Ovis_Viewmode_Absolute_Set()
Abstract
Sets 3D Network Visualizer to the Absolute view mode.
Syntax
Ovis_Viewmode_Absolute_Set (pos, orientation)
| Argument | Type | Description |
|---|---|---|
pos |
OvisT_3D_Position |
Position of the viewpoint |
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 an absolute mode with the viewpoint at pos looking out based on orientation.
The position must refer to a fixed location in geocentric or geodetic coordinates.
Example
OvisT_3D_Position pos;
OvisT_TaitBryan orientation;
Ovis_3D_Position_Geodetic_Set (&pos, 38, -122, 300);
/* looking down the geocentric X axis */
orientation.phi = orientation.theta = orientation.psi = 0;
Ovis_Viewmode_Absolute_Set (pos, orientation);
Errors
- 'Decoration' 3D position is not supported.
- 'Entity' 3D position is not supported.
Reference
- Use other
Ovis_Viewmode_xxx_Setfunctions to change the view to different modes. - Use the function Ovis_3D_Position_Orientation_TaitBryan_Get() to obtain a Tait-Bryan rotation based on a specified position and orientation.