挨代码

VEX —— Functions|Geometry

geoself —— 返回当前几何体的handle

addpoint —— 添加点到几何体

addprim —— 添加面到几何体

addvertex —— 添加一顶点到面

minpos —— 查找点离几何体表面最近的位置

nearpoint —— 查找离几何体最近的点

nearpoints —— 查找离几何体所有最近的点

neighbour —— 下一个被连接到给定点的点号

neighbours —— 所有被连接到给定点的点号

neighbourcount —— 被连接到给定点的点总数

intersect —— 计算射线的第一个交点

intersects —— 计算射线的所有交点

pointprims —— 返回包含指定点的prim列表

pointvertices —— 返回连接到指定点的顶点列表

pointvertex —— 返回与指定点共享的第一个顶点的线性顶点号

primpoints —— 返回指定prim上点的列表

primvertices —— 返回指定prim上的线性顶点列表

primpoint —— 将prim上的vertex转化为对应的点号

primvertex —— 将prim上的顶点转化为对应的线性顶点

primvertexcount —— 返回prim上的顶点总数

primfind —— 返回可能与boundingbox边界相交的面号列表

polyneighbours —— 返回边邻居的面号数组

vertexindex —— 将顶点转化为线性顶点

vertexprev —— 返回与给定顶点分享点的上一个顶点的线性顶点号

vertexnext —— 返回与给定顶点分享点的下一个顶点的线性顶点号；

vertexpoint —— 返回线性顶点的点号；

vertexprim —— 返回包含给定线性顶点的面号；

vertexprimindex —— 将线性顶点转化为顶点号；

npoints —— 返回点总数

nprimitives —— 返回面总数

nvertices —— 返回顶点总数

npointsgroup —— 返回组内的点总数

nprimitivesgroup —— 返回组内的面总数

nverticesgroup —— 返回组内的顶点总数

removeattrib —— 移除指定属性或组

removepoint —— 移除指定点

removeprim —— 移除指定面

removevertex —— 移除指定顶点

setprimvertex —— 将顶点重连接到不同的点

setvertexpoint —— 将顶点重连接到不同的点

setedgegroup —— 设置边组成员

expandedgegroup —— 返回边点列表

inedgegroup —— 是否在指定的边组

nedgesgroup —— 返回组内的边数

uvintersect —— 计算在UV空间内射线交点

vertexcurveparam —— 沿着面的周长返回顶点参数坐标

clip —— 切割p0和p1之间的线段

geounwrap

geoself —— 返回当前几何体的handle

int geoself()
Return，返回当前几何体的handle，适用于几何图形创建操作；

addpoint —— 添加点到几何体

//创建一个新点，伴随给定点号的所有属性和组；
int addpoint(int geohandle, int point_number)
//创建一个新点，在指定位置；
int addpoint(int geohandle, vector pos)
Args

geohandle，待写入的几何体，仅0、geoself有效；

Return

返回新点的点号，未创建新点返回-1；

可使用返回值，通过setpointattrib函数设置新点属性，有可能不是最终的点号；

int pt = addpoint(0,{1,1,1});
setpointattrib(0,"a",pt,1);

addprim —— 添加面到几何体

//创建polygon或polyline，然后可使用addvertex添加顶点到面
//确保添加至少一个顶点到面，如处理空几何体可能引起奇怪的结果或失败
int addprim(int geohandle, string type)
//使用被点号指定的点，来创建prim
int addprim(int geohandle, string type, int pt0)
int addprim(int geohandle, string type, int pt0, int pt1)
int addprim(int geohandle, string type, int pt0, int pt1, int pt2)
int addprim(int geohandle, string type, int pt0, int pt1, int pt2, int pt3)
int addprim(int geohandle, string type, int pt0, int pt1, int pt2, int pt3, int pt4, int pt5, int pt6, int pt7)
//使用被点号数组指定的点，来创建prim
int addprim(int geohandle, string type, int points[])
//输出新prim对应的顶点号，然后可使用setvertexattrib函数设置顶点属性，可能不是最终的顶点号
void addprim(int &prim_num, int geohandle, string type, int pt0, int &vertices[])
void addprim(int &prim_num, int geohandle, string type, int pt0, int pt1, int &vertices[])
void addprim(int &prim_num, int geohandle, string type, int pt0, int pt1, int pt2, int &vertices[])
void addprim(int &prim_num, int geohandle, string type, int pt0, int pt1, int pt2, int pt3, int &vertices[])
void addprim(int &prim_num, int geohandle, string type, int pt0, int pt1, int pt2, int pt3, int pt4, int pt5, int pt6, int pt7, int &vertices[])
void addprim(int &prim_num, int geohandle, string type, int points[], int &vertices[])
Args

geohandle，待写入的几何体，仅0、geoself有效；

type，新面的类型；

"poly"，封闭的几何体，可使用0或更多的点；

"polyline"，打开的几何体，可使用0或更多的点；

"tet"，四面体Tetrahedron，要求4个点，不能添加顶点到prim；

“hex”，六面体Hexahedron，要求8个点，不能添加顶点到prim；

"sphere", "circle", "tube", "metaball", "metasquad"，创建对应类型的prim，半径和形状由内在变换属性控制，要求1个点，不能添加顶点到prim；

"AlembicRef", "PackedDisk"，创建对应类型的prim，要求1个点，不能添加顶点到prim；

Return

返回新prim的面号，未创建则返回-1；

可使用返回值，通过setprimattrib函数设置新面属性，有可能不是最终的面号；

//使用setprimintrinsic函数设置primitive’s transforms
matrix3 transform_value = {{0, 0, 0}, {0, 0, 0}, {1, 1, 1}};
setprimintrinsic(geoself(), "transform", prim, transform_value);

//也可设置Alembic/packed primitive intrinsics
setprimintrinsic(geoself(), "unexpandedfilename", prim, "test.bgeo");

int p0 = addpoint(0, chv("p0"));
int p1 = addpoint(0, chv("p1"));
int p2 = addpoint(0, chv("p2"));
int p3 = addpoint(0, chv("p3"));
int prim = addprim(0, "poly");
addvertex(0, prim, p0);
addvertex(0, prim, p1);
addvertex(0, prim, p2);
addvertex(0, prim, p3);

addvertex —— 添加一顶点到面

int addvertex(int geohandle, int prim_num, int point_num)
Args

geohandle，待写入的几何体，仅0、geoself有效；

Return

返回线性顶点索引，未创建则返回-1；

可使用返回值，通过setvertexattrib函数设置新顶点属性，有可能不是最终的顶点索引；

minpos —— 查找点离几何体表面最近的位置

//返回点离几何体最近点位置
vector minpos(geometry, vector point)
//返回点离几何体最近点位置，在指定最大距离内
vector minpos(geometry, vector point, float maxdist)
//返回点离几何体最近点位置，在指定面组内
vector minpos(geometry, string primgroup, vector point)
//返回点离几何体最近点位置，在指定面组及最大距离内
vector minpos(geometry, string primgroup, vector point, float maxdist)
Args

，当运行在一个节点context（如wrangle SOP）时，此参数可以是一个整数（表示输入端）；也可是一字符串（指定一几何体文件，如a.bgeo）；

primgroup，面组；可使用类似@Cd.x>0来指定组（可能需要反斜杠转义），空字符串表示所有面；

point，指定的空间点位置；

maxdist，查找最大距离；

Return

最近点位置，未查找到最近点返回point；

nearpoint —— 查找离几何体最近的点

int nearpoint(geometry, vector pt)
int nearpoint(geometry, vector pt, float maxdist)
int nearpoint(geometry, string ptgroup, vector pt)
int nearpoint(geometry, string ptgroup, vector pt, float maxdist)
查找几何体上最近的点号，并不是表面的位置；

使用xyzdist可查找表面或曲线上最近点；

Args

，当运行在一个节点context（如wrangle SOP）时，此参数可以是一个整数（表示输入端）；也可是一字符串（指定一几何体文件，如a.bgeo）；

ptgroup，点组，可使用SOP风格的组样式如0-10或@Cd.x>0.5，空字符串表示所有点；

pt，指定的空间点位置；

maxdist，最大查找距离；

Return

最近点号，未查找到返回-1；

nearpoints —— 查找离几何体所有最近的点

int[] nearpoints(geometry, vector pt, float maxdist)
int[] nearpoints(geometry, vector pt, float maxdist, int maxpts)
int[] nearpoints(geometry, string ptgroup, vector pt, float maxdist)
int[] nearpoints(geometry, string ptgroup, vector pt, float maxdist, int maxpts)
Args

，当运行在一个节点context（如wrangle SOP）时，此参数可以是一个整数（表示输入端）；也可是一字符串（指定一几何体文件，如a.bgeo）；

ptgroup，点组，可使用SOP风格的组样式如0-10或@Cd.x>0.5，空字符串表示所有点；

pt，指定的空间点位置；

maxdist，最大查找距离；

maxpts，最大查找点数；

Return

返回搜索距离内的点号数组；

vector point = chv("point");
int pts[] = nearpoints(1, point, ch("maxdist"), chi("maxpts"));
vector pos;
int pt0 = addpoint(0, point);
int pt1;
foreach(int pt; pts){
    pos = point(1, "P", pt);
    pt1 = addpoint(0, pos);
    addprim(0, "polyline", pt0, pt1);
}

neighbour —— 下一个被连接到给定点的点号

int neighbour(geometry, int point_num, int neighbour_num)
Args

，当运行在一个节点context（如wrangle SOP）时，此参数可以是一个整数（表示输入端）；也可是一字符串（指定一几何体文件，如a.bgeo）；

point_num，指定的点号；

neighbour_num，将查找的邻居，邻居们没有特定的顺序；

neighbourcount，获取所有连接邻居的总数；

Return

超出邻居数，点超出范围或不存在，返回-1；

neighbours —— 所有被连接到给定点的点号

int[] neighbours(geometry, int ptnum)
，当运行在一个节点context（如wrangle SOP）时，此参数可以是一个整数（表示输入端）；也可是一字符串（指定一几何体文件，如a.bgeo）；

//大致等价
int[] neighbours(int opinput, int ptnum)
{
    int i, n;
    int result[];
    n = neighbourcount(input, ptnum);
    resize(result, n);
    for (i = 0; i < n; i++)
        result[i] = neighbour(input, ptnum, i);
}

neighbourcount —— 被连接到给定点的点总数

int neighbourcount(geometry, int point_num)
Args

，当运行在一个节点context（如wrangle SOP）时，此参数可以是一个整数（表示输入端）；也可是一字符串（指定一几何体文件，如a.bgeo）；

point_num，指定的点号；

Return

指定点号超出范围或没有输入，返回0；

intersect —— 计算射线的第一个交点

int intersect(geometry, vector orig, vector dir, vector &p, float &u, float &v)
int intersect(geometry, vector orig, vector dir, vector &p, float &u, float &v, ...)
int intersect(geometry, vector orig, vector dir, vector &p, vector &uvw)
int intersect(geometry, string group, vector orig, vector dir, vector &p, vector &uvw)
Args

，当运行在一个节点context（如wrangle SOP）时，此参数可以是一个整数（表示输入端）；也可是一字符串（指定一几何体文件，如a.bgeo）；

group，面组；

orig，射线起点；

dir，射线方向和最大距离；

&p，交点位置；

&u、&v、&uvw，在面上的参数化交点位置；

Return

交点面号，没有相交或错误返回-1；

注，当与metaball相交时，不能确定面号，将返回面总数；

vector origin = @P;
float max_dist = 1000;
vector dir = max_dist * normalize(@v);

vector isect_pos;
float isect_u, isect_v;
//返回第一个交点
int isect_prim = intersect(@OpInput2, origin, dir, isect_pos, isect_u, isect_v);
//返回最远交点
isect_prim = intersect(@OpInput2, origin, dir, isect_pos, isect_u, isect_v, "farthest", 1);

intersects —— 计算射线的所有交点

int intersect_all(geometry, string group, vector orig, vector dir, vector &pos[], int &prim[], vector &uvw[], float tol=0.01, float ttol=0.01)
Args

，当运行在一个节点context（如wrangle SOP）时，此参数可以是一个整数（表示输入端）；也可是一字符串（指定一几何体文件，如a.bgeo）；

group，面组；

orig，射线起点；

dir，射线方向和最大距离；

&pos[]，每一个交点位置；

&prim[]，每一个交点面号；

&uvw[]，每一个在面上的参数化交点坐标；

tol，是3D容差；ttol，是射线容差；当相交与边时可避免额外交点，获取所有不合并的交点，设置ttol=-1；

Return

交点总数，没有相交返回0；