GDpick_data

Synopsis

group GDpick_data
{
int _sx;
int _sy;
float _vert[3];
float _point[3];
int _verti;
int _conni;
int _primi;
float _dist;
group &field_id;
prim &values_id;
group &data_id;
};

Description

GDpick_data defines the Graphics Display Kit pick data.

The pick data is part of the pick information returned by the Graphics Display Kit when an object is picked. The pick data is returned for each primitive in the object that is picked. Currently, only the front-most primitive is picked.

Parameters

sx
sy

The x and y coordinates, in screen space, of the point that was picked. Note that the screen space coordinate system has 0,0 in the upper left with positive X to the right and positive Y down. The coordinate system in the view has 0,0 in the center with positive X to the right and positive Y up.

vert

The x, y, and z values, in modeling coordinates, of the closest vertex to the selected point.

point

The x, y, and z values, in modeling coordinates, of the selected point.

verti

The index into the coordinate array associated with the object of the nearest vertex.

conni

The index into the connectivity array associated with the object of the selected vertex's cell set. Not all renderable data has a connectivity array (e.g, text does not have a connectivity array).

primi

The number of the primitive that was picked.

dist

The picked data's z coordinate.

field_id

The OM object id of the data that is attached to the object. Typically, this is the OM object id of an AVS/Express field.

values_id

The OM object id of the array of coordinates associated with the object. Typically, this is the OM object id of the values array within an AVS/Express field.

data_id

The OM object id of the cell set selected in the object. The cell set is found in the AVS/Express field. The cell set contains the connectivity array.

Example

Libraries.Graphics_Display.Objects.DataObject

File