STATE_camera_drop_down

 

 



  Drops the camera down.
  In other words: Move the camera down till it is height_above_ground above the polygon below the camera
  If there is nothing below the camera then the location of the camera will not be changed.
  In many times the function STATE_engine_ignore_dynamic_objects_for_collision_detection(YES);
   will be called before dropping down the camera. This will make the camera fall through dynamic objects
   
   Return value: 
  		returns a handle to the polygon below the camera
  
   parameters:
  		camera_handle: the camera to be dropped
  
  		height_above_ground: the height above the polygon below the camera in which the camera should be positioned.
  
  
   Examples: 
  	A)	  drop the camera down
  		STATE_camera_drop_down(my_camera, 100);   put the camera 100 units above the ground 
  
  	B)    drop the camera through objects
  		STATE_engine_ignore_dynamic_objects_for_collision_detection(YES);
  		STATE_camera_drop_down(my_camera, 100);   put the camera 100 units above the ground 
  		STATE_engine_ignore_dynamic_objects_for_collision_detection(NO);   restore regular collision detection
  

 

 

Go to page 1      Select API

 

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