Vixen
02b45cc4
csharp
public record class DepthOfFieldAsset

Defocus, from the lens the frame is exposed through.

Read the guide page for this →

Remarks

⚠ Before the tonemap, and before !Bloom. Defocus is the lens spreading light across the sensor, which is scene-referred — a blurred highlight has to keep its energy so that averaging it with a dark neighbour gives the bright smear a lens gives rather than a grey one. And the glow has to be built from the image the lens actually focused, not from highlights that were never there.

⚠ Every number comes off the view's Camera. There is no manual mode and that is deliberate: an aperture that sets the exposure and a blur radius typed beside it are two answers to one question. A camera with no lens, or one focused at infinity, leaves the frame sharp.

Fields and properties (10)

  • public string Name

    The node's name, for debug groups and for a human reading the file.

  • public bool Enabled

    Whether the node runs.

  • public string Source

    The scene colour it defocuses.

  • public string Depth

    The depth every pixel's distance is read from.

  • public string View

    The view whose camera carries the lens.

  • public string Output

    The name the result is published under.

  • public PixelFormat Format

    The format of the target it declares.

  • public int Samples

    How many samples the disc is gathered with.

  • public bool UseBladeShape

    Whether the bokeh takes the diaphragm's polygon rather than a circle.

  • public float MaximumRadius

    How wide the blur may get, in pixels.

Used by (3)

  • PostEffectFactoryVixen.Rendering.PostFx
  • TypeRegistrationVixen.Rendering.PostFx
  • Vixen_Rendering_PostFx_DepthOfFieldAssetSerializerVixen.Rendering.PostFx