Revision Difference
Depth_Of_Field#526794
<cat>Dev.Cinematic</cat>
<title>Depth Of Field</title>
<upload src="739b0/8d7b02b80a65969.jpg" size="99362" name="rust-wiki_dof_header2.jpg" />
# DOF Basics
Enable camera depth of field by using the command `dof 1`. Use `dof 0` to disable it.
## Aperture
`dof_aper <amount>` - Sets the focus range for the camera's depth of field, i.e. the area size which is in focus.
Smaller values produce a wider area of focus, higher values create a narrower focus range.
## Blur Amount
`dof_blur <amount>` - Specifies the amount of blur applied to the out of focus areas.
Decent results can be achieved by matching the blur amount to the [aperture](/rust/Depth_Of_Field#aperture), then adjusting from there.
# Focus Modes
There are currently two modes for camera depth of field - **auto** and **manual** focus.
Use the command `dof_mode <0/1>` to switch between modes. `0` = auto, `1` = manual
## Auto Focus
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.
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 - e.g. 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/Depth_Of_Field#manualfocus)
## Manual Focus
Manual mode allows setting focus to a specific distance from the camera by using the [focus distance](/rust/Depth_Of_Field#focusdistance) command and adjusting the time it takes to reach that distance by using the [focus time](/rust/Depth_Of_Field#focustime) command.
# Focus Settings
The following commands are mostly applicable to manual mode:`dof_mode 1`
## Focus Distance
`dof_focus_dist <amount>` - Distance from camera to focus - measured in units.
Parsing the command without an amount specified will print the current focus distance in the console.
## Focus Time
`dof_focus_time <amount>` - The time it takes (in seconds) to reach a new focus distance. 0 will be an instant change.
Useful for lerping between focus points triggered either by a bind or when [nudging](/rust/Depth_Of_Field#focusnudging) the focus distance. This commmand can also be used in [auto mode](/rust/Depth_Of_Field#autofocus) for smoother focus alterations.
Useful for lerping between focus points triggered either by a bind or when [nudging](/rust/Depth_Of_Field#focusnudging) the focus distance. This command can also be used in [auto mode](/rust/Depth_Of_Field#autofocus) for smoother focus alterations.
## 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.
`dof_nudge <amount>` - Incrementally modify the focus distance by a specified amount. Both positive `+` and negative `-` values are accepted in the amount parameter, e.g. `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 <1/0>` - Enable/disable a debug depth pass; a monochromatic display of the current focus settings.
This command is useful for previewing the DOF's focus range and achieving precise focus distances in manual mode.
Black indicates areas in focus, white indicates areas out of focus.
**Example:**
<upload src="739b0/8d7b02af97c953b.jpg" size="456170" name="rust-wiki_dof_debug-preview.jpg" />