Functions | |
void | Show_Selection_Original_Key (HC_KEY *key) |
Returns the original HOOPS key to a renumbered selection object. More... | |
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. More... | |
void Show_Selection_Original_Key | ( | HC_KEY * | key | ) |
Returns the original HOOPS key to a renumbered selection object.
key | - The non-renumbered key of the "best match" element of your scene. Passed by reference. Returned to user. |
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.
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.
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.
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. |
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.