PhysicalBokeh3DSelective is a Matchbox effect dedicated to creating Lens Effects. It is similar to PhysicaBokehSFX, but with the ability to use different type of 3D data that Action is able to provide when used as a post processing effect when applied to the output Camera as a Camera FX. The Selective menu allows you to use different image segmentation methods to isolate section of the 3D scene, and then apply the effect selectively.

Controls Menu

Highlights Options

Threshold

Sets the colour value threshold over which a colour is considered a highlight.

Max Threshold

Sets the maximum colour value to be used as a highlight: values over this limit are not considered a highlight. Enabled by Enable Max Threshold.

Gain

Boosts or reduces the highlights selected by Threshold and Max Threshold. A larger Gain value creates brighter and larger bokeh.

Kernel Options

Type

Specifies the source of the kernel used: Bokeh and ROI Sampling. The Bokeh mode (the default) uses the physical bokeh algorithm. In Bokeh mode, Scale and Rotation are disabled: use the Bokeh tab to control the bokeh effect. The ROI Sampling mode allows you to sample the Input image, and then use that sample to generate the kernel to convolve. In ROI Sampling mode, first set the Viewing to Kernel, and then use the ROI Sampling tab to define a portion of the input image to use as the Kernel for the convolution.

Scale

Reduces or enlarges the sampled kernel by varying the size of the Kernel input. Note that the larger Kernel input, the longer the convolution process takes.

Rotation

Rotates the sample kernel.

Gain

Adds or removes gain from the kernel.

Tint

Changes the colour of the kernel.

Output Options

Viewing

Selects what to display in the viewport the different stages of the processing of the Convolve effect.

• Input: Displays the original Front input.

• Highlights: Displays the result of the Highlights controls. This is what is added to the original image and sent to the convolution engine.

• Kernel: Displays the Kernel input, modified by the Scale and Rotation controls (when applicable). This, once modified by the Gain (Kernel) and Tint controls, is sent to the convolution engine.

• Convolution: Displays the result of the convolution process.

• Result: Displays the final result of the convolve operation, as defined by the Selective control. When Rendering is set to Blend, Convolution and Result are identical.

Rendering

Selects the method to apply the convolution.

• Blend: The Selective limits the convolution to a portion of the image: what's inside the Selective is processed, while what's outside remains as-is.
• Additive: This option does two things. First, just as the Blend option, it limits the convolution to the Selective. Second it limits the Highlights section and only convolves the Highlights result, and then additively blends the result on top of the original image. This option creates a result similar to the PhysicalGlareSFX effect.

Mix

Controls the mix of the Result with the original source.

Normalize

Sets the Kernel energy to 1.0 before Kernel Gain and Tint are applied.

Bokeh Shape Menu

Aperture Options

Offset Angle

Rotates the shape of the bokeh.

Blades Number

Sets the basic shape of the bokeh, based on the number of blades of the simulated aperture.

Curved Blade

Enable to have the simulated aperture use curved blades.

Camera Options

Sync To Action Camera

Syncs the FOV and F-Stop to the current Action camera when used as a CameraFX.

Field Of View and F-Stop

These two control the scale of the bokeh. The bookeh is inversely proportional to the FOV, but directly proportional to the F-Stop. Note that in Curved Blade mode, the F-Stop defines the shape of the bokeh: a smaller F-Stop rounds the bokeh.

Aberration Options

Spherical

Represents the maximum aberration, expressed as a relative distance to the focal length. The higher the value, the more the circle of confusion impacts the size of the Bokeh.

Chromatic

Represents the maximum distance to the focal length of the redmost wavelength. The higher the value, the more the colours are separated in the bokeh.

Focal Plane

Represents the focus distance relative to the focal length.

ROI Sampling Menu

Position

Aligns the part of the input image you would like to sample and use as a Kernel to the centre of the image. It is quite important to centre the feature in the centre of the screen as an offset Kernel will create an offset in the convolve result.

Crop

Center-crops the image.

Falloff

Rounds and feathers the sample.

Selective Menu

Type

Selects the segmentation method that will use the different 3D data provided by Action.

• None: Apply the effect on the whole Image.
• Object ID: Select up to 5 objects in the scene by using the Object ID data pass.
• 3D Motion: Use the Motion Vector output pass to create a selective based on pixel motion from an sequence.
• Depth: Use the Z-Depth output pass to segment the scene by setting a point of origin and a range. This is the closest mode there is to a classic focus plane depth of field effect by inverting the selective result.
• Distance: Create a decay type of selective using different decay algorithm based on the Z-Depth output pass.
• Near/Far: Set a Near and Far clipping plane similar to a 3D camera to limit the selective range.
• Cube Cam: Set a virtual cube in the 3D scene to create the selective range that is always relative to the camera position.
• Cube World: Set a virtual cube in the 3D scene to create the selective range independent from the camera position, and keep its 3D position.
• Sphere Cam: Set a virtual sphere in the 3D scene to create the selective range that is always relative to the camera position.
• Sphere World: Set a virtual sphere in the 3D scene to create the selective range that is independent from the camera position, and keep its 3D position.
• Normals: Use the Normals output pass to create an image segmentation based on the 3D object normals angles.
• Colour Selection: Sample any colour and create a selective range based on a HLS keyer.

Invert

Inverts the current Selective result.

Exclude Background

Removes the Action Background from the Selective result.

Selective Viewing

Displays in magenta the result of the current Selective.

Softness

Adds softness to the Selective result, allowing you to remove the aliasing caused by some of the 3D data such as Z-Depth or Object ID.