API
Return to top
PostProcess
编辑

场景 / PostProcess

PostProcess Class
​

后处理

后处理是指在渲染完成后对图像进行处理的一系列技术和效果。后处理通常用于增强或修改最终渲染图像的对比度、饱和度等特性，以达到特定的视觉效果或风格。

使用示例: 可按如下操作控制编辑器后处理实时效果

创建一个名为"PostProcessExample"的脚本，放置在对象栏中，打开脚本，输入以下代码，运行游戏，你将可以通过+和-键控制后处理的伽马值

ts
@Component
export default class PostProcessExample extends mw.Script {
    // 当脚本被实例后，会在第一帧更新前调用此函数
    protected async onStart(): Promise<void> {
        if(SystemUtil.isClient())
        {
            mw.InputUtil.onKeyDown(Keys.Add,()=>{
                // 小键盘+建，增加后处理饱和度,依次递增1个单位
                PostProcess.saturation = PostProcess.saturation + 1;
                console.log("当前后处理饱和度:" + PostProcess.saturation);
            });
            InputUtil.onKeyDown(Keys.Subtract,()=>{
                // 小键盘-建，降低后处理饱和度,依次递减1个单位
                PostProcess.saturation = PostProcess.saturation - 1;
                console.log("当前后处理饱和度:" + PostProcess.saturation);
            });
        }
    }
}
@Component
export default class PostProcessExample extends mw.Script {
    // 当脚本被实例后，会在第一帧更新前调用此函数
    protected async onStart(): Promise<void> {
        if(SystemUtil.isClient())
        {
            mw.InputUtil.onKeyDown(Keys.Add,()=>{
                // 小键盘+建，增加后处理饱和度,依次递增1个单位
                PostProcess.saturation = PostProcess.saturation + 1;
                console.log("当前后处理饱和度:" + PostProcess.saturation);
            });
            InputUtil.onKeyDown(Keys.Subtract,()=>{
                // 小键盘-建，降低后处理饱和度,依次递减1个单位
                PostProcess.saturation = PostProcess.saturation - 1;
                console.log("当前后处理饱和度:" + PostProcess.saturation);
            });
        }
    }
}

Table of contents ​

Accessors
​

ambientOcclusionAngleBias(): number client
获取环境光遮蔽角度偏移
ambientOcclusionEnabled(): boolean client
获取环境光遮蔽开关
ambientOcclusionIntensity(): number client
获取环境光遮蔽强度
ambientOcclusionRadius(): number client
获取环境光遮蔽半径
bloom(): number client
获取泛光
bloomExposureFactor(): number client
获取泛光曝光系数
bloomRange(): number client
获取泛光范围
bloomSpread(): number client
获取泛光扩散度
blurEnabled(): boolean client
获取模糊
blurIntensity(): number client
获取模糊强度
config(): PostProcessConfig client
获取后处理属性配置
contrast(): number client
获取全局对比度
depthOfFieldEnabled(): boolean client
获取景深开关
depthOfFieldIntensity(): number client
获取景深强度
focusDistance(): number client
获取焦距距离
focusPosition(): number client
获取焦距位置
preset(): PostProcessPreset client
获取预设
saturation(): number client
获取全局饱和度

Accessors ​

ambientOcclusionAngleBias
​

• Static get ambientOcclusionAngleBias(): number client

• Static set ambientOcclusionAngleBias(Value): void client

获取环境光遮蔽角度偏移

Returns ​

number获取值

设置环境光遮蔽角度偏移（0 ~ 80）

Parameters ​

Value number设置值

ambientOcclusionEnabled
​

• Static get ambientOcclusionEnabled(): boolean client

• Static set ambientOcclusionEnabled(Value): void client

获取环境光遮蔽开关

Returns ​

boolean获取值

设置环境光遮蔽开关

Parameters ​

Value boolean设置值

ambientOcclusionIntensity
​

• Static get ambientOcclusionIntensity(): number client

• Static set ambientOcclusionIntensity(Value): void client

获取环境光遮蔽强度

Returns ​

number获取值

设置环境光遮蔽强度（0 ~ 1）数值越大,强度越大

Parameters ​

Value number设置值

ambientOcclusionRadius
​

• Static get ambientOcclusionRadius(): number client

• Static set ambientOcclusionRadius(Value): void client

获取环境光遮蔽半径

Returns ​

number获取值

设置环境光遮蔽半径（0 ~ 300.0）数值越小半径越小

Parameters ​

Value number设置值

bloom
​

• Static get bloom(): number client

• Static set bloom(Value): void client

获取泛光

Returns ​

number获取值

设置泛光

Parameters ​

Value number设置值

bloomExposureFactor
​

• Static get bloomExposureFactor(): number client

• Static set bloomExposureFactor(Value): void client

获取泛光曝光系数

Returns ​

number获取值

设置泛光曝光系数

Parameters ​

Value number设置值

bloomRange
​

• Static get bloomRange(): number client

• Static set bloomRange(Value): void client

获取泛光范围

Returns ​

number获取值

设置泛光范围

Parameters ​

Value number设置值

bloomSpread
​

• Static get bloomSpread(): number client

• Static set bloomSpread(Value): void client

获取泛光扩散度

Returns ​

number获取值

设置泛光扩散度

Parameters ​

Value number设置值

blurEnabled
​

• Static get blurEnabled(): boolean client

• Static set blurEnabled(Value): void client

获取模糊

Returns ​

boolean获取值

开关模糊

Parameters ​

Value boolean设置值

blurIntensity
​

• Static get blurIntensity(): number client

• Static set blurIntensity(Value): void client

获取模糊强度

Returns ​

number获取值

模糊强度开关

Parameters ​

Value number设置值

config
​

• Static get config(): PostProcessConfig client

• Static set config(newConfig): void client

获取后处理属性配置

Returns ​

PostProcessConfig获取值

设置后处理属性配置

Parameters ​

newConfig PostProcessConfig设置值

contrast
​

• Static get contrast(): number client

• Static set contrast(Value): void client

获取全局对比度

Returns ​

number获取值

设置全局对比度 （0.2 ~ 5.0）

Parameters ​

Value number设置值

depthOfFieldEnabled
​

• Static get depthOfFieldEnabled(): boolean client

• Static set depthOfFieldEnabled(Value): void client

获取景深开关

Returns ​

boolean获取值

开关景深

Parameters ​

Value boolean设置值

depthOfFieldIntensity
​

• Static get depthOfFieldIntensity(): number client

• Static set depthOfFieldIntensity(Value): void client

获取景深强度

Returns ​

number获取值

设置景深强度

Parameters ​

Value number设置值

focusDistance
​

• Static get focusDistance(): number client

• Static set focusDistance(Value): void client

获取焦距距离

Returns ​

number获取值

设置焦距距离

Parameters ​

Value number设置值

focusPosition
​

• Static get focusPosition(): number client

• Static set focusPosition(Value): void client

获取焦距位置

Returns ​

number获取值

设置焦距位置

Parameters ​

Value number设置值

preset
​

• Static get preset(): PostProcessPreset client

• Static set preset(newPreset): void client

获取预设

Returns ​

PostProcessPreset预设枚举

设置预设

Parameters ​

newPreset PostProcessPreset预设枚举

saturation
​

• Static get saturation(): number client

• Static set saturation(Value): void client

获取全局饱和度

Returns ​

number获取值

设置全局饱和度 （0 ~ 2）

Parameters ​

Value number设置值