Brief Index      Full Index      Events Index      I.M. Reference

Show_Selection_Original_Key

Functions

void Show_Selection_Original_Key (HC_KEY *key)
void Show_Selection_Original_Keys (int *count, HC_KEY *key)

Function Documentation

void Show_Selection_Original_Key ( HC_KEY *  key)

Returns the original HOOPS key to a renumbered selection object.

Parameters:
key- The non-renumbered key of the "best match" element of your scene. Passed by reference. Returned to user.

DETAILS

The key returned by this function is identical to that from Show_Selection_Element(), except that it is of the non-renumbered form (see Show_Selection_Original_Key() for details). Show_Selection_Original_Key(), however, has the advantage of extra context information from the selection event. Thus, it can operate on entities whose keys have been locally renumbered, even without opening the containing segment.

NOTES

If the selected entity's key was not renumbered, then the key returned by Show_Selection_Element() and Show_Selection_Original_Key() will be identical.

See also:
Compute_Selection, Find_Related_Selection, Show_Original_Key, Renumber_Key, Show_Key_Type, Set_Selectability, Show_Selection, Show_Selection_Element
void Show_Selection_Original_Keys ( int *  count,
HC_KEY *  key 
)

Returns an array of original HOOPS keys that delineate the ownership of the selection object.

Parameters:
count- The number of HC_KEY's in key. Passed by reference. Returned to user.
key- The non-renumbered keys to the "best match" element of your scene. Passed by reference. Returned to user.

DETAILS

The key array returned by this function starts with the object's original key, continues with the keys of successive owning segments, and ends with the original key of the driver segment. The output is useful as input to any number of PShow_* routines, especially in scenes that have renumbered objects.

NOTES

See also:
Compute_Selection, Find_Related_Selection, Show_Original_Key, Renumber_Key, Show_Key_Type, Set_Selectability, Show_Selection, Show_Selection_Element, Show_Owner_Original_Key

Brief Index      Full Index      Events Index      I.M. Reference