

Sets the f-stop value for the physical lens you want to match when defocusing. Sets the focal length of the physical lens you want to match when defocusing. When disabled, the Lens controls have no effect. When enabled, you can use the Lens controls to match your physical lens characteristics, such as Focal Length and Aperture. If you notice artifacts in your output from deep data, try enabling this control to reduce the artifacts produced by simultaneous integration. When enabled, front and back deep data from the Deep input is integrated separately. When Output Type is set to Focal Distance Visualization, color values in the output are limited to the 0-1 range when this control is enabled. By default, the defocus effect is limited to the non-black areas of this channel. Disabling this checkbox is the same as setting the channel to none. Sets the falloff applied between the focal plane and the front and back regions of the image.Įnables the associated mask channel to the right. Larger values increase the width of the plane. Note:Set the Output Type to Focal Distance Visualization to see a representation of the focal plane in red and the front and back regions in green and blue.Ĭontrols the size of the plane totally in focus. Lower values move the plane towards the front of the image and higher values move the plane towards the back of the image. Note:If you're using deep data, this control has no effect.Ĭontrols the plane on which the image is totally in focus. 1/z - uses values similar to those output by ScanlineRender nodes to calculate the defocus.Real - uses real world values to calculate the defocus.Sets the amount of defocus applied to the back focus region in addition to the defocus applied by the Multiplier control.Ĭontrols how the depth information is interpreted: Sets the amount of defocus applied to the front focus region in addition to the defocus applied by the Multiplier control. Sets the overall amount of defocus applied to the image. You can switch this control to just output the front or back regions to make adjustments to individual multipliers without taking the processing hit for both regions. Sets whether the Front, Back, or Both focus regions are output to the Viewer. Focus Mattes - Front/Back mattes for the focus.Filter Shape - preview the shape of the kernel.Tip:Increasing the Focus Region Size can help differentiate between regions. Blue - areas of the image behind the focal plane.Green - areas of the image in front of the focal plane.Red - the focal plane, where your image is fully in focus.This option displays where your focus plane is located in the image: Focal Distance Visualization - preview the focal distance values.Lens Bloom - displays just the bloom effect.Defocused Image - displays the input image with the Bokeh effects applied.Note:You can defocus an image without using any additional depth data, but the result is uniformly defocused by the Multiplier control. Specifies the input channel containing the depth map information. If you set this to something other than all or none, you can use the checkboxes on the right to select individual channels. The effect is only applied to these channels. The image to which you want to apply the effect. This input is only used when the Kernel Type is set to Input in the node properties. If you cannot see the Mattes input, ensure that the Default Matte Channel control is disabled or set to none.Īn optional input to use Deep data as the depth channel.Īn optional input to use Camera node data to determine the focal plane.Īn optional input to control the shape of the defocus kernel. By default, the effect is limited to the non-black areas of the mask.Īt first, the Mattes input appears as a triangle on the right side of the node, but when you drag it, it turns into an arrow labeled mask. Inputs and ControlsĪn optional input to use as a mask. You can also control the shape of the defocus kernel using the Kernel input. The native version of Bokeh is backwards compatible with version 1.4.8 of the pgBokeh plug-in.īokeh defocuses an image according to a Z depth map, Deep data, or Camera information and allows you to control where the focal plane lies so you can focus on specific elements in an image, and simulate real-world lenses. Bokeh is a plug-in originally developed by Peregrine Labs and acquired by Foundry in 2022.
