volumecubicsamplev

vector volumecubicsamplev(<geometry>geometry, int primnum, vector pos)

vector volumecubicsamplev(<geometry>geometry, string volumename, vector pos)

vector volumecubicsamplev(<geometry>geometry, int primnum, vector pos, matrix3 &grad)

vector volumecubicsamplev(<geometry>geometry, string volumename, vector pos, matrix3 &grad)

vector volumecubicsamplev(<geometry>geometry, int primnum, vector pos, matrix3 &grad, matrix3 &hessX, matrix3 &hessY, matrix3 &hessZ)

vector volumecubicsamplev(<geometry>geometry, string volumename, vector pos, matrix3 &grad, matrix3 &hessX, matrix3 &hessY, matrix3 &hessZ)

<geometry>

在节点上下文（如wrangle SOP）中运行时，此参数可以是表示输入编号（从0开始）的整数，用于读取几何体。

或者，该参数可以是指定要读取的几何文件（例如.bgeo）的字符串。在Houdini内部运行时，可以是op:/path/to/sop引用。

返回值

在给定位置处体积图元的采样值。体素之间的值通过三次插值计算。

grad是一个矩阵，其第i列是体积第i分量的梯度。

矩阵hessX、hessY、hessZ分别是x、y和z分量的二阶导数。

如果primnum或inputnum超出范围、几何体无效，或给定图元不是体积或vdb图元，则返回0。

示例

使用点P处的体积值来近似计算点P + u处的体积值。

vector  P = {1.0, 2.0, 3.0};
matrix3 grad, hessX, hessY, hessZ;
vector val1 = volumecubicsamplev(0, "vel", P, grad, hessX, hessY, hessZ));

vector u = {0.1, 0.01, 0.001};
vector val2 = volumecubicsamplev(0, "vel", P + u);

// 根据泰勒展开式我们有：
// `val1 + u * grad` 约等于 `val2`

// 二阶近似：
// `val1 + u * grad + 0.5 * set(dot(u, u*hessX), dot(u, u*hessY), dot(u, u*hessZ))`
// 约等于 `val2`