volumecubicsample

float volumecubicsample(<geometry>geometry, int primnum, vector pos)

float volumecubicsample(<geometry>geometry, string volumename, vector pos)

float volumecubicsample(<geometry>geometry, int primnum, vector pos, vector &grad)

float volumecubicsample(<geometry>geometry, string volumename, vector pos, vector &grad)

float volumecubicsample(<geometry>geometry, int primnum, vector pos, vector &grad, matrix3 &hess)

float volumecubicsample(<geometry>geometry, string volumename, vector pos, vector &grad, matrix3 &hess)

<geometry>

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

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

返回值

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

grad和hess参数返回此采样函数的梯度或Hessian矩阵，可与值同时计算。

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

使用volumecubicsample对一维和二维数据进行插值的示例。可视化法线通过grad参数计算。

示例

示例

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

vector  P = {1.0, 2.0, 3.0};
vector grad;
matrix3 hess;
float val1 = volumecubicsample(0, "density", P, grad, hess);

vector u = {0.1, 0.01, 0.001};
float val2 = volumecubicsample(0, "density", P + u);

// 根据泰勒展开式可得：
// `val1 + dot(u, grad)` 约等于 `val2`

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