GDpick_info_xxxx - GD API

Synopsis

access the Graphics Display Kit pick information

GDpick_info_get_xxxx

void   GDpick_info_get_objxform ( pick_info_id ,  float  * matrix  );
void   GDpick_info_get_topxform ( pick_info_id ,  float  * matrix  );
void   GDpick_info_get_viewxform ( pick_info_id ,  float  * matrix  );
void   GDpick_info_get_selected ( pick_info_id ,  int  * npicked  );
void   GDpick_info_get_npicked ( pick_info_id ,  int  * selected  );
void GDpick_info_get_pickdata  ( pick_info_id ,   index ,  GDpick_data  * pick_data );

OMobj_id   pick_info_id ;
int   index ;

GDpick_info_set_xxxx

void   GDpick_info_set_objxform ( pick_info_id ,  float  * matrix  );
void   GDpick_info_set_topxform ( pick_info_id ,  float  * matrix  );
void   GDpick_info_set_viewxform ( pick_info_id ,  float  * matrix  );
void   GDpick_info_set_selected ( pick_info_id ,  int   selected  );
void   GDpick_info_set_npicked ( pick_info_id ,  int   npicked  );
void GDpick_info_set_pickdata  ( pick_info_id ,   index ,  GDpick_data  * pick_data );

OMobj_id   pick_info_id ;
int   index ;

GDpick_info_delete

void   GDpick_info_delete (
NULL,
OMobj_id   pick_info_id ,
0,
GDpick_info  * pick_info  );

GDpick_info_reset

void   GDpick_info_reset (GDpick_info  * pick_info );

Description

These routines access the Graphics Display Kit pick information.

The GDpick_info_get_xxxx routines get the subobject values of the pick information. The GDpick_info_set_xxxx routines set the subobject values of the pick information.

GDpick_info_delete deletes the pick information. This method is called directly by the Object Manager when the pick information is deleted.

GDpick_info_reset resets the pick information's subobjects to their default values. The default values are those in specified in DefaultPickInfo.

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

Parameters

pick_info_id

The id of the pick information.

Other get/set parameters

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

For details, including a listing of symbolic constants, see See DefaultPickInfo .

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

The index parameter is the index into the array of pick-data objects.

pick_info

(GDpick_info_delete only)  The pick information's local pointer. To get this value, call the utility routine GDget_local.

Example

/* Get a pick_info object's topxform subobject. */
OMobj_id pick_info_id; /* Assume this has been set. */
float topxform[4][4];
...
GDpick_info_get_topxform(pick_info_id, topxform);