|
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
|