OutputType

DreamShader » 内置组件 » OutputType

1.x 调用用它作为参数来说明反射内置组件产生何种类型的值。自 2.0.0 起，内置组件目录会为每个类说明这一点，而 OutputType 保留了两项职责：Custom 节点的输出类型，以及 1.x 源码中的宽度提示。

概要

{ OutputType | ResultType } = <type-token>

旧版前端在查找 OutputType 和 ResultType 时忽略大小写，并在绑定器看到调用之前将它们从调用中取出——在 Custom 调用中，它会将其中第一个保留为节点的输出类型，并丢弃第二个。两者都不会作为引脚或属性被绑定。该标记可以带引号或裸写：OutputType = "float3" 与 OutputType = float3 完全相同。

它在任何地方都不是必需的 (自 2.0.0 起；1.x 要求每个泛型调用以及其表之外的属性声明都必须提供它)。.dss 没有这样的参数：反射节点以 UE.<ClassShortName>(Pin = …, Property = …) 方式调用，其值由目录确定类型。

读取位置

不符合上述任何情况的标记——非 Custom 调用中的纹理、MaterialAttributes、Substrate 或 SamplerState 标记，矩阵，拼写错误——都会被无诊断信息地丢弃 (自 2.0.0 起；1.x 会报告不支持的标记)，并由目录确定值的类型。

[!NOTE] 宽度提示遵循 1.x 的行为，即当目录会构建另一个图时： float Cam = UE.Expression(Class = "CameraPositionWS", OutputType = "float") 将 Cam 类型设为 float，并在读取 Cam 的任何位置连接节点的整体输出，这正是 1.x 图 所为。在引擎以与提示相同方式确定类型的节点上，它不会改变任何东西。

接受的标记

在 Custom 节点上

比较时忽略大小写并移除所有空格。其他任何内容都是 DSH5261。

(自 2.0.0 起) int、uint、bool 及其向量、ivec*、uvec*、bvec*、纹理标记、StaticBool 和 Substrate 在此处为 DSH5261。裸写的 MaterialAttributes 会被读取为类型 material，同样为 DSH5261；请为其加引号。

在任何其他调用上，以及在属性声明上

标记是 1.x 类型拼写，比较时忽略大小写：

在 Graph 调用上，标记会被修剪但保留内部空格（" float 4 " 不是标记）；在属性声明上，会先移除所有空格。下划线和短横线从不移除：float_4 和 Material-Attributes 不是拼写。

输出掩码伪名称

与 OutputType 不同：Output / OutputName 参数选择多输出节点的哪一个输出被读取，并在调用上成为 .Name。该名称是目录为该类列出的输出之一。引擎未命名的输出，在类具有多个输出时，会列在其掩码的通道之下——R、G、B、A、RG、RGB、RGBA——除非该类已使用该名称。单个输出保留空名称，并作为调用的值。

名称按精确方式比较；在 1.x 源码中，仅忽略大小写匹配的名称会被接受，并给出 DSH5276。没有任何输出使用的名称是 DSH5201 (自 2.0.0 起；1.x 会按固定顺序对每个未命名输出测试七个掩码名称)。在输出全都是同一个值的通道视图的节点上，一个输出内部的 swizzle 就是该输出（UE.VertexColor().a）。完整规则：UE.Expression。

[!NOTE] 这些不是 OutputType 值，OutputType 标记永远不是有效的 Output 选择器。 UE.Expression(Class = "BreakMaterialAttributes", Output = "BaseColor") 按输出名称选择； UE.VertexColor(Output = "RGB") 选择其掩码命名的输出。

备注

• 宽度来自目录。 UE.Expression(Class = "WorldPosition") 是一个节点，其第一个输出 XYZ 是 float3；无需也不查阅任何 token。参见结果类型与组件数量。
• 仅因 OutputType 拼写方式不同而有所区别的两次调用——float3 与 vec3——是一个节点：IR 合并的是节点，而非拼写 (自 2.0.0 起)。参见节点复用。
• 此 token 集是 1.x 类型词汇表。Properties 部分还接受参数节点 token；参见类型、紧凑类型和输入/输出/结果。

诊断

每个代码都在诊断中其对应页面有描述。

示例

Shader(Name="Docs/M_OutputTypes")
{
    Properties {
        // Declaration surface: the type of the local `Radius`.
        UE.Expression(Class = "ObjectRadius", OutputType = "float1") Radius;
    }

    Settings { ShadingModel = "Unlit"; }

    Outputs {
        vec3 Color;
        Base.EmissiveColor = Color;
    }

    Graph {
        // Not needed: the catalog gives TextureCoordinate a float2.
        float2 uv = UE.Expression(Class = "TextureCoordinate", OutputType = "float2");

        // ResultType is the alias.
        float t = UE.Expression(Class = "Time", ResultType = "float1");

        // The node's own output type on a Custom node.
        float3 tinted = UE.Expression(Class = "Custom", OutputType = "float3",
                                      Code = "return In * 0.5f;", In = vec3(uv.x, uv.y, t));

        // An output the catalog names after its mask.
        float3 vcol = UE.Expression(Class = "VertexColor", Output = "RGB");

        Color = tinted * vcol * Radius;
    }
}

另见

• UE.Expression——此参数所属的调用形式
• UE.* 目录——那些 1.x 名称，会丢弃此参数
• 内置项——调用界面
• Substrate——丢弃此参数之处
• 类型——该语言的声明类型 token
• 紧凑类型——参数类型 token
• 输入/输出/结果——函数参数类型集
• 转换——宽度以及值如何适配
• 节点复用——相同的节点
• 诊断索引——每个代码