Library/PackageCache/com.unity.postprocessing@2.1.6/Documentation~/Bloom.md

   1 # Bloom
   2
   3 **Bloom** is an effect used to reproduce an imaging artifact of real-world cameras. The effect produces fringes of light extending from the borders of bright areas in an image, contributing to the illusion of an extremely bright light overwhelming the camera or eye capturing the scene.
   4
   5 **Lens Dirt** applies a fullscreen layer of smudges or dust to diffract the Bloom effect. This is commonly used in modern first person shooters.
   6
   7
   8 ![](images/screenshot-bloom.png)
   9
  10
  11
  12 ![](images/bloom.png)
  13
  14
  15 ### Properties
  16
  17 **Bloom** settings:
  18
  19 | Property         | Function                                                     |
  20 | :---------------- | :------------------------------------------------------------ |
  21 | Intensity        | Strength of the Bloom filter.                                |
  22 | Threshold        | Filters out pixels under this level of brightness. This value is expressed in gamma-space. |
  23 | Soft Knee        | Makes transition between under/over-threshold gradual (0 = hard threshold, 1 = soft threshold). |
  24 | Clamp            | Clamps pixels to control the bloom amount. This value is expressed in gamma-space. |
  25 | Diffusion        | Changes extent of veiling effects in a screen resolution-independent fashion. |
  26 | Anamorphic Ratio | Emulates the effect of an anamorphic lens by scaling the bloom vertically (in range [-1,0]) or horizontally (in range [0,1]). |
  27 | Color            | Tint of the Bloom filter.                                    |
  28 | Fast Mode        | Boost performances by lowering the effect quality.           |
  29
  30 **Dirtiness** settings:
  31
  32 | Property  | Function                                              |
  33 | --------- | ----------------------------------------------------- |
  34 | Texture   | Dirtiness texture to add smudges or dust to the lens. |
  35 | Intensity | Amount of lens dirtiness.                             |
  36
  37 ### Details
  38
  39 With properly exposed HDR scenes, `Threshold` should be set to ~1 so that only pixels with values above 1 leak into surrounding objects. You’ll probably want to drop this value when working in LDR or the effect won’t be visible.
  40
  41 ### Performances
  42
  43 Lowering the `Diffusion` parameter will make the effect faster. The further away `Anamorphic Ratio` is from 0, the slower it will be. On mobile and low-end platforms it is recommended to enable `Fast Mode` as it gives a significant boost in performances.
  44
  45 Finally, smaller lens dirt textures will result is faster lookup and blending across volumes.
  46
  47 ### Requirements
  48
  49 - Shader model 3
  50
  51 See the [Graphics Hardware Capabilities and Emulation](https://docs.unity3d.com/Manual/GraphicsEmulation.html) page for further details and a list of compliant hardware.