VO View
Set parameters for the view in a 3D window
Syntax
VO <ScenarioPath> View {Options}
Related commands
Description
The VO View command enables you to set several 3D viewing parameters for a 3D window. These parameters are typically controlled from the View From Position and View To Direction dialog.
After setting the parameters for the view, send the VO ViewFromTo command with the Reset option to update the 3D Graphics window. (e.g. VO * ViewFromTo Reset)
{Options} | Description |
---|---|
Top | Orients the view to look down towards the central body. |
North | Orients the view to look north. |
Home | Resets the view in the 3D window to your home view. |
NextReferenceFrame | Changes the view reference frame to the next frame in the list.
This option is valid for FromTo mode only. |
SetReferenceFrame "<AxesComponent>" [WindowID <WinNum>] | Set the reference frame to the specified Axes. The specified Axes must be valid for the current view, i.e. this command will not change the View, just the reference frame.
This option is valid for FromTo mode only. |
AddReferenceFrame <Parameters> | For FromTo mode <Parameters> are
"<AxesComponent>" Object {<TruncObjPath> | CentralBody} If <TruncObjPath> is entered, it must be an existing object truncated path. The Axes will be added to the Class list of the object. |
For Untethered mode <Parameters> is | |
RemoveReferenceFrame <Parameters> | For FromTo mode <Parameters> are
"<AxesComponent>" Object {<TruncObjPath> | CentralBody} If <TruncObjPath> is entered, it must be an existing object truncated path. The Axes will be removed from the Class list of the object. |
For Untethered mode <Parameters> is | |
Mouse Speed {Slower | Faster | Reset} | Specify one of the following:
|
Mouse Inertia {On | Off} | Turn On for quicker mouse movement, turn Off for more precise mouse movement. |
Zoom { FractionOfCB <Value> | Distance <Value> | Speed {Slower | Faster | Reset | <Value>} | SpeedRelativeToCBDistance {On|Off} } | FractionOfCB <Value> Zoom in (+ numbers) or out (- numbers). <Value> is multiplied by the view central body reference radius. |
Distance <Value> Zoom in (+ numbers) or out (- numbers) the distance <Value> specified. <Value> is in Connect distance units. | |
Speed {Slower | Faster | Reset | <Value>} Set the Zoom speed. <Value> can be between -10.0 and 10.0. A negative number decreases the zoom speed, a positive number increases it. | |
SpeedRelativeToCBDistance {On|Off} Set the Zoom speed relative to the distance from the central body. As you get closer to the surface, your zoom increment becomes smaller. | |
Parameters UpAxis {[X | -X | Y | -Y | Z | -Z}] [UseUpAxis {On | Off}]} | Specify one of the following:
|
Rotate {RelativeSpeed | PanOnCentralBodies} {On | Off} | Set RelativeSpeed to enable/disable the auto-selection of mouse rotation sensitivity depending on the distance to the viewed object. If On, the closer you zoom towards the object you are looking at, mouse rotation speed will decrease for finer viewpoint control.
Set PanOnCentralBodies to enable/disable panning on central bodies. If On, when a user initiates a scene rotation with the mouse over a central body the clicked position will move where the mouse is dragged, whenever possible. |
LockViewDirection {On | Off} | When On this will disable all rotation in the 3D window. Zooming is still allowed as is twisting if Constrained "Up" Vector is ON. |
FromTo {{FromToOptions} | {FromOptions} {ToOptions}} | Define the View. Enter {FromToOptions} if the From and To values are the same. Otherwise, enter both {FromOptions} and {ToOptions}. Additional options and parameters are described in the following tables. |
WindowID <WinNumber> | Enter the number of the 3D window to which the changes will be applied. |
VO View FromTo
The following tables describe the parameters and values used to define a view using the FromTo option.
To set additional views use the VO ViewFromTo command. To create views using Vectors use the VO ViewAlongDirection command.
Use {FromToOption} when the name of the view from direction or object and the view to direction or object are the same. The FromToRegName and FromToName parameters are required.
{FromToOption} | Description |
---|---|
FromToRegName "<RegisteredName>" | Enter the registered name that specifies the type of view being defined. |
FromToName "<ViewName>" | Enter the name that indicates the specific view being defined. |
FromToCallData "<CallDataValue>" | CallData is the additional data necessary to define the view position or object. Depending on the FromToRegName entered, this value may be optional. See table below for details. |
Use {FromOption} to define the view from direction or object. The FromRegName and FromName parameters are required.
{FromOption} | Description |
---|---|
FromRegName "<RegisteredName>" | Enter the registered name that specifies the type of view being defined. |
FromName "<ViewName>" | Enter the name that indicates the specific view being defined. |
FromCallData "<CallDataValue>" | CallData is the additional data necessary to define the view position or object. Depending on the FromToRegName entered, this value may be optional. See table below for details. |
Use {ToOption} to define the view to direction or object. The ToRegName and ToName parameters are required.
{ToOption} | Description |
---|---|
ToRegName "<RegisteredName>" | Enter the registered name that specifies the type of view being defined. |
ToName "<ViewName>" | Enter name that indicates the specific view being defined. |
ToCallData "<CallDataValue>" | CallData is the additional data necessary to define the view position or object. Depending on the FromToRegName entered, this value may be optional. See table below for details. |
The following table further describes the "<RegisteredName>", "<ViewName>" and "<CallDataValue>" values, used to define a view.
"<RegisteredName>" | "<ViewName>" | "<CallDataValue>" | Description |
---|---|---|---|
"View Central Body" | "<CBName>" | N/A | The view direction is to or from the specified Central body. |
"STK Object" | "<TruncObjectPath>" | N/A | The view direction is to or from the specified object. |
"Latitude, Longitude, Altitude" | "Latitude, Longitude, Altitude" | "Lat <LatInDegrees> Lon <LonInDegrees> Alt <AltInMeters>" | The view direction is to or from the coordinates specified.
This View type is valid as FromTo only. |
"Untethered" | "Untethered" | InitialAttitude {Origin | Current}
SystemDef '{Name <SystemName> {CBName <CentralBodyName> | Object <SystemObjectName>}}' Speed <Speed> AlignViewDirWithOrigin {On | Off} | The view is not attached to any specific object or location. Enter any or all of the "<CallDataValue>" options, all enclosed in double quotes.
This View type is valid as FromTo only. Origin resets the camera's initial attitude to the system's origin, while Current sets it to the default (From/To) attitude. Speed indicates the speed of the camera and is entered in meters/second. AlignViewDirWithOrigin aligns the view with the system origin. |
"STK Object VGT Point" | "<PointComponent>" | N/A | Specify the direction of the view as a point. |
To set additional views, including those using Axes and Vectors, use the VO ViewFromTo command.
Specifying a Component
Use this format to specify a Vector Geometry Tool Component. The syntax is:
"<TruncObjectPath> <Name> <Type>"
Where <TruncObjectPath> is a truncated object path or central body path for the component; <Name> is the component name, and <Type> is the component type, for example Point, Axes or System.
Deprecated Options
The following "<RegisteredName>" values have been replaced in STK 9.
Pre-STK 9 Name | Use This Instead: |
---|---|
"Central Body" | "View Central Body" |
"STK Object Direction" | "STK Object" |
Examples
To orient the view in the first 3D window to look down towards the central body:
To orient the view in the second 3D window to look north:
To increase the mouse rotation speed for coarser viewpoint control in the first 3D window:
To decrease the mouse rotation speed for finer viewpoint control in the first 3D window:
To zoom out 0.5 times the central body reference radius:
To allow unconstrained view rotation:
To set the up axis to -Z and orient the view from that axis:
To enable rotation in the second 3D window:
Examples
To select the untethered mode with the initial attitude set to origin and the view direction aligned with the system's origin:
To select the untethered mode with the initial attitude set to origin and with the view direction aligned with the system's origin turned off:
To orient the view in the first 3D window so that you can view and rotate around Satellite1:
To orient the view, using the From/To viewing mode, so that you are looking from Satellite1 (the view from object) towards Earth (the view to direction):
In order to set the view for an MTO object, please note that stk just views the MTO object's computational track, so set the compute track first, then set the view options:
To view from Facility1 Center Point to Earth:
Set the view fromto to the specified Lat, Lon, Alt coordinates:
Examples
In Untethered mode add and then remove a reference frame:
In FromTo mode add a reference frame to the Satellite class:
In FromTo mode set the reference frame for the current view:
In FromTo mode remove a reference frame from the Satellite class:
In FromTo mode add a reference frame for the CentralBody:
To change the view reference frame in the first 3D window to the next view reference frame in the list:
To change the view reference frame in the third 3D window to the next view reference frame in the list:
Examples
To change the zoom speed:
Return message
PanOnCentralBodiesGroup membership
This command belongs to the following group(s):
Version
11