LogoLogo
WebsiteSupportDownloadsForumsQuick LinksContact Us
v3.2
v3.2
  • OptiTrack Documentation
  • WHAT'S NEW
    • What's New in Motive 3.2
  • QUICK START GUIDES
    • Quick Start Guide: Getting Started
    • Quick Start Guide: Prime Color Camera Setup
    • Quick Start Guide: Precision Capture
    • Quick Start Guide: Tutorial Videos
    • Quick Start Guide: Active Marker Tracking
    • Quick Start Guide: Outdoor Tracking Setup
  • HARDWARE
    • Cameras
      • Ethernet Cameras
        • PrimeX 120
        • PrimeX 41
        • PrimeX 22
        • PrimeX 13
        • PrimeX 13W
        • SlimX 13
        • Prime Color
        • VersaX 22
        • VersaX 41
        • VersaX 120
      • USB Cameras
        • Slim 3U
        • Flex 13
        • Flex 3
        • V120:Duo
        • V120:Trio
        • Adjusting Global Origin for Tracking Bars
    • Prepare Setup Area
    • Camera Mount Structures
    • Camera Placement
    • Ethernet Camera Network Setup
      • General Overview and Specs
      • Windows 10 Network Settings
      • Cabling and Load Balancing
      • Switch Configuration for PrimeX 120
      • NETGEAR ProSafe GSM7228S: Disabling the Broadcast Storm Control
      • White/Blacklisting Cameras
    • USB Camera System Setup
      • USB Camera Network Overview and Specs
      • V120:Duo and Trio Setup
      • Tracking Bar Coordinate System
        • Transforming Coordinate System: Global to Local
    • Aiming and Focusing
    • Camera Status Indicators
  • MOTIVE
    • Installation and License Activation
    • Motive Basics
    • Calibration
      • .mcal XML Calibration Files
      • Continuous Calibration
      • Continuous Calibration (Info Pane)
      • Calibration Squares
    • Markers
    • Assets
      • Gizmo Tool: Translate, Rotate, and Scale
    • Rigid Body Tracking
      • Aligning Rigid Body Pivot Point with a Replicated 3D Model
    • Skeleton Tracking
    • Trained Markersets
    • IMU Sensor Fusion
    • Data Recording
      • Data Types
    • Labeling
    • Data Editing
    • Data Export
      • Data Export: BVH
      • Data Export: C3D
      • Data Export: CSV
      • Data Export: FBX
      • Data Export: TRC
    • Data Streaming
    • Camera Video Types
    • Audio Recording
    • Motive HotKeys
    • Measurement Probe Kit Guide
    • Motive Batch Processor
    • Reconstruction and 2D Mode
  • MOTIVE UI PANES
    • Settings
      • Settings: General
      • Settings: Assets
      • Settings: Live Pipeline
      • Settings: Streaming
      • Settings: Views
      • Settings: Mouse and Keyboard
      • Settings: Audio
    • Assets Pane
    • Builder Pane
    • Constraints Pane
      • Constraints XML Files
    • Calibration Pane
    • Data Pane
    • Devices Pane
    • Edit Tools Pane
    • Graph View Pane
    • Info Pane
    • Labels Pane
    • Log Pane
    • Probe Pane
    • Properties Pane
      • Properties Pane: Camera
      • Properties Pane: Force Plates
      • Properties Pane: NI-DAQ
      • Properties Pane: OptiHub2
      • Properties Pane: Rigid Body
      • Properties Pane: Skeleton
      • Properties Pane: Take
      • Properties Pane: Trained Markerset
      • Properties Pane: eSync2
    • Status Panel
    • Toolbar/Command Bar
    • Control Deck
    • Viewport
  • PLUGINS
    • OptiTrack Blender Plugin
      • OptiTrack Blender Plugin
    • OptiTrack Unreal Engine Plugin
      • Unreal Engine: OptiTrack Live Link Plugin
        • Quick Start Guide: Real-Time Retargeting in Unreal Engine with Live Link Content
        • Unreal Editor for Fortnite (UEFN): OptiTrack Plugin for Live Link Hub
        • Unreal Engine: Live Link Camera Stream Setup
        • Live Link Content: Active Puck Static Meshes
      • Unreal Engine: MotionBuilder Workflow
      • Unreal Engine: HMD Setup
      • Unreal Engine VCS Inputs
    • OptiTrack Unity Plugin
      • Unity: HMD Setup
    • OptiTrack OpenVR Driver
    • OptiTrack MATLAB Plugin
    • Autodesk Maya
      • Autodesk Maya: OptiTrack Insight VCS Plugin
    • Autodesk MotionBuilder
      • Autodesk MotionBuilder Plugin
      • Autodesk MotionBuilder: OptiTrack Skeleton Plugin
      • Autodesk MotionBuilder: OptiTrack Optical Plugin
      • Autodesk MotionBuilder: OptiTrack Insight VCS Plugin
      • Autodesk MotionBuilder: Timecode Data
    • OptiTrack Peripheral API
    • External Plugins
      • Houdini 19 Integration
  • ACTIVE COMPONENTS
    • Active Components Hardware
      • Active Puck
      • Wired AnchorPuck
      • CinePuck
      • Wired CinePuck
      • BaseStation
      • Information for Assembling the Active Tags
      • Manus Glove Setup
    • Configuration
      • Active Batch Programmer
      • Active Hardware Configuration: PuTTY
      • Active Component Firmware Compatibility
    • Active Marker Tracking
      • Active Finger Marker Set
  • SYNCHRONIZATION
    • Synchronization Hardware
      • External Device Sync Guide: eSync 2
      • External Device Sync Guide: OptiHub2
    • Synchronization Setup
    • OptiTrack Timecode
  • VIRTUAL PRODUCTION
    • Unreal Engine: OptiTrack InCamera VFX
    • Entertainment Marker Sets
    • PrimeX 41
  • MOVEMENT SCIENCES
    • Movement Sciences Hardware
      • General Motive Force Plate Setup
      • AMTI Force Plate Setup
      • Bertec Force Plate Setup
      • Kistler Force Plate Setup
      • Delsys EMG Setup
      • NI-DAQ Setup
      • Multiple Device Setup
    • Movement Sciences Marker Sets
      • Biomechanics Marker Sets
      • Biomech (57)
      • Rizzoli Marker Sets
    • For Visual3D Users
    • Prime Color Camera Setup
      • Prime Color Setup: Required Components
      • Prime Color Setup: Hardware Setup
      • Prime Color Camera Setup: Camera Settings
      • Prime Color Camera Setup: Prime Color FS Calibration
      • Prime Color Setup: Data Recording / Export
      • Prime Color Camera Setup: FAQ / Troubleshooting
      • Prime Color Camera Setup: Windows Network Settings
  • VIRTUAL REALITY
    • VR Plugins
      • VR Unreal Engine
        • OptiTrack Unreal Engine Plugin
        • Unreal Engine: OptiTrack Live Link Plugin
          • UE5.1 Live Link Retarget External Workaround
        • Unreal Engine VCS Inputs
      • VR Unity
        • OptiTrack Unity Plugin
      • VR OpenVR
        • OptiTrack OpenVR Driver
    • VR HMD Setup
      • Unreal Engine: HMD Setup
      • Unity: HMD Setup
      • Manually Calibrating the HMD Pivot Point
      • Sync Configuration with an HTC Vive System
    • SlimX 13
    • Active Marker Tracking
      • Active Finger Marker Set
    • Synchronization Hardware
      • External Device Sync Guide: eSync 2
      • External Device Sync Guide: OptiHub2
  • ANIMATION
    • Autodesk Maya
      • Autodesk Maya: OptiTrack Insight VCS Plugin
    • Autodesk MotionBuilder
      • Autodesk MotionBuilder Plugin
      • Autodesk MotionBuilder: OptiTrack Skeleton Plugin
      • Autodesk MotionBuilder: OptiTrack Optical Plugin
      • Autodesk MotionBuilder: OptiTrack Insight VCS Plugin
      • Autodesk MotionBuilder: Timecode Data
  • ROBOTICS
    • MoCap4ROS2 Setup
    • OptiTrack Robot Applications
    • Outdoor Tracking Setup
  • DEVELOPER TOOLS
    • Developer Tools Overview
    • Camera SDK
      • Class: cCameraModule
      • Class: cUID
    • Motive API
      • Motive API: Quick Start Guide
      • Motive API Overview
      • Motive API: Function Reference
      • Motive API Camera Calibration
    • NatNet SDK
      • NatNet 4.1
      • NatNet: Class/Function Reference
      • NatNet: Creating a Managed (C sharp) Client Application
      • NatNet: Creating a Native (C++) Client Application
      • NatNet: Data Types
      • NatNet: Matlab Wrapper
      • NatNet: Migration to NatNet 3.0 libraries
      • NatNet: Remote Requests/Commands
      • NatNet: Sample Projects
      • NatNet: Unicast Data Subscription Commands
      • Latency Measurements
    • VRPN Sample
    • Peripheral API: Glove Devices
  • SKELETON MARKER SETS
    • Full Body
      • Baseline (41)
      • Core (50)
      • Biomech (57)
      • Conventional (39)
    • Full Body + Fingers
      • Baseline + Passive Fingers (49)
      • Baseline + Active Fingers (57)
      • Core + Passive Fingers (54)
      • Core + Active Fingers (62)
    • Upper
      • Baseline Upper (25)
      • Conventional Upper (27)
    • Lower
      • Baseline Lower (20)
      • Helen Hayes Lower (19)
      • Conventional Lower (16)
    • Hand and Fingers
      • Left/Right Hand (4) Active
      • Left/Right Hand (10) Active + Passive
      • Active Finger Marker Set
    • Glove Device Setup
      • Manus Glove Setup
      • StretchSense Glove Setup
    • Rizzoli Marker Sets
    • Entertainment Marker Sets
    • Rigid Body Skeleton Marker Set
  • GENERAL TROUBLESHOOTING
    • Licensing Troubleshooting
    • Windows 11 Optimization for Realtime Applications
    • Network Troubleshooting
    • Troubleshooting Q&A
    • Running Motive on High DPI Displays
    • Firewall Settings
Powered by GitBook
On this page
  • Overview
  • Motive Data Streaming Setup (Server)
  • Streaming Settings
  • MotionBuilder Setup (Client)
  • Device Settings
  • Insight VCS Features
  • Creating a Virtual Camera Device (OptiTrack Server)
  • Step-By-Step
  • Creating a Virtual Camera Device (Universal Mode)
  • Step-By-Step
  • Controllers
  • Controller Profiles
  • Profile Setup
  • Typical Insight VCS Controller Map
  • Action Parameters
  • Curve Types
  • Button Actions
  • Run Script Usage
  • Virtual Camera Device Settings
  • MotionBuilder Camera Settings

Was this helpful?

Export as PDF
  1. PLUGINS
  2. Autodesk MotionBuilder

Autodesk MotionBuilder: OptiTrack Insight VCS Plugin

PreviousAutodesk MotionBuilder: OptiTrack Optical PluginNextAutodesk MotionBuilder: Timecode Data

Was this helpful?

Overview

This page provides instructions on how to use the OptiTrack MotionBuilder Virtual Camera Device (Insight VCS) plugin. The Virtual Camera device is specifically designed for creating a Virtual Camera in MotionBuilder. You can use the Insight VCS device with standard OptiTrack applications such as Motive, or you can use the device in "Universal" mode, which works with generic MotionBuilder Optical or RigidBody objects, allowing you to use the Insight VCS device with alternative motion capture systems that support optical or Rigid Body devices in MotionBuilder.

Motive Data Streaming Setup (Server)

First, you'll want to follow the instructions below to set up the data streaming settings in Motive. Once this is configured, Motive will be broadcasting tracking data onto a designated network interface where client applications can receive them.

Streaming Settings

  • Enable - Turn on the Enable setting at the top of the NatNet section.

  • Local Interface - Choose the desired IP network address from this dropdown to stream data over.

    • Loopback

      • This is the local computer IP address (127.0.0.1 or Localhost).

      • Used for streaming data locally on the PC you are running Motive on that does not interact with the LAN.

      • Good option for testing network issues.

    • 192.168.0.1x (typical, but may be different depending on which interface is used to establish a LAN connection)

      • This IP address is the interface of the LAN either by Wi-Fi or Ethernet.

      • This will be the same address the Client application will use to connect to Motive.

  • Transmission Type

    • For streaming over a Wi-Fi network, setting the Transmission Type to Unicast is strongly advised.

  • Select desired data types to stream under streaming options:

    • Rigid Bodies - Enabled (required).

    • Skeletons - Optional for Skeleton tracking.

    • Markers (Labeled, Unlabled, Asset) - Disabled for HMDs (advised).

    • Devices - Disabled.

  • Skeleton Coordinates

    • Set to Local.

  • Bone Naming Convention

    • When streaming Skeletons, set to FBX.

Additional Tips

  • For best results, it is advised to run Motive and MotionBuilder separately on different computers, so that they are not competing for processing resources.

  • When streaming the data over a Wi-Fi network, Unicast transmission must be used.

  • In order to stream data from the Edit mode, a capture-recording must be playing back in Motive.

MotionBuilder Setup (Client)

To get started, drag the OptiTrack Optical plugin from the Motion Builder Asset Browser tab > Devices into the Viewer window. This will create a dropdown menu called I/O Devices in the Navigator tab. Click the + button next to I/O Devices and select OptiTrack Optical. This will populate the plugin's settings tab if it hasn't already auto-populated from the drag and drop step from earlier.

Device Settings

  • Local address - IP address of the MotionBuilder computer. In situations where multiple network adapter cards are present, select the adapter that is on the same network as the Motive application.

    • 127.0.0.1

      • This is the local computer IP address (127.0.0.1 or Localhost).

      • Use this loopback address if Motive is running on the same machine as MotionBuilder.

    • 192.168.0.1x (typical, but may be different depending on which interface is used to establish a LAN connection)

      • This IP address is the interface of the LAN either by Wi-Fi or Ethernet.

      • Use this if Motive is running on a different computer, but on the same network as the MotionBuilder computer.

    • 169.xxx.x.xx

      • This address is assigned when a DHCP server could not be reached.

      • This address can be ignored for our application.

  • Server Address - IP address of computer that is running Motive

    • 127.0.0.1

      • Use this IP when both Motive and MotionBuilder are running on the same computer.

  • Server Type

    • Multicast (default) or Unicast

    • Must match what is selected in the Motive Streaming settings.

    • Multicast is default and recommended.

Once the above settings are input appropriately, you'll want to click the box next to Online. This indicate whether or not Motive is successfully streaming to MotionBuilder.

  • Online color indicator

    • Green - Connected and streaming.

    • Yellow - Connected but not streaming.

    • Red - Not connected or streaming.

  • Live

    • Indicates to MotionBuilder that data is coming from a live source (checked) or from a recorded take.

  • Recording

    • Indicates to MotionBuilder that data from this device should be recorded when MotionBuilder is recording.

  • Model Binding

    • Indicates the MotionBuilder Camera to be controlled by the tracking controller.

  • Device Information

    • Information about the status of the connection.

  • OptiTrack Connection

    • Indicates the data source is an OptiTrack server application.

  • Universal Connection

    • Indicates the data source is a generic MotionBuilder RigidBody.

  • Rigid Body ID

    • [OptiTrack Connection] Name of the OptiTrack server application’s Rigid Body to use for tracking.

  • Rigid Body

    • [Universal Connection] Name of the MotionBuilder RigidBody to use as a position/orientation source.

Insight VCS Features

Feature
Description

Pan/Dolly/Boom

Use VCS controls to Pan Left/Right and Up/Down. Pan in local, world, or a combination of coordinate systems. Adjust pan speeds on the fly with controls or scripts.

Pitch/Tilt/Roll

Absolute orientation at all times from the OptiTrack optical system.

Free Move

Absolute position at all times from the OptiTrack optical system. Scale movement in real-time with controllers or from script.

Zoom

Fully control camera zoom/FOV and zoom rates using the controller's analog thumbsticks and speed adjusters.

Smooth

Advanced Kalman filtering allows for customizing a "Steadicam" feeling.

Play/Record

Control common actions like recording and playback using the controller.

Custom Commands

Customize the controller by mapping controller inputs to execute scripts for complete control and one-person camera operation.

The Virtual Camera also integrates into existing MotionBuilder camera control workflows, including spline/path/constraint animation and custom scripted behaviors.

Creating a Virtual Camera Device (OptiTrack Server)

First you'll need to create the "neutral" or "zero" orientation of a Rigid Body

The “neutral” or “zero” orientation of a Rigid Body is the orientation when it is created in Motive. This will be the camera’s neutral orientation. In addition, for correct interpretation into MotionBuilder’s coordinate system, it is important you align your Rigid Body with the correct axis and coordinate system convention as follows:

  • Point your tracking controller (e.g. VCS Pro) along physical volume -Z axis.

Step-By-Step

After correctly orienting your Rigid Body follow the steps below to continue with the setup:

  1. [Motive] Create a Rigid Body from your tracking controller’s markers.

  2. [OptiTrack Server App] Enable network streaming (make sure Rigid Body data is streaming).

  3. [MotionBuilder] Drag the OptiTrack Insight VCS device from the Motion Builder Asset Browser Panel into the Viewer or Navigator window.

  4. [Insight VCS Panel] Connect to an OptiTrack Server (e.g. Motive, Arena, TrackingTools) by clicking the “Online” checkbox. If the connection was successful and data is streaming from you OptiTrack server application, this box will change from Red to Green.

  5. [Insight VCS Panel] Create a new MotionBuilder camera using the Model Binding dropdown.

  6. [Insight VCS Panel] [Optional] If tracking more than one Rigid Body object in your OptiTrack server application, select the Rigid Body you wish to use as your tracking source using the Rigid Body ID dropdown on the CameraTracker device panel (Note: the camera tracker will automatically default to the first detected Rigid Body).

You should now see a standard MotionBuilder Camera moving within your 3D scene:

Creating a Virtual Camera Device (Universal Mode)

In Universal mode, a MotionBuilder Rigid Body is used to drive a camera position. This position/orientation information is merged with the VCS camera controls and applied to the camera's final state (position, lens settings, etc.). It is assumed the Rigid Body orientation matches the MotionBuilder default camera orientation (camera lens aimed down +X axis). For example, if streaming from Motive, create a Rigid Body in MotionBuilder from the optical data, with the camera lens aimed down +X in MotionBuilder.

Step-By-Step

  1. [MotionBuilder] Create a Rigid Body or a Marker. For a Marker:

    • Create a bone (or some rigid element) from the geometry your 6DOF system streams into MotionBuilder

    • Create a MotionBuilder "Marker" element, and make this new marker a child of the bone

    • This new “Marker” marker should now have the same 6DOF value as the bone

    • . Use this “Marker” in the VCS universal dropdown to drive the 6DOF data of the VCS.

  2. [Insight VCS Panel] Check the "Universal Connection" Radio.

  3. [Insight VCS Panel] Check "Online".

  4. [Insight VCS Panel] Create a new MotionBuilder camera binding using the Model Binding dropdown.

  5. [Insight VCS Panel] Select the Rigid Body you created in step 1 using the Rigid Body dropdown in the Universal Connection group box.

Limitations

  • The following VCS features/properties are unavailable when operating in Universal Mode:

  • Scale Rotation

  • Offset Rotation

Controllers

The Insight VCS plugin supports any DirectInput compatible joystick or USB device. Controllers can then be configured to perform actions or control the camera using Controller Profiles.

Controller Profiles

Virtual Camera controls are managed by a Control-to-Event mapping system called the Controller Profile. The controller profile is configured in the Controller Tab. The Insight VCS plugin allows you to create and swap between multiple controller profiles, allowing you to create any number of custom button/axis configurations depending upon the scene, particular move types, different physical VCS controllers or HID devices, etc. Profiles can be saved and then later swapped out using the Profile Dropdown. Profiles are saved into <VCS Mobu install folder>\Profiles folder.

The VCS plugin ships with 2 default profiles:

  • The 2 controller VCS Pro (<VCS Mobu install folder>\Profiles\VCSProDefault.xml).

  • The XBox based VCS Mini (<VCS Mobu install folder>\Profiles\VCSMiniDefault.xml).

When the Insight VCS plugin is first launched, it will attempt to detect any compatible controllers. It will then attempt to match the detected controllers with an existing Controller Profile, beginning with the last used ("preferred") profile.

Profile Setup

The VCS plugin supports 2 types of controller inputs and 2 types of actions:

Axis Inputs / Actions

  • Axis inputs are analog inputs and represent the range of values. This range has been scaled to [0, 1000]. Axis inputs can be assigned to Axis actions. PTZ operations (Pan, Tilt, Zoom) are good examples of typical Axis Actions.

Button Inputs / Actions

  • Button inputs are the button inputs on the controller. These are “one shot” events that occur when the button is pressed. Transport commands such as Play, Record, and Rewind are typical examples of “one shot” events.

Some Insight VCS controllers have a dial that is represented in the Axis list as a "Wheel". This is a special form of an axis, and can be used to modify existing actions, such as zoom speed, pan speed, and motion scale amount.

Typical Insight VCS Controller Map

Insight VCS Inputs/Action Settings

Axes

Name of the controller’s analog input.

Action

Action to take or value to change.

Param

Input parameter used by some actions to modify the action in some way (e.g. speed up or slowdown zooming).

Value

Current value of the control input.

Action Parameters

Some actions have parameters that modify the way they operate. The following tables list the axis and button actions, and how the parameter value for that action is interpreted.

VCS Controller - Axis Actions

Action
Parameter(s)
Example

Pan Right/Left

[Pan Speed] [Curve Type]

  • 1.0 [ pan at normal rate, linear curve]

  • 1.0 1 [ pan at normal rate, ease-in curve]

  • 0.5 1 [ pan at half speed, ease-in curve]

  • 2.0 [ pan at 2x speed ]

Dolly In/Out

[Pan Speed] [Curve Type]

1.0

Pan Up/Down

[Pan Speed] [Curve Type]

1.0

Focal Length +/-

[Focal length change rate] [Curve Type]

1.0

Orbit Offset

[Orbit offset change rate] [Curve Type]

1.0

Focal Distance

[Focal distance change rate] [Curve Type]

1.0

Wheel Modifier

[VCS Dial controls only] Modify an axis' parameter value (e.g. zoom speed, pan speed, translation scale) by a specified increment.Format:

  • [axis name] [increment]

Examples:

  • X Axis .1 (+/- the X Axis parameter by 0.1)

  • Y Axis .2 (+/- the Y Axis parameter by 0.2)

  • Z Axis .1 (+/- the Z Axis parameter by 0.1)

  • Scale All .5 (+/- all translational scale by .5)

  • Translate All 1.0 (+/- all pan speeds by 1.0)

Rotate Right/Left

[Rotate Speed] [Curve Type]

  • 1.0 [ rotate at normal rate, linear curve]

  • 1.0 1 [rotate at normal rate, ease-in curve]

  • 0.5 1 [rotate at half speed, ease-in curve]

  • 2.0 [rotate at 2x speed ]

Rotate Up/Down

[Rotate Speed] [Curve Type]

SAME AS ABOVE

Tilt Right/Left

[Rotate Speed] [Curve Type]

SAME AS ABOVE

Curve Types

When mapping a controller thumbstick axis to an animatable camera parameter (pan, zoom), you have the option of specifying how the Insight VCS plugin should interpret controller axis movement as a standard animation curve. Instead of modifying the value over time, however, the motion curve modifies the value over the controller span, from neutral/center position (0) to maximum position (Max). The following diagram describes this relationship:

Button Actions

VCS Controller - Button Actions

Action
Parameter
Example

Record

Copy data from previous take.

true

Play

None.

Fullscreen

Toggles between Fullscreen and the MotionBuilder GUI. On return to the MotionBuilder GUI, this parameter indicates the number of viewports to show.

2

RunScript

Runs a MotionBuilder python script. This script must be located in your MotionBuilder scripts root folder.

ResetOffset.py

ToggleAxisAction

  • Toggles a specified axis between 2 actions.

  • [Axis name],[Action1 Index], [Action1 Params],[Action2 Index],[Action2 Params]

  • The example at right toggles the Y Axis behavior between Dolly In/Out at speed 1.0 with a Cubic Curve and Focal Length at 0.1 speed with a Quartic curve.

  • This action can be used to extend axis functionalitywithout swapping profiles.

Y Axis, 3, 1.0 1, 4, 0.1 2

Pause

None.

Stop

None.

Rewind

None.

Suspend Tracking

None.

Scale Translation +/-

Increment amount.

.5

Scale Rotation +/-

Increment amount.

.5

Zoom +/-

Increment amount.

.5

FOV +/-

Increment amount.

.5

Playback Speed +/-

Enumerated value that matches MoBu transport.

2

Reset Zoom

Focal Length to reset to.

50.0

Reset Offset

[x y z] Optional - specifies the position to reset camera to, otherwise camera is reset to (0.0,0.0,0.0).

10.0 10.0 0.0 [reset camera offset to 10,10,0]

Reset Rotation Offset

[x y z] Optional - specifies the rotation vector to reset to (in degrees), otherwise camera is reset to (0.0,0.0,0.0).

0.0 90.0 0.0 ( reset camera to 90 degrees yaw)

Reset Orbit Offset

None.

Change Camera

None.

Play Last Take

None.

Reset to Live

None.

Run Script Usage

When using the Run Script action to map button presses to MotionBuilder scripts, be sure to note the following:

  1. Scripts must be placed in the MotionBuilder scripts folder in order to be correctly located. For a typical MotionBuilder installation this folder is:

    • C:\Program Files\Autodesk\MotionBuilder 2014\bin\config\Scripts:

  2. The RunScript Param is the filename of the script, including the .py extension:

Virtual Camera Device Settings

The Insight VCS plugin has several properties that can be used to customize its behavior. These properties can be accessed in the same manner as any other MotionBuilder object property, such as from the Asset Browser or from MotionBuilder's Python scripting environment.

Action
Parameter

Scale Translation

Scale the physical movement (when tracking controller is moved).

Scale Rotation

Scale the physical movement (when tracking controller is moved).

Offset Translation

Can be used for 2 purposes :

  1. To adjust the center of the physical volume to the virtual scene.

  2. To effectively pan/truck/dolly the camera. This value is updated by the thumbstick controls for the Pan/dolly/truck operations

OffsetTranslationMode

Affects how Offset Translation is applied to the camera:

  • 0 : Global Translates the camera according to the MotionBuilder global coordinate system (global)

  • 1 : Local Translates the camera according to the camera’s coordinate system (local).

  • 2 : LocalOnStart Translates the camera according to the camera’s coordinate system when the camera first moves (stick first moves), then keeps that axis (Does not continuously update the coordinate system).

Boom Global Always

Always pan camera up/down in the global Y axis, regardless of the OffsetTranslationMode

Scale Updates Offset

Instructs whether changes to Scale Translation update the Offset Translation value in order to keep the camera in the same position (true) or does not affect Offset Translation, resulting in camera position moving to new scaled amount.

Smooth Translation Amount

Applies smoothing to the camera position values.

Smooth Rotation Amount

Applies smoothing to the camera rotation values.

Dead Zone

Controller thumbsticks do not typically restore to an exact center value. Dead Zone can be used to specify a value range around thumbstick center that should be ignored. This can be used, for example, to prevent drift in pan/dolly/zoom when thumbsticks are mapped to these actions.

MotionBuilder Camera Settings

A MotionBuilder Camera controls how you see the 3D scene. MotionBuilder’s Camera object allow users the ability to model realworld cameras, including settings such as Focal length, aspect ratio, film format, etc.

Before following the walkthrough below, please refer to for initial steps for setting up motive and downloading the OptiTrack MotionBuilder plugin.

For additional information on data streaming in general, read through the page.

Refer to the for more information on Camera Settings.

Autodesk MotionBuilder Plugin page
Data Streaming
MotionBuilder documentation
Camera Tracking in MotionBuilder.
Asset Browser tab > Devices view of the plugins.
Navigator tab.
OptiTrack MotionBuilder Skeleton Plugin settings.
Controller orientation with CS-400 ground plane. Any ground plane can be used, but just make sure it oriented correctly along the physical -Z axis (longest side of ground plane).
Camera in 3D scene.
Insight VCS Controller Map tab.
VCS Plugin built-in curve options.
Insight VCS Properties.