UE4材质函数帮助文档.docx
《UE4材质函数帮助文档.docx》由会员分享，可在线阅读，更多相关《UE4材质函数帮助文档.docx（24页珍藏版）》请在冰豆网上搜索。
UE4材质函数帮助文档
材质函数表达式
FunctionInput（函数输入）
FunctionInput（函数输入）表达式只能放在材质函数中，用于在该函数中定义该函数的某个输入。
项目说明
属性
输入名称（InputName）输入的名称，此名称将显示在使用了包含该输入的材质函数的MaterialFunctionCall（材质函数调用）表达式中。
说明（Description）这是对输入的说明，当用户将鼠标指针悬停在MaterialFunctionCall（材质函数调用）表达式中此输入的连接器上方时，此说明将显示为“工具提示”。
输入类型（InputType）此输入所需的数据类型。
传递到此输入的数据将强制转换为此类型，如果因为数据不兼容而导致强制转换失败，那么将抛出编译器错误。
预览值（PreviewValue）这是编辑包含此输入的材质函数时，要用作此输入的预览的值。
使用预览值作为默认值（UsePreviewValueAsDefault）如果启用此项目，并且未传入任何数据，那么将使用预览值作为此输入的默认值。
排序优先顺序（SortPriority）指定确定MaterialFunctionCall（材质函数调用）表达式中显示各个输入的顺序时，对于此输入要使用的优先顺序。
此节点与材质函数配合使用。
FunctionOutput（函数输出）
FunctionOutput（函数输出）表达式只能放在材质函数中，用于在该函数中定义该函数的某个输出。
项目说明
属性
输出名称（OutputName）输出的名称，此名称将显示在使用了包含该输出的材质函数的MaterialFunctionCall（材质函数调用）表达式中。
说明（Description）这是对输出的说明，当用户将鼠标指针悬停在MaterialFunctionCall（材质函数调用）表达式中此输出的连接器上方时，此说明将显示为“工具提示”。
排序优先顺序（SortPriority）指定确定MaterialFunctionCall（材质函数调用）表达式中显示各个输出的顺序时，对于此输出要使用的优先顺序。
此节点与材质函数配合使用。
MaterialFunctionCall（材质函数调用）
MaterialFunctionCall（材质函数调用）表达式允许您使用来自另一材质或函数的外部材质函数。
这个外部函数的输入及输出节点将变成函数调用节点的输入和输出。
如果放置其中某个表达式时在内容浏览器中选中了某个材质函数，那么将自动指派该函数。
快捷键：
F+鼠标左键单击
项目说明
属性
材质函数（MaterialFunction）指定要使用的材质函数。
此节点与材质函数配合使用。
StaticBool（静态布尔值）
StaticBool（静态布尔值）表达式用来为函数内的静态布尔函数输入提供默认布尔值。
此节点不会在任何内容之间切换，因此必须与StaticSwitch（静态开关）节点配合使用。
项目说明
属性
值（Value）布尔值True（选中）或False。
此节点与材质函数配合使用。
StaticSwitch（静态开关）
StaticSwitch（静态开关）表达式的工作方式与StaticSwitchParameter（静态开关参数）类似，但是它仅实现开关，而不会创建参数。
项目说明
属性
默认值（DefaultValue）参数的默认布尔值（用于确定哪个输入处于活动状态），即True（选中）或False。
输入
True当开关的值（Value）为True时使用的输入。
False当开关的值（Value）为False时使用的输入。
值（Value）接收一个布尔值，用于确定哪个输入处于活动状态。
此节点与材质函数配合使用。
TextureObject（纹理对象）
TextureObject（纹理对象）表达式用来为函数内的纹理函数输入提供默认纹理。
此节点不会对该纹理进行实际取样，因此必须与“纹理取样”（TextureSample）节点配合使用。
项目说明
属性
纹理（Texture）内容浏览器中要应用于此节点的纹理。
取样类型（SamplerType）此节点所要输出的数据类型。
材质属性表达式
BreakMaterialAttributes（中断材质属性）
在使用 分层材质 （“材质功能”系统的一项特性）时，BreakMaterialAttributes（中断材质属性）表达式十分理想。
在材质中使用 材质层功能 时，您可能想只使用材质层的某一个方面。
例如，您可能有一个定义漂亮的一般材质（如钢铁）的材质层。
您可能希望在最终材质中仅使用该材质层的“粗糙度”和“底色”属性，而不是使用整个材质层。
在此类情况下，您可使用BreakMaterialAttributes（中断材质属性）节点对材质层的所有传入属性进行拆分，然后仅连接所需的属性。
这也使您能够对各种材质属性进行复杂混合。
MakeMaterialAttributes（建立材质属性）
MakeMaterialAttributes（建立材质属性）节点的作用与BreakMaterialAttributes（中断材质属性）节点正好相反。
此节点将各属性汇聚到一起，而不是拆分属性。
这在您创建自己的 材质层 功能时非常有用，因为您将能够访问所有的标准属性以用于输出。
此节点也可用于复杂材质设置，在这些设置中，您希望定义多种类型的材质，并将它们全部混合到一个材质中。
在将MakeMaterialAttributes（建立材质属性）节点连接到材质时，您需要确保将主材质节点的 使用材质属性（UseMaterialAttributes）属性设置为 True（选中）。
这会将主节点折叠成单个输入，该输入将接受来自MakeMaterialAttributes（建立材质属性）节点的传入输出。
数学表达式
Abs（绝对值）
Abs（绝对值）是数学术语“绝对值（absolutevalue）”的缩写。
Abs（绝对值）表达式输出其接收到的输入的绝对值（无符号值）。
基本上，这意味着它通过删除减号将负数转换为正数，而正数和零将保持不变。
示例：
-0.7的Abs（绝对值）为0.7；-1.0的Abs（绝对值）为1.0；1.0的Abs（绝对值）也是1.0
用法示例：
Abs（绝对值）一般与 DotProduct（标量积） 配合使用。
DotProduct（标量积）的结果是-1..0..1，对DotProduct（标量积）的结果执行Abs（绝对值）的结果将是1..0..1。
Add（加）
Add（加）表达式接收两个输入，将其相加，然后输出结果。
这个加法运算按通道执行，这意味着输入的R通道、G通道和B通道等等将分别相加。
两个输入必须具有相同数目的通道，除非其中之一是单个常量值。
常量可以添加到具有任意数目输入的矢量。
项目
说明
属性
常量A（ConstA）
接收被加数的值。
仅当未使用A输入时才使用。
常量B（ConstB）
接收加数的值。
仅当未使用B输入时才使用。
输入
A
接收被加数的值。
B
接收加数的值。
示例：
对0.2和0.4执行Add（加）的结果是0.6；对（0.2,-0.4,0.6）和（0.1,0.5,1.0）执行Add（加）的结果是（0.3,0.1,1.6）；对（0.2,-0.4,0.6）和1.0执行Add（加）的结果是（1.2,0.6,1.6）
用法示例：
Add（加）通常用来使颜色变亮/变暗，或者使UV纹理坐标偏移。
AppendVector（追加矢量）
AppendVector（追加矢量）表达式允许您将通道组合在一起，以创建通道数比原始矢量更多的矢量。
例如，您可以使用两个 常量 值并进行追加，以建立双通道 Constant2Vector（常量2矢量） 值。
这有助于将单个纹理中的通道重新排序，或者将多个灰阶纹理组合成一个RGB彩色纹理。
项目
说明
输入
A
接收作为追加目标的值。
B
接收要追加的值。
示例：
对0.2和0.4执行追加的结果是（0.2,0.4）；对（0.2,0.4）和（1.6）执行追加的结果是（0.2,0.4,1.6）。
Ceil（加一取整）
Ceil（加一取整）表达式接收值，使其 向上 舍入到下一个整数，并输出结果。
另请参阅 Floor（减一取整） 和 Frac（小数） 。
示例：
对0.2执行Ceil（加一取整）的结果是1.0；对（0.2,1.6）执行Ceil（加一取整）的结果是（1.0,2.0）。
Clamp（限制）
Clamp（限制）表达式接收值，并将它们约束到由最小值和最大值定义的指定范围。
最小值0.0和最大值0.5意味着结果值决不会小于0.0，并且决不会大于0.5。
项目
说明
属性
限制模式（ClampMode）
选择要使用的限制类型。
CMODE_Clamp将对范围的两端进行限制。
CMODE_ClampMin和CMODE_ClampMax将仅对范围的相应端进行限制。
默认最小值（MinDefault）
接收限制时用作最小值的值。
仅当未使用“最小值”（Min）输入时才使用。
默认最大值（MaxDefault）
接收限制时用作最大值的值。
仅当未使用“最大值”（Max）输入时才使用。
输入
最小值（Min）
接收限制时用作最小值的值。
最大值（Max）
接收限制时用作最大值的值。
示例：
在最小值为0.0且最大值为1.0的情况下对0.3进行限制将产生0.3；在最小值为0.0且最大值为1.0的情况下对1.3进行限制将产生1.0；
ComponentMask（分量蒙版）
ComponentMask（分量蒙版）表达式允许从输入中选择通道（R、G、B和/或A）的特定子集以传递到输出。
尝试传递输入中不存在的通道将导致错误，除非输入是单个常量值。
在这种情况下，会将单个值传递到每个通道。
选择传递的当前通道将显示在表达式的标题栏中。
项目
说明
属性
R
如果选中此项目，那么会将输入值的红色通道（第一个通道）传递到输出。
G
如果选中此项目，那么会将输入值的绿色通道（第二个通道）传递到输出。
B
如果选中此项目，那么会将输入值的蓝色通道（第三个通道）传递到输出。
A
如果选中此项目，那么会将输入值的阿尔法通道（第四个通道）传递到输出。
示例：
如果ComponentMask（分量蒙版）的输入为（0.2,0.8,1.4）并选中R和B通道，那么将输出（0.2,1.4）。
Cosine（余弦）
Cosine（余弦）表达式反复输出[0,1]范围内的余弦波值。
最常见的情况是，通过将 Time（时间） 表达式连接至它的输入，输出连续的振荡波形。
输出值将在-1与1之间来回循环。
下图显示波的视觉表示：
项目
说明
属性
周期（Period）
指定产生的波的周期。
换而言之，这是发生一次振荡的长度。
用法示例：
在任何需要振荡效果的场合，此表达式都非常有用。
通过将时间输入（速度）或输出（振幅）倍增，可以轻松地动态控制振荡的速度和振幅。
在以上示例中，颜色将以余弦频率振荡。
CrossProduct（矢量积）
CrossProduct（矢量积）表达式计算两个三通道矢量值输入的矢量积，并输出所产生的三通道矢量值。
给定空间中的两个矢量，矢量积是与两个输入都垂直的矢量。
项目
说明
输入
A
接收三通道矢量值。
B
接收三通道矢量值。
用法示例：
CrossProduct（矢量积）通常用来计算与另外两个方向都垂直的方向。
Divide（除）
Divide（除）表达式接收两个输入，并输出第一个输入除以第二个输入的结果。
除法按通道进行，即，第一个输入的R通道将除以第二个输入的R通道，第一个输入的G通道将除以第二个输入的G通道，依此类推。
除非除数是单个浮点值，否则两个输入必须具有相同数目的值。
切勿以零作除数。
项目
说明
属性
常量A（ConstA）
接收被除数的值。
仅当未使用A输入时才使用。
常量B（ConstB）
接收除数的值。
仅当未使用B输入时才使用。
输入
A
接收被除数的值。
B
接收除数的值。
示例：
当A=（1.0,0.5,-0.4）且B=（2.0,2.0,4.0）时，Divide（除）的输出为（0.5,0.25,-0.1）
DotProduct（标量积）
DotProduct（标量积）表达式计算标量积，即一个矢量投射到另一个矢量上的长度。
许多技术使用此计算来计算衰减。
DotProduct（标量积）要求两个矢量输入具有相同数目的通道。
项目
说明
输入
A
接收一个值，或接收任意长度的矢量。
B
接收一个值，或接收任意长度的矢量。
Floor（减一取整）
Floor（减一取整）表达式接收值，使其 向下 舍入到上一个整数，并输出结果。
另请参阅 Ceil（加一取整） 和 Frac（小数） 。
示例：
对0.2执行Floor（减一取整）的结果是0.0；对（0.2,1.6）执行Floor（减一取整）的结果是（0.0,1.0）。
FMod（浮点余数）
FMod（浮点余数）表达式返回对两个输入执行除法运算的浮点余数。
在此示例中，FMod（浮点余数）每秒返回一个重复值，该值的范围限制在0到1。
达到1之后，该值将恢复为0，并无穷反复。
Frac（小数）
Frac（小数）表达式接收值，并输出这些值的小数部分。
另请参阅 Ceil（加一取整） 和 Floor（减一取整） 。
示例：
对0.2执行Frac（小数）的结果是0.2；对（0.0,1.6）执行Frac（小数）的结果是（0.0,0.6）。
在此示例中，Frac（小数）节点将时间转换为重复的0-1级数序列，从而通过线性插值使颜色从绿色渐变为红色，然后恢复为绿色，并无穷反复。
If（如果）
If（如果）表达式对两个输入进行比较，然后根据比较结果传递另外三个输入值中的一个。
所比较的两个输入必须都是单个浮点值。
项目
说明
输入
A
接收单个浮点值。
B
接收单个浮点值。
A>B
接收A的值大于B的值时要输出的值。
A=B
接收A的值等于B的值时要输出的值。
A接收A的值小于B的值时要输出的值。
在此示例中，If（如果）表达式接收高度贴图，并根据高度是低于还是高于值0.2来输出红色或绿色。
LinearInterpolate（线性插值）
LinearInterpolate（线性插值）表达式根据用作蒙版的第三个输入值，在两个输入值之间进行混合。
您可以将其想像成用于定义两个纹理之间的过渡效果的蒙版，例如Photoshop中的层蒙版。
蒙版“阿尔法”（Alpha）的强度确定从两个输入值获取颜色的比例。
如果“阿尔法”（Alpha）为0.0/黑色，那么将使用第一个输入。
如果“阿尔法”（Alpha）为1.0/白色，那么将使用第二个输入。
如果“阿尔法”（Alpha）为灰色（介于0.0与1.0之间的值），那么输出是两个输入之间的混合。
请记住，混合按通道进行。
因此，如果“阿尔法”（Alpha）为RGB颜色，那么“阿尔法”（Alpha）的红色通道值定义A与B的红色通道之间的混合，而与“阿尔法”（Alpha）的绿色通道 无关，该通道定义A与B的绿色通道之间的混合。
项目
说明
属性
常量A（ConstA）
映射到黑色（0.0）的值。
仅当未连接A输入时才使用。
常量B（ConstB）
映射到白色（1.0）的值。
仅当未连接B输入时才使用。
常量阿尔法（ConstAlpha）
接收要用作蒙版阿尔法的值。
仅当未连接“阿尔法”（Alpha）输入时才使用。
输入
A
接收映射到黑色（0.0）的值。
B
接收映射到白色（1.0）的值。
阿尔法（Alpha）
接收要用作蒙版阿尔法的值。
程序员需知：
LinearInterpolate（线性插值）根据参数值“阿尔法”（Alpha）在A与B之间执行按通道插值。
Max（最大值）
Max（最大值）表达式接收两个输入，然后输出其中的较大者。
此节点类似于Photoshop的“变亮”。
在以上示例中，A为"0"，B为"1"；因此，产生的底色为"1"（白色）。
项目
说明
属性
常量A（ConstA）
接收第一个值。
仅当未使用A输入时才使用。
常量B（ConstB）
接收第二个值。
仅当未使用B输入时才使用。
输入
A
接收要比较的第一个值。
B
接收要比较的第二个值。
Min（最小值）
Min（最小值）表达式接收两个输入，然后输出其中的较小者。
此节点类似于Photoshop的“变暗”。
在以上示例中，A为"0"，B为"1"；因此，产生的底色为"0"（黑色）。
项目
说明
属性
常量A（ConstA）
接收第一个值。
仅当未使用A输入时才使用。
常量B（ConstB）
接收第二个值。
仅当未使用B输入时才使用。
输入
A
接收要比较的第一个值。
B
接收要比较的第二个值。
Multiply（乘）
Multiply（乘）表达式接收两个输入，将其相乘，然后输出结果。
类似于Photoshop的多层混合。
乘法按通道进行，即，第一个输入的R通道将乘以第二个输入的R通道，第一个输入的G通道将乘以第二个输入的G通道，依此类推。
除非其中一个值是单个浮点值，否则两个输入必须具有相同数目的值。
项目
说明
属性
常量A（ConstA）
接收第一个要相乘的值。
仅当未使用A输入时才使用。
常量B（ConstB）
接收第二个要相乘的值。
仅当未使用B输入时才使用。
输入
A
接收第一个要相乘的值。
B
接收第二个要相乘的值。
请注意，UE4中的材质不限于[0,1]。
如果颜色/值大于1，那么Multiply（乘）实际上会使颜色变亮。
示例：
对0.4和0.5执行Multiply（乘）的结果是0.2；对（0.2,-0.4,0.6）和（0.0,2.0,1.0）执行Multiply（乘）的结果是（0.0,-0.8,0.6）；对（0.2,-0.4,0.6）和0.5执行Multiply（乘）的结果是（0.1,-0.2,0.3）。
用法示例：
Multiply（乘）通常用来使颜色/纹理变亮或变暗。
Normalize（规范化）
Normalize（规范化）表达式计算并输出其输入的规范化值。
这表示该输入的每个分量都会除以矢量的L-2范数（长度）。
不必对连接到“法线”（Normal）材质输出的表达式进行规范化。
OneMinus（一减）
OneMinus（一减）表达式接收一个输入值，并输出“一减去该值”。
此运算按通道执行。
示例：
对0.4执行OneMinus（一减）的结果是0.6；对（0.2,0.5,1.0）执行OneMinus（一减）的结果是（0.8,0.5,0.0）；对（0.0,-0.4,1.6）执行OneMinus（一减）的结果是（1.0,1.4,-0.6）。
用法示例：
当输入颜色在[0,1]范围内时，OneMinus（一减）的作用就是通常所谓的“反色”--即，OneMinus（一减）将返回互补色，这种颜色与输入相加将产生白色。
Power（幂）
Power（幂）表达式接收两个输入，计算“底数”（Base）的“指数”（Exp）次幂，并输出结果；换而言之，“底数”（Base）自乘“指数”（Exp）次。
项目
说明
属性
常量指数（ConstExponent）
接收指数值。
仅当未使用“指数”（Exp）输入时才使用。
输入
底数（Base）
接收底数值。
指数（Exp）
接收指数值。
示例：
底数为0.5，指数为2.0时，Power（幂）的结果为0.25。
用法示例：
如果传递到Power（幂）的颜色在[0,1]范围内，那么Power（幂）可以用作对比度调整，即，仅保留较亮的值。
Sine（正弦）
Sine（正弦）表达式反复输出[0,1]范围内的正弦波值。
最常见的情况是，通过将 Time（时间） 表达式连接至它的输入，输出连续的振荡波形。
输出值将在-1与1之间来回循环。
此表达式与 Cosine（余弦） 表达式输出之间的差别是，输出波形偏移半个周期。
下图显示波的视觉表示：
项目
说明
属性
周期（Period）
指定产生的波的周期。
换而言之，这是发生一次振荡的长度。
用法示例：
在任何需要振荡效果的场合，此表达式都非常有用。
通过将时间输入（速度）或输出（振幅）倍增，可以轻松地动态控制振荡的速度和振幅。
SquareRoot（平方根）
SquareRoot（平方根）表达式输出输入值的平方根。
SquareRoot（平方根）只能对单个浮点输入值执行运算。
Subtract（减）
Subtract（减）节点接收两个输入，从第一个输入中减去第二个输入，然后输出它们的差。
减法按通道进行，即，第一个输入的R通道将减去第二个输入的R通道，第一个输入的G通道将减去第二个输入的G通道，依此类推。
除非第二个输入是单个常量值，否则两个输入必须具有相同数目的通道。
常量可以从具有任意数目输入的矢量中减去。
项目
说明
属性
常量A（ConstA）
接收被减数的值。
仅当未使用A输入时才使用。
常量B（ConstB）
接收减数的值。
仅当未使用B输入时才使用。
输入
A
接收被减数的值。
B
接收减数的值。
示例：
对0.5和0.2执行Subtract（减）的结果是0.3；对（0.2,-0.4,0.6）和（0.1,0.1,1.0）执行Subtract（减）的结果是（0.1,-0.5,-0.4）；对（0.2,0.4,1.0）和0.2执行Subtract（减）的结果是（0.0,0.2,0.8）。
用法示例：
Subtract（减）可用来使颜色变暗以及使UV偏移。
升级会员 