Revision Difference
Cinematic_Tools#522331
<cat>Dev</cat>
<title>Cinematic Tools</title>
This page outlines the available tools and commands related to cinematics and video content creation.
# Debug Camera
# Depth of Field
Enable depth of field using the command `dof 1`
## Focus Modes
Depth of field currently has two modes - **auto** and **manual** focus.
Use the command `dof_mode <0/1>` to switch between modes. `0` = auto, `1` = manual
## Auto Focus
⤶
`dof_mode 0`⤶
This is the default mode for depth of field. Focus distance is automatically adjusted to a point of interest being looked at in the centermost part of the screen - eg. an entity (player, npc, deployable, etc) or a world object.
Auto focus is generally good for achieving quick results, but it's not perfect. For finer control use [manual mode.](/rust/Cinematic_Tools#manualfocus)
## Manual Focus
`dof_mode 1`⤶
⤶
Manual mode allows setting focus to a specific distance from the camera - as specified using the [focus distance]() command.⤶
Manual mode allows setting focus to a specific distance from the camera by using the [focus distance](/rust/Cinematic_Tools#focusdistance) command and adjusting the time it takes to reach that distance by using the [focus time](/rust/Cinematic_Tools#focustime) command.⤶
⤶
⤶
⤶
⤶
### Focus Distance⤶
⤶
`dof_focus_dist <amount>` - Distance from camera to focus - measured in units. ⤶
⤶
⤶
### Focus Time⤶
⤶
`dof_focus_time <amount>` - The time it takes (in seconds) to reach a new focus distance. 0 will be an instant change.⤶
## Focus Distance⤶
⤶
Distance from camera⤶
⤶
## Focus Time⤶
⤶
The time it takes to reach a new focus distance. 0 will be an instant change.⤶
## Focus Nudging⤶
Increase or decrease the focus distance amount by a certain amount - almost like a focus wheel.
⤶
### Focus Nudging⤶
`dof_nudge <amount>` - Incrementally modify the focus distance by a specified amount. Both positive `+` and negative `-` values are accepted in the amount parameter, eg. `dof_nudge 1.5` will increase the focus distance by 1.5 units and `dof_nudge -1.5` will decrease it by 1.5 units.⤶
⤶
Nudging is also useful when applied as a bind. You can pull focus by setting nudge amounts to the <key>mousewheel</key>⤶
⤶
Example: `bind mousewheelup "dof_nudge 1.5"` and `bind mousewheeldown "dof_nudge -1.5"`⤶
## Focus Debug⤶
⤶
`dof_debug <0/1>` - Enable/disable a debug pass for depth of field - provides a 1:1 preview of focus settings.
⤶
Black = in focus, white = out of focus.