Bokeh Iwa

● Overview

● Input Port

• Iris : Connects the image to define the shape of the Iris. The image luminance
  values will be used for the effect. If no image is connected to the Iris port, no calculation
  will take place. It's possible to connect 8bit or 16bit RGBA images.
• Source [1～5] : Connects images for the layers. The order in which they are
  connected here doesn't define the layer stacking order. If nothing is connected to any
  Source port, no calculation will be performed.
• Depth [1～] : Connect the Depth reference image for the layer to be divided into sub-layers.
  The brightness of each pixel corresponds to the depth.
  The higher (brighter) the value, the farther away from the camera.

● Parameters

• On-Focus Distance : If there's a layer or sub-layer in this position, it will look on focus and it will be
  composed normally. 0 represents the camera position. (Range 0.0-1.0)
• Bokeh Amount : Maximum size of blur (in scene units). When the focus position and the
  layer position are 1.0 away from each other and Bokeh Adjustment is 1, the Iris image is
  enlarged until the width of this image reaches this value.
• Master Hardness : The gamma value of the film. Used to convert between RGB value and
  exposure. This is equivalent to the increase in RGB value (0.0 to 1.0) when the exposure is
  increased 10 times. The lower the value, the more the highlights are emphasized.
  (Range 0.05-3.0)
• Hardness per Source : Specify whether to use individual hardness value instead of the master hardness for converting the layer RGB values to exposures.

• Distance : The distance of the layer from the camera. The layer stacking order is
  automatically sorted according to this value. (Range 0.0-1.0)
• Bokeh Adjustment : Bokeh size correction value. The size of the bokeh is multiplied by N,
  keeping the order of layer stacking. If this value is 0, the layers will be composited normally
  without blurring regardless of the distance of the layer. (Range 0.0-2.0)
• Hardness : Individual hardness used for converting this layer's RGB values to exposure.
• Depth Image : Specifies the Depth port number. If some available Depth port is set, this layer will be divided into sub-layers at different depths in the specified range.
• Depth Range : Specifies the range of depth where the sub-layers will be distributed.

● Notes

• Separating a layer into sub-layers is just like the Bokeh Ref Iwa Fx except that the following parameters are hard-coded:
  
  • Distance Precision = 10
  • Fill Gap = ON
  • Use Median Filter = OFF
• When rendering multiple frames, the Iris and the layers images, must be present within
  the range of all frames to be rendered.
• This effect uses a lot of RAM.

● License Information

• This effect uses an open source library called Kiss FFT for the Fourier transform.