Files
engine/docs/zh/graphics/postProcess/effects.mdx
zhuxudong 3441a7690a Enhance post-processing document (#2604)
* refactor: enhance post-processing document
2025-04-07 18:59:25 +08:00

110 lines
4.3 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
order: 1
title: 后处理效果
---
## 泛光Bloom
[API](/apis/core/#BloomEffect)
<Image src="https://gw.alipayobjects.com/zos/OasisHub/99928a81-72c2-45f3-90ba-b51117e01715/image-20240719122439611.png" />
Bloom 特效可以给图像增加光晕质感。
### 属性
- **Down Scale** 控制泛光后处理的起始分辨率,默认为 `Half`,即初始降采样的分辨率为画布的一半,如果对精度要求没那么高,可以切换为 `Quarter`,节省为画布的 1/4。
<Comparison
leftSrc="https://gw.alipayobjects.com/zos/OasisHub/b537d126-863e-4387-b6a6-7c4f042029ca/image-20240726114458404.png"
leftText="Half"
rightSrc="https://gw.alipayobjects.com/zos/OasisHub/b62624a6-a4f2-4c9d-964c-7742f9970c8f/image-20240726114511958.png"
rightText="Quarter"
/>
- **Threshold**泛光效果会过滤掉低于此亮度级别的像素即值越低Bloom 区域越大。该值位于伽马空间,默认 0.9。
<Comparison
leftSrc="https://gw.alipayobjects.com/zos/OasisHub/47347ffb-b6c3-43f8-8008-32041c1d1d3c/image-20240726114601564.png"
leftText="0.9"
rightSrc="https://gw.alipayobjects.com/zos/OasisHub/ee71fee4-ab78-4848-ac46-79587e107df4/image-20240726114616577.png"
rightText="0.5"
/>
- **Scatter**:设置泛光效果的扩散范围,默认 0.7。
<Comparison
leftSrc="https://gw.alipayobjects.com/zos/OasisHub/38833509-dac2-4a97-bf55-6c1d85ec17c6/image-20240726115106399.png"
leftText="0.3"
rightSrc="https://gw.alipayobjects.com/zos/OasisHub/352d7efb-3c61-4cef-bc7f-7405faa7b121/image-20240726115129010.png"
rightText="0.8"
/>
- **Intensity**:泛光效果的强度。
<Comparison
leftSrc="https://gw.alipayobjects.com/zos/OasisHub/8555a001-d1b6-4a2c-8687-ad322e841071/image-20240726115441141.png"
leftText="1"
rightSrc="https://gw.alipayobjects.com/zos/OasisHub/8391bd7e-feeb-4351-b65e-9c1352bfb032/image-20240726115350389.png"
rightText="2"
/>
- **Tint**:泛光效果的色调。
<Comparison
leftSrc="https://gw.alipayobjects.com/zos/OasisHub/ae9ce1a2-9075-4739-9162-c0e5ff6b8ad1/image-20240726115519606.png"
leftText="White"
rightSrc="https://gw.alipayobjects.com/zos/OasisHub/796ec758-bf4e-45df-8050-67f88ad174b8/image-20240726115534397.png"
rightText="Red"
/>
- **Dirt Texture**:使用污渍纹理可为泛光效果添加污迹或灰尘。
<Comparison
leftSrc="https://gw.alipayobjects.com/zos/OasisHub/8a9b9fdb-191e-4ec9-bb38-ab0877fbde68/image-20240726115722323.png"
leftText="Off"
rightSrc="https://gw.alipayobjects.com/zos/OasisHub/a711bdd0-95a0-4f88-85fc-8f533569635d/image-20240726115736031.png"
rightText="On"
/>
- **Dirt Intensity**:污渍纹理的强度。
<Comparison
leftSrc="https://gw.alipayobjects.com/zos/OasisHub/a711bdd0-95a0-4f88-85fc-8f533569635d/image-20240726115736031.png"
leftText="1"
rightSrc="https://gw.alipayobjects.com/zos/OasisHub/451dff04-fc7b-4e40-9a3c-76dce3ff81c8/image-20240726115803813.png"
rightText="5"
/>
## 色调映射Tonemapping
[API](/apis/core/#TonemappingEffect)
<Image src="https://gw.alipayobjects.com/zos/OasisHub/d326f3fb-0d04-493c-8714-93cd4c5924ae/image-20240719122505552.png" />
色调映射可以重映射图像的 HDR 值,改善整个画面的对比度、色彩饱和度。
<Callout type="positive">
色调映射一般搭配 [相机开启 HDR 模式](/docs/graphics/postProcess/postProcess/#2相机开关) 后使用
</Callout>
比如下图开启 ACES 色调映射后,可以提高太阳曝光处的动态范围,看到更多细节:
<Comparison
leftSrc="https://gw.alipayobjects.com/zos/OasisHub/8ec8f8e0-0054-48c9-aeb1-146b745ac996/image-20240726114047059.png"
leftText="Tonemapping Off"
rightSrc="https://gw.alipayobjects.com/zos/OasisHub/9bbb75f2-8ed2-4448-930f-960da82ed298/image-20240726114242977.png"
rightText="Tonemapping On"
/>
### 属性
- **Mode**:色调映射算法。可以选择 `Neutral` 和 `ACES`。 `Netural` 模式特别适用于只需要范围重映射且对色调和饱和度影响最小的情况;`ACES` 模式使用电影的 ACES 参考色彩空间,可产生电影般的对比度效果,但性能消耗较大。
<Comparison
leftSrc="https://gw.alipayobjects.com/zos/OasisHub/8eaed6b4-ceb6-4e05-927e-eb02b1f76aaa/image-20240726114338413.png"
leftText="Netural"
rightSrc="https://gw.alipayobjects.com/zos/OasisHub/9bbb75f2-8ed2-4448-930f-960da82ed298/image-20240726114242977.png"
rightText="ACES"
/>