Ovis_Viewmode_Orbit_Set()
Note: The Orbit view mode is not supported in 3D Network Visualizer 3.1.0 and later. Calls to this function set the follow view mode, with the offset built from radius, azimuth, and elevation and orientation looking straight at the entity. The azimuth_rate is ignored.
Abstract
Sets 3D Network Visualizer to the Orbit view mode.
Syntax
Ovis_Viewmode_Orbit_Set (entity, radius, azimuth, elevation, azimuth_rate)
| Argument | Type | Description |
|---|---|---|
entity |
OvisT_Entity * |
Ovis entity |
radius |
double |
Distance from the entity in meters |
azimuth |
double |
Azimuth angle in X-Y entity plane, in degrees |
elevation |
double |
Elevation angle in X-Z entity plane, in degrees |
azimuth_rate |
double |
Rotation rate around the Z axis, in degrees/second |
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 orbit mode with the viewpoint located at <azimuth,elevation> on a sphere of |radius| meters, with the viewpoint rotating around the Z axis.
A positive radius will have the viewpoint looking away from the entity, while a negative radius will have the viewpoint looking at the entity, as shown in Figure 12.
Example
OvisT_Entity * entity;
/* Looking down at entity, slowly moving around it */
Ovis_Viewmode_Orbit_Set (entity, 20, 0, 5, 5);
Errors
- Entity is NIL.
Reference
- Use other
Ovis_Viewmode_xxx_Setfunctions to change the view to different modes.