GD2object_xxxx

Synopsis

access a Graphics Display Kit object

GDobject_get_xxxx

void _ GDobject_get_visible ( object_id , _int _* visible _);
void _ GDobject_get_pickable ( object_id , _int _* pickable _);
void _ GDobject_get_cache ( object_id , _float _* cache _);
void _ GDobject_get_type ( object_id , _int _* type _);
void _ GDobject_get_dith_tech ( object_id , _int _* dith_tech _);
void _ GDobject_get_interp_type ( object_id , _int _* interp_type _);
void _ GDobject_get_missing_val ( object_id , _float _* missing_val _);
void _ GDobject_get_missing_rgb ( object_id , _float _* missing_rgb _);
void _ GDobject_get_xform_mode ( object_id , _int _* xform_mode _);
void _ GDobject_get_window ( object_id , _float _* window _);
void _ GDobject_get_surf_conv ( object_id , _int _* surf_conv _);
void _ GDobject_get_surf_chunk ( object_id , _int _* surf_chunk _);
void _ GDobject_get_surf_chunk_size ( object_id , _int _* surf_chunk_size _);
void _ GDobject_get_line_chunk_size ( object_id , _int _* line_chunk_size _);
void _ GDobject_get_tmap_method ( object_id , _int _* tmap_method _);
void _ GDobject_get_tri_subdiv_type ( object_id , _int _* tri_subdiv_type _);
void _ GDobject_get_tri_subdiv_aval ( object_id , _int _* tri_subdiv_aval _);
void _ GDobject_get_tri_subdiv_fval ( object_id , _int _* tri_subdiv_fval _);

OMobj_id _ object_id ;

GDobject_set_xxxx

int _ GDobject_set_visible ( object_id , _int _ visible _);
int _ GDobject_set_pickable ( object_id , _int _ pickable _);
int _ GDobject_set_cache ( object_id , _float _ cache _);
int _ GDobject_set_type ( object_id , _int _type _);
int _ GDobject_set_dith_tech ( object_id , _int _ dith_tech _);
int _ GDobject_set_interp_type ( object_id , _int _ interp_type _);
int _ GDobject_set_missing_val ( object_id , _float _ missing_val _);
int _ GDobject_set_missing_rgb ( object_id , _float _* missing_rgb _);
int _ GDobject_set_xform_mode ( object_id , _int _ xform_mode _);
int _ GDobject_set_window ( object_id , _float _* window _);
int _ GDobject_set_surf_conv ( object_id , _int _ surf_conv _);
int _ GDobject_set_surf_chunk ( object_id , _int _ surf_chunk _);
int _ GDobject_set_surf_chunk_size ( object_id , _int _ surf_chunk_size _);
int _ GDobject_set_line_chunk_size ( object_id , _int _ line_chunk_size _);
int _ GDobject_set_tmap_method ( object_id , _int _ tmap_method _);
int _ GDobject_set_tri_subdiv_type ( object_id , _int _ tri_subdiv_type _);
int _ GDobject_set_tri_subdiv_aval ( object_id , _int _ tri_subdiv_aval _);
int _ GDobject_set_tri_subdiv_fval ( object_id , _int _ tri_subdiv_fval _);

OMobj_id _ object_id ;

GDobject_attach/detach_xxxx

void _ GDobject_attach_altobj ( object_id , _ altobj_id , int flag_);
void GDobject_detach_altobj ( object_id, int flag );

void GDobject_detach_cameras ( object_id );

void _ GDobject_attach_dmap ( object_id , _ dmap_id, int flag _);
void GDobject_detach_dmap ( object_id, int flag );

void _ GDobject_attach_modes ( object_id , _ modes_id, int flag _);
void GDobject_detach_modes ( object_id, int flag );

void GDobject_attach_object ( object_id, child_id, int flag );
void GDobject_detach_children ( object_id );
void GDobject_detach_parents ( object_id );
void GDobject_detach_object ( object_id, child_id );

void _ GDobject_attach_pick_info ( object_id , _ pick_info_id, int flag _);
void GDobject_detach_pick_info ( object_id, int flag );

void _ GDobject_attach_props ( object_id , _ props_id, int flag _);
void GDobject_detach_props ( object_id, int flag );

void _ GDobject_attach_texture ( object_id , _ texture_id, int flag _);
void GDobject_detach_texture ( object_id, int flag );

void _ GDobject_attach_xform ( object_id , _ xform_id , int flag_);
void GDobject_detach_xform ( object_id, int flag );

OMobj_id _ object_id , texture_id;
OMobj_id _ xform_id , modes_id , props_id , pick_info_id , altobj_id , dmap_id ;

GDobject_ext_xxx

void _ GDobject_ext_reset ( object_id _);
void _ GDobject_ext_center ( object_id _);
void GDobject_ext_norm ( camera_id , _ object_id , _ mode __);
void _ GDobject_ext_compute ( camera_id , _ object_id , _ extents );
void _ GDobject_ext_compute_world ( camera_id , _ object_id , _ extents );

void _ GDobject_get_transform ( object_id , _float * matrix _);
void _ GDobject_get_rotation ( object_id , _float * matrix _);

OMobj_id _ object_id , camera_id ;
int _ mode ;
float _extents [6];
float matrix[4][4];

GDobject_delete

void _ GDobject_delete ( OMobj_id _ object_id _);

Description

These routines are used to access a Graphics Display Kit object.

GDobject_get/set_xxxx

The GDobject_get_xxxx routines get the subobject values of the object. The GDpbject_set_xxxx routines set the subobject values of the object. These routines are used by the Graphics Display Kit object editor (i.e., GDobj_edit).

GDobject_attach/detach_xxxx

The GDobject_attach_xxxx routines attach a Graphics Display Kit base type (properties, modes, etc.) to a Graphics Display Kit object. The GDobject_detach_xxxx routines detach a Graphics Display Kit base type from a Graphics Display Kit object.

GDobject_ext_xxxx

The GDobject_ext_xxxx routines perform a variety of operations on a graphics-display object.

GDobject_ext_reset resets the transformation matrix associated with the object.

GDobject_ext_center sets the center used for rotation/scaling to the center of the extents of the object.

GDobject_ext_norm sets the transformation matrix associated with the object such that the object fits in the view.

GDobject_ext_compute computes an object's extents. The returned extenst have been transformed by the full transform that is applied to the object to render it.

GDobject_ext_compute_world computes an object's extents. The returned extents are not transformed.

GDobject_get_transform gets the transformation matrix from the object back to the top object.

GDobject_get_rotation is like GDobject_get_transform, but the matrix it returns includes only rotations and scale.

GDobject_delete

GDobject_delete deletes the object. This method is called directly by the Object Manager when the object is deleted.

To create an instance of an object, call the utility routine GDcreate_instance.

Parameters

object_id

The id of an object.

Other get/set parameters

The other parameters in the get/set routines correspond to subobjects of the graphics-display object.

For details, including a listing of symbolic constants, see DefaultObject .

The matrix parameter is a 4-by-4 floating-point array.

extents

A six-element array containing the object's extents (X 1 , X 2 , Y 1 , Y 2 , Z 1 , Z 2 ).

camera_id

The id of a camera.

child_id

The id of a child object to attach or detach to the object.

xform_id
modes_id
props_id
pick_info_id
altobj_id
dmap_id
texture_id

(GDobject_attach_xxxx only) _The id of the base type to attach to the object.

Example

/* Get and set a GD object's cache subobject. */
OMobj_id object_id; /* Assume this has been set. */
int cache;
...
GDobject_get_cache(object_id, &cache);
GDobject_set_cache(object_id, 1);