HC_Conditional_Reference

Key HC_Conditional_Reference(char const *segname, char const *condition)
Key HC_Conditional_Reference(char const segname, char const condition)

Directs HOOPS to create a reference to some geometry when processing a segment, subject to meeting the conditions set on the segment in a previous call to Set_Conditions().

This “Conditional” variant of Reference_Geometry() allows the user to register one or a series of conditions that must match with the conditions set on the owning or referencing segment ( see Set_Conditions() ), in order for the reference to apply. The conditions are user-defined and have no internal meaning to HOOPS other than as elements that can be compared. Conditions are inherited down the tree like other regular attributes, and are resolved at draw time.

In all other respects, this function is identical to Reference_Geometry().

HC_Copy_Geometry, HC_Open_Geometry, HC_Reference_Geometry, HC_Set_Conditions, HC_Show_Conditional_Reference, HC_Show_Reference_Geometry

Parameters

segname: Name, possibly including wildcards and lists, of extra segment(s) from which the geometry should be included when displaying the current segment.

condition: The condition(s) that are associated with a particular conditional include, and that are valid input to Set_Conditions().

Returns

Unique numeric identifier to the reference. This is not the same as the key of the geometry being referenced.