vex functions

请参阅VEX上下文了解各种函数和语句可用的不同上下文（如表面着色器或置换着色器）。

函数

子主题

数组

array_group

• append 向数组或字符串添加项。
• argsort 返回数组排序后的索引。
• array 高效地从参数创建数组。
• foreach 遍历数组中的项，可选枚举。
• insert 向数组或字符串插入项、数组或字符串。
• isvalidindex 检查给定索引对数组或字符串是否有效。
• len 返回数组长度。
• pop 移除数组最后一个元素并返回。
• push 向数组添加项。
• removeindex 从数组中移除指定索引的项。
• removevalue 从数组中移除项。
• reorder 重排数组或字符串中的项。
• resize 设置数组长度。
• reverse 返回数组或字符串的逆序。
• slice 切片字符串或数组的子串或子数组。
• sort 返回按升序排序的数组。
• upush 向数组添加统一项。

属性和内禀属性

attrib_group

• addattrib 向几何体添加属性。
• adddetailattrib 向几何体添加细节属性。
• addpointattrib 向几何体添加点属性。
• addprimattrib 向几何体添加图元属性。
• addvertexattrib 向几何体添加顶点属性。
• addvisualizer 追加到几何体的可视化器细节属性。
• attrib 从几何体读取属性值。
• attribclass 返回几何体属性的类别。
• attribdataid 返回几何体属性的数据ID。
• attribsize 返回几何体属性的大小。
• attribtype 返回几何体属性的类型。
• attribtypeinfo 返回几何体属性的变换元数据。
• curvearclen 使用参数化uv坐标评估由点数组定义的图元上的弧长。
• detail 从几何体读取细节属性值。
• detailattrib 从几何体读取细节属性值。
• detailattribsize 返回几何体细节属性的大小。
• detailattribtype 返回几何体细节属性的类型。
• detailattribtypeinfo 返回几何体属性的类型信息。
• detailintrinsic 从几何体读取细节内禀属性。
• findattribval 查找具有特定属性值的图元/点/顶点。
• findattribvalcount 返回整数或字符串属性具有特定值的元素数量。
• getattrib 从几何体读取属性值，带有效性检查。
• getattribute 将几何体属性值复制到变量并返回成功标志。
• hasattrib 检查几何体属性是否存在。
• hasdetailattrib 返回几何体细节属性是否存在。
• haspointattrib 返回几何体点属性是否存在。
• hasprimattrib 返回几何体图元属性是否存在。
• hasvertexattrib 返回几何体顶点属性是否存在。
• idtopoint 通过id属性查找点。
• idtoprim 通过id属性查找图元。
• nametopoint 通过名称属性查找点。
• nametoprim 通过名称属性查找图元。
• nuniqueval 返回整数或字符串属性的唯一值数量。
• point 从几何体读取点属性值。
• pointattrib 从几何体读取点属性值并输出成功/失败标志。
• pointattribsize 返回几何体点属性的大小。
• pointattribtype 返回几何体点属性的类型。
• pointattribtypeinfo 返回几何体属性的类型信息。
• pointlocaltransforms 从点索引数组返回点局部变换数组。
• pointtransform 从点索引返回点变换。
• pointtransformrigid 从点索引返回刚体点变换。
• pointtransforms 从点索引数组返回点变换数组。
• pointtransformsrigid 从点索引数组返回刚体点变换数组。
• prim 从几何体读取图元属性值。
• prim_attribute 在特定参数化(u, v)位置插值属性值并复制到变量。
• primarclen 使用参数化uv坐标评估图元上的弧长。
• primattrib 从几何体读取图元属性值，输出成功标志。
• primattribsize 返回几何体图元属性的大小。
• primattribtype 返回几何体图元属性的类型。
• primattribtypeinfo 返回几何体属性的类型信息。
• primduv 返回图元在特定参数化(u, v)位置的导数。
• priminteriorweights 给定UVW坐标，找到将计算内部点的顶点索引和权重。
• primintrinsic 从几何体读取图元内禀属性。
• primuv 在特定参数化(uvw)位置插值属性值。
• primuvconvert 在曲线图元上转换参数化UV位置到不同空间。
• removedetailattrib 从几何体移除细节属性。
• removepointattrib 从几何体移除点属性。
• removepointgroup 从几何体移除点组。
• removeprimattrib 从几何体移除图元属性。
• removeprimgroup 从几何体移除图元组。
• removevertexattrib 从几何体移除顶点属性。
• removevertexgroup 从几何体移除顶点组。
• setattrib 向几何体写入属性值。
• setattribtypeinfo 设置几何体中属性的含义。
• setdetailattrib 设置几何体中的细节属性。
• setdetailintrinsic 设置可写细节内禀属性的值。
• setpointattrib 设置几何体中的点属性。
• setpointlocaltransforms 在给定点索引处设置点局部变换数组。
• setpointtransform 设置给定点的世界空间变换。
• setpointtransforms 在给定点索引处设置点变换数组。
• setprimattrib 设置几何体中的图元属性。
• setprimintrinsic 设置可写图元内禀属性的值。
• setvertexattrib 设置几何体中的顶点属性。
• uniqueval 返回int或string属性所有值中的唯一值之一。
• uniquevals 返回int或string属性所有值的唯一值集合。
• uvsample 使用UV属性在特定UV坐标处插值属性值。
• vertex 从几何体读取顶点属性值。
• vertexattrib 从几何体读取顶点属性值。
• vertexattribsize 返回几何体顶点属性的大小。
• vertexattribtype 返回几何体顶点属性的类型。
• vertexattribtypeinfo 返回几何体属性的类型信息。

BSDFs

bsdf_group

• albedo 给定出射光方向，返回BSDF的反照率（反射光百分比）。
• ashikhmin 使用Ashikhmin着色模型返回镜面BSDF。
• blinn 返回Blinn BSDF或计算Blinn着色。
• chiang 返回chiang BSDF。
• chiang_fur 返回chiang_fur BSDF。
• cone 返回锥形反射BSDF。
• cvex_bsdf 从两个CVEX着色器字符串创建bsdf对象。
• diffuse 返回漫反射BSDF或计算漫反射着色。
• eval_bsdf 给定两个向量，评估bsdf。
• getbounces
• ggx 返回ggx BSDF。
• hair 返回用于头发着色的BSDF。
• henyeygreenstein 返回各向异性体积BSDF，可以向前或向后散射光。
• isotropic 返回各向同性BSDF，在所有方向上均匀散射光。
• mask_bsdf 返回仅包含掩码指定组件的新BSDF。
• normal_bsdf 返回BSDF漫反射组件的法线。
• phong 返回Phong BSDF或计算Phong着色。
• phonglobe
• sample_bsdf 采样BSDF。
• solid_angle 计算BSDF函数所对的立体角（球面度）。
• split_bsdf 将bsdf拆分为其组件瓣。
• sssapprox 创建近似SSS BSDF。

BSDFs

BSDFs_group

• specular 返回镜面BSDF或计算镜面着色。

CHOP

CHOP_group

• chadd 向CHOP节点添加新通道。
• chattr 读取CHOP属性。
• chattrnames 从CHOP输入读取给定属性类的CHOP属性名称。
• chend 返回给定CHOP输入中最后一个样本的样本编号。
• chendf 返回指定输入最后一个样本对应的帧。
• chendt 返回指定输入最后一个样本对应的时间。
• chindex 给定通道名称，从输入返回通道索引。
• chinput 返回指定样本处通道的值。
• chinputlimits 计算输入通道中样本的最小值和最大值。
• chnames 返回给定CHOP输入的所有CHOP通道名称。
• chnumchan 返回指定输入中的通道数量。
• chop 返回指定样本处CHOP通道的值。
• choplocal 返回指定样本处CHOP局部变换通道的值。
• choplocalt 返回指定样本和评估时间处CHOP局部变换通道的值。
• chopt 返回指定样本和评估时间处CHOP通道的值。
• chrate 返回指定输入的采样率。
• chreadbuf 返回指定索引处CHOP上下文临时缓冲区的值。
• chremove 从CHOP节点移除通道。
• chremoveattr 移除CHOP属性。
• chrename 重命名CHOP通道。
• chresizebuf 调整CHOP上下文临时缓冲区大小。
• chsetattr 设置CHOP属性的值。
• chsetlength 设置CHOP通道数据的长度。
• chsetrate 设置CHOP通道数据的采样率。
• chsetstart 设置CHOP通道数据的起始样本。
• chstart 返回指定输入的起始样本。
• chstartf 返回指定输入第一个样本对应的帧。
• chstartt 返回指定输入第一个样本对应的时间。
• chwritebuf 在指定索引处写入CHOP上下文临时缓冲区的值。
• isframes 如果Vex CHOP的单位菜单当前设置为’frames’返回1，否则返回0。
• issamples 如果Vex CHOP的单位菜单当前设置为’samples’返回1，否则返回0。
• isseconds 如果Vex CHOP的单位菜单当前设置为’seconds’返回1，否则返回0。
• ninputs 返回输入数量。

通道图元

chprim_group

• chprim_clear 清除通道图元，移除所有关键帧。
• chprim_destroykey 从通道图元销毁现有关键帧。
• chprim_end 获取通道图元的结束时间。
• chprim_eval 在给定时间评估通道图元。
• [chprim_insertkey](chprim_insertkey