Rhinoscript常用的函数命令.doc

建筑形态设计常用Rhino Script函数Application MethodsCommand运行仅一条内部命令LastCommandResult返回上一命令的执行结果Print / PrintEx向命令行显示一条信息SendKeyStrokes向命令行传送字符可包括回车Ortho / Osnap / Planar / ProjectOsnaps打开或关闭或返回辅助绘图OsnapMode设定或返回对象捕捉类型Exit结束RhinoDocument MethodsCreatePreviewImage抓屏EnableRedraw / Redraw使能/触发屏幕重画Selection MethodsFirstObject / NextObject / LastObject内存最新/下一个/最老对象GetPointCoordinates / GetCurveObject / GetSurfaceObject/ GetObject / GetObjects互动选取点、线、面、对象LastCreatedObjects选取最新一群创建的对象ObjectsByGroup / ObjectsByLayer / ObjectsByType / ObjectsByName符合条件选对象群Object Methods属性查询类IsObjectSolidObjectDescriptionObjectType属性查询设置类ObjectColorObjectLayerObjectName / ObjectNames几何变换类CopyObject / CopyObjectsDeleteObject / DeleteObjectsMirrorObject / MirrorObjectsMoveObject / MoveObjectsOrientObject / OrientObjectsRotateObject / RotateObjectsScaleObject / ScaleObjectsShearObject / ShearObjectsCurve Methods创建类AddCurve建控制点曲线AddInterpCurve / AddInterpCurveEx建穿越点曲线AddInterpCrvOnSrf在给定曲面上建曲线AddInterpCrvOnSrfUV在给定曲面上用曲面座标建线AddNurbsCurve根据point,knot,degree建曲线AddSubCrv用参数从头至尾取曲线一段AddLine建直线AddPolyline建折线MeshPolyline以折线建mesh编辑类ConvertCurveToPolyline转曲线为折线CurveBrepIntersect？有问题（无法选取曲线）CloseCurve闭合曲线CurveSeam改变闭合点DivideCurve / DivideCurveLength分段ExplodeCurves炸开ExtendCurve / ExtendCurveLength / ExtendCurvePoint 延长非闭合线FairCurve减小曲线的曲率变化InsertCurveKnot加入节点JoinCurves连接曲线MakeCurvePeriodic使拼接曲线连贯封闭OffsetCurve间距ReverseCurve反转曲线方向SimplifyCurve简化曲线SplitCurve某点断开TrimCurve裁剪属性查询类ArcAngle返回角度ArcCenterPoint / CircleCenterPoint返回中心ArcMidPoint / CurveMidPoint返回中点ArcRadius / CircleRadius / CurveRadius返回半径CircleCircumference返回周长CurveArea返回面积CurveArcLengthPoint返回曲线定长处点CurveAreaCentroid返回质心CurveClosestPoint返回曲线上某点的曲线坐标CurveCurvature返回曲率CurveDegree返回度数CurveDim？永远返回3CurveDiscontinuity返回曲线不连续点CurveDomain？定义不明CurveEditPoints返回曲线穿越的编辑点CurveEndPoint / CurveStartPoint返回曲线始末点CurveEvaluate？不懂EvaluateCurve用曲线参数确定点坐标CurveFrame 返回某点切向/曲向平面文档案例第9行错误CurvePerpFrame返回某点切向为Z轴平面文档案例第9行错误CurveKnotCount / CurvePointCount返回节点数CurveKnots / CurvePoints返回节点坐标CurveWeights返回权重CurveLength返回长度CurveNormal返回曲面法线CurvePlane返回平面曲线的所在平面CurveTangent返回某点切向IsArc / IsCircle / IsCurve返回类型IsCurveClosable返回是否可用6点闭合IsCurveClosed返回是否闭合IsCurveInPlane返回是否曲线在一特定平面上IsCurvePlanar返回是否曲线全在平面IsCurveLinear 返回是否曲线为一直线IsCurvePeriodic返回是否曲线无头无尾IsCurveRational返回是否由弧线组成IsLine / IsPolyCurve / IsPolyline返回曲线类型PolyCurveCount返回多段曲线的段数PolylineVertices返回折线顶点关系查询类CurveCurveIntersection两曲线相交重合情况CurveDeviation两曲线间的最大最小距离CurveDirectionsMatch两曲线方是否同向（算法不明）CurveSurfaceIntersection曲线与曲面相交重合情况IsPointOnCurve点是否在曲线PlanarClosedCurveContainment两平面闭合曲线的关系无法判断有一个交点的内包含，其会被认为是相交PlanarCurveCollision两共面曲线是否相交PointInPlanarClosedCurve点与平面闭合曲线的关系Surface Methods创建图元AddBox / AddCone / AddCylinder 拼接polysurfaceAddSphere / AddTorus / 连续surface创建surfaceAddSrfPt / AddPlaneSurface / AddEdgeSrf/ AddLoftSrf / AddRailRevSrf / AddRevSrf / ExtrudeCurve / ExtrudeCurvePoint / ExtrudeCurveStraight / ExtrudeSurface常见建面方式AddNurbsSurface建NURBS曲面AddPlanarSrf用共面曲线建平面AddSrfControlPtGrid用控制点建曲面AddSrfPtGrid用过点建面编辑类BooleanDifference / BooleanIntersection / BooleanUnion布尔运算CapPlanarHoles补孔ExplodePolysurfaces打碎面JoinSurfaces连接面FlipSurface反转法向InsertSurfaceKnot给面加节点MakeSurfacePeriodic消除闭合曲面始末交接的节OffsetSurface位移复制ShrinkTrimmedSurface把经切割的原面缩至切割边界SplitBrep分割曲面属性查询类IsBrepBoundary Representation ObjectIsPlaneSurface / IsSurfacePlanar？是否为一平面没区别？IsPolysurface是否由两个以上surface组成IsPolysurfaceClosed是否是solidIsPolysurfacePlanar是否共面IsSurface是否为面IsSurfaceClosed是否面闭合（UV两向）IsSurfacePeriodic是否面闭合且连续（UV两向）IsSurfaceRational是否为弧线或椭圆线面IsSurfaceSingular是否某一方向收于一点IsSurfaceTrimmed是否曾被裁剪SurfaceArea返回面积SurfaceAreaCentroid返回质心SurfaceAreaMoments返回面积贯性弯矩SurfaceVolume返回solid体积SurfaceVolumeCentroid返回solid质心SurfaceVolumeMoments返回体惯性矩SurfaceCurvature返回某点曲率SurfaceCurvatureAnalysis返回四种曲率分析结果SurfaceDegree返回某点度数SurfaceDomain？不懂SurfaceEditPoints返回编辑点其与控制点对应SurfaceKnotCount/ SurfaceKnots返回节点数/节点SurfacePointCount/ SurfacePoints / SurfaceWeights返回控制点数/控制点/权重SurfaceIsocurveDensity？不懂SurfaceNormal返回某点法线PullCurve已知一曲线在面上法线投影SurfacePrincipalCurvature面上一点的最大最小曲率弧几何查询类BrepClosestPoint / SurfaceClosestPoint返回曲面上距给定点最近点DuplicateEdgeCurves返回曲面的边界曲线EvaluateSurface用UV参数确定表面坐标SurfaceEvaluate？不懂ExtractIsoCurve返回曲面上一点的UV轴线？IntersectBreps / SurfaceSurfaceIntersection返回两曲面交线IsPointInSurface判断一点是否在曲面体内IsPointOnSurface判断一点是否在曲面上ShortPath返回曲面上两点间的最短路径SurfaceContourPoints返回等高线顶点SurfaceFrame返回曲面上选定点的切向平面Geometry Methods创建类AddPoint/ AddPoints加点或点群AddPointCloud加点云（为一个对象）AddText加文字VectorCreate建一矢量PlaneFitFromPoints用一群点拟合建CplanePlaneFromFrame用两个矢量一个原点建CplanePlaneFromNormal用法线矢量建CplanePlaneFromPoints用三点建CplaneWorldXYPlane / WorldYZPlane / WorldZXPlane建顶、侧、前Cplane编辑类MovePlane移动CplaneRotatePlane旋转CplanePointAdd / PointSubtract点加、减矢量成新点PointDivide / PointScale点坐标缩放矢量运算VectorAdd / VectorSubtract矢量加减VectorCrossProduct返回与两个矢量平面垂直矢量VectorDotProduct返回|a|*|b|*cos夹角VectorMultiply / VectorDivide矢量乘除VectorScale矢量缩放VectorReverse矢量反向VectorRotate矢量旋转VectorUnitize矢量单元化为长度1常数与转换函数PI圆周率ToDegrees / ToRadians弧度转角度Polar以极坐标求笛卡儿坐标XformCPlaneToWorld / XformWorldToCPlane 点坐标在不同坐标系间转换属性查询类BoundingBox返回对象的三轴范围IsVectorTiny返回是否矢量太小于1e-12IsVectorZero返回是否矢量为零PlaneEquation返回Cplane方程四系数PointCloudCount / PointCloudPoints返回点云内点数、各点坐标VectorLength返回矢量长度属性查询设置类PointCoordinates查询、设置某点坐标TextObjectHeight / TextObjectPlane / TextObjectPoint / TextObjectText查询、设置某文字属性关系查询类Angle / Angle2返回两点、线夹角Distance / DistanceToPlane返回两点、点到平面距离IsVectorParallelTo返回两个矢量是否平行IsVectorPerpendicularTo返回两个矢量是否垂直PlaneClosestPoint返回点在Cplane上的投影点PointsAreCoplanar返回群点是否共平面PointCompare返回两点重合关系VectorCompare返回两矢量重合关系PullPoints返回沿法线方向拉至面上的点Mesh MethodsMeshFaces逐面返回各点坐标MeshVertices返回各顶点坐标MeshFaceVertices返回各面其顶点的编号MeshTriangleCount / MeshQuadCount返回面数Layer Methods创建类AddLayer添加层编辑类PurgeLayer除去非当前层及其对象RenameLayer更名查询类IsLayer返回某层是否存在LayerCount返回文件中的层数LayerNames返回文件中所有层名查询设置类CurrentLayer查询或设置当前层LayerColor查询或设置层色LayerVisible查询或设置层可见性View MethodsViewCPlane查询并设置CplaneZoomBoundingBox / ZoomExtents / ZoomSelected缩放视图Group Methods创建类AddGroup / DeleteGroup / RenameGroup创建、消除、更名组AddObjectsToGroup / AddObjectToGroup添加组成员RemoveObjectFromAllGroups / RemoveObjectFromGroup / RemoveObjectsFromGroup减少组成员查询类GroupCount返回文件中组数GroupNames返回文件中组名IsGroup返回某组名是否存在IsGroupEmpty返回某组是否为空User Interface Methods通用类BrowseForFolder / OpenFileName / SaveFileName返回一个文件定位CheckListBox/ ComboListBox / ListBox / MultiListBox返回列表选择结果PropertyListBox返回对于列表的编辑EditBox返回多行文本GetBoolean返回布尔量GetColor返回颜色GetInteger / IntegerBox返回整数GetReal / RealBox返回实数GetString / StringBox返回一字符串MessageBeep返回一声响MessageBox返回对于对话框的反应PopupMenu返回对于弹出菜单的反应Rhino类GetLayer返回选择的层名GetLinetype返回选择的线型几何类GetAngle返回一个夹角GetBox返回一个立方体积GetDistance返回距离GetPoint