内置变量

最近更新： 2026年9月11日

您可以在Substance函数图形中使用内置变量来访问特定值。它们始终以$（美元）符号开头。

某些变量仅在特定上下文中可用。

所有节点

系统变量

名称

类型

目的

$size

浮点 2

返回当前节点的大小（像素）。如果在输出大小参数中使用设置为相对于…… 继承方法，则返回继承值。

$sizelog2

浮点 2

如上所述，但以2的幂值形式返回大小（例如：对于2048*2048图像，$sizelog2返回11）。如果在输出大小参数中使用设置为相对于…… 继承方法，则返回继承值。

$pixelration

整数

返回与当前整数像素比率对应的节点值（继承或绝对）： 0：拉伸1：方形

$拼贴

整数

返回与当前拼贴模式对应的节点值（继承或绝对）： 0：无拼贴1：水平拼贴2：垂直拼贴3：H和V拼贴

$physicalsize

浮点 3

返回图形的 物理尺寸属性值。

$uvtile

整数 2

使用UDIM工作流时，此变量返回U和V中当前udim的索引。例如，对于拼贴1003为(2,0)，对于拼贴1118为(7,11)，…

FX-Map

系统变量

名称

类型

目的

$pos

浮点 2

返回模式的出生位置。原点(0， 0)位于图像的左上角。

$深度

浮点

返回FX-Map节点的八度音阶（级别）数。这允许节点根据它所代表的四叉树中的级别来修改其行为。

$depthpow2

浮点

如上所示，但返回2的乘反值，其值为八度音阶（音阶）数字的次方 — 即1/（2^八度音阶）。这是一个助手值，对于某些常见计算很有用。

$number

浮点

返回绘制的模式的编号。这可以通过控制迭代图形的动态函数节点来访问，以便在每个迭代步骤修改其行为。请注意，$number从0开始计数，而不是1。在使用迭代节点链时，$number变量将返回使用函数参数之前连接的最后一个迭代节点的迭代号。如果要从多个Iterate迭代中检索变量编号，则应使用“自定义变量”到Set节点。

像素处理器

系统变量

名称

类型

目的

$pos

浮点 2

返回正在计算的像素的位置。

全局

系统变量

名称

类型

目的

$time

浮点

此变量返回自Substance 引擎启动以来的时间（秒）。它可用于结果会根据经过时间而变化的图形中。 注意：虽然目前无法在Designer中更改此值，但集成该Substance 引擎的应用程序可以利用该值，例如Substance Player用于动画，或Substance 3D Painter用于动态笔触。

$normalformat

整数

当前环境中使用的普通格式（即，DirectX或OpenGL）。 注意：此变量在Designer中无效，可能被集成该Substance 引擎的其他应用程序使用。

recommendation-more-help

substance-3d-designer-help-guide