目录
geoself —— 返回当前几何体的handle
addpoint —— 添加点到几何体
addprim —— 添加面到几何体
addvertex —— 添加一顶点到面
minpos —— 查找点离几何体表面最近的位置
nearpoint —— 查找离几何体最近的点
nearpoints —— 查找离几何体所有最近的点
neighbour —— 下一个被连接到给定点的点号
neighbours —— 所有被连接到给定点的点号
neighbourcount —— 被连接到给定点的点总数
intersect —— 计算射线的第一个交点
intersects —— 计算射线的所有交点
npoints —— 返回点总数
nprimitives —— 返回面总数
nvertices —— 返回顶点总数
npointsgroup —— 返回组内的点总数
nprimitivesgroup —— 返回组内的面总数
nverticesgroup —— 返回组内的顶点总数
pointprims —— 返回包含指定点的prim列表
pointvertices —— 返回连接到指定点的顶点列表
primpoints —— 返回指定prim上点的列表
primvertices —— 返回指定prim上的线性顶点列表
pointvertex —— 返回与指定点共享的第一个顶点的线性顶点号
primpoint —— 将prim上的vertex转化为对应的点号
primvertex —— 将prim上的vertex转化为对应的线性顶点
primvertexcount —— 返回prim上的顶点总数
polyneighbours —— 返回边邻居的面号数组
primfind —— 返回可能与boundingbox边界相交的面号列表
removeattrib —— 移除指定属性或组
removepoint —— 移除指定点
removeprim —— 移除指定面
removepvertex —— 移除指定顶点
setprimvertex —— 将顶点重连接到不同的点
setvertexpoint —— 将顶点重连接到不同的点
setedgegroup —— 设置边组成员
expandedgegroup —— 返回边点列表
inedgegroup —— 是否在指定的边组
nedgesgroup —— 返回组内的边数
uvintersect —— 计算在UV空间内射线交点
vertexcurveparam —— 沿着面的周长返回顶点参数坐标
vertexindex —— 将顶点转化未线性顶点
vertexprev —— 返回与给定顶点分享点的上一个顶点的线性顶点号；
vertexnext —— 返回与给定顶点分享点的下一个顶点的线性顶点号；
vertexpoint —— 返回线性顶点的点号；
vertexprim —— 返回包含给定顶点的面号；
vertexprimindex —— 将线性顶点转化为顶点号；
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>geometry, vector point)
//返回点离几何体最近点位置，在指定最大距离内
vector minpos(<geometry>geometry, vector point, float maxdist)
//返回点离几何体最近点位置，在指定面组内
vector minpos(<geometry>geometry, string primgroup, vector point)
//返回点离几何体最近点位置，在指定面组及最大距离内
vector minpos(<geometry>geometry, string primgroup, vector point, float maxdist)
- Args
- <geometry>，当运行在一个节点context（如wrangle SOP）时，此参数可以是一个整数（表示输入端）；也可是一字符串（指定一几何体文件，如a.bgeo）；
- primgroup，面组；可使用类似@Cd.x>0来指定组（可能需要反斜杠转义），空字符串表示所有面；
- point，指定的空间点位置；
- maxdist，查找最大距离；
- Return
- 最近点位置，未查找到最近点返回point；
nearpoint —— 查找离几何体最近的点
int nearpoint(<geometry>geometry, vector pt)
int nearpoint(<geometry>geometry, vector pt, float maxdist)
int nearpoint(<geometry>geometry, string ptgroup, vector pt)
int nearpoint(<geometry>geometry, string ptgroup, vector pt, float maxdist)- 查找几何体上最近的点号，并不是表面的位置；
- 使用xyzdist可查找表面或曲线上最近点；
- Args
- <geometry>，当运行在一个节点context（如wrangle SOP）时，此参数可以是一个整数（表示输入端）；也可是一字符串（指定一几何体文件，如a.bgeo）；
- ptgroup，点组，可使用SOP风格的组样式如0-10或@Cd.x>0.5，空字符串表示所有点；
- pt，指定的空间点位置；
- maxdist，最大查找距离；
- Return
- 最近点号，未查找到返回-1；
nearpoints —— 查找离几何体所有最近的点
int[] nearpoints(<geometry>geometry, vector pt, float maxdist)
int[] nearpoints(<geometry>geometry, vector pt, float maxdist, int maxpts)
int[] nearpoints(<geometry>geometry, string ptgroup, vector pt, float maxdist)
int[] nearpoints(<geometry>geometry, string ptgroup, vector pt, float maxdist, int maxpts)
- Args
- <geometry>，当运行在一个节点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>geometry, int point_num, int neighbour_num)
- Args
- <geometry>，当运行在一个节点context（如wrangle SOP）时，此参数可以是一个整数（表示输入端）；也可是一字符串（指定一几何体文件，如a.bgeo）；
- point_num，指定的点号；
- neighbour_num，将查找的邻居，邻居们没有特定的顺序；
- neighbourcount，获取所有连接邻居的总数；
- Return
- 超出邻居数，点超出范围或不存在，返回-1；
neighbours —— 所有被连接到给定点的点号
int[] neighbours(<geometry>geometry, int ptnum)- <geometry>，当运行在一个节点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>geometry, int point_num)
- Args
- <geometry>，当运行在一个节点context（如wrangle SOP）时，此参数可以是一个整数（表示输入端）；也可是一字符串（指定一几何体文件，如a.bgeo）；
- point_num，指定的点号；
- Return
- 指定点号超出范围或没有输入，返回0；
intersect —— 计算射线的第一个交点
int intersect(<geometry>geometry, vector orig, vector dir, vector &p, float &u, float &v)
int intersect(<geometry>geometry, vector orig, vector dir, vector &p, float &u, float &v, ...)int intersect(<geometry>geometry, vector orig, vector dir, vector &p, vector &uvw)
int intersect(<geometry>geometry, string group, vector orig, vector dir, vector &p, vector &uvw)
- Args
- <geometry>，当运行在一个节点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>geometry, string group, vector orig, vector dir, vector &pos[], int &prim[], vector &uvw[], float tol=0.01, float ttol=0.01)
- Args
- <geometry>，当运行在一个节点context（如wrangle SOP）时，此参数可以是一个整数（表示输入端）；也可是一字符串（指定一几何体文件，如a.bgeo）；
- group，面组；
- orig，射线起点；
- dir，射线方向和最大距离；
- &pos[]，每一个交点位置；
- &prim[]，每一个交点面号；
- &uvw[]，每一个在面上的参数化交点坐标；
- tol，是3D容差；ttol，是射线容差；当相交与边时可避免额外交点，获取所有不合并的交点，设置ttol=-1；
- Return
- 交点总数，没有相交返回0；
注，当与metaball相交时，不能确定面号，将返回面总数；
vector p[], uvw[];
int prim[];
vector origin = chv("origin");
vector dir = normalize(chv("dir"))*ch("length");
int num = intersect_all(@OpInput2, origin, dir, p, prim, uvw);
foreach(vector pos; p){addpoint(0, pos);
}npoints —— 返回点总数
int npoints(<geometry>geometry)nprimitives —— 返回面总数
int nprimitives(<geometry>geometry)nvertices —— 返回顶点总数
int nvertices(<geometry>geometry)npointsgroup —— 返回组内的点总数
int npointsgroup(<geometry>geometry, string groupname)nprimitivesgroup —— 返回组内的面总数
int nprimitivesgroup(<geometry>geometry, string groupname)nverticesgroup —— 返回组内的顶点总数
int nverticesgroup(<geometry>geometry, string groupname)pointprims —— 返回包含指定点的prim列表
int[] pointprims(geometry, int ptnum)- 返回面号数组，升序且不重复；
pointvertices —— 返回连接到指定点的顶点列表
int[] pointvertices(<geometry>geometry, int ptnum)- 返回被连接到给定点的顶点号数组，不依赖数字顺序；
primpoints —— 返回指定prim上点的列表
int[] primpoints(geometry, int primnum)-
返回点数组，和存储在面上的顺序相同；
primvertices —— 返回指定prim上的线性顶点列表
int[] primvertices(<geometry>geometry, int primnum)- 返回线性顶点索引，与存储在面的顺序相同；
pointvertex —— 返回与指定点共享的第一个顶点的线性顶点号
int pointvertex(<geometry>geometry, int point_num)- 与指定点共享的第一个顶点的线性顶点号，可使用vertexnext去迭代其他顶点；
primpoint —— 将prim上的vertex转化为对应的点号
int primpoint(geometry, int primnum, int vertex)
如：i@a = primpoint("op:../sphere1", 0, 2);- vertex为面的顶点，从0开始；
- 返回顶点对应的点号，失败返回-1；
primvertex —— 将prim上的vertex转化为对应的线性顶点
int primvertex(<geometry>geometry, int primnum, int vertex)- vertex为面的顶点，从0开始；
- 返回顶点对应的线性顶点号，失败返回-1；
primvertexcount —— 返回prim上的顶点总数
int primvertexcount(<geometry>geometry, int prim_num)- 返回给定面上的顶点数，如面不存返回-1；
polyneighbours —— 返回边邻居的面号数组
primfind —— 返回可能与boundingbox边界相交的面号列表
removeattrib —— 移除指定属性或组
removepoint —— 移除指定点
removeprim —— 移除指定面
removepvertex —— 移除指定顶点
setprimvertex —— 将顶点重连接到不同的点
setvertexpoint —— 将顶点重连接到不同的点
setedgegroup —— 设置边组成员
expandedgegroup —— 返回边点列表
int[] expandedgegroup(<geometry>geometry, string groupname)
int[] expandedgegroup(<geometry>geometry, string groupname, string mode)
- Args
- 可使用ad-hoc，如0或p0-1，空字符串表示所有边；
- mode
- ordered，默认模式，将按字符串中出现的顺序返回数字，仅限于数字；但使用表达式如@Cd.x>0.5，顺序将不被保持；在返回的数组，相同的数字不会出现两次；
- unordered，按排序的点号返回被解析的组；
- split，先拆开字符串groupname为@字符串，然后解析每个子字符串；相同的数字可以出现多次；
- expandpointgroup
- expandprimgroup
- expandvertexgroup
inedgegroup —— 是否在指定的边组
int inedgegroup(string filename, string groupname, int pointnum0, int pointnum1)
int inedgegroup(int input, string groupname, int pointnum0, int pointnum1)- 在指定的边组，返回1；
- 不在指定的边组，或组不存在，返回0；
nedgesgroup —— 返回组内的边数
int nedgesgroup(string filename, string groupname)
int nedgesgroup(int input, string groupname)- 必须是一个确定的组名，不可是adhoc组；
uvintersect —— 计算在UV空间内射线交点
vertexcurveparam —— 沿着面的周长返回顶点参数坐标
vertexindex —— 将顶点转化未线性顶点
vertexprev —— 返回与给定顶点分享点的上一个顶点的线性顶点号；
vertexnext —— 返回与给定顶点分享点的下一个顶点的线性顶点号；
vertexpoint —— 返回线性顶点的点号；
vertexprim —— 返回包含给定顶点的面号；
vertexprimindex —— 将线性顶点转化为顶点号；
clip —— 切割p0和p1之间的线段
void clip(int &result, vector &p0, vector &p1, vector4 plane)
void clip(int &result, vector &p0, vector &p1, vector min, vector max)geounwrap
string geounwrap(<geometry>geometry, string unwrap_attribute)查看案例：UV Island 각각의 스케일을 줄여주는 방법 (3DS Max의 Uv Relax 대응)
vector t = chv("t");
vector r = chv("r");
vector s = chv("s");
string geo = geounwrap(0, "uv");
int island = prim(0, "island", @primnum);
vector center = getbbox_center(geo, "@island=" + itoa(island));
matrix xform = maketransform(0, 0, t, r, s, center);
v@uv *= xform;
 D 1e5+双重for循环技巧)
