STATE_object_set_father_object

 

 



   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)

 

 

Go to page 1      Select API

 

Copyright © 2007 3DSTATE Corporation. www.3dstate.com