Motion Controller

From RealMotion Wiki

3D/Camera/Motion Controller

Animates 3D objects (Camera) based on the Pointer and Keyboard Devices. ​

Description

The Motion Controller box allows to simply animate Camera or 3D objects based on the input Pointer and Keys inputs. The box has 3 modes: Target, Walk or Fly.

The connection to the Pointer allows the user to control the camera. The following keys are used:
- W or Arrow Up: Move Forward
- A or Arrow Left: Move Left
- S or Arrow Down: Move Backward
- D or Arrow Right: Move Right
- Ctrl: Strafe down
- Shift: Strafe Up
- Mouse: Change camera direction when allowed.

Note that changes made with those keys are not saved. Only changes in parameters are saved and the box resets to these parameters at each run.

Inputs

Keys Keyboard Event Vector Acquires the Keys input.
Pointers Pointer Event Vector Acquires the Pointers input.

Outputs

Position Float3 Outputs the position of the Motion Controller.
Target Float3 Outputs the target point of the Motion Controller.
Transform Transform Outputs the transformation resulting from the motion input.
Up Float3 Outputs the up vector of the Motion Controller.

Parameters

General

Lock Motion Toggle Locks the Motion Controller at the current position.

Orientation

Position Float3 Sets the XYZ position.
Direction Float3 Sets the XYZ normalized direction vector of the camera. Visible only when the Behavior is set to Walk or Fly mode.
Up Float3 Sets the XYZ normalized Up Vector of the camera. The default value is (0,1,0). Visible only when the Behavior is set to Fly mode.
Target Float3 Sets the XYZ target position. Visible only when the Behavior is set to Target mode.

Behavior

Mode String Changes the behavior of the Motion Controller. In Target Mode, the controller turns around the target and always point toward this target. In Walk Mode, the controller moves on the ground. The ground is by default at 0 on the y-axis. In Fly Mode, the controller moves freely in the 3D environment.

Advanced

Acceleration Float Sets the acceleration of the Motion Controller when a key is pressed and held. If set to 0.0, no motion occurs. If set to 1.0, perpetual motion occurs.
Rotation Speed Float Sets the initial rotation speed of the Motion Controller.
Translation Speed Float Sets the initial translation speed of the Motion Controller.

Output

Enable Output Pin: Position Toggle Enables the Position Output Pin.
Enable Output Pin: Up Toggle Enables the Up Output Pin.
Enable Output Pin: Target Toggle Enables the Target Output Pin.

See Also

Boxes related

Camera, Camera Components, Model 3D, Scene Renderer, Float3, ​​

Version Information

Current documentation version: 2.1.1. ​ ​