1. 初识VEX：为什么说它是Houdini技术艺术家的“瑞士军刀”？
如果你刚开始接触Houdini，可能会被各种节点和连线搞得眼花缭乱。但当你深入到一定程度，想要实现一些更灵活、更高效的控制时，总会遇到一个绕不开的名字：VEX。我第一次接触VEX时，感觉它就像是藏在Houdini庞大身躯里的一个“秘密武器”，一旦掌握，很多复杂效果都能信手拈来。简单来说，VEX是Houdini内置的一种高性能脚本语言，专门用来处理几何体属性、计算和逻辑控制。它不像Python那样通用，但在Houdini内部操作几何数据时，速度要快得多，尤其是在处理成千上万个点、面的时候，这种速度优势非常明显。
为什么我们这么需要VEX呢？这得从Houdini的工作方式说起。Houdini的核心是“基于属性的建模”，场景中的每一个点、每一个面都携带了大量的信息，比如位置（P）、颜色（Cd）、法线（N）、速度（v）等等。这些信息就是属性。传统的节点操作，比如Transform、Color节点，虽然直观，但它们是“黑盒”操作，你只能调节参数，无法深入到每个元素进行精细控制。而VEX就像给了你一把手术刀，让你可以直接读写、修改这些属性，实现真正意义上的“像素级”操控。比如，你想让模型上每个点的移动幅度都跟它的高度相关，或者想让粒子根据周围密度改变颜色，用VEX写几行代码就能轻松搞定。
很多从其他三维软件转过来的朋友，可能会觉得写代码很头疼。但我想说，VEX可能是你遇到过的最“友好”的脚本语言之一。它的语法借鉴了C语言，但简化了很多，更专注于数据处理。你不需要像开发软件一样去考虑内存管理、复杂的类结构，你的核心任务就是：获取属性 -> 计算 -> 设置属性。整个思维模式非常直接。而且，Houdini提供了Attribute Wrangle（属性缠绕）节点作为VEX的主要“战场”，这个节点的界面就是一个代码编辑器，你写好的代码会作用在流经该节点的每一个点、顶点或面上，这种“数据并行”的处理方式，正是现代计算机多核性能的完美体现。我常跟团队里的新人说，学好VEX，不是让你去当程序员，而是让你从一个“节点操作工”升级为“效果设计师”，能把自己的想法更直接、更高效地实现出来。
2. VEX语法核心：从“Hello World”到属性自由读写
2.1 属性声明：给你的数据贴上标签
在VEX里操作属性，第一步就是“声明”。你可以把它理解为告诉Houdini：“嘿，接下来我要用一个叫mass的属性，它是浮点数，如果之前没有，你就先按1这个值创建它。”声明的语法很简单，主要有两种风格。
第一种是完整声明，使用类型关键词开头：
float @my_float = 0.5; // 声明一个浮点属性，默认值0.5 vector @my_vector = {0, 1, 0}; // 声明一个向量属性，默认朝向Y轴 int @my_id[]; // 声明一个整数数组属性，不赋初值这里有个新手常踩的坑：用{ }初始化向量时，里面的值必须是常数，不能是变量或表达式。比如vector @up = {0, @P.y, 0};是会报错的。正确的做法是使用set()函数：vector @up = set(0, @P.y, 0);。
第二种是更常用的简写声明，在属性名前加一个类型前缀字母：
f@mass = 1.0; // 等同于 float @mass = 1.0; v@wind = set(1, 0, 0); // 等同于 vector @wind = {1, 0, 0}; i[]@index_list; // 等同于 int @index_list[];这种写法更紧凑，而且在属性不存在时，Houdini会自动创建它。我个人的习惯是，在Attribute Wrangle节点里，一律使用简写声明，因为它写起来快，读起来也清晰。需要注意的是，数组属性不能用简写方式赋初始值，比如i[]@arr = {1, 2, 3};是错误的，你需要先声明，再通过循环或其他方式赋值。
2.2 访问与修改：@符号的魔法
声明了属性，接下来就是读写操作。VEX最精髓的符号就是@。在代码中，@P代表当前处理元素的位置属性，@Cd代表颜色，@N代表法线。直接对它们赋值，就能修改属性。
// 让所有点沿法线方向移动 @P += @N * 0.1; // 根据点的Y坐标设置颜色（渐变） @Cd = set(0, @P.y / 10.0, 1.0);这里@P += @N * 0.1;这一行代码的效果，相当于连接了一个沿着法线方向的Transform节点，但更加灵活。你可以把0.1替换成任何基于其他属性的计算，比如根据噪波纹理来变化位移量。
除了常见的P、Cd，你还可以访问很多Houdini提供的“内置变量”，它们非常有用：
@ptnum：当前点的序号（从0开始）。@primnum：当前面的序号。@numpt：点的总数。@Frame：当前帧号（替代HScript中的$F）。@Time：当前时间（替代HScript中的$T）。
利用这些变量，你可以轻松实现基于序号或时间的动画。比如，做一个点序号波浪动画：
// 根据点序号和时间的正弦波，在Y轴上移动 float wave = sin(@ptnum * 0.1 + @Time * 2.0); @P.y += wave * 0.5;短短三行代码，就能生成复杂的动态效果，这就是VEX效率的体现。@符号默认是浮点类型，当你操作一个已知类型的属性（如向量类型的v速度）时，最好加上类型前缀来避免意外：v@v += set(0, -9.8, 0) * @TimeInc;这里@TimeInc是每帧的时间增量，用来模拟重力加速度更准确。
2.3 跨越端口：读取其他节点的数据
一个强大的特效往往由多个节点网络构成。在Attribute Wrangle节点里，我们经常需要读取其他输入端口的数据。比如，第一个输入（0号）是当前要处理的几何体，第二个输入（1号）可能是一个作为参考的力场或吸引物。 这时就需要用到opinput语法。
// 读取1号输入端口上，对应点（@ptnum）的P属性 vector target_pos = point(1, "P", @ptnum); // 计算朝向目标的方向向量，并归一化 vector dir = normalize(target_pos - @P); // 让当前点以一定速度移向目标 @P += dir * 0.05 * @TimeInc;point()函数是一个非常重要的函数，它的基本格式是point(输入端口索引, "属性名", 点序号)。同理，还有prim()读取面属性，vertex()读取顶点属性，detail()读取整体（detail）属性。detail属性是整个几何体只有一个值的属性，比如包围盒大小、平均高度等。
有时候，两个输入端口几何体的点序并不对应。Houdini在Attribute Wrangle节点的参数栏里提供了一个非常贴心的功能：“Attribute to Match”（匹配属性）。你可以指定一个属性（比如id），让节点根据这个属性的值去匹配两个输入中的对应元素，而不是简单地按序号匹配。这在处理从不同源合并或经过重拓扑的几何体时，能确保数据关联正确，避免错位。
3. 高效属性操作实战：从基础函数到性能心法
3.1 属性函数三剑客：add、set、get
虽然@符号用起来很方便，但在一些特定场景下，使用属性操作函数会更灵活、更强大。它们主要分为三类：添加（add）、设置（set）、获取（get）。
添加属性函数用于在指定的几何体层级上创建一个新属性。这在初始化阶段非常有用。
// 在Detail层级添加一个名为“total_mass”的浮点属性，初始值为0 adddetailattrib(0, "total_mass", 0.0); // 为每个点添加一个名为“heat”的浮点属性，初始值为0.5 addpointattrib(0, "heat", 0.5);注意，如果属性已存在，addpointattrib不会覆盖原有值。通常，在Wrangle节点中，我们更倾向于直接用f@heat = 0.5;这样的简写，因为如果heat属性不存在，它也会被自动创建。add*attrib函数更常用于在代码逻辑中动态判断是否需要创建某个属性。
设置属性函数允许你为任意元素（不一定是当前正在处理的元素）设置属性值。这是@语法做不到的，@只能操作当前元素。
// 将序号为5的点的颜色设置为红色 setpointattrib(0, "Cd", 5, {1, 0, 0}); // 基于某个条件，修改另一个点的属性 int neighbor_pt = neighbour(0, @ptnum, 0); // 获取当前点的第一个邻接点 if (neighbor_pt != -1) { float neighbor_height = point(0, "P", neighbor_pt).y; if (neighbor_height > @P.y) { // 如果邻居点更高，把自己的颜色调蓝一些 setpointattrib(0, "Cd", @ptnum, @Cd * set(0.8, 0.8, 1.0)); } }这个例子展示了setpointattrib的威力：你可以在处理当前点时，根据逻辑去修改其他点的状态，实现点与点之间的交互。这在模拟扩散、感染、传递等效果时是核心手段。
获取属性函数我们已经见过了，就是point(),prim(),vertex(),detail()这一组。它们是你从几何体中提取信息的万能钥匙。一个实用的技巧是，你可以通过detail()函数获取一些全局信息来辅助计算：
// 获取整个几何体的包围盒最小值和最大值 vector bbox_min = detail(0, "bbox_min", 0); vector bbox_max = detail(0, "bbox_max", 0); vector bbox_center = (bbox_min + bbox_max) / 2.0; // 计算当前点到中心点的距离，并归一化到0-1范围 float dist = distance(@P, bbox_center); float max_dist = distance(bbox_max, bbox_center); f@relative_dist = dist / max_dist;这样，你就得到了一个基于空间位置的标准化属性，可以用来驱动颜色、大小、透明度等，做出从中心向边缘衰减的效果。
3.2 玩转组（Group）：逻辑控制的核心
在Houdini中，组（Group）是管理几何体子集的强大工具。在VEX中，你可以通过@group_组名这个虚拟属性来读写组。它的值是整数，非0表示“在组内”，0表示“不在组内”。
// 根据Y坐标将点加入“high_points”组 if (@P.y > 0) { i@group_high_points = 1; // 加入组 } else { i@group_high_points = 0; // 从组中移除（如果之前在的话） } // 更简洁的写法：条件表达式直接赋值 i@group_high_points = @P.y > 0;操作组让你能对几何体的不同部分实施不同的规则。例如，你可以先根据某种规则（如随机数、位置、属性阈值）创建一个组，然后在后续的Wrangle节点中，通过if (@group_mygroup == 1)来判断，只对组内的元素进行昂贵的计算或特殊的变形，从而大幅提升效率。
你还可以使用专门的组操作函数，它们功能更丰富：
// 将当前点添加到‘active’组 setpointgroup(0, "active", @ptnum, 1, "set"); // 从‘inactive’组中移除当前点 setpointgroup(0, "inactive", @ptnum, 0, "set"); // 切换（toggle）当前点在‘toggle_group’中的状态 setpointgroup(0, "toggle_group", @ptnum, -1, "toggle");setpointgroup的最后一个参数是操作模式，"set"是直接设置，"toggle"是切换，"union"是求并集等。这在做交互式工具或复杂的状态管理时非常有用。
3.3 性能优化与避坑指南
VEX很快，但写得不好也会成为瓶颈。下面是我在实际项目中总结的几个关键优化点和常见“坑”。
1. 避免在循环内频繁调用查找函数像nearpoint()、minpos()这类函数，会根据空间结构进行搜索，比较耗时。如果可能，尽量在循环外预先计算好所需数据。
// 不推荐的写法（在每点循环内多次搜索） int near_pt = nearpoint(0, @P); vector near_pos = point(0, "P", near_pt); ... // 其他操作 // 更好的写法：如果只是需要最近点的位置，一次函数调用即可 vector near_pos = minpos(0, "P", @P);对于固定的参考几何体（比如第二个输入），可以考虑使用pcopen()和pciterate()（点云函数）进行一次性批量查询，这比在循环里反复调用nearpoint高效得多。
2. 理解属性绑定的优先级在Attribute Wrangle节点里，属性修改的最终结果有一个优先级顺序，理解它能避免奇怪的结果：
- 通过
setpointattrib()等函数写入输出几何体的修改，优先级最高。 - 直接使用
@attr = value;修改当前几何体的属性。 - 通过
point()等函数从输入几何体读取属性。 一个典型的顺序问题是：
@my_attr = 10; // 设置当前几何体属性为10 setpointattrib(0, "my_attr", @ptnum, 20); // 设置输出几何体属性为20 vector final_value = point(0, "my_attr", @ptnum); // 读取输出几何体的值最终final_value会是20，因为setpointattrib的写入发生在最后，覆盖了@my_attr=10的设置。而如果最后一行是@my_attr，它读取的则是“当前几何体”的值，可能还是10。这种细微差别在调试时要特别注意。
3. 善用Detail模式处理全局数据当你的代码不需要遍历每个点，而是只需要计算一次全局值时，一定要把Wrangle节点的“Run Over”参数从“Points”（点）改为“Detail”（整体）。这样整个代码块只执行一次，性能开销极小。
// 在Detail模式下运行 // 计算所有点的平均高度 float total_height = 0; for (int i = 0; i < @numpt; i++) { total_height += point(0, "P", i).y; } f@average_height = total_height / @numpt;然后，你可以在另一个运行在“Points”模式的Wrangle节点中，读取这个detail属性detail(0, "average_height", 0)，让每个点都知道全局的平均高度。这种“先全局计算，再局部应用”的模式非常高效。
4. 数组与循环的注意事项VEX支持数组，用于存储一系列值。操作数组时，要注意边界。
// 声明并初始化一个数组 int my_array[] = array(1, 2, 3, 5, 8); // 安全地遍历数组 for (int i = 0; i < len(my_array); i++) { // 处理 my_array[i] } // 动态添加元素 append(my_array, 13);如果数组可能很大，且需要频繁查找成员，可以考虑使用dict（字典）来获得更快的查找速度，尽管它在内存上开销稍大。
4. 进阶技巧与实战案例解析
4.1 动态创建与修改几何体
VEX不仅能修改属性，还能直接创建和删除几何体元素。这让你能在程序化流程中动态构建形态。
// 1. 创建点 int new_pt = addpoint(0, @P + set(0, 1, 0)); // 在当前点上方1单位创建一个新点 // 为新点设置属性 setpointattrib(0, "Cd", new_pt, {0, 1, 0}); // 绿色 setpointattrib(0, "pscale", new_pt, 0.2); // 点大小 // 2. 创建多边形（Primitive） int pt_list[] = array(new_pt, @ptnum); // 准备一个点索引列表 int new_prim = addprim(0, "poly", pt_list); // 用这两个点创建一条线段 // 为面设置属性 setprimattrib(0, "Cd", new_prim, {1, 0.5, 0}); // 橙色 // 3. 删除满足条件的点（小心使用！） if (@P.y < 0) { removepoint(0, @ptnum); }addprim函数非常强大，第二个参数指定创建的类型，可以是"poly"（多边形）、"tet"（四面体）、"sphere"（球体，需要更多参数）等。结合循环和条件判断，你可以用代码“生长”出复杂的结构，比如分形树、血管网络等。
一个实战案例是“根据曲线生成扫描体”。你可以在一个Detail模式下运行的Wrangle中，读取一条输入曲线的所有点位置，然后通过循环，依次创建截面圆环的点，再用addprim连接成面。这个过程完全由代码控制，你可以轻松地加入截面大小变化、扭曲、随机扰动等效果，比使用传统的Sweep节点灵活得多。
4.2 向量与矩阵运算：实现复杂变形
VEX内置了丰富的数学函数，特别是向量和矩阵运算，这是实现高级变形的基石。
// 示例：让几何体围绕一个自定义轴心点和轴向旋转 vector pivot = {0, 5, 0}; // 轴心点 vector axis = normalize({1, 0, 1}); // 旋转轴（单位化） float angle = @Time * 10.0; // 随时间旋转的角度 // 构建旋转矩阵（绕任意轴旋转） matrix3 rot_m = ident(); rotate(rot_m, angle, axis); // 应用变换：1.移动到原点 2.旋转 3.移回 vector local_pos = @P - pivot; // 移动到局部空间（以轴心为原点） vector rotated_pos = local_pos * rot_m; // 旋转 @P = rotated_pos + pivot; // 移回世界空间这个例子展示了比简单使用rotate节点更强大的控制力。你可以让不同的点拥有不同的轴心、不同的旋转轴和速度，创造出漩涡、扭曲、螺旋上升等复杂动画。
另一个常用技巧是使用dot（点积）和cross（叉积）。点积可以用来计算投影、判断前后关系；叉积可以用来生成垂直向量、计算面积。
// 判断点是否在某个锥形视野内 vector view_dir = normalize(v@view_direction); // 观察方向 vector to_point = normalize(@P - v@view_position); // 到点的方向 float cos_angle = dot(view_dir, to_point); // 方向夹角的余弦值 float fov_cos = cos(radians(30.0)); // 30度视野的余弦值 if (cos_angle > fov_cos) { @Cd = {1, 0, 0}; // 在视野内，显示为红色 } else { @Cd = {0.2, 0.2, 0.2}; // 在视野外，显示为暗色 }4.3 与外部参数的联动：ch()函数
虽然可以直接用参数名作为变量，但更稳健和通用的方式是使用ch()函数族来读取节点参数。它的好处是，即使参数名改变了，代码里的引用字符串也可以不变，而且支持相对路径引用其他节点的参数。
// 读取本节点上一个名为‘amplitude’的浮点参数 float amp = chf("amplitude"); // 读取本节点上一个名为‘center’的向量参数 vector center = chv("center"); // 读取相对路径参数：当前节点的父节点下的‘transform1’节点的‘tx’参数 float parent_tx = chf("../transform1/tx"); // 使用参数驱动效果 float noise = noise(@P * chf("freq") + @Time * chf("speed")); @P.y += noise * amp;chf用于浮点数，chv用于向量，chi用于整数，chs用于字符串。养成使用ch()函数的习惯，能让你的VEX代码模块化程度更高，更容易被其他艺术家复用和调节。你可以把一整套复杂的算法封装在一个Wrangle节点里，然后暴露出几个关键的ch()参数（如强度、频率、速度），这样即使不懂代码的同事，也能通过调节这些参数来控制最终效果，极大地提升了团队协作的效率。
最后，调试VEX代码是必不可少的技能。除了查看几何体视图，多用printf()函数在文本端口输出中间变量的值。对于向量，可以用printf("Position: %g, %g, %g\n", @P.x, @P.y, @P.z);。遇到复杂逻辑时，可以先用一个简单的条件（比如@ptnum == 0）只让第一个点执行你的代码，逐步验证逻辑是否正确。VEX的学习曲线初期可能有点陡峭，但一旦你习惯了这种“直接操作数据”的思维方式，就会发现它在Houdini中几乎无所不能。从简单的属性传递，到复杂的物理模拟、程序化建模，VEX都是你最值得信赖的高效伙伴。多写，多试，多拆解别人的案例，很快你就能从“知道怎么写”进化到“知道怎么写更好”。
