HExp12-5|Houdini Expression functions全集之Cop合成类：

1、合成节点的元数据类函数

• float copmeta (string compositing_node, string metadata_name, float index)

  从合成节点返回数字元数据。
  

• string copmetas (string compositing_node, string metadata_name)

  从合成节点返回字符串元数据。
  

• float cophasmeta (string compositing_node, string metadata_name)

  测试合成节点上是否存在元数据。
  

• float cophasplane (string compositing_node, string plane_name)

  测试合成节点上是否存在平面。说明：如果存在，则返回1，如果不存在，则为0。

2、合成节点的图像序列类函数

• float seqanim (string compositing_node)

  如果指定的合成节点具有动画序列，则返回1。如果只有一张图像，则返回0。

• float seqstart (string compositing_node)

  返回合成节点图像序列的开始帧。

• float seqend (string compositing_node)

  返回合成节点图像序列的结束帧。

• float seqlength (string compositing_node)

  返回合成节点图像序列中的帧数。

3、图像合成类函数

• float res(string compositing_node, float res_type)

  返回合成节点中图像的自然分辨率。<res_type>是D_XRES或D_YRES。

• float rgb (float hue, float saturation, float value, string component)

  将色彩模式由HSV转换为RGB。<hue>色相， <saturation>饱和度，<value>明度，＜component＞是“r”、“g”或“b”中的一个。

• float hsv (float red, float green, float blue, string component)

  将色彩模式由RGB转换为HSV。

• float pic (string copname, float U, float V, float color_type)

  返回合成节点中像素的颜色。<color_type>参数可以是以下参数之一：D_CR、D_CG、D_CB、D_CA、D_CHUE、D_CSAT、D_CVAL、D_CLUM，用于表示像素的红、绿、蓝、alpha、色相、饱和度、明度、亮度。返回的颜色将在相邻像素之间平滑插值，对于非插值颜色，请使用"picni"。

• float picni (string copname, float U, float V, float color_type)

  返回合成节点中像素的非插值颜色。

• float tex (string filename, float U, float V, string color_type)

  返回磁盘上纹理贴图上点的颜色。纹理贴图可以是包含8位、16位或浮点数据的1、3或4通道图像。当指定的颜色类型与图像的格式不匹配时，将采用默认模式。此函数将在像素之间平滑地插值颜色，对于非插值颜色，请使用"texni"。<color_type> 可以是下面中的一个：

  * r, R, or D_CR =红色通道

  * g, G, or D_CG =绿色通道

  * b, B, or D_CB =蓝色通道

  * a, A, or D_CA =Alpha通道

  * h, H, or D_CHUE=色相

  * s, S, or D_CSAT =饱和度

  * v, V, or D_CVAL =明度

  * l, L, or D_CLUM =亮度

• float texni (string filename, float U, float V, string color_type)

  返回磁盘上纹理贴图上的点的非插值颜色。

4、UV类函数

• float unituv (string surface_node, float prim_num, float uv_real, float D_U|D_V)

  将真实UV转换为单位UV。单位值定义在[0,1]区间内。

  如果图元是样条曲线类型，则真实UV在图元的域的有效间隔中定义。

  如果图元是多边形或网格，则其域的大小由顶点数、行数或列数分别给定。

  如果图元是多边形或曲线，则D_U和D_V无关紧要。

  如果图元既不是面也不是外壳，则结果是未定义的。

• float realuv (string surface_node, float prim_num, float uv_unit, float D_U|D_V)

  将单位UV转换为实际UV。

• float uvdist (string surface_node, float prim1_num, float u1, float v1, string surface_node, float prim2_num, float u2, float v2)

  返回两个图元上的参数化位置之间的距离。有效的u和v值介于0和1之间。