Ovis_Viewmode_Tether_Set()
Abstract
Sets 3D Network Visualizer to the Tether view mode.
Syntax
Ovis_Viewmode_Tether_Set (entity, offset, orientation)
| Argument | Type | Description |
|---|---|---|
entity |
OvisT_Entity * |
Ovis entity |
offset |
OvisT_3D_Body_Offset |
Position of the viewpoint in entity's local axis, in meters |
orientation |
OvisT_TaitBryan |
Orientation of the viewpoint |
Return Type
OvisT_Compcode
OvisC_Compcode_Success if the operation could be performed; OvisC_Compcode_Failure otherwise.
Header
ovis_entity.h
Details
This function modifies the current view mode in 3D Network Visualizer to a tether view mode attached to the specified entity. offset indicates where the viewpoint is located with respect to the attached entity and orientation indicates where the viewpoint is looking.
Example
OvisT_3D_Body_Offset offset;
OvisT_TaitBryan orientation;
OvisT_Entity * entity;
/* entity created at some point */
offset.forward = 10;
offset.right = offset.down = 0;
/* looking down the geocentric X axis */
orientation.phi = orientation.theta = orientation.psi = 0;
Ovis_Viewmode_Tether_Set (entity, offset, orientation);
Errors
- Entity is NIL.
Reference
- Use other
Ovis_Viewmode_xxx_Setfunctions to change the view to different modes.