Graphic Display - API for base objects

This topic introduces the Graphics Display Kit's Application Program Interface (API) for accessing base objects.

Introduction

The Graphics Display Kit provides an application program interface for accessing base objects.

Objects and views

Several routines enable a program to access the base objects related to objects, views, and transformations. The routines can:

Get a subobject value.

Set a subobject value.

Attach or detach an object.

Delete an object.

Reset an object.

Here is a list of the routines:

GDcamera_ xxxx

GDlight_ xxxx

GDlight_info_ xxxx

GDmodes_ xxxx

GDobject_ xxxx

GDpick_ctrl_ xxxx

GDpick_info_ xxxx

GDprops_ xxxx

GDtexture_ xxxx

GDview_ xxxx

GDxform_ xxxx

To create an object, you use the utility routine GDcreate_instance.

Utility routines

The Graphics Display Kit also provides utility routines that perform low-level functions.

In the table below, where two or more routines appear together, you can find the details for the routines under the entry for the first routine listed.

Utility routine	Description
See GDcreate_instance	Create an object
GDget_obj_seq	Get an object's sequence number
See GDget_float_array GDget_newfloat_array GDget_updfloat_array GDset_float_array	Get or set a floating-point array object
See GDget_float_val GDget_newfloat_val GDget_updfloat_val GDset_float_val GDset_newfloat_val	Get or set a floating-point scalar object
See GDget_int_array GDget_newint_array GDset_int_array	Get or set an integer array object
See GDget_int_val GDget_newint_val GDget_updint_val GDset_int_val GDset_newint_val	Get or set an integer scalar object
See GDget_local GDset_local	Get or set an object's local_ptr subobject
GDget_str_val GDget_newstr_val GDget_updstr_val GDset_newstr_val	Get or set a string object
See GDget_refer_db GDset_refer_db	Get or set an object's reference

Header files

Here are the AVS/Express-specific header files you typically include in the source file:

#include <avs/util.h>
#include <avs/err.h>
#include <avs/om.h>
#include <avs/om_type.h>
#include <avs/fld.h>
#include <avs/math.h>
#include <avs/gd.h>