VO CameraControl

Set parameters for controlling a camera path.

Syntax

VO <ScenarioPath> CameraControl {CameraOptions}

Related Commands

• VO_R CameraControl

Description

The VO CameraControl command enables you to define the path that the virtual camera takes during a technical animation.

The following table describes basic options to follow, stop following, hide or show the graphics of a camera path in a particular 3D Graphics window for a specific scenario.

Additional {CameraOptions} described below allow for detailed definitions of camera paths and keyframes. These options are CameraPath, KeyframeProps, 3DWindowProps, RenderProps and Keyframes.

Example

To follow the "Path 4" camera path in the 3D Graphics window 2, without a soft transition:

VO * CameraControl Follow "Path 4" SoftTransition No WindowID 2

To stop following any camera path in the 3D Graphics window 1:

VO * CameraControl Follow Off WindowID 1

To follow the "Path0" camera path in the 3D Graphics window, but don't show the graphics:

VO * CameraControl Follow "Path0" HidePath "Path0"

CameraPath

Use this option to manage camera paths.

The syntax for the commands to add, modify, delete and duplicate a CameraPath are listed here.

Syntax to Add or Modify a camera path, valid {AddModifyOptions} are described in the following table.:

VO <ScenarioPath> CameraControl CameraPath {Add | Modify} {AddModifyOptions}

Syntax to Delete a camera path, specify the name of the camera path to delete:

VO <ScenarioPath> CameraControl CameraPath Delete Name "<CameraPathName>"

Syntax to Duplicate a camera path. Specify the from and to camera path names:

VO <ScenarioPath> CameraControl CameraPath Duplicate FromName "<CameraPathName>" ToName "<CameraPathName>"

Example

To add a camera path called Path2:

VO * CameraControl CameraPath Add Name "Path2"

To modify the color of Path2:

VO * CameraControl CameraPath Modify Name "Path2" color #ff00ff

To create a duplicate of Path2 named Path4:

VO * CameraControl CameraPath Duplicate FromName "Path2" ToName "Path4"

KeyFrameProps

Use this option to set keyframe properties.

VO <ScenarioPath> CameraControl KeyFrameProps "<CameraPathName>" {KeyframeOptions}

Enter "<CameraPathName>" to specifiy the camera path being modified. The following table describes the {KeyframeOptions}.

Example

To enable ripple times for Path2:

VO * CameraControl KeyframeProps "Path2" RippleTimes On

To set the reference axes for Path2:

VO * CameraControl KeyframeProps "Path2" ReferenceAxes "CentralBody/Earth B1950 Axes"

3DWindowProps

Use this option to define camera control properties of a particular 3D graphics window.

VO <ScenarioPath> CameraControl 3DWindowProps {WindowOptions}

The following table describes the {WindowOptions}.

Note: Follow mode cannot not be enabled while enabling an edit mode.

Example

To esable follow mode:

VO * CameraControl 3DWindowProps FollowMode On

To set the modes and active path:

VO * CameraControl 3DWindowProps FreeEditMode On FollowMode off OrientVecEditMode on FixedEditMode on ActivePath "Path2"

RenderProps

Use this option to set properties for drawing camera paths in the 3D windows.

VO <ScenarioPath> CameraControl RenderProps {RenderOptions}

The following table describes the {RenderOptions}.

For valid {Color} options see Common Options.

Example

To turn off the display of keyframe points:

VO * CameraControl RenderProps ShowKeyframePts Off

To set the color of control points:

VO * CameraControl RenderProps ControlPtColor green

KeyFrames

The syntax for the commands to add, delete or modify a keyframe are listed here. In each command you must specify the "<CameraPathName>" where the keyframe can be found.

Syntax to Add a keyframe, note you can optionally include the 3D window ID:

VO <ScenarioPath> CameraControl KeyFrames "<CameraPathName>" Add [WindowID <WinNumber>]

Syntax to Delete a keyframe, also include the keyframe number or enter All to delete all keyframes:

VO <ScenarioPath> CameraControl KeyFrames "<CameraPathName>" Delete {<KeyframeNum> | "All"}

Syntax to Modify a keyframe. Specify the <KeyframeNum> and {ModifyOptions}. Valid {ModifyOptions} are described in the following table:

VO <ScenarioPath> CameraControl KeyFrames "<CameraPathName>" Modify <KeyframeNum> {ModifyOptions}

Example

To add a keyframe to Path2:

VO * CameraControl Keyframes "Path2" Add

To modify the position of keyframe 1 in Path2:

VO * CameraControl Keyframes "Path2" Modify 1 Position 1760.563917 89.909729 70.324841

ReturnMessage

Group Membership

This command belongs to the following group(s):

VO

VO Window

Version

10

STK Programming Interface 11.0.1