【实用程序表达式 | Unreal Engine】

admin · 发表于 2016-6-25 12:32:49

本页面的内容：

BlackBody（黑体）

BumpOffset（凹凸贴图偏移）

ConstantBiasScale（常量偏差比例）

DDX

DDY

DepthFade（深度消退）

DepthOfFieldFunction（视野深度函数）

Desaturation（去饱和度）

Distance（距离）

FeatureLevelSwitch（功能级别开关）

Fresnel（菲涅尔）

GIReplace（GI 替换）

LightmassReplace（光照系统替换）

LinearInterpolate（线性插值）

Noise（噪声）

QualitySwitch（质量开关）

RotateAboutAxis（绕轴旋转）

SphereMask（球体蒙版）

AntialiasedTextureMask（抗锯齿纹理蒙版）

DistanceToNearestSurface（与最近表面的距离）

DistanceFieldGradient（距离场梯度）
BlackBody（黑体）
BlackBody（黑体）表达式用来在材质中模拟黑体辐射效果。用户输入开氏温度，产生的颜色和强度可用来驱动“底色”（Base Color）和“自发光”（Emissive）值，以获得在物理上准确的结果。

【虚幻4翻译文档-实用程序表达式 | Unreal Engine】[虚幻4中文文档]

BumpOffset（凹凸贴图偏移）
BumpOffset（凹凸贴图偏移）是虚幻引擎 4 术语，就是通常所谓的“视差贴图”。BumpOffset（凹凸贴图偏移）表达式可以使材质产生深度错觉，而不需要额外的几何体。BumpOffset（凹凸贴图偏移）材质使用灰阶高度贴图来提供深度信息。高度贴图中的值越亮，材质的“凸出”效果越明显；当摄像机在表面上移动时，这些区域将产生视差（移位）。高度贴图中较暗的区域将显得“距离较远”，其移位程度最小。

项目
说明

属性
高度比（HeightRatio）从高度贴图中取得的深度的乘数。这个值越大，深度越极端。典型值的范围是 0.02 到 0.1。参考平面（ReferencePlane）指定纹理空间中要应用此效果的近似高度。值为 0 将使纹理完全离开表面，而值 0.5（默认值）表示部分表面凸起而部分区域凹陷。
输入
坐标（Coordinate）接收此表达式所要修改的基本纹理坐标。高度（Height）接收要用作高度贴图的纹理（或值）。高度比输入（HeightRatioInput）从高度贴图中取得的深度的乘数。这个值越大，深度越极端。典型值的范围是 0.02 到 0.1。如果使用此输入，那么它将取代“高度比”（Height Ratio）属性中的任何值。

ConstantBiasScale（常量偏差比例）
ConstantBiasScale（常量偏差比例）表达式接收输入值，加上偏差值，然后乘以比例缩放系数并输出结果。例如，要将输入数据从 [-1,1] 转换到 [0,1]，请使用偏差值 1.0 和比例缩放系数 0.5。

项目
说明

属性
偏差（Bias）指定要与输入相加的值。比例（Scale）指定偏差结果的乘数。

DDX
DDX 表达式公开 DDX 导数计算，这是像素着色器计算中使用的一项 GPU 硬件功能。
DDY
DDY 表达式公开 DDX 导数计算，这是像素着色器计算中使用的一项 GPU 硬件功能。
DepthFade（深度消退）
DepthFade（深度消退）表达式用来隐藏半透明对象与不透明对象相交时出现的不美观接缝。

项目
说明

属性
消退距离（Fade Distance）这是应该发生消退的全局空间距离。未连接 FadeDistance（FadeDistance）输入时，将使用此距离。
输入
不透明（Opacity）接收深度消退前对象的现有不透明度。FadeDistance（消退距离）这是应该发生消退的全局空间距离。

、输入颜色 I</code> 和亮度系数 L</code>。输出将是 O = (1-百分比)*(D.dot(I)) + 百分比*I</code>
Distance（距离）
Distance（距离）表达式计算两个点/颜色/位置/矢量之间的欧氏距离，并输出结果值。此表达式可效果于单分量、双分量、三分量和四分量矢量，但此表达式的两个输入必须具有相同数目的通道。

项目
说明

输入
A接收一个值，或接收任意长度的矢量。B接收一个值，或接收任意长度的矢量。

伪代码：
Result = length(A - B)
低级 HLSL 代码：
float Result = sqrt(dot(A-B, A-B))FeatureLevelSwitch（功能级别开关）
FeatureLevelSwitch（功能级别开关）节点允许您建立简化的材质，以用于功能不太强大的设备。

用法示例：您可能有一个采用 10 个重叠纹理及复杂数学运算的材质，但仅将单个静态纹理用于移动设备（功能级别 ES2）。

项目
说明

输入
默认值（Default）默认功能级别。ES2由 OpenGL ES2 的核心功能定义的功能级别。ES3.1由金属级设备的功能定义的功能级别。SM4由 DX10 Shader Model 4 的核心功能定义的功能级别。SM5由 DX11 Shader Model 5 的核心功能定义的功能级别。Fresnel（菲涅尔）
Fresnel（菲涅尔）表达式根据表面法线与摄像机方向的标量积来计算衰减。当表面法线正对着摄像机时，输出值为 0。当表面法线垂直于摄像机时，输出值为 1。结果限制在 [0,1] 范围内，以确保不会在中央产生任何负颜色。

项目
说明

属性
指数（Exponent）指定输出值的衰减速度。值越大，意味着衰减越紧或越快。基本反射小数（Base Reflect Fraction）指定从正对表面的方向查看表面时，镜面反射的小数。值为 1 将有效地禁用菲涅耳效果。
输入
指数输入（ExponentIn）指定输出值的衰减速度。值越大，意味着衰减越紧或越快。如果使用此输入，那么值将始终取代“指数”（Exponent）属性值。基本反射小数（Base Reflect Fraction）指定从正对表面的方向查看表面时，镜面反射的小数。值为 1 将有效地禁用菲涅耳效果。如果使用此输入，那么值将始终取代“指数”（Exponent）属性值。法线（Normal）接收三通道矢量值，该值代表表面在全局空间中的法线。要查看应用于菲涅耳对象表面的法线贴图的结果，请将该法线贴图连接到材质的“法线”（Normal）输入，然后连接一个 (PixelNormalWS（像素全局空间法线）)[Engine/Rendering/Materials/ExpressionReference/Vector#PixelNormalWS] 表达式到 Fresnel（菲涅尔）上的此输入。如果未指定任何法线，那么将使用网格的切线法线。

GIReplace（GI 替换）
GIReplace（GI 替换）允许美工指定另一个表达式链（通常较为简单），以便在材质用于 GI 时使用。

用法示例：光照系统静态 GI 和 LPV 动态 GI 使用此表达式。

项目
说明

输入
默认值（Default）默认 GI。静态间接（StaticIndirect）用于烘焙间接照明。动态间接（DynamicIndirect）用于动态间接照明。
观察下图中的两个红色方块 - 其中一个反射为绿色（而非红色）。

使用新材质表现可获得此效果。

通常而言不需要设置完全不同的颜色，使用较深、较亮、或细微的颜色调节即可。
LightmassReplace（光照系统替换）
LightmassReplace（光照系统替换）表达式用来在编译材质以用于正常渲染用途时传递“实时”（Realtime）输入，并在导出材质到光照系统以用于全局照明时传递“光照系统”（Lightmass）输入。使用此表达式可以避免使用导出版本无法正确处理的材质表达式，例如 WorldPosition（全局位置）。

项目
说明

输入
实时（Realtime）接收要传递以用于正常渲染的值。光照系统（Lightmass）接收在导出材质到光照系统时要传递的值。LinearInterpolate（线性插值）
LinearInterpolate（线性插值）表达式根据用作蒙版的第三个输入值，在两个输入值之间进行混合。您可以将其想像成用于定义两个纹理之间的过渡效果的蒙版，例如 Photoshop 中的层蒙版。蒙版“阿尔法”（Alpha）的强度确定从两个输入值获取颜色的比例。如果“阿尔法”（Alpha）为 0.0/黑色，那么将使用第一个输入。如果“阿尔法”（Alpha）为 1.0/白色，那么将使用第二个输入。如果“阿尔法”（Alpha）为灰色（介于 0.0 与 1.0 之间的值），那么输出是两个输入之间的混合。请记住，混合按通道进行。因此，如果“阿尔法”（Alpha）为 RGB 颜色，那么“阿尔法”（Alpha）的红色通道值定义 A 与 B 的红色通道之间的混合，而与“阿尔法”（Alpha）的绿色通道无关，该通道定义 A 与 B 的绿色通道之间的混合。

项目
说明

属性
常量 A（Const A）映射到黑色 (0.0) 的值。仅当未连接 A 输入时才使用。常量 B（Const B）映射到白色 (1.0) 的值。仅当未连接 B 输入时才使用。常量阿尔法（Const Alpha）接收要用作蒙版阿尔法的值。仅当未连接“阿尔法”（Alpha）输入时才使用。
输入
A接收映射到黑色 (0.0) 的值。B接收映射到白色 (1.0) 的值。阿尔法（Alpha）接收要用作蒙版阿尔法的值。
程序员需知：LinearInterpolate（线性插值）根据参数值“阿尔法”（Alpha）在 A 与 B 之间执行按通道插值。

Noise（噪声）
Noise（噪声）表达式建立过程式噪声场，以使您能够控制其生成方式。

项目
说明

属性
比例（Scale）更改噪声单元的整体资源文件大小。数字越小，噪声越大。质量（Quality）外观/性能设置。0 表示速度最快。较大的值将导致速度下降，但外观可能较好。功能（Function）控制要计算的噪声类型。选项包括“单形”（Simplex）、“柏林”（Perlin）和“梯度”（Gradient）。干扰（Turbulence）是否计算多个级别、彼此叠加的噪声。级别数（Levels）要组合的不同噪声级别数。仅当激活“干扰”（Turbulence）后才有用。最小输出（Output Min）噪声计算的最低值输出。最大输出（Output Max）噪声计算的最高值输出。级别比例（Level Scale）控制激活“干扰”（Turbulence）后各个级别的比例。默认值为 2，但较大的值可确保更高效率地使用少量级别。
Inputs
位置（Position）允许通过 3D 矢量来调整纹理资源文件大小。过滤宽度（FilterWidth）实际上，控制应用于噪声纹理的模糊量。

QualitySwitch（质量开关）
QualitySwitch（质量开关）表达式允许根据引擎在不同质量级别之间的切换使用不同的表达式网络，例如在较低端的设备上使用较低的质量。

项目
说明

输入
默认值（Default）此输入用于针对默认视觉质量而设计的网络。低（Low）此输入用于针对较低视觉质量而设计的网络。高（High）此输入用于针对较高视觉质量而设计的网络。RotateAboutAxis（绕轴旋转）
RotateAboutAxis（绕轴旋转）表达式在给定旋转轴、该轴上的某个点以及旋转角度的情况下，旋转三通道矢量输入。此表达式适合于使用 WorldPositionOffset（全局位置偏移）产生质量优于简单剪切的动画。

项目
说明

输入
规范化旋转轴（NormalizedRotationAxis）接收一个规范化 (0-1) 矢量，它代表对象的旋转轴。旋转角度（RotationAngle）旋转角度。值 1 表示完全 360 度旋转。枢轴点（PivotPoint）接收代表枢轴点的三通道矢量，对象将绕着该枢轴点旋转。位置（Position）接收代表对象位置的三通道矢量。创建 RotateAboutAxis（绕轴旋转）表达式时，将自动创建一个 WorldPosition（全局位置）表达式并将其连接至此输入。

在以上示例中，预览平面将显示为绕着它的垂直轴旋转。
SphereMask（球体蒙版）
SphereMask（球体蒙版）表达式根据距离计算来输出蒙版值。如果某一个输出是某个点的位置，而另一输入是具有某半径的球体的中心，那么蒙版值将是 0（位于球体外部）和 1（位于球体内部），并存在一定的过渡区域。此表达式可效果于单分量、双分量、三分量和四分量矢量。

项目
说明

属性
衰减半径（Attenuation Radius）指定用于距离计算的半径。硬度百分比（Hardness Percent）指定过渡区域资源文件大小。此项目类似于 Photoshop 的笔刷硬度值。0 表示硬过渡，100 表示最大化过渡区域（软过渡）。
输入
A接收一个值，该值代表要检查的点的位置。B接收一个值，该值代表球体中心。

在此示例中，当摄像机距离预览对象超过 256 个单位时，该对象将平滑地渐变为黑色。
AntialiasedTextureMask（抗锯齿纹理蒙版）
AntialiasedTextureMask（抗锯齿纹理蒙版）表达式允许您使用软（抗锯齿）过渡蒙版来创建材质。此蒙版可用来在两个复杂材质属性之间混合，或者使阿尔法混合材质淡出（适合与“软屏蔽”配合使用）。您只需指定在其中一个通道（红色、绿色、蓝色或阿尔法）中指定了蒙版的材质，在此表达式中设置所使用的通道，并指定比较值。假设该通道存储 0（黑色）到 1（白色）范围内的灰阶值，比较功能将定义产生的蒙版是应该为 0 还是 1。此表达式是一个参数，这使纹理（Texture）属性可以由子材质实例覆盖。

项目
说明

属性
阈值（Threshold）指定用作像素范围中的分界点的值。小于此值的像素范围值将变为黑色，大于此值的像素范围值将变为白色。通道（Channel）指定要用作蒙版的纹理通道。纹理（Texture）指定要使用的蒙版纹理。
输入
UVs接收要应用于纹理蒙版的纹理坐标。
伪代码：
Result = 1if TextureLookup Threshold then Result = 0
实际实现略微复杂，因为它会尝试根据实际像素范围来返回介于 0 与 1 之间的值，以消除锯齿。

示例（为了确保质量最佳，这个 128x128 的小纹理未进行压缩）：

用作正常纹理（左上角），以及与说明的材质表达式配合使用（右下角）：

这种技术最适合在进行放大时使用，并可效果于模糊的输入内容。压缩会导致质量大幅下降，因此，请尝试使用未经压缩的低分辨率纹理。
DistanceToNearestSurface（与最近表面的距离）
DistanceToNearestSurface（与最近表面的距离）材质表达式节点允许材质对“全局距离场”关卡中的任何点进行取样。这个材质表达式将输出从距离场到场景中最近遮挡体的带符号距离（以全局空间单位计）。

必须在项目设置（Project Settings）的渲染（Rendering）下启用生成网格距离场（Generate Mesh Distance Fields），此表达式才能正确工作。

项目
说明

位置（Position）如果未输入任何内容，那么默认为当前全局位置。
以下是效果中的 DistanceToNearestSurface（与最近表面的距离）材质表达式示例。

在此示例中，DistanceToNearestSurface（与最近表面的距离）输送到材质上的“不透明”（Opacity）输入，而该材质应用于放在关卡地板正上方的“静态网格”平面。 DistanceToNearestSurface（与最近表面的距离）的效果是告诉材质，“静态网格”平面仅从红色区域开始与场景中的其他“静态网格”相交。
DistanceFieldGradient（距离场梯度）
DistanceFieldGradient（距离场梯度）材质表达式节点进行规范化后，将输出对象在距离场中的 X,Y,Z 移动方向。这使 DistanceFieldGradient（距离场梯度）材质表达式节点非常适合于需要模拟液体流的材质。

必须在项目设置（Project Settings）的渲染（Rendering）下启用生成网格距离场（Generate Mesh Distance Fields），此表达式才能正确工作。

项目
说明

位置（Position）如果未输入任何内容，那么默认为当前全局位置。
这里是在材质中使用 DistanceFieldGradient（距离场梯度）材质表达式的示例。在此示例中，请务必注意，DistanceFieldGradient（距离场梯度）首先进行规范化，然后输入到“蒙版通道”（Mask Channel）节点。这样做的原因是，如果不首先对 DistanceFieldGradient（距离场梯度）进行规范化，您将无法获得方向性数据。为了方便在材质实例中进行 RGB 通道切换，添加了“蒙版通道”（Mask Channel）参数。