• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# ScenePostProcessSettings
2<!--Kit: ArkGraphics 3D-->
3<!--Subsystem: Graphics-->
4<!--Owner: @zzhao0-->
5<!--Designer: @zdustc-->
6<!--Tester: @zhangyue283-->
7<!--Adviser: @ge-yafang-->
8
9本模块提供3D图形中的色调映射等图像后处理方法。
10
11> **说明:**
12> - 本模块首批接口从API version 12开始支持,后续版本的新增接口,采用上角标标记接口的起始版本。
13
14## 导入模块
15```ts
16import { ToneMappingType, ToneMappingSettings, BloomSettings, PostProcessSettings } from '@kit.ArkGraphics3D';
17```
18
19## ToneMappingType
20色调映射类型枚举。
21
22**系统能力:** SystemCapability.ArkUi.Graphics3D
23
24| 名称 | 值 | 说明 |
25| ---- | ---- | ---- |
26| ACES | 0 | ACES类型。 |
27| ACES_2020 | 1 | ACES_2020类型。 |
28| FILMIC | 2 | FILMIC类型。 |
29
30## ToneMappingSettings
31色调映射设置接口。
32### 属性
33
34**系统能力:** SystemCapability.ArkUi.Graphics3D
35
36| 名称 | 类型 | 只读 | 可选 | 说明 |
37| ---- | ---- | ---- | ---- | ---- |
38| type | [ToneMappingType](#tonemappingtype) | 否 | 是 | 色调映射类型,默认值为undefined。 |
39| exposure | number | 否 | 是 | 曝光度,取值大于0,默认值为undefined。 |
40
41## BloomSettings<sup>18+</sup>
42泛光设置接口。
43### 属性
44
45**系统能力:** SystemCapability.ArkUi.Graphics3D
46
47| 名称 | 类型 | 只读 | 可选 | 说明 |
48| ---- | ---- | ---- | ---- | ---- |
49| thresholdHard | number | 否 | 是 | 硬阈值,取值范围是非负数,默认值为1.0。 |
50| thresholdSoft | number | 否 | 是 | 软阈值,取值范围是非负数,默认值为2.0。 |
51| scaleFactor | number | 否 | 是 | 缩放因子,取值范围大于0,默认值为1.0。 |
52| scatter | number | 否 | 是 | 扩散量,取值范围大于0,默认值为1.0。 |
53
54## PostProcessSettings
55后处理设置。
56
57**系统能力:** SystemCapability.ArkUi.Graphics3D
58
59| 名称 | 类型 | 只读 | 可选 | 说明 |
60| ---- | ---- | ---- | ---- | ---- |
61| toneMapping | [ToneMappingSettings](#tonemappingsettings) | 否 | 是 | 色调映射,默认值为undefined。 |
62| bloom<sup>18+</sup> | [BloomSettings](#bloomsettings18) | 否 | 是 | 泛光,默认值为undefined。 |
63