<cat>Dev.Cinematic</cat> <title>Depth Of Field</title> <upload src="739b0/8d7b02b80a65969.jpg" size="99362" name="rust-wiki_dof_header2.jpg" />⤶ # Getting Started Enable depth of field using the command `dof 1` Enable camera depth of field by using the command `dof 1` ## Aperture `dof_aper <amount>` - Adjust the focus range for the camera's depth of field, i.e. the area size which is in focus. `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>` - Specify the amount of blur applied in out of focus areas. Decent results can be achieved by matching the blur amount to the [aperture](/rust/Depth_Of_Field#aperture) amount, then modifying from there. `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) amount, then adjusting from there. # Focus Modes ⤶ Depth of field currently has two modes - **auto** and **manual** focus. ⤶ 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. 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. # Manual Focus Settings The following commands are only applicable when `dof_mode 1` is enabled.⤶ # 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. 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. ## 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 <1/0>` - Enable/disable a debug depth pass; a monochromatic preview of the current focus settings. `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" />