BokehBlur

Photographic lens blur where bright highlights bloom into aperture-shaped discs

Props

  • radius

    Defocus amount — how far the lens blur spreads

    Type
    number
    Default
    50

  • highlightGain

    How strongly bright highlights bloom into discs

    Type
    number
    Default
    4

  • highlightThreshold

    Brightness above which a highlight forms a disc

    Type
    number
    Default
    0.6

  • bladeShape

    Aperture shape the highlights bloom into — bladed iris or a novelty cut-out (heart, star, …)

    Type
    "blades" | "circle" | "star" | "heart" | "flower" | "cross" | "ring"
    Default
    blades

  • bladeCount

    Blade or point count for the Blades, Star and Flower shapes — 0–2 blades is a circular iris

    Type
    number
    Default
    6

  • bladeRotation

    Rotation of the aperture shape (in degrees)

    Type
    number
    Default
    0

  • chromaticFringe

    Lens color fringing on the disc edges

    Type
    number
    Default
    0.2

  • catEye

    Clips the discs into cat-eye shapes toward the frame corners, like a real lens vignetting its aperture

    Type
    number
    Default
    0

Usage

<Shader>
  <BokehBlur
    radius={50}
  >
    <Circle />
  </BokehBlur>
</Shader>