HOOPS/3dGS I.M. Interface

     << Back      Full Index      Forward >>


Check_XXX_Interesting


Functions

HT_Boolean Check_Current_Geometry_Interesting (HT_Rendition *nr)
HT_Boolean Check_Geometry_Interesting (HT_Rendition *nr, HT_(Geometry)*geo)
HT_Boolean Check_Segment_Interesting (HT_Rendition *nr, HT_Segment_Info *si)

Function Documentation

HT_Boolean * Check_Current_Geometry_Interesting HT_Rendition *  nr  ) 
 

Checks the value of the "interesting" bit in the item currently being drawn.

Parameters:
nr - Rendition created with HIC_New_Rendition() . Passed by reference.
Returns:
flag - Flag indicating if the result is interesting or not.

DETAILS

The interesting bit is a place holder that can be used for application-specific purposes. The bit is referred to as the "interesting" bit because it can be set during rendering and then interrogated later.

For example, during rendering, items that are off-screen are flagged un-interesting, since they are outside the camera's view. Only the items on the screen are marked as interesting. During selection processing, these off-screen items are immediately rejected for consideration. A callback on the rendering or selection traversal can override the default flagging on any kind of geometry.

NOTES

RESTRICTIONS

See also:
Set_Geometry_Interesting, Set_Current_Geometry_Interesting, Set_Segment_Interesting, Check_Geometry_Interesting, Check_Segment_Interesting

HT_Boolean * Check_Geometry_Interesting HT_Rendition *  nr,
HT_(Geometry)*  geo
 

Checks the value of the "interesting" bit in a specified piece of geometry.

Parameters:
nr - Rendition created with HIC_New_Rendition() . Passed by reference.
geo - Geometry descriptor structure. Passed by reference.
Returns:
flag - Flag indicating if the result is interesting or not.

DETAILS

The interesting bit is a place holder that can be used for application-specific purposes. The bit is referred to as the "interesting" bit because it can be set during rendering and then interrogated later.

For example, during rendering, items that are off-screen are flagged un-interesting, since they are outside the camera's view. Only the items on the screen are marked as interesting. During selection processing, these off-screen items are immediately rejected for consideration. A callback on the rendering or selection traversal can override the default flagging on any kind of geometry.

See also:
Set_Geometry_Interesting, Set_Current_Geometry_Interesting, Set_Segment_Interesting, Check_Current_Geometry_Interesting, Check_Segment_Interesting

HT_Boolean * Check_Segment_Interesting HT_Rendition *  nr,
HT_Segment_Info *  si
 

Checks the value of the "interesting" bit in a specified segment.

Parameters:
nr - Rendition created with HIC_New_Rendition() . Passed by reference.
si - Segment info structure. Passed by reference.
Returns:
flag - Flag indicating if the result is interesting or not.

DETAILS

The interesting bit is a place holder that can be used for application-specific purposes. The bit is referred to as the "interesting" bit because it can be set during rendering and then interrogated later.

For example, during rendering, items that are off-screen are flagged un-interesting, since they are outside the camera's view. Only the items on the screen are marked as interesting. During selection processing, these off-screen items are immediately rejected for consideration. A callback on the rendering or selection traversal can override the default flagging on any kind of geometry.

See also:
Set_Geometry_Interesting, Set_Current_Geometry_Interesting, Set_Segment_Interesting, Check_Current_Geometry_Interesting, Check_Geometry_Interesting
Main Index

HOOPS/3dGS I.M. Interface

     << Back      Full Index      Forward >>