Rust Wiki

Revision Difference

Depth_Of_Field#522342

<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" />