PostProcessing
继承自:
描述
后处理节点,用于管理场景中的各种后处理效果,包括泛光(Bloom)、景深(DOF)、抗锯齿(Antialiasing)、色彩查找表(LUTs)、全局时间环境遮蔽(GTAO)、色差(ChromaticAberration)、暗角(Vignette)、径向闪光(RadialFlash)和自定义材质列表等效果。需要注意:当MiniWorldStudio设置为低QualityLevel时,部分后处理效果可能以不同方式工作或不工作
属性
bool BloomActive |
|---|
| 泛光效果开关,用于控制是否启用全屏泛光效果。默认值为false |
float BloomIntensity |
|---|
| 泛光强度,用于控制泛光效果的亮度值。数值越大,泛光效果越明显。默认值为2.0 |
float BloomThreshold |
|---|
| 泛光阈值,用于设置像素亮度达到多少时才会产生泛光效果。只有亮度超过此阈值的像素才会参与泛光计算。默认值为-1.0 |
bool DofActive |
|---|
| 景深效果开关,用于控制是否启用景深效果,模拟相机的焦点模糊效果。默认值为false |
float DofFocalRegion |
|---|
| 景深焦点区域大小,用于设置完全清晰的焦点区域范围。默认值为0.0 |
float DofNearTransitionRegion |
|---|
| 景深近处过渡区域大小,用于设置从焦点区域到近处模糊区域的过渡距离。默认值为300.0 |
float DofFarTransitionRegion |
|---|
| 景深远处过渡区域大小,用于设置从焦点区域到远处模糊区域的过渡距离。默认值为500.0 |
float DofFocalDistance |
|---|
| 景深焦点距离,用于设置相机到焦点平面的距离,此距离上的物体会保持清晰。默认值为100.0 |
float DofScale |
|---|
| 景深模糊强度比例,用于控制景深模糊的强度倍数。数值越大,模糊效果越强。默认值为1.0 |
bool AntialiasingEnable |
|---|
| 抗锯齿开关,用于控制是否启用抗锯齿效果,以减少渲染图像中的锯齿状边缘。Windows平台默认值为true,其他平台默认值为false |
AntialiasingMethodDesc AntialiasingMethod |
|---|
| 抗锯齿方法,用于指定使用的抗锯齿算法。默认值为kAntialiasingMethodFXAA |
AntialiasingQualityDesc AntialiasingQuality |
|---|
| 抗锯齿质量等级,用于设置抗锯齿效果的渲染质量。Windows平台默认值为kAntialiasingQualityHigh,其他平台默认值为kAntialiasingQualityMedium |
bool LUTsActive |
|---|
| 色彩查找表开关,用于控制是否启用色彩查找表效果,用于进行色彩校正和风格化处理。默认值为false |
LUTsTemperatureType LUTsTemperatureType |
|---|
| LUTs色温调整类型,用于指定色温调整的方式。默认值为WhiteBalance(白平衡模式) |
float LUTsWhiteTemp |
|---|
| LUTs白平衡色温值,用于调整白平衡的色温(单位:开尔文),范围0-15000。默认值为6450.0 |
float LUTsWhiteTint |
|---|
| LUTs白平衡色调偏移,用于微调白平衡的色调偏移量,范围-1.0到1.0。默认值为0.0 |
float LUTsColorCorrectionShadowsMax |
|---|
| LUTs阴影区域最大色彩校正值,用于控制阴影区域的颜色校正强度,范围-1.0到1.0。默认值为0.8 |
float LUTsColorCorrectionHighlightsMin |
|---|
| LUTs高光区域最小色彩校正值,用于控制高光区域的颜色校正强度,范围-1.0到1.0。默认值为0.5 |
float LUTsBlueCorrection |
|---|
| LUTs蓝光校正强度,用于校正蓝光通道的颜色,范围0-1.0。默认值为0.60 |
float LUTsExpandGamut |
|---|
| LUTs色域扩展系数,用于扩展色彩查找表的色域范围,范围0-1.0。默认值为1.0 |
float LUTsToneCurveAmout |
|---|
| LUTs色调曲线强度,用于控制色调曲线调整的强度,范围0-1.0。默认值为1.0 |
float LUTsFilmicToneMapSlope |
|---|
| LUTs电影色调映射线性段斜率,用于控制电影色调映射曲线线性段的斜率,范围0-1.0。默认值为0.88 |
float LUTsFilmicToneMapToe |
|---|
| LUTs电影色调映射曲线脚部(暗部)参数,用于控制暗部区域的色调映射,范围0-1.0。默认值为0.55 |
float LUTsFilmicToneMapShoulder |
|---|
| LUTs电影色调映射曲线肩部(亮部)参数,用于控制亮部区域的色调映射,范围0-1.0。默认值为0.26 |
float LUTsFilmicToneMapBlackClip |
|---|
| LUTs电影色调映射黑色裁剪值,用于设置黑色区域的裁剪阈值,范围0-1.0。默认值为0.0 |
float LUTsFilmicToneMapWhiteClip |
|---|
| LUTs电影色调映射白色裁剪值,用于设置白色区域的裁剪阈值,范围0-1.0。默认值为0.04 |
ColorQuad LUTsBaseSaturation |
|---|
| LUTs基础饱和度颜色,用于调整整体图像的饱和度,每个通道独立控制对应颜色通道的饱和度。默认值为(255,255,255,255) |
ColorQuad LUTsBaseContrast |
|---|
| LUTs基础对比度颜色,用于调整整体图像的对比度,每个通道独立控制对应颜色通道的对比度。默认值为(255,255,255,255) |
ColorQuad LUTsBaseGamma |
|---|
| LUTs基础Gamma值颜色,用于调整整体图像的Gamma曲线,每个通道独立控制对应颜色通道的Gamma值。默认值为(255,255,255,255) |
ColorQuad LUTsBaseGain |
|---|
| LUTs基础增益颜色,用于调整整体图像的亮度增益,每个通道独立控制对应颜色通道的增益。默认值为(255,255,255,255) |
ColorQuad LUTsBaseOffset |
|---|
| LUTs基础偏移颜色,用于调整整体图像的颜色偏移,每个通道独立控制对应颜色通道的偏移量。默认值为(0,0,0,0) |
ColorQuad LUTsShadowSaturation |
|---|
| LUTs阴影区域饱和度颜色,用于调整阴影区域的饱和度,每个通道独立控制。默认值为(255,255,255,255) |
ColorQuad LUTsShadowContrast |
|---|
| LUTs阴影区域对比度颜色,用于调整阴影区域的对比度,每个通道独立控制。默认值为(255,255,255,255) |
ColorQuad LUTsShadowGamma |
|---|
| LUTs阴影区域Gamma值颜色,用于调整阴影区域的Gamma曲线,每个通道独立控制。默认值为(255,255,255,255) |
ColorQuad LUTsShadowGain |
|---|
| LUTs阴影区域增益颜色,用于调整阴影区域的亮度增益,每个通道独立控制。默认值为(255,255,255,255) |
ColorQuad LUTsShadowOffset |
|---|
| LUTs阴影区域偏移颜色,用于调整阴影区域的颜色偏移,每个通道独立控制。默认值为(0,0,0,0) |
ColorQuad LUTsMidtoneSaturation |
|---|
| LUTs中间色调区域饱和度颜色,用于调整中间色调区域的饱和度,每个通道独立控制。默认值为(255,255,255,255) |
ColorQuad LUTsMidtoneContrast |
|---|
| LUTs中间色调区域对比度颜色,用于调整中间色调区域的对比度,每个通道独立控制。默认值为(255,255,255,255) |
ColorQuad LUTsMidtoneGamma |
|---|
| LUTs中间色调区域Gamma值颜色,用于调整中间色调区域的Gamma曲线,每个通道独立控制。默认值为(255,255,255,255) |
ColorQuad LUTsMidtoneGain |
|---|
| LUTs中间色调区域增益颜色,用于调整中间色调区域的亮度增益,每个通道独立控制。默认值为(255,255,255,255) |
ColorQuad LUTsMidtoneOffset |
|---|
| LUTs中间色调区域偏移颜色,用于调整中间色调区域的颜色偏移,每个通道独立控制。默认值为(0,0,0,0) |
ColorQuad LUTsHighlightSaturation |
|---|
| LUTs高光区域饱和度颜色,用于调整高光区域的饱和度,每个通道独立控制。默认值为(255,255,255,255) |
ColorQuad LUTsHighlightContrast |
|---|
| LUTs高光区域对比度颜色,用于调整高光区域的对比度,每个通道独立控制。默认值为(255,255,255,255) |
ColorQuad LUTsHighlightGamma |
|---|
| LUTs高光区域Gamma值颜色,用于调整高光区域的Gamma曲线,每个通道独立控制。默认值为(255,255,255,255) |
ColorQuad LUTsHighlightGain |
|---|
| LUTs高光区域增益颜色,用于调整高光区域的亮度增益,每个通道独立控制。默认值为(255,255,255,255) |
ColorQuad LUTsHighlightOffset |
|---|
| LUTs高光区域偏移颜色,用于调整高光区域的颜色偏移,每个通道独立控制。默认值为(0,0,0,0) |
string LUTsColorGradingLUTPath |
|---|
| LUTs色彩分级查找表纹理路径,用于指定色彩校正的LUT纹理资源,支持PNG、JPEG、JPG格式的纹理文件。默认值为空字符串 |
bool GTAOActive |
|---|
| 全局时间环境遮蔽开关,用于控制是否启用GTAO效果,模拟环境光遮蔽以增强场景的立体感。默认值为false |
float GTAOThicknessblend |
|---|
| GTAO厚度混合系数,用于控制GTAO效果的厚度插值,范围0-1。默认值为0.75 |
float GTAOFalloffStartRatio |
|---|
| GTAO衰减起始距离比例,用于设置GTAO效果开始衰减的距离比例,范围0-1。默认值为0.5 |
float GTAOFalloffEnd |
|---|
| GTAO衰减结束距离,用于设置GTAO效果衰减的最大距离,范围0-300。默认值为70.0 |
float GTAOFadeoutDistance |
|---|
| GTAO渐隐距离,用于设置GTAO效果完全消失的距离,范围0-20000。默认值为7000.0 |
float GTAOFadeoutRadius |
|---|
| GTAO渐隐半径,用于设置GTAO效果渐隐的半径范围,范围0-10000。默认值为3000.0 |
float GTAOIntensity |
|---|
| GTAO强度,用于控制GTAO效果的强度指数,范围0-1。数值越大,环境遮蔽效果越明显。默认值为0.5 |
float GTAOPower |
|---|
| GTAO强度倍率,用于控制GTAO效果的强度倍率,范围0-10。数值越大,环境遮蔽效果越强。默认值为3.5 |
bool ChromaticAberrationActive |
|---|
| 色差效果开关,用于控制是否启用色差效果,模拟相机镜头产生的色散现象。默认值为false |
float ChromaticAberrationIntensity |
|---|
| 色差强度,用于控制色差效果的强度,范围0-8。数值越大,色散效果越明显。默认值为1.0 |
float ChromaticAberrationStartOffset |
|---|
| 色差开始偏移距离,用于设置色差效果开始的位置偏移,范围0-1。默认值为0.0 |
float ChromaticAberrationIterationStep |
|---|
| 色差迭代步长,用于控制色差计算的采样步长,范围0.01-10。默认值为0.01 |
float ChromaticAberrationIterationSamples |
|---|
| 色差迭代采样次数,用于设置色差计算的采样迭代次数,范围1-8。次数越多效果越精确但性能开销越大。默认值为1.0 |
bool VignetteActive |
|---|
| 暗角效果开关,用于控制是否启用暗角效果,在画面边缘产生渐暗效果。默认值为false |
float VignetteIntensity |
|---|
| 暗角强度,用于控制暗角效果的强度,范围0-1。数值越大,边缘暗化效果越明显。默认值为0.0 |
bool VignetteRounded |
|---|
| 暗角圆形边缘开关,用于控制暗角是否使用圆形边缘。当设置为true时,暗角边缘为圆形;设置为false时,为椭圆形。默认值为false |
float VignetteSmoothness |
|---|
| 暗角平滑度,用于控制暗角边缘的过渡平滑程度,范围0-1。数值越大,边缘过渡越平滑。默认值为0.2 |
Vector2 VignetteCenter |
|---|
| 暗角中心位置(Vector2),用于设置暗角效果的中心点坐标,范围为屏幕空间的UV坐标(0-1)。默认值为(0.5,0.5) |
ColorQuad VignetteColor |
|---|
| 暗角颜色,用于设置暗角区域的颜色,通常设置为黑色以产生暗化效果。默认值为(0,0,0,255) |
VignetteMode VignetteMode |
|---|
| 暗角模式,用于指定暗角的实现方式。Classic模式使用渐变算法,Masked模式使用遮罩贴图。默认值为Classic |
float VignetteRoundness |
|---|
| 暗角圆度,用于控制暗角边缘的圆度,范围0-1。数值越大,边缘越圆润。默认值为1.0 |
string VignetteMaskTexturePath |
|---|
| 暗角遮罩贴图路径,用于指定暗角的遮罩纹理资源,仅在VignetteMode为Masked时生效。遮罩贴图需要包含透明通道,透明区域不会产生暗角效果。默认值为空字符串 |
float VignetteMaskOpacity |
|---|
| 暗角遮罩透明度,用于控制遮罩贴图的透明度,范围0-1。仅在VignetteMode为Masked时生效。数值越大,遮罩效果越明显。默认值为1.0 |
float BloomLuminanceScale |
|---|
| 泛光亮度缩放,用于控制泛光效果的亮度缩放系数,范围0-1。数值越大,泛光越亮。默认值为1.0 |
int BloomIterator |
|---|
| 泛光迭代次数,用于设置泛光效果的迭代计算次数,范围2-4。次数越多,泛光扩散范围越大,但性能开销也越大。默认值为4 |
bool RadialFlashActive |
|---|
| 径向闪光(RadialFlash)效果开关,用于控制是否启用径向闪光效果,在画面中心产生径向扩散的光晕效果。默认值为false |
float RadialFlashLuminance |
|---|
| 径向闪光亮度,用于控制径向闪光效果的亮度值,范围0-10。数值越大,闪光效果越亮。默认值为0.65 |
float RadialFlashRadius |
|---|
| 径向闪光半径,用于控制径向闪光的扩散半径(屏幕空间比例),范围0-1。数值越大,闪光扩散范围越大。默认值为0.001 |
float RadialFlashContrast |
|---|
| 径向闪光对比度,用于控制径向闪光效果的对比度,范围0-10。数值越大,明暗对比越强烈。默认值为3.0 |
float RadialFlashThreshold |
|---|
| 径向闪光阈值,用于设置像素亮度达到多少时才会产生径向闪光效果,范围0-1。默认值为0.06 |
ColorQuad RadialFlashColor |
|---|
| 径向闪光颜色,用于设置径向闪光效果的颜色。默认值为(255,255,255,255) |
Vector2 RadialFlashPivot |
|---|
| 径向闪光中心点位置(Vector2),用于设置径向闪光效果的中心点坐标,范围为屏幕空间的UV坐标(0-1)。默认值为(0.5,0.5) |
Vector2 RadialFlashScale |
|---|
| 径向闪光缩放(Vector2),用于控制径向闪光在X和Y轴方向的缩放比例。默认值为(27.36,0.2) |
Vector2 RadialFlashSpeed |
|---|
| 径向闪光速度(Vector2),用于控制径向闪光效果的动画速度,用于创建动态闪光效果。默认值为(0.0,-5.5) |
string RadialFlashNoiseTexturePath |
|---|
| 径向闪光噪声贴图路径,用于指定径向闪光效果的噪声纹理资源,用于增加闪光效果的细节和随机性。支持PNG、JPEG、JPG格式。默认值为空字符串 |
bool MaterialListActive |
|---|
| 后处理材质列表开关,用于控制是否启用自定义后处理材质列表。启用后,MaterialList中指定的后处理材质将按顺序应用于渲染管线。默认值为false |
table MaterialList |
|---|
| 后处理材质列表,用于指定按顺序应用的后处理材质资源路径数组。材质必须为后处理域(PostProcess)材质,支持MAT和PREFAB格式。默认值为空数组 |
成员函数
| 根据索引设置材质列表中的材质参数,用于动态修改后处理材质列表中指定材质(通过索引)的参数 |
