材料关键字

这些关键字描述用于创建 3D 对象的设备中的原材料。

3.1. Job3DMaterialCount

此参数必须定义设备中当前加载的材料数，这些材料可在单个作业中使用。 如果设备不知道何时加载材料，则此参数必须是单个作业中使用的材料数。 如果打印机只有一种未知材料，可以省略此参数以及所有其他材料关键字。

特征	详细信息
名称	psk3d:Job3DMaterialCount
适用于	PrintCapabilities 文档
元素类型	properties
目录	仅包含 1 个 <Value> 子元素，具体如下： 子项：值 xsi:type：xsd:integer 值：JobMaterialCountText 猫叔：JobMaterialCountText（如果指定此属性）必须包含一个正整数，用于标识此设备上可用的材料数。

Job3DMaterialCount 关键字用法

<psf:Property name="psk3d:Job3DMaterialCount">
    <psf:Value xsi:type="xsd:integer">2</psf:Value>
</psf:Property>

3.2. Job3DMaterials

此属性必须包含设备中加载的材料的描述，或者如果这是未知的，则必须包含可加载材料的可能位置的枚举。

特征	详细信息
名称	psk3d:Job3DMaterials
适用于	PrintCapabilities 文档
元素类型	properties
目录	包含 1 个或多个子属性元素，具体如下： 子项：属性列表 xsi:type：不适用 值：MaterialsList 描述：MaterialsList 包含一组子属性。

3.2.1. MaterialsList 属性

供应商必须创建自己的材料，枚举在其设备中加载的打印材料。 这些材料的名称是供应商定义的，如果设备能够从加载的材料盒中读取此类信息，则应该表示库存描述。 如果设备不具有此信息，供应商应将材料名称定义为加载此材料的位置的描述性名称（例如，“左挤压机”）。

每种材料都应该指定以下子属性。

材料名称	xsi:type	说明
psk:DisplayName	xsd:string	此属性应该包含含有本地化显示名称的 psf:Value 元素。
psk3d:MaterialColor	xsd:string	设备可以定义此属性以指定材料的颜色。 如果指定，则值必须是符合以下描述的 sRGB 颜色： cpp sRGBColorText = "#" hR hG hB hA hR = hG = hB = hA = hexpair hexpair = hexdigit hexdigit hexdigit = "0" / "1" / "2" / "3" / "4" / "5" / "6" / "7" / "8" / "9" / "A" / "B" / "C" / "D" / "E" / "F" / "a" / "b" / "c" / "d" / "e" / "f" hR、hG、hB 和 hA 分别指定红色、绿色、蓝色和 alpha 分量的十六进制单字节值，范围为 00 到 FF。 设备可以省略 alpha（即 #hRhGhB），在这种情况下，alpha 采用 FF 的默认值（完全不透明）。

Job3DMaterials 关键字用法

<psf:Property name="psk3d:Job3DMaterials">
    <psf:Property name="vnd:ABS_RED">
        <psf:Property name="psk:DisplayName">
            <psf:Value xsi:type="xsd:string">Red ABS Plastic</psf:Value>
        </psf:Property>
        <psf:Property name="psk3d:MaterialColor">
            <psf:Value xsi:type="xsd:string">#FF0000</psf:Value>
        </psf:Property>
    </psf:Property>
    <psf:Property name="vnd:PLA_TEAL">
        <psf:Property name="psk:DisplayName">
            <psf:Value xsi:type="xsd:string">Teal PLA Plastic</psf:Value>
        </psf:Property>
        <psf:Property name="psk3d:MaterialColor">
            <psf:Value xsi:type="xsd:string">#00FFFF</psf:Value>
        </psf:Property>
    </psf:Property>
</psf:Property>

3.3. Job3DSupports

psk3d:Job3DSupports 关键字指定此作业是否应包括设备或驱动程序生成的支持。

特征	详细信息
名称	psk3d:Job3DSupports
适用于	PrintCapabilities 文档 PrintTicket 文档
元素类型	功能
SelectionType	psk:PickOne
目录	打印架构关键字为 3D 制造定义的选项如下所示： 子项：选项 psk3d:SupportsIncluded 描述：此选项指定设备应该为模型生成外部支持。 子项：选项 psk3d:SupportsExcluded 描述：此选项指定设备不应该为模型生成外部支持。

Job3DSupports 关键字用法

<psf:Feature name="psk3d:Job3DSupports">
    <psf:Property name="SelectionType">
        <psf:Value xsi:type="xsd:QName">psk:PickOne</psf:Value>
    </psf:Property>
    <psf:Option name="psk3d:SupportsIncluded" />
    <psf:Option name="psk3d:SupportsExcluded" />
</psf:Feature>

3.3.1. Job3DSupportsMaterial

如果选择 psk3d:SupportsIncluded 选项，并且设备支持多种材料，则此参数应该指示用于支持结构的主要材料。 此参数应解释为对 psk3d:Job3DMaterials 属性的命名子属性的引用。

Job3DSupportsMaterial 关键字配置文件

特征	详细信息
名称	psk3d:Job3DSupportsMaterial
适用于	PrintCapabilities 文档
元素类型	ParameterDef
目录	psk3d:Job3DSupportsMaterial 是 QNameParamType，如打印架构规范中的 §2.1.3.1“<psf:ParameterDef>”中所述： 子项：QNameParamType 说明： psf:MinLength 属性值必须是大于或等于 1 的整数。 psf:MaxLength 属性值可由供应商定义，并且必须大于或等于 psf:MinLength 属性值。 它应该为 1024。 psf:Mandatory 属性值必须为 psk:Optional。 psf:UnitType 属性值必须为字符。

Job3DSupportsMaterial 初始化配置文件

特征	详细信息
名称	psk3d:Job3DSupportsMaterial
适用于	PrintTicket 文档
元素类型	ParameterInit
目录	仅包含 1 个 <Value> 子元素，具体如下： 子项：值 xsi:type：xsd:QName 值：MaterialName 描述： MaterialName 必须引用标识为 psk3D:Job3DMaterials 属性子项的材料。

Job3DSupportsMaterial 关键字用法

参数定义如下：

<psf:ParameterDef name="psk3d:Job3DSupportsMaterial">
    <psf:Property name="psf:DataType">
        <psf:Value xsi:type="xsd:QName">xsd:QName</psf:Value>
    </psf:Property>
    <psf:Property name="psf:DefaultValue">
        <psf:Value xsi:type="xsd:QName">vnd:ABS_RED</psf:Value>
    </psf:Property>
    <psf:Property name="psf:MaxLength">
        <psf:Value xsi:type="xsd:integer">1024</psf:Value>
    </psf:Property>
    <psf:Property name="psf:MinLength">
        <psf:Value xsi:type="xsd:integer">1</psf:Value>
    </psf:Property>
    <psf:Property name="psf:Mandatory">
        <psf:Value xsi:type="xsd:QName">psk:Optional</psf:Value>
    </psf:Property>
    <psf:Property name="psf:UnitType">
        <psf:Value xsi:type="xsd:string">characters</psf:Value>
    </psf:Property>
</psf:ParameterDef>

此参数的初始化如下所示：

<psf:ParameterInit name="psk3d:Job3DSupportsMaterial">
    <psf:Value xsi:type="xsd:QName">vnd:PLA_TEAL</psf:Value>
</psf:ParameterInit>

3.4. Job3DRaft

psk3d:Job3DRaft 关键字指定此作业是否应包括设备或驱动程序生成的筏。

特征	详细信息
名称	psk3d:Job3DRaft
适用于	PrintCapabilities 文档 PrintTicket 文档
元素类型	功能
SelectionType	psk:PickOne
目录	打印架构关键字为 3D 制造定义的选项如下所示： 子项：选项 psk3d:RaftIncluded 描述：此选项指定设备应该为模型生成筏。 子项：选项 psk3d:RaftExcluded 描述：此选项指定设备不应该为模型生成筏。

Job3DRaft 关键字用法

<psf:Feature name="psk3d:Job3DRaft">
    <psf:Property name="SelectionType">
        <psf:Value xsi:type="xsd:QName">psk:PickOne</psf:Value>
    </psf:Property>
    <psf:Option name="psk3d:RaftIncluded" />
    <psf:Option name="psk3d:RaftExcluded" />
</psf:Feature>

3.4.1. Job3DRaftMaterial

如果选择 psk3d:RaftIncluded 选项，并且设备支持多种材料，则此参数应该指示用于筏的主要材料。 此参数应解释为对 psk3d:Job3DMaterials 属性的命名子属性的引用。

Job3DRaftMaterial 关键字配置文件

特征	详细信息
名称	psk3d:Job3DRaftMaterial
适用于	PrintCapabilities 文档
元素类型	ParameterDef
目录	psk3d:Job3DRaftMaterial 是 QNameParamType，如打印架构规范中的 §2.1.3.1“<psf:ParameterDef>”中所述： 子项：QNameParamType 说明： psf:MinLength 属性值必须是大于或等于 1 的整数。 psf:MaxLength 属性值可由供应商定义，并且必须大于或等于 psf:MinLength 属性值。 它应该为 1024。 psf:Mandatory 属性值必须为 psk:Optional。 psf:UnitType 属性值必须为字符。

Job3DRaftMaterial 初始化配置文件

特征	详细信息
名称	psk3d:Job3DRaftMaterial
适用于	PrintTicket 文档
元素类型	ParameterInit
目录	仅包含 1 个 <Value> 子元素，具体如下： 子项：值 xsi:type：xsd:QName 值：MaterialName 描述： MaterialName 必须引用标识为 psk3D:Job3DMaterials 属性子项的材料。

Job3DRaftMaterial 关键字用法

参数定义如下：

<psf:ParameterDef name="psk3d:Job3DRaftMaterial">
    <psf:Property name="psf:DataType">
        <psf:Value xsi:type="xsd:QName">xsd:QName</psf:Value>
    </psf:Property>
    <psf:Property name="psf:DefaultValue">
        <psf:Value xsi:type="xsd:QName">vnd:ABS_RED</psf:Value>
    </psf:Property>
    <psf:Property name="psf:MaxLength">
        <psf:Value xsi:type="xsd:integer">1024</psf:Value>
    </psf:Property>
    <psf:Property name="psf:MinLength">
        <psf:Value xsi:type="xsd:integer">1</psf:Value>
    </psf:Property>
    <psf:Property name="psf:Mandatory">
        <psf:Value xsi:type="xsd:QName">psk:Optional</psf:Value>
    </psf:Property>
    <psf:Property name="psf:UnitType">
        <psf:Value xsi:type="xsd:string">characters</psf:Value>
    </psf:Property>
</psf:ParameterDef>

此参数的初始化如下所示：

<psf:ParameterInit name="psk3d:Job3DRaftMaterial">
    <psf:Value xsi:type="xsd:QName">vnd:PLA_TEAL</psf:Value>
</psf:ParameterInit>

3.5. 材料映射参数

如果设备支持多种材料，此参数应指示有效负载文件中基材料 (ID:index) 的列表，以映射到特定的输出材料。 ID 必须引用有效负载文件中的基材料元素，因为不允许映射其他类型的材料。 输出材料（由 Job3DMaterialSelected 指定）必须是 psk3d:Job3DMaterials 属性的子项。 材料映射参数的名称必须以“Job3D”开头，并将 psk3d:Job3DMaterialSelected 属性的值追加到末尾，并追加了“Map”。 这样，打印票证就可以针对整个材料映射进行分析，而无需打印功能，使作业可移植到其他可能具有相同材料但按不同顺序加载的打印机。

材料映射参数关键字配置文件

特征	详细信息
名称	供应商指定
适用于	PrintCapabilities 文档
元素类型	ParameterDef
目录	材料映射参数是 MaterialMapParamType，如本文档第 1.8.1 部分中所述。 子项：MaterialMapParamType 说明： psf:MinLength 属性值必须是大于或等于 1 的整数。 psf:MaxLength 属性值可由供应商定义，并且必须大于或等于 psf:MinLength 属性值。 它应该为 1024。 psf:Mandatory 属性值必须为 psk:Optional。 psf:UnitType 属性值必须为 materialMapUnitType。 psk3d:Job3DMaterialSelected 属性值必须引用 Job3DMaterials 属性的子项的名称。

Job3DRaftMaterial 初始化配置文件

特征	详细信息
名称	供应商指定
适用于	PrintTicket 文档
元素类型	ParameterInit
目录	仅包含 1 个 <Value> 子元素，具体如下： 子项：值 xsi:type：Psk3d:MaterialMapUnitType 值：材料列表 描述：材料列表必须是材料 ID:index 值的分号分隔列表，引用模型有效负载中的基材料。

材料映射参数关键字用法

参数定义如下：

   <psf:ParameterDef name="vnd:Job3DABS_REDMap">
       <psf:Property name="psf:DataType">
          <psf:Value xsi:type="xsd:QName">xsd:string</psf:Value>
       </psf:Property>
       <psf:Property name="psf:MinLength">
          <psf:Value xsi:type="xsd:integer">1</psf:Value>
       </psf:Property>
       <psf:Property name="psf:MaxLength">
          <psf:Value xsi:type="xsd:integer">1024</psf:Value>
       </psf:Property>
       <psf:Property name="psf:Mandatory">
          <psf:Value xsi:type="xsd:QName">psk:Optional</psf:Value>
       </psf:Property>
       <psf:Property name="psf:UnitType">
          <psf:Value xsi:type="xsd:string">characters</psf:Value>
       </psf:Property>
       <psf:Property name="psk3d:Job3DMaterialSelected">
          <psf:Value xsi:type="xsd:QName">vnd:ABS_RED</psf:Value>
       </psf:Property>
   </psf:ParameterDef>
   <psf:ParameterDef name="vnd:Job3DPLA_TEALMap">
       <psf:Property name="psf:DataType">
          <psf:Value xsi:type="xsd:QName">xsd:string</psf:Value>
       </psf:Property>
       <psf:Property name="psf:MinLength">
          <psf:Value xsi:type="xsd:integer">1</psf:Value>
       </psf:Property>
       <psf:Property name="psf:MaxLength">
          <psf:Value xsi:type="xsd:integer">1024</psf:Value>
       </psf:Property>
       <psf:Property name="psf:Mandatory">
          <psf:Value xsi:type="xsd:QName">psk:Optional</psf:Value>
       </psf:Property>
       <psf:Property name="psf:UnitType">
          <psf:Value xsi:type="xsd:string">characters</psf:Value>
       </psf:Property>
       <psf:Property name="psk3d:Job3DMaterialSelected">
          <psf:Value xsi:type="xsd:QName">vnd:PLA_TEAL</psf:Value>
       </psf:Property>
   </psf:ParameterDef>

此参数的初始化如下所示：

   psf:ParameterInit name="vnd:Job3DABS_REDMap">
      <psf:Value xsi:type="xsd:string">1:0;1:2</psf:Value>
   </psf:ParameterInit>
   <psf:ParameterInit name="vnd:Job3DPLA_TEALMap">
      <psf:Value xsi:type="xsd:string">1:1</psf:Value>
   </psf:ParameterInit>