|
The following functions are used for creating a hierarchy among objects and manipulating
multiple number of objects together. For example let's say
that we want to have a human model in our application. We should construct the model from
several objects, the hands, the legs, the head etc ... Each object can be constructed from
smaller objects, the hands for example could contain objects for the fingers.
When we move the hand we will want the finger objects to move together with the
hand object. We do it by setting the hand object as the father of each finger object.
Later we can call STATE_object_move_including_sons(hand_object_handle) This will
move the hand objects including all the fingers.
Terminology: The usage of the word TREE
Setting father-sons relations creates a structure similar to a family tree
We can call this function with father_object==NULL
this will mean that there is no father for this object.
Returns OK or VR_ERROR.
If the function fails it means that we tried to make a loop in hierarchy of the objects
(for example setting object B as the father of object A and then setting object A as the father of B)
|