Version: 2021.3

Material.SetColorArray

切换到手册
public void SetColorArray (string name, Color[] values);
public void SetColorArray (int nameID, Color[] values);
public void SetColorArray (string name, List<Color> values);
public void SetColorArray (int nameID, List<Color> values);

参数

name 属性名称。
nameID 属性名称 ID,使用 Shader.PropertyToID 获取。
values 要设置的值的数组。

描述

设置颜色数组属性。

对材质设置颜色数组属性。如果具有给定名称的颜色数组属性已存在,则替换旧值。

它只是 SetVectorArray 的别名,只有颜色才会转换为向量。在函数调用过程中不会进行 sRGB 到线性的转换。

数组添加到代码块之后,其长度不可更改。如果随后尝试将较长数组设置到相同属性中,则长度受限为原始长度,尝试分配的额外项会被忽略。如果设置的数组比原始长度更短,则值会进行分配,但是对于超过较短新数组长度的数组元素,原始值会保留。

矩阵参数不会在材质 Inspector 中公开,也不会使用材质资源序列化。但是可以在运行时通过脚本使用 SetMatrixArraySetMatrixArraySetMatrixArraySetMatrixArray 和对应的 getter 设置和查询它们。

另请参阅:GetColorArraySetVectorArray