Houdini

去 github 下载 plugin，将 plugin copy 到 TestProj/Assets/Plugins/目录下。

• https://github.com/sideeffects/HoudiniEngineForUnity
  

去 github 下载 plugin，目录名称改为 HoudiniEngine。将 plugin copy 到 TestProj/Plugins/Runtime/ 目录下。
打开 UE 工程，会提示是否编译。选择 Yes 之后，需要等待很长一段时间。最终编译结果会放在 TestProj\Plugins\Runtime\HoudiniEngine\Binaries\Win64 目录下。

• https://github.com/sideeffects/HoudiniEngineForUnreal
  
• https://www.bilibili.com/read/cv16472917
  

Vex 引擎可以在 32 位 或 64 位模式下运行。32 位模式下，所有 floats,vectors,以及 integers 都是 32 位的，64 位模式下，则都为 64 位。
为方便肉眼识别,数之间可以使用下划线分割。如：1_000_000, 1.000_000_000_999
{ {1,0,0,0}, {0,1,0,0}, {0,0,1,0}, {0,0,0,1} }

VEX 和 C 语言的操作符基本相同，下面列出存在差异的地方：

• 支持 vectors 或 points 之间的相乘。相乘方式为逐元素相乘（非 dot 或 cross）
  
• 很多非标量类型的操作符是有定义的。例如：vector 和 matrix 相乘表示使用 matrix 对 vector 进行变换
  

• 使用操作符将不同类型的两个变量组合在一起的模棱两可情况下，结果类型为第二个变量的类型。如下：
  

    int + vector = vector
  

vex 支持类似 c 一样的语句。

和 c 语言中一样。

// this is a comment

/*
comment multi lines
comment multi lines
*/

Vex 程序是针对特定 context 的。例如，控制物体表面颜色的 shader (vex 编写的 shader 程序)是专门用于 surface context 的。确定来自一个光源的照度的 shader 则是专门用于 light contex 的。创建或过滤通道数据的 vex 程序是专门用于 chop context 的。

context 会影响哪些函数、语句以及全局变量是可用的。

• https://www.sidefx.com/docs/houdini/vex/lang.html
  

Houdini 中的很多节点可以让你写一段 vex 代码。例如：Attrib Wrangle 几何节点； Geometry Wrangle, 以及 Gas Field Wrangle 动力学节点和粒子动力学节点。这些 vex 表达式会在每个经过该节点的元素上执行。这些代码可以读取节点参数、几何属性、或者可以设置特定变量或修改输入几何的值。

Tip:
Python SOP 类似，但是其允许你使用 python 代码来编辑几何。

出于性能原因，Houdini 正朝着使用 VEX 对属性进行专门的几何修改，而不是使用 HScript 表达式对局部变量和外部通道引用进行操作。

与 HScript 表达式和局部变量相比，使用 VEX 和属性具有主要的性能优势。它运行速度更快，并自动支持线程和并行计算。直接处理属性而不是局部变量实际上具有一些易用性优势，因为局部变量的命名可能与底层属性的名称不一致，并且在节点之间不一致。

在 HScript 表达式中，获取尚未在节点中设置局部变量映射的属性的值是一件苦差事（例如，point(opinputpath(".",0), $PT, "my_var", 0))。在 VEX 中，这要容易得多：v@my_var。由于 Houdini 中的技术工作通常围绕属性展开，这实际上可以使 VEX 表达式比等效的 HScript 表达式简单得多。与在后面节点上使用外部引用前面节点上的数据相比， 将有关属性的信息通过网络传递本质上对并行处理更友好。

目前，已编译的 SOP 块内 VEX 操作已经被支持，但使用了局部变量的 HScript 无法被编译。VEX 已经有了大多数 HScript 表达式函数的等价物，并且更容易用于数组和字符串处理等事情，具有类似 Python 的数组/字符串切片和类似 Python 的字典等便利设施。

随着用户处理越来越大、越来越复杂的几何形状，线程和并行处理对于获得可接受的性能变得越来越重要。这个简单的事实就是为什么 VEX 只会更广泛地用于替代 HScript 表达式以进行临时几何操作的原因。

HScript 可能总是可用于某些比 VEX 更方便的工作。然而，对于几何操作，wrangling 和 VEX/VOP 是发展方向，学习新的工作流程是值得的。

vex snippet 参数允许你输入 VEX 代码片段。

VEX 有 context 的概念。 某些函数仅在某些 context 中可用（例如，访问几何信息的函数在 SOP context 下可以使用）。 VEX snippet 在 CVEX context 中运行。

在 vex snippet 中，你可以将参数的内部名称作为变来来对节点上的参数值进行读写。在参数编辑器中，鼠标悬停在参数名上，tooltip 会显示参数的内部名称。例如，Particle Color DOP 中，Color 参数的内部名称为 color.

多分量参数通过 vector 来进行访问。例如，Position 参数的内部内部名称为 t。可以使用 dot 操作符来访问参数的各个分量。

// set the translation
t = {0, 1, 0};
// move one unit along the x axis
t.x = t.x + 1;

Tips: 使用用户定义的参数，需要使用 chv vex 函数。

在 vex snippet 中，你可以使用 @attribute_name 来对属性值进行读写。例如，可以使用 @P 来对 P（position）属性进行读写。

Particle DOPs 中可以访问粒子属性，但是不能修改。通过改变参数值来影响每个粒子, 具体可以参考如下文档。

• writing particle VEX expressions https://www.sidefx.com/docs/houdini/dopparticles/vexpressions.html
  

在 Volume Wrangle node 中，你可以使用 @volume_name 来读写一个 volume。

如果你对一个 @attribute 进行写入，而该属性不存在，Houdini 将会创建该属性。(Volume Wrange node 不会已这种方式创建新的 volumes)

Houdini 提供了一些类似属性的变量，你可以在 vex snippet 中使用他们。@elemnum 包含当前当前被处理的元素的编号。 @numelem 包含几何或列表中的所有元素的数量。更多信息如下：
Indexing variables

一些节点会提供额外的类似属性的变量，你可以读取。例如，在 Volume Wrangle node, 你可以使用 @center 获得 volume 的中心位置。

Houdini 知道一些常用的属性如何转换为对应的 vex 数据类型。下面列表类出了 Houdini 会自动进行转换的属性。

Tips:
使用 @opinput 访问不同输入上的属性时, 上面的自动转换无法工作，依然需要手动指定属性类型。

除此之外，Houdini 将所有其他 @ 引用的属性都当作 float 类型，除非你指定一个不同的类型。指定类型的方法如下：

在特定节点中(如 Attrib Wrangle 节点)，你可以使用 vex snippets 创建几何体。

addpoint, addprim, addvertex 函数可用于创建 points, primitives, 以及 verteices。使用 setattrib 和 setprimvertex 可以修改几何体。使用 removepoint removeprim 可以删除几何。使用 setpointgroup setprimgroup 可以设置组关系。使用 setprimintrinsic 来修改 primitives 的 intrinsic 属性。

使用绑定变量（例如@name = val）在当前元素上设置属性比使用 setattrib 更快。 仅当您需要在其他元素上设置属性时才使用 setattrib。 如果您正在使用 setattrib 并修改来自不同来源的点时，需要将 mode 参数设置为 add 以合成结果。

几何创建功能可以并行运行。 在你的 VEX 代码遍历所有现有几何图形后，所有更改都会排队并应用。 这意味着 setattrib 将覆盖你通过绑定变量所做的更改（例如 @name = val）。

几何创建函数的第一个参数是“几何句柄”，其指定创建的目的地（这主要用于支持写入文件，作为写入当前几何的一种扩展）。 使用 geoself() 作为第一个参数来指定当前几何。如下：

addpoint(geoself(), {0, 1, 0});

addprim 函数可以生成一个多边形(polygon)或折线(polyline)。如果创建多边形，你必须使用 addvertex 将顶点加入到 primitive。如果多边形只有 points 没有 vertices，Houdini 可能会 crash。

int p1 = addpoint(geoself(), {0, 1, 0});
int p2 = addpoint(geoself(), {1, 1, 0});
int p3 = addpoint(geoself(), {1, 1, 1});

int prim = addprim(geoself(), "poly");
addvertex(geoself(), prim, p1);
addvertex(geoself(), prim, p2);
addvertex(geoself(), prim, p3);

你可以使用 vertexpoint、pointvertex、vertexprim、vertexnext、vertexprev 和 primvertexcount 检查几何的拓扑。

你可以使用 pc* 函数（pcopen、pcnumfound、pciterate、pcimport 等）从点云(point cloud)文件中读取数据。

请参考下面文档

• https://www.sidefx.com/docs/houdini/vex/geometry.html
  

使用 @group_groupname 这种特殊虚拟属性，你可以获取或设置当前元素的分组。

你可以通过 @group_name == 1 来检查当前点/边/基元/粒子是否在指定命名的分组中。

你可以通过设置 @group_name 虚拟属性将当前点/边/基元添加或删除到组中。 将属性设置为 1（或任何非零值）会将当前元素置于该组中。 将该属性设置为 0 会从该组中删除当前元素。

在 vex snippet 中可以定义自己的函数, 如下：

float mysquare(float a)
{
    return a * a;
}

windresist = mysquare(windresist);

#include 指令用于引入其他文件。

确定是否存在用于属性绑定的参数是通过在预处理完成后简单扫描代码来完成的。这种预处理只在 code snippets 上完成； 但是，并且不处理任何#include 文件。 因此它可能会被依赖于#includes 的#ifdef 指令混淆。

• 每个语句必须以分号 (;) 结尾！
  
• / 和 /* … * 可用于注释。
  
• 在 VEX 中，诸如 sin 和 cos 之类的三角函数使用弧度，而不是度数。
  
• 使用@v.x 而不是$VX 来操作一个 vector 的属性。 也就是说，你获得的是一个 @v 向量值，可以使用点符号访问其中的 x、y 或 z 分量，而不是获得三个单独的分开的变量 $VX、$VY 和 $VZ。
  
• rand 应用于向量变量时会产生向量噪声。
  

• Ctrl+Enter 可以提交 vex snippet。
  
• 每帧都会执行 vex snippet。（如果是在 simulation 网络中，每个 time step 都会执行）
  

• 可以使用 return，更早地离开 vex snippet.
  

    if (@age > 0) return;
  
    // If @age was > 0, we returned above, so this line
    // only runs for particles where @age == 0
    windresist = 0;
  

• Bracelet https://www.sidefx.com/tutorials/houdini-friendship-bracelet-tutorial/
  
• House https://www.sidefx.com/tutorials/procedural-house/
  
• Knife https://www.sidefx.com/tutorials/knife-modeling-basics/
  
• Firewatch https://www.sidefx.com/tutorials/houdini-185-firewatch-project-building-the-base-tower/
  

• Rig Fur Dude with KineFX https://www.sidefx.com/tutorials/foundations-rig-fur-dude-with-kinefx/
  

进入 BakeTexture node，在 baking 选项中，取消 Disable Lighting/Emission

• https://www.sidefx.com/forum/topic/61112/
  

设置 curve 的 up 属性可以修复该问题。