Attribute Wrangle: ваш параллельный for-each по геометрии

VEX-код в SOP-сети чаще всего пишут в ноде Attribute Wrangle. Для программиста это как написать C-подобную функцию, которую Houdini сам применяет к каждому элементу геометрии — точке, примитиву, вершине. Исполнение идёт параллельно (многопоточно), поэтому по духу это ближе к ядру обработки данных или шейдеру, чем к обычному скрипту.

Представьте массив структур:

struct Point { vector3 position; vector3 color; };
Point geometry[1000];

for (int i = 0; i < 1000; i++) {
    geometry[i].position.y *= 2.0;
}

В VEX вы пишете только тело этого цикла — итерацию и распределение по потокам организует нода:

@P.y *= 2.0;

Каждый вызов видит только «свой» элемент, поэтому гонок данных между итерациями нет, если вы явно не обращаетесь к соседним точкам.

Режимы исполнения: Run Over

Параметр Run Over задаёт, что считается элементом:

• Points — код выполняется для каждой точки (самый частый режим);
• Primitives — для каждого примитива (полигона);
• Vertices — для каждой вершины (связка точки и примитива);
• Detail — ровно один раз для всей геометрии (глобальные значения, инициализация);
• Numbers — заданное число итераций.

Типы данных и доступ к атрибутам

Префикс @ — это доступ к атрибуту текущего элемента. К компонентам вектора обращаются как к полям структуры: @P.x, @P.y, @P.z, а для цвета — @Cd.r, @Cd.g, @Cd.b (Cd = Color diffuse). Это не отдельная переменная, а срез внутри vector.

Атрибут @P есть у точек всегда — это позиция. @Cd — стандартное имя для цвета, но сам атрибут появляется на геометрии в момент первой записи в него; увидеть его можно в Geometry Spreadsheet.

graph LR
    A[Входная геометрия: N точек] --> B[Attribute Wrangle]
    B -->|Run Over: Points| C1[VEX-вызов для точки 0]
    B -->|Run Over: Points| C2[VEX-вызов для точки 1]
    B -->|Run Over: Points| C3[VEX-вызов для точки N-1]
    C1 --> D[Выходная геометрия]
    C2 --> D
    C3 --> D

// Attribute Wrangle, Run Over: Points
float freq = chf("frequency");   // "channel float" — параметр ноды
float amp  = chf("amplitude");

float offset = sin(@P.x * freq) * amp;
@P.y += offset;

// нормализуем offset в диапазон [0,1] для цвета
float h = fit(offset, -amp, amp, 0.0, 1.0);
@Cd = set(h, 0.2, 1.0 - h);