All Controls Explained

The main script OrbitalCameraSystem is divided into multible foldable sections:

The Rig

Contains the references to the 3 objects in the rig structure. You would normally never need to modify this.

Camera Position

Controls the intial rotation, tilt and zoom distance for the Camera.

Beware that the initial values can only be within the limits set in the Settings section.

Mouse

1. Toggle on/off the use of mouse for movement, rotation (around y-axiz) and tilt (height of the camera / angle looking down).

2. Pick which mouse buttons should be used for what. Note: you should not use the same mouse button for both features.

3. Toggle camera movement by edge scrolling. Default is off.

4. Toggle the use of mouse wheel for zoom.

5. Mouse Wheel Sensitivity: How much movement is provided from one turn of the scroll wheel. This is used to balance the speed between touch zoom and mouse zoom. The overall speed should be adjusted in the Speeds section.

Keyboard and UI Buttons

The keyboard and UI buttons function in a similar way: You hold a button, and while it is held, the action is performed. To allow for any number of keys and buttons, I have made a modular input component system for this. You can add as many input components you would like, each with their own key/button bindings.

1. Toggle on/off the use of input components for movement, rotation/tilt or zoom.

2. Use this button to add new input components.

Note: The input components can also be added with the objects own Add Component button. They are located under the Goehler Studios category.

Touch

1. Toggle on/off the use of touch for movement, rotation (around y-axiz) and tilt (height of the camera / angle looking down).

2. Pick which TouchGesture should be used for what. Note: you should not use the same touch gesture for both features.

3. Toggle the use of pinch gesture for zoom.

4. Pinch Sensitivity: How much zoom movement is provided from the pinch gesture. This is used to balance the speed between touch zoom and mouse zoom. The overall speed should be adjusted in the Speeds section.

Speeds

1. Adjust Movespeed by Camera Height will automatically speed up the keyboard and button controls for movement, the higher the camera is above the ground. The drag movement with mouse or touch is not affected.

2. Edge scrolling speed

3. Key and UI Button movement speed: Meters pr. second (when adjust movespeed by camera height is off)

4. Key and UI Button rotation/tilt speed: Degrees pr. second

5. Key and UI Button zoom speed: Meters pr. second (when zoom method is linead)

6. Mouse and Touch multiplier for rotation/tilt speed.

7. Maximum movement speed while dragging the ground. To prevent insane movements if dragging near the horizon.

8. Mouse and Touch zoom speed multiplier.

9. Default animation time when using the Public API.

Settings

1. The minimum and maximum tilt angle. Note that the max angle is clamped at 88 degrees. This is to avoid gimbal lock.

2. The Zoom Method:

• Linear - The camera moves a fixed amount with each scroll/pinch
• Exponential - The camera moves a percentage of the distance to the target with each scroll/pinch. This will speed up the movement the further you get from the ground. Ideal for very large zoom ranges.

3. The minumum and maximum zoom distances. Note: The minimum is clamped at 0.001.

4. Toggle to invert the X or Y axis of the rotation/tilt input vector.

Special Features

1. Prevent mouse and touch interaction while the pointer is over any UI element, like fx. a button.

2. Use the bounding box to set a rectangular perimeter from which the player can never escape.

3. Follow terrain height will keep the camera level with the terrain. This should be set up with a TerrainLayerMask to reduce the performance cost.

4. Locking the camera origin onto a target will ensure the camera follows that target around. It will also disable the Follow Terrain Height feature, and prevent the player from moving the camera manually. Note: this feature can be set/unset via the Public API