跳转到内容
月离文档

colormap

该函数对像素值进行双线性插值。要获取未过滤的像素值，请使用rawcolormap。

vector|vector4 colormap(string filename, vector uvw, ...)

使用uvw的前两个分量作为单位(0-1)坐标来点采样纹理文件。

vector|vector4 colormap(string filename, float u, float v, ...)

使用u和v作为单位(0-1)坐标来点采样纹理文件。

vector|vector4 colormap(string filename, vector uv, vector du, vector dv, int samples, ...)

使用由(uv)-(uv+du)-(uv+du+dv)-(uv+dv)形成的四边形区域采样纹理文件。 进行指定数量的随机采样(除非图像是.rat文件)。

vector|vector4 colormap(string filename, vector uv0, vector uv1, vector uv2, vector uv3, ...)

使用由(uv0)-(uv1)-(uv2)-(uv3)形成的四边形区域采样纹理文件。

vector|vector4 colormap(string filename, vector uv0, vector uv1, vector uv2, vector uv3, int samples, ...)

使用由(uv0)-(uv1)-(uv2)-(uv3)形成的四边形区域采样纹理文件。 进行指定数量的随机采样(除非图像是.rat文件)。

vector|vector4 colormap(string filename, float u0, float v0, float u1, float v1, float u2, float v2, float u3, float v3, int samples, ...)

使用由(uv0)-(uv1)-(uv2)-(uv3)形成的四边形区域采样纹理文件。 进行指定数量的随机采样(除非图像是.rat文件)。

返回值

如果使用vector4返回类型调用函数，则第四个分量是纹理的alpha通道。如果图像没有alpha，第四个分量始终为1。

图像过滤选项

图像过滤选项

指定过滤参数的示例：

colormap(map, u, v, "smode", "decal", "tmode", "repeat", "border", {.1,1,1});
colormap(map, u, v, "mode", "clamp", "width", 1.3);
colormap(map, u, v, "filter", "gauss", "width", 1.3, "mode", "repeat");

如果纹理是深度.rat文件，可以使用"channel"关键字参数指定文件中的通道：

string channelname = "N";
cf = colormap(map, u, v, "channel", channelname);

  • 当读取非Houdini原生.pic或.rat格式的纹理时，Houdini使用OpenImageIO从文件中读取图像数据。在这种情况下，下面的一些可变参数可能无效。

  • 当纹理函数评估非Houdini格式纹理时，Houdini会切换到使用OpenImageIO进行纹理评估。虽然有许多可变关键字对应的值，但有些关键字在OpenImageIO中没有等效功能。

    • OIIO默认不会为没有多分辨率图像的图像创建MIP映射。您可以通过在OPENIMAGEIO_IMAGECACHE_OPTIONS环境变量内容中添加automip=1来启用此功能。

没有MIP映射，模糊和过滤可能无法按预期工作。 * 您也可以使用OPENIMAGEIO_IMAGECACHE_OPTIONS来覆盖OIIO用于缓存的内存量。

默认情况下，Houdini会将缓存内存设置为计算机物理内存的1/8。如果设置了OPENIMAGEIO_IMAGECACHE_OPTIONS变量，它将覆盖计算出的缓存大小。

“wrap”, string ="repeat"

repeat或periodic

图像贴图将在0到1范围外重复。 基本上，纹理坐标的整数部分被忽略。这是默认设置。

clamp或edge或streak

纹理坐标将被限制在0到1范围内。这会导致范围外的评估结果为图像最边缘的颜色(边界像素在范围外延伸)。

black或decal或color

0到1范围外的坐标将评估为边界颜色(而不是图像中的颜色)。默认边界颜色为黑色(即0)。

“uwrap”, string

(又名swrap) 指定当u坐标超出0到1范围时的行为。值与wrap相同。

“vwrap”, string

(又名twrap) 指定当v坐标超出0到1范围时的行为。值与wrap相同。

“border”, float|vector|vector4 =0

指定使用Black/Decal/Color包裹时的边界颜色。 对OpenImageIO格式无效。

“default_color”, float|vector|vector4

指定当找不到纹理贴图时使用的颜色。如果未给出此参数，则颜色由HOUDINI_DEFAULT_TEXTURE_COLOR变量设置。

“channel”,

为具有多个颜色平面的纹理(例如diffuse_indirect或N)指定颜色通道。 对于ptex图像，这指定第一个通道的索引(例如0或4)。

“blur”, float

在x和y方向模糊。模糊量以图像大小的百分比衡量 - 因此0.1的模糊将模糊图像宽度的10%。如果需要不同维度的模糊量，请使用xblur和yblur。

“xblur”,

(又名ublur, sblur) x图像方向上的模糊量。

“yblur”,

(又名vblur, tblur) y图像方向上的模糊量。

“pixelblur”, float

以浮点数像素模糊纹理。 对OpenImageIO格式无效。

Cf = texture("map.rat", ss, tt, "pixelblur", 2.0);

“xpixelblur”, float

在X方向上以浮点数像素模糊纹理。

“ypixelblur”, float

在Y方向上以浮点数像素模糊纹理。

“filter”, string ="box"

指定用于评估的抗锯齿过滤器类型。

对于Houdini原生格式，以下值应为指定以下之一的字符串：

"point"

点采样(即无过滤)

"box"

盒式过滤器(默认)

"gauss"

高斯过滤器

"bartlett"

Bartlett/三角形过滤器

"sinc"

Sinc锐化过滤器

"hanning"

Hanning过滤器

"blackman"

Blackman过滤器

"catrom"

Catmull-Rom过滤器

对于所有其他格式(由OpenImageIO加载)，指定"point"过滤器将OIIO插值模式设置为"closest"并禁用MIP映射。任何其他值都使用OIIO智能双三次插值。您可以使用"filtermode"可变参数获得更精细的控制(见下文)。

“xfilter”, string

(又名ufilter, sfilter) 指定X方向的过滤器。过滤器与filter相同。

“yfilter”, string

(又名vfilter, tfilter) 指定Y方向的过滤器。过滤器与filter相同。

“filtermode”, string

对于Houdini原生格式，VEX还支持更简单的过滤。filtermode可以设置为以下之一：

filter

使用由filter关键字参数指定的过滤器。

bilinear

使用简单的双线性过滤。这是最快的专用过滤模式，但提供最低质量的过滤。

biquadratic

使用简单的二次过滤(3阶过滤)。

bicubic

使用简单的双三次过滤。

当filtermode设置为bilinear、biquadratic或bicubic时， 几个参数(如filter和width)被忽略，而是使用固定的插值过滤器。其他参数(特别是lerp和blur关键字)仍然有效。

对于所有其他格式(由OpenImageIO加载)，您可以将filtermode设置为"filter"(见上文"filter")、"bilinear"、"biquadratic"或"bicubic"。

“width”, float =1.0

对于Houdini原生格式，这设置X和Y方向的过滤器宽度。

对于所有其他格式(由OpenImageIO加载)，这设置OIIO的swidth和twidth选项。

“xwidth”, float

(又名uwidth, swidth) X方向的过滤器宽度。

“ywidth”, float

(又名vwidth, twidth) Y方向的过滤器宽度。

“zwidth”, float

Z方向的过滤器宽度(用于阴影贴图)。 这以世界空间单位衡量，与其他宽度参数不同。

“extrapolate”, int

是否在计算抗锯齿信息时使用导数外推。 导数外推默认开启。参数应为0或1。

“lerp”, int

对于Houdini原生格式，这指定RAT文件是否应在不同MIP级别之间插值。默认情况下，此功能关闭。开启插值将有助于消除访问.rat文件不同MIP级别时的不连续性。但是，纹理评估的结果会稍微柔和(即更模糊)并且需要更多时间。

此参数有三个可能的值。

0

禁用MIP映射插值(最快)。

1

近似MIP映射插值(快速)。

2

高质量MIP映射插值(较慢但质量最高)。

对于所有其他格式(由OpenImageIO加载)，值为0指定单个MIP级别，任何其他值指定三线性插值。

“depthinterp”, string

为深度阴影贴图指定深度插值模式， 控制在两个z记录之间采样贴图时将返回的不透明度值。

参数必须为字符串。

discrete

(默认)返回采样点之前的第一个z记录。

linear

线性插值采样点前后的z记录的不透明度。

有关两种模式差异的更多信息，请参见深度阴影贴图。

“beerlambert”, int

评估体积深度阴影贴图时，这将启用Beer-Lambert不透明度插值。Beer-Lambert是一种更准确但更昂贵的插值形式。

参数应为0或1。

“srccolorspace”, string

指定纹理存储的颜色空间。 当访问纹理值时，如果需要，它们将从该空间转换为线性空间进行渲染。

auto

(默认)根据文件确定源颜色空间。目前，这将假设8位纹理为sRGB颜色空间，其他所有纹理为线性。

linear

转换为线性空间。目前这仅影响8位纹理，因为其他所有纹理都被假定为已经在线性空间中。使用此选项可强制线性解释用于凹凸或置换贴图的纹理。

sRGB

无论纹理的位深度或通道数如何，都强制从sRGB颜色空间转换为线性空间。

rec709

从Rec709颜色空间转换为线性空间。

gamma22

从Gamma 2.2颜色空间转换为线性空间。

raw

使用未转换的贴图颜色

srccolorspace参数也可以是OpenColorIO已知的任何颜色空间。

“face”,

使用Ptex纹理贴图时，face参数用于指定ptexture查找的面。 对OpenImageIO格式无效。

“ptexorient”, int

使用Ptex纹理时，多边形上的隐式纹理坐标用作纹理查找的插值(与face结合)。然而，不同的软件可能对缠绕和方向有不同的理解。此关键字参数允许您控制Houdini多边形方向的解释。ptexorient需要一个整数参数，该参数由位字段组成

  • 位0×01：补码s坐标
  • 位0×02：补码t坐标
  • 位0×04：交换s和t坐标

例如，值6(0×4|0×2)相当于调用texture(map, 1-t, s)而不是texture(map, s, t)。

默认ptexorient为0，与http://ptex.us上的示例正常工作。

对OpenImageIO格式无效。

“iesnormalization”, string ="maxvalue"

通过environment()函数查询时，选择不同的IES贴图输出值归一化方法。

none

使用标头中烛光乘数缩放的原始值。

maxvalue

(默认)按最大值归一化。这是mantra默认光着色器使用的传统行为。

preserveenergy

按覆盖角度积分值归一化，因此IES配置文件影响光的形状，同时保持其总能量输出。