CameraTools

Capture different camera positions. Create cinematic transitions between them.
Inspired by Cities Skylines mod Cinematic Camera Extended by SamsamTS.

Camera List (Alt+F5)

Manage a list to store stationary camera positions and angles. Those can apply across saves.

• Add Camera: If the player is on planet, add planet camera. Otherwise add space camera.
  Planet camera will only work on the local planet. It can't be viewed from space.
  Space camera is stored by uPosition which home star is the origin. It can't be viewed from planet.
• View: Set the current main camera to the target camera. Click again or esc to exit.
• Edit: Edit camera position, rotation, field of view.

Camera Config

To edit the field, click on the edit button first, input new value, then click set button to apply.
In polar coordinate, the orignal is either local planet or local star (space camera).

Adjust Mode with Freecam

Click on the button to modify the editing camera position and angle with free 3D camera.

• WASD: Pan movement in local frame
• Scroll up/down: Forward and backward movement
• Shift: Hold to increase cam movement 10 times
• Middle mouse: Hold to rotate
• Right click: Hold to roll

Path Config (Alt+F6)

Create a camera path moving from point to point.
You can edit clip duration, key point progression time and camera settings.
The path used on planet should not be used in space, vice versa.
To edit the field, click on the edit button first, input new value, then click set button to apply.

Playback control

The top area is playback contorl. The timeline slider can preview the path (need to enable Viewing first).
Progress time is [0,1]. The buttons are to start (|<<), play, to end (>>|).
Duration is time length of the whole path in second.
Interp can choose from 3 different interpolation: Linear, Spherical, Curve.

• Linear interpolation is straight line from one point to another.
• Spherical will make piecewise path into arc by adjusting altitude with interpolated value.
• Curve will use Unity's AnimationCurve to make a smooth curve path.

Keypoint control

The bottom scroll area is for keyframe (camera pose + time) control. To make a valid path, add at least 2 cameras.
The keyframe foramt can be displayed in either raio [0,1], or in second.
When Auto Split toggle is on, it will evenly split time ratio for all the keypoints.

• Insert keyframe will insert the current view into the current progression time.
• Append keyframe will add the current view at the last of all keyframes.

Path List

The top input field can change the name of the current path.
Close the window to save the name change.

Installation & Mod Config

Via r2modman, or manual download the file and put CameraTools.dll in BepInEx/plugins folder.
Keyboard shortcuts can be changed in the mod config window.
All mod config together with stored camera data is in BepInEx\config\starfi5h.plugin.CameraTools.cfg.

In config window - IO tab, it can import/export config file containing the camera and path data.
Input field to input the target file path. The acceptable file extension is .cfg.
After importing success, user can choose to import all cameras or all paths from the file.

Known issues

• The star image will distort when space camera position is different from player's.
  It can be fixed by letting player move along with space camera in mod config.
• Rotation is not smooth enough in curve camera path with respect to position changes.

ChangeLogs

v0.3.0

• Fix camera path is not smooth in space. Add VectorLF3 json convertor in TomlTypeConverter.
• Make windows resizeable by dragging outside area of bottom-right corner.
• Add import/export config file option in config window - IO tab.
• Path: Add curve interpolation.
• Path: Add insert keyframe option in path config window.

v0.2.0

• Fix flickr when overwritten mecha space position.
• Cam: Add freecam adjust mode and polar coordinate in camera config window.
• Path: Add spherical interpolation, keyframe format switch and keypoint reorder in path config window.
• Add ToggleLastCameraShortcut, CycyleNextCameraShortcut in plugin config.
• Remember window positions after closing them.

v0.1.0

• Initial released. (DSP 0.10.30.23430)

Video-camera icons created by prettycons - Flaticon