RhinoScriptSyntax Type
A static class with static methods providing functions identical to RhinoScript in Python or VBscript
Static members
| Static member |
Description
|
Full Usage:
RhinoScriptSyntax.Add(geo, ?layer, ?objectName, ?userTextKeysAndValues, ?layerColor, ?stringSafetyCheck, ?collapseParents)
Parameters:
Cone
-
(Cone) The cone.
?layer : string
-
(string) Optional, default value: "". The layer name; parent layers separated by '::'. The current layer if empty.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?layerColor : Color
-
(Drawing.Color) Optional, default value: UtilLayer.randomLayerColor(). The color for the layer. The layer color will NOT be changed if the layer already exists.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds a Cone to the Rhino document as a NURBS surface.
|
Full Usage:
RhinoScriptSyntax.Add(geo, layerIndex, ?objectName, ?userTextKeysAndValues, ?stringSafetyCheck, ?collapseParents)
Parameters:
Cone
-
(Cone) The cone.
layerIndex : int
-
(int) The layer index.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds a Cone to the Rhino document as a NURBS surface.
|
Full Usage:
RhinoScriptSyntax.Add(geo, ?layer, ?objectName, ?userTextKeysAndValues, ?layerColor, ?stringSafetyCheck, ?collapseParents)
Parameters:
Cylinder
-
(Cylinder) The cylinder.
?layer : string
-
(string) Optional, default value: "". The layer name; parent layers separated by '::'. The current layer if empty.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?layerColor : Color
-
(Drawing.Color) Optional, default value: UtilLayer.randomLayerColor(). The color for the layer. The layer color will NOT be changed if the layer already exists.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds a Cylinder to the Rhino document as a NURBS surface.
|
Full Usage:
RhinoScriptSyntax.Add(geo, layerIndex, ?objectName, ?userTextKeysAndValues, ?stringSafetyCheck, ?collapseParents)
Parameters:
Cylinder
-
(Cylinder) The cylinder.
layerIndex : int
-
(int) The layer index.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds a Cylinder to the Rhino document as a NURBS surface.
|
Full Usage:
RhinoScriptSyntax.Add(geo, ?layer, ?objectName, ?userTextKeysAndValues, ?layerColor, ?stringSafetyCheck, ?collapseParents)
Parameters:
Sphere
-
(Sphere) The sphere.
?layer : string
-
(string) Optional, default value: "". The layer name; parent layers separated by '::'. The current layer if empty.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?layerColor : Color
-
(Drawing.Color) Optional, default value: UtilLayer.randomLayerColor(). The color for the layer. The layer color will NOT be changed if the layer already exists.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds a Sphere to the Rhino document.
|
Full Usage:
RhinoScriptSyntax.Add(geo, layerIndex, ?objectName, ?userTextKeysAndValues, ?stringSafetyCheck, ?collapseParents)
Parameters:
Sphere
-
(Sphere) The sphere.
layerIndex : int
-
(int) The layer index.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds a Sphere to the Rhino document.
|
Full Usage:
RhinoScriptSyntax.Add(geo, ?layer, ?objectName, ?userTextKeysAndValues, ?layerColor, ?stringSafetyCheck, ?collapseParents)
Parameters:
BoundingBox
-
(BoundingBox) The bounding box.
?layer : string
-
(string) Optional, default value: "". The layer name; parent layers separated by '::'. The current layer if empty.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?layerColor : Color
-
(Drawing.Color) Optional, default value: UtilLayer.randomLayerColor(). The color for the layer. The layer color will NOT be changed if the layer already exists.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds a BoundingBox to the Rhino document as a box.
|
Full Usage:
RhinoScriptSyntax.Add(geo, layerIndex, ?objectName, ?userTextKeysAndValues, ?stringSafetyCheck, ?collapseParents)
Parameters:
BoundingBox
-
(BoundingBox) The bounding box.
layerIndex : int
-
(int) The layer index.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds a BoundingBox to the Rhino document as a box.
|
Full Usage:
RhinoScriptSyntax.Add(geo, ?layer, ?objectName, ?userTextKeysAndValues, ?layerColor, ?stringSafetyCheck, ?collapseParents)
Parameters:
Box
-
(Box) The box.
?layer : string
-
(string) Optional, default value: "". The layer name; parent layers separated by '::'. The current layer if empty.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?layerColor : Color
-
(Drawing.Color) Optional, default value: UtilLayer.randomLayerColor(). The color for the layer. The layer color will NOT be changed if the layer already exists.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds a Box to the Rhino document.
|
Full Usage:
RhinoScriptSyntax.Add(geo, layerIndex, ?objectName, ?userTextKeysAndValues, ?stringSafetyCheck, ?collapseParents)
Parameters:
Box
-
(Box) The box.
layerIndex : int
-
(int) The layer index.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds a Box to the Rhino document.
|
Full Usage:
RhinoScriptSyntax.Add(geo, ?layer, ?objectName, ?userTextKeysAndValues, ?layerColor, ?stringSafetyCheck, ?collapseParents)
Parameters:
Polyline
-
(Polyline) The polyline.
?layer : string
-
(string) Optional, default value: "". The layer name; parent layers separated by '::'. The current layer if empty.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?layerColor : Color
-
(Drawing.Color) Optional, default value: UtilLayer.randomLayerColor(). The color for the layer. The layer color will NOT be changed if the layer already exists.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds a Polyline to the Rhino document as a polyline curve.
|
Full Usage:
RhinoScriptSyntax.Add(geo, layerIndex, ?objectName, ?userTextKeysAndValues, ?stringSafetyCheck, ?collapseParents)
Parameters:
Polyline
-
(Polyline) The polyline.
layerIndex : int
-
(int) The layer index.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds a Polyline to the Rhino document as a polyline curve.
|
Full Usage:
RhinoScriptSyntax.Add(geo, ?layer, ?objectName, ?userTextKeysAndValues, ?layerColor, ?stringSafetyCheck, ?collapseParents)
Parameters:
Ellipse
-
(Ellipse) The ellipse.
?layer : string
-
(string) Optional, default value: "". The layer name; parent layers separated by '::'. The current layer if empty.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?layerColor : Color
-
(Drawing.Color) Optional, default value: UtilLayer.randomLayerColor(). The color for the layer. The layer color will NOT be changed if the layer already exists.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds an Ellipse to the Rhino document as a curve.
|
Full Usage:
RhinoScriptSyntax.Add(geo, layerIndex, ?objectName, ?userTextKeysAndValues, ?stringSafetyCheck, ?collapseParents)
Parameters:
Ellipse
-
(Ellipse) The ellipse.
layerIndex : int
-
(int) The layer index.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds an Ellipse to the Rhino document as a curve.
|
Full Usage:
RhinoScriptSyntax.Add(geo, ?layer, ?objectName, ?userTextKeysAndValues, ?layerColor, ?stringSafetyCheck, ?collapseParents)
Parameters:
Circle
-
(Circle) The circle.
?layer : string
-
(string) Optional, default value: "". The layer name; parent layers separated by '::'. The current layer if empty.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?layerColor : Color
-
(Drawing.Color) Optional, default value: UtilLayer.randomLayerColor(). The color for the layer. The layer color will NOT be changed if the layer already exists.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds a Circle to the Rhino document as a curve.
|
Full Usage:
RhinoScriptSyntax.Add(geo, layerIndex, ?objectName, ?userTextKeysAndValues, ?stringSafetyCheck, ?collapseParents)
Parameters:
Circle
-
(Circle) The circle.
layerIndex : int
-
(int) The layer index.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds a Circle to the Rhino document as a curve.
|
Full Usage:
RhinoScriptSyntax.Add(geo, ?layer, ?objectName, ?userTextKeysAndValues, ?layerColor, ?stringSafetyCheck, ?collapseParents)
Parameters:
Arc
-
(Arc) The arc.
?layer : string
-
(string) Optional, default value: "". The layer name; parent layers separated by '::'. The current layer if empty.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?layerColor : Color
-
(Drawing.Color) Optional, default value: UtilLayer.randomLayerColor(). The color for the layer. The layer color will NOT be changed if the layer already exists.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds an Arc to the Rhino document as an arc curve.
|
Full Usage:
RhinoScriptSyntax.Add(geo, layerIndex, ?objectName, ?userTextKeysAndValues, ?stringSafetyCheck, ?collapseParents)
Parameters:
Arc
-
(Arc) The arc.
layerIndex : int
-
(int) The layer index.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds an Arc to the Rhino document as an arc curve.
|
Full Usage:
RhinoScriptSyntax.Add(geo, ?layer, ?objectName, ?userTextKeysAndValues, ?layerColor, ?stringSafetyCheck, ?collapseParents)
Parameters:
Line
-
(Line) The line.
?layer : string
-
(string) Optional, default value: "". The layer name; parent layers separated by '::'. The current layer if empty.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?layerColor : Color
-
(Drawing.Color) Optional, default value: UtilLayer.randomLayerColor(). The color for the layer. The layer color will NOT be changed if the layer already exists.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds a Line to the Rhino document as a line curve.
|
Full Usage:
RhinoScriptSyntax.Add(geo, layerIndex, ?objectName, ?userTextKeysAndValues, ?stringSafetyCheck, ?collapseParents)
Parameters:
Line
-
(Line) The line.
layerIndex : int
-
(int) The layer index.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds a Line to the Rhino document as a line curve.
|
Full Usage:
RhinoScriptSyntax.Add(geo, ?layer, ?objectName, ?userTextKeysAndValues, ?layerColor, ?stringSafetyCheck, ?collapseParents)
Parameters:
Point3f
-
(Point3f) The point.
?layer : string
-
(string) Optional, default value: "". The layer name; parent layers separated by '::'. The current layer if empty.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?layerColor : Color
-
(Drawing.Color) Optional, default value: UtilLayer.randomLayerColor(). The color for the layer. The layer color will NOT be changed if the layer already exists.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds a Point3f to the Rhino document as a point object.
|
Full Usage:
RhinoScriptSyntax.Add(geo, layerIndex, ?objectName, ?userTextKeysAndValues, ?stringSafetyCheck, ?collapseParents)
Parameters:
Point3f
-
(Point3f) The point.
layerIndex : int
-
(int) The layer index.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds a Point3f to the Rhino document as a point object.
|
Full Usage:
RhinoScriptSyntax.Add(geo, ?layer, ?objectName, ?userTextKeysAndValues, ?layerColor, ?stringSafetyCheck, ?collapseParents)
Parameters:
Point3d
-
(Point3d) The point.
?layer : string
-
(string) Optional, default value: "". The layer name; parent layers separated by '::'. The current layer if empty.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?layerColor : Color
-
(Drawing.Color) Optional, default value: UtilLayer.randomLayerColor(). The color for the layer. The layer color will NOT be changed if the layer already exists.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds a Point3d to the Rhino document as a point object.
|
Full Usage:
RhinoScriptSyntax.Add(geo, layerIndex, ?objectName, ?userTextKeysAndValues, ?stringSafetyCheck, ?collapseParents)
Parameters:
Point3d
-
(Point3d) The point.
layerIndex : int
-
(int) The layer index.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds a Point3d to the Rhino document as a point object.
|
Full Usage:
RhinoScriptSyntax.Add(geo, ?layer, ?objectName, ?userTextKeysAndValues, ?layerColor, ?stringSafetyCheck, ?collapseParents)
Parameters:
GeometryBase
-
(GeometryBase) The geometry object.
?layer : string
-
(string) Optional, default value: "". The layer name; parent layers separated by '::'. The current layer if empty.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?layerColor : Color
-
(Drawing.Color) Optional, default value: UtilLayer.randomLayerColor(). The color for the layer. The layer color will NOT be changed if the layer already exists.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds any geometry object that is a subclass of GeometryBase to the Rhino document, such as a Curve, Brep, Mesh or Point.
|
Full Usage:
RhinoScriptSyntax.Add(geo, layerIndex, ?objectName, ?userTextKeysAndValues, ?stringSafetyCheck, ?collapseParents)
Parameters:
GeometryBase
-
(GeometryBase) The geometry object.
layerIndex : int
-
(int) The layer index.
?objectName : string
-
(string) Optional, default value: "". The object name.
?userTextKeysAndValues : string * string
-
(string*string seq) Optional, default value: []. List of key-value pairs for user text.
?stringSafetyCheck : bool
-
(bool) Optional, default value: true. Checks that object name and user text do not include line returns, tabs, or leading/trailing whitespace.
?collapseParents : bool
-
(bool) Optional, default value: false. Collapse parent layers in the Layer UI.
Returns: Guid
(Guid) The Guid of the added object.
|
Adds any geometry object that is a subclass of GeometryBase to the Rhino document, such as a Curve, Brep, Mesh or Point.
|
Full Usage:
RhinoScriptSyntax.AddAlias(alias, macro)
Parameters:
string
-
(string) Name of new command alias. Cannot match command names or existing
aliases
macro : string
-
(string) The macro to run when the alias is executed
Returns: bool
(bool) True or False indicating success or failure.
|
Add new command alias to Rhino. Command aliases can be added manually by using Rhino's Options command and modifying the contents of the Aliases tab.
|
Full Usage:
RhinoScriptSyntax.AddAlignedDimension(startPoint, endPoint, pointOnDimensionLine, ?style)
Parameters:
Point3d
-
(Point3d) First point of the dimension.
endPoint : Point3d
-
(Point3d) Second point of the dimension.
pointOnDimensionLine : Point3d
-
(Point3d) Location point of the dimension line.
?style : string
-
(string) Optional, default value: "". Name of the dimension style.
Returns: Guid
(Guid) Identifier of the new dimension.
|
Adds an aligned dimension object to the document. An aligned dimension is a linear dimension lined up with two points.
|
Full Usage:
RhinoScriptSyntax.AddArc(plane, radius, angleDegrees)
Parameters:
Plane
-
(Plane) Plane on which the arc will lie. The origin of the plane will be the center point of the arc. The x-axis of the plane defines the 0 angle direction.
radius : float
-
(float) Radius of the arc.
angleDegrees : float
-
(float) Interval of arc in degrees.
Returns: Guid
(Guid) ObjectId of the new curve object.
|
Adds an arc curve to the document.
|
|
|
Full Usage:
RhinoScriptSyntax.AddArcPtTanPt(start, direction, ende)
Parameters:
Point3d
-
(Point3d) The starting point of the arc.
direction : Vector3d
-
(Vector3d) The arc direction at start.
ende : Point3d
-
(Point3d) The ending point of the arc.
Returns: Guid
(Guid) ObjectId of the new curve object.
|
Adds an arc curve, created from a start point, a start direction, and an end point, to the document.
|
Full Usage:
RhinoScriptSyntax.AddBlendCurve(curves, parameters, reverses, continuities)
Parameters:
Guid * Guid
-
(Guid * Guid) Tuple of two curves.
parameters : float * float
-
(float * float) Tuple of two curve parameters defining the blend end points.
reverses : bool * bool
-
(bool * bool) Tuple of two boolean values specifying to use the natural or opposite direction of the curve.
continuities : int * int
-
(int * int) Tuple of two numbers specifying continuity at end points:
0 = position
1 = tangency
2 = curvature
Returns: Guid
(Guid) Identifier of new curve.
|
Makes a curve blend between two curves.
|
Full Usage:
RhinoScriptSyntax.AddBlock(objectIds, basePoint, ?name, ?deleteInput)
Parameters:
Guid seq
-
(Guid seq) Objects that will be included in the block
basePoint : Point3d
-
(Point3d) 3D base point for the block definition
?name : string
-
(string) Optional, default value: InstanceDefinitions.GetUnusedInstanceDefinitionName()
Name of the block definition. If omitted a name will be automatically generated
?deleteInput : bool
-
(bool) Optional, default value: false
If True, the objectIds will be deleted
Returns: string
(string) name of new block definition.
|
Adds a new block definition to the document.
|
|
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.AddClippingPlane(plane, uMagnitude, vMagnitude, ?views)
Parameters:
Plane
-
(Plane) The Plane
uMagnitude : float
-
(float) U magnitude of the Plane
vMagnitude : float
-
(float) V magnitude of the Plane
?views : string
-
(string seq) Optional, Titles the view(s) to clip. If omitted, the active
view is used
Returns: Guid
(Guid) object identifier.
|
Create a clipping Plane for visibly clipping away geometry in a specific view. Clipping Planes are infinite.
|
Full Usage:
RhinoScriptSyntax.AddCone(baseCenter, tip, radius, ?cap)
Parameters:
Point3d
-
(Point3d) The point in the center of the base.
tip : Point3d
-
(Point3d) The tip of cone.
radius : float
-
(float) The radius at the basis of the cone.
?cap : bool
-
(bool) Optional, default value: true. Add capping surface at basis of the cone?
Returns: Guid
(Guid) identifier of the new object.
|
Adds a cone shaped Polysurface to the document. The cone will have it's base center at the first point and the tip at the second point
|
Full Usage:
RhinoScriptSyntax.AddCone(basis, height, radius, ?cap)
Parameters:
Plane
-
(Plane) The plane at the tip of the cone. From this tip the cone wil expand along the Z axis.
height : float
-
(float) The height of cone.
radius : float
-
(float) The radius at the basis of the cone.
?cap : bool
-
(bool) Optional, default value: true. Add capping surface at basis of the cone?
Returns: Guid
(Guid) identifier of the new object.
|
Adds a cone shaped Polysurface to the document. The cone will have it's tip at the origin of the given plane. And grow along its Z axis. So it will be an upside down cone on world XY plane
|
|
|
Full Usage:
RhinoScriptSyntax.AddCutPlane(objectIds, startPoint, endPoint, ?normal)
Parameters:
Guid seq
-
(Guid seq) Identifiers of objects that the cutting Plane will
pass through
startPoint : Point3d
-
(Point3d) Start point of line that defines the cutting Plane
endPoint : Point3d
-
(Point3d) End point of line that defines the cutting Plane
?normal : Vector3d
-
(Vector3d) Optional, default value: world Z axis
Vector that will be contained in the returned planar Surface.
If omitted, the world Z axis is used (NOT the normal to, or Z axis of, the active view's construction plane as in rhinopython).
Returns: Guid
(Guid) identifier of new object.
|
Adds a planar Surface through objects at a designated location. For more information, see the Rhino help file for the CutPlane command.
|
Full Usage:
RhinoScriptSyntax.AddCylinder(basis, height, radius, ?cap)
Parameters:
Plane
-
(Plane) The cylinder base plane; its origin is the base center and its normal is the axis.
height : float
-
(float) Numeric height along the base plane normal.
For two endpoints, construct the base plane with their direction and use their distance as height.
radius : float
-
(float) Radius of the cylinder
?cap : bool
-
(bool) Optional, default value: true
Cap the cylinder
Returns: Guid
(Guid) identifier of new object.
|
Adds a cylinder-shaped Polysurface to the document.
|
Full Usage:
RhinoScriptSyntax.AddDetail(layoutName, corner1, corner2, ?title, ?projection)
Parameters:
string
-
(string) Name of an existing layout
corner1 : Point2d
-
(Point2d) Corner1 of the detail in the layout's unit system
corner2 : Point2d
-
(Point2d) Corner2 of the detail in the layout's unit system
?title : string
-
(string) Optional, Title of the new detail
?projection : int
-
(int) Optional, default value: 1
Type of initial view projection for the detail
1 = parallel top view
2 = parallel bottom view
3 = parallel left view
4 = parallel right view
5 = parallel front view
6 = parallel back view
7 = perspective view
Returns: Guid
(Guid) Identifier of the newly created detail.
|
Add new detail view to an existing layout view.
|
Full Usage:
RhinoScriptSyntax.AddDimStyle(?dimStyleName)
Parameters:
string
-
(string) Optional, default value: null. Name of the new dimension style; omit to generate a name automatically.
Returns: string
(string) The name assigned to the new dimension style.
|
Adds a new dimension style to the document. The new dimension style will be initialized with the current default dimension style properties.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.AddEllipse(plane, radiusX, radiusY)
Parameters:
Plane
-
(Plane) The plane on which the ellipse will lie. The origin of the plane will be the center of the ellipse.
radiusX : float
-
(float) Radius in the X axis direction.
radiusY : float
-
(float) Radius in the Y axis direction.
Returns: Guid
(Guid) ObjectId of the new curve object.
|
Adds an elliptical curve to the document.
|
|
|
Full Usage:
RhinoScriptSyntax.AddFilletCurve(curveA, curveB, ?radius, ?basePointA, ?basePointB)
Parameters:
Guid
-
(Guid) Identifier of the first curve object.
curveB : Guid
-
(Guid) Identifier of the second curve object.
?radius : float
-
(float) Optional, default value: 1.0. Fillet radius.
?basePointA : Point3d
-
(Point3d) Optional. Base point of the first curve. If omitted, starting point of the curve is used.
?basePointB : Point3d
-
(Point3d) Optional. Base point of the second curve. If omitted, starting point of the curve is used.
Returns: Guid
(Guid) ObjectId of the new curve object.
|
Adds a fillet curve between two curve objects.
|
Full Usage:
RhinoScriptSyntax.AddGroup(?groupName)
Parameters:
string
-
(string) Optional. Name of the new group. If omitted, Rhino automatically generates the group name.
Returns: string
(string) Name of the new group.
|
Adds a new empty group to the document.
|
Full Usage:
RhinoScriptSyntax.AddHatch(curveId, ?hatchPattern, ?scale, ?rotationDegrees, ?tolerance)
Parameters:
Guid
-
(Guid) Identifier of the closed planar Curve that defines the boundary of the Hatch object
?hatchPattern : string
-
(string) Optional. Name of the Hatch pattern to be used by the Hatch object. If omitted, the current Hatch pattern will be used.
?scale : float
-
(float) Optional, default value: 1.0. Hatch pattern scale factor.
?rotationDegrees : float
-
(float) Optional, default value: 0.0. Hatch pattern rotation angle in degrees.
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance. Tolerance for Hatch fills.
Returns: Guid
(Guid) Identifier of the newly created Hatch.
|
Creates a new Hatch object from a closed planar Curve object.
|
Full Usage:
RhinoScriptSyntax.AddHatchPatterns(filename, ?replace)
Parameters:
string
-
(string) Name of the Hatch pattern file
?replace : bool
-
(bool) Optional, default value: false
If Hatch pattern names already in the document match Hatch
pattern names in the pattern definition file, then the existing Hatch
patterns will be redefined
Returns: ResizeArray<string>
(string ResizeArray) Names of the newly added Hatch patterns.
|
Adds Hatch patterns to the document by importing Hatch pattern definitions from a pattern file. Replacing an existing pattern requires Rhino 8; Rhino 7 raises before replacing it.
|
Full Usage:
RhinoScriptSyntax.AddHatches(curveIds, ?hatchPattern, ?scale, ?rotationDegrees, ?tolerance)
Parameters:
Guid seq
-
(Guid seq) Identifiers of the closed planar Curves that define the boundary of the Hatch objects
?hatchPattern : string
-
(string) Optional. Name of the Hatch pattern to be used by the Hatch object. If omitted, the current Hatch pattern will be used.
?scale : float
-
(float) Optional, default value: 1.0. Hatch pattern scale factor.
?rotationDegrees : float
-
(float) Optional, default value: 0.0. Hatch pattern rotation angle in degrees.
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance. Tolerance for Hatch fills.
Returns: ResizeArray<Guid>
(Guid ResizeArray) Identifiers of the newly created Hatches.
|
Creates one or more new Hatch objects from a list of closed planar Curves.
|
Full Usage:
RhinoScriptSyntax.AddInterpCrvOnSrf(surfaceId, points)
Parameters:
Guid
-
(Guid) Identifier of the surface to create the curve on.
points : Point3d seq
-
(Point3d seq) List of 3D points that lie on the specified surface. The list must contain at least 2 points.
Returns: Guid
(Guid) ObjectId of the new curve object.
|
Adds an interpolated curve object that lies on a specified surface. Note, this function will not create periodic curves, but it will create closed curves.
|
Full Usage:
RhinoScriptSyntax.AddInterpCrvOnSrfUV(surfaceId, points)
Parameters:
Guid
-
(Guid) Identifier of the surface to create the curve on.
points : Point2d seq
-
(Point2d seq) A list of 2D surface parameters. The list must contain at least 2 sets of parameters.
Returns: Guid
(Guid) ObjectId of the new curve object.
|
Adds an interpolated curve object based on surface parameters, that lies on a specified surface. Note, this function will not create periodic curves, but it will create closed curves.
|
Full Usage:
RhinoScriptSyntax.AddInterpCurve(points, ?degree, ?knotStyle, ?startTangent, ?endTangent)
Parameters:
Point3d seq
-
(Point3d seq) A list containing 3D points to interpolate. For periodic Curves,
if the final point is a duplicate of the initial point, it is
ignored. The number of control points must be bigger than 'degree' number
?degree : int
-
(int) Optional, default value: 3
Periodic Curves must have a degree bigger than 1.
For knot-style = 1 or 2, the degree must be 3.
For knot-style = 4 or 5, the degree must be odd
?knotStyle : int
-
(int) Optional, default value: 0
0 Uniform knots. Parameter spacing between consecutive knots is 1.0.
1 Chord length spacing. Requires degree = 3 with arrCV1 and arrCVn1 specified.
2 Sqrt (chord length). Requires degree = 3 with arrCV1 and arrCVn1 specified.
3 Periodic with uniform spacing.
4 Periodic with chord length spacing. Requires an odd degree value.
5 Periodic with sqrt (chord length) spacing. Requires an odd degree value
?startTangent : Vector3d
-
(Vector3d) Optional, A vector that specifies a tangency condition at the
beginning of the Curve. If the Curve is periodic, this argument must be omitted
?endTangent : Vector3d
-
(Vector3d) Optional, 3d vector that specifies a tangency condition at the
end of the Curve. If the Curve is periodic, this argument must be omitted
Returns: Guid
(Guid) objectId of the new Curve object.
|
Adds an interpolated Curve object to the document. Options exist to make a periodic Curve or to specify the tangent at the endpoints. The resulting Curve is a non-rational NURBS Curve of the specified degree.
|
Full Usage:
RhinoScriptSyntax.AddLayer(?name, ?color, ?visible, ?locked, ?parent, ?allowAllUnicode, ?collapseParents)
Parameters:
string
-
(string) Optional. The name of the new layer. If omitted, Rhino automatically generates the layer name.
?color : Color
-
(Drawing.Color) Optional. A Red-Green-Blue color value. If omitted, a random (non-yellow) color will be chosen.
?visible : int
-
(int) Optional, default value: 2
Layer visibility:
0 = explicitly Off (even if parent is already Off)
1 = On and turn parents on too
2 = inherited from parent, or On by default
?locked : int
-
(int) Optional, default value: 2
Layer locking state:
0 = Unlocked this and parents
1 = explicitly Locked (even if parent is already Locked)
2 = inherited from parent, or Unlocked by default
?parent : string
-
(string) Optional. Name of existing or non-existing parent layer.
?allowAllUnicode : bool
-
(bool) Optional. Allow ambiguous Unicode characters too.
?collapseParents : bool
-
(bool) Optional. Collapse parent layers in Layer UI.
Returns: int
(int) The index in the layer table. Use Doc.Layers.[i].FullPath to get the full name of the new layer.
E.g. The function rs.Add can then take this layer index.
|
Adds a new layer to the document. If it does not exist yet. By default, ambiguous Unicode characters are not allowed in the layer name. This can be changed via optional parameter. If layers or parent layers exist already, color, visibility, and locking parameters are ignored.
|
Full Usage:
RhinoScriptSyntax.AddLayout(?title, ?width, ?height)
Parameters:
string
-
(string) Optional, Title of new layout
?width : float
-
(float) Optional, width of paper for the new layout
?height : float
-
(float) Optional, height of paper for the new layout
Returns: Guid * string
(Guid*string) Id and Name of new layout.
|
Adds a new page layout view.
|
Full Usage:
RhinoScriptSyntax.AddLeader(points, ?text, ?plane)
Parameters:
Point3d seq
-
(Point3d seq) List of (at least 2) 3D points.
?text : string
-
(string) Optional, default value: null. Leader text; omit to create a leader without text.
?plane : Plane
-
(Geometry.Plane) Optional, default value: defined by points arg.
Points will be projected to this plane if provided.
Returns: Guid
(Guid) Identifier of the new leader.
|
Adds a leader to the document. Leader objects are planar. The 3D points passed will define the plane if no plane is given. If there are only two points, the World XY plane is used, except for a vertical segment, which uses a plane containing the segment.
|
Full Usage:
RhinoScriptSyntax.AddLine(startX, startY, startZ, endX, endY, endZ)
Parameters:
float
-
(float) Startpoint of the line: X position.
startY : float
-
(float) Startpoint of the line: Y position.
startZ : float
-
(float) Startpoint of the line: Z position.
endX : float
-
(float) Endpoint of the line: X position.
endY : float
-
(float) Endpoint of the line: Y position.
endZ : float
-
(float) Endpoint of the line:Z position.
Returns: Guid
(Guid) ObjectId of the new curve object.
|
Adds a line curve to the current model.
|
|
|
Full Usage:
RhinoScriptSyntax.AddLine2D(startX, startY, endX, endY)
Parameters:
float
-
(float) Startpoint of the line: X position.
startY : float
-
(float) Startpoint of the line: Y position.
endX : float
-
(float) Endpoint of the line: X position.
endY : float
-
(float) Endpoint of the line: Y position.
Returns: Guid
(Guid) ObjectId of the new curve object.
|
Adds a 2D line curve to the current model at z level 0.0
|
Full Usage:
RhinoScriptSyntax.AddLinearDimension(startPoint, endPoint, pointOnDimensionLine, ?plane)
Parameters:
Point3d
-
(Point3d) The origin, or first point of the dimension
endPoint : Point3d
-
(Point3d) The offset, or second point of the dimension
pointOnDimensionLine : Point3d
-
(Point3d) A point that lies on the dimension line
?plane : Plane
-
(Plane) Optional, The Plane on which the dimension will lie. The default is World XY Plane
Returns: Guid
(Guid) identifier of the new object.
|
Adds a linear dimension to the document.
|
|
|
Full Usage:
RhinoScriptSyntax.AddLinearLight(startPoint, endPoint, lightWidth)
Parameters:
Point3d
-
(Point3d) Starting point of the light
endPoint : Point3d
-
(Point3d) Ending point and direction of the light
lightWidth : float
-
(float) Width of the light. An explicit zero is preserved. Use the two-argument overload for the default width.
Returns: Guid
(Guid) Identifier of the new object.
|
Adds a new linear light object to the document.
|
Full Usage:
RhinoScriptSyntax.AddLoftSrf(objectIds, ?start, ?ende, ?loftType, ?rebuild, ?refit, ?closed)
Parameters:
Guid seq
-
(Guid seq) Ordered list of the Curves to loft through
?start : Point3d
-
(Point3d) Optional, Starting point of the loft
?ende : Point3d
-
(Point3d) Optional, Ending point of the loft
?loftType : int
-
(int) Optional, default value: 0
Type of loft. Possible options are:
0 = Normal. Uses chord-length parameterization in the loft direction
1 = Loose. The Surface is allowed to move away from the original Curves
to make a smoother Surface. The Surface control points are created
at the same locations as the control points of the loft input Curves.
2 = Straight. The sections between the Curves are straight. This is
also known as a ruled Surface.
3 = Tight. The Surface sticks closely to the original Curves. Uses square
root of chord-length parameterization in the loft direction
?rebuild : int
-
(int) Optional, default value: 0
If not 0 then Rebuilds the shape Curves before lofting with this control point count
?refit : float
-
(float) Optional, if given the loft is refitted, the value is the tolerance used to rebuild
?closed : bool
-
(bool) Optional, default value: false
Close the loft back to the first Curve
Returns: ResizeArray<Guid>
(Guid ResizeArray) Array containing the identifiers of the new Surface objects.
|
Adds a Surface created by lofting Curves to the document. - no Curve sorting performed. pass in Curves in the order you want them sorted - directions of open Curves not adjusted. Use CurveDirectionsMatch and ReverseCurve to adjust the directions of open Curves - seams of closed Curves are not adjusted. Use CurveSeam to adjust the seam of closed Curves.
|
Full Usage:
RhinoScriptSyntax.AddMaterialToLayer(layer)
Parameters:
string
-
(string) Name of an existing layer.
Returns: int
(int) Material index of the layer.
|
Adds a material to a layer and returns the new material's index. If the layer already has a material, then the layer's current material index is returned.
|
Full Usage:
RhinoScriptSyntax.AddMaterialToObject(objectId)
Parameters:
Guid
-
(Guid) Identifier of an object.
Returns: int
(int) Material index of the object.
|
Adds a material to an object and returns the new material's index. If the object already has a material, the object's current material index is returned.
|
Full Usage:
RhinoScriptSyntax.AddMesh(vertices, faceVertices, ?vertexNormals, ?textureCoordinates, ?vertexColors)
Parameters:
Point3d seq
-
(Point3d seq) List of 3D points defining the vertices of the mesh
faceVertices : (int * int * int * int) seq
-
(int*int*int*int seq) Tuple of 4 integers that define the
vertex indices for each face of the mesh. If the third and fourth vertex
indices of a face are identical, a triangular face will be created
?vertexNormals : Vector3f
-
(Vector3f seq) Optional, list of 3D vectors defining the vertex normals of
the mesh. Note, for every vertex, there must be a corresponding vertex normal
?textureCoordinates : Point2f
-
(Point2f seq) Optional, list of 2D texture coordinates. For every
vertex, there must be a corresponding texture coordinate
?vertexColors : Color
-
(Drawing.Color seq) Optional, a list of color values. For every vertex,
there must be a corresponding vertex color.
Returns: Guid
(Guid) Identifier of the new object.
|
Adds a Mesh object to the document.
|
Full Usage:
RhinoScriptSyntax.AddMesh(vertices, faceVertices, ?vertexNormals, ?textureCoordinates, ?vertexColors)
Parameters:
Point3d seq
-
(Point3d seq) List of 3D points defining the vertices of the mesh
faceVertices : 'a seq
-
(int IList seq) List containing lists of 3 or 4 numbers that define the
vertex indices for each face of the mesh. If the third and fourth vertex
indices of a face are identical, a triangular face will be created
?vertexNormals : Vector3f
-
(Vector3f seq) Optional, list of 3D vectors defining the vertex normals of
the mesh. Note, for every vertex, there must be a corresponding vertex normal
?textureCoordinates : Point2f
-
(Point2f seq) Optional, list of 2D texture coordinates. For every
vertex, there must be a corresponding texture coordinate
?vertexColors : Color
-
(Drawing.Color seq) Optional, a list of color values. For every vertex,
there must be a corresponding vertex color.
Returns: Guid
(Guid) Identifier of the new object.
Type parameters: 'a (requires :> System.Collections.Generic.IList<Microsoft.FSharp.Core.int>) |
Adds a Mesh object to the document.
|
Full Usage:
RhinoScriptSyntax.AddMeshQuad(pointA, pointB, pointC, pointD)
Parameters:
Point3d
-
(Point3d) First corner point
pointB : Point3d
-
(Point3d) Second corner point
pointC : Point3d
-
(Point3d) Third corner point
pointD : Point3d
-
(Point3d) Fourth corner point
Returns: Guid
(Guid) The identifier of the new Mesh.
|
|
|
|
Full Usage:
RhinoScriptSyntax.AddNamedCPlane(cPlaneName, plane)
Parameters:
string
-
(string) The name of the new named construction plane
plane : Plane
-
(Plane) The construction plane
|
Adds new named construction plane to the document.
|
Full Usage:
RhinoScriptSyntax.AddNamedView(name, ?view)
Parameters:
string
-
(string) The name of the new named view
?view : string
-
(string) Optional, The title of the view to save. If omitted, the current
active view is saved
|
Adds a new named view to the document.
|
Full Usage:
RhinoScriptSyntax.AddNetworkSrf(curves, ?continuity, ?edgeTolerance, ?interiorTolerance, ?angleToleranceRadians)
Parameters:
Guid seq
-
(Guid seq) Curves from which to create the Surface
?continuity : int
-
(int) Optional, default value: 1
How the edges match the input geometry
0 = loose
1 = position
2 = tangency
3 = curvature
?edgeTolerance : float
-
(float) Optional, Edge tolerance
?interiorTolerance : float
-
(float) Optional, Interior tolerance
?angleToleranceRadians : float
-
(float) Optional, default value: 0.0. Angle tolerance in radians, passed directly to RhinoCommon.
Use RhinoMath.ToRadians to convert from degrees to radians.
Returns: Guid
(Guid) identifier of new object.
|
Creates a Surface from a network of crossing Curves.
|
Full Usage:
RhinoScriptSyntax.AddNurbsCurve(points, knots, degree, ?weights)
Parameters:
Point3d seq
-
(Point3d seq) A list containing 3D control points.
knots : float seq
-
(float seq) Knot values for the Curve. The number of elements in knots must
equal the number of elements in points plus degree minus 1.
degree : int
-
(int) Degree of the Curve. must be greater than of equal to 1.
?weights : float
-
(float seq) Optional, Weight values for the Curve. Number of elements should
equal the number of elements in points. Values must be greater than 0.
Returns: Guid
(Guid) The identifier of the new object.
|
Adds a NURBS Curve object to the document.
|
Full Usage:
RhinoScriptSyntax.AddNurbsSurface(pointCount, points, knotsU, knotsV, degree, ?weights)
Parameters:
int * int
-
(int * int) Number of control points in the u and v direction
points : IList<Point3d>
-
(Point3d IList) List of 3D points
knotsU : float seq
-
(float IList) List of Knot values for the Surface in the u direction.
Must contain pointCount[0]+degree[0]-1 elements
knotsV : float seq
-
(float IList) List of Knot values for the Surface in the v direction.
Must contain pointCount[1]+degree[1]-1 elements
degree : int * int
-
(int * int) Degree of the Surface in the u and v directions
?weights : float
-
(float IList) Optional, List of Weight values for the Surface. The number of elements in
weights must equal the number of elements in points. Values must be greater than zero
Returns: Guid
(Guid) identifier of new object.
|
Adds a NURBS Surface object to the document.
|
Full Usage:
RhinoScriptSyntax.AddObjectToGroup(objectId, groupName)
Parameters:
Guid
-
(Guid) Guid representing the object identifier.
groupName : string
-
(string) The name of an existing group.
|
Adds a single object to an existing group.
|
Full Usage:
RhinoScriptSyntax.AddObjectsToGroup(objectIds, groupName)
Parameters:
Guid seq
-
(Guid seq) List of Guids representing the object identifiers.
groupName : string
-
(string) The name of an existing group.
|
Adds one or more objects to an existing group.
|
Full Usage:
RhinoScriptSyntax.AddPatch(objectIds, uvSpans, ?tolerance, ?trim, ?pointSpacing, ?flexibility, ?surfacePull, ?fixEdges)
Parameters:
Guid seq
-
(Guid seq) A list of object identifiers that indicate the objects to use for the patch fitting.
Acceptable object types include Curves, points, point clouds, and Meshes
uvSpans : int * int
-
(int * int) The U and V direction span counts for the automatically generated Surface . however it is best if you create a starting Surface that is similar in shape
to the Surface you are trying to create an use the other overload of this method
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
The tolerance used by input analysis functions.
?trim : bool
-
(bool) Optional, default value: true
Try to find an outside Curve and trims the Surface to it. The default value is True
?pointSpacing : float
-
(float) Optional, default value: 0.1
The basic distance between points sampled from input Curves. The default value is 0.1
?flexibility : float
-
(float) Optional, default value: 1.0
Determines the behavior of the Surface in areas where its not otherwise controlled by the input.
Lower numbers make the Surface behave more like a stiff material, higher, more like a flexible material.
That is, each span is made to more closely match the spans adjacent to it if there is no input geometry
mapping to that area of the Surface when the flexibility value is low. The scale is logarithmic.
For example, numbers around 0.001 or 0.1 make the patch pretty stiff and numbers around 10 or 100
make the Surface flexible. The default value is 1.0
?surfacePull : float
-
(float) Optional, default value: 1.0
Similar to stiffness, but applies to the starting Surface. The bigger the pull, the closer
the resulting Surface shape will be to the starting Surface. The default value is 1.0
?fixEdges : bool
-
(bool) Optional, default value: false
Clamps the edges of the starting Surface in place. This option is useful if you are using a
Curve or points for deforming an existing Surface, and you do not want the edges of the starting Surface
to move. The default is False
Returns: Guid
(Guid) Identifier of the new Surface object.
|
Fits a Surface through Curve, point, point cloud, and Mesh objects.
|
Full Usage:
RhinoScriptSyntax.AddPatch(objectIds, startSurfaceId, ?tolerance, ?trim, ?pointSpacing, ?flexibility, ?surfacePull, ?fixEdges)
Parameters:
Guid seq
-
(Guid seq) A list of object identifiers that indicate the objects to use for the patch fitting.
Acceptable object types include Curves, points, point clouds, and Meshes
startSurfaceId : Guid
-
(Guid) The identifier of the starting Surface. It is best if you create a starting Surface that is similar in shape
to the Surface you are trying to create
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
The tolerance used by input analysis functions.
?trim : bool
-
(bool) Optional, default value: true
Try to find an outside Curve and trims the Surface to it. The default value is True
?pointSpacing : float
-
(float) Optional, default value: 0.1
The basic distance between points sampled from input Curves. The default value is 0.1
?flexibility : float
-
(float) Optional, default value: 1.0
Determines the behavior of the Surface in areas where its not otherwise controlled by the input.
Lower numbers make the Surface behave more like a stiff material, higher, more like a flexible material.
That is, each span is made to more closely match the spans adjacent to it if there is no input geometry
mapping to that area of the Surface when the flexibility value is low. The scale is logarithmic.
For example, numbers around 0.001 or 0.1 make the patch pretty stiff and numbers around 10 or 100
make the Surface flexible. The default value is 1.0
?surfacePull : float
-
(float) Optional, default value: 1.0
Similar to stiffness, but applies to the starting Surface. The bigger the pull, the closer
the resulting Surface shape will be to the starting Surface. The default value is 1.0
?fixEdges : bool
-
(bool) Optional, default value: false
Clamps the edges of the starting Surface in place. This option is useful if you are using a
Curve or points for deforming an existing Surface, and you do not want the edges of the starting Surface
to move. The default is False
Returns: Guid
(Guid) Identifier of the new Surface object.
|
Fits a Surface through Curve, point, point cloud, and Mesh objects.
|
Full Usage:
RhinoScriptSyntax.AddPictureFrame(plane, filename, ?width, ?height, ?selfIllumination, ?embed, ?useAlpha, ?makeMesh)
Parameters:
Plane
-
(Plane) The plane in which the PictureFrame will be created. The bottom-left corner of the picture will be at the plane's origin. The width will be in the plane's X axis direction, and the height will be in the plane's Y axis direction.
filename : string
-
(string) The path to a bitmap or image file.
?width : float
-
(float) Optional. If both width and height are 0.0 or skipped, then the width and height of the PictureFrame will be the width and height of the image. If width = 0 and height > 0, or if width > 0 and height = 0, then the non-zero value is assumed to be an aspect ratio of the image's width or height, whichever one is 0. If both width and height are > 0, then these are assumed to be the width and height in the current unit system.
?height : float
-
(float) Optional. If both width and height are 0.0 or skipped, then the width and height of the PictureFrame will be the width and height of the image. If width = 0 and height > 0, or if width > 0 and height = 0, then the non-zero value is assumed to be an aspect ratio of the image's width or height, whichever one is 0. If both width and height are > 0, then these are assumed to be the width and height in the current unit system.
?selfIllumination : bool
-
(bool) Optional, default value: true. If True, then the image mapped to the picture frame plane always displays at full intensity and is not affected by light or shadow.
?embed : bool
-
(bool) Optional, default value: false. If True, then the function adds the image to Rhino's internal bitmap table, thus making the document self-contained.
?useAlpha : bool
-
(bool) Optional, default value: false. If False, the picture frame is created without any transparency texture. If True, a transparency texture is created with a "mask texture" set to alpha, and an instance of the diffuse texture in the source texture slot.
?makeMesh : bool
-
(bool) Optional, default value: false. If True, the function will make a PictureFrame object from a mesh rather than a plane surface.
Returns: Guid
(Guid) Object identifier.
|
Creates a picture frame and adds it to the document.
|
Full Usage:
RhinoScriptSyntax.AddPipe(curveId, parameters, radii, ?blendType, ?cap, ?fit)
Parameters:
Guid
-
(Guid) Identifier of rail Curve
parameters : float seq
-
(float seq) normalized Curve parameters, from 0.0 to 1.0
radii : float seq
-
(float seq) radius values at normalized Curve parameters, the same count as parameters.
A RhinoScriptingException is raised if the counts differ.
?blendType : int
-
(int) Optional, default value: 0
0(local) or 1(global)
?cap : int
-
(int) Optional, default value: 0
0(none), 1(flat), 2(round)
?fit : bool
-
(bool) Optional, default value: false
Attempt to fit a single Surface
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers of new objects created.
|
Creates a single walled Surface with a circular profile around a Curve.
|
|
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.AddPoint(x, y, z)
Parameters:
float
-
(float) X location of point to add
y : float
-
(float) Y location of point to add
z : float
-
(float) Z location of point to add
Returns: Guid
(Guid) identifier for the object that was added to the doc.
|
Adds point object to the document.
|
Full Usage:
RhinoScriptSyntax.AddPointCloud(points, ?colors)
Parameters:
Point3d[]
-
(Point3d array) List of values where every multiple of three represents a point
?colors : Color
-
(Drawing.Color IList) Optional, List of colors to apply to each point
Returns: Guid
(Guid) identifier of point cloud.
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.AddPolyline(points, ?deleteShortSegments, ?drawDotsAndRaiseIfFailed)
Parameters:
Point3d seq
-
(Point3d seq) List of 3D points. The list must contain at least two points. If the list contains less than four points, then the first point and last point must be different.
?deleteShortSegments : bool
-
(bool) Optional, default value: true. If true, segments shorter than the document's absolute tolerance will be deleted.
?drawDotsAndRaiseIfFailed : bool
-
(bool) Optional, default value: false. If true, text dots will be drawn on layer `ERROR-AddPolyline` at each point and an exception will be raised if the operation fails.
Returns: Guid
(Guid) ObjectId of the new curve object. Empty Guid if the operation fails.
|
Adds a Polyline Curve.
|
Full Usage:
RhinoScriptSyntax.AddPolylineClosed(points, ?deleteShortSegments, ?drawDotsAndRaiseIfFailed)
Parameters:
Point3d seq
-
(Point3d seq) List of 3D points. The list must contain at least three points.
?deleteShortSegments : bool
-
(bool) Optional, default value: true. If true, segments shorter than the document's absolute tolerance will be deleted.
?drawDotsAndRaiseIfFailed : bool
-
(bool) Optional, default value: false.
If true, text dots will be drawn on layer `ERROR-AddPolylineClosed` at each point and an exception will be raised if the operation fails.
Returns: Guid
(Guid) ObjectId of the new curve object. Empty Guid if the operation fails.
|
Adds a closed Polyline Curve. If the endpoint is already closer than State.Doc.ModelAbsoluteTolerance to the start it wil be set to start point else an additional point will be added with the same position as start.
|
Full Usage:
RhinoScriptSyntax.AddRailRevSrf(profile, rail, axis, ?scaleHeight)
Parameters:
Guid
-
(Guid) Identifier of the profile Curve
rail : Guid
-
(Guid) Identifier of the rail Curve
axis : Line
-
(Line) A Line identifying the start point and end point of the rail revolve axis
?scaleHeight : bool
-
(bool) Optional, default value: false
If True, Surface will be locally scaled. Defaults to False
Returns: Guid
(Guid) identifier of the new object.
|
Adds a Surface created through profile Curves that define the Surface shape and two Curves that defines a Surface edge.
|
Full Usage:
RhinoScriptSyntax.AddRectangle(plane, width, height)
Parameters:
Plane
-
(Plane) Plane on which the rectangle will lie
width : float
-
(float) Width of rectangle as measured along the Plane's x and y axes
height : float
-
(float) Height of rectangle as measured along the Plane's x and y axes
Returns: Guid
(Guid) ObjectId of new rectangle.
|
Add a rectangular Curve to the document.
|
Full Usage:
RhinoScriptSyntax.AddRectangularLight(origin, widthPoint, heightPoint)
Parameters:
Point3d
-
(Point3d) 3d origin point of the light
widthPoint : Point3d
-
(Point3d) 3d width and direction point of the light
heightPoint : Point3d
-
(Point3d) 3d height and direction point of the light
Returns: Guid
(Guid) identifier of the new object.
|
Adds a new rectangular light object to the document.
|
Full Usage:
RhinoScriptSyntax.AddRevSrf(curveId, axis, ?startAngleDegrees, ?endAngleDegrees)
Parameters:
Guid
-
(Guid) Identifier of profile Curve
axis : Line
-
(Line) Line for the rail revolve axis
?startAngleDegrees : float
-
(float) Optional, default value: 0.0
Start angle of revolution in degrees
?endAngleDegrees : float
-
(float) Optional, default value: 360.0
End angle of revolution in degrees
Returns: Guid
(Guid) identifier of new object.
|
Create a Surface by revolving a Curve around an axis.
|
Full Usage:
RhinoScriptSyntax.AddSearchPath(folder, ?index)
Parameters:
string
-
(string) A valid folder, or path, to add
?index : int
-
(int) Optional, Zero-based position in the search path list to insert.
If omitted, path will be appended to the end of the search path list.
Returns: int
(int) The index where the item was inserted.
-1 on failure.
|
Add new path to Rhino's search path list. Search paths can be added by using Rhino's Options command and modifying the contents of the Files tab.
|
|
|
Full Usage:
RhinoScriptSyntax.AddSpiral(point0, point1, pitch, turns, radius0, ?radius1)
Parameters:
Point3d
-
(Point3d) Helix axis start point or center of spiral.
point1 : Point3d
-
(Point3d) Helix axis end point or point normal on spiral Plane.
pitch : float
-
(float) Distance between turns. If 0, then a spiral. If > 0 then the distance between helix "threads".
turns : float
-
(float) Number of turns.
radius0 : float
-
(float) Starting radius of spiral.
?radius1 : float
-
(float) Optional, Ending radius of spiral. If omitted, the starting radius is used for the complete spiral.
Returns: Guid
(Guid) ObjectId of new curve.
|
Adds a spiral or helical curve to the document.
|
|
|
Full Usage:
RhinoScriptSyntax.AddSrfContourCrvs(objectId, startPoint, endPoint, interval)
Parameters:
Guid
-
(Guid) Object identifier to contour
startPoint : Point3d
-
(Point3d) The start point of a center line
endPoint : Point3d
-
(Point3d) the end point of a center line
interval : float
-
(float) Distance between contour Curves
Returns: ResizeArray<Guid>
(Guid ResizeArray) ids of new contour Curves .
|
Adds a spaced series of planar Curves resulting from the intersection of defined cutting Planes through a Surface or Polysurface. For more information, see Rhino help for details on the Contour command.
|
|
Adds a spaced series of planar Curves resulting from the intersection of defined cutting Planes through a Surface or Polysurface. For more information, see Rhino help for details on the Contour command.
|
Full Usage:
RhinoScriptSyntax.AddSrfControlPtGrid(count, points, ?degreeU, ?degreeV)
Parameters:
int * int
-
(int * int) Tuple of two numbers defining number of points in the u, v directions
points : Point3d seq
-
(Point3d seq) List of 3D points
?degreeU : int
-
(int) Optional, default value: 3 degree of the Surface in the U directions
?degreeV : int
-
(int) Optional, default value: 3 degree of the Surface in the V directions
Returns: Guid
(Guid) The identifier of the new object.
|
Creates a Surface from a grid of points.
|
|
|
Full Usage:
RhinoScriptSyntax.AddSrfPt(pointA, pointB, pointC, pointD)
Parameters:
Point3d
-
(Point3d) First corner point
pointB : Point3d
-
(Point3d) Second corner point
pointC : Point3d
-
(Point3d) Third corner point
pointD : Point3d
-
(Point3d) Fourth corner point
Returns: Guid
(Guid) The identifier of the new object.
|
|
Full Usage:
RhinoScriptSyntax.AddSrfPtGrid(count, points, ?degreeU, ?degreeV, ?closedU, ?closedV)
Parameters:
int * int
-
(int * int) Tuple of two numbers defining number of points in the u, v directions
points : Point3d seq
-
(Point3d seq) List of 3D points
?degreeU : int
-
(int) Optional, default value: 3 degree of the Surface in the U directions
?degreeV : int
-
(int) Optional, default value: 3 degree of the Surface in the V directions
?closedU : bool
-
(bool * bool) Optional, default value: false boolean defining if the Surface is closed in the U directions
?closedV : bool
-
(bool * bool) Optional, default value: false boolean defining if the Surface is closed in the V directions
Returns: Guid
(Guid) The identifier of the new object.
|
Creates a Surface from a grid of points.
|
Full Usage:
RhinoScriptSyntax.AddSubCrv(curveId, param0, param1)
Parameters:
Guid
-
(Guid) Identifier of a closed planar Curve object
param0 : float
-
(float) First parameters on the source Curve
param1 : float
-
(float) Second parameters on the source Curve
Returns: Guid
(Guid) ObjectId of the new curve object.
|
Add a Curve object based on a portion, or interval of an existing Curve object. Similar in operation to Rhino's SubCrv command.
|
Full Usage:
RhinoScriptSyntax.AddSweep1(rail, shapes, ?closed)
Parameters:
Guid
-
(Guid) Identifier of the rail Curve
shapes : Guid seq
-
(Guid seq) One or more cross section shape Curves
?closed : bool
-
(bool) Optional, default value: false
If True, then create a closed Surface
Returns: ResizeArray<Guid>
(Guid ResizeArray) List of new Surface objects.
An empty list if RhinoCommon finds no result, this is not an error.
|
Adds a Surface created through profile Curves that define the Surface shape and one Curve that defines a Surface edge.
|
Full Usage:
RhinoScriptSyntax.AddSweep2(rails, shapes, ?closed)
Parameters:
Guid * Guid
-
(Guid * Guid) Identifiers of the two rail Curve
shapes : Guid seq
-
(Guid seq) One or more cross section shape Curves
?closed : bool
-
(bool) Optional, default value: false
If True, then create a closed Surface
Returns: ResizeArray<Guid>
(Guid ResizeArray) List of new Surface objects.
An empty list if RhinoCommon finds no result, this is not an error.
|
Adds a Surface created through profile Curves that define the Surface shape and two Curves that defines a Surface edge.
|
Full Usage:
RhinoScriptSyntax.AddText(text, pt, ?height, ?font, ?fontStyle, ?horizontalAlignment, ?verticalAlignment)
Parameters:
string
-
(string) The text to display
pt : Point3d
-
(Point3d) a point where to add text. It will be parallel to XY Plane.
?height : float
-
(float) Optional, default value: 1.0
The text height
?font : string
-
(string) Optional, The text font
?fontStyle : int
-
(int) Optional, default value: 0
Any of the following flags
0 = normal
1 = bold
2 = italic
3 = bold and italic
?horizontalAlignment : byte
-
(DocObjects.TextHorizontalAlignment) or Byte.
Optional, default value: TextHorizontalAlignment.Center = 1uy
0uy = Left
1uy = Center
2uy = Right
?verticalAlignment : byte
-
(DocObjects.TextVerticalAlignment) or Byte.
Optional, default value: TextVerticalAlignment.Middle = 3uy
0uy = Top: Attach to top of an "I" on the first line.
1uy = MiddleOfTop: Attach to middle of an "I" on the first line.
2uy = BottomOfTop: Attach to baseline of first line.
3uy = Middle: Attach to middle of text vertical advance.
4uy = MiddleOfBottom: Attach to middle of an "I" on the last line.
5uy = Bottom: Attach to the baseline of the last line.
6uy = BottomOfBoundingBox: Attach to the bottom of the bounding box of the visible glyphs.
Returns: Guid
(Guid) identifier for the object that was added to the doc.
|
Adds a text string to the document.
|
Full Usage:
RhinoScriptSyntax.AddText(text, plane, ?height, ?font, ?fontStyle, ?horizontalAlignment, ?verticalAlignment)
Parameters:
string
-
(string) The text to display
plane : Plane
-
(Plane) The Plane on which the text will lie.
The origin of the Plane will be the origin point of the text
?height : float
-
(float) Optional, default value: 1.0
The text height
?font : string
-
(string) Optional, The text font
?fontStyle : int
-
(int) Optional, default value: 0
Any of the following flags
0 = normal
1 = bold
2 = italic
3 = bold and italic
?horizontalAlignment : byte
-
(DocObjects.TextHorizontalAlignment) or Byte.
Optional, default value: TextHorizontalAlignment.Center = 1uy
0uy = Left
1uy = Center
2uy = Right
?verticalAlignment : byte
-
(DocObjects.TextVerticalAlignment) or Byte.
Optional, default value: TextVerticalAlignment.Middle = 3uy
0uy = Top: Attach to top of an "I" on the first line.
1uy = MiddleOfTop: Attach to middle of an "I" on the first line.
2uy = BottomOfTop: Attach to baseline of first line.
3uy = Middle: Attach to middle of text vertical advance.
4uy = MiddleOfBottom: Attach to middle of an "I" on the last line.
5uy = Bottom: Attach to the baseline of the last line.
6uy = BottomOfBoundingBox: Attach to the bottom of the bounding box of the visible glyphs.
Returns: Guid
(Guid) identifier for the object that was added to the doc.
|
Adds a text string to the document.
|
Full Usage:
RhinoScriptSyntax.AddTextDot(text, x, y, z)
Parameters:
string
-
(string) String in dot
x : float
-
(float) X position
y : float
-
(float) Y position
z : float
-
(float) Z position
Returns: Guid
(Guid) The identifier of the new object.
|
Add a text dot to the document.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.AddTweenCurves(fromCurveId, toCurveId, ?numberOfCurves, ?method, ?sampleNumber)
Parameters:
Guid
-
(Guid) Identifier of the first Curve object
toCurveId : Guid
-
(Guid) Identifier of the second Curve object
?numberOfCurves : int
-
(int) Optional, default value: 1
The number of Curves to create. The default is 1
?method : int
-
(int) Optional, default value: 0
The method for refining the output Curves, where:
0: (Default) Uses the control points of the Curves for matching. So the first control point of first Curve is matched to first control point of the second Curve.
1: Refits the output Curves like using the FitCurve method. Both the input Curve and the output Curve will have the same structure. The resulting Curves are usually more complex than input unless input Curves are compatible.
2: Input Curves are divided to the specified number of points on the Curve, corresponding points define new points that output Curves go through. If you are making one tween Curve, the method essentially does the following: divides the two Curves into an equal number of points, finds the midpoint between the corresponding points on the Curves, and interpolates the tween Curve through those points
?sampleNumber : int
-
(int) Optional, default value: 10
The number of samples points to use if method is 2. The default is 10
Returns: ResizeArray<Guid>
(Guid ResizeArray) The identifiers of the new tween objects.
|
Creates Curves between two open or closed input Curves.
|
Full Usage:
RhinoScriptSyntax.AliasCount()
Returns: int
(int) The number of command aliases in Rhino.
|
Returns number of command aliases in Rhino.
|
Full Usage:
RhinoScriptSyntax.AliasMacro(alias, macro)
Parameters:
string
-
(string) The name of an existing command alias
macro : string
-
(string) The new macro to run when the alias is executed.
|
Modifies the macro of a command alias.
|
Full Usage:
RhinoScriptSyntax.AliasMacro(alias)
Parameters:
string
-
(string) The name of an existing command alias
Returns: string
(string) The existing macro.
|
Returns the macro of a command alias.
|
Full Usage:
RhinoScriptSyntax.AliasNames()
Returns: string array
(string array) An array of command alias names.
|
Returns an array of command alias names.
|
Full Usage:
RhinoScriptSyntax.AllObjects(?select, ?includeLights, ?includeGrips, ?includeReferences)
Parameters:
bool
-
(bool) Optional, default value: false Select the objects
?includeLights : bool
-
(bool) Optional, default value: false Include light objects
?includeGrips : bool
-
(bool) Optional, default value: false Include grips objects
?includeReferences : bool
-
(bool) Optional, default value: false Include reference objects such as work session objects
Returns: ResizeArray<Guid>
(Guid ResizeArray) Identifiers for all the objects in the document.
|
Returns identifiers of all objects in the document.
|
Full Usage:
RhinoScriptSyntax.Angle(point1, point2, ?plane)
Parameters:
Point3d
-
(Point3d) Point1 of input points
point2 : Point3d
-
(Point3d) Point2 of input points
?plane : Plane
-
(Plane) Optional, default value: Plane.WorldXY
If a Plane is provided, angle calculation is with respect to this Plane
Returns: float * float * float * float * float
(float * float * float * float * float) containing the following elements:
element 0 = the X, Y angle in degrees
element 1 = the elevation angle in degrees
element 2 = delta in the X direction
element 3 = delta in the Y direction
element 4 = delta in the Z direction.
|
Measures the XY and elevation angles in degrees between two points.
|
Full Usage:
RhinoScriptSyntax.Angle2(line1, line2)
Parameters:
Line
-
(Line) List of 6 numbers or 2 Point3d
line2 : Line
-
(Line) List of 6 numbers or 2 Point3d
Returns: float * float
(float * float) containing the following elements:
0 = The angle in degrees.
1 = The reflex angle in degrees.
|
Measures the angle and reflex angle in degrees between two lines.
|
Full Usage:
RhinoScriptSyntax.AppearanceColor(item, color)
Parameters:
int
-
(int) Item number to either query or modify
0 = View background
1 = Major grid line
2 = Minor grid line
3 = X-Axis line
4 = Y-Axis line
5 = Selected Objects
6 = Locked Objects
7 = New layers
8 = Feedback
9 = Tracking
10 = Crosshair
11 = Text
12 = Text Background
13 = Text hover
color : Color
-
(Drawing.Color ) The new color value as System.Drawing.Color
|
Modifies an application interface item's color.
|
Full Usage:
RhinoScriptSyntax.AppearanceColor(item)
Parameters:
int
-
(int) Item number to either query or modify
0 = View background
1 = Major grid line
2 = Minor grid line
3 = X-Axis line
4 = Y-Axis line
5 = Selected Objects
6 = Locked Objects
7 = New layers
8 = Feedback
9 = Tracking
10 = Crosshair
11 = Text
12 = Text Background
13 = Text hover
Returns: Color
(Drawing.Color) The current item color.
0 = View background
1 = Major grid line
2 = Minor grid line
3 = X-Axis line
4 = Y-Axis line
5 = Selected Objects
6 = Locked Objects
7 = New layers
8 = Feedback
9 = Tracking
10 = Crosshair
11 = Text
12 = Text Background
13 = Text hover.
|
Returns an application interface item's color.
|
Full Usage:
RhinoScriptSyntax.ArcAngle(curveGeo, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
?segmentIndex : int
-
(int) Optional, Identifies the Curve segment if CurveId identifies a poly-curve.
Returns: float
(float) The angle in degrees.
|
Returns the angle in degrees of an arc Curve object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.ArcAngle(curveId, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of a Curve object
?segmentIndex : int
-
(int) Optional, Identifies the Curve segment if CurveId identifies a poly-curve.
Returns: float
(float) The angle in degrees.
|
Returns the angle in degrees of an arc Curve object.
|
|
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.ArcRadius(curveGeo, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a poly-curve
Returns: float
(float) The radius of the arc.
|
Returns the radius of an arc Curve object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.ArcRadius(curveId, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of a Curve object
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a poly-curve
Returns: float
(float) The radius of the arc.
|
Returns the radius of an arc Curve object.
|
Full Usage:
RhinoScriptSyntax.Area(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: float
(float) area.
|
Compute the area of a closed Curve, Hatch, Surface, Polysurface, or Mesh.
|
Full Usage:
RhinoScriptSyntax.Area(geometry)
Parameters:
GeometryBase
-
(GeometryBase) The geometry to use
Returns: float
(float) area.
|
Compute the area of a closed Curve, Hatch, Surface, Polysurface, or Mesh.
|
Full Usage:
RhinoScriptSyntax.AutosaveFile(filename)
Parameters:
string
-
(string) Name of the new autosave file
|
Changes the file name used by Rhino's automatic file saving.
|
Full Usage:
RhinoScriptSyntax.AutosaveFile()
Returns: string
(string) The name of the current autosave file.
|
Returns the file name used by Rhino's automatic file saving.
|
Full Usage:
RhinoScriptSyntax.AutosaveInterval(minutes)
Parameters:
float
-
(float) The number of minutes between saves
|
Changes how often the document will be saved when Rhino's automatic file saving mechanism is enabled.
|
Full Usage:
RhinoScriptSyntax.AutosaveInterval()
Returns: float
(float) The current interval in minutes.
|
Returns how often the document will be saved when Rhino's automatic file saving mechanism is enabled.
|
Full Usage:
RhinoScriptSyntax.BlockContainerCount(blockName)
Parameters:
string
-
(string) The name of an existing block definition
Returns: int
(int) The number of block definitions that contain a specified block definition.
|
Returns number of block definitions that contain a specified block definition.
|
Full Usage:
RhinoScriptSyntax.BlockContainers(blockName)
Parameters:
string
-
(string) The name of an existing block definition
Returns: ResizeArray<string>
(string ResizeArray) A list of block definition names.
|
Returns names of the block definitions that contain a specified block definition.
|
Full Usage:
RhinoScriptSyntax.BlockCount()
Returns: int
(int) The number of block definitions in the document.
|
Returns the number of block definitions in the document.
|
Full Usage:
RhinoScriptSyntax.BlockDescription(blockName, description)
Parameters:
string
-
(string) The name of an existing block definition
description : string
-
(string) The new description
|
Sets the description of a block definition.
|
Full Usage:
RhinoScriptSyntax.BlockDescription(blockName)
Parameters:
string
-
(string) The name of an existing block definition
Returns: string
(string) The current description.
|
Returns the description of a block definition.
|
Full Usage:
RhinoScriptSyntax.BlockInstanceCount(blockName, ?whereToLook)
Parameters:
string
-
(string) The name of an existing block definition
?whereToLook : int
-
(int) Optional, default value: 0
0 = get top level references in active document.
1 = get top level and nested references in active document.
If a block is nested more than once within another block it will be counted only once.
2 = check for references from other instance definitions, counts every instance of nested block
Returns: int
(int) The number of instances of the block in the document.
|
Counts number of instances of the block in the document. Nested instances are not included in the count. Attention this may include deleted blocks.
|
|
|
Full Usage:
RhinoScriptSyntax.BlockInstanceName(objectId)
Parameters:
Guid
-
(Guid) The identifier of an existing block insertion object
Returns: string
(string) The block name of a block instance.
|
Returns the block name of a block instance.
|
|
Returns the location of a block instance relative to the world coordinate system origin (0, 0, 0). The position is returned as a 4x4 transformation matrix.
|
Full Usage:
RhinoScriptSyntax.BlockInstances(blockName, ?whereToLook)
Parameters:
string
-
(string) The name of an existing block definition
?whereToLook : int
-
(int) Optional, default value: 0
0 = get top level references in active document.
1 = get top level and nested references in active document.
2 = check for references from other instance definitions
Returns: ResizeArray<Guid>
(Guid ResizeArray) Ids identifying the instances of a block in the model.
|
Returns the identifiers of the inserted instances of a block.
|
Full Usage:
RhinoScriptSyntax.BlockNames(?sort)
Parameters:
bool
-
(bool) Optional, default value: false. True to sort the names; False to preserve document order.
Returns: ResizeArray<string>
(string ResizeArray) The names of all block definitions in the document.
|
Returns the names of all block definitions in the document, optionally sorted in ordinal order.
|
Full Usage:
RhinoScriptSyntax.BlockObjectCount(blockName)
Parameters:
string
-
(string) Name of an existing block definition
Returns: int
(int) The number of objects that make up a block definition.
|
Returns number of objects that make up a block definition.
|
Full Usage:
RhinoScriptSyntax.BlockObjects(blockName)
Parameters:
string
-
(string) Name of an existing block definition
Returns: ResizeArray<Guid>
(Guid ResizeArray) list of identifiers.
|
Returns identifiers of the objects that make up a block definition.
|
Full Usage:
RhinoScriptSyntax.BlockPath(blockName)
Parameters:
string
-
(string) Name of an existing block definition
Returns: string
(string) path to the linked block.
|
Returns path to the source of a linked or embedded block definition. A linked or embedded block definition is a block definition that was inserted from an external file.
|
Full Usage:
RhinoScriptSyntax.BlockStatus(blockName)
Parameters:
string
-
(string) Name of an existing block
Returns: int
(int) The status of a linked block
Value Description
-3 Not a linked block definition.
-2 The linked block definition's file could not be opened or could not be read.
-1 The linked block definition's file could not be found.
0 The linked block definition is up-to-date.
1 The linked block definition's file is newer than definition.
2 The linked block definition's file is older than definition.
3 The linked block definition's file is different than definition.
|
Returns the status of a linked block.
|
Full Usage:
RhinoScriptSyntax.BooleanDifference(input0, input1)
Parameters:
Brep seq
-
(Brep seq) List of Surfaces to subtract from
input1 : Brep seq
-
(Brep seq) List of Surfaces to be subtracted
Returns: ResizeArray<Brep>
(Brep ResizeArray) Newly created geometry. The caller owns the returned objects.
|
Performs a boolean difference operation on two sets of input Surfaces and Polysurfaces. For more details, see the BooleanDifference command in the Rhino help file. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.BooleanDifference(input0, input1, ?deleteInput)
Parameters:
Guid seq
-
(Guid seq) List of Surfaces to subtract from
input1 : Guid seq
-
(Guid seq) List of Surfaces to be subtracted
?deleteInput : bool
-
(bool) Optional, default value: true
Delete all input objects
Returns: ResizeArray<Guid>
(Guid ResizeArray) List of identifiers of newly created objects .
|
Performs a boolean difference operation on two sets of input Surfaces and Polysurfaces. For more details, see the BooleanDifference command in the Rhino help file.
|
Full Usage:
RhinoScriptSyntax.BooleanIntersection(input0, input1)
Parameters: Returns: ResizeArray<Brep>
(Brep ResizeArray) Newly created geometry. The caller owns the returned objects.
An empty list if the inputs do not overlap.
|
Performs a boolean intersection operation on two sets of input Surfaces and Polysurfaces. For more details, see the BooleanIntersection command in the Rhino help file. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.BooleanIntersection(input0, input1, ?deleteInput)
Parameters:
Guid seq
-
(Guid seq) List of Surfaces
input1 : Guid seq
-
(Guid seq) List of Surfaces
?deleteInput : bool
-
(bool) Optional, default value: true
Delete all input objects
Returns: ResizeArray<Guid>
(Guid ResizeArray) List of identifiers of newly created objects.
An empty list if the inputs do not overlap. Then the inputs are still deleted if deleteInput is true, like in RhinoPython.
|
Performs a boolean intersection operation on two sets of input Surfaces and Polysurfaces. For more details, see the BooleanIntersection command in the Rhino help file.
|
|
Performs a boolean union operation on a set of input Surfaces and Polysurfaces. For more details, see the BooleanUnion command in the Rhino help file. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.BooleanUnion(input, ?deleteInput)
Parameters:
Guid seq
-
(Guid seq) List of Surfaces to union
?deleteInput : bool
-
(bool) Optional, default value: true
Delete all input objects
Returns: ResizeArray<Guid>
(Guid ResizeArray) List of identifiers of newly created objects .
|
Performs a boolean union operation on a set of input Surfaces and Polysurfaces. For more details, see the BooleanUnion command in the Rhino help file.
|
Full Usage:
RhinoScriptSyntax.BoundingBox(object, plane, ?inWorldCoords)
Parameters:
GeometryBase
-
(GeometryBase) Geometry to use directly.
plane : Plane
-
(Plane) Plane to which the bounding box should be aligned
?inWorldCoords : bool
-
(bool) Optional, default value: true
Returns the box as world coordinates or custom Plane coordinates.
Returns: Box
(Geometry.Box) The Box ,oriented to the Plane or in Plane coordinates.
It cannot be a Geometry.BoundingBox since it is not in World XY
To get the eight 3D points that define the bounding box call box.GetCorners()
Points returned in counter-clockwise order starting with the bottom rectangle of the box.
|
Returns a custom Plane axis-aligned bounding box of one object.
|
Full Usage:
RhinoScriptSyntax.BoundingBox(objects, plane, ?inWorldCoords)
Parameters:
GeometryBase seq
-
(GeometryBase seq) Geometry to use directly.
plane : Plane
-
(Plane) Plane to which the bounding box should be aligned
?inWorldCoords : bool
-
(bool) Optional, default value: true
Returns the box as world coordinates or custom Plane coordinates.
Returns: Box
(Geometry.Box) The Box ,oriented to the Plane or in Plane coordinates.
It cannot be a Geometry.BoundingBox since it is not in World XY
To get the eight 3D points that define the bounding box call box.GetCorners()
Points returned in counter-clockwise order starting with the bottom rectangle of the box.
|
Returns a custom Plane axis-aligned bounding box of several objects.
|
Full Usage:
RhinoScriptSyntax.BoundingBox(object)
Parameters:
GeometryBase
-
(GeometryBase) Geometry to use directly.
Returns: BoundingBox
(Geometry.BoundingBox) The BoundingBox (oriented to the World XY Plane).
To get the eight 3D points that define the bounding box call box.GetCorners()
Points returned in counter-clockwise order starting with the bottom rectangle of the box.
|
Returns a world axis-aligned bounding box of one object.
|
Full Usage:
RhinoScriptSyntax.BoundingBox(object, plane, ?inWorldCoords)
Parameters:
Guid
-
(Guid) The identifier of the object
plane : Plane
-
(Plane) Plane to which the bounding box should be aligned
?inWorldCoords : bool
-
(bool) Optional, default value: true
Returns the box as world coordinates or custom Plane coordinates.
Returns: Box
(Geometry.Box) The Box ,oriented to the Plane or in Plane coordinates.
It cannot be a Geometry.BoundingBox since it is not in World XY
To get the eight 3D points that define the bounding box call box.GetCorners()
Points returned in counter-clockwise order starting with the bottom rectangle of the box.
|
Returns a custom Plane axis-aligned bounding box of one object.
|
Full Usage:
RhinoScriptSyntax.BoundingBox(objects, plane, ?inWorldCoords)
Parameters:
Guid seq
-
(Guid seq) The identifiers of the objects
plane : Plane
-
(Plane) Plane to which the bounding box should be aligned
?inWorldCoords : bool
-
(bool) Optional, default value: true
Returns the box as world coordinates or custom Plane coordinates.
Returns: Box
(Geometry.Box) The Box ,oriented to the Plane or in Plane coordinates.
It cannot be a Geometry.BoundingBox since it is not in World XY
To get the eight 3D points that define the bounding box call box.GetCorners()
Points returned in counter-clockwise order starting with the bottom rectangle of the box.
|
Returns a custom Plane axis-aligned bounding box of several objects.
|
Full Usage:
RhinoScriptSyntax.BoundingBox(object)
Parameters:
Guid
-
(Guid) The identifier of the object
Returns: BoundingBox
(Geometry.BoundingBox) The BoundingBox (oriented to the World XY Plane).
To get the eight 3D points that define the bounding box call box.GetCorners()
Points returned in counter-clockwise order starting with the bottom rectangle of the box.
|
Returns a world axis-aligned bounding box of one object.
|
Full Usage:
RhinoScriptSyntax.BoundingBox(objects)
Parameters:
Guid seq
-
(Guid seq) The identifiers of the objects
Returns: BoundingBox
(Geometry.BoundingBox) The BoundingBox (oriented to the World XY Plane).
To get the eight 3D points that define the bounding box call box.GetCorners()
Points returned in counter-clockwise order starting with the bottom rectangle of the box.
|
Returns a world axis-aligned bounding box of several objects.
|
Full Usage:
RhinoScriptSyntax.BoundingBox(geos)
Parameters:
'a seq
-
(GeometryBase seq) The geometries
Returns: BoundingBox
(Geometry.BoundingBox) The BoundingBox (oriented to the World XY Plane).
To get the eight 3D points that define the bounding box call box.GetCorners()
Points returned in counter-clockwise order starting with the bottom rectangle of the box.
Type parameters: 'a (requires :> Rhino.Geometry.GeometryBase) |
Returns a world axis-aligned bounding box of several geometry objects.
|
Full Usage:
RhinoScriptSyntax.BoundingBoxEstimate(object)
Parameters:
GeometryBase
-
(GeometryBase) Geometry to use directly.
Returns: BoundingBox
(Geometry.BoundingBox) The BoundingBox (oriented to the World XY Plane).
To get the eight 3D points that define the bounding box call box.GetCorners()
Points returned in counter-clockwise order starting with the bottom rectangle of the box.
|
Returns a world axis-aligned bounding box of one object. Estimated bounding boxes can be computed much (much) faster than accurate (or "tight") bounding boxes. Estimated bounding boxes are always similar to or larger than accurate bounding boxes.
|
Full Usage:
RhinoScriptSyntax.BoundingBoxEstimate(object)
Parameters:
Guid
-
(Guid) The identifier of the object
Returns: BoundingBox
(Geometry.BoundingBox) The BoundingBox (oriented to the World XY Plane).
To get the eight 3D points that define the bounding box call box.GetCorners()
Points returned in counter-clockwise order starting with the bottom rectangle of the box.
|
Returns a world axis-aligned bounding box of one object. Estimated bounding boxes can be computed much (much) faster than accurate (or "tight") bounding boxes. Estimated bounding boxes are always similar to or larger than accurate bounding boxes.
|
Full Usage:
RhinoScriptSyntax.BoundingBoxEstimate(objects)
Parameters:
Guid seq
-
(Guid seq) The identifiers of the objects
Returns: BoundingBox
(Geometry.BoundingBox) The BoundingBox (oriented to the World XY Plane).
To get the eight 3D points that define the bounding box call box.GetCorners()
Points returned in counter-clockwise order starting with the bottom rectangle of the box.
|
Returns a world axis-aligned bounding box of several objects. Estimated bounding boxes can be computed much (much) faster than accurate (or "tight") bounding boxes. Estimated bounding boxes are always similar to or larger than accurate bounding boxes.
|
Full Usage:
RhinoScriptSyntax.BoundingBoxEstimate(geometries)
Parameters:
'a seq
-
(GeometryBase seq) The Geometries of the objects
Returns: BoundingBox
(Geometry.BoundingBox) The BoundingBox (oriented to the World XY Plane).
To get the eight 3D points that define the bounding box call box.GetCorners()
Points returned in counter-clockwise order starting with the bottom rectangle of the box.
Type parameters: 'a (requires :> Rhino.Geometry.GeometryBase) |
Returns a world axis-aligned bounding box of several objects. Estimated bounding boxes can be computed much (much) faster than accurate (or "tight") bounding boxes. Estimated bounding boxes are always similar to or larger than accurate bounding boxes.
|
Full Usage:
RhinoScriptSyntax.BoundingBoxInflate(bbox, amountX, amountY, amountZ)
Parameters:
BoundingBox
-
(BoundingBox) Geometry.BoundingBox
amountX : float
-
(float) amount on X Axis in model units to expand
amountY : float
-
(float) amount on X Axis in model units to expand
amountZ : float
-
(float) amount on X Axis in model units to expand
Returns: BoundingBox
(Geometry.BoundingBox) The new Box.
|
Returns a new inflated box with custom x, y and z amounts in their directions. Inflating with negative amounts may result in decreasing and invalid boxes. This function raises an Exception if the resulting box is decreasing. InValid boxes can not be inflated.
|
Full Usage:
RhinoScriptSyntax.BoundingBoxInflate(bbox, amount)
Parameters:
BoundingBox
-
(BoundingBox) Geometry.BoundingBox
amount : float
-
(float) amount in model units to expand
Returns: BoundingBox
(Geometry.BoundingBox) The new Box.
|
Returns a new inflated the box with equal amounts in all directions. Inflating with negative amounts may result in decreasing and invalid boxes. This function raises an Exception if the resulting box is decreasing. Invalid boxes can not be inflated.
|
Full Usage:
RhinoScriptSyntax.BrepClosestPoint(geometryObject, point)
Parameters: Returns: Point3d * float * float * ComponentIndexType * int * Vector3d
(Point3d * float * float * ComponentIndexType * int * Vector3d) of closest point information . The list will
contain the following information:
Element Type Description
0 Point3d The 3-D point at the parameter value of the closest point.
1 (U of U, V) Parameter values of closest point.
Note, V is 0 if the component index type is brepEdge or brepVertex.
2 (V of U, V) Parameter values of closest point.
Note, V is 0 if the component index type is brepEdge or brepVertex.
3 (type, index) The type the brep component that contains the closest point. Possible types are
BrepVertex 1 Targets a brep vertex index.
BrepEdge 2 Targets a brep edge index.
BrepFace 3 Targets a brep face index.
BrepTrim 4 Targets a brep trim index.
BrepLoop 5 Targets a brep loop index.
4 int The index of the brep component
5 Vector3d The normal to the brepFace, or the tangent to the brepEdge.
|
Returns the point on a Surface or Polysurface that is closest to a test point. This function works on both untrimmed and trimmed Surfaces. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.BrepClosestPoint(objectId, point)
Parameters:
Guid
-
(Guid) The object's identifier
point : Point3d
-
(Point3d) The test, or sampling point
Returns: Point3d * float * float * ComponentIndexType * int * Vector3d
(Point3d * float * float * ComponentIndexType * int * Vector3d) of closest point information . The list will
contain the following information:
Element Type Description
0 Point3d The 3-D point at the parameter value of the closest point.
1 (U of U, V) Parameter values of closest point.
Note, V is 0 if the component index type is brepEdge or brepVertex.
2 (V of U, V) Parameter values of closest point.
Note, V is 0 if the component index type is brepEdge or brepVertex.
3 (type, index) The type the brep component that contains the closest point. Possible types are
BrepVertex 1 Targets a brep vertex index.
BrepEdge 2 Targets a brep edge index.
BrepFace 3 Targets a brep face index.
BrepTrim 4 Targets a brep trim index.
BrepLoop 5 Targets a brep loop index.
4 int The index of the brep component
5 Vector3d The normal to the brepFace, or the tangent to the brepEdge.
|
Returns the point on a Surface or Polysurface that is closest to a test point. This function works on both untrimmed and trimmed Surfaces.
|
Full Usage:
RhinoScriptSyntax.BrowseForFolder(?folder, ?message, ?title)
Parameters:
string
-
(string) Optional, a default folder
?message : string
-
(string) Optional, a prompt or message
?title : string
-
(string) Optional, a dialog box title
Returns: string
(string) Selected folder.
A RhinoUserInteractionException is raised if input is cancelled via Esc key.
|
Display browse-for-folder dialog allowing the user to select a folder.
|
Full Usage:
RhinoScriptSyntax.BuildDate()
Returns: DateTime
(DateTime) The build date of Rhino. Will be converted to a string by most functions.
|
Returns the build date of Rhino.
|
Full Usage:
RhinoScriptSyntax.CapPlanarHoles(surfaceId)
Parameters:
Guid
-
(Guid) The identifier of the Surface or Polysurface to cap
Returns: bool
(bool) True or False indicating success or failure.
|
Caps planar holes in a Surface or Polysurface.
|
Full Usage:
RhinoScriptSyntax.ChangeCurveDegree(curveId, degree)
Parameters:
Guid
-
(Guid) The object's identifier
degree : int
-
(int) The new degree
Returns: bool
(bool) True of False indicating success or failure.
|
Changes the degree of a Curve object. For more information see the Rhino help file for the ChangeDegree command.
|
Full Usage:
RhinoScriptSyntax.ChangeLayerName(currentLayerName, newLayerName, ?allowUnicode)
Parameters:
string
-
(string) The name an existing layer to rename
newLayerName : string
-
(string) The new name
?allowUnicode : bool
-
(bool) Optional, Allow ambiguous Unicode characters too
|
Changes the Name of a layer if than name is yet non existing. Fails if layer exists already. Currently only ASCII characters are allowed.
|
Full Usage:
RhinoScriptSyntax.ChangeSurfaceDegree(objectId, degree)
Parameters:
Guid
-
(Guid) The object's identifier
degree : int * int
-
(int * int) Two integers, specifying the degrees for the U V directions
Returns: bool
(bool) True of False indicating success or failure.
|
Raises the degree of a Surface object. Lowering a degree is not supported and returns false.
|
Full Usage:
RhinoScriptSyntax.CheckListBox(items, ?message, ?title)
Parameters:
(string * bool) seq
-
((string*bool) seq) A list of tuples containing a string and a boolean check state
?message : string
-
(string) Optional, a prompt or message
?title : string
-
(string) Optional, a dialog box title
Returns: ResizeArray<string * bool>
((string*bool) ResizeArray) Option of tuples containing the input string in items along with their new boolean check value.
A RhinoUserInteractionException is raised if input is cancelled via Esc key.
|
Displays a list of items in a checkable-style list dialog box.
|
Full Usage:
RhinoScriptSyntax.CircleCenterPlane(curveGeo, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a poly-curve
Returns: Plane
(Plane) The 3D Plane at the center point of the circle.
|
Returns the center Plane of a circle Curve object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CircleCenterPlane(curveId, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of a Curve object
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a poly-curve
Returns: Plane
(Plane) The 3D Plane at the center point of the circle.
|
|
|
|
Full Usage:
RhinoScriptSyntax.CircleCircumference(curveGeo, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a poly-curve
Returns: float
(float) The circumference of the circle.
|
Returns the circumference of a circle Curve object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CircleCircumference(curveId, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of a Curve object
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a poly-curve
Returns: float
(float) The circumference of the circle.
|
Returns the circumference of a circle Curve object.
|
Full Usage:
RhinoScriptSyntax.CircleRadius(curveGeo, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a poly-curve
Returns: float
(float) The radius of the circle.
|
Returns the radius of a circle Curve object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CircleRadius(curveId, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of a Curve object
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a poly-curve
Returns: float
(float) The radius of the circle.
|
Returns the radius of a circle Curve object.
|
Full Usage:
RhinoScriptSyntax.Clamp(minVal, maxVal, value)
Parameters:
float
-
(float) The lower bound.
maxVal : float
-
(float) The upper bound.
value : float
-
(float) The value to clamp.
Returns: float
(float) The clamped value.
|
Clamps a value between a lower and an upper bound.
|
Full Usage:
RhinoScriptSyntax.ClearCommandHistory()
|
Clears contents of Rhino's command history window. You can view the command history window by using the CommandHistory command in Rhino. |
Full Usage:
RhinoScriptSyntax.ClipboardText(text)
Parameters:
string
-
(string) Text to set
|
Sets a text string to the Windows clipboard.
|
Full Usage:
RhinoScriptSyntax.ClipboardText()
Returns: string
(string) The current text in the clipboard
or an empty string if the content of the clipboard is not a text
|
Gets the text string in the Windows clipboard.
|
Full Usage:
RhinoScriptSyntax.CloseCurve(curveGeo, ?tolerance)
Parameters:
Curve
-
(Curve) The input curve geometry.
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Maximum allowable distance between start and end point
Returns: Curve
(Curve) The resulting geometry; it is not added to a document.
|
Computes CloseCurve from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.CloseCurve(curveId, ?tolerance)
Parameters:
Guid
-
(Guid) Identifier of a Curve object
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Maximum allowable distance between start and end point
Returns: Guid
(Guid) ObjectId of the new Curve object.
|
Closes an open Curve object by making adjustments to the end points so they meet at a point.
|
Full Usage:
RhinoScriptSyntax.CloseToolbarCollection(name, ?prompt)
Parameters:
string
-
(string) Name of a currently open toolbar collection
?prompt : bool
-
(bool) Optional, default value: false
If True, user will be prompted to save the collection file
if it has been modified prior to closing
Returns: bool
(bool) True or False indicating success or failure.
|
Closes a currently open toolbar collection.
|
Full Usage:
RhinoScriptSyntax.ClosedCurveOrientation(curveGeo, ?direction)
Parameters:
Curve
-
(Curve) The input geometry.
?direction : Vector3d
-
(Vector3d) Optional, default value: Vector3d.ZAxis
3d vector that identifies up, or Z axs, direction of
the Plane to test against
Returns: int
(int) 1 if the Curve's orientation is counter-clockwise
-1 if the Curve's orientation is clockwise
0 if unable to compute the Curve's orientation.
|
Determine the orientation (counter-clockwise or clockwise) of a closed, planar Curve. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.ClosedCurveOrientation(curveId, ?direction)
Parameters:
Guid
-
(Guid) Identifier of a Curve object
?direction : Vector3d
-
(Vector3d) Optional, default value: Vector3d.ZAxis
3d vector that identifies up, or Z axs, direction of
the Plane to test against
Returns: int
(int) 1 if the Curve's orientation is counter-clockwise
-1 if the Curve's orientation is clockwise
0 if unable to compute the Curve's orientation.
|
Determine the orientation (counter-clockwise or clockwise) of a closed, planar Curve.
|
Full Usage:
RhinoScriptSyntax.Coerce2dPoint(x, y)
Parameters:
float
-
(float) The X coordinate.
y : float
-
(float) The Y coordinate.
Returns: Point2d
(Point2d) The 2D point.
|
Converts two floats into a Rhino.Geometry.Point2d.
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.Coerce3dPoint(pointObject)
Parameters:
PointObject
-
(DocObjects.PointObject) The point object.
Returns: Point3d
(Point3d) The location of the point. Raises a RhinoScriptingException if the PointObject is null.
|
Gets the location of a PointObject.
|
|
|
Full Usage:
RhinoScriptSyntax.Coerce3dPoint(point)
Parameters:
string
-
(string) Three numbers separated by commas, like "1, 2, 3",
or by semicolons if the decimal separator is a comma, like "1,5; 2,5; 3,5".
Returns: Point3d
(Point3d) The point. Raises a RhinoScriptingException if the string can not be parsed.
|
Parses a string into a Rhino.Geometry.Point3d.
|
Full Usage:
RhinoScriptSyntax.Coerce3dPoint(xyz)
Parameters:
float seq
-
(float seq) The X, Y and Z coordinates.
Returns: Point3d
(Point3d) The point. Raises a RhinoScriptingException if the sequence is null or does not have exactly three items.
|
Converts a sequence of exactly three floats into a Rhino.Geometry.Point3d.
|
Full Usage:
RhinoScriptSyntax.Coerce3dPoint(x, y, z)
Parameters:
float
-
(float) The X coordinate.
y : float
-
(float) The Y coordinate.
z : float
-
(float) The Z coordinate.
Returns: Point3d
(Point3d) The point.
|
Converts three floats into a Rhino.Geometry.Point3d.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.Coerce3dVector(lineId)
Parameters:
Guid
-
(Guid) The identifier of a curve object that is linear within the current Documents Absolute Tolerance.
Returns: Vector3d
(Vector3d) The direction of the line, its length is the length of the line.
Raises a RhinoScriptingException if the object does not exist, is not a curve, or is not linear.
|
Gets the direction of a linear curve object in the document, from its start to its end point.
|
Full Usage:
RhinoScriptSyntax.Coerce3dVector(vector)
Parameters:
string
-
(string) Three numbers separated by commas, like "1, 2, 3",
or by semicolons if the decimal separator is a comma, like "1,5; 2,5; 3,5".
Returns: Vector3d
(Vector3d) The vector. Raises a RhinoScriptingException if the string can not be parsed.
|
Parses a string into a Rhino.Geometry.Vector3d.
|
Full Usage:
RhinoScriptSyntax.Coerce3dVector(xyz)
Parameters:
float seq
-
(float seq) The X, Y and Z components.
Returns: Vector3d
(Vector3d) The vector. Raises a RhinoScriptingException if the sequence is null or does not have exactly three items.
|
Converts a sequence of exactly three floats into a Rhino.Geometry.Vector3d.
|
Full Usage:
RhinoScriptSyntax.Coerce3dVector(x, y, z)
Parameters:
float
-
(float) The X component.
y : float
-
(float) The Y component.
z : float
-
(float) The Z component.
Returns: Vector3d
(Vector3d) The vector.
|
Converts three floats into a Rhino.Geometry.Vector3d.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.CoerceAnnotation(objectId)
Parameters:
Guid
-
(Guid) objectId of annotation object
Returns: AnnotationObjectBase
(DocObjects.AnnotationObjectBase. Raises a RhinoScriptingException if coerce failed.
|
Attempt to get Rhino Annotation Base Object.
|
|
Gets an Arc from a curve object using the current Documents Absolute Tolerance. Does not return circles as arcs.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.CoerceBlockInstanceObject(objectId)
Parameters:
Guid
-
(Guid) Id of block instance
Returns: InstanceObject
(DocObjects.InstanceObject) block instance object.
|
Returns the Rhino Block instance object for a given Id.
|
|
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.CoerceColor(color)
Parameters:
string
-
(string) A color name like "Red", or a hex string like "#FF0000".
Returns: Color
(Drawing.Color) The color in ARGB form (not as named color) this will provide better comparison to other colors.
For example the named color Red is not equal to fromRGB(255, 0, 0). Raises a RhinoScriptingException if the string can not be parsed.
|
Parses a System.Drawing.Color from a string, also works on natural language color strings, see Drawing.ColorTranslator.FromHtml.
|
Full Usage:
RhinoScriptSyntax.CoerceColor(red, green, blue, alpha)
Parameters:
int
-
(int) Red value from 0 to 255.
green : int
-
(int) Green value from 0 to 255.
blue : int
-
(int) Blue value from 0 to 255.
alpha : int
-
(int) Alpha value from 0 (transparent) to 255 (opaque).
Returns: Color
(Drawing.Color) The color in ARGB form (not as named color).
Raises a RhinoScriptingException if a value is not between 0 and 255.
|
Creates a System.Drawing.Color from red, green, blue and alpha values. Like in RhinoPython, alpha is the last argument, not the first one as in Drawing.Color.FromArgb.
|
Full Usage:
RhinoScriptSyntax.CoerceColor(red, green, blue)
Parameters:
int
-
(int) Red value from 0 to 255.
green : int
-
(int) Green value from 0 to 255.
blue : int
-
(int) Blue value from 0 to 255.
Returns: Color
(Drawing.Color) The opaque color in ARGB form (not as named color).
Raises a RhinoScriptingException if a value is not between 0 and 255.
|
Creates a System.Drawing.Color from red, green and blue values.
|
|
Converts a System.Drawing.Color into its ARGB form, so that it is not a named color any more.
|
Full Usage:
RhinoScriptSyntax.CoerceCurve(objectId, ?segmentIndex)
Parameters:
Guid
-
objectId (Guid or string) to be RhinoScriptSyntax.Coerced into a Curve
?segmentIndex : int
-
(int) Optional, index of segment to retrieve. To ignore segmentIndex give -1 as argument
Returns: Curve
(Rhino.Geometry.Curve. Raises a RhinoScriptingException if coerce failed.
|
Attempt to get Curve geometry from the document with a given objectId.
|
Full Usage:
RhinoScriptSyntax.CoerceDetailView(objectId)
Parameters:
Guid
-
(Guid) objectId of Detail object
Returns: DetailView
A Geometry.DetailView. Raises a RhinoScriptingException if coerce failed.
|
Attempt to get Detail view rectangle Geometry.
|
Full Usage:
RhinoScriptSyntax.CoerceDetailViewObject(objectId)
Parameters:
Guid
-
(Guid) objectId of Detail object
Returns: DetailViewObject
A DocObjects.DetailViewObject. Raises a RhinoScriptingException if coerce failed.
|
Attempt to get Detail view rectangle Object.
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.CoerceGeometry(objectId)
Parameters:
Guid
-
(Guid) geometry Identifier
Returns: GeometryBase
(Rhino.Geometry.GeometryBase. Raises a RhinoScriptingException if coerce failed.
|
Attempt to get GeometryBase from a given input.
|
|
|
Full Usage:
RhinoScriptSyntax.CoerceGuid(rhinoObject)
Parameters:
RhinoObject
-
(DocObjects.RhinoObject) The RhinoObject.
Returns: Guid
(Guid) The Guid of the RhinoObject. Raises a RhinoScriptingException if the RhinoObject is null.
|
Gets the Guid of a RhinoObject.
|
Full Usage:
RhinoScriptSyntax.CoerceGuid(input)
Parameters:
string
-
(string) The Guid as a string.
Returns: Guid
(Guid) The Guid. Raises a RhinoScriptingException if the string is not a Guid or is the empty Guid.
|
Parses a Guid from a string.
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.CoerceHatchObject(objectId)
Parameters:
Guid
-
(Guid) objectId of Hatch object
Returns: HatchObject
(DocObjects.HatchObject. Raises a RhinoScriptingException if coerce failed.
|
Attempt to get Rhino Hatch Object.
|
|
|
Full Usage:
RhinoScriptSyntax.CoerceLayer(name)
Parameters:
string
-
(string) The layer's name.
Returns: Layer
DocObjects.Layer
|
Attempt to get Rhino LayerObject from the document for a given full name.
|
Full Usage:
RhinoScriptSyntax.CoerceLeader(objectId)
Parameters:
Guid
-
(Guid) objectId of Leader object
Returns: LeaderObject
(DocObjects.LeaderObject. Raises a RhinoScriptingException if coerce failed.
|
Attempt to get Rhino Leader Annotation Object.
|
|
|
|
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.CoerceLinearDimension(objectId)
Parameters:
Guid
-
(Guid) objectId of LinearDimension object
Returns: LinearDimensionObject
(DocObjects.LinearDimensionObject. Raises a RhinoScriptingException if coerce failed.
|
Attempt to get Rhino LinearDimension Annotation Object.
|
|
|
Full Usage:
RhinoScriptSyntax.CoerceNurbsSurface(objectId)
Parameters:
Guid
-
the object's Identifier
Returns: NurbsSurface
(Rhino.Geometry.Surface. Raises a RhinoScriptingException if coerce failed.
|
Attempt to get Surface geometry from the document with a given objectId.
|
Full Usage:
RhinoScriptSyntax.CoercePageView(pageName)
Parameters:
string
-
(string) The name of the Layout.
Returns: RhinoPageView
(Display.RhinoPageView) The page view. Raises a RhinoScriptingException if the name is null, or if not exactly one Layout has this name.
|
Gets a Rhino Page (or Layout) View from the name of the Layout.
|
Full Usage:
RhinoScriptSyntax.CoercePageView(viewId)
Parameters:
Guid
-
(Guid) The Guid of the page view.
Returns: RhinoPageView
(Display.RhinoPageView) The page view. Raises a RhinoScriptingException if no view has this Guid or if the view is not a page view.
|
Gets a Rhino Page (or Layout) View from its Guid.
|
Full Usage:
RhinoScriptSyntax.CoercePlane(x, y, z)
Parameters:
float
-
(float) The X coordinate of the origin.
y : float
-
(float) The Y coordinate of the origin.
z : float
-
(float) The Z coordinate of the origin.
Returns: Plane
(Plane) A plane with the axes of the World XY plane.
|
Creates a Plane parallel to the World XY plane at the given origin.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.CoercePointCloud(objectId)
Parameters:
Guid
-
(Guid) objectId of PointCloud object
Returns: PointCloud
A Geometry.PointCloud. Raises a RhinoScriptingException if coerce failed.
|
Attempt to get Rhino PointCloud Geometry.
|
Full Usage:
RhinoScriptSyntax.CoercePointObject(objectId)
Parameters:
Guid
-
(Guid) objectId of Point object
Returns: PointObject
A DocObjects.PointObject, Raises a RhinoScriptingException if coerce failed.
|
Attempt to get Rhino Point Object.
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.CoerceRhinoObject(objectId)
Parameters:
Guid
-
(Guid) Object identifier.
Returns: RhinoObject
A RhinoObject. Raises a RhinoScriptingException if coercion failed.
|
Attempt to get a RhinoObject from the document with a given objectId.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.CoerceTextEntity(objectId)
Parameters:
Guid
-
(Guid) objectId of TextEntity object
Returns: TextEntity
A Geometry.TextEntity. Raises a RhinoScriptingException if coerce failed.
|
Attempt to get TextEntity Geometry (for the text Object use rs.CoerceTextObject) .
|
Full Usage:
RhinoScriptSyntax.CoerceTextObject(objectId)
Parameters:
Guid
-
(Guid) objectId of TextObject
Returns: TextObject
(DocObjects.TextObject. Raises a RhinoScriptingException if coerce failed.
|
Attempt to get Rhino TextObject Annotation Object.
|
Full Usage:
RhinoScriptSyntax.CoerceView(viewName)
Parameters:
string
-
(string) The name of the view.
Returns: RhinoView
(Display.RhinoView) The view. Raises a RhinoScriptingException if the name is null or no view has this name.
|
Gets a Rhino View from its name, it can be a standard or page view.
|
|
|
Full Usage:
RhinoScriptSyntax.CoerceXform(xForm)
Parameters:
float[,]
-
(float[,]) The matrix as a 2D array, the first index is the row.
Smaller or larger matrices are not accepted.
Returns: Transform
(Transform) The transformation matrix. Raises a RhinoScriptingException if the input is not a 4x4 matrix.
|
Converts a 4x4 matrix of floats into a Rhino.Geometry.Transform Transformation Matrix.
|
Full Usage:
RhinoScriptSyntax.CoerceXform(xForm)
Parameters:
'a seq
-
(float seq seq) The matrix given row by row, for example as a list of lists or an array of arrays.
Smaller or larger matrices are not accepted.
Returns: Transform
(Transform) The transformation matrix. Raises a RhinoScriptingException if the input is not a 4x4 matrix.
Type parameters: 'a (requires :> Microsoft.FSharp.Core.float Microsoft.FSharp.Collections.seq) |
Converts a 4x4 matrix of floats into a Rhino.Geometry.Transform Transformation Matrix.
|
|
|
Full Usage:
RhinoScriptSyntax.CollapseLayer(layerName, ?childrenToo)
Parameters:
string
-
(string) full or short layer name
?childrenToo : bool
-
(bool) Optional, default value: false
'true' to collapse any child layers too.
'false' to not change the parents layers collapse state.(default)
|
Collapse a layer in UI if it has children. This is the opposite of rs.ExpandLayer(..)
|
Full Usage:
RhinoScriptSyntax.ColorAdjustLuma(rgb, luminance, ?isScaleRelative)
Parameters:
Color
-
(Drawing.Color) Initial rgb value
luminance : float
-
(float) The luminance in units of 0.1 percent of the total range. A
value of luminance = 50 corresponds to 5 percent of the maximum luminance
?isScaleRelative : bool
-
(bool) Optional, default value: false
If True, luminance specifies how much to increment or decrement the
current luminance. If False, luminance specified the absolute luminance
Returns: Color
(Drawing.Color) modified rgb value.
|
Changes the luminance of a red-green-blue value. Hue and saturation are not affected.
|
Full Usage:
RhinoScriptSyntax.ColorBlueValue(rgb)
Parameters:
Color
-
(Drawing.Color) The RGB color value
Returns: int
(int) The blue component.
|
Retrieves intensity value for the blue component of an RGB color.
|
Full Usage:
RhinoScriptSyntax.ColorGreenValue(rgb)
Parameters:
Color
-
(Drawing.Color) The RGB color value
Returns: int
(int) The green component.
|
Retrieves intensity value for the green component of an RGB color.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.ColorRedValue(rgb)
Parameters:
Color
-
(Drawing.Color) The RGB color value
Returns: int
(int) The red color value.
|
Retrieves intensity value for the red component of an RGB color.
|
Full Usage:
RhinoScriptSyntax.ComboListBox(items, ?message, ?title)
Parameters:
string seq
-
(string seq) A list of string
?message : string
-
(string) Optional, A prompt of message
?title : string
-
(string) Optional, A dialog box title
Returns: string
(string) Option of The selected item.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Displays a list of items in a combo-style list box dialog.
|
Full Usage:
RhinoScriptSyntax.Command(commandString, ?echo)
Parameters:
string
-
(string) A Rhino command including any arguments
?echo : bool
-
(bool) Optional, default value: true
The default command echo mode true will display the commands on the commandline.
If the command echo mode is set to false the command prompts will not be printed to the Rhino command line.
Returns: bool
(bool) True or False indicating success or failure.
|
Runs a Rhino command macro / script. All Rhino commands can be used in command scripts. The command can be a built-in Rhino command or one provided by a 3rd party plug-in. Write command scripts just as you would type the command sequence at the Commandline. A space or a new line acts like pressing 'Enter' at the Commandline. For more information, see "Scripting" in Rhino help. Note, this function is designed to run one command and one command only. Do not combine multiple Rhino commands into a single call to this method. WRONG:
CORRECT:
Also, the exclamation point and space character ( ! ) combination used by
button macros and batch-driven scripts to cancel the previous command is
not valid.
WRONG:
CORRECT:
In a normal command, when the user enters a command beginning with a '!' , the command exits.
There is no documented way to get this behavior from within a script command.
After the command script has run, you can obtain the identifiers of most
recently created or changed object by calling
.
Warning: This kind of command can be very dangerous. Please be sure you understand the following: If you are not very familiar with how references work, you should only call Rhino.RhinoApp.RunScript() from within a RhinoScriptCommand derived command. If you are very familiar with references, then please observe the following rules: If you get a reference or pointer to any part of the Rhino run-time database, this reference or pointer will not be valid after you call Rhino.RhinoApp.RunScript(). If you get a reference or a pointer, then call Rhino.RhinoApp.RunScript(), and then use the reference, Rhino will probably crash. All pointers and references used by the command should be scoped such that they are only valid for the time between calls to Rhino.RhinoApp.RunScript(). This is because Rhino.RhinoApp.RunScript() can change the dynamic arrays in the run-time database. The result is that all pointers and references become invalid. Be sure to scope your variables between Rhino.RhinoApp.RunScript() calls. Never allow references and pointers from one section to be used in another section.
|
Full Usage:
RhinoScriptSyntax.CommandHistory()
Returns: string
(string) The contents of Rhino's command history window.
|
Returns the contents of Rhino's command history window.
|
Full Usage:
RhinoScriptSyntax.CompareGeometry(first, second)
Parameters:
GeometryBase
-
(GeometryBase) Geometry to use directly.
second : GeometryBase
-
(GeometryBase) Geometry to use directly.
Returns: bool
(bool) True if the objects are geometrically identical, otherwise False.
|
Compares two objects to determine if they are geometrically identical.
|
|
|
Full Usage:
RhinoScriptSyntax.ContextIsGrasshopper()
Returns: bool
(bool) True if the script is being executed in a Grasshopper component.
|
Return true if the script is being executed in a Grasshopper component. Unlike in RhinoPython there is no host that sets a flag (scriptcontext.id). Instead this checks if the call stack of the current thread contains a method from the Grasshopper assembly. So it returns false for code that runs on another thread than the one of the Grasshopper component, or after an await in an async method.
|
Full Usage:
RhinoScriptSyntax.ContextIsRhino()
Returns: bool
|
Return true if the script is being executed in the context of Rhino (Rhino.Runtime.HostUtils.RunningInRhino).
|
Full Usage:
RhinoScriptSyntax.ConvertCurveToPolyline(curveGeo, ?angleToleranceDegrees, ?tolerance, ?minEdgeLength, ?maxEdgeLength)
Parameters:
Curve
-
(Curve) The input curve geometry.
?angleToleranceDegrees : float
-
(float) Optional, default value: 0.0
The maximum angle in degrees between Curve tangents at line endpoints; 0.0 uses 5.0 degrees.
?tolerance : float
-
(float) Optional, default value: 0.01
The distance tolerance at segment midpoints.
?minEdgeLength : float
-
(float) Optional, Minimum segment length
?maxEdgeLength : float
-
(float) Optional, Maximum segment length
Returns: PolylineCurve
(PolylineCurve) The resulting geometry; it is not added to a document.
|
Computes ConvertCurveToPolyline from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.ConvertCurveToPolyline(curveId, ?angleToleranceDegrees, ?tolerance, ?deleteInput, ?minEdgeLength, ?maxEdgeLength)
Parameters:
Guid
-
(Guid) Identifier of a Curve object
?angleToleranceDegrees : float
-
(float) Optional, default value: 0.0
The maximum angle in degrees between Curve tangents at line endpoints; 0.0 uses 5.0 degrees.
?tolerance : float
-
(float) Optional, default value: 0.01
The distance tolerance at segment midpoints.
?deleteInput : bool
-
(bool) Optional, default value: false
Delete the Curve object specified by CurveId. If omitted, CurveId will not be deleted
?minEdgeLength : float
-
(float) Optional, Minimum segment length
?maxEdgeLength : float
-
(float) Optional, Maximum segment length
Returns: Guid
(Guid) The new Curve.
|
Convert Curve to a Polyline Curve.
|
Full Usage:
RhinoScriptSyntax.CopyMaterial(sourceIndex, destinationIndex)
Parameters:
int
-
(int) Source index of material to copy.
destinationIndex : int
-
(int) Destination index of material to copy to.
Returns: bool
(bool) True or False indicating success or failure.
|
Copies the definition of a source material to a destination material. The same in-range index succeeds without changing the material.
|
Full Usage:
RhinoScriptSyntax.CopyObject(geometry, ?translation)
Parameters:
GeometryBase
-
(GeometryBase) Input geometry to duplicate and transform.
?translation : Vector3d
-
(Vector3d) Optional, additional translation vector to apply
Returns: GeometryBase
(GeometryBase) The transformed geometry duplicate.
|
Returns a transformed duplicate of the input geometry. The input is unchanged and the result is not added to a document.
|
|
Copies an object from one location to another, or in-place. The copy of a grouped object is put into a new group. The original is left unchanged and the copy is added to the document. The geometry overload returns a transformed duplicate instead and does not touch the document.
|
Full Usage:
RhinoScriptSyntax.CopyObjects(geometries, ?translation)
Parameters:
GeometryBase seq
-
(GeometryBase seq) Input geometry to duplicate and transform.
?translation : Vector3d
-
(Vector3d) Optional, translation vector to apply to copied set
Returns: ResizeArray<GeometryBase>
(GeometryBase ResizeArray) The transformed geometry duplicates.
|
Returns transformed duplicates of the input geometries. The input is unchanged and the result is not added to a document.
|
|
Copies one or more objects from one location to another, or in-place. Copies of grouped objects are put into new groups. The originals are left unchanged and the copies are added to the document. The geometry overload returns transformed duplicates instead and does not touch the document.
|
Full Usage:
RhinoScriptSyntax.CreateColor(red, green, blue)
Parameters:
byte
-
(byte) Red Value
green : byte
-
(byte) Green value
blue : byte
-
(byte) Blue value
Returns: Color
(System.Drawing.Color) a Color.
|
Creates a RGB color from red, green and blue values as Bytes.
|
Full Usage:
RhinoScriptSyntax.CreateColor(red, green, blue)
Parameters:
int
-
(int) Red Value between 0 and 255
green : int
-
(int) Green value between 0 and 255
blue : int
-
(int) Blue value between 0 and 255
Returns: Color
(System.Drawing.Color) a Color.
|
Creates a RGB color from red, green and blue values as Integers. Raise an exception if values are out of range
|
Full Usage:
RhinoScriptSyntax.CreateInterval(start, ende)
Parameters:
float
-
(float) Start of interval
ende : float
-
(float) End of interval
Returns: Interval
(Rhino.Geometry.Interval) This can be seen as an object made of two items:
[0] start of interval
[1] end of interval.
|
Converts input into a Rhino.Geometry.Interval. This interval can be increasing or decreasing
|
Full Usage:
RhinoScriptSyntax.CreateNurbsCurve(points, knots, degree, ?weights)
Parameters:
Point3d seq
-
(Point3d seq) A list containing 3D control points.
knots : float seq
-
(float seq) Knot values for the Curve. The number of elements in knots must
equal the number of elements in points plus degree minus 1.
degree : int
-
(int) Degree of the Curve. must be greater than of equal to 1.
?weights : float
-
(float seq) Optional, Weight values for the Curve. Number of elements should
equal the number of elements in points. Values must be greater than 0.
Returns: NurbsCurve
(NurbsCurve) a NurbsCurve geometry.
|
Creates a NURBS Curve geometry, but does not add or draw it to the document.
|
Full Usage:
RhinoScriptSyntax.CreatePlane(origin, ?xAxis, ?yAxis)
Parameters:
Point3d
-
(Point3d) The Plane Center or Origin
?xAxis : Vector3d
-
(Vector3d) Optional, default value: Vector3d.XAxis
Direction of X-Axis
?yAxis : Vector3d
-
(Vector3d) Optional, default value: Vector3d.YAxis
Direction of Y-Axis
Returns: Plane
(Plane) A Rhino.Geometry.Plane.
|
Converts input into a Rhino.Geometry.Plane object if possible.
|
|
|
Full Usage:
RhinoScriptSyntax.CreatePoint(pointObject)
Parameters:
PointObject
-
(DocObjects.PointObject) The point object.
Returns: Point3d
(Point3d) The location of the point. Raises a RhinoScriptingException if the PointObject is null.
|
Gets the location of a PointObject.
|
|
|
Full Usage:
RhinoScriptSyntax.CreatePoint(point)
Parameters:
string
-
(string) Three numbers separated by commas, like "1, 2, 3",
or by semicolons if the decimal separator is a comma, like "1,5; 2,5; 3,5".
Returns: Point3d
(Point3d) The point. Raises a RhinoScriptingException if the string can not be parsed.
|
Parses a string into a Rhino.Geometry.Point3d.
|
Full Usage:
RhinoScriptSyntax.CreatePoint(xyz)
Parameters:
float seq
-
(float seq) The X, Y and Z coordinates.
Returns: Point3d
(Point3d) The point. Raises a RhinoScriptingException if the sequence is null or does not have exactly three items.
|
Converts a sequence of exactly three floats into a Rhino.Geometry.Point3d.
|
Full Usage:
RhinoScriptSyntax.CreatePoint(x, y, z)
Parameters:
float
-
(float) The X coordinate.
y : float
-
(float) The Y coordinate.
z : float
-
(float) The Z coordinate.
Returns: Point3d
(Point3d) The point.
|
Converts x, y and z into a Rhino.Geometry.Point3d.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.CreatePreviewImage(fileName, ?view, ?width, ?height, ?flags, ?wireframe)
Parameters:
string
-
(string) Name of the bitmap file to create.
?view : string
-
(string) Optional. Title of the view. If omitted, the active view is used.
?width : int
-
(int) Optional, default value: 0. Integer that specifies the width of the bitmap in pixels. If only width is given, height will be scaled to keep screen ratio.
?height : int
-
(int) Optional, default value: 0. Integer that specifies the height of the bitmap in pixels. If only height is given, width will be scaled to keep screen ratio.
?flags : int
-
(int) Optional, default value: 0. Bitmap creation flags. Can be a combination of:
1 = honor object highlighting
2 = draw construction plane
4 = use ghosted shading
?wireframe : bool
-
(bool) Optional, default value: false. If True, then a wireframe preview image. If False, a rendered image will be created.
Returns: bool
(bool) True or False indicating success or failure.
|
Creates a bitmap preview image of the current model.
|
Full Usage:
RhinoScriptSyntax.CreateVector(lineId)
Parameters:
Guid
-
(Guid) The identifier of a curve object that is linear within the current Documents Absolute Tolerance.
Returns: Vector3d
(Vector3d) The direction of the line, its length is the length of the line.
Raises a RhinoScriptingException if the object does not exist, is not a curve, or is not linear.
|
Gets the direction of a linear curve object in the document, from its start to its end point.
|
Full Usage:
RhinoScriptSyntax.CreateVector(vector)
Parameters:
string
-
(string) Three numbers separated by commas, like "1, 2, 3",
or by semicolons if the decimal separator is a comma, like "1,5; 2,5; 3,5".
Returns: Vector3d
(Vector3d) The vector. Raises a RhinoScriptingException if the string can not be parsed.
|
Parses a string into a Rhino.Geometry.Vector3d.
|
Full Usage:
RhinoScriptSyntax.CreateVector(xyz)
Parameters:
float seq
-
(float seq) The X, Y and Z components.
Returns: Vector3d
(Vector3d) The vector. Raises a RhinoScriptingException if the sequence is null or does not have exactly three items.
|
Converts a sequence of exactly three floats into a Rhino.Geometry.Vector3d.
|
Full Usage:
RhinoScriptSyntax.CreateVector(x, y, z)
Parameters:
float
-
(float) The X component.
y : float
-
(float) The Y component.
z : float
-
(float) The Z component.
Returns: Vector3d
(Vector3d) The vector.
|
Converts x, y and z into a Rhino.Geometry.Vector3d.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.CreateXform(xForm)
Parameters:
'a seq
-
(float seq seq) The transform. This can be seen as a 4x4 matrix, given row by row as nested lists or arrays
Returns: Transform
(Transform) A Rhino.Geometry.Transform. result[0, 3] gives access to the first row, last column.
Type parameters: 'a (requires :> Microsoft.FSharp.Core.float Microsoft.FSharp.Collections.seq) |
Converts input into a Rhino.Geometry.Transform object if possible.
|
Full Usage:
RhinoScriptSyntax.CullDuplicateNumbers(numbers, ?tolerance)
Parameters:
float seq
-
(float seq) List of Doubles
?tolerance : float
-
(float) Optional, default value: RhinoMath.ZeroTolerance
The minimum distance between numbers. Numbers that fall within this tolerance will be discarded
Returns: ResizeArray<float>
(float ResizeArray) numbers with duplicates removed.
|
Removes duplicates from an array of numbers.
|
Full Usage:
RhinoScriptSyntax.CullDuplicatePoints(points, ?tolerance)
Parameters:
Point3d seq
-
(Point3d seq) A list of 3D points
?tolerance : float
-
(float) Optional, default value: RhinoMath.ZeroTolerance Minimum distance between points.
Points within this tolerance will be discarded.
Returns: Point3d array
(Point3d array) Array of 3D points with duplicates removed.
|
Removes duplicates from a list of 3D points.
|
Full Usage:
RhinoScriptSyntax.CurrentDetail(layout, detail)
Parameters:
string
-
(string) Title of an existing page layout view
detail : string
-
(string) Title of the detail view to set
|
Changes the current detail view in a page layout view.
|
Full Usage:
RhinoScriptSyntax.CurrentDetail(layout)
Parameters:
string
-
(string) Title of an existing page layout view
Returns: string
(string) The name of the current detail view, or an empty String if the Page view is the current view.
|
Returns the current detail view in a page layout view.
|
Full Usage:
RhinoScriptSyntax.CurrentDimStyle(dimStyleName)
Parameters:
string
-
(string) Name of an existing dimension style to make current
|
Changes the current default dimension style. Raise a RhinoScriptingException if the style does not exist.
|
Full Usage:
RhinoScriptSyntax.CurrentDimStyle()
Returns: string
(string) Name of the current dimension style.
|
Returns the current default dimension style.
|
Full Usage:
RhinoScriptSyntax.CurrentHatchPattern(hatchPattern)
Parameters:
string
-
(string) Name of an existing Hatch pattern to make current
|
Sets the current Hatch pattern file.
|
Full Usage:
RhinoScriptSyntax.CurrentHatchPattern()
Returns: string
(string) The current Hatch pattern.
|
Returns the current Hatch pattern file.
|
Full Usage:
RhinoScriptSyntax.CurrentLayer(layer)
Parameters:
string
-
(string) The name of an existing layer to make current
|
Changes the current layer.
|
Full Usage:
RhinoScriptSyntax.CurrentLayer()
Returns: string
(string) The full name of the current layer.
|
Returns the current layer.
|
Full Usage:
RhinoScriptSyntax.CurrentView(view)
Parameters:
string
-
(string) Title of the view to set current
|
Sets the currently active view.
|
Full Usage:
RhinoScriptSyntax.CurrentView()
Returns: string
(string) The title of the current view.
|
Returns the currently active view.
|
Full Usage:
RhinoScriptSyntax.CurveArcLengthPoint(curveGeo, length, ?fromStart)
Parameters:
Curve
-
(Curve) The input geometry.
length : float
-
(float) The arc length from the start of the Curve to evaluate
?fromStart : bool
-
(bool) Optional, default value: true
If not specified or True, then the arc length point is
calculated from the start of the Curve. If False, the arc length
point is calculated from the end of the Curve
Returns: Point3d
(Point3d) on Curve.
|
Returns the point on the Curve that is a specified arc length from the start of the Curve. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveArcLengthPoint(curveId, length, ?fromStart)
Parameters:
Guid
-
(Guid) Identifier of a Curve object
length : float
-
(float) The arc length from the start of the Curve to evaluate
?fromStart : bool
-
(bool) Optional, default value: true
If not specified or True, then the arc length point is
calculated from the start of the Curve. If False, the arc length
point is calculated from the end of the Curve
Returns: Point3d
(Point3d) on Curve.
|
Returns the point on the Curve that is a specified arc length from the start of the Curve.
|
Full Usage:
RhinoScriptSyntax.CurveArea(curveGeo)
Parameters:
Curve
-
(Curve) The input geometry.
Returns: float
(float) The area.
|
Returns area of closed planar Curves. The results are based on the current drawing units. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveArea(curveId)
Parameters:
Guid
-
(Guid) The identifier of a closed, planar Curve object
Returns: float
(float) The area.
|
Returns area of closed planar Curves. The results are based on the current drawing units.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.CurveArrows(curveIds, arrowStyle)
Parameters:
Guid seq
-
(Guid seq) Identifier of multiple Curve
arrowStyle : int
-
(int) The style of annotation arrow to be displayed.
0 = no arrows
1 = display arrow at start of Curve
2 = display arrow at end of Curve
3 = display arrow at both start and end of Curve
|
Enables or disables multiple Curve objects's annotation arrows.
|
Full Usage:
RhinoScriptSyntax.CurveArrows(curveId, arrowStyle)
Parameters:
Guid
-
(Guid) Identifier of a Curve
arrowStyle : int
-
(int) The style of annotation arrow to be displayed.
0 = no arrows
1 = display arrow at start of Curve
2 = display arrow at end of Curve
3 = display arrow at both start and end of Curve
|
Enables or disables a Curve object's annotation arrows.
|
Full Usage:
RhinoScriptSyntax.CurveArrows(curveId)
Parameters:
Guid
-
(Guid) Identifier of a Curve
Returns: int
(int) The current annotation arrow style
0 = no arrows
1 = display arrow at start of Curve
2 = display arrow at end of Curve
3 = display arrow at both start and end of Curve.
|
Get status of a Curve object's annotation arrows.
|
Full Usage:
RhinoScriptSyntax.CurveBooleanDifference(curveA, curveB, ?tolerance)
Parameters:
Curve
-
(Curve) The input geometry.
curveB : Curve
-
(Curve) The input geometry.
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
A positive tolerance value, or None for the doc default
Returns: ResizeArray<Curve>
(Curve ResizeArray) The resulting geometry; it is not added to a document.
|
Computes CurveBooleanDifference from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.CurveBooleanDifference(curveA, curveB, ?tolerance)
Parameters:
Guid
-
(Guid) Identifier of the first Curve object
curveB : Guid
-
(Guid) Identifier of the second Curve object
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
A positive tolerance value, or None for the doc default
Returns: ResizeArray<Guid>
(Guid ResizeArray) The identifiers of the new objects.
|
Calculates the difference between two closed, planar Curves and adds the results to the document. Note, Curves must be coplanar.
|
Full Usage:
RhinoScriptSyntax.CurveBooleanIntersection(curveA, curveB, ?tolerance)
Parameters:
Curve
-
(Curve) The input geometry.
curveB : Curve
-
(Curve) The input geometry.
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
A positive tolerance value, or None for the doc default
Returns: ResizeArray<Curve>
(Curve ResizeArray) The resulting geometry; it is not added to a document.
|
Computes CurveBooleanIntersection from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.CurveBooleanIntersection(curveA, curveB, ?tolerance)
Parameters:
Guid
-
(Guid) Identifier of the first Curve object
curveB : Guid
-
(Guid) Identifier of the second Curve object
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
A positive tolerance value, or None for the doc default
Returns: ResizeArray<Guid>
(Guid ResizeArray) The identifiers of the new objects.
|
Calculates the intersection of two closed, planar Curves and adds the results to the document. Note, Curves must be coplanar.
|
Full Usage:
RhinoScriptSyntax.CurveBooleanUnion(curveInputs, ?tolerance)
Parameters:
Curve seq
-
(Curve seq) The input objects.
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
A positive tolerance value, or None for the doc default
Returns: ResizeArray<Curve>
(Curve ResizeArray) The resulting geometry; it is not added to a document.
|
Computes CurveBooleanUnion from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.CurveBooleanUnion(curveIds, ?tolerance)
Parameters:
Guid seq
-
(Guid seq) List of two or more close planar Curves identifiers
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
A positive tolerance value, or None for the doc default
Returns: ResizeArray<Guid>
(Guid ResizeArray) The identifiers of the new objects.
|
Calculate the union of two or more closed, planar Curves and add the results to the document. Note, Curves must be coplanar.
|
Full Usage:
RhinoScriptSyntax.CurveBrepIntersect(curveGeo, brepInput, ?tolerance)
Parameters:
Curve
-
(Curve) The input geometry.
brepInput : Brep
-
(Brep) The input geometry.
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Distance tolerance at segment midpoints.
Returns: ResizeArray<Point3d> * ResizeArray<Curve>
(Point3d ResizeArray * Curve ResizeArray) List of points and List of Curves.
|
Intersects a Curve object with a brep object. Note, unlike the CurveSurfaceIntersection function, this function works on trimmed Surfaces. Uses the supplied geometry directly. |
Full Usage:
RhinoScriptSyntax.CurveBrepIntersect(curveId, brepId, ?tolerance)
Parameters:
Guid
-
(Guid) Identifier of a Curve object
brepId : Guid
-
(Guid) Identifier of a brep object
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Distance tolerance at segment midpoints.
Returns: ResizeArray<Point3d> * ResizeArray<Curve>
(Point3d ResizeArray * Curve ResizeArray) List of points and List of Curves.
|
Intersects a Curve object with a brep object. Note, unlike the CurveSurfaceIntersection function, this function works on trimmed Surfaces. |
Full Usage:
RhinoScriptSyntax.CurveClosestObject(curveGeo, objectInputs)
Parameters:
Curve
-
(Curve) The input geometry.
objectInputs : GeometryBase seq
-
(GeometryBase seq) The input objects.
Returns: GeometryBase * Point3d * Point3d
(GeometryBase * Point3d * Point3d) The resulting geometry; it is not added to a document.
|
Computes CurveClosestObject from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.CurveClosestObject(curveId, objectIds)
Parameters:
Guid
-
(Guid) Identifier of the Curve object to test
objectIds : Guid seq
-
(Guid seq) List of identifiers of point cloud, Curve, Surface, or
Polysurface to test against
Returns: Guid * Point3d * Point3d
(Guid * Point3d * Point3d) containing the results of the closest point calculation.
The elements are as follows:
[0] The identifier of the closest object.
[1] The 3-D point that is closest to the closest object.
[2] The 3-D point that is closest to the test Curve.
|
Returns the 3D point locations on two objects where they are closest to each other. Note, this function provides similar functionality to that of Rhino's ClosestPt command. |
|
|
Full Usage:
RhinoScriptSyntax.CurveClosestParameter(curveGeo, point, segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
point : Point3d
-
(Point3d) Sampling point
segmentIndex : int
-
(int) Optional,
Curve segment index if `curveId` identifies a Polycurve
Returns: float
(float) The parameter of the closest point on the Curve.
|
Returns parameter of the point on a Curve that is closest to a test point. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveClosestParameter(curveId, point, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of a Curve object
point : Point3d
-
(Point3d) Sampling point
?segmentIndex : int
-
(int) Optional,
Curve segment index if `curveId` identifies a Polycurve
Returns: float
(float) The parameter of the closest point on the Curve.
|
Returns parameter of the point on a Curve that is closest to a test point.
|
|
|
Full Usage:
RhinoScriptSyntax.CurveClosestPoint(curveGeo, point, segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
point : Point3d
-
(Point3d) Sampling point
segmentIndex : int
-
(int) Optional,
Curve segment index if `curveId` identifies a Polycurve
Returns: Point3d
(Point3d) The closest point on the Curve.
|
Returns the point on a Curve that is closest to a test point. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveClosestPoint(curveId, point, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of a Curve object
point : Point3d
-
(Point3d) Sampling point
?segmentIndex : int
-
(int) Optional,
Curve segment index if `curveId` identifies a Polycurve
Returns: Point3d
(Point3d) The closest point on the Curve.
|
Returns the point on a Curve that is closest to a test point.
|
Full Usage:
RhinoScriptSyntax.CurveContourPoints(curveGeo, startPoint, endPoint, interval)
Parameters:
Curve
-
(Curve) The input geometry.
startPoint : Point3d
-
(Point3d) 3D starting point of a center line
endPoint : Point3d
-
(Point3d) 3D ending point of a center line
interval : float
-
(float) The distance between contour Curves
Returns: Point3d array
(Point3d array) A list of 3D points, one for each contour.
|
Returns the 3D point locations calculated by contouring a Curve object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveContourPoints(curveId, startPoint, endPoint, interval)
Parameters:
Guid
-
(Guid) Identifier of a Curve object
startPoint : Point3d
-
(Point3d) 3D starting point of a center line
endPoint : Point3d
-
(Point3d) 3D ending point of a center line
interval : float
-
(float) The distance between contour Curves
Returns: Point3d array
(Point3d array) A list of 3D points, one for each contour.
|
Returns the 3D point locations calculated by contouring a Curve object.
|
Full Usage:
RhinoScriptSyntax.CurveCurvature(curveGeo, parameter)
Parameters:
Curve
-
(Curve) The input geometry.
parameter : float
-
(float) Parameter to evaluate
Returns: Point3d * Vector3d * Point3d * float * Vector3d
(Point3d * Vector3d * Point3d * float * Vector3d) of curvature information
[0] = point at specified parameter
[1] = tangent vector
[2] = center of radius of curvature
[3] = radius of curvature
[4] = curvature vector.
|
Returns the curvature of a Curve at a parameter. See the Rhino help for details on Curve curvature. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveCurvature(curveId, parameter)
Parameters:
Guid
-
(Guid) Identifier of the Curve
parameter : float
-
(float) Parameter to evaluate
Returns: Point3d * Vector3d * Point3d * float * Vector3d
(Point3d * Vector3d * Point3d * float * Vector3d) of curvature information
[0] = point at specified parameter
[1] = tangent vector
[2] = center of radius of curvature
[3] = radius of curvature
[4] = curvature vector.
|
Returns the curvature of a Curve at a parameter. See the Rhino help for details on Curve curvature.
|
Full Usage:
RhinoScriptSyntax.CurveCurveIntersection(curveA, ?curveB, ?tolerance)
Parameters:
Curve
-
(Curve) The input geometry.
?curveB : Curve
-
(Curve) Optional, default value: null. The second curve.
If omitted, or if it is the same Curve object as curveA, then a self-intersection test will be performed on curveA
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Absolute tolerance in drawing units. If omitted,
the document's current absolute tolerance is used
Returns: ResizeArray<int * Point3d * Point3d * Point3d * Point3d * float * float * float * float>
( a ResizeArray of int*Point3d*Point3d*Point3d*Point3d*float*float*float*float)
List of tuples: containing intersection information .
The list will contain one or more of the following elements:
Element Type Description
[n][0] Number The intersection event type, either Point (1) or Overlap (2).
[n][1] Point3d If the event type is Point (1), then the intersection point
on the first Curve. If the event type is Overlap (2), then
intersection start point on the first Curve.
[n][2] Point3d If the event type is Point (1), then the intersection point
on the first Curve. If the event type is Overlap (2), then
intersection end point on the first Curve.
[n][3] Point3d If the event type is Point (1), then the intersection point
on the second Curve. If the event type is Overlap (2), then
intersection start point on the second Curve.
[n][4] Point3d If the event type is Point (1), then the intersection point
on the second Curve. If the event type is Overlap (2), then
intersection end point on the second Curve.
[n][5] Number If the event type is Point (1), then the first Curve parameter.
If the event type is Overlap (2), then the start value of the
first Curve parameter range.
[n][6] Number If the event type is Point (1), then the first Curve parameter.
If the event type is Overlap (2), then the end value of the
first Curve parameter range.
[n][7] Number If the event type is Point (1), then the second Curve parameter.
If the event type is Overlap (2), then the start value of the
second Curve parameter range.
[n][8] Number If the event type is Point (1), then the second Curve parameter.
If the event type is Overlap (2), then the end value of the
second Curve parameter range.
|
Calculates intersection of two Curve objects. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveCurveIntersection(curveA, ?curveB, ?tolerance)
Parameters:
Guid
-
(Guid) Identifier of the first Curve object
?curveB : Guid
-
(Guid) Optional, Identifier of the second Curve object. If omitted, then a
self-intersection test will be performed on CurveA
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Absolute tolerance in drawing units. If omitted,
the document's current absolute tolerance is used
Returns: ResizeArray<int * Point3d * Point3d * Point3d * Point3d * float * float * float * float>
( a ResizeArray of int*Point3d*Point3d*Point3d*Point3d*float*float*float*float)
List of tuples: containing intersection information .
The list will contain one or more of the following elements:
Element Type Description
[n][0] Number The intersection event type, either Point (1) or Overlap (2).
[n][1] Point3d If the event type is Point (1), then the intersection point
on the first Curve. If the event type is Overlap (2), then
intersection start point on the first Curve.
[n][2] Point3d If the event type is Point (1), then the intersection point
on the first Curve. If the event type is Overlap (2), then
intersection end point on the first Curve.
[n][3] Point3d If the event type is Point (1), then the intersection point
on the second Curve. If the event type is Overlap (2), then
intersection start point on the second Curve.
[n][4] Point3d If the event type is Point (1), then the intersection point
on the second Curve. If the event type is Overlap (2), then
intersection end point on the second Curve.
[n][5] Number If the event type is Point (1), then the first Curve parameter.
If the event type is Overlap (2), then the start value of the
first Curve parameter range.
[n][6] Number If the event type is Point (1), then the first Curve parameter.
If the event type is Overlap (2), then the end value of the
first Curve parameter range.
[n][7] Number If the event type is Point (1), then the second Curve parameter.
If the event type is Overlap (2), then the start value of the
second Curve parameter range.
[n][8] Number If the event type is Point (1), then the second Curve parameter.
If the event type is Overlap (2), then the end value of the
second Curve parameter range.
|
Calculates intersection of two Curve objects.
|
Full Usage:
RhinoScriptSyntax.CurveDegree(curveGeo, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: int
(int) The degree of the Curve.
|
Returns the degree of a Curve object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveDegree(curveId, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of a Curve object
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: int
(int) The degree of the Curve.
|
Returns the degree of a Curve object.
|
Full Usage:
RhinoScriptSyntax.CurveDeviation(curveA, curveB)
Parameters: Returns: float * float * float * float * float * float
(float * float * float * float * float * float) of deviation information
[0] = CurveA parameter at maximum overlap distance point
[1] = CurveB parameter at maximum overlap distance point
[2] = maximum overlap distance
[3] = CurveA parameter at minimum overlap distance point
[4] = CurveB parameter at minimum overlap distance point
[5] = minimum distance between Curves.
|
Returns the minimum and maximum deviation between two Curve objects. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveDeviation(curveA, curveB)
Parameters: Returns: float * float * float * float * float * float
(float * float * float * float * float * float) of deviation information
[0] = CurveA parameter at maximum overlap distance point
[1] = CurveB parameter at maximum overlap distance point
[2] = maximum overlap distance
[3] = CurveA parameter at minimum overlap distance point
[4] = CurveB parameter at minimum overlap distance point
[5] = minimum distance between Curves.
|
Returns the minimum and maximum deviation between two Curve objects.
|
Full Usage:
RhinoScriptSyntax.CurveDim(curveGeo, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
?segmentIndex : int
-
(int) Optional,
The Curve segment if CurveId identifies a PolyCurve
Returns: int
(int) The dimension of the Curve .
|
Returns the dimension of a Curve object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveDim(curveId, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of a Curve object
?segmentIndex : int
-
(int) Optional,
The Curve segment if CurveId identifies a PolyCurve
Returns: int
(int) The dimension of the Curve .
|
Returns the dimension of a Curve object.
|
Full Usage:
RhinoScriptSyntax.CurveDirection(curveGeo, ?allowNonLinear, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
?allowNonLinear : bool
-
(bool) Optional, allow non linear Curves, Default Value False
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: Vector3d
(Vector3d) The direction of the Curve.
|
Returns the average unitized direction of a Curve object between start and end point, Optionally allows non linear Curves too. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveDirection(curveId, ?allowNonLinear, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?allowNonLinear : bool
-
(bool) Optional, allow non linear Curves, Default Value False
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: Vector3d
(Vector3d) The direction of the Curve.
|
Returns the average unitized direction of a Curve object between start and end point, Optionally allows non linear Curves too.
|
|
Tests if two Curve objects are generally in the same direction or if they would be more in the same direction if one of them were flipped. When testing Curve directions, both Curves must be either open or closed - you cannot test one open Curve and one closed Curve. Uses the supplied geometry directly.
|
|
Tests if two Curve objects are generally in the same direction or if they would be more in the same direction if one of them were flipped. When testing Curve directions, both Curves must be either open or closed - you cannot test one open Curve and one closed Curve.
|
Full Usage:
RhinoScriptSyntax.CurveDiscontinuity(curveGeo, style)
Parameters:
Curve
-
(Curve) The input geometry.
style : int
-
(int) The type of continuity to test for. The types of
continuity are as follows:
Value Description
1 C0 - Continuous function
2 C1 - Continuous first derivative
3 C2 - Continuous first and second derivative
4 G1 - Continuous unit tangent
5 G2 - Continuous unit tangent and curvature
Returns: ResizeArray<Point3d>
(Point3d ResizeArray) 3D points where the Curve is discontinuous.
|
Search for a derivative, tangent, or curvature discontinuity in a Curve object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveDiscontinuity(curveId, style)
Parameters:
Guid
-
(Guid) Identifier of Curve object
style : int
-
(int) The type of continuity to test for. The types of
continuity are as follows:
Value Description
1 C0 - Continuous function
2 C1 - Continuous first derivative
3 C2 - Continuous first and second derivative
4 G1 - Continuous unit tangent
5 G2 - Continuous unit tangent and curvature
Returns: ResizeArray<Point3d>
(Point3d ResizeArray) 3D points where the Curve is discontinuous.
|
Search for a derivative, tangent, or curvature discontinuity in a Curve object.
|
|
Returns the domain of a Curve object as an indexable object with two elements. Uses the supplied geometry directly.
|
|
|
Full Usage:
RhinoScriptSyntax.CurveEditParameters(curveGeo, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
?segmentIndex : int
-
(int) Optional, The Curve segment index is `curveId` identifies a PolyCurve
Returns: float[]
(Collections.Point3dList) A list of Curve parameters
|
Returns the Edit-, or Greville-Parameters of a Curve object. For each Curve control point, there is a corresponding edit point parameter. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveEditParameters(curveId, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?segmentIndex : int
-
(int) Optional, The Curve segment index is `curveId` identifies a PolyCurve
Returns: float[]
(Collections.Point3dList) A list of Curve parameters
|
Returns the Edit-, or Greville-Parameters of a Curve object. For each Curve control point, there is a corresponding edit point parameter.
|
Full Usage:
RhinoScriptSyntax.CurveEditPoints(curveGeo, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
?segmentIndex : int
-
(int) Optional, The Curve segment index is `curveId` identifies a PolyCurve
Returns: Point3dList
(Collections.Point3dList) Curve edit points.
|
Returns the Edit-, or Greville-Points of a Curve object. For each Curve control point, there is a corresponding edit point. see rs.CurveEditParameters for parameters, not points Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveEditPoints(curveId, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?segmentIndex : int
-
(int) Optional, The Curve segment index is `curveId` identifies a PolyCurve
Returns: Point3dList
(Collections.Point3dList) Curve edit points.
|
Returns the Edit-, or Greville-Points of a Curve object. For each Curve control point, there is a corresponding edit point. see rs.CurveEditParameters for parameters, not points
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.CurveEndTangent(curveGeo, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: Vector3d
(Vector3d) The tangent, same as Curve.TangentAtEnd property .
|
Returns the tangent at end point of a Curve object pointing away from the Curve . Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveEndTangent(curveId, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: Vector3d
(Vector3d) The tangent, same as Curve.TangentAtEnd property .
|
Returns the tangent at end point of a Curve object pointing away from the Curve .
|
Full Usage:
RhinoScriptSyntax.CurveFilletPoints(curveA, curveB, ?radius, ?basePointA, ?basePointB)
Parameters:
Curve
-
(Curve) The input geometry.
curveB : Curve
-
(Curve) The input geometry.
?radius : float
-
(float) Optional, default value: 1.0. The fillet radius.
?basePointA : Point3d
-
(Point3d) Optional. The base point on the first Curve.
If omitted, the starting point of the Curve is used
?basePointB : Point3d
-
(Point3d) Optional. The base point on the second Curve. If omitted,
the starting point of the Curve is used
Returns: Point3d * Point3d * Plane
(Point3d * Point3d * Plane)
. The list elements are as follows:
[0] A point on the first Curve at which to cut (point).
[1] A point on the second Curve at which to cut (point).
[2] The fillet Plane.
|
Find points at which to cut a pair of Curves so that a fillet of a specified radius fits. A fillet point is a pair of points (point0, point1) such that there is a circle of radius tangent to Curve Curve0 at point0 and tangent to Curve Curve1 at point1. Of all possible fillet points, this function returns the one which is the closest to the base point basePointA, basePointB. Distance from the base point is measured by the sum of arc lengths along the two Curves. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveFilletPoints(curveA, curveB, ?radius, ?basePointA, ?basePointB)
Parameters:
Guid
-
(Guid) Identifier of the first Curve object
curveB : Guid
-
(Guid) Identifier of the second Curve object
?radius : float
-
(float) Optional, default value: 1.0. The fillet radius.
?basePointA : Point3d
-
(Point3d) Optional. The base point on the first Curve.
If omitted, the starting point of the Curve is used
?basePointB : Point3d
-
(Point3d) Optional. The base point on the second Curve. If omitted,
the starting point of the Curve is used
Returns: Point3d * Point3d * Plane
(Point3d * Point3d * Plane)
. The list elements are as follows:
[0] A point on the first Curve at which to cut (point).
[1] A point on the second Curve at which to cut (point).
[2] The fillet Plane.
|
Find points at which to cut a pair of Curves so that a fillet of a specified radius fits. A fillet point is a pair of points (point0, point1) such that there is a circle of radius tangent to Curve Curve0 at point0 and tangent to Curve Curve1 at point1. Of all possible fillet points, this function returns the one which is the closest to the base point basePointA, basePointB. Distance from the base point is measured by the sum of arc lengths along the two Curves.
|
Full Usage:
RhinoScriptSyntax.CurveFrame(curveGeo, parameter, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
parameter : float
-
(float) Parameter to evaluate
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: Plane
(Plane) The Plane at the specified parameter.
|
Returns the Plane at a parameter of a Curve. The Plane is based on the tangent and curvature vectors at a parameter. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveFrame(curveId, parameter, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
parameter : float
-
(float) Parameter to evaluate
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: Plane
(Plane) The Plane at the specified parameter.
|
Returns the Plane at a parameter of a Curve. The Plane is based on the tangent and curvature vectors at a parameter.
|
Full Usage:
RhinoScriptSyntax.CurveKnotCount(curveGeo, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
?segmentIndex : int
-
(int) Optional, The Curve segment if `curveId` identifies a PolyCurve
Returns: int
(int) The number of knots.
|
Returns the knot count of a Curve object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveKnotCount(curveId, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?segmentIndex : int
-
(int) Optional, The Curve segment if `curveId` identifies a PolyCurve
Returns: int
(int) The number of knots.
|
Returns the knot count of a Curve object.
|
Full Usage:
RhinoScriptSyntax.CurveKnots(curveGeo, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: ResizeArray<float>
(float ResizeArray) knot values.
|
Returns the knots, or knot vector, of a Curve object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveKnots(curveId, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: ResizeArray<float>
(float ResizeArray) knot values.
|
Returns the knots, or knot vector, of a Curve object.
|
Full Usage:
RhinoScriptSyntax.CurveLength(curveGeo, ?segmentIndex, ?subDomain)
Parameters:
Curve
-
(Curve) The input geometry.
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
?subDomain : Interval
-
(Interval) Optional, List of two numbers identifying the sub-domain of the
Curve on which the calculation will be performed. The two parameters
(sub-domain) must be non-decreasing. If omitted, the length of the
entire Curve is returned
Returns: float
(float) The length of the Curve.
|
Returns the length of a Curve object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveLength(curveId, ?segmentIndex, ?subDomain)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
?subDomain : Interval
-
(Interval) Optional, List of two numbers identifying the sub-domain of the
Curve on which the calculation will be performed. The two parameters
(sub-domain) must be non-decreasing. If omitted, the length of the
entire Curve is returned
Returns: float
(float) The length of the Curve.
|
Returns the length of a Curve object.
|
|
Returns the 3D point locations on the Curve and finite line where they are closest to each other. Note, this function provides similar functionality to that of Rhino's ClosestPt command. Uses the supplied geometry directly. |
|
Returns the 3D point locations on the Curve and finite line where they are closest to each other. Note, this function provides similar functionality to that of Rhino's ClosestPt command. |
Full Usage:
RhinoScriptSyntax.CurveMeshIntersection(curve, mesh)
Parameters: Returns: Point3d array * int array
(Point3d array * int array) two arrays as tuple:
[0] = point of intersection
[1] = Mesh face index where intersection lies.
|
|
Full Usage:
RhinoScriptSyntax.CurveMeshIntersection(curveId, meshId)
Parameters:
Guid
-
(Guid) Identifier of a Curve object
meshId : Guid
-
(Guid) Identifier or a Mesh object
Returns: Point3d array * int array
(Point3d array * int array) two arrays as tuple:
[0] = point of intersection
[1] = Mesh face index where intersection lies.
|
Calculates the intersection of a Curve object and a Mesh object.
|
|
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.CurveNormalizedParameter(curveGeo, parameter)
Parameters:
Curve
-
(Curve) The input geometry.
parameter : float
-
(float) The Curve parameter to convert
Returns: float
(float) normalized Curve parameter.
|
Converts a Curve parameter to a normalized Curve parameter; one that ranges between 0-1. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveNormalizedParameter(curveId, parameter)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
parameter : float
-
(float) The Curve parameter to convert
Returns: float
(float) normalized Curve parameter.
|
Converts a Curve parameter to a normalized Curve parameter; one that ranges between 0-1.
|
Full Usage:
RhinoScriptSyntax.CurveParameter(curveGeo, parameter)
Parameters:
Curve
-
(Curve) The input geometry.
parameter : float
-
(float) The normalized Curve parameter to convert
Returns: float
(float) Curve parameter.
|
Converts a normalized Curve parameter to a Curve parameter; one within the Curve's domain. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveParameter(curveId, parameter)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
parameter : float
-
(float) The normalized Curve parameter to convert
Returns: float
(float) Curve parameter.
|
Converts a normalized Curve parameter to a Curve parameter; one within the Curve's domain.
|
|
|
|
|
|
Returns the Plane in which a planar Curve lies. Note, this function works only on planar Curves. Uses the supplied geometry directly.
|
|
Returns the Plane in which a planar Curve lies. Note, this function works only on planar Curves.
|
Full Usage:
RhinoScriptSyntax.CurvePointCount(curveGeo, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
?segmentIndex : int
-
(int) Optional, The Curve segment if `curveId` identifies a PolyCurve
Returns: int
(int) Number of control points.
|
Returns the control points count of a Curve object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurvePointCount(curveId, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?segmentIndex : int
-
(int) Optional, The Curve segment if `curveId` identifies a PolyCurve
Returns: int
(int) Number of control points.
|
Returns the control points count of a Curve object.
|
Full Usage:
RhinoScriptSyntax.CurvePoints(curveGeo, segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
segmentIndex : int
-
(int) The Curve segment if `curveId` identifies a PolyCurve
Returns: ResizeArray<Point3d>
(Point3d ResizeArray) The control points, or control vertices, of a Curve object.
|
Returns the control points, or control vertices, of a Curve object. If the Curve is a rational NURBS Curve, the euclidean control vertices are returned. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurvePoints(curveId, ?segmentIndex)
Parameters:
Guid
-
(Guid) The object's identifier
?segmentIndex : int
-
(int) Optional, The Curve segment if `curveId` identifies a PolyCurve
Returns: ResizeArray<Point3d>
(Point3d ResizeArray) The control points, or control vertices, of a Curve object.
|
Returns the control points, or control vertices, of a Curve object. If the Curve is a rational NURBS Curve, the euclidean control vertices are returned.
|
|
Returns the control points, or control vertices, of a Curve object. If the Curve is a rational NURBS Curve, the euclidean control vertices are returned.
|
Full Usage:
RhinoScriptSyntax.CurveRadius(curveGeo, testPoint, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
testPoint : Point3d
-
(Point3d) Sampling point
?segmentIndex : int
-
(int) Optional, The Curve segment if CurveId identifies a PolyCurve
Returns: float
(float) The radius of curvature at the point on the Curve.
|
Returns the radius of curvature at a point on a Curve. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveRadius(curveId, testPoint, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
testPoint : Point3d
-
(Point3d) Sampling point
?segmentIndex : int
-
(int) Optional, The Curve segment if CurveId identifies a PolyCurve
Returns: float
(float) The radius of curvature at the point on the Curve.
|
Returns the radius of curvature at a point on a Curve.
|
Full Usage:
RhinoScriptSyntax.CurveSeam(curveId, parameter)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
parameter : float
-
(float) The parameter of the new start/end point.
Note, if successful, the resulting Curve's
domain will start at `parameter`
Returns: bool
(bool) True or False indicating success or failure.
|
Adjusts the seam, or start/end, point of a closed Curve.
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.CurveStartTangent(curveGeo, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: Vector3d
(Vector3d) The tangent, same as Curve.TangentAtStart property .
|
Returns the tangent at start point of a Curve object pointing in direction of the Curve . Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveStartTangent(curveId, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: Vector3d
(Vector3d) The tangent, same as Curve.TangentAtStart property .
|
Returns the tangent at start point of a Curve object pointing in direction of the Curve .
|
Full Usage:
RhinoScriptSyntax.CurveSurfaceIntersection(curveGeo, surfaceGeo, ?tolerance, ?angleToleranceDegrees)
Parameters:
Curve
-
(Curve) The input geometry.
surfaceGeo : Surface
-
(Surface) The input geometry.
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
The absolute tolerance in drawing units.
?angleToleranceDegrees : float
-
(float) Optional, default value: 0.0
Angle tolerance in degrees; 0.0 uses the document angle tolerance. The angle
tolerance is used to determine when the Curve is tangent to the
Surface.
Returns: ResizeArray<int * Point3d * Point3d * Point3d * Point3d * float * float * float * float * float * float>
(ResizeArray of int*Point3d*Point3d*Point3d*Point3d*float*float*float*float) of intersection information .
The list will contain one or more of the following elements:
Element Type Description
[n][0] Number The intersection event type, either Point(1) or Overlap(2).
[n][1] Point3d If the event type is Point(1), then the intersection point
on the first Curve. If the event type is Overlap(2), then
intersection start point on the first Curve.
[n][2] Point3d If the event type is Point(1), then the intersection point
on the first Curve. If the event type is Overlap(2), then
intersection end point on the first Curve.
[n][3] Point3d If the event type is Point(1), then the intersection point
on the second Curve. If the event type is Overlap(2), then
intersection start point on the Surface.
[n][4] Point3d If the event type is Point(1), then the intersection point
on the second Curve. If the event type is Overlap(2), then
intersection end point on the Surface.
[n][5] Number If the event type is Point(1), then the first Curve parameter.
If the event type is Overlap(2), then the start value of the
first Curve parameter range.
[n][6] Number If the event type is Point(1), then the first Curve parameter.
If the event type is Overlap(2), then the end value of the
Curve parameter range.
[n][7] Number If the event type is Point(1), then the U Surface parameter.
If the event type is Overlap(2), then the U Surface parameter
for Curve at (n, 5).
[n][8] Number If the event type is Point(1), then the V Surface parameter.
If the event type is Overlap(2), then the V Surface parameter
for Curve at (n, 5).
[n][9] Number If the event type is Point(1), then the U Surface parameter.
If the event type is Overlap(2), then the U Surface parameter
for Curve at (n, 6).
[n][10] Number If the event type is Point(1), then the V Surface parameter.
If the event type is Overlap(2), then the V Surface parameter
for Curve at (n, 6).
|
Calculates intersection of a Curve object with a Surface object. Note, this function works on the untrimmed portion of the Surface. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveSurfaceIntersection(curveId, surfaceId, ?tolerance, ?angleToleranceDegrees)
Parameters:
Guid
-
(Guid) The identifier of the first Curve object
surfaceId : Guid
-
(Guid) The identifier of the second Curve object. If omitted,
the a self-intersection test will be performed on Curve
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
The absolute tolerance in drawing units.
?angleToleranceDegrees : float
-
(float) Optional, default value: 0.0
Angle tolerance in degrees; 0.0 uses the document angle tolerance. The angle
tolerance is used to determine when the Curve is tangent to the
Surface.
Returns: ResizeArray<int * Point3d * Point3d * Point3d * Point3d * float * float * float * float * float * float>
(ResizeArray of int*Point3d*Point3d*Point3d*Point3d*float*float*float*float) of intersection information .
The list will contain one or more of the following elements:
Element Type Description
[n][0] Number The intersection event type, either Point(1) or Overlap(2).
[n][1] Point3d If the event type is Point(1), then the intersection point
on the first Curve. If the event type is Overlap(2), then
intersection start point on the first Curve.
[n][2] Point3d If the event type is Point(1), then the intersection point
on the first Curve. If the event type is Overlap(2), then
intersection end point on the first Curve.
[n][3] Point3d If the event type is Point(1), then the intersection point
on the second Curve. If the event type is Overlap(2), then
intersection start point on the Surface.
[n][4] Point3d If the event type is Point(1), then the intersection point
on the second Curve. If the event type is Overlap(2), then
intersection end point on the Surface.
[n][5] Number If the event type is Point(1), then the first Curve parameter.
If the event type is Overlap(2), then the start value of the
first Curve parameter range.
[n][6] Number If the event type is Point(1), then the first Curve parameter.
If the event type is Overlap(2), then the end value of the
Curve parameter range.
[n][7] Number If the event type is Point(1), then the U Surface parameter.
If the event type is Overlap(2), then the U Surface parameter
for Curve at (n, 5).
[n][8] Number If the event type is Point(1), then the V Surface parameter.
If the event type is Overlap(2), then the V Surface parameter
for Curve at (n, 5).
[n][9] Number If the event type is Point(1), then the U Surface parameter.
If the event type is Overlap(2), then the U Surface parameter
for Curve at (n, 6).
[n][10] Number If the event type is Point(1), then the V Surface parameter.
If the event type is Overlap(2), then the V Surface parameter
for Curve at (n, 6).
|
Calculates intersection of a Curve object with a Surface object. Note, this function works on the untrimmed portion of the Surface.
|
Full Usage:
RhinoScriptSyntax.CurveTangent(curveGeo, parameter, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
parameter : float
-
(float) Parameter to evaluate
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: Vector3d
(Vector3d) A 3D vector.
|
Returns a 3D vector that is the tangent to a Curve at a parameter. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveTangent(curveId, parameter, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
parameter : float
-
(float) Parameter to evaluate
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: Vector3d
(Vector3d) A 3D vector.
|
Returns a 3D vector that is the tangent to a Curve at a parameter.
|
Full Usage:
RhinoScriptSyntax.CurveWeights(curveGeo, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: ResizeArray<float>
(float ResizeArray) The weight values of the Curve.
|
Returns list of weights that are assigned to the control points of a Curve. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.CurveWeights(curveId, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: ResizeArray<float>
(float ResizeArray) The weight values of the Curve.
|
Returns list of weights that are assigned to the control points of a Curve.
|
Full Usage:
RhinoScriptSyntax.DefaultRenderer(rendererId)
Parameters:
Guid
-
(Guid) The Guid of the renderer plug-in to set as default renderer
Returns: bool
(bool) True or False indicating success or failure.
|
Changes the default render plug-in.
|
Full Usage:
RhinoScriptSyntax.DefaultRenderer(renderer)
Parameters:
string
-
(string) The name of the renderer to set as default renderer
Returns: bool
(bool) True or False indicating success or failure.
|
Changes the default render plug-in.
|
Full Usage:
RhinoScriptSyntax.DefaultRenderer()
Returns: string
(string) Name of default renderer.
|
Returns the default render plug-in.
|
Full Usage:
RhinoScriptSyntax.DeleteAlias(alias)
Parameters:
string
-
(string) The name of an existing alias
Returns: bool
(bool) True or False indicating success or failure.
|
Delete an existing alias from Rhino.
|
Full Usage:
RhinoScriptSyntax.DeleteBlock(blockName)
Parameters:
string
-
(string) Name of an existing block definition
Returns: bool
(bool) True or False indicating success or failure.
|
Deletes a block definition and all of it's inserted instances.
|
Full Usage:
RhinoScriptSyntax.DeleteDimStyle(dimStyleName)
Parameters:
string
-
(string) The name of an unreferenced dimension style
|
Removes an existing dimension style from the document. The dimension style to be removed cannot be referenced by any dimension objects.
|
Full Usage:
RhinoScriptSyntax.DeleteDocumentData(?section, ?entry)
Parameters:
string
-
(string) Optional, Section name. If omitted, all sections and their corresponding entries are removed
?entry : string
-
(string) Optional, Entry name. If omitted, all entries for section are removed
|
Removes user data strings from the current document.
|
Full Usage:
RhinoScriptSyntax.DeleteDocumentUserText(key)
Parameters:
string
-
(string) Key name to delete
|
Removes user text stored in the document.
|
Full Usage:
RhinoScriptSyntax.DeleteGroup(groupName)
Parameters:
string
-
(string) The name of an existing group.
|
Removes an existing group from the document. Reference groups cannot be removed. Deleting a group does not delete the member objects.
|
Full Usage:
RhinoScriptSyntax.DeleteLayer(layer)
Parameters:
string
-
(string) The name of an existing empty layer
Returns: bool
(bool) True or False indicating success or failure.
|
Removes an existing layer from the document. The layer to be removed cannot be the current layer. Unlike the PurgeLayer method, the layer must be empty, or contain no objects, before it can be removed. Any layers that are children of the specified layer will also be removed if they are also empty.
|
Full Usage:
RhinoScriptSyntax.DeleteNamedCPlane(name)
Parameters:
string
-
(string) Name of the construction Plane to remove
Returns: bool
(bool) True or False indicating success or failure.
|
Removes a named construction Plane from the document.
|
Full Usage:
RhinoScriptSyntax.DeleteNamedView(name)
Parameters:
string
-
(string) Name of the named view to remove
Returns: bool
(bool) True or False indicating success or failure.
|
Removes a named view from the document.
|
Full Usage:
RhinoScriptSyntax.DeleteObject(objectId)
Parameters:
Guid
-
(Guid) Identifier of object to delete
|
Deletes a single object from the document.
|
Full Usage:
RhinoScriptSyntax.DeleteObjects(objectIds)
Parameters:
Guid seq
-
(Guid seq) Identifiers of objects to delete
|
Deletes one or more objects from the document, Fails if not all objects can be deleted.
|
Full Usage:
RhinoScriptSyntax.DeleteSearchPath(folder)
Parameters:
string
-
(string) A folder to remove
Returns: bool
(bool) True or False indicating success or failure.
|
Removes existing path from Rhino's search path list. Search path items can be removed manually by using Rhino's options command and modifying the contents of the Files tab.
|
Full Usage:
RhinoScriptSyntax.DeleteUserText(objectIds, key, ?attachToGeometry)
Parameters:
Guid seq
-
(Guid seq) The object identifiers
key : string
-
(string) The key name to delete
?attachToGeometry : bool
-
(bool) Optional, default value: false Location on the object to delete the user text from
|
Removes user text stored on multiple objects. If the key exists.
|
Full Usage:
RhinoScriptSyntax.DeleteUserText(objectId, key, ?attachToGeometry)
Parameters:
Guid
-
(Guid) The object's identifier
key : string
-
(string) The key name to delete
?attachToGeometry : bool
-
(bool) Optional, default value: false Location on the object to delete the user text from
|
Removes user text stored on an object. If the key exists.
|
Full Usage:
RhinoScriptSyntax.DetailLock(detailGeo)
Parameters:
DetailView
-
(DetailView) The detail geometry to query.
Returns: bool
(bool) The current detail projection locked state.
|
Returns the projection locked state of a detail view-port rectangle.
|
Full Usage:
RhinoScriptSyntax.DetailLock(detailId, lock)
Parameters:
Guid
-
(Guid) Identifier of a detail object
lock : bool
-
(bool) The new lock state
|
Modifies the projection locked state of a detail.
|
Full Usage:
RhinoScriptSyntax.DetailLock(detailId)
Parameters:
Guid
-
(Guid) Identifier of a detail rectangle object
Returns: bool
(bool) The current detail projection locked state.
|
Returns the projection locked state of a detail view-port rectangle.
|
Full Usage:
RhinoScriptSyntax.DetailScale(detailGeo)
Parameters:
DetailView
-
(DetailView) The detail geometry to query.
Returns: float
(float) The current page to model scale ratio.
|
Returns the scale of a detail geometry object.
|
Full Usage:
RhinoScriptSyntax.DetailScale(detailId, modelLength, pageLength)
Parameters:
Guid
-
(Guid) Identifier of a detail object
modelLength : float
-
(float) A length in the current model units
pageLength : float
-
(float) A length in the current page units
|
Modifies the scale of a detail object.
|
Full Usage:
RhinoScriptSyntax.DetailScale(detailId)
Parameters:
Guid
-
(Guid) Identifier of a detail object
Returns: float
(float) current page to model scale ratio if model Length and page Length are both None.
|
Returns the scale of a detail object.
|
Full Usage:
RhinoScriptSyntax.DimStyleAnglePrecision(dimStyle, precision)
Parameters:
string
-
(string) The name of an existing dimension style
precision : int
-
(int) The new angle precision value.
|
Changes the angle display precision of a dimension style.
|
Full Usage:
RhinoScriptSyntax.DimStyleAnglePrecision(dimStyle)
Parameters:
string
-
(string) The name of an existing dimension style
Returns: int
(int) The current angle precision.
|
Returns the angle display precision of a dimension style.
|
Full Usage:
RhinoScriptSyntax.DimStyleArrowSize(dimStyle, size)
Parameters:
string
-
(string) The name of an existing dimension style
size : float
-
(float) The new arrow size
|
Changes the arrow size of a dimension style.
|
Full Usage:
RhinoScriptSyntax.DimStyleArrowSize(dimStyle)
Parameters:
string
-
(string) The name of an existing dimension style
Returns: float
(float) The current arrow size.
|
Returns the arrow size of a dimension style.
|
Full Usage:
RhinoScriptSyntax.DimStyleAvailableFonts()
Returns: string array
(string array) array of all available font names.
|
Gets all Available Font Face Names.
|
Full Usage:
RhinoScriptSyntax.DimStyleCount()
Returns: int
(int) The number of dimension styles in the document.
|
Returns the number of dimension styles in the document.
|
Full Usage:
RhinoScriptSyntax.DimStyleExtension(dimStyle, extension)
Parameters:
string
-
(string) The name of an existing dimension style
extension : float
-
(float) The new extension line extension
|
Changes the extension line extension of a dimension style.
|
Full Usage:
RhinoScriptSyntax.DimStyleExtension(dimStyle)
Parameters:
string
-
(string) The name of an existing dimension style
Returns: float
(float) The current extension line extension.
|
Returns the extension line extension of a dimension style.
|
Full Usage:
RhinoScriptSyntax.DimStyleFont(dimStyle, font)
Parameters:
string
-
(string) The name of an existing dimension style
font : string
-
(string) The new font quartet name
|
Changes the font used by a dimension style.
|
Full Usage:
RhinoScriptSyntax.DimStyleFont(dimStyle)
Parameters:
string
-
(string) The name of an existing dimension style
Returns: string
(string) The current font.
|
Returns the font used by a dimension style.
|
Full Usage:
RhinoScriptSyntax.DimStyleLeaderArrowSize(dimStyle, size)
Parameters:
string
-
(string) The name of an existing dimension style
size : float
-
(float) The new leader arrow size
|
Changes the leader arrow size of a dimension style.
|
Full Usage:
RhinoScriptSyntax.DimStyleLeaderArrowSize(dimStyle)
Parameters:
string
-
(string) The name of an existing dimension style
Returns: float
(float) The current leader arrow size.
|
Returns the leader arrow size of a dimension style.
|
Full Usage:
RhinoScriptSyntax.DimStyleLengthFactor(dimStyle, factor)
Parameters:
string
-
(string) The name of an existing dimension style
factor : float
-
(float) The new length factor
|
Changes the length factor of a dimension style. Length factor is the conversion between Rhino units and dimension units.
|
Full Usage:
RhinoScriptSyntax.DimStyleLengthFactor(dimStyle)
Parameters:
string
-
(string) The name of an existing dimension style
Returns: float
(float) if factor is not defined, the current length factor.
|
Returns the length factor of a dimension style. Length factor is the conversion between Rhino units and dimension units.
|
Full Usage:
RhinoScriptSyntax.DimStyleLinearPrecision(dimStyle, precision)
Parameters:
string
-
(string) The name of an existing dimension style
precision : int
-
(int) The new linear precision value
|
Changes the linear display precision of a dimension style.
|
Full Usage:
RhinoScriptSyntax.DimStyleLinearPrecision(dimStyle)
Parameters:
string
-
(string) The name of an existing dimension style
Returns: int
(int) The current linear precision value.
|
Returns the linear display precision of a dimension style.
|
Full Usage:
RhinoScriptSyntax.DimStyleNames(?sort)
Parameters:
bool
-
(bool) Optional, default value: false. True to sort the names; False to preserve document order.
Returns: ResizeArray<string>
(string ResizeArray) The names of all dimension styles in the document.
|
Returns the names of all dimension styles in the document, optionally sorted in ordinal order.
|
Full Usage:
RhinoScriptSyntax.DimStyleNumberFormat(dimStyle, format)
Parameters:
string
-
(string) The name of an existing dimension style
format : int
-
(int) The new number format
ModelUnits 0 Decimal current model units
Millimeters 3 Decimal Millimeters
Centimeters 4 Decimal Centimeters
Meters 5 Decimal Meters
Kilometers 6 Decimal Kilometers
InchesDecimal 7 Decimal Inches
InchesFractional 1 Fractional Inches ( 1.75 inches displays as 1-3/4 )
FeetDecimal 8 Decimal Feet
FeetAndInches 2 Feet and Inches ( 14.75 inches displays as 1'-2-3/4" )
Miles 9 Decimal Miles
|
Changes the number display format of a dimension style.
|
Full Usage:
RhinoScriptSyntax.DimStyleNumberFormat(dimStyle)
Parameters:
string
-
(string) The name of an existing dimension style
Returns: int
(int) The current display format
ModelUnits 0 Decimal current model units
Millimeters 3 Decimal Millimeters
Centimeters 4 Decimal Centimeters
Meters 5 Decimal Meters
Kilometers 6 Decimal Kilometers
InchesDecimal 7 Decimal Inches
InchesFractional 1 Fractional Inches ( 1.75 inches displays as 1-3/4 )
FeetDecimal 8 Decimal Feet
FeetAndInches 2 Feet and Inches ( 14.75 inches displays as 1'-2-3/4" )
Miles 9 Decimal Miles.
|
Returns the number display format of a dimension style.
|
Full Usage:
RhinoScriptSyntax.DimStyleOffset(dimStyle, offset)
Parameters:
string
-
(string) The name of an existing dimension style
offset : float
-
(float) The new extension line offset
|
Changes the extension line offset of a dimension style.
|
Full Usage:
RhinoScriptSyntax.DimStyleOffset(dimStyle)
Parameters:
string
-
(string) The name of an existing dimension style
Returns: float
(float) The current extension line offset.
|
Returns the extension line offset of a dimension style.
|
Full Usage:
RhinoScriptSyntax.DimStylePrefix(dimStyle, prefix)
Parameters:
string
-
(string) The name of an existing dimStyle
prefix : string
-
(string) The new prefix
|
Changes the prefix of a dimension style - the text to prefix to the dimension text.
|
Full Usage:
RhinoScriptSyntax.DimStylePrefix(dimStyle)
Parameters:
string
-
(string) The name of an existing dimStyle
Returns: string
(string) The current prefix.
|
Returns the prefix of a dimension style - the text to prefix to the dimension text.
|
Full Usage:
RhinoScriptSyntax.DimStyleScale(dimStyle, scale)
Parameters:
string
-
(string) The name of an existing dimStyle
scale : float
-
(float) The new scale
|
Changes the scale of a dimension style .
|
Full Usage:
RhinoScriptSyntax.DimStyleScale(dimStyle)
Parameters:
string
-
(string) The name of an existing dimStyle
Returns: float
(float) The current dimension scale.
|
Returns the scale of a dimension style .
|
Full Usage:
RhinoScriptSyntax.DimStyleSuffix(dimStyle, suffix)
Parameters:
string
-
(string) The name of an existing dimStyle
suffix : string
-
(string) The new suffix
|
Changes the suffix of a dimension style - the text to append to the dimension text.
|
Full Usage:
RhinoScriptSyntax.DimStyleSuffix(dimStyle)
Parameters:
string
-
(string) The name of an existing dimStyle
Returns: string
(string) The current suffix.
|
Returns the suffix of a dimension style - the text to append to the dimension text.
|
Full Usage:
RhinoScriptSyntax.DimStyleTextAlignment(dimStyle, alignment)
Parameters:
string
-
(string) The name of an existing dimension style
alignment : int
-
(int) The new text alignment
0 = Same as 2
1 = Orientation horizontal to view, location is left unchanged
2 = Orientation in the dimension plane, location above the dimension line
3 = Orientation in the dimension plane, location in the dimension line
|
Changes the text alignment mode of a dimension style. Rhino 6 replaced the single Rhino 5 text alignment setting with a text location (above, in, or below the dimension line) and a text orientation (in the dimension plane, or horizontal to the view), stored separately for linear and angular dimensions and for radial dimensions. This function sets both, for linear, angular and radial dimensions.
|
Full Usage:
RhinoScriptSyntax.DimStyleTextAlignment(dimStyle)
Parameters:
string
-
(string) The name of an existing dimension style
Returns: int
(int) The current text alignment
1 = Horizontal to view
2 = In the dimension plane, above or below the dimension line
3 = In the dimension plane, in the dimension line
0 is never returned.
|
Returns the text alignment mode of a dimension style. Rhino 6 replaced the single Rhino 5 text alignment setting with a text location (above, in, or below the dimension line) and a text orientation (in the dimension plane, or horizontal to the view). This function maps them back onto the Rhino 5 values. It reads the settings for linear and angular dimensions.
|
Full Usage:
RhinoScriptSyntax.DimStyleTextGap(dimStyle, gap)
Parameters:
string
-
(string) The name of an existing dimension style
gap : float
-
(float) The new text gap
|
Changes the text gap used by a dimension style.
|
Full Usage:
RhinoScriptSyntax.DimStyleTextGap(dimStyle)
Parameters:
string
-
(string) The name of an existing dimension style
Returns: float
(float) The current text gap.
|
Returns the text gap used by a dimension style.
|
Full Usage:
RhinoScriptSyntax.DimStyleTextHeight(dimStyle, height)
Parameters:
string
-
(string) The name of an existing dimension style
height : float
-
(float) The new text height
|
Changes the text height used by a dimension style.
|
Full Usage:
RhinoScriptSyntax.DimStyleTextHeight(dimStyle)
Parameters:
string
-
(string) The name of an existing dimension style
Returns: float
(float) The current text height.
|
Returns the text height used by a dimension style.
|
Full Usage:
RhinoScriptSyntax.DimensionStyle(objectIds, dimStyleName)
Parameters:
Guid seq
-
(Guid seq) Identifier of the objects
dimStyleName : string
-
(string) The name of multiple existing dimension style
|
Modifies the dimension style of multiple dimension objects.
|
Full Usage:
RhinoScriptSyntax.DimensionStyle(objectId, dimStyleName)
Parameters:
Guid
-
(Guid) Identifier of the object
dimStyleName : string
-
(string) The name of an existing dimension style
|
Modifies the dimension style of a dimension object.
|
Full Usage:
RhinoScriptSyntax.DimensionStyle(objectId)
Parameters:
Guid
-
(Guid) Identifier of the object
Returns: string
(string) The object's current dimension style name.
|
Returns the dimension style of a dimension object.
|
Full Usage:
RhinoScriptSyntax.DimensionText(objectId)
Parameters:
Guid
-
(Guid) Identifier of the object
Returns: string
(string) The text displayed by a dimension object.
|
Returns the text displayed by a dimension object.
|
Full Usage:
RhinoScriptSyntax.DimensionUserText(objectIds, usertext)
Parameters:
Guid seq
-
(Guid seq) Identifiers of the objects
usertext : string
-
(string) The new user text string value
|
Modifies the user text string of multiple dimension objects. The user text is the string that gets printed when the dimension is defined.
|
Full Usage:
RhinoScriptSyntax.DimensionUserText(objectId, usertext)
Parameters:
Guid
-
(Guid) Identifier of the object
usertext : string
-
(string) The new user text string value
|
Modifies the user text string of a dimension object. The user text is the string that gets printed when the dimension is defined.
|
Full Usage:
RhinoScriptSyntax.DimensionUserText(objectId)
Parameters:
Guid
-
(Guid) Identifier of the object
Returns: string
(string) The current usertext string.
|
Returns the user text string of a dimension object. The user text is the string that gets printed when the dimension is defined.
|
Full Usage:
RhinoScriptSyntax.DimensionValue(objectId)
Parameters:
Guid
-
(Guid) Identifier of the object
Returns: float
(float) numeric value of the dimension.
|
Returns the value of a dimension object.
|
Full Usage:
RhinoScriptSyntax.DisableRedraw()
|
Disables screen redrawing. All UI interacting functions (such as rs.GetObject) of Rhino.Scripting will automatically enable redraw if needed and afterwards disable it again if it was disabled before. At the end of a script run in Fesh Editor Redraw will be automatically enabled again. |
Full Usage:
RhinoScriptSyntax.DisjointMeshCount(mesh)
Parameters:
Mesh
-
(Mesh) Input geometry.
Returns: int
(int) The number of Meshes that could be created.
|
Returns number of Meshes that could be created by calling SplitDisjointMesh.
|
Full Usage:
RhinoScriptSyntax.DisjointMeshCount(objectId)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object
Returns: int
(int) The number of Meshes that could be created.
|
Returns number of Meshes that could be created by calling SplitDisjointMesh.
|
Full Usage:
RhinoScriptSyntax.DisplayOleAlerts(enable)
Parameters:
bool
-
(bool) Whether alerts should be visible (True or False)
|
Enables/disables OLE Server Busy/Not Responding dialog boxes.
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.DivideCurve(curveId, segments)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
segments : int
-
(int) The number of segments
Returns: float array
( float array ) array containing 3D division parameters.
|
Divides a Curve object into a specified number of segments.
|
Full Usage:
RhinoScriptSyntax.DivideCurve(curve, segments)
Parameters:
Curve
-
(Geometry.Curve) Curve geometry
segments : int
-
(int) The number of segments
Returns: float array
( float array ) array containing 3D division parameters.
|
Divides a Curve Geometry into a specified number of segments.
|
|
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.DivideCurveLength(curveId, length)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
length : float
-
(float) The length of each segment
Returns: float[]
( float array) a list containing 3D division parameters.
|
Divides a Curve object into segments of a specified length. If length is more than Curve length it fails.
|
Full Usage:
RhinoScriptSyntax.DivideCurveLength(curve, length)
Parameters:
Curve
-
(Geometry.Curve) Curve geometry
length : float
-
(float) The length of each segment
Returns: float[]
( float array) a list containing 3D division parameters.
|
Divides a Curve Geometry into segments of a specified length. If length is more than Curve length it fails.
|
|
The current active Rhino document (= the file currently open)
|
Full Usage:
RhinoScriptSyntax.DocumentDataCount()
Returns: int
(int) The number of user data strings in the current document.
|
Returns the number of user data strings in the current document.
|
Full Usage:
RhinoScriptSyntax.DocumentModified(modified)
Parameters:
bool
-
(bool) The modified state, either True or False
|
Sets the document's modified flag. This flag indicates whether or not any changes to the current document have been made. NOTE: setting the document modified flag to False will prevent the "Do you want to save this file..." from displaying when you close Rhino.
|
Full Usage:
RhinoScriptSyntax.DocumentModified()
Returns: bool
(bool) if no modified state is specified, the current modified state.
|
Returns the document's modified flag. This flag indicates whether or not any changes to the current document have been made. NOTE: setting the document modified flag to False will prevent the "Do you want to save this file..." from displaying when you close Rhino.
|
Full Usage:
RhinoScriptSyntax.DocumentName()
Returns: string
(string) The name of the currently loaded Rhino document (3dm file).
|
Returns the name of the currently loaded Rhino document (3dm file).
|
Full Usage:
RhinoScriptSyntax.DocumentPath()
Returns: string
(string) The path of the currently loaded Rhino document including the file name(3dm file).
|
Returns full path of the currently loaded Rhino document including the file name (3dm file).
|
Full Usage:
RhinoScriptSyntax.DocumentUserTextCount()
Returns: int
(int) The number of user text strings in the current document.
|
Returns the number of user text strings in the current document.
|
|
Duplicates the edge Curves of a Surface or Polysurface. For more information, see the Rhino help file for information on the DupEdge command. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.DuplicateEdgeCurves(objectId, ?select)
Parameters:
Guid
-
(Guid) The identifier of the Surface or Polysurface object
?select : bool
-
(bool) Optional, default value: false
Select the duplicated edge Curves. The default is not to select (False)
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifying the newly created Curve objects.
|
Duplicates the edge Curves of a Surface or Polysurface. For more information, see the Rhino help file for information on the DupEdge command.
|
Full Usage:
RhinoScriptSyntax.DuplicateMeshBorder(mesh)
Parameters:
Mesh
-
(Mesh) Input Mesh.
Returns: ResizeArray<PolylineCurve>
(PolylineCurve ResizeArray) New border Curves.
|
Duplicates the naked borders of a Mesh as Polyline Curves. Returns new geometry without adding it to a document.
|
|
|
Full Usage:
RhinoScriptSyntax.DuplicateSurfaceBorder(surfaceGeo, ?typ)
Parameters:
Brep
-
(Brep) Object of a Surface
?typ : int
-
(int) Optional, default value: 0
The border Curves to return
0 = both exterior and interior,
1 = exterior
2 = interior
Returns: ResizeArray<Curve>
(Curve ResizeArray) Newly created geometry. The caller owns the returned objects.
|
Create Curves that duplicate a Surface or Polysurface border. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.DuplicateSurfaceBorder(surfaceId, ?typ)
Parameters:
Guid
-
(Guid) Identifier of a Surface
?typ : int
-
(int) Optional, default value: 0
The border Curves to return
0 = both exterior and interior,
1 = exterior
2 = interior
Returns: ResizeArray<Guid>
(Guid ResizeArray) list of Curve ids .
|
Create Curves that duplicate a Surface or Polysurface border.
|
Full Usage:
RhinoScriptSyntax.EdgeAnalysisColor(color)
Parameters:
Color
-
(Drawing.Color), optional) The new color for the analysis
|
Modifies edge analysis color displayed by the ShowEdges command.
|
Full Usage:
RhinoScriptSyntax.EdgeAnalysisColor()
Returns: Color
(Drawing.Color) The current edge analysis color.
|
Returns edge analysis color displayed by the ShowEdges command.
|
Full Usage:
RhinoScriptSyntax.EdgeAnalysisMode(mode)
Parameters:
int
-
(int) The new display mode. The available modes are
0 - display all edges
1 - display naked edges
2 - non-manifold edges
|
Modifies edge analysis mode displayed by the ShowEdges command.
|
Full Usage:
RhinoScriptSyntax.EdgeAnalysisMode()
Returns: int
(int) The current edge analysis mode
0 - display all edges
1 - display naked edges
2 - non-manifold edges
|
Returns edge analysis mode displayed by the ShowEdges command.
|
Full Usage:
RhinoScriptSyntax.EditBox(?defaultValString, ?message, ?title)
Parameters:
string
-
(string) Optional, A default string value
?message : string
-
(string) Optional, A prompt message
?title : string
-
(string) Optional, A dialog box title
Returns: string
(string Option) Option of Multiple lines that are separated by carriage return-linefeed combinations.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Display dialog prompting the user to enter a string. The string value may span multiple lines.
|
|
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.EnableAutosave(?enable)
Parameters:
bool
-
(bool) Optional, default value: true
The autosave state. If omitted automatic saving is enabled (True)
|
Enables or disables Rhino's automatic file saving mechanism.
|
Full Usage:
RhinoScriptSyntax.EnableLight(geometryObject)
Parameters:
Light
-
(Light) The light geometry to use.
Returns: bool
(bool) The current enabled status.
|
Get On / Off status of a light object.
|
Full Usage:
RhinoScriptSyntax.EnableLight(objectIds, enable)
Parameters:
Guid seq
-
(Guid seq) The light objects's identifiers
enable : bool
-
(bool) The light's enabled status
|
Enables or disables multiple light objects.
|
Full Usage:
RhinoScriptSyntax.EnableLight(objectId, enable)
Parameters:
Guid
-
(Guid) The light object's identifier
enable : bool
-
(bool) The light's enabled status
|
Enables or disables a light object.
|
Full Usage:
RhinoScriptSyntax.EnableLight(objectId)
Parameters:
Guid
-
(Guid) The light object's identifier
Returns: bool
(bool) The current enabled status.
|
Get On / Off status of a light object.
|
Full Usage:
RhinoScriptSyntax.EnableObjectGrips(objectId, ?enable)
Parameters:
Guid
-
(Guid) Identifier of the object.
?enable : bool
-
(bool) Optional, default value: true.
If true, the specified object's grips will be turned on.
If false, they will be turned off.
Returns: bool
(bool) True on success, false on failure.
|
Enables or disables an object's grips. For curves and surfaces, these are also called control points.
|
Full Usage:
RhinoScriptSyntax.EnablePlugIn(pluginId, enable)
Parameters:
Guid
-
(Guid) The Guid of the plugin
enable : bool
-
(bool) Load silently if True
|
Enables or disables a Rhino plug-in.
|
Full Usage:
RhinoScriptSyntax.EnablePlugIn(pluginId)
Parameters:
Guid
-
(Guid) The Guid of the plugin
Returns: bool
(bool) True if set to load silently otherwise False.
|
Get status of a Rhino plug-in.
|
Full Usage:
RhinoScriptSyntax.EnablePlugIn(plugin, enable)
Parameters:
string
-
(string) The name of the plugin
enable : bool
-
(bool) Load silently if True
|
Enables or disables a Rhino plug-in.
|
Full Usage:
RhinoScriptSyntax.EnablePlugIn(plugin)
Parameters:
string
-
(string) The name of the plugin
Returns: bool
(bool) True if set to load silently otherwise False.
|
Get status of a Rhino plug-in.
|
Full Usage:
RhinoScriptSyntax.EnableRedraw(?enable)
Parameters:
bool
-
(bool) Optional, default value: true
True to enable, False to disable
|
Enables or disables screen redrawing. All UI interacting functions (such as rs.GetObject) of Rhino.Scripting will automatically enable redraw if needed and afterwards disable it again if it was disabled before. At the end of a script run in Fesh Editor Redraw will be automatically enabled again.
|
Full Usage:
RhinoScriptSyntax.EscapeTest()
|
Tests to see if the user has pressed the escape key. Raises an OperationCanceledException. |
Full Usage:
RhinoScriptSyntax.EvaluateCurve(curveGeo, t, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
t : float
-
(float) The parameter to evaluate
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: Point3d
(Point3d) a 3-D point.
|
Evaluates a Curve at a parameter and returns a 3D point. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.EvaluateCurve(curveId, t, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
t : float
-
(float) The parameter to evaluate
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: Point3d
(Point3d) a 3-D point.
|
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.ExeFolder()
Returns: string
(string) The full path to Rhino's executable folder.
|
Returns the full path to Rhino's executable folder.
|
Full Usage:
RhinoScriptSyntax.ExePlatform()
Returns: int
(int) 1 for 64 bit, 0 for 32 bit.
|
Returns the platform of the Rhino executable , calls System.Environment.Is64BitProcess.
|
Full Usage:
RhinoScriptSyntax.ExeServiceRelease()
Returns: int
(int) The service release number of the Rhino executable.
|
Returns the service release number of the Rhino executable.
|
Full Usage:
RhinoScriptSyntax.ExeVersion()
Returns: int
(int) The major version number of the Rhino executable.
|
Returns the major version number of the Rhino executable.
|
Full Usage:
RhinoScriptSyntax.Exit()
|
Closes the Rhino application. |
Full Usage:
RhinoScriptSyntax.ExpandLayer(layer, expand)
Parameters:
string
-
(string) Name of the layer to expand
expand : bool
-
(bool) True to expand, False to collapse
|
Expands or Collapses a layer. Expanded layers can be viewed in Rhino's layer dialog. Use the functions rs.UnCollapseLayer and rs.CollapseLayer to expand and collapse their children too.
|
Full Usage:
RhinoScriptSyntax.ExplodeBlockInstance(geometryObject, ?explodeNestedInstances)
Parameters:
InstanceReferenceGeometry
-
(InstanceReferenceGeometry) The block reference geometry to explode.
?explodeNestedInstances : bool
-
(bool) Optional, default value: false.
If true, recursively explodes nested references. Otherwise, nested references remain instance reference geometry.
Returns: GeometryBase array
(GeometryBase array) Independent geometry copies with the block reference transforms applied.
|
Explodes block reference geometry into transformed copies of its component geometry. Resolves block definitions in the active document without adding, deleting or changing document objects. Object attributes are not part of the returned geometry.
|
Full Usage:
RhinoScriptSyntax.ExplodeBlockInstance(objectId, ?explodeNestedInstances)
Parameters:
Guid
-
(Guid) The identifier of an existing block insertion object
?explodeNestedInstances : bool
-
(bool) Optional, default value: false
By default nested blocks are not exploded
Returns: Guid array
(Guid array) identifiers for the newly exploded objects.
|
Explodes a block instance into it's geometric components. The exploded objects are added to the document. The block instance is deleted
|
|
|
Full Usage:
RhinoScriptSyntax.ExplodeCurve(curveId, ?deleteInput)
Parameters:
Guid
-
(Guid) The Curve object to explode
?deleteInput : bool
-
(bool) Optional, default value: false
Delete input objects after exploding if True
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifying the newly created Curve objects.
|
Explodes, or un-joins, one Curve. PolyCurves will be exploded into Curve segments. Polylines will be exploded into line segments. ExplodeCurves will return the Curves in topological order.
|
|
|
Full Usage:
RhinoScriptSyntax.ExplodeCurves(curveIds, ?deleteInput)
Parameters:
Guid seq
-
(Guid seq) The Curve objects to explode
?deleteInput : bool
-
(bool) Optional, default value: false
Delete input objects after exploding if True
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifying the newly created Curve objects.
|
Explodes, or un-joins, several curves Curve. PolyCurves will be exploded into Curve segments. Polylines will be exploded into line segments. ExplodeCurves will return the Curves in topological order.
|
Full Usage:
RhinoScriptSyntax.ExplodeHatch(hatch)
Parameters:
Hatch
-
(Hatch) The hatch geometry to explode.
Returns: ResizeArray<GeometryBase>
(GeometryBase ResizeArray) The exploded geometry.
|
Explodes hatch geometry into curves or planar breps without adding them to the document.
|
Full Usage:
RhinoScriptSyntax.ExplodeHatch(hatchId, ?delete)
Parameters:
Guid
-
(Guid) Identifier of a Hatch object
?delete : bool
-
(bool) Optional, default value: false
Delete the Hatch object
Returns: ResizeArray<Guid>
(Guid ResizeArray) list of identifiers for the newly created objects.
|
Explodes a Hatch object into its component objects. The exploded objects will be added to the document. If the Hatch object uses a solid pattern, then planar face Brep objects will be created. Otherwise, line Curve objects will be created.
|
|
|
|
Explodes a Mesh object, or Mesh objects int subMeshes. A subMesh is a collection of Mesh faces that are contained within a closed loop of unwelded Mesh edges. Unwelded Mesh edges are where the Mesh faces that share the edge have unique Mesh vertices (not Mesh topology vertices) at both ends of the edge.
|
|
Explodes, or un-joins, one or more Polysurface objects. Polysurfaces will be exploded into separate Surfaces. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.ExplodePolysurfaces(objectIds, ?deleteInput)
Parameters:
Guid seq
-
(Guid seq) Identifiers of Polysurfaces to explode
?deleteInput : bool
-
(bool) Optional, default value: false
Delete input objects after exploding
Returns: ResizeArray<Guid>
(Guid ResizeArray) List of identifiers of exploded pieces .
|
Explodes, or un-joins, one or more Polysurface objects. Polysurfaces will be exploded into separate Surfaces.
|
Full Usage:
RhinoScriptSyntax.ExplodeText(text)
Parameters:
TextEntity
-
(TextEntity) The text geometry to explode.
Returns: ResizeArray<Curve>
(Curve ResizeArray) The outline curves.
|
Creates outline curves from text geometry without adding them to the document.
|
Full Usage:
RhinoScriptSyntax.ExplodeText(textId, ?delete)
Parameters:
Guid
-
(Guid) Identifier of Text object to explode
?delete : bool
-
(bool) Optional, default value: false
Delete the text object after the Curves have been created
Returns: ResizeArray<Guid>
(Guid array) Array of outline Curves.
|
|
Full Usage:
RhinoScriptSyntax.ExtendCurve(curveGeo, extensionType, side, boundaryCurves)
Parameters:
Curve
-
(Curve) The input curve geometry.
extensionType : int
-
(int)
0 = line
1 = arc
2 = smooth
side : int
-
(int)
0 = extend from the start of the Curve
1 = extend from the end of the Curve
2 = extend from both the start and the end of the Curve
boundaryCurves : GeometryBase seq
-
(GeometryBase seq) The input objects.
Returns: Curve
(Curve) The resulting geometry; it is not added to a document.
|
Computes ExtendCurve from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.ExtendCurve(curveId, extensionType, side, boundaryCurveIds, ?replaceInput)
Parameters:
Guid
-
(Guid) Identifier of Curve to extend
extensionType : int
-
(int)
0 = line
1 = arc
2 = smooth
side : int
-
(int)
0 = extend from the start of the Curve
1 = extend from the end of the Curve
2 = extend from both the start and the end of the Curve
boundaryCurveIds : Guid seq
-
(Guid seq) Curve, Surface, and Polysurface objects to extend to
?replaceInput : bool
-
(bool) Optional, Default Value false Replace input or add new?
Returns: Guid
(Guid) The identifier of the new or modified Curve.
|
Extends a non-closed Curve object by a line, arc, or smooth extension until it intersects a collection of objects.
|
Full Usage:
RhinoScriptSyntax.ExtendCurveLength(curveGeo, extensionType, side, length)
Parameters:
Curve
-
(Curve) The input curve geometry.
extensionType : int
-
(int)
0 = line
1 = arc
2 = smooth
side : int
-
(int)
0 = extend from start of the Curve
1 = extend from end of the Curve
2 = Extend from both ends
length : float
-
(float) Distance to extend
Returns: Curve
(Curve) The resulting geometry; it is not added to a document.
|
Computes ExtendCurveLength from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.ExtendCurveLength(curveId, extensionType, side, length)
Parameters:
Guid
-
(Guid) Curve to extend
extensionType : int
-
(int)
0 = line
1 = arc
2 = smooth
side : int
-
(int)
0 = extend from start of the Curve
1 = extend from end of the Curve
2 = Extend from both ends
length : float
-
(float) Distance to extend
Returns: Guid
(Guid) The identifier of the new object.
|
Extends a non-closed Curve by a line, arc, or smooth extension for a specified distance.
|
Full Usage:
RhinoScriptSyntax.ExtendCurvePoint(curveGeo, side, point, ?extensionType)
Parameters:
Curve
-
(Curve) The input curve geometry.
side : int
-
(int)
0 = extend from start of the Curve
1 = extend from end of the Curve
2 = extend from both the start and the end of the Curve
point : Point3d
-
(Point3d) Point to extend to
?extensionType : int
-
(int) Optional, default value: 2 ( CurveExtensionStyle.Smooth))
0 = line
1 = arc
2 = smooth
Returns: Curve
(Curve) The resulting geometry; it is not added to a document.
|
Computes ExtendCurvePoint from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.ExtendCurvePoint(curveId, side, point, ?extensionType)
Parameters:
Guid
-
(Guid) Curve to extend
side : int
-
(int)
0 = extend from start of the Curve
1 = extend from end of the Curve
2 = extend from both the start and the end of the Curve
point : Point3d
-
(Point3d) Point to extend to
?extensionType : int
-
(int) Optional, default value: 2 ( CurveExtensionStyle.Smooth))
0 = line
1 = arc
2 = smooth
Returns: Guid
(Guid) The identifier of the new object.
|
Extends a non-closed Curve by smooth extension to a point.
|
Full Usage:
RhinoScriptSyntax.ExtendSurface(surfaceId, parameter, length, ?smooth)
Parameters:
Guid
-
(Guid) Identifier of a Surface
parameter : float * float
-
(float * float) Tuple of two values defining the U, V parameter to evaluate.
The Surface edge closest to the U, V parameter will be the edge that is
extended
length : float
-
(float) Amount to extend to Surface
?smooth : bool
-
(bool) Optional, default value: true
If True, the Surface is extended smoothly curving from the
edge. If False, the Surface is extended in a straight line from the edge
Returns: bool
(bool) True or False indicating success or failure.
|
Lengthens an untrimmed Surface object.
|
Full Usage:
RhinoScriptSyntax.ExtractIsoCurve(surfaceGeo, parameter, direction)
Parameters:
Surface
-
(Surface) Object of a Surface
parameter : float * float
-
(float * float) U, v parameter of the Surface to evaluate
direction : int
-
(int) Direction to evaluate
0 = u
1 = v
2 = both
Returns: ResizeArray<Curve>
(Curve ResizeArray) Newly created geometry. The caller owns the returned objects.
|
Extracts iso-parametric Curves from a Surface. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.ExtractIsoCurve(surfaceId, parameter, direction)
Parameters:
Guid
-
(Guid) Identifier of a Surface
parameter : float * float
-
(float * float) U, v parameter of the Surface to evaluate
direction : int
-
(int) Direction to evaluate
0 = u
1 = v
2 = both
Returns: ResizeArray<Guid>
(Guid ResizeArray) List of Curve ids .
|
Extracts iso-parametric Curves from a Surface.
|
Full Usage:
RhinoScriptSyntax.ExtractPreviewImage(fileName, ?modelName)
Parameters:
string
-
(string) Name of the bitmap file to create. The extension of
the fileName controls the format of the bitmap file created.
(.bmp, .tga, .jpg, .jpeg, .pcx, .png, .tif, .tiff)
?modelName : string
-
(string) Optional, The model (.3dm) from which to extract the
preview image. If omitted, the currently loaded model is used
|
Extracts the bitmap preview image from the specified model (.3dm).
|
Full Usage:
RhinoScriptSyntax.ExtractSurface(geometryObject, faceIndices)
Parameters:
Brep
-
(Brep) Polysurface object
faceIndices : int seq
-
(int seq) One or more numbers representing faces
Returns: ResizeArray<Brep>
(Brep ResizeArray) Newly created geometry. The caller owns the returned objects.
|
Duplicates the selected faces of a Polysurface as independent Breps. Returns geometry without adding it to the document.
|
Full Usage:
RhinoScriptSyntax.ExtractSurface(objectId, faceIndices, ?copy)
Parameters:
Guid
-
(Guid) Polysurface identifier
faceIndices : int seq
-
(int seq) One or more numbers representing faces
?copy : bool
-
(bool) Optional, default value: false
If True the faces are copied. If False, the faces are extracted
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers of extracted Surface objects .
|
Separates or copies a Surface or a copy of a Surface from a Polysurface.
|
Full Usage:
RhinoScriptSyntax.ExtrudeCurve(curveGeo, pathGeo)
Parameters:
Curve
-
(Curve) Object of the Curve to extrude
pathGeo : Curve
-
(Curve) Object of the path Curve
Returns: SumSurface
(SumSurface) Newly created geometry. The caller owns the returned objects.
|
Creates a Surface by extruding a Curve along a path. Returns geometry without adding it.
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.ExtrudeCurveStraight(curveGeo, startPoint, endPoint)
Parameters:
Curve
-
(Curve) Object of the Curve to extrude
startPoint : Point3d
-
(Point3d) Start point
endPoint : Point3d
-
(Point3d) End point, that specifies distance and direction
Returns: Surface
(Surface) Newly created geometry. The caller owns the returned objects.
|
Create Surface by extruding a Curve along two points that define a line. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.ExtrudeCurveStraight(curveId, startPoint, endPoint)
Parameters:
Guid
-
(Guid) Identifier of the Curve to extrude
startPoint : Point3d
-
(Point3d) Start point
endPoint : Point3d
-
(Point3d) End point, that specifies distance and direction
Returns: Guid
(Guid) identifier of new Surface .
|
|
Full Usage:
RhinoScriptSyntax.ExtrudeSurface(surfaceGeo, curveGeo, ?cap)
Parameters:
Brep
-
(Brep) Object of the Surface to extrude
curveGeo : Curve
-
(Curve) Object of the path Curve
?cap : bool
-
(bool) Optional, default value: true
Extrusion is capped at both ends
Returns: Brep
(Brep) Newly created geometry. The caller owns the returned objects.
|
Create Surface by extruding along a path Curve. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.ExtrudeSurface(surfaceId, curveId, ?cap)
Parameters:
Guid
-
(Guid) Identifier of the Surface to extrude
curveId : Guid
-
(Guid) Identifier of the path Curve
?cap : bool
-
(bool) Optional, default value: true
Extrusion is capped at both ends
Returns: Guid
(Guid) identifier of new Surface .
|
|
Full Usage:
RhinoScriptSyntax.FairCurve(curveId, tolerance)
Parameters:
Guid
-
(Guid) Curve to fair
tolerance : float
-
(float) Fairing tolerance
Returns: bool
(bool) True or False indicating success or failure.
|
Fairs a Curve. Fair works best on degree 3 (cubic) Curves. Fair attempts to remove large curvature variations while limiting the geometry changes to be no more than the specified tolerance. Sometimes several applications of this method are necessary to remove nasty curvature problems.
|
Full Usage:
RhinoScriptSyntax.FilletSurfaces(surface0, surface1, radius, ?uvparam0, ?uvparam1)
Parameters:
Surface
-
(Surface) first Surface
surface1 : Surface
-
(Surface) second Surface
radius : float
-
(float) A positive fillet radius
?uvparam0 : Point2d
-
(Point2d) Optional, A u, v Surface parameter of Surface0 near where the fillet
is expected to hit the Surface
?uvparam1 : Point2d
-
(Point2d) Optional, Same as uvparam0, but for Surface1
Returns: ResizeArray<Surface>
(Surface ResizeArray) Newly created geometry. The caller owns the returned objects.
An empty list if no fillet could be made, this is not an error.
|
Create constant radius rolling ball fillets between two Surfaces. Note, this function does not trim the original Surfaces of the fillets. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.FilletSurfaces(surface0, surface1, radius, ?uvparam0, ?uvparam1)
Parameters:
Guid
-
(Guid) first Surface
surface1 : Guid
-
(Guid) second Surface
radius : float
-
(float) A positive fillet radius
?uvparam0 : Point2d
-
(Point2d) Optional, A u, v Surface parameter of Surface0 near where the fillet
is expected to hit the Surface
?uvparam1 : Point2d
-
(Point2d) Optional, Same as uvparam0, but for Surface1
Returns: ResizeArray<Guid>
(Guid ResizeArray) ids of Surfaces created.
An empty list if no fillet could be made, this is not an error.
|
Create constant radius rolling ball fillets between two Surfaces. Note, this function does not trim the original Surfaces of the fillets.
|
|
An Integer Enum of Object types. To be used in object selection functions such as rs.GetObjects().
|
Full Usage:
RhinoScriptSyntax.FindFile(filename)
Parameters:
string
-
(string) A short file name to search for
Returns: string
(string) a full path.
|
Searches for a file using Rhino's search path. Rhino will look for a file in the following locations: 1. The current document's folder. 2. Folder's specified in Options dialog, File tab. 3. Rhino's System folders.
|
Full Usage:
RhinoScriptSyntax.FirstObject(?select, ?includeLights, ?includeGrips)
Parameters:
bool
-
(bool) Optional, default value: false Select the object. If omitted, the object is not selected
?includeLights : bool
-
(bool) Optional, default value: false Include light objects. If omitted, light objects are not returned
?includeGrips : bool
-
(bool) Optional, default value: false Include grips objects. If omitted, grips objects are not returned
Returns: Guid
(Guid) The identifier of the object.
|
Returns identifier of the first object in the document. The first object is the last object created by the user.
|
Full Usage:
RhinoScriptSyntax.FitCurve(curveGeo, ?degree, ?distanceTolerance, ?angleToleranceDegrees)
Parameters:
Curve
-
(Curve) The input curve geometry.
?degree : int
-
(int) Optional, default value: 3
The Curve degree, which must be greater than 1.
The default is 3
?distanceTolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
The fitting tolerance.
?angleToleranceDegrees : float
-
(float) Optional, default value: -1.0
The kink smoothing tolerance in degrees. If
angleToleranceDegrees is 0.0, all kinks are smoothed. If angleToleranceDegrees
is bigger than 0.0, kinks smaller than angleToleranceDegrees are smoothed. If
angleToleranceDegrees is not specified or smaller than 0.0, the document angle
tolerance is used for the kink smoothing
Returns: Curve
(Curve) The resulting geometry; it is not added to a document.
|
Computes FitCurve from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.FitCurve(curveId, ?degree, ?distanceTolerance, ?angleToleranceDegrees)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?degree : int
-
(int) Optional, default value: 3
The Curve degree, which must be greater than 1.
The default is 3
?distanceTolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
The fitting tolerance.
?angleToleranceDegrees : float
-
(float) Optional, default value: -1.0
The kink smoothing tolerance in degrees. If
angleToleranceDegrees is 0.0, all kinks are smoothed. If angleToleranceDegrees
is bigger than 0.0, kinks smaller than angleToleranceDegrees are smoothed. If
angleToleranceDegrees is not specified or smaller than 0.0, the document angle
tolerance is used for the kink smoothing
Returns: Guid
(Guid) The identifier of the new object.
|
Reduces number of Curve control points while maintaining the Curve's same general shape. Use this function for replacing Curves with many control points. For more information, see the Rhino help for the FitCrv command.
|
Full Usage:
RhinoScriptSyntax.FlashObject(objectIds, ?style)
Parameters:
Guid seq
-
(Guid seq) Identifiers of objects to flash
?style : bool
-
(bool) Optional, default value: true
If True, flash between object color and selection color.
If False, flash between visible and invisible
|
Causes the selection state of one or more objects to change momentarily so the object appears to flash on the screen.
|
|
|
Full Usage:
RhinoScriptSyntax.FlipSurface(surfaceIds, flip)
Parameters:
Guid seq
-
(Guid seq) Identifiers of multiple Surface objects
flip : bool
-
(bool) New normal orientation, either flipped(True) or not flipped (False)
|
Changes the normal direction of multiple Surface. This feature can also be found in Rhino's Dir command. Use RhinoScriptSyntax.IsSurfaceFlipped to get the orientation.
|
Full Usage:
RhinoScriptSyntax.FlipSurface(surfaceId, flip)
Parameters:
Guid
-
(Guid) Identifier of a Surface object
flip : bool
-
(bool) New normal orientation, either flipped(True) or not flipped (False)
|
Changes the normal direction of a Surface. This feature can also be found in Rhino's Dir command. Use RhinoScriptSyntax.IsSurfaceFlipped to get the orientation.
|
Full Usage:
RhinoScriptSyntax.FrangePython(start, stop, step)
Parameters:
float
-
(float) The first value of the range.
stop : float
-
(float) The end of the range. The last value will not be included in the range (Python semantics).
step : float
-
(float) The step size between two values.
Returns: ResizeArray<float>
(float ResizeArray) A resizable array of floats.
|
Like the Python 'range' function for integers, this creates a range of floating point values. The last or stop value will NOT be included in the range as per Python semantics; this is different from F# semantics on range expressions. Like in Python the range is empty if the stop value cannot be reached, e.g. if start equals stop or if the step has the wrong sign. A step of zero raises an exception.
|
Full Usage:
RhinoScriptSyntax.FxrangePython(start, stop, step)
Parameters:
float
-
(float) The first value of the range.
stop : float
-
(float) The end of the range. The last value will not be included in the range (Python semantics).
step : float
-
(float) The step size between two values.
Returns: float seq
(float seq) A lazy sequence of floats.
|
Like the Python 'xrange' function for integers, this creates a range of floating point values. The last or stop value will NOT be included in the range as per Python semantics; this is different from F# semantics on range expressions. Like in Python the range is empty if the stop value cannot be reached, e.g. if start equals stop or if the step has the wrong sign. A step of zero raises an exception.
|
Full Usage:
RhinoScriptSyntax.GetAngle(?point, ?referencePoint, ?defaultValAngleDegrees, ?message)
Parameters:
Point3d
-
(Point3d) Optional, default value: Point3d.Unset
Starting, or base point
?referencePoint : Point3d
-
(Point3d) Optional, default value: Point3d.Unset
If specified, the reference angle is calculated from it and the base point
?defaultValAngleDegrees : float
-
(float) Optional, default value: 0.0. The default angle in degrees
?message : string
-
(string) Optional, A prompt to display
Returns: float
(float) The selected angle in degrees.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Pause for user input of an angle in degrees.
|
Full Usage:
RhinoScriptSyntax.GetBoolean(message, items, defaultVals)
Parameters:
string
-
(string) A prompt
items : (string * string * string) array
-
((string*string*string) array) List of options. Each is a tuple of three strings
[n][1] description of the boolean value. Must only consist of letters and numbers. (no characters like space, period, or dash)
[n][2] string identifying the false value
[n][3] string identifying the true value
defaultVals : bool array
-
(bool seq) List of boolean values used as default or starting values
Returns: ResizeArray<bool>
(bool ResizeArray) Option of a list of values that represent the boolean values.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Pauses for user input of one or more boolean values. Boolean values are displayed as click-able Command-line toggles.
|
Full Usage:
RhinoScriptSyntax.GetBox(?mode, ?basePoint, ?prompt1, ?prompt2, ?prompt3)
Parameters:
int
-
(int) Optional, default value: 0
The box selection mode.
0 = All modes
1 = Corner. The base rectangle is created by picking two corner points
2 = 3-Point. The base rectangle is created by picking three points
3 = Vertical. The base vertical rectangle is created by picking three points.
4 = Center. The base rectangle is created by picking a center point and a corner point
?basePoint : Point3d
-
(Point3d) Optional, Optional 3D base point
?prompt1 : string
-
(string) Optional, Prompt1 of 'optional prompts to set'
?prompt2 : string
-
(string) Optional, Prompt2 of 'optional prompts to set'
?prompt3 : string
-
(string) Optional, Prompt3 of 'optional prompts to set'
Returns: Point3d[]
(Point3d array) array of eight Point3d that define the corners of the box.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Pauses for user input of a box.
|
|
|
Full Usage:
RhinoScriptSyntax.GetCursorPos()
Returns: Point3d * Point2d * Guid * Point2d
(Point3d * Point2d * Guid * Point2d) a Tuple of containing the following information
0 Point3d: cursor position in world coordinates
1 Point2d: cursor position in screen coordinates
2 Guid: objectId of the active view-port
3 Point2d: cursor position in client coordinates.
|
Retrieves the cursor's position.
|
Full Usage:
RhinoScriptSyntax.GetCurveObject(?message, ?preselect, ?select)
Parameters:
string
-
(string) Optional, A prompt or message
?preselect : bool
-
(bool) Optional, default value: true Allow for the selection of pre-selected objects
?select : bool
-
(bool) Optional, default value: false Select the picked objects. If False, objects that are picked are not selected
Returns: Guid * bool * SelectionMethod * Point3d * float * string
(Guid * bool * int * Point3d * float * string) Tuple containing the following information
[0] guid identifier of the Curve object
[1] bool True if the Curve was preselected, otherwise False
[2] Enum DocObjects.SelectionMethod
[3] point selection point
[4] number the Curve parameter of the selection point
[5] str name of the view selection was made.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Prompts user to pick or select a single Curve object.
|
Full Usage:
RhinoScriptSyntax.GetDistance(?firstPt, ?distance, ?firstPtMsg, ?secondPtMsg)
Parameters:
Point3d
-
(Point3d) Optional, First distance point
?distance : float
-
(float) Optional, Default distance
?firstPtMsg : string
-
(string) Optional, default value: "First distance point"
Prompt for the first distance point
?secondPtMsg : string
-
(string) Optional, default value: "Second distance point"
Prompt for the second distance point
Returns: float
(float) The distance between the two points.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Pauses for user input of a distance.
|
Full Usage:
RhinoScriptSyntax.GetDocumentData(?sectionName)
Parameters:
string
-
(string) Optional, Section name. If omitted, all section names are returned
Returns: string array
(string array) Array of all section names if sectionName is omitted,
else all entry names in this section.
|
Returns a user data item from the current document.
|
Full Usage:
RhinoScriptSyntax.GetDocumentDataEntry(section, entry)
Parameters:
string
-
(string) Section name
entry : string
-
(string) Entry name
Returns: string
(string) The entry value.
|
Returns a user data item entry from the current document.
|
Full Usage:
RhinoScriptSyntax.GetDocumentUserText(key)
Parameters:
string
-
(string) Key to use for retrieving user text
Returns: string
(string) If key is specified, then the associated value.
|
Returns user text stored in the document.
|
Full Usage:
RhinoScriptSyntax.GetDocumentUserTextKeys()
Returns: ResizeArray<string>
(string ResizeArray) all document user text keys.
|
Returns all document user text keys.
|
Full Usage:
RhinoScriptSyntax.GetEdgeCurves(?message, ?minCount, ?maxCount, ?select)
Parameters:
string
-
(string) Optional, default value: Select Edges
A prompt or message
?minCount : int
-
(int) Optional, default value: 1
Minimum number of edges to select
?maxCount : int
-
(int) Optional, default value: 0
Maximum number of edges to select
?select : bool
-
(bool) Optional, default value: false
Select the duplicated edge Curves
Returns: ResizeArray<Guid * Guid * Point3d>
((Guid*Guid*Point3d) ResizeArray) a List of selection prompts (curve objectId, parent objectId, selection point).
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Prompt the user to pick one or more Surface or Polysurface edge Curves.
|
Full Usage:
RhinoScriptSyntax.GetInteger(?message, ?number, ?minimum, ?maximum)
Parameters:
string
-
(string) Optional, A prompt or message
?number : int
-
(int) Optional, A default whole number value
?minimum : int
-
(int) Optional, A minimum allowable value
?maximum : int
-
(int) Optional, A maximum allowable value
Returns: int
(int) The whole number input by the user.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Pauses for user input of a whole number.
|
Full Usage:
RhinoScriptSyntax.GetLayer(?title, ?layer, ?showNewButton, ?showSetCurrent)
Parameters:
string
-
(string) Optional, default value: "Select Layer"
Dialog box title
?layer : string
-
(string) Optional, Name of a layer to preselect. If omitted, the current layer will be preselected
?showNewButton : bool
-
(bool) Optional, default value: false
Show new button of on the dialog
?showSetCurrent : bool
-
(bool) Optional, default value: false
Show set current button on the dialog
Returns: string
(string) name of selected layer.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Displays dialog box prompting the user to select a layer.
|
Full Usage:
RhinoScriptSyntax.GetLayers(?title, ?showNewButton)
Parameters:
string
-
(string) Optional, default value: "Select Layers"
Dialog box title
?showNewButton : bool
-
(bool) Optional, default value: false
Optional button to show on the dialog
Returns: ResizeArray<string>
(string ResizeArray) The names of selected layers.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Displays a dialog box prompting the user to select one or more layers.
|
Full Usage:
RhinoScriptSyntax.GetLine(?mode, ?point, ?message1, ?message2, ?message3)
Parameters:
int
-
(int) Optional, default value: 0
Line definition mode.
0 Default - Show all modes, start in two-point mode
1 Two-point - Defines a line from two points.
2 Normal - Defines a line normal to a location on a Surface.
3 Angled - Defines a line at a specified angle from a reference line.
4 Vertical - Defines a line vertical to the construction Plane.
5 Four-point - Defines a line using two points to establish direction and two points to establish length.
6 Bisector - Defines a line that bisects a specified angle.
7 Perpendicular - Defines a line perpendicular to or from a Curve
8 Tangent - Defines a line tangent from a Curve.
9 Extension - Defines a line that extends from a Curve
?point : Point3d
-
(Point3d) Optional, Optional starting point
?message1 : string
-
(string) Optional, Message1 of optional prompts
?message2 : string
-
(string) Optional, Message2 of optional prompts
?message3 : string
-
(string) Optional, Message3 of optional prompts
Returns: Line
(Line) a Line.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Prompts the user to pick points that define a line.
|
Full Usage:
RhinoScriptSyntax.GetLinetype(?defaultValLinetype)
Parameters:
string
-
(string) Optional. The name of the line-type to pre-select. If omitted or not found, the current line-type will be pre-selected.
Pre-selecting is only supported in Rhino 8 and higher, it is ignored in Rhino 7.
Returns: string
(string) The names of selected line-type.
|
Displays a dialog box prompting the user to select one line-type. A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Full Usage:
RhinoScriptSyntax.GetMeshFaces(objectId, ?message, ?minCount, ?maxCount)
Parameters:
Guid
-
(Guid) The Mesh object's identifier
?message : string
-
(string) Optional, default value: "Select Mesh Faces"
A prompt of message
?minCount : int
-
(int) Optional, default value: 1
The minimum number of faces to select
?maxCount : int
-
(int) Optional, default value: 0
The maximum number of faces to select.
If 0, the user must press enter to finish selection.
If -1, selection stops as soon as there are at least minCount faces selected
Returns: ResizeArray<int>
(int ResizeArray) Mesh face indices.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Prompts the user to pick one or more Mesh faces.
|
Full Usage:
RhinoScriptSyntax.GetMeshVertices(objectId, ?message, ?minCount, ?maxCount)
Parameters:
Guid
-
(Guid) The Mesh object's identifier
?message : string
-
(string) Optional, default value: "Select Mesh Vertices"
A prompt of message
?minCount : int
-
(int) Optional, default value: 1
The minimum number of vertices to select
?maxCount : int
-
(int) Optional, default value: 0
The maximum number of vertices to select. If 0, the user must
press enter to finish selection. If -1, selection stops as soon as there
are at least minCount vertices selected
Returns: ResizeArray<int>
(int ResizeArray) Mesh vertex indices.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Prompts the user to pick one or more Mesh vertices.
|
Full Usage:
RhinoScriptSyntax.GetObject(?message, ?filter, ?preselect, ?select, ?customFilter, ?subObjects)
Parameters:
string
-
(string) Optional, A prompt or message
?filter : int
-
(int) Optional, The type(s) of geometry (points, Curves, Surfaces, Meshes,...)
that can be selected. Object types can be added together to filter
several different kinds of geometry. use the RhinoScriptSyntax.Filter enum to get values, they can be joined with '+'
?preselect : bool
-
(bool) Optional, default value: true
Allow for the selection of pre-selected objects
?select : bool
-
(bool) Optional, default value: false
Select the picked objects. If False, the objects that are
picked are not selected
?customFilter : GetObjectGeometryFilter
-
(Input.Custom.GetObjectGeometryFilter) Optional, A custom filter function
?subObjects : bool
-
(bool) Optional, default value: false
If True, sub-objects can be selected. When this is the
case, use GetObjectRef instead to retain the selected component; this method returns only the parent identifier
Returns: Guid
(Guid) Identifier of the picked object.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Prompts user to pick, or select, a single object. Raises a RhinoUserInteractionException if no object was selected. For example when Esc key was pressed.
|
Full Usage:
RhinoScriptSyntax.GetObjectEx(?message, ?filter, ?preselect, ?select, ?objects)
Parameters:
string
-
(string) Optional, A prompt or message
?filter : int
-
(int) Optional, default value: 0
The type(s) of geometry (points, Curves, Surfaces, Meshes,...)
that can be selected. Object types can be added together to filter
several different kinds of geometry. use the filter class to get values
?preselect : bool
-
(bool) Optional, default value: true
Allow for the selection of pre-selected objects
?select : bool
-
(bool) Optional, default value: false
Select the picked objects. If False, the objects that are
picked are not selected
?objects : Guid
-
(Guid seq) Optional, List of object identifiers specifying objects that are
allowed to be selected
Returns: Guid * bool * SelectionMethod * Point3d * string
(Guid * bool * float * Point3d * string) Tuple containing the following information
[0] identifier of the object
[1] True if the object was preselected, otherwise False
[2] selection method Enum DocObjects.SelectionMethod
(0) selected by non-mouse method (SelAll, etc.).
(1) selected by mouse click on the object.
(2) selected by being inside of a mouse window.
(3) selected by intersecting a mouse crossing window.
[3] selection point
[4] name of the view selection was made.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Prompts user to pick, or select a single object. Raises a RhinoUserInteractionException if no object was selected. For example when Esc key was pressed.
|
Full Usage:
RhinoScriptSyntax.GetObjectGrip(?message, ?preselect, ?select)
Parameters:
string
-
(string) Optional. Prompt for picking.
?preselect : bool
-
(bool) Optional, default value: false.
Allow for selection of preselected object grip.
?select : bool
-
(bool) Optional, default value: false.
Select the picked object grip.
Returns: Guid * int * Point3d
(Guid * int * Point3d) A grip record tuple:
[0] = identifier of the object that owns the grip
[1] = index value of the grip
[2] = location of the grip.
|
Prompts the user to pick a single object grip. Fails if selection is empty.
|
Full Usage:
RhinoScriptSyntax.GetObjectGrips(?message, ?preselect, ?select)
Parameters:
string
-
(string) Optional. Prompt for picking.
?preselect : bool
-
(bool) Optional, default value: false.
Allow for selection of preselected object grips.
?select : bool
-
(bool) Optional, default value: false.
Select the picked object grips.
Returns: ResizeArray<Guid * int * Point3d>
((Guid * int * Point3d) ResizeArray) containing one or more grip records. Each grip record is a tuple:
[n][0] = identifier of the object that owns the grip
[n][1] = index value of the grip
[n][2] = location of the grip.
|
Prompts the user to pick one or more object grips from one or more objects.
|
Full Usage:
RhinoScriptSyntax.GetObjectRef(?message, ?filter, ?preselect, ?select, ?customFilter, ?subObjects)
Parameters:
string
-
(string) Optional, A prompt or message
?filter : int
-
(int) Optional, The type(s) of geometry (points, Curves, Surfaces, Meshes,...)
that can be selected. Object types can be added together to filter
several different kinds of geometry. use the RhinoScriptSyntax.Filter enum to get values, they can be joined with '+'
?preselect : bool
-
(bool) Optional, default value: true
Allow for the selection of pre-selected objects
?select : bool
-
(bool) Optional, default value: false
Select the picked objects. If False, the objects that are
picked are not selected
?customFilter : GetObjectGeometryFilter
-
(Input.Custom.GetObjectGeometryFilter) Optional, A custom filter function
?subObjects : bool
-
(bool) Optional, default value: false
If True, sub-objects can be selected. When this is the
case, the returned reference retains the selected component
Returns: ObjRef
(DocObjects.ObjRef) Reference retaining the selected subobject. The caller must dispose it when finished.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Prompts user to pick a single object or subobject and returns its object reference. Raises a RhinoUserInteractionException if no object was selected. For example when Esc key was pressed.
|
Full Usage:
RhinoScriptSyntax.GetObjects(?message, ?filter, ?group, ?preselect, ?select, ?objectsToSelectFrom, ?minimumCount, ?maximumCount, ?printCount, ?customFilter)
Parameters:
string
-
(string) Optional, default value: "Select objects"
A prompt or message
?filter : int
-
(int) Optional, The type(s) of geometry (points, Curves, Surfaces, Meshes,...)
that can be selected. Object types can be added together to filter
several different kinds of geometry. use the RhinoScriptSyntax.Filter enum to get values, they can be joined with '+'
?group : bool
-
(bool) Optional, default value: true
Honor object grouping. If omitted and the user picks a group,
the entire group will be picked (True). Note, if filter is set to a
value other than 0 (All objects), then group selection will be disabled
?preselect : bool
-
(bool) Optional, default value: true
Allow for the selection of pre-selected objects
?select : bool
-
(bool) Optional, default value: false
Select the picked objects. If False, the objects that are
picked are not selected
?objectsToSelectFrom : Guid
-
(Guid seq) Optional, List of objects that are allowed to be selected. If customFilter is also supplied, both filters must accept the object
?minimumCount : int
-
(int) Optional, default value: 1
Minimum count of objects allowed to be selected
?maximumCount : int
-
(int) Optional, default value: 0
Maximum count of objects allowed to be selected
?printCount : bool
-
(bool) Optional, default value: false Print object count to command window.
?customFilter : GetObjectGeometryFilter
-
(Input.Custom.GetObjectGeometryFilter) Optional, Calls a custom function in the script and passes
the Rhino Object, Geometry, and component index and returns true or false indicating if the object can be selected
Returns: ResizeArray<Guid>
(Guid ResizeArray) List of identifiers of the picked objects.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Prompts user to pick or select one or more objects. Raises a RhinoUserInteractionException if no object was selected. For example when Esc key was pressed.
|
Full Usage:
RhinoScriptSyntax.GetObjectsEx(?message, ?filter, ?group, ?preselect, ?select, ?printCount, ?objectsToSelectFrom)
Parameters:
string
-
(string) Optional, default value: "Select objects"
A prompt or message
?filter : int
-
(int) Optional, default value: 0
The type(s) of geometry (points, Curves, Surfaces, Meshes,...)
that can be selected. Object types can be added together to filter
several different kinds of geometry. use the filter class to get values
?group : bool
-
(bool) Optional, default value: true
Honor object grouping. If omitted and the user picks a group,
the entire group will be picked (True). Note, if filter is set to a
value other than 0 (All objects), then group selection will be disabled
?preselect : bool
-
(bool) Optional, default value: true
Allow for the selection of pre-selected objects
?select : bool
-
(bool) Optional, default value: false
Select the picked objects. If False, the objects that are
picked are not selected
?printCount : bool
-
(bool) Optional, default value: false Print object count to command window
?objectsToSelectFrom : Guid
-
(Guid seq) Optional, List of object identifiers specifying objects that are
allowed to be selected
Returns: ResizeArray<Guid * bool * SelectionMethod * Point3d * string>
((Guid*bool*int*Point3d*string) ResizeArray) List containing the following information
[n][0] identifier of the object
[n][1] True if the object was preselected, otherwise False
[n][2] selection method (DocObjects.SelectionMethod)
[n][3] selection point
[n][4] name of the view selection was made.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Prompts user to pick, or select one or more objects. Raises a RhinoUserInteractionException if no object was selected. For example when Esc key was pressed.
|
Full Usage:
RhinoScriptSyntax.GetPlugInObject(plugInId)
Parameters:
Guid
-
(Guid) The Guid of a registered plug-in that supports scripting.
If the plug-in is registered but not loaded, it will be loaded
Returns: obj
(object) a scriptable plugin object.
|
Returns a scriptable object from a specified plug-in. Not all plug-ins contain scriptable objects. Check with the manufacturer of your plug-in to see if they support this capability.
|
Full Usage:
RhinoScriptSyntax.GetPlugInObject(plugIn)
Parameters:
string
-
(string) The name of a registered plug-in that supports scripting.
If the plug-in is registered but not loaded, it will be loaded
Returns: obj
(object) a scriptable plugin object.
|
Returns a scriptable object from a specified plug-in. Not all plug-ins contain scriptable objects. Check with the manufacturer of your plug-in to see if they support this capability.
|
Full Usage:
RhinoScriptSyntax.GetPoint(?message, ?basePoint, ?distance, ?inPlane)
Parameters:
string
-
(string) Optional, A prompt or message
?basePoint : Point3d
-
(Point3d) Optional, Point3d identifying a starting, or base point
?distance : float
-
(float) Optional, Constraining distance. If distance is specified, basePoint must also be specified
?inPlane : bool
-
(bool) Optional, default value: false
Constrains the point selections to the active construction Plane
Returns: Point3d
(Point3d) point3d.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Pauses for user input of a point.
|
Full Usage:
RhinoScriptSyntax.GetPointCoordinates(?message, ?preselect)
Parameters:
string
-
(string) Optional, default value: "Select Point Objects"
A prompt message
?preselect : bool
-
(bool) Optional, default value: false
Allow for the selection of pre-selected objects. If omitted, pre-selected objects are not accepted
Returns: ResizeArray<Point3d>
(Point3d ResizeArray) List of 3d points.
|
Prompts the user to select one or more point objects.
|
Full Usage:
RhinoScriptSyntax.GetPointOnCurve(curveGeo, ?message)
Parameters:
Curve
-
(Curve) Curve geometry to get a point on
?message : string
-
(string) Optional, default value: "Pick Point On Curve"
A prompt of message
Returns: Point3d
(Point3d) 3d point.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Pauses for user input of a point constrained to a Curve object.
|
Full Usage:
RhinoScriptSyntax.GetPointOnCurve(curveId, ?message)
Parameters:
Guid
-
(Guid) Identifier of the Curve to get a point on
?message : string
-
(string) Optional, default value: "Pick Point On Curve"
A prompt of message
Returns: Point3d
(Point3d) 3d point.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Pauses for user input of a point constrained to a Curve object.
|
Full Usage:
RhinoScriptSyntax.GetPointOnMesh(meshId, ?message)
Parameters:
Guid
-
(Guid) Identifier of the Mesh to get a point on
?message : string
-
(string) Optional, default value: "Pick Point On Mesh"
A prompt or message
Returns: Point3d
(Point3d) 3d point.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Pauses for user input of a point constrained to a Mesh object.
|
Full Usage:
RhinoScriptSyntax.GetPointOnSurface(surfaceGeo, ?message)
Parameters:
GeometryBase
-
(GeometryBase) Surface or Brep geometry to get a point on
?message : string
-
(string) Optional, default value: "Pick Point on Surface or Polysurface"
A prompt or message
Returns: Point3d
(Point3d) 3d point.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Pauses for user input of a point constrained to a Surface or Polysurface object.
|
Full Usage:
RhinoScriptSyntax.GetPointOnSurface(surfaceId, ?message)
Parameters:
Guid
-
(Guid) Identifier of the Surface to get a point on
?message : string
-
(string) Optional, default value: "Pick Point on Surface or Polysurface"
A prompt or message
Returns: Point3d
(Point3d) 3d point.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Pauses for user input of a point constrained to a Surface or Polysurface object.
|
Full Usage:
RhinoScriptSyntax.GetPoints(?drawLines, ?inPlane, ?message1, ?message2, ?maxPoints)
Parameters:
bool
-
(bool) Optional, default value: false
Draw lines between points
?inPlane : bool
-
(bool) Optional, default value: false
Constrain point selection to the active construction Plane
?message1 : string
-
(string) Optional, A prompt or message for the first point
?message2 : string
-
(string) Optional, A prompt or message for the next points
?maxPoints : int
-
(int) Optional, Maximum number of points to pick. If not specified, an
unlimited number of points can be picked
Returns: ResizeArray<Point3d>
(Point3d array) 3d points.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Pauses for user input of one or more points.
|
Full Usage:
RhinoScriptSyntax.GetPolyline(?message1, ?message2, ?message3, ?message4, ?min, ?max)
Parameters:
string
-
(string) Optional, A prompt or message for the first point
?message2 : string
-
(string) Optional, A prompt or message for the second point
?message3 : string
-
(string) Optional, A prompt or message for the third point
?message4 : string
-
(string) Optional, A prompt or message for the 'next' point
?min : int
-
(int) Optional, default value: 2
The minimum number of points to require. The default is 2
?max : int
-
(int) Optional, default value: 0
The maximum number of points to require; 0 for no limit.
Returns: Polyline
(Polyline) a polyline.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Prompts the user to pick points that define a polyline.
|
Full Usage:
RhinoScriptSyntax.GetReal(?message, ?number, ?minimum, ?maximum)
Parameters:
string
-
(string) Optional, default value: "Number"
A prompt or message
?number : float
-
(float) Optional, A default number value
?minimum : float
-
(float) Optional, A minimum allowable value
?maximum : float
-
(float) Optional, A maximum allowable value
Returns: float
(float) The number input by the user.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Pauses for user input of a number.
|
Full Usage:
RhinoScriptSyntax.GetRectangle(?mode, ?basePoint, ?prompt1, ?prompt2, ?prompt3)
Parameters:
int
-
(int) Optional, default value: 0
The rectangle selection mode. The modes are as follows
0 = All modes
1 = Corner - a rectangle is created by picking two corner points
2 = 3Point - a rectangle is created by picking three points
3 = Vertical - a vertical rectangle is created by picking three points
4 = Center - a rectangle is created by picking a center point and a corner point
?basePoint : Point3d
-
(Point3d) Optional, A 3d base point
?prompt1 : string
-
(string) Optional, Prompt1 of optional prompts
?prompt2 : string
-
(string) Optional, Prompt2 of optional prompts
?prompt3 : string
-
(string) Optional, Prompt3 of optional prompts
Returns: Point3d * Point3d * Point3d * Point3d
(Point3d * Point3d * Point3d * Point3d) Four 3d points that define the corners of the rectangle.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Pauses for user input of a rectangle.
|
Full Usage:
RhinoScriptSyntax.GetString(?message, ?defaultValString, ?strings)
Parameters:
string
-
(string) Optional, A prompt or message
?defaultValString : string
-
(string) Optional, A default value
?strings : string
-
(string seq) Optional, List of strings to be displayed as a click-able command options.
Note, strings cannot begin with a numeric character
Returns: string
(string) The string either input or selected by the user .
If the user presses the Enter key without typing in a string, an empty string "" is returned.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Pauses for user input of a string value.
|
Full Usage:
RhinoScriptSyntax.GetSurfaceObject(?message, ?preselect, ?select)
Parameters:
string
-
(string) Optional, default value: "Select Surface"
Prompt displayed
?preselect : bool
-
(bool) Optional, default value: true
Allow for preselected objects
?select : bool
-
(bool) Optional, default value: false
Select the picked object
Returns: Guid * bool * SelectionMethod * Point3d * (float * float) * string
((Guid * bool * DocObjects.SelectionMethod * Point3d * (float * float) * string))
[0] identifier of the Surface
[1] True if the Surface was preselected, otherwise False
[2] selection method ( DocObjects.SelectionMethod )
[3] selection point
[4] u, v Surface parameter of the selection point
[5] name of the view in which the selection was made.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Prompts the user to select a single Surface. Raises a RhinoUserInteractionException if no object was selected. For example when Esc key was pressed.
|
Full Usage:
RhinoScriptSyntax.GetUserText(objectId, key, ?attachedToGeometry)
Parameters:
Guid
-
(Guid) The object's identifier
key : string
-
(string) The key name
?attachedToGeometry : bool
-
(bool) Optional, default value: false
Location on the object to retrieve the user text
Returns: string
(string) If key is specified, the associated value. Fails if non-existing.
|
Returns user text stored on an object, fails if non-existing.
|
Full Usage:
RhinoScriptSyntax.GetUserTextKeys(objectId, ?attachedToGeometry)
Parameters:
Guid
-
(Guid) The object's identifier
?attachedToGeometry : bool
-
(bool) Optional, default value: false
Location on the object to retrieve the user text
Returns: ResizeArray<string>
(string ResizeArray) All keys.
|
Returns all user text keys stored on an object.
|
Full Usage:
RhinoScriptSyntax.GroupCount()
Returns: int
(int) The number of groups in the document.
|
Returns the number of groups in the document.
|
Full Usage:
RhinoScriptSyntax.GroupNames()
Returns: string array
(string array) The names of all the groups in the document. An empty array if no names exist in the document.
|
Returns the names of all the groups in the document. Returns an empty array if no names exist in the document.
|
Full Usage:
RhinoScriptSyntax.GroupObjects(objectIds, groupName)
Parameters:
Guid seq
-
(Guid seq) List of Guids representing the object identifiers.
groupName : string
-
(string) The name of the group to create.
|
Adds two or more objects to a new group, sets group name.
|
Full Usage:
RhinoScriptSyntax.GroupObjects(objectIds)
Parameters:
Guid seq
-
(Guid seq) List of Guids representing the object identifiers.
|
Adds two or more objects to a new group.
|
Full Usage:
RhinoScriptSyntax.HasUserText(objectId, key, ?attachedToGeometry)
Parameters:
Guid
-
(Guid) The object's identifier
key : string
-
(string) The key name
?attachedToGeometry : bool
-
(bool) Optional, default value: false Location on the object to retrieve the user text
Returns: bool
(bool) If key exists, true.
|
Checks if a User Text key is stored on an object.
|
Full Usage:
RhinoScriptSyntax.HatchPattern(hatchGeo)
Parameters:
Hatch
-
(Hatch) The Hatch geometry
Returns: string
(string) The current Hatch pattern.
|
Returns a Hatch object's Hatch pattern.
|
Full Usage:
RhinoScriptSyntax.HatchPattern(hatchIds, hatchPattern)
Parameters:
Guid seq
-
(Guid seq) Identifiers of multiple Hatch objects
hatchPattern : string
-
(string) Name of existing Hatch pattern to replace the
current Hatch pattern
|
Changes multiple Hatch objects' Hatch pattern.
|
Full Usage:
RhinoScriptSyntax.HatchPattern(hatchId, hatchPattern)
Parameters:
Guid
-
(Guid) Identifier of a Hatch object
hatchPattern : string
-
(string) Name of an existing Hatch pattern to replace the
current Hatch pattern
|
Changes a Hatch object's Hatch pattern.
|
Full Usage:
RhinoScriptSyntax.HatchPattern(hatchId)
Parameters:
Guid
-
(Guid) Identifier of a Hatch object
Returns: string
(string) The current Hatch pattern.
|
Returns a Hatch object's Hatch pattern.
|
Full Usage:
RhinoScriptSyntax.HatchPatternCount()
Returns: int
(int) The number of Hatch patterns in the document.
|
Returns the number of Hatch patterns in the document.
|
Full Usage:
RhinoScriptSyntax.HatchPatternDescription(hatchPattern)
Parameters:
string
-
(string) Name of an existing Hatch pattern
Returns: string
(string) description of the Hatch pattern.
|
Returns the description of a Hatch pattern. Note, not all Hatch patterns have descriptions.
|
Full Usage:
RhinoScriptSyntax.HatchPatternFillType(hatchPattern)
Parameters:
string
-
(string) Name of an existing Hatch pattern
Returns: int
(int) Hatch pattern's fill type
0 = solid, uses object color
1 = lines, uses pattern file definition
2 = gradient, uses fill color definition.
|
Returns the fill type of a Hatch pattern.
|
Full Usage:
RhinoScriptSyntax.HatchPatternNames()
Returns: ResizeArray<string>
(string ResizeArray) The names of all of the Hatch patterns in the document.
|
Returns the names of all of the Hatch patterns in the document.
|
Full Usage:
RhinoScriptSyntax.HatchRotation(hatchGeo)
Parameters:
Hatch
-
(Hatch) The Hatch geometry
Returns: float
(float) The current hatch pattern rotation angle in degrees.
|
Returns the rotation in degrees applied to the Hatch pattern when it is mapped to the Hatch's Plane.
|
Full Usage:
RhinoScriptSyntax.HatchRotation(hatchIds, rotationDegrees)
Parameters:
Guid seq
-
(Guid seq) Identifiers of multiple Hatch objects
rotationDegrees : float
-
(float) Rotation angle in degrees
|
Modifies the rotation applied to the Hatch pattern when it is mapped to the Hatch's Plane.
|
Full Usage:
RhinoScriptSyntax.HatchRotation(hatchId, rotationDegrees)
Parameters:
Guid
-
(Guid) Identifier of a Hatch object
rotationDegrees : float
-
(float) Rotation angle in degrees
|
Modifies the rotation applied to the Hatch pattern when it is mapped to the Hatch's Plane.
|
Full Usage:
RhinoScriptSyntax.HatchRotation(hatchId)
Parameters:
Guid
-
(Guid) Identifier of a Hatch object
Returns: float
(float) The current hatch pattern rotation angle in degrees.
|
Returns the rotation in degrees applied to the Hatch pattern when it is mapped to the Hatch's Plane.
|
Full Usage:
RhinoScriptSyntax.HatchScale(hatchGeo)
Parameters:
Hatch
-
(Hatch) The Hatch geometry
Returns: float
(float) if scale is not defined, the current scale factor.
|
Returns the scale applied to the Hatch pattern when it is mapped to the Hatch's Plane.
|
Full Usage:
RhinoScriptSyntax.HatchScale(hatchIds, scale)
Parameters:
Guid seq
-
(Guid seq) Identifiers of multiple Hatch objects
scale : float
-
(float) Scale factor
|
Modifies the scale applied to the Hatch pattern when it is mapped to the Hatch's Plane.
|
Full Usage:
RhinoScriptSyntax.HatchScale(hatchId, scale)
Parameters:
Guid
-
(Guid) Identifier of a Hatch object
scale : float
-
(float) Scale factor
|
Modifies the scale applied to the Hatch pattern when it is mapped to the Hatch's Plane.
|
Full Usage:
RhinoScriptSyntax.HatchScale(hatchId)
Parameters:
Guid
-
(Guid) Identifier of a Hatch object
Returns: float
(float) if scale is not defined, the current scale factor.
|
Returns the scale applied to the Hatch pattern when it is mapped to the Hatch's Plane.
|
Full Usage:
RhinoScriptSyntax.HiddenObjects(?includeLights, ?includeGrips, ?includeReferences)
Parameters:
bool
-
(bool) Optional, default value: false
Include light objects
?includeGrips : bool
-
(bool) Optional, default value: false
Include grip objects
?includeReferences : bool
-
(bool) Optional, default value: false
Include reference objects such as work session objects
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers of the hidden objects.
|
Returns identifiers of all hidden objects in the document. Hidden objects are not visible, cannot be snapped to, and cannot be selected.
|
Full Usage:
RhinoScriptSyntax.HideGroup(groupName)
Parameters:
string
-
(string) The name of an existing group
Returns: int
(int) The number of objects that were hidden.
|
Hides a group of objects. Hidden objects are not visible, cannot be snapped to, and cannot be selected.
|
Full Usage:
RhinoScriptSyntax.HideObject(objectId)
Parameters:
Guid
-
(Guid) Id of object to hide
Returns: bool
(bool) True of False indicating success or failure.
|
Hides a single object.
|
Full Usage:
RhinoScriptSyntax.HideObjects(objectIds)
Parameters:
Guid seq
-
(Guid seq) Identifiers of objects to hide
Returns: int
(int) Number of objects hidden.
|
Hides one or more objects.
|
Full Usage:
RhinoScriptSyntax.InCommand()
Returns: int
(int) The number of active commands.
|
Determines if Rhino is currently running a command. Because Rhino allows for transparent commands (commands run from inside of other commands), this method returns the total number of active commands.
|
Full Usage:
RhinoScriptSyntax.InsertBlock(blockName, insertionPoint, ?scale, ?angleDegrees, ?rotationNormal)
Parameters:
string
-
(string) Name of an existing block definition
insertionPoint : Point3d
-
(Point3d) Insertion point for the block
?scale : Vector3d
-
(Vector3d) Optional, default value: Vector3d(1.0 , 1.0 , 1.0)
X, y, z scale factors
?angleDegrees : float
-
(float) Optional, default value: 0
Rotation angle in degrees
?rotationNormal : Vector3d
-
(Vector3d) Optional, default value: Vector3d.ZAxis
The axis of rotation
Returns: Guid
(Guid) objectId for the block that was added to the doc.
|
Inserts a block whose definition already exists in the document.
|
|
|
Full Usage:
RhinoScriptSyntax.InsertCurveKnot(curveId, parameter, ?symmetrical)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
parameter : float
-
(float) Parameter on the Curve
?symmetrical : bool
-
(bool) Optional, default value: false
If True, then knots are added on both sides of
the center of the Curve
Returns: bool
(bool) True or False indicating success or failure.
|
Inserts a knot into a Curve object.
|
Full Usage:
RhinoScriptSyntax.InstallFolder()
Returns: string
(string) The full path to Rhino's installation folder.
|
The full path to Rhino's installation folder.
|
Full Usage:
RhinoScriptSyntax.IntersectBreps(brep1, brep2, ?tolerance)
Parameters:
Brep
-
(Brep) Object of first brep object
brep2 : Brep
-
(Brep) Object of second brep object
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Distance tolerance at segment midpoints. If omitted,
the current absolute tolerance is used
Returns: ResizeArray<GeometryBase>
(GeometryBase ResizeArray) Newly created geometry. The caller owns the returned objects.
|
Intersects a brep object with another brep object. Note, unlike the SurfaceSurfaceIntersection function this function works on trimmed Surfaces. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.IntersectBreps(brep1, brep2, ?tolerance)
Parameters:
Guid
-
(Guid) Identifier of first brep object
brep2 : Guid
-
(Guid) Identifier of second brep object
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Distance tolerance at segment midpoints. If omitted,
the current absolute tolerance is used
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifying the newly created intersection Curve and point objects.
|
Intersects a brep object with another brep object. Note, unlike the SurfaceSurfaceIntersection function this function works on trimmed Surfaces.
|
Full Usage:
RhinoScriptSyntax.IntersectPlanes(plane1, plane2, plane3)
Parameters:
Plane
-
(Plane) The first plane to intersect
plane2 : Plane
-
(Plane) The second plane to intersect
plane3 : Plane
-
(Plane) The third plane to intersect
Returns: Point3d
(Point3d) The intersection point between the three planes.
|
|
Full Usage:
RhinoScriptSyntax.IntersectSpheres(spherePlane0, sphereRadius0, spherePlane1, sphereRadius1)
Parameters:
Plane
-
(Plane) An equatorial Plane of the first sphere. The origin of the
Plane will be the center point of the sphere
sphereRadius0 : float
-
(float) Radius of the first sphere
spherePlane1 : Plane
-
(Plane) Plane for second sphere
sphereRadius1 : float
-
(float) Radius for second sphere
Returns: int * Circle * float
(int * Circle * float ) of intersection results
[0] = type of intersection (0 = point, 1 = circle, 2 = spheres are identical)
[1] = Circle of intersection , if type is Point take Circle center
[2] = radius of circle if circle intersection.
|
Calculates intersections of two spheres.
|
Full Usage:
RhinoScriptSyntax.InvertSelectedObjects(?includeLights, ?includeGrips, ?includeReferences)
Parameters:
bool
-
(bool) Optional, default value: false
Include light objects. If omitted, light objects are not returned
?includeGrips : bool
-
(bool) Optional, default value: false
Include grips objects. If omitted, grips objects are not returned
?includeReferences : bool
-
(bool) Optional, default value: false
Include reference objects such as work session objects
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers of the newly selected objects.
|
Inverts the current object selection. The identifiers of the newly selected objects are returned.
|
Full Usage:
RhinoScriptSyntax.IsAlias(alias)
Parameters:
string
-
(string) The name of an existing command alias
Returns: bool
(bool) True if exists or False if the alias does not exist.
|
Checks if a command alias exists in Rhino.
|
Full Usage:
RhinoScriptSyntax.IsAlignedDimension(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The geometry to test
Returns: bool
(bool) True or False.
|
Checks if an object is an aligned dimension object. Returns false for any other Rhino object or if the geometry is null.
|
Full Usage:
RhinoScriptSyntax.IsAlignedDimension(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) True or False.
|
Checks if an object is an aligned dimension object. Returns false for any other Rhino object or if the object does not exist.
|
Full Usage:
RhinoScriptSyntax.IsAngularDimension(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The geometry to test
Returns: bool
(bool) True or False.
|
Checks if an object is an angular dimension object. Returns false for any other Rhino object or if the geometry is null.
|
Full Usage:
RhinoScriptSyntax.IsAngularDimension(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) True or False.
|
Checks if an object is an angular dimension object. Returns false for any other Rhino object or if the object does not exist.
|
Full Usage:
RhinoScriptSyntax.IsArc(curveGeo, ?tolerance, ?segmentIndex)
Parameters:
GeometryBase
-
(GeometryBase) The input geometry.
?tolerance : float
-
(float) Optional, default value: RhinoMath.ZeroTolerance
If the Curve is not a circle, then the tolerance used
to determine whether or not the NURBS form of the Curve has the
properties of a arc.
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: bool
(bool) True or False.
|
Checks if an object is an open arc Curve. Returns false for any other Rhino object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.IsArc(curveId, ?tolerance, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?tolerance : float
-
(float) Optional, default value: RhinoMath.ZeroTolerance
If the Curve is not a circle, then the tolerance used
to determine whether or not the NURBS form of the Curve has the
properties of a arc.
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: bool
(bool) True or False.
|
Checks if an object is an open arc Curve. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsBlock(blockName)
Parameters:
string
-
(string) Name of an existing block definition
Returns: bool
(bool) True or False.
|
Checks if the existence of a block definition in the document.
|
Full Usage:
RhinoScriptSyntax.IsBlockEmbedded(blockName)
Parameters:
string
-
(string) Name of an existing block definition
Returns: bool
(bool) True or False.
|
Checks if a block definition is embedded, or linked, from an external file.
|
Full Usage:
RhinoScriptSyntax.IsBlockInUse(blockName, ?whereToLook)
Parameters:
string
-
(string) Name of an existing block definition
?whereToLook : int
-
(int) Optional, default value: 0
One of the following values:
0 = Check for top level references in active document
1 = Check for top level and nested references in active document
2 = Check for references in other instance definitions
Returns: bool
(bool) True or False.
|
Checks if a block definition is being used by an inserted instance.
|
Full Usage:
RhinoScriptSyntax.IsBlockInstance(objectId)
Parameters:
Guid
-
(Guid) The identifier of an existing block insertion object
Returns: bool
(bool) True or False.
|
Checks if an object is a block instance. Returns false for any other rhino object.
|
Full Usage:
RhinoScriptSyntax.IsBlockReference(blockName)
Parameters:
string
-
(string) Name of an existing block definition
Returns: bool
(bool) True or False.
|
Checks if that a block definition is from a reference file.
|
Full Usage:
RhinoScriptSyntax.IsBrep(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The object
Returns: bool
(bool) True if successful, otherwise False.
|
Verifies an object is a Brep. That is a trimmed surface or a polysurface but not an extrusion. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.IsBrep(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) True if successful, otherwise False.
|
Verifies an object is a Brep. That is a trimmed surface or a polysurface but not an extrusion.
|
Full Usage:
RhinoScriptSyntax.IsCircle(curveGeo, ?tolerance)
Parameters:
GeometryBase
-
(GeometryBase) The input geometry.
?tolerance : float
-
(float) Optional, default value: RhinoMath.ZeroTolerance
If the Curve is not a circle, then the tolerance used
to determine whether or not the NURBS form of the Curve has the
properties of a circle.
Returns: bool
(bool) True or False.
|
Checks if an object is a circle Curve. Returns false for any other Rhino object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.IsCircle(curveId, ?tolerance)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?tolerance : float
-
(float) Optional, default value: RhinoMath.ZeroTolerance
If the Curve is not a circle, then the tolerance used
to determine whether or not the NURBS form of the Curve has the
properties of a circle.
Returns: bool
(bool) True or False.
|
Checks if an object is a circle Curve. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsClippingPlane(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) Geometry to use directly.
Returns: bool
(bool) True if the object with a given geometryObject is a clipping Plane.
|
Checks if that an object is a clipping Plane object. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsClippingPlane(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) True if the object with a given objectId is a clipping Plane.
|
Checks if that an object is a clipping Plane object. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsCommand(commandName)
Parameters:
string
-
(string) The command name to test
Returns: bool
(bool) True if the string is a command or False if it is not a command.
|
Checks if a command exists in Rhino. Useful when scripting commands found in 3rd party plug-ins.
|
Full Usage:
RhinoScriptSyntax.IsCone(geometryObject)
Parameters:
Surface
-
(Surface) The Surface object
Returns: bool
(bool) True , otherwise False.
|
Determines if a Surface is a portion of a cone. Returns false for any other Rhino object or if the object does not exist. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.IsCone(objectId)
Parameters:
Guid
-
(Guid) The Surface object's identifier
Returns: bool
(bool) True , otherwise False.
|
Determines if a Surface is a portion of a cone. Returns false for any other Rhino object or if the object does not exist.
|
Full Usage:
RhinoScriptSyntax.IsCurve(curveGeo)
Parameters:
GeometryBase
-
(GeometryBase) The input geometry.
Returns: bool
(bool) True or False.
|
Checks if an object is a Curve. Returns false for any other Rhino object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.IsCurve(curveId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) True or False.
|
Checks if an object is a Curve. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsCurveClosable(curveGeo, ?tolerance)
Parameters:
GeometryBase
-
(GeometryBase) The input geometry.
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Maximum allowable distance between start point and end point.
Returns: bool
(bool) True or False.
|
Decide if it makes sense to close off the Curve by moving the end point to the start point based on start-end gap size and length of Curve as approximated by chord defined by 6 points. Returns false for any other Rhino object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.IsCurveClosable(curveId, ?tolerance)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Maximum allowable distance between start point and end point.
Returns: bool
(bool) True or False.
|
Decide if it makes sense to close off the Curve by moving the end point to the start point based on start-end gap size and length of Curve as approximated by chord defined by 6 points. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsCurveClosed(curveGeo)
Parameters:
GeometryBase
-
(GeometryBase) The input geometry.
Returns: bool
(bool) If Curve is Closed True, otherwise False.
|
Checks if an object is a closed Curve object. Returns false for any other Rhino object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.IsCurveClosed(curveId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) If Curve is Closed True, otherwise False.
|
Checks if an object is a closed Curve object. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsCurveInPlane(curveGeo, plane, ?tolerance)
Parameters:
GeometryBase
-
(GeometryBase) The input geometry.
plane : Plane
-
(Plane) Plane to test
?tolerance : float
-
(float) Optional, default value: RhinoMath.ZeroTolerance
Returns: bool
(bool) True or False.
|
Test a Curve to see if it lies in a specific Plane. Returns false for any other Rhino object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.IsCurveLinear(curveGeo, ?tolerance, ?segmentIndex)
Parameters:
GeometryBase
-
(GeometryBase) The input geometry.
?tolerance : float
-
(float) Optional, default value: RhinoMath.ZeroTolerance
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: bool
(bool) True or False indicating success or failure.
|
Checks if an object is a linear Curve. Returns false for any other Rhino object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.IsCurveLinear(curveId, ?tolerance, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?tolerance : float
-
(float) Optional, default value: RhinoMath.ZeroTolerance
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: bool
(bool) True or False indicating success or failure.
|
Checks if an object is a linear Curve. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsCurvePeriodic(curveGeo, ?segmentIndex)
Parameters:
GeometryBase
-
(GeometryBase) The input geometry.
?segmentIndex : int
-
(int) Optional,
The Curve segment index if `curveId` identifies a PolyCurve
Returns: bool
(bool) True or False.
|
Checks if an object is a periodic Curve object. Returns false for any other Rhino object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.IsCurvePeriodic(curveId, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?segmentIndex : int
-
(int) Optional,
The Curve segment index if `curveId` identifies a PolyCurve
Returns: bool
(bool) True or False.
|
Checks if an object is a periodic Curve object. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsCurvePlanar(curveGeo, ?tolerance, ?segmentIndex)
Parameters:
GeometryBase
-
(GeometryBase) The input geometry.
?tolerance : float
-
(float) Optional, default value: RhinoMath.ZeroTolerance
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: bool
(bool) True or False indicating success or failure.
|
Checks if an object is a planar Curve. Returns false for any other Rhino object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.IsCurvePlanar(curveId, ?tolerance, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?tolerance : float
-
(float) Optional, default value: RhinoMath.ZeroTolerance
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: bool
(bool) True or False indicating success or failure.
|
Checks if an object is a planar Curve. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsCurveRational(curveGeo, ?segmentIndex)
Parameters:
GeometryBase
-
(GeometryBase) The input geometry.
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: bool
(bool) True or False indicating success or failure.
|
Checks if an object is a rational NURBS Curve. Returns false for any other Rhino object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.IsCurveRational(curveId, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: bool
(bool) True or False indicating success or failure.
|
Checks if an object is a rational NURBS Curve. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsCylinder(geometryObject)
Parameters:
Surface
-
(Surface) The cylinder object
Returns: bool
(bool) True , otherwise False.
|
Determines if a Surface is a portion of a cylinder. Returns false for any other Rhino object or if the object does not exist. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.IsCylinder(objectId)
Parameters:
Guid
-
(Guid) The cylinder object's identifier
Returns: bool
(bool) True , otherwise False.
|
Determines if a Surface is a portion of a cylinder. Returns false for any other Rhino object or if the object does not exist.
|
Full Usage:
RhinoScriptSyntax.IsDetail(layout, detail)
Parameters:
string
-
(string) Title of an existing page layout
detail : string
-
(string) Title of an existing detail view
Returns: bool
(bool) True if detail is a detail view, False if detail is not a detail view.
|
Checks if a detail view exists on a page layout view.
|
Full Usage:
RhinoScriptSyntax.IsDiameterDimension(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The geometry to test
Returns: bool
(bool) True or False.
|
Checks if an object is a diameter dimension object. Returns false for any other Rhino object or if the geometry is null.
|
Full Usage:
RhinoScriptSyntax.IsDiameterDimension(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) True or False.
|
Checks if an object is a diameter dimension object. Returns false for any other Rhino object or if the object does not exist.
|
Full Usage:
RhinoScriptSyntax.IsDimStyle(dimStyle)
Parameters:
string
-
(string) The name of a dimStyle to test for
Returns: bool
(bool) True or False.
|
Checks if the existence of a dimension style in the document. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsDimStyleReference(dimStyle)
Parameters:
string
-
(string) The name of an existing dimension style
Returns: bool
(bool) True or False.
|
Checks if that an existing dimension style is from a reference file. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsDimension(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The geometry to test
Returns: bool
(bool) True or False.
|
Checks if an object is a dimension object. Returns false for any other Rhino object or if the geometry is null.
|
Full Usage:
RhinoScriptSyntax.IsDimension(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) True or False.
|
Checks if an object is a dimension object. Returns false for any other Rhino object or if the object does not exist.
|
Full Usage:
RhinoScriptSyntax.IsDirectionalLight(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The geometry to test.
Returns: bool
(bool) True or False.
|
Verifies a light object is a directional light. Returns false for any other Rhino object or if the geometry is null.
|
Full Usage:
RhinoScriptSyntax.IsDirectionalLight(objectId)
Parameters:
Guid
-
(Guid) The light object's identifier
Returns: bool
(bool) True or False.
|
Verifies a light object is a directional light. Returns false for any other Rhino object or if the object does not exist.
|
Full Usage:
RhinoScriptSyntax.IsDocumentData()
Returns: bool
(bool) True or False indicating the presence of Script user data.
|
Checks if the current document contains user data.
|
Full Usage:
RhinoScriptSyntax.IsDocumentModified()
Returns: bool
(bool) True or False.
|
Checks if the current document has been modified in some way.
|
Full Usage:
RhinoScriptSyntax.IsDocumentUserText()
Returns: bool
(bool) True or False indicating the presence of Script user text.
|
Checks if the current document contains user text.
|
Full Usage:
RhinoScriptSyntax.IsEllipse(curveGeo, ?tolerance, ?segmentIndex)
Parameters:
GeometryBase
-
(GeometryBase) The input geometry.
?tolerance : float
-
(float) Optional, default value: RhinoMath.ZeroTolerance
?segmentIndex : int
-
(int) Optional,
The Curve segment index if `curveId` identifies a PolyCurve
Returns: bool
(bool) True or False indicating success or failure.
|
Checks if an object is an elliptical-shaped Curve. Returns false for any other Rhino object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.IsEllipse(curveId, ?tolerance, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?tolerance : float
-
(float) Optional, default value: RhinoMath.ZeroTolerance
?segmentIndex : int
-
(int) Optional,
The Curve segment index if `curveId` identifies a PolyCurve
Returns: bool
(bool) True or False indicating success or failure.
|
Checks if an object is an elliptical-shaped Curve. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsExtrusion(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The object
Returns: bool
(bool) True if successful, otherwise False.
|
Verifies an object is a or Extrusion. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.IsExtrusion(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) True if successful, otherwise False.
|
Verifies an object is a or Extrusion.
|
Full Usage:
RhinoScriptSyntax.IsGoodStringId(name, ?allowEmpty, ?limitToAscii)
Parameters:
string
-
(string) The string to check.
?allowEmpty : bool
-
(bool) Optional, default value: false , set to true to make empty strings pass.
?limitToAscii : bool
-
(bool) Optional, default value: false , set to true to only allow chars between Unicode points 32 till 126 (ASCII)
Returns: bool
(bool) true if the string is a valid name.
|
Checks if a string is a good string for use in Rhino Object Names or User Dictionary key as and values. A good string may not include line returns, tabs, and leading or trailing whitespace. Confusing characters that look like ASCII but are some other Unicode are also not allowed.
|
Full Usage:
RhinoScriptSyntax.IsGroup(groupName)
Parameters:
string
-
(string) The name of the group to check for
Returns: bool
(bool) True or False.
|
Verifies the existence of a group.
|
Full Usage:
RhinoScriptSyntax.IsGroupEmpty(groupName)
Parameters:
string
-
(string) The name of an existing group
Returns: bool
(bool) True or False if groupName is empty.
|
Checks if an existing group is empty, or contains no object members.
|
Full Usage:
RhinoScriptSyntax.IsHatch(geometry)
Parameters:
GeometryBase
-
(GeometryBase) The geometry to test.
Returns: bool
(bool) True if the geometry is a Hatch, otherwise false.
|
Tests whether the supplied geometry is a Hatch.
|
Full Usage:
RhinoScriptSyntax.IsHatch(objectId)
Parameters:
Guid
-
(Guid) Identifier of an object
Returns: bool
(bool) True or False.
|
Verifies the existence of a Hatch object in the document.
|
Full Usage:
RhinoScriptSyntax.IsHatchPattern(name)
Parameters:
string
-
(string) The name of a Hatch pattern
Returns: bool
(bool) True or False.
|
Verifies the existence of a Hatch pattern in the document.
|
Full Usage:
RhinoScriptSyntax.IsHatchPatternCurrent(hatchPattern)
Parameters:
string
-
(string) Name of an existing Hatch pattern
Returns: bool
(bool) True or False.
|
Checks if a Hatch pattern is the current Hatch pattern.
|
Full Usage:
RhinoScriptSyntax.IsHatchPatternReference(hatchPattern)
Parameters:
string
-
(string) Name of an existing Hatch pattern
Returns: bool
(bool) True or False.
|
Checks if a Hatch pattern is from a reference file.
|
Full Usage:
RhinoScriptSyntax.IsLayer(layer)
Parameters:
string
-
(string) The name of a layer to search for
Returns: bool
(bool) True on success, otherwise False.
|
Verifies the existence of a layer in the document.
|
Full Usage:
RhinoScriptSyntax.IsLayerChangeable(layer)
Parameters:
string
-
(string) The name of an existing layer
Returns: bool
(bool) True on success, otherwise False.
|
Checks if the objects on a layer can be changed (normal).
|
Full Usage:
RhinoScriptSyntax.IsLayerChildOf(layer, test)
Parameters:
string
-
(string) The name of the layer to test against
test : string
-
(string) The name to the layer to test
Returns: bool
(bool) True on success, otherwise False.
|
Checks if a layer is a child of another layer.
|
Full Usage:
RhinoScriptSyntax.IsLayerCurrent(layer)
Parameters:
string
-
(string) The name of an existing layer
Returns: bool
(bool) True on success, otherwise False.
|
Checks if a layer is the current layer.
|
Full Usage:
RhinoScriptSyntax.IsLayerEmpty(layer)
Parameters:
string
-
(string) The name of an existing layer
Returns: bool
(bool) True on success, otherwise False.
|
Checks if an existing layer is empty, or contains no objects.
|
Full Usage:
RhinoScriptSyntax.IsLayerExpanded(layer)
Parameters:
string
-
(string) The name of an existing layer
Returns: bool
(bool) True on success, otherwise False.
|
Checks if a layer is expanded. Expanded layers can be viewed in Rhino's layer dialog.
|
Full Usage:
RhinoScriptSyntax.IsLayerLocked(layer)
Parameters:
string
-
(string) The name of an existing layer
Returns: bool
(bool) True on success, otherwise False.
|
Checks if a layer is locked persistent or non persistent locking return true via layer.IsLocked.
|
Full Usage:
RhinoScriptSyntax.IsLayerOn(layer)
Parameters:
string
-
(string) The name of an existing layer
Returns: bool
(bool) True on success, otherwise False.
|
Checks if a layer is on.
|
Full Usage:
RhinoScriptSyntax.IsLayerParentOf(layer, test)
Parameters:
string
-
(string) The name of the layer to test against
test : string
-
(string) The name to the layer to test
Returns: bool
(bool) True on success, otherwise False.
|
Checks if a layer is a parent of another layer.
|
Full Usage:
RhinoScriptSyntax.IsLayerReference(layer)
Parameters:
string
-
(string) The name of an existing layer
Returns: bool
(bool) True on success, otherwise False.
|
Checks if a layer is from a reference file.
|
Full Usage:
RhinoScriptSyntax.IsLayerSelectable(layer)
Parameters:
string
-
(string) The name of an existing layer
Returns: bool
(bool) True on success, otherwise False.
|
Checks if an existing layer is selectable (normal and reference).
|
Full Usage:
RhinoScriptSyntax.IsLayerVisible(layer)
Parameters:
string
-
(string) The name of an existing layer
Returns: bool
(bool) True on success, otherwise False.
|
Checks if a layer is visible.
|
Full Usage:
RhinoScriptSyntax.IsLayout(layout)
Parameters:
string
-
(string) Title of an existing page layout view
Returns: bool
(bool) True if layout is a page layout view, False is layout is a standard model view.
|
Checks if a view is a page layout view.
|
Full Usage:
RhinoScriptSyntax.IsLayoutObject(objectId)
Parameters:
Guid
-
(Guid) Id of an object to test
Returns: bool
(bool) True if the object is in page layout space, False if the object is in model space.
|
Checks if an object is in on a page layout space. (as opposed to model space).
|
Full Usage:
RhinoScriptSyntax.IsLeader(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The geometry to test
Returns: bool
(bool) True or False.
|
Checks if an object is a dimension leader object. Returns false for any other Rhino object or if the geometry is null.
|
Full Usage:
RhinoScriptSyntax.IsLeader(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) True or False.
|
Checks if an object is a dimension leader object. Returns false for any other Rhino object or if the object does not exist.
|
Full Usage:
RhinoScriptSyntax.IsLight(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The geometry to test.
Returns: bool
(bool) True or False.
|
Verifies an object is a light object.
|
Full Usage:
RhinoScriptSyntax.IsLight(objectId)
Parameters:
Guid
-
(Guid) The light object's identifier
Returns: bool
(bool) True or False.
|
Verifies an object is a light object.
|
Full Usage:
RhinoScriptSyntax.IsLightEnabled(geometryObject)
Parameters:
Light
-
(Light) The light geometry to use.
Returns: bool
(bool) True or False.
|
Verifies a light object is enabled.
|
Full Usage:
RhinoScriptSyntax.IsLightEnabled(objectId)
Parameters:
Guid
-
(Guid) The light object's identifier
Returns: bool
(bool) True or False.
|
Verifies a light object is enabled.
|
Full Usage:
RhinoScriptSyntax.IsLightReference(objectId)
Parameters:
Guid
-
(Guid) The light object's identifier
Returns: bool
(bool) True or False.
|
Verifies a light object is referenced from another file.
|
Full Usage:
RhinoScriptSyntax.IsLine(curveGeo, ?tolerance, ?segmentIndex)
Parameters:
GeometryBase
-
(GeometryBase) The input geometry.
?tolerance : float
-
(float) Optional, default value: RhinoMath.ZeroTolerance
?segmentIndex : int
-
(int) Optional,
The Curve segment index if `curveId` identifies a PolyCurve
Returns: bool
(bool) True or False indicating success or failure.
|
Checks if an object is a line Curve. Returns false for any other Rhino object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.IsLine(curveId, ?tolerance, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?tolerance : float
-
(float) Optional, default value: RhinoMath.ZeroTolerance
?segmentIndex : int
-
(int) Optional,
The Curve segment index if `curveId` identifies a PolyCurve
Returns: bool
(bool) True or False indicating success or failure.
|
Checks if an object is a line Curve. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsLinearDimension(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The geometry to test
Returns: bool
(bool) True or False.
|
Checks if an object is a linear dimension object. Returns false for any other Rhino object or if the geometry is null.
|
Full Usage:
RhinoScriptSyntax.IsLinearDimension(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) True or False.
|
Checks if an object is a linear dimension object. Returns false for any other Rhino object or if the object does not exist.
|
Full Usage:
RhinoScriptSyntax.IsLinearLight(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The geometry to test.
Returns: bool
(bool) True or False.
|
Verifies a light object is a linear light. Returns false for any other Rhino object or if the geometry is null.
|
Full Usage:
RhinoScriptSyntax.IsLinearLight(objectId)
Parameters:
Guid
-
(Guid) The light object's identifier
Returns: bool
(bool) True or False.
|
Verifies a light object is a linear light. Returns false for any other Rhino object or if the object does not exist.
|
Full Usage:
RhinoScriptSyntax.IsLinetype(name)
Parameters:
string
-
(string) The name of an existing linetype
Returns: bool
(bool) True or False.
|
Verifies the existence of a linetype in the document. The name is not case sensitive.
|
Full Usage:
RhinoScriptSyntax.IsLinetypeReference(name)
Parameters:
string
-
(string) The name of an existing linetype
Returns: bool
(bool) True or False.
|
Checks if an existing linetype is from a reference file.
|
Full Usage:
RhinoScriptSyntax.IsMaterialDefault(materialIndex)
Parameters:
int
-
(int) The zero-based material index.
Returns: bool
(bool) True or False indicating success or failure.
|
Verifies a material is a copy of Rhino's built-in "default" material. The default material is used by objects and layers that have not been assigned a material.
|
Full Usage:
RhinoScriptSyntax.IsMaterialReference(materialIndex)
Parameters:
int
-
(int) The zero-based material index.
Returns: bool
(bool) True or False indicating success or failure.
|
Verifies a material is referenced from another file.
|
Full Usage:
RhinoScriptSyntax.IsMesh(geometry)
Parameters:
GeometryBase
-
(GeometryBase) Input geometry.
Returns: bool
(bool) True , otherwise False.
|
Verifies if an object is a Mesh.
|
Full Usage:
RhinoScriptSyntax.IsMesh(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) True , otherwise False.
|
Verifies if an object is a Mesh.
|
Full Usage:
RhinoScriptSyntax.IsMeshClosed(mesh)
Parameters:
Mesh
-
(Mesh) Input geometry.
Returns: bool
(bool) True , otherwise False.
|
Verifies a Mesh object is closed.
|
Full Usage:
RhinoScriptSyntax.IsMeshClosed(objectId)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object
Returns: bool
(bool) True , otherwise False.
|
Verifies a Mesh object is closed.
|
Full Usage:
RhinoScriptSyntax.IsMeshManifold(mesh)
Parameters:
Mesh
-
(Mesh) Input geometry.
Returns: bool
(bool) True, otherwise False.
|
Verifies a Mesh object is manifold. A Mesh for which every edge is shared by at most two faces is called manifold. If a Mesh has at least one edge that is shared by more than two faces, then that Mesh is called non-manifold.
|
Full Usage:
RhinoScriptSyntax.IsMeshManifold(objectId)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object
Returns: bool
(bool) True, otherwise False.
|
Verifies a Mesh object is manifold. A Mesh for which every edge is shared by at most two faces is called manifold. If a Mesh has at least one edge that is shared by more than two faces, then that Mesh is called non-manifold.
|
Full Usage:
RhinoScriptSyntax.IsObject(objectId)
Parameters:
Guid
-
(Guid) An object to test
Returns: bool
(bool) True if the object exists, False if the object does not exist.
|
Verifies the existence of an object in the State.Doc.Objects table. Fails on empty Guid.
|
Full Usage:
RhinoScriptSyntax.IsObjectHidden(objectId)
Parameters:
Guid
-
(Guid) The identifier of an object to test
Returns: bool
(bool) True if the object is hidden, False if the object is not hidden.
|
Checks if an object is hidden. Hidden objects are not visible, cannot be snapped to, and cannot be selected.
|
Full Usage:
RhinoScriptSyntax.IsObjectInBox(geometryObject, box, ?testMode)
Parameters:
GeometryBase
-
(GeometryBase) Input geometry.
box : BoundingBox
-
(Geometry.BoundingBox) Bounding box to test for containment
?testMode : bool
-
(bool) Optional, default value: true
If True, the object's bounding box must be contained by box
If False, the object's bounding box must be contained by or intersect box
Returns: bool
(bool) True if object is inside box, False is object is not inside box.
|
Verifies an object's bounding box is inside of another bounding box.
|
Full Usage:
RhinoScriptSyntax.IsObjectInBox(objectId, box, ?testMode)
Parameters:
Guid
-
(Guid) Identifier of an object to be tested
box : BoundingBox
-
(Geometry.BoundingBox) Bounding box to test for containment
?testMode : bool
-
(bool) Optional, default value: true
If True, the object's bounding box must be contained by box
If False, the object's bounding box must be contained by or intersect box
Returns: bool
(bool) True if object is inside box, False is object is not inside box.
|
Verifies an object's bounding box is inside of another bounding box.
|
Full Usage:
RhinoScriptSyntax.IsObjectInGroup(objectId, ?groupName)
Parameters:
Guid
-
(Guid) The identifier of an object
?groupName : string
-
(string) Optional, The name of a group. If omitted, the function checks if the object is a member of any group
Returns: bool
(bool) True if the object is a member of the specified group. If a groupName
was not specified, the object is a member of some group.
False if the object is not a member of the specified group.
If a groupName was not specified, the object is not a member of any group.
|
Checks if an object is a member of a group.
|
Full Usage:
RhinoScriptSyntax.IsObjectLocked(objectId)
Parameters:
Guid
-
(Guid) The identifier of an object to be tested
Returns: bool
(bool) True if the object is locked, False if the object is not locked.
|
Checks if an object is locked. Locked objects are visible, and can be snapped to, but cannot be selected.
|
Full Usage:
RhinoScriptSyntax.IsObjectNormal(objectId)
Parameters:
Guid
-
(Guid) The identifier of an object to be tested
Returns: bool
(bool) True if the object is normal, False if the object is not normal.
|
Checks if an object is normal. Normal objects are visible, can be snapped to, and can be selected.
|
Full Usage:
RhinoScriptSyntax.IsObjectReference(objectId)
Parameters:
Guid
-
(Guid) The identifier of an object to test
Returns: bool
(bool) True if the object is a reference object, False if the object is not a reference object.
|
Checks if an object is a reference object. Reference objects are objects that are not part of the current document.
|
Full Usage:
RhinoScriptSyntax.IsObjectSelectable(objectId)
Parameters:
Guid
-
(Guid) The identifier of an object to test
Returns: bool
(bool) True or False.
|
Checks if an object can be selected.
|
Full Usage:
RhinoScriptSyntax.IsObjectSelected(objectId)
Parameters:
Guid
-
(Guid) The identifier of an object to test
Returns: int
(int)
0, the object is not selected
1, the object is selected
2, the object is entirely persistently selected
3, one or more proper sub-objects are selected.
|
Checks if an object is currently selected.
|
Full Usage:
RhinoScriptSyntax.IsObjectSolid(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) Input geometry.
Returns: bool
(bool) True if the object is solid, or a Mesh is closed, False otherwise.
|
Determines if an object is closed or solid.
|
Full Usage:
RhinoScriptSyntax.IsObjectSolid(objectId)
Parameters:
Guid
-
(Guid) The identifier of an object to test
Returns: bool
(bool) True if the object is solid, or a Mesh is closed, False otherwise.
|
Determines if an object is closed or solid.
|
Full Usage:
RhinoScriptSyntax.IsObjectValid(objectId)
Parameters:
Guid
-
(Guid) The identifier of an object to test
Returns: bool
(bool) True if the object is valid.
|
Verifies an object's geometry is valid and without error.
|
Full Usage:
RhinoScriptSyntax.IsOrdinateDimension(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The geometry to test
Returns: bool
(bool) True or False.
|
Checks if an object is an ordinate dimension object. Returns false for any other Rhino object or if the geometry is null.
|
Full Usage:
RhinoScriptSyntax.IsOrdinateDimension(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) True or False.
|
Checks if an object is an ordinate dimension object. Returns false for any other Rhino object or if the object does not exist.
|
Full Usage:
RhinoScriptSyntax.IsPlaneSurface(geometryObject)
Parameters:
Surface
-
(Surface) The object
Returns: bool
(bool) True , otherwise False.
|
Verifies an object is a Plane Surface. Plane Surfaces can be created by the Plane command. Note, a Plane Surface is not a planar NURBS Surface. Returns false for any other Rhino object or if the object does not exist. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.IsPlaneSurface(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) True , otherwise False.
|
Verifies an object is a Plane Surface. Plane Surfaces can be created by the Plane command. Note, a Plane Surface is not a planar NURBS Surface. Returns false for any other Rhino object or if the object does not exist.
|
Full Usage:
RhinoScriptSyntax.IsPlugIn(pluginId)
Parameters:
Guid
-
(Guid) The Guid of the plug-in
Returns: bool
(bool) True if the Guid is registered or False if it is not.
|
Checks if a plug-in is registered.
|
Full Usage:
RhinoScriptSyntax.IsPlugIn(plugin)
Parameters:
string
-
(string) The name or identifier string of the plug-in
Returns: bool
(bool) True if the Guid is registered or False if it is not.
|
Checks if a plug-in is registered.
|
Full Usage:
RhinoScriptSyntax.IsPoint(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) Geometry to use directly.
Returns: bool
(bool) True if the object with a given geometryObject is a point.
|
Checks if an object is a point object. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsPoint(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) True if the object with a given objectId is a point.
|
Checks if an object is a point object. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsPointCloud(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) Geometry to use directly.
Returns: bool
(bool) True if the object with a given geometryObject is a point cloud.
|
Checks if an object is a point cloud object. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsPointCloud(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) True if the object with a given objectId is a point cloud.
|
Checks if an object is a point cloud object. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsPointInSurface(geometryObject, point, ?strictlyIn, ?tolerance)
Parameters:
GeometryBase
-
(GeometryBase) The object
point : Point3d
-
(Point3d) The test, or sampling point
?strictlyIn : bool
-
(bool) Optional, default value: false
If true, the test point must be inside by at least tolerance
?tolerance : float
-
(float) Optional, default value: RhinoMath.SqrtEpsilon
Distance tolerance used for intersection and determining
strict inclusion.
Returns: bool
(bool) True , otherwise False.
|
Checks if a point is inside a closed Mesh , Surface or Polysurface. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.IsPointInSurface(objectId, point, ?strictlyIn, ?tolerance)
Parameters:
Guid
-
(Guid) The object's identifier
point : Point3d
-
(Point3d) The test, or sampling point
?strictlyIn : bool
-
(bool) Optional, default value: false
If true, the test point must be inside by at least tolerance
?tolerance : float
-
(float) Optional, default value: RhinoMath.SqrtEpsilon
Distance tolerance used for intersection and determining
strict inclusion.
Returns: bool
(bool) True , otherwise False.
|
Checks if a point is inside a closed Mesh , Surface or Polysurface.
|
Full Usage:
RhinoScriptSyntax.IsPointLight(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The geometry to test.
Returns: bool
(bool) True or False.
|
Verifies a light object is a point light. Returns false for any other Rhino object or if the geometry is null.
|
Full Usage:
RhinoScriptSyntax.IsPointLight(objectId)
Parameters:
Guid
-
(Guid) The light object's identifier
Returns: bool
(bool) True or False.
|
Verifies a light object is a point light. Returns false for any other Rhino object or if the object does not exist.
|
Full Usage:
RhinoScriptSyntax.IsPointOnCurve(curveGeo, point, ?tolerance, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
point : Point3d
-
(Point3d) The test point
?tolerance : float
-
(float) Optional, default value: RhinoMath.SqrtEpsilon
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: bool
(bool) True or False indicating success or failure.
|
Checks if a point is on a Curve. Returns false for any other Rhino object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.IsPointOnCurve(curveId, point, ?tolerance, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
point : Point3d
-
(Point3d) The test point
?tolerance : float
-
(float) Optional, default value: RhinoMath.SqrtEpsilon
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: bool
(bool) True or False indicating success or failure.
|
Checks if a point is on a Curve. Returns false for any other Rhino object.
|
|
|
Full Usage:
RhinoScriptSyntax.IsPointOnMesh(objectId, point, ?tolerance)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object
point : Point3d
-
(Point3d) Test point
?tolerance : float
-
(float) Optional, Default Value RhinoMath.SqrtEpsilon
The testing tolerance
Returns: bool
(bool) True , otherwise False.
|
|
Full Usage:
RhinoScriptSyntax.IsPointOnSurface(geometryObject, point)
Parameters:
GeometryBase
-
(GeometryBase) The object
point : Point3d
-
(Point3d) The test, or sampling point
Returns: bool
(bool) True , otherwise False.
|
Checks if a point lies on a Surface. Uses the supplied objects directly. A Polysurface with a single face is accepted, a Polysurface with several faces raises a RhinoScriptingException, like in RhinoPython.
|
|
Checks if a point lies on a Surface. A Polysurface with a single face is accepted, a Polysurface with several faces raises a RhinoScriptingException, like in RhinoPython.
|
Full Usage:
RhinoScriptSyntax.IsPolyCurve(curveGeo, ?segmentIndex)
Parameters:
GeometryBase
-
(GeometryBase) The input geometry.
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: bool
(bool) True or False.
|
Checks if an object is a PolyCurve Curve. Returns false for any other Rhino object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.IsPolyCurve(curveId, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: bool
(bool) True or False.
|
Checks if an object is a PolyCurve Curve. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsPolyline(curveGeo, ?segmentIndex)
Parameters:
GeometryBase
-
(GeometryBase) The input geometry.
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: bool
(bool) True or False.
|
Checks if an object is a Polyline Curve object or a nurbs cure with degree 1 and moer than 2 points Lines return false. Returns false for any other Rhino object. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.IsPolyline(curveId, ?segmentIndex)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?segmentIndex : int
-
(int) Optional, The Curve segment index if `curveId` identifies a PolyCurve
Returns: bool
(bool) True or False.
|
Checks if an object is a Polyline Curve object or a nurbs cure with degree 1 and moer than 2 points Lines return false. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsPolysurface(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The object
Returns: bool
(bool) True if successful, otherwise False.
|
Verifies an object is a Polysurface or Extrusion. Polysurfaces consist of two or more Surfaces joined together. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.IsPolysurface(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) True if successful, otherwise False.
|
Verifies an object is a Polysurface or Extrusion. Polysurfaces consist of two or more Surfaces joined together.
|
Full Usage:
RhinoScriptSyntax.IsPolysurfaceClosed(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The object
Returns: bool
(bool) True if successful, otherwise False.
|
Verifies a Guid refers to a closed Polysurface or closed Extrusion. If the Polysurface fully encloses a volume, it is considered a solid. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.IsPolysurfaceClosed(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) True if successful, otherwise False.
|
Verifies a Guid refers to a closed Polysurface or closed Extrusion. If the Polysurface fully encloses a volume, it is considered a solid.
|
Full Usage:
RhinoScriptSyntax.IsRadialDimension(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The geometry to test
Returns: bool
(bool) True or False.
|
Checks if an object is a radial dimension object. Returns false for any other Rhino object or if the geometry is null.
|
Full Usage:
RhinoScriptSyntax.IsRadialDimension(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) True or False.
|
Checks if an object is a radial dimension object. Returns false for any other Rhino object or if the object does not exist.
|
Full Usage:
RhinoScriptSyntax.IsRectangularLight(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The geometry to test.
Returns: bool
(bool) True or False.
|
Verifies a light object is a rectangular light. Returns false for any other Rhino object or if the geometry is null.
|
Full Usage:
RhinoScriptSyntax.IsRectangularLight(objectId)
Parameters:
Guid
-
(Guid) The light object's identifier
Returns: bool
(bool) True or False.
|
Verifies a light object is a rectangular light. Returns false for any other Rhino object or if the object does not exist.
|
Full Usage:
RhinoScriptSyntax.IsRunningOnWindows()
Returns: bool
(bool) True if currently running on the Widows platform. False if it is not Windows.
|
Returns True if this script is being executed on a Windows platform.
|
Full Usage:
RhinoScriptSyntax.IsSphere(geometryObject)
Parameters:
Surface
-
(Surface) The object
Returns: bool
(bool) True , otherwise False.
|
Determines if a Surface is a portion of a Sphere. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.IsSphere(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) True , otherwise False.
|
Determines if a Surface is a portion of a Sphere.
|
Full Usage:
RhinoScriptSyntax.IsSpotLight(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The geometry to test.
Returns: bool
(bool) True or False.
|
Verifies a light object is a spot light. Returns false for any other Rhino object or if the geometry is null.
|
Full Usage:
RhinoScriptSyntax.IsSpotLight(objectId)
Parameters:
Guid
-
(Guid) The light object's identifier
Returns: bool
(bool) True or False.
|
Verifies a light object is a spot light. Returns false for any other Rhino object or if the object does not exist.
|
Full Usage:
RhinoScriptSyntax.IsSurface(geometryObject)
Parameters:
Surface
-
(Surface) The object
Returns: bool
(bool) True , otherwise False.
|
Verifies an object is a Surface, Extrusion or Brep objects with only one face. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.IsSurface(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) True , otherwise False.
|
Verifies an object is a Surface, Extrusion or Brep objects with only one face.
|
Full Usage:
RhinoScriptSyntax.IsSurfaceClosed(surfaceGeo, direction)
Parameters:
Surface
-
(Surface) Object of a Surface
direction : int
-
(int)
0 = U direction check,
1 = V direction check
Returns: bool
(bool) True or False.
|
Verifies a Surface object is closed in the specified direction. If the Surface fully encloses a volume, it is considered a solid. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.IsSurfaceClosed(surfaceId, direction)
Parameters:
Guid
-
(Guid) Identifier of a Surface
direction : int
-
(int)
0 = U direction check,
1 = V direction check
Returns: bool
(bool) True or False.
|
Verifies a Surface object is closed in the specified direction. If the Surface fully encloses a volume, it is considered a solid.
|
Full Usage:
RhinoScriptSyntax.IsSurfaceFlipped(surfaceGeo)
Parameters:
Brep
-
(Brep) The single-face surface geometry.
Returns: bool
(bool) True when the surface normal is reversed.
|
Returns whether the normal of a single-face surface is flipped.
|
Full Usage:
RhinoScriptSyntax.IsSurfaceFlipped(surfaceId)
Parameters:
Guid
-
(Guid) Identifier of the surface object.
Returns: bool
(bool) True when the surface normal is reversed.
|
Returns whether the normal of a single-face surface is flipped.
|
Full Usage:
RhinoScriptSyntax.IsSurfacePeriodic(surfaceGeo, direction)
Parameters:
Surface
-
(Surface) Object of a Surface
direction : int
-
(int)
0 = U direction check,
1 = V direction check
Returns: bool
(bool) True or False.
|
Verifies a Surface object is periodic in the specified direction. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.IsSurfacePeriodic(surfaceId, direction)
Parameters:
Guid
-
(Guid) Identifier of a Surface
direction : int
-
(int)
0 = U direction check,
1 = V direction check
Returns: bool
(bool) True or False.
|
Verifies a Surface object is periodic in the specified direction.
|
Full Usage:
RhinoScriptSyntax.IsSurfacePlanar(surfaceGeo, ?tolerance)
Parameters:
Surface
-
(Surface) Object of a Surface
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Tolerance used when checked. If omitted, the current absolute
tolerance is used
Returns: bool
(bool) True or False.
|
Verifies a Surface object is planar. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.IsSurfacePlanar(surfaceId, ?tolerance)
Parameters:
Guid
-
(Guid) Identifier of a Surface
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Tolerance used when checked. If omitted, the current absolute
tolerance is used
Returns: bool
(bool) True or False.
|
Verifies a Surface object is planar.
|
Full Usage:
RhinoScriptSyntax.IsSurfaceRational(surfaceGeo)
Parameters:
Surface
-
(Surface) The Surface
Returns: bool
(bool) True , otherwise False.
|
Verifies a Surface object is rational. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.IsSurfaceRational(surfaceId)
Parameters:
Guid
-
(Guid) The Surface's identifier
Returns: bool
(bool) True , otherwise False.
|
Verifies a Surface object is rational.
|
Full Usage:
RhinoScriptSyntax.IsSurfaceSingular(surfaceGeo, direction)
Parameters:
Surface
-
(Surface) The Surface
direction : int
-
(int)
0 = south
1 = east
2 = north
3 = west
Returns: bool
(bool) True or False.
|
Verifies a Surface object is singular in the specified direction. Surfaces are considered singular if a side collapses to a point. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.IsSurfaceSingular(surfaceId, direction)
Parameters:
Guid
-
(Guid) The Surface's identifier
direction : int
-
(int)
0 = south
1 = east
2 = north
3 = west
Returns: bool
(bool) True or False.
|
Verifies a Surface object is singular in the specified direction. Surfaces are considered singular if a side collapses to a point.
|
Full Usage:
RhinoScriptSyntax.IsSurfaceTrimmed(surfaceGeo)
Parameters:
Brep
-
(Brep) The Surface
Returns: bool
(bool) True or False.
|
Verifies a Surface object has been trimmed. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.IsSurfaceTrimmed(surfaceId)
Parameters:
Guid
-
(Guid) The Surface's identifier
Returns: bool
(bool) True or False.
|
Verifies a Surface object has been trimmed.
|
Full Usage:
RhinoScriptSyntax.IsText(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) Geometry to use directly.
Returns: bool
(bool) True if the object with a given geometryObject is a text object.
|
Checks if an object is a text object. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsText(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) True if the object with a given objectId is a text object.
|
Checks if an object is a text object. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsTextDot(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) Geometry to use directly.
Returns: bool
(bool) True if the object with a given geometryObject is a text dot object.
|
Checks if an object is a text dot object. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsTextDot(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: bool
(bool) True if the object with a given objectId is a text dot object.
|
Checks if an object is a text dot object. Returns false for any other Rhino object.
|
Full Usage:
RhinoScriptSyntax.IsToolbar(name, toolbar, ?group)
Parameters:
string
-
(string) Name of a currently open toolbar file
toolbar : string
-
(string) Name of a toolbar group
?group : bool
-
(bool) Optional, default value: false
If toolbar parameter is referring to a toolbar group
Returns: bool
(bool) True or False indicating success or failure.
|
Verifies a toolbar (or toolbar group) exists in an open collection file.
|
Full Usage:
RhinoScriptSyntax.IsToolbarCollection(file)
Parameters:
string
-
(string) Full path to a toolbar collection file
Returns: string
(string) Rhino-assigned name of the toolbar collection.
|
Checks if a toolbar collection is open.
|
Full Usage:
RhinoScriptSyntax.IsTorus(surfaceGeo)
Parameters:
Surface
-
(Surface) The Surface object
Returns: bool
(bool) True , otherwise False.
|
Determines if a Surface is a portion of a torus. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.IsTorus(surfaceId)
Parameters:
Guid
-
(Guid) The Surface object's identifier
Returns: bool
(bool) True , otherwise False.
|
Determines if a Surface is a portion of a torus.
|
Full Usage:
RhinoScriptSyntax.IsUserText(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: int
(int) result of test:
0 = no user text
1 = attribute user text
2 = geometry user text
3 = both attribute and geometry user text.
|
Checks if an object contains user text.
|
Full Usage:
RhinoScriptSyntax.IsVectorParallelTo(vector1, vector2, ?toleranceDegrees)
Parameters:
Vector3d
-
(Vector3d) First of the vectors to compare
vector2 : Vector3d
-
(Vector3d) Second of the vectors to compare
?toleranceDegrees : float
-
(float) Optional, default value: 0.0
Angle tolerance in degrees; 0.0 uses RhinoCommon's default of 1.0 degree
Returns: int
(int) The value represents
-1 = the vectors are anti-parallel
0 = the vectors are not parallel
1 = the vectors are parallel.
|
Compares two vectors to see if they are parallel within one degree or custom tolerance.
|
Full Usage:
RhinoScriptSyntax.IsVectorPerpendicularTo(vector1, vector2, ?toleranceDegrees)
Parameters:
Vector3d
-
(Vector3d) First of the vectors to compare
vector2 : Vector3d
-
(Vector3d) Second of the vectors to compare
?toleranceDegrees : float
-
(float) Optional, default value: 0.0
Angle tolerance in degrees; 0.0 uses RhinoCommon's default of 1.0 degree
Returns: bool
(bool) True if vectors are perpendicular, otherwise False.
|
Compares two vectors to see if they are perpendicular.
|
Full Usage:
RhinoScriptSyntax.IsVectorTiny(vector)
Parameters:
Vector3d
-
(Vector3d) The vector to check
Returns: bool
(bool) True if the vector is tiny, otherwise False.
|
Checks if a vector is very short. The X, Y, Z elements are smaller than 1.0e-12.
|
Full Usage:
RhinoScriptSyntax.IsVectorZero(vector)
Parameters:
Vector3d
-
(Vector3d) The vector to check
Returns: bool
(bool) True if the vector is zero, otherwise False.
|
Checks if a vector is zero. The X, Y, Z elements are equal to 0.0.
|
Full Usage:
RhinoScriptSyntax.IsView(view)
Parameters:
string
-
(string) Title of the view
Returns: bool
(bool) True of False indicating success or failure.
|
Checks if the specified view exists.
|
Full Usage:
RhinoScriptSyntax.IsViewCurrent(view)
Parameters:
string
-
(string) Title of the view
Returns: bool
(bool) True of False indicating success or failure.
|
Checks if the specified view is the current, or active view.
|
Full Usage:
RhinoScriptSyntax.IsViewMaximized(?view)
Parameters:
string
-
(string) Optional, Title of the view. If omitted, the current
view is used
Returns: bool
(bool) True of False.
|
Checks if the specified view is maximized (enlarged so as to fill the entire Rhino window).
|
Full Usage:
RhinoScriptSyntax.IsViewPerspective(view)
Parameters:
string
-
(string) Title of the view
Returns: bool
(bool) True of False.
|
Checks if the specified view's projection is set to perspective.
|
Full Usage:
RhinoScriptSyntax.IsViewTitleVisible(?view)
Parameters:
string
-
(string) Optional, The title of the view. If omitted, the current
active view is used
Returns: bool
(bool) True of False.
|
Checks if the specified view's title window is visible.
|
Full Usage:
RhinoScriptSyntax.IsVisibleInView(objectId, ?view)
Parameters:
Guid
-
(Guid) The identifier of an object to test
?view : string
-
(string) Optional, default value: ActiveView.MainViewport The title of the view. If omitted, the current active view is used
Returns: bool
(bool) True if the object is visible in the specified view, otherwise False.
|
Verifies an object is visible in a view.
|
Full Usage:
RhinoScriptSyntax.IsWallpaper(view)
Parameters:
string
-
(string) View to verify
Returns: bool
(bool) True or False.
|
Checks if the specified view contains a wallpaper image.
|
Full Usage:
RhinoScriptSyntax.IsXformIdentity(xForm)
Parameters:
Transform
-
(Transform) Rhino.Geometry.Transform. A 4x4 transformation matrix
Returns: bool
(bool) True or False indicating success or failure.
|
Verifies a matrix is the identity matrix.
|
Full Usage:
RhinoScriptSyntax.IsXformSimilarity(xForm)
Parameters:
Transform
-
(Transform) Rhino.Geometry.Transform. A 4x4 transformation matrix
Returns: bool
(bool) True if this transformation is a similarity, including an orientation reversing reflection; otherwise False.
|
Verifies a matrix is a similarity transformation. A similarity transformation can be broken into a sequence of dilatations, translations, rotations, and reflections.
|
Full Usage:
RhinoScriptSyntax.IsXformZero(xForm)
Parameters:
Transform
-
(Transform) Rhino.Geometry.Transform. A 4x4 transformation matrix
Returns: bool
(bool) True or False indicating success or failure.
|
Checks if a matrix is a zero transformation matrix.
|
Full Usage:
RhinoScriptSyntax.JoinCurves(curveInputs, ?tolerance)
Parameters:
Curve seq
-
(Curve seq) The input objects.
?tolerance : float
-
(float) Optional, default value: 2.1 * State.Doc.ModelAbsoluteTolerance
Join tolerance. If omitted, 2.1 * document absolute
tolerance is used
Returns: ResizeArray<Curve>
(Curve ResizeArray) The resulting geometry; it is not added to a document.
|
Computes JoinCurves from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.JoinCurves(curveIds, ?deleteInput, ?tolerance)
Parameters:
Guid seq
-
(Guid seq) List of multiple Curves
?deleteInput : bool
-
(bool) Optional, default value: false
Delete input objects after joining
?tolerance : float
-
(float) Optional, default value: 2.1 * State.Doc.ModelAbsoluteTolerance
Join tolerance. If omitted, 2.1 * document absolute
tolerance is used
Returns: ResizeArray<Guid>
(Guid ResizeArray) Object objectId representing the new Curves.
|
Joins multiple Curves together to form one or more Curves or polycurves.
|
|
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.JoinSurfacesAll(objectIds, ?deleteInput)
Parameters:
Guid seq
-
(Guid seq) Identifiers of at least two surfaces or polysurfaces.
?deleteInput : bool
-
(bool) Optional, default value: false. Delete inputs only after all results have been added.
Returns: ResizeArray<Guid>
(Guid ResizeArray) Identifiers of all results, corresponding to RhinoPython JoinSurfaces with return_all=True.
|
Joins surface objects and adds every resulting Brep, including disconnected results.
|
|
|
Full Usage:
RhinoScriptSyntax.LastCommandName()
Returns: string
(string) The name of the last executed command.
|
Returns the name of the last executed command.
|
Full Usage:
RhinoScriptSyntax.LastCommandResult()
Returns: int
(int) The result code for the last executed command.
0 = success (command successfully completed)
1 = cancel (command was cancelled by the user)
2 = nothing (command did nothing, but was not cancelled)
3 = failure (command failed due to bad input, computational problem...)
4 = unknown command (the command was not found)
|
Returns the result code for the last executed command.
|
Full Usage:
RhinoScriptSyntax.LastCreatedObjects(?select)
Parameters:
bool
-
(bool) Optional, default value: false
Select the object. If omitted, the object is not selected
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers of the most recently created or changed objects.
|
Returns identifiers of the objects that were most recently created or changed by scripting a Rhino command using the Command function. It is important to call this function immediately after calling the Command function as only the most recently created or changed object identifiers will be returned.
|
Full Usage:
RhinoScriptSyntax.LastObject(?select, ?includeLights, ?includeGrips)
Parameters:
bool
-
(bool) Optional, default value: false
Select the object
?includeLights : bool
-
(bool) Optional, default value: false
Include lights in the potential set
?includeGrips : bool
-
(bool) Optional, default value: false
Include grips in the potential set
Returns: Guid
(Guid) identifier of the object.
|
Returns the identifier of the last object in the document. The last object in the document is the first object created by the user.
|
Full Usage:
RhinoScriptSyntax.LayerChildCount(layer)
Parameters:
string
-
(string) The name of an existing layer
Returns: int
(int) The number of immediate child layers.
|
Returns the number of immediate child layers of a layer.
|
Full Usage:
RhinoScriptSyntax.LayerChildren(layer)
Parameters:
string
-
(string) The name of an existing layer
Returns: ResizeArray<string>
(string ResizeArray) List of children layer names.
|
Returns the immediate child layers of a layer. ( excluding children of children)
|
Full Usage:
RhinoScriptSyntax.LayerChildrenAll(layer)
Parameters:
string
-
(string) The name of an existing layer
Returns: ResizeArray<string>
(string ResizeArray) List of children layer names.
|
Returns all (immediate and descendent) child and grand child layers of a layer.
|
Full Usage:
RhinoScriptSyntax.LayerColor(layer, color)
Parameters:
string
-
(string) Name of an existing layer
color : Color
-
(Drawing.Color) The new color value
|
Changes the color of a layer.
|
Full Usage:
RhinoScriptSyntax.LayerColor(layer)
Parameters:
string
-
(string) Name of an existing layer
Returns: Color
(Drawing.Color) The current color value .
|
Returns the color of a layer.
|
Full Usage:
RhinoScriptSyntax.LayerCount()
Returns: int
(int) The number of layers in the document.
|
Returns the number of layers in the document.
|
Full Usage:
RhinoScriptSyntax.LayerId(layer)
Parameters:
string
-
(string) Name of existing layer
Returns: Guid
(Guid) The layer's identifier.
|
Returns the identifier of a layer given the layer's name.
|
Full Usage:
RhinoScriptSyntax.LayerIds()
Returns: ResizeArray<Guid>
(Guid ResizeArray) The identifiers of all layers in the document.
|
Return identifiers of all layers in the document.
|
Full Usage:
RhinoScriptSyntax.LayerLinetype(layer, lineType)
Parameters:
string
-
(string) Name of an existing layer
lineType : string
-
(string) Name of a line type, not case sensitive
|
Changes the line type of a layer.
|
Full Usage:
RhinoScriptSyntax.LayerLinetype(layer)
Parameters:
string
-
(string) Name of an existing layer
Returns: string
(string) Name of the current line type.
|
Returns the line type of a layer.
|
Full Usage:
RhinoScriptSyntax.LayerLock(layer)
Parameters:
string
-
(string) Name of existing layer
|
Locks a layer if it is not already locked via a parent.
|
Full Usage:
RhinoScriptSyntax.LayerLocked(layer)
Parameters:
string
-
(string) Name of existing layer
Returns: bool
(bool) The current layer visibility.
|
Returns the locked property of a layer, if layer is unlocked but parent layer is locked this still returns true.
|
Full Usage:
RhinoScriptSyntax.LayerLockedSetFalse(layer, ?parentsToo)
Parameters:
string
-
(string) Name of existing layer
?parentsToo : bool
-
(bool) Optional, default value: true
Unlock parent layers to if needed
|
Makes a layer unlocked.
|
Full Usage:
RhinoScriptSyntax.LayerLockedSetTrue(layer, ?forceLocked)
Parameters:
string
-
(string) Name of existing layer
?forceLocked : bool
-
(bool) Optional, default value: false
Lock layer even if it is already locked via a parent layer
|
Makes a layer locked.
|
Full Usage:
RhinoScriptSyntax.LayerMaterialIndex(layer, index)
Parameters:
string
-
(string) Name of existing layer
index : int
-
(int) The new material index
|
Changes the material index of a layer. A material index of -1 indicates that no material has been assigned to the layer. Thus, the layer will use Rhino's default layer material.
|
Full Usage:
RhinoScriptSyntax.LayerMaterialIndex(layer)
Parameters:
string
-
(string) Name of existing layer
Returns: int
(int) a zero-based material index.
|
Returns the material index of a layer. A material index of -1 indicates that no material has been assigned to the layer. Thus, the layer will use Rhino's default layer material.
|
Full Usage:
RhinoScriptSyntax.LayerName(layerId, ?fullPath)
Parameters:
Guid
-
(Guid) Layer identifier
?fullPath : bool
-
(bool) Optional, default value: true
Return the full path name `True` or short name `False`
Returns: string
(string) The layer's name.
|
Return the name of a layer given it's identifier.
|
Full Usage:
RhinoScriptSyntax.LayerNames(?sort)
Parameters:
bool
-
(bool) Optional, default value: false. True to sort the names; False to preserve document order.
Returns: ResizeArray<string>
(string ResizeArray) List of layer names.
|
Returns the names of all layers in the document, optionally sorted in ordinal order.
|
Full Usage:
RhinoScriptSyntax.LayerOff(layer)
Parameters:
string
-
(string) Name of existing layer
|
Turn a layer off if visible, does nothing if parent layer is already invisible. .
|
Full Usage:
RhinoScriptSyntax.LayerOn(layer)
Parameters:
string
-
(string) Name of existing layer
|
Turn a layer on if not visible , enforces visibility of parents.
|
Full Usage:
RhinoScriptSyntax.LayerOrder(layer)
Parameters:
string
-
(string) Name of existing layer
Returns: int
(int) zero based index of layer.
|
Returns the current display order index of a layer as displayed in Rhino's layer dialog box. A display order index of -1 indicates that the current layer dialog filter does not allow the layer to appear in the layer list.
|
Full Usage:
RhinoScriptSyntax.LayerPrintColor(layer, color)
Parameters:
string
-
(string) Name of existing layer
color : Color
-
(Drawing.Color) New print color
|
Changes the print color of a layer. Layer print colors are represented as RGB colors.
|
Full Usage:
RhinoScriptSyntax.LayerPrintColor(layer)
Parameters:
string
-
(string) Name of existing layer
Returns: Color
(Drawing.Color) The current layer print color.
|
Returns the print color of a layer. Layer print colors are represented as RGB colors.
|
Full Usage:
RhinoScriptSyntax.LayerPrintWidth(layer, width)
Parameters:
string
-
(string) Name of existing layer
width : float
-
(float) New print width
|
Changes the print width of a layer. Print width is specified in millimeters. A print width of 0.0 denotes the "default" print width.
|
Full Usage:
RhinoScriptSyntax.LayerPrintWidth(layer)
Parameters:
string
-
(string) Name of existing layer
Returns: float
(float) The current layer print width.
|
Returns the print width of a layer. Print width is specified in millimeters. A print width of 0.0 denotes the "default" print width.
|
Full Usage:
RhinoScriptSyntax.LayerUnlock(layer)
Parameters:
string
-
(string) Name of existing layer
|
Unlocks a layer and all parents if needed .
|
Full Usage:
RhinoScriptSyntax.LayerVisible(layer)
Parameters:
string
-
(string) Name of existing layer
Returns: bool
(bool) The current layer visibility.
|
Returns the visible property of a layer, if layer is on but invisible because of a parent that is off this returns false.
|
Full Usage:
RhinoScriptSyntax.LayerVisibleSetFalse(layer, ?persist)
Parameters:
string
-
(string) Name of existing layer
?persist : bool
-
(bool) Optional, default value: false
Turn layer persistently off? even if it is already invisible because of a parent layer that is turned off.
By default already invisible layers are not changed
|
Makes a layer invisible.
|
Full Usage:
RhinoScriptSyntax.LayerVisibleSetTrue(layer, ?forceVisible)
Parameters:
string
-
(string) Name of existing layer
?forceVisible : bool
-
(bool) Optional, default value: true
Turn on parent layers too if needed. True by default
|
Makes a layer visible.
|
Full Usage:
RhinoScriptSyntax.LeaderText(objectIds, text)
Parameters:
Guid seq
-
(Guid seq) The objects's identifiers
text : string
-
(string) The new text string
|
Modifies the text string of multiple dimension leader objects.
|
Full Usage:
RhinoScriptSyntax.LeaderText(objectId, text)
Parameters:
Guid
-
(Guid) The object's identifier
text : string
-
(string) The new text string
|
Modifies the text string of a dimension leader object.
|
Full Usage:
RhinoScriptSyntax.LeaderText(objectId)
Parameters:
Guid
-
(Guid) The object's identifier
Returns: string
(string) The current text string.
|
Returns the text string of a dimension leader object.
|
|
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.LightCount()
Returns: int
(int) The number of light objects in the document.
|
Returns the number of light objects in the document.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.LightName(geometryObject)
Parameters:
Light
-
(Light) The light geometry to use.
Returns: string
(string) The current name.
|
Returns the name of a light object.
|
Full Usage:
RhinoScriptSyntax.LightName(objectIds, name)
Parameters:
Guid seq
-
(Guid seq) The light objects's identifiers
name : string
-
(string) The light's new name
|
Changes the name of multiple light objects.
|
Full Usage:
RhinoScriptSyntax.LightName(objectId, name)
Parameters:
Guid
-
(Guid) The light object's identifier
name : string
-
(string) The light's new name
|
Changes the name of a light object.
|
Full Usage:
RhinoScriptSyntax.LightName(objectId)
Parameters:
Guid
-
(Guid) The light object's identifier
Returns: string
(string) The current name.
|
Returns the name of a light object.
|
Full Usage:
RhinoScriptSyntax.LightObjects()
Returns: ResizeArray<Guid>
(Guid ResizeArray) The list of identifiers of light objects in the document.
|
Returns list of identifiers of light objects in the document.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.LineCylinderIntersection(line, cylinderPlane, cylinderHeight, cylinderRadius)
Parameters:
Line
-
(Geometry.Line) The line to intersect
cylinderPlane : Plane
-
(Plane) Base plane of the cylinder
cylinderHeight : float
-
(float) Height of the cylinder
cylinderRadius : float
-
(float) Radius of the cylinder
Returns: Point3d array
(Point3d array) List of intersection points (0, 1, or 2 points).
|
Calculates the intersection of a line and a cylinder.
|
|
|
Full Usage:
RhinoScriptSyntax.LineIsFartherThan(line, distance, line2)
Parameters:
Line
-
(Geometry.Line) a Geometry.Line
distance : float
-
(float) The distance
line2 : Line
-
(Geometry.Line) The test line
Returns: bool
(bool) True if the shortest distance from the line to the other object is
greater than distance, False otherwise.
|
Determines if the shortest distance from a line to a point or another line is greater than a specified distance.
|
Full Usage:
RhinoScriptSyntax.LineIsFartherThan(line, distance, point)
Parameters:
Line
-
(Geometry.Line) A Geometry.Line
distance : float
-
(float) The distance
point : Point3d
-
(Point3d) The test point
Returns: bool
(bool) True if the shortest distance from the line to the other object is
greater than distance, False otherwise.
|
Determines if the shortest distance from a line to a point or another line is greater than a specified distance.
|
Full Usage:
RhinoScriptSyntax.LineLineIntersection(lineA, lineB)
Parameters:
Line
-
(Geometry.Line) LineA of lines to intersect
lineB : Line
-
(Geometry.Line) LineB of lines to intersect
Returns: Point3d * Point3d
(Point3d * Point3d) containing a point on the first line and a point on the second line.
|
Calculates the intersection of two non-parallel lines. The lines are considered endless. If the two lines do not actually intersect the closest point on each is returned. Fails on parallel or collinear lines |
Full Usage:
RhinoScriptSyntax.LineMaxDistanceTo(line, line2)
Parameters: Returns: float
(float) A distance (D) such that if Q is any point on the line and P is any point on the other object,
then D is bigger than Rhino.Distance(Q, P).
|
Finds the longest distance between a line as a finite chord, and a line.
|
Full Usage:
RhinoScriptSyntax.LineMaxDistanceTo(line, point)
Parameters: Returns: float
(float) A distance (D) such that if Q is any point on the line and P is any point on the other object,
then D is bigger than Rhino.Distance(Q, P).
|
Finds the longest distance between a line as a finite chord, and a point.
|
Full Usage:
RhinoScriptSyntax.LineMinDistanceTo(line, line2)
Parameters: Returns: float
(float) A distance (D) such that if Q is any point on the line and P is any point on the other object,
then D is smaller than Rhino.Distance(Q, P).
|
Finds the shortest distance between a line as a finite chord, and a point or another line.
|
Full Usage:
RhinoScriptSyntax.LineMinDistanceTo(line, point)
Parameters: Returns: float
(float) A distance (D) such that if Q is any point on the line and P is any point on the other object,
then D is smaller than Rhino.Distance(Q, P).
|
Finds the shortest distance between a line as a finite chord, and a point or another line.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.LineSphereIntersection(line, sphereCenter, sphereRadius)
Parameters:
Line
-
(Geometry.Line) The line
sphereCenter : Point3d
-
(Point3d) The center point of the sphere
sphereRadius : float
-
(float) The radius of the sphere
Returns: Point3d array
(Point3d array) list of intersection points.
|
|
|
|
Full Usage:
RhinoScriptSyntax.LineTransform(lineId, xForm, ?copy)
Parameters:
Guid
-
(Guid) The line to transform
xForm : Transform
-
(Transform) The transformation to apply
?copy : bool
-
(bool) Optional, default value: false. Copy the Line object
Returns: Guid
(Guid) The same Guid if copy=false, or the Guid of the new line object if copy=true.
|
Transforms a line object in the document. With copy=false the line object is transformed in place and keeps its Guid, with copy=true the original is left unchanged and a transformed copy is added to the document. The Line geometry overload returns a new transformed Line instead and does not touch the document.
|
Full Usage:
RhinoScriptSyntax.LinetypeCount()
Returns: int
(int) The number of linetypes in the document.
|
Returns the number of active, non-deleted linetypes in the document.
|
Full Usage:
RhinoScriptSyntax.LinetypeNames(?sort)
Parameters:
bool
-
(bool) Optional, default value: false. True to sort the names; False to preserve document order.
Returns: ResizeArray<string>
(string ResizeArray) List of linetype names.
|
Returns names of all linetypes in the document, optionally sorted in ordinal order.
|
Full Usage:
RhinoScriptSyntax.ListBox(items, ?message, ?title, ?defaultVal)
Parameters:
IList<string>
-
(string IList) A list of values to select
?message : string
-
(string) Optional, A prompt of message
?title : string
-
(string) Optional, A dialog box title
?defaultVal : string
-
(string) Optional, Selected item in the list
Returns: string
(string) The selected item.
|
Display a list of items in a list box dialog.
|
Full Usage:
RhinoScriptSyntax.LocaleID()
Returns: int
(int) The current language used for the Rhino interface as a locale ID, or LCID.
1029 Czech
1031 German-Germany
1033 English-United States
1034 Spanish-Spain
1036 French-France
1040 Italian-Italy
1041 Japanese
1042 Korean
1045 Polish
|
Returns the current language used for the Rhino interface. The current language is returned as a locale ID, or LCID, value.
|
Full Usage:
RhinoScriptSyntax.LockGroup(groupName)
Parameters:
string
-
(string) The name of an existing group
Returns: int
(int) Number of objects that were locked.
|
Locks a group of objects. Locked objects are visible and they can be snapped to. But, they cannot be selected.
|
Full Usage:
RhinoScriptSyntax.LockObject(objectId)
Parameters:
Guid
-
(Guid) The identifier of an object
Returns: bool
(bool) True or False indicating success or failure.
|
Locks a single object. Locked objects are visible, and they can be snapped to. But, they cannot be selected.
|
Full Usage:
RhinoScriptSyntax.LockObjects(objectIds)
Parameters:
Guid seq
-
(Guid seq) List of Strings or Guids. The identifiers of objects
Returns: int
(int) number of objects locked.
|
Locks multiple objects. Locked objects are visible, and they can be snapped to. But, they cannot be selected.
|
Full Usage:
RhinoScriptSyntax.LockedObjects(?includeLights, ?includeGrips, ?includeReferences)
Parameters:
bool
-
(bool) Optional, default value: false
Include light objects
?includeGrips : bool
-
(bool) Optional, default value: false
Include grip objects
?includeReferences : bool
-
(bool) Optional, default value: false
Include reference objects such as work session objects
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers the locked objects.
|
Returns identifiers of all locked objects in the document. Locked objects cannot be snapped to, and cannot be selected.
|
Full Usage:
RhinoScriptSyntax.MakeBlendCurve(curves, parameters, reverses, continuities)
Parameters:
Curve * Curve
-
(Curve * Curve) The pair of input curves.
parameters : float * float
-
(float * float) Tuple of two curve parameters defining the blend end points.
reverses : bool * bool
-
(bool * bool) Tuple of two boolean values specifying to use the natural or opposite direction of the curve.
continuities : int * int
-
(int * int) Tuple of two numbers specifying continuity at end points:
0 = position
1 = tangency
2 = curvature
Returns: Curve
(Curve) The resulting geometry; it is not added to a document.
|
Computes MakeBlendCurve from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.MakeCurveNonPeriodic(curveGeo)
Parameters:
Curve
-
(Curve) The input curve geometry.
Returns: NurbsCurve
(NurbsCurve) The resulting geometry; it is not added to a document.
|
Computes MakeCurveNonPeriodic from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.MakeCurveNonPeriodic(curveId, ?deleteInput)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
?deleteInput : bool
-
(bool) Optional, default value: false
Delete the input Curve. If omitted, the input Curve will not be deleted
Returns: Guid
(Guid) objectId of the new or modified Curve.
|
Makes a periodic Curve non-periodic. Non-periodic Curves can develop kinks when deformed.
|
Full Usage:
RhinoScriptSyntax.MakeCutPlane(geometryObjects, startPoint, endPoint, ?normal)
Parameters:
GeometryBase seq
-
(GeometryBase seq) Objects of objects that the cutting Plane will
pass through
startPoint : Point3d
-
(Point3d) Start point of line that defines the cutting Plane
endPoint : Point3d
-
(Point3d) End point of line that defines the cutting Plane
?normal : Vector3d
-
(Vector3d) Optional, default value: world Z axis
Vector that will be contained in the returned planar Surface.
If omitted, the world Z axis is used (NOT the normal to, or Z axis of, the active view's construction plane as in rhinopython).
Returns: PlaneSurface
(PlaneSurface) Newly created geometry. The caller owns the returned objects.
|
Creates a planar Surface through objects at a designated location. For more information, see the Rhino help file for the CutPlane command. Returns geometry without adding it.
|
|
|
Full Usage:
RhinoScriptSyntax.MakeFilletCurve(curveA, curveB, ?radius, ?basePointA, ?basePointB)
Parameters:
Curve
-
(Curve) The input geometry.
curveB : Curve
-
(Curve) The input geometry.
?radius : float
-
(float) Optional, default value: 1.0. Fillet radius.
?basePointA : Point3d
-
(Point3d) Optional. Base point of the first curve. If omitted, starting point of the curve is used.
?basePointB : Point3d
-
(Point3d) Optional. Base point of the second curve. If omitted, starting point of the curve is used.
Returns: ArcCurve
(ArcCurve) The resulting geometry; it is not added to a document.
|
Computes MakeFilletCurve from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.MakeHatch(curve, ?hatchPattern, ?scale, ?rotationDegrees, ?tolerance)
Parameters:
Curve
-
(Curve) Geometry of the closed planar Curve that defines the boundary of the Hatch object
?hatchPattern : string
-
(string) Optional. Name of the Hatch pattern to be used by the Hatch object. If omitted, the current Hatch pattern will be used.
?scale : float
-
(float) Optional, default value: 1.0. Hatch pattern scale factor.
?rotationDegrees : float
-
(float) Optional, default value: 0.0. Hatch pattern rotation angle in degrees.
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance. Tolerance for Hatch fills.
Returns: Hatch
(Hatch) Hatch geometry, without adding it to the document.
|
Creates one Hatch object from one closed planar Curve.
|
Full Usage:
RhinoScriptSyntax.MakeHatches(curves, ?hatchPattern, ?scale, ?rotationDegrees, ?tolerance)
Parameters:
Curve seq
-
(Curve seq) Geometry of the closed planar Curves that define the boundary of the Hatch objects
?hatchPattern : string
-
(string) Optional. Name of the Hatch pattern to be used by the Hatch object. If omitted, the current Hatch pattern will be used.
?scale : float
-
(float) Optional, default value: 1.0. Hatch pattern scale factor.
?rotationDegrees : float
-
(float) Optional, default value: 0.0. Hatch pattern rotation angle in degrees.
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance. Tolerance for Hatch fills.
Returns: ResizeArray<Hatch>
(Hatch ResizeArray) Hatch geometry, without adding it to the document.
|
Creates one or more new Hatch objects from a list of closed planar Curves. The Hatch geometry refers to a Hatch pattern of the document, so the default Hatch patterns are added to the document if missing.
|
Full Usage:
RhinoScriptSyntax.MakeInterpCrvOnSrf(surfaceGeo, points)
Parameters:
Surface
-
(Surface) The input geometry.
points : Point3d seq
-
(Point3d seq) List of 3D points that lie on the specified surface. The list must contain at least 2 points.
Returns: Curve
(Curve) The resulting geometry; it is not added to a document.
|
Computes MakeInterpCrvOnSrf from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.MakeInterpCrvOnSrfUV(surfaceGeo, points)
Parameters:
Surface
-
(Surface) The input geometry.
points : Point2d seq
-
(Point2d seq) A list of 2D surface parameters. The list must contain at least 2 sets of parameters.
Returns: Curve
(Curve) The resulting geometry; it is not added to a document.
|
Computes MakeInterpCrvOnSrfUV from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.MakeLoftSrf(geometryObjects, ?start, ?ende, ?loftType, ?rebuild, ?refit, ?closed)
Parameters:
Curve seq
-
(Curve seq) Ordered list of the Curves to loft through
?start : Point3d
-
(Point3d) Optional, Starting point of the loft
?ende : Point3d
-
(Point3d) Optional, Ending point of the loft
?loftType : int
-
(int) Optional, default value: 0
Type of loft. Possible options are:
0 = Normal. Uses chord-length parameterization in the loft direction
1 = Loose. The Surface is allowed to move away from the original Curves
to make a smoother Surface. The Surface control points are created
at the same locations as the control points of the loft input Curves.
2 = Straight. The sections between the Curves are straight. This is
also known as a ruled Surface.
3 = Tight. The Surface sticks closely to the original Curves. Uses square
root of chord-length parameterization in the loft direction
?rebuild : int
-
(int) Optional, default value: 0
If not 0 then Rebuilds the shape Curves before lofting with this control point count
?refit : float
-
(float) Optional, if given the loft is refitted, the value is the tolerance used to rebuild
?closed : bool
-
(bool) Optional, default value: false
Close the loft back to the first Curve
Returns: ResizeArray<Brep>
(Brep ResizeArray) Newly created geometry. The caller owns the returned objects.
|
Creates a Surface created by lofting Curves. - no Curve sorting performed. pass in Curves in the order you want them sorted - directions of open Curves not adjusted. Use CurveDirectionsMatch and ReverseCurve to adjust the directions of open Curves - seams of closed Curves are not adjusted. Use CurveSeam to adjust the seam of closed Curves. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.MakeNetworkSrf(curves, ?continuity, ?edgeTolerance, ?interiorTolerance, ?angleToleranceRadians)
Parameters:
Curve seq
-
(Curve seq) Curves from which to create the Surface
?continuity : int
-
(int) Optional, default value: 1
How the edges match the input geometry
0 = loose
1 = position
2 = tangency
3 = curvature
?edgeTolerance : float
-
(float) Optional, Edge tolerance
?interiorTolerance : float
-
(float) Optional, Interior tolerance
?angleToleranceRadians : float
-
(float) Optional, default value: 0.0. Angle tolerance in radians, passed directly to RhinoCommon.
Use RhinoMath.ToRadians to convert from degrees to radians.
Returns: NurbsSurface
(NurbsSurface) Newly created geometry. The caller owns the returned objects.
|
Creates a Surface from a network of crossing Curves. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.MakePatch(geometryObjects, uvSpans, ?tolerance, ?trim, ?pointSpacing, ?flexibility, ?surfacePull, ?fixEdges)
Parameters:
GeometryBase seq
-
(GeometryBase seq) A list of objects that indicate the objects to use for the patch fitting.
Acceptable object types include Curves, points, point clouds, and Meshes
uvSpans : int * int
-
(int * int) The U and V direction span counts for the automatically generated Surface . however it is best if you create a starting Surface that is similar in shape
to the Surface you are trying to create an use the other overload of this method
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
The tolerance used by input analysis functions.
?trim : bool
-
(bool) Optional, default value: true
Try to find an outside Curve and trims the Surface to it. The default value is True
?pointSpacing : float
-
(float) Optional, default value: 0.1
The basic distance between points sampled from input Curves. The default value is 0.1
?flexibility : float
-
(float) Optional, default value: 1.0
Determines the behavior of the Surface in areas where its not otherwise controlled by the input.
Lower numbers make the Surface behave more like a stiff material, higher, more like a flexible material.
That is, each span is made to more closely match the spans adjacent to it if there is no input geometry
mapping to that area of the Surface when the flexibility value is low. The scale is logarithmic.
For example, numbers around 0.001 or 0.1 make the patch pretty stiff and numbers around 10 or 100
make the Surface flexible. The default value is 1.0
?surfacePull : float
-
(float) Optional, default value: 1.0
Similar to stiffness, but applies to the starting Surface. The bigger the pull, the closer
the resulting Surface shape will be to the starting Surface. The default value is 1.0
?fixEdges : bool
-
(bool) Optional, default value: false
Clamps the edges of the starting Surface in place. This option is useful if you are using a
Curve or points for deforming an existing Surface, and you do not want the edges of the starting Surface
to move. The default is False
Returns: Brep
(Brep) Newly created geometry. The caller owns the returned objects.
|
Fits a Surface through Curve, point, point cloud, and Mesh objects. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.MakePatch(geometryObjects, startSurfaceGeo, ?tolerance, ?trim, ?pointSpacing, ?flexibility, ?surfacePull, ?fixEdges)
Parameters:
GeometryBase seq
-
(GeometryBase seq) A list of objects that indicate the objects to use for the patch fitting.
Acceptable object types include Curves, points, point clouds, and Meshes
startSurfaceGeo : Surface
-
(Surface) The starting Surface. It is best if you create a starting Surface that is similar in shape
to the Surface you are trying to create
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
The tolerance used by input analysis functions.
?trim : bool
-
(bool) Optional, default value: true
Try to find an outside Curve and trims the Surface to it. The default value is True
?pointSpacing : float
-
(float) Optional, default value: 0.1
The basic distance between points sampled from input Curves. The default value is 0.1
?flexibility : float
-
(float) Optional, default value: 1.0
Determines the behavior of the Surface in areas where its not otherwise controlled by the input.
Lower numbers make the Surface behave more like a stiff material, higher, more like a flexible material.
That is, each span is made to more closely match the spans adjacent to it if there is no input geometry
mapping to that area of the Surface when the flexibility value is low. The scale is logarithmic.
For example, numbers around 0.001 or 0.1 make the patch pretty stiff and numbers around 10 or 100
make the Surface flexible. The default value is 1.0
?surfacePull : float
-
(float) Optional, default value: 1.0
Similar to stiffness, but applies to the starting Surface. The bigger the pull, the closer
the resulting Surface shape will be to the starting Surface. The default value is 1.0
?fixEdges : bool
-
(bool) Optional, default value: false
Clamps the edges of the starting Surface in place. This option is useful if you are using a
Curve or points for deforming an existing Surface, and you do not want the edges of the starting Surface
to move. The default is False
Returns: Brep
(Brep) Newly created geometry. The caller owns the returned objects.
|
Fits a Surface through Curve, point, point cloud, and Mesh objects. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.MakePipe(curveGeo, parameters, radii, ?blendType, ?cap, ?fit)
Parameters:
Curve
-
(Curve) Object of rail Curve
parameters : float seq
-
(float seq) normalized Curve parameters, from 0.0 to 1.0
radii : float seq
-
(float seq) radius values at normalized Curve parameters, the same count as parameters.
A RhinoScriptingException is raised if the counts differ.
?blendType : int
-
(int) Optional, default value: 0
0(local) or 1(global)
?cap : int
-
(int) Optional, default value: 0
0(none), 1(flat), 2(round)
?fit : bool
-
(bool) Optional, default value: false
Attempt to fit a single Surface
Returns: ResizeArray<Brep>
(Brep ResizeArray) Newly created geometry. The caller owns the returned objects.
|
Creates a single walled Surface with a circular profile around a Curve. Returns geometry without adding it.
|
|
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.MakeRailRevSrf(profile, rail, axis, ?scaleHeight)
Parameters:
Curve
-
(Curve) Object of the profile Curve
rail : Curve
-
(Curve) Object of the rail Curve
axis : Line
-
(Line) A Line identifying the start point and end point of the rail revolve axis
?scaleHeight : bool
-
(bool) Optional, default value: false
If True, Surface will be locally scaled. Defaults to False
Returns: NurbsSurface
(NurbsSurface) Newly created geometry. The caller owns the returned objects.
|
Creates a Surface created through profile Curves that define the Surface shape and two Curves that defines a Surface edge. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.MakeRevSrf(curveGeo, axis, ?startAngleDegrees, ?endAngleDegrees)
Parameters:
Curve
-
(Curve) Object of profile Curve
axis : Line
-
(Line) Line for the rail revolve axis
?startAngleDegrees : float
-
(float) Optional, default value: 0.0
Start angle of revolution in degrees
?endAngleDegrees : float
-
(float) Optional, default value: 360.0
End angle of revolution in degrees
Returns: NurbsSurface
(NurbsSurface) Newly created geometry. The caller owns the returned objects.
|
Create a Surface by revolving a Curve around an axis. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.MakeSrfContourCrvs(geometryObject, startPoint, endPoint, interval)
Parameters:
Brep
-
(Brep) Object to contour
startPoint : Point3d
-
(Point3d) The start point of a center line
endPoint : Point3d
-
(Point3d) the end point of a center line
interval : float
-
(float) Distance between contour Curves
Returns: ResizeArray<Curve>
(Curve ResizeArray) Newly created geometry. The caller owns the returned objects.
|
Creates a spaced series of planar Curves resulting from the intersection of defined cutting Planes through a Surface or Polysurface. For more information, see Rhino help for details on the Contour command. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.MakeSrfContourCrvs(geometryObject, plane)
Parameters:
Brep
-
(Brep) Object to contour
plane : Plane
-
(Plane) The Plane that defines the cutting Plane
Returns: ResizeArray<Curve>
(Curve ResizeArray) Newly created geometry. The caller owns the returned objects.
|
Creates a spaced series of planar Curves resulting from the intersection of defined cutting Planes through a Surface or Polysurface. For more information, see Rhino help for details on the Contour command. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.MakeSubCrv(curveGeo, param0, param1)
Parameters:
Curve
-
(Curve) The input geometry.
param0 : float
-
(float) First parameters on the source Curve
param1 : float
-
(float) Second parameters on the source Curve
Returns: Curve
(Curve) The resulting geometry; it is not added to a document.
|
Computes MakeSubCrv from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.MakeSurfacePeriodic(surfaceId, direction, ?deleteInput)
Parameters:
Guid
-
(Guid) The Surface's identifier
direction : int
-
(int) The direction to make periodic, either
0 = U
1 = V
?deleteInput : bool
-
(bool) Optional, default value: false
Delete the input Surface
Returns: Guid
(Guid) if deleteInput is False, identifier of the new Surface.
|
Makes an existing Surface a periodic NURBS Surface.
|
Full Usage:
RhinoScriptSyntax.MakeSweep1(rail, shapes, ?closed)
Parameters:
Curve
-
(Curve) Object of the rail Curve
shapes : Curve seq
-
(Curve seq) One or more cross section shape Curves
?closed : bool
-
(bool) Optional, default value: false
If True, then create a closed Surface
Returns: ResizeArray<Brep>
(Brep ResizeArray) Newly created geometry. The caller owns the returned objects.
An empty list if RhinoCommon finds no result, this is not an error.
|
Creates a Surface created through profile Curves that define the Surface shape and one Curve that defines a Surface edge. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.MakeSweep2(rails, shapes, ?closed)
Parameters:
Curve * Curve
-
(Curve * Curve) Objects of the two rail Curve
shapes : Curve seq
-
(Curve seq) One or more cross section shape Curves
?closed : bool
-
(bool) Optional, default value: false
If True, then create a closed Surface
Returns: ResizeArray<Brep>
(Brep ResizeArray) Newly created geometry. The caller owns the returned objects.
An empty list if RhinoCommon finds no result, this is not an error.
|
Creates a Surface created through profile Curves that define the Surface shape and two Curves that defines a Surface edge. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.MakeTweenCurves(fromCurve, toCurve, ?numberOfCurves, ?method, ?sampleNumber)
Parameters:
Curve
-
(Curve) The input geometry.
toCurve : Curve
-
(Curve) The input geometry.
?numberOfCurves : int
-
(int) Optional, default value: 1
The number of Curves to create. The default is 1
?method : int
-
(int) Optional, default value: 0
The method for refining the output Curves, where:
0: (Default) Uses the control points of the Curves for matching. So the first control point of first Curve is matched to first control point of the second Curve.
1: Refits the output Curves like using the FitCurve method. Both the input Curve and the output Curve will have the same structure. The resulting Curves are usually more complex than input unless input Curves are compatible.
2: Input Curves are divided to the specified number of points on the Curve, corresponding points define new points that output Curves go through. If you are making one tween Curve, the method essentially does the following: divides the two Curves into an equal number of points, finds the midpoint between the corresponding points on the Curves, and interpolates the tween Curve through those points
?sampleNumber : int
-
(int) Optional, default value: 10
The number of samples points to use if method is 2. The default is 10
Returns: ResizeArray<Curve>
(Curve ResizeArray) The resulting curves, without adding them to the document.
|
Computes MakeTweenCurves from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.MatchMaterial(source, destination)
Parameters:
int
-
(int) Index of an existing, non-deleted material.
destination : Guid seq
-
(Guid seq) Identifiers of the destination objects.
|
Assigns a material to destination objects using its material-table index.
|
|
|
Full Usage:
RhinoScriptSyntax.MatchObjectAttributes(targetIds, ?sourceId)
Parameters:
Guid seq
-
(Guid seq) Identifiers of objects to copy attributes to
?sourceId : Guid
-
(Guid) Optional, Identifier of object to copy attributes from. If None,
then the default attributes are copied to the targetIds
Returns: int
(int) number of objects modified.
|
Matches, or copies the attributes of a source object to a target object.
|
Full Usage:
RhinoScriptSyntax.MaterialBump(materialIndex, filename)
Parameters:
int
-
(int) Zero based material index.
filename : string
-
(string) The bump bitmap filename. The file must exist locally; Rhino search-path resolution is not used.
|
Modifies a material's bump bitmap filename.
|
Full Usage:
RhinoScriptSyntax.MaterialBump(materialIndex)
Parameters:
int
-
(int) Zero based material index.
Returns: string
(string) The current bump bitmap filename.
Or an empty string if no Bump texture is present on the Material.
|
Returns a material's bump bitmap filename.
|
Full Usage:
RhinoScriptSyntax.MaterialColor(materialIndex, color)
Parameters:
int
-
(int) Zero based material index.
color : Color
-
(Drawing.Color) The new color value
|
Modifies a material's diffuse color.
|
Full Usage:
RhinoScriptSyntax.MaterialColor(materialIndex)
Parameters:
int
-
(int) Zero based material index.
Returns: Color
(Drawing.Color) The current material color.
|
Returns a material's diffuse color.
|
Full Usage:
RhinoScriptSyntax.MaterialEnvironmentMap(materialIndex, filename)
Parameters:
int
-
(int) Zero based material index.
filename : string
-
(string) The environment bitmap filename. The file must exist locally; Rhino search-path resolution is not used.
|
Modifies a material's environment bitmap filename.
|
Full Usage:
RhinoScriptSyntax.MaterialEnvironmentMap(materialIndex)
Parameters:
int
-
(int) Zero based material index.
Returns: string
(string) The current environment bitmap filename.
Or an empty string if no MaterialEnvironmentMap texture is present on the Material.
|
Returns a material's environment bitmap filename.
|
Full Usage:
RhinoScriptSyntax.MaterialName(materialIndex, name)
Parameters:
int
-
(int) Zero based material index
name : string
-
(string) The new name
|
Modifies a material's user defined name.
|
Full Usage:
RhinoScriptSyntax.MaterialName(materialIndex)
Parameters:
int
-
(int) Zero based material index.
Returns: string
(string) The current material name.
|
Returns a material's user defined name.
|
Full Usage:
RhinoScriptSyntax.MaterialReflectiveColor(materialIndex, color)
Parameters:
int
-
(int) Zero based material index.
color : Color
-
(Drawing.Color) The new color value.
|
Modifies a material's reflective color.
|
Full Usage:
RhinoScriptSyntax.MaterialReflectiveColor(materialIndex)
Parameters:
int
-
(int) Zero based material index.
Returns: Color
(Drawing.Color) The current material reflective color.
|
Returns a material's reflective color.
|
Full Usage:
RhinoScriptSyntax.MaterialShine(materialIndex, shine)
Parameters:
int
-
(int) Zero based material index
shine : float
-
(float) The new shine value. A material's shine value ranges from 0.0 to 255.0, with
0.0 being matte and 255.0 being glossy
|
Modifies a material's shine value.
|
Full Usage:
RhinoScriptSyntax.MaterialShine(materialIndex)
Parameters:
int
-
(int) Zero based material index.
Returns: float
(float) The current material shine value
0.0 being matte and 255.0 being glossy.
|
Returns a material's shine value.
|
Full Usage:
RhinoScriptSyntax.MaterialTexture(materialIndex, filename)
Parameters:
int
-
(int) Zero based material index.
filename : string
-
(string) The texture bitmap filename. The file must exist locally; Rhino search-path resolution is not used.
|
Modifies a material's texture bitmap filename.
|
Full Usage:
RhinoScriptSyntax.MaterialTexture(materialIndex)
Parameters:
int
-
(int) Zero based material index.
Returns: string
(string) The current texture bitmap filename.
Or an empty string if no MaterialTexture is present on the Material
|
Returns a material's texture bitmap filename.
|
Full Usage:
RhinoScriptSyntax.MaterialTransparency(materialIndex, transparency)
Parameters:
int
-
(int) Zero based material index.
transparency : float
-
(float) The new transparency value. A material's transparency value ranges from 0.0 to 1.0, with
0.0 being opaque and 1.0 being transparent.
|
Modifies a material's transparency value.
|
Full Usage:
RhinoScriptSyntax.MaterialTransparency(materialIndex)
Parameters:
int
-
(int) Zero based material index.
Returns: float
(float) The current material transparency value
0.0 being opaque and 1.0 being transparent.
|
Returns a material's transparency value.
|
Full Usage:
RhinoScriptSyntax.MaterialTransparencyMap(materialIndex, filename)
Parameters:
int
-
(int) Zero based material index.
filename : string
-
(string) The transparency bitmap filename. The file must exist locally; Rhino search-path resolution is not used.
|
Modifies a material's transparency bitmap filename.
|
Full Usage:
RhinoScriptSyntax.MaterialTransparencyMap(materialIndex)
Parameters:
int
-
(int) Zero based material index.
Returns: string
(string) The current transparency bitmap filename.
Or an empty string if no Bump texture is present on the Material.
|
Returns a material's transparency bitmap filename.
|
Full Usage:
RhinoScriptSyntax.MaximizeRestoreView(?view)
Parameters:
string
-
(string) Optional, The title of the view. If omitted, the current
active view is used
|
Toggles a view's maximized/restore window state of the specified view.
|
Full Usage:
RhinoScriptSyntax.MeanCurve(curve0, curve1, ?angleToleranceRadians)
Parameters:
Curve
-
(Curve) The input geometry.
curve1 : Curve
-
(Curve) The input geometry.
?angleToleranceRadians : float
-
(float) Optional, default value: 0.0.
Angle tolerance in radians used to match kinks between Curves; 0.0 uses RhinoCommon's default (RhinoMath.UnsetValue).
Use RhinoMath.ToRadians to convert from degrees to radians.
Returns: Curve
(Curve) The resulting geometry; it is not added to a document.
|
Computes MeanCurve from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.MeanCurve(curve0, curve1, ?angleToleranceRadians)
Parameters:
Guid
-
(Guid) identifiers of first Curve
curve1 : Guid
-
(Guid) identifiers of second Curve
?angleToleranceRadians : float
-
(float) Optional, default value: 0.0.
Angle tolerance in radians used to match kinks between Curves; 0.0 uses RhinoCommon's default (RhinoMath.UnsetValue).
Use RhinoMath.ToRadians to convert from degrees to radians.
Returns: Guid
(Guid) objectId of the new or modified Curve.
|
Creates an average Curve from two Curves.
|
Full Usage:
RhinoScriptSyntax.MeshArea(meshes)
Parameters:
Mesh seq
-
(Mesh seq) The mesh geometry.
Returns: float
(float) The total area; zero for an empty collection.
|
Returns the total approximate area of a collection of meshes.
|
Full Usage:
RhinoScriptSyntax.MeshArea(objectIds)
Parameters:
Guid seq
-
(Guid seq) Identifiers of the mesh objects.
Returns: float
(float) The total area; zero for an empty collection.
|
Returns the total approximate area of a collection of mesh objects.
|
Full Usage:
RhinoScriptSyntax.MeshArea(mesh)
Parameters:
Mesh
-
(Mesh) Input geometry.
Returns: float
(float) total area of Mesh.
|
Returns approximate area of one mesh object.
|
Full Usage:
RhinoScriptSyntax.MeshArea(objectId)
Parameters:
Guid
-
(Guid) Identifier of a Mesh objects
Returns: float
(float) total area of Mesh.
|
Returns approximate area of one mesh object.
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.MeshBooleanDifference(input0, input1, ?deleteInput)
Parameters:
Guid seq
-
(Guid seq) Meshes to subtract from
input1 : Guid seq
-
(Guid seq) Meshes to subtract with
?deleteInput : bool
-
(bool) Optional, default value: true
Delete the input Meshes
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers of newly created Meshes.
|
Performs boolean difference operation on two sets of input Meshes.
|
|
|
Full Usage:
RhinoScriptSyntax.MeshBooleanIntersection(input0, input1, ?deleteInput)
Parameters:
Guid seq
-
(Guid seq) Meshes to intersect
input1 : Guid seq
-
(Guid seq) Meshes to intersect
?deleteInput : bool
-
(bool) Optional, default value: true
Delete the input Meshes
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers of new Meshes.
|
Performs boolean intersection operation on two sets of input Meshes.
|
|
|
Full Usage:
RhinoScriptSyntax.MeshBooleanSplit(input0, input1, ?deleteInput)
Parameters:
Guid seq
-
(Guid seq) Meshes to split from
input1 : Guid seq
-
(Guid seq) Meshes to split with
?deleteInput : bool
-
(bool) Optional, default value: true
Delete the input Meshes
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers of new Meshes.
|
Performs boolean split operation on two sets of input Meshes.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.MeshClosestPoint(mesh, point, ?maximumDistance)
Parameters:
Mesh
-
(Mesh) Input geometry.
point : Point3d
-
(Point3d) Point to test
?maximumDistance : float
-
(float) Optional, Upper bound used for closest point calculation.
If you are only interested in finding a point Q on the Mesh when
point.DistanceTo(Q) is smaller than maximumDistance, then set maximumDistance to
that value
Returns: Point3d * int
(Point3d * int) containing the results of the calculation where
[0] = the 3-D point on the Mesh
[1] = the index of the Mesh face on which the 3-D point lies.
|
Returns the point on a Mesh that is closest to a test point.
|
Full Usage:
RhinoScriptSyntax.MeshClosestPoint(objectId, point, ?maximumDistance)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object
point : Point3d
-
(Point3d) Point to test
?maximumDistance : float
-
(float) Optional, Upper bound used for closest point calculation.
If you are only interested in finding a point Q on the Mesh when
point.DistanceTo(Q) is smaller than maximumDistance, then set maximumDistance to
that value
Returns: Point3d * int
(Point3d * int) containing the results of the calculation where
[0] = the 3-D point on the Mesh
[1] = the index of the Mesh face on which the 3-D point lies.
|
Returns the point on a Mesh that is closest to a test point.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.MeshFaceCount(mesh)
Parameters:
Mesh
-
(Mesh) Input geometry.
Returns: int
(int) The number of Mesh faces.
|
Returns total face count of a Mesh object.
|
Full Usage:
RhinoScriptSyntax.MeshFaceCount(objectId)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object
Returns: int
(int) The number of Mesh faces.
|
Returns total face count of a Mesh object.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.MeshFacePoints(mesh)
Parameters:
Mesh
-
(Mesh) Input geometry.
Returns: ResizeArray<Point3d * Point3d * Point3d * Point3d>
(Point3d ResizeArray) List of 3D points that define the face vertices of the Mesh.
the faces are returned as both quads and triangles. For triangles, the third and fourth vertex will be identical.
|
Returns vertices of each face in a Mesh as tuple of 4 points.
|
Full Usage:
RhinoScriptSyntax.MeshFacePoints(objectId)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object
Returns: ResizeArray<Point3d * Point3d * Point3d * Point3d>
(Point3d ResizeArray) List of 3D points that define the face vertices of the Mesh.
the faces are returned as both quads and triangles. For triangles, the third and fourth vertex will be identical.
|
Returns vertices of each face in a Mesh as tuple of 4 points.
|
Full Usage:
RhinoScriptSyntax.MeshFaceVertices(mesh)
Parameters:
Mesh
-
(Mesh) Input geometry.
Returns: ResizeArray<int * int * int * int>
((int*int*int*int) ResizeArray) containing tuples of 4 numbers that define the vertex indices for
each face of the Mesh. Both quad and triangle faces are returned. If the
third and fourth vertex indices are identical, the face is a triangle.
|
Returns the vertex indices of all faces of a Mesh object, Does not suport Ngons yet.
|
Full Usage:
RhinoScriptSyntax.MeshFaceVertices(objectId)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object
Returns: ResizeArray<int * int * int * int>
((int*int*int*int) ResizeArray) containing tuples of 4 numbers that define the vertex indices for
each face of the Mesh. Both quad and triangle faces are returned. If the
third and fourth vertex indices are identical, the face is a triangle.
|
Returns the vertex indices of all faces of a Mesh object, Does not suport Ngons yet.
|
Full Usage:
RhinoScriptSyntax.MeshFaces(mesh, ?faceType)
Parameters:
Mesh
-
(Mesh) Input geometry.
?faceType : bool
-
(bool) Optional, default value: true
The face type to be returned.
True = both triangles and quads.
False = Quads are broken down into triangles
Returns: ResizeArray<Point3d>
(Point3d ResizeArray) List of 3D points that define the face vertices of the Mesh.
If faceType is True, then faces are returned as both quads and triangles
(every four 3D points). For triangles, the third and fourth vertex will be identical.
If faceType is False, then faces are returned as only triangles
(very three 3D points). Quads will be converted to triangles.
|
Returns face vertices of a Mesh.
|
Full Usage:
RhinoScriptSyntax.MeshFaces(objectId, ?faceType)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object
?faceType : bool
-
(bool) Optional, default value: true
The face type to be returned.
True = both triangles and quads.
False = Quads are broken down into triangles
Returns: ResizeArray<Point3d>
(Point3d ResizeArray) List of 3D points that define the face vertices of the Mesh.
If faceType is True, then faces are returned as both quads and triangles
(every four 3D points). For triangles, the third and fourth vertex will be identical.
If faceType is False, then faces are returned as only triangles
(very three 3D points). Quads will be converted to triangles.
|
Returns face vertices of a Mesh.
|
Full Usage:
RhinoScriptSyntax.MeshHasFaceNormals(mesh)
Parameters:
Mesh
-
(Mesh) Input geometry.
Returns: bool
(bool) True , otherwise False.
|
Verifies a Mesh object has face normals.
|
Full Usage:
RhinoScriptSyntax.MeshHasFaceNormals(objectId)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object
Returns: bool
(bool) True , otherwise False.
|
Verifies a Mesh object has face normals.
|
Full Usage:
RhinoScriptSyntax.MeshHasTextureCoordinates(mesh)
Parameters:
Mesh
-
(Mesh) Input geometry.
Returns: bool
(bool) True , otherwise False.
|
Verifies a Mesh object has texture coordinates.
|
Full Usage:
RhinoScriptSyntax.MeshHasTextureCoordinates(objectId)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object
Returns: bool
(bool) True , otherwise False.
|
Verifies a Mesh object has texture coordinates.
|
Full Usage:
RhinoScriptSyntax.MeshHasVertexColors(mesh)
Parameters:
Mesh
-
(Mesh) Input geometry.
Returns: bool
(bool) True , otherwise False.
|
Verifies a Mesh object has vertex colors.
|
Full Usage:
RhinoScriptSyntax.MeshHasVertexColors(objectId)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object
Returns: bool
(bool) True , otherwise False.
|
Verifies a Mesh object has vertex colors.
|
Full Usage:
RhinoScriptSyntax.MeshHasVertexNormals(mesh)
Parameters:
Mesh
-
(Mesh) Input geometry.
Returns: bool
(bool) True , otherwise False.
|
Verifies a Mesh object has vertex normals.
|
Full Usage:
RhinoScriptSyntax.MeshHasVertexNormals(objectId)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object
Returns: bool
(bool) True , otherwise False.
|
Verifies a Mesh object has vertex normals.
|
Full Usage:
RhinoScriptSyntax.MeshMeshIntersection(mesh1, mesh2, ?tolerance)
Parameters:
Mesh
-
(Mesh) Input geometry.
mesh2 : Mesh
-
(Mesh) Input geometry.
?tolerance : float
-
(float) Optional, default value: ModelAbsoluteTolerance * MeshIntersectionsTolerancesCoefficient
The intersection tolerance
Returns: Polyline array
(Polyline array) Array of points that define the vertices of the intersection Curves.
|
Calculates the intersections of a Mesh object with another Mesh object.
|
Full Usage:
RhinoScriptSyntax.MeshMeshIntersection(mesh1, mesh2, ?tolerance)
Parameters:
Guid
-
(Guid) Mesh1
mesh2 : Guid
-
(Guid) Mesh2
?tolerance : float
-
(float) Optional, default value: ModelAbsoluteTolerance * MeshIntersectionsTolerancesCoefficient
The intersection tolerance
Returns: Polyline array
(Polyline array) Array of points that define the vertices of the intersection Curves.
|
Calculates the intersections of a Mesh object with another Mesh object.
|
Full Usage:
RhinoScriptSyntax.MeshNakedEdgePoints(mesh)
Parameters:
Mesh
-
(Mesh) Input geometry.
Returns: bool array
(bool array) Array of boolean values that represent whether or not a Mesh vertex is
naked or not. The number of elements in the list will be equal to
the value returned by MeshVertexCount. In which case, the list will
identify the naked status for each vertex returned by MeshVertices.
|
Identifies the naked edge points of a Mesh object. This function shows where Mesh vertices are not completely surrounded by faces. Joined Meshes, such as are made by MeshBox, have naked Mesh edge points where the sub-meshes are joined.
|
Full Usage:
RhinoScriptSyntax.MeshNakedEdgePoints(objectId)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object
Returns: bool array
(bool array) Array of boolean values that represent whether or not a Mesh vertex is
naked or not. The number of elements in the list will be equal to
the value returned by MeshVertexCount. In which case, the list will
identify the naked status for each vertex returned by MeshVertices.
|
Identifies the naked edge points of a Mesh object. This function shows where Mesh vertices are not completely surrounded by faces. Joined Meshes, such as are made by MeshBox, have naked Mesh edge points where the sub-meshes are joined.
|
Full Usage:
RhinoScriptSyntax.MeshNgonFaceVertices(mesh)
Parameters:
Mesh
-
(Mesh) Input geometry.
Returns: ResizeArray<ResizeArray<int>>
(int ResizeArray ResizeArray) containing a nested List that define the vertex indices for
each face of the Mesh. Ngons, quad and triangle faces are returned.
|
Returns the vertex indices of all faces of a Ngon Mesh object.
|
Full Usage:
RhinoScriptSyntax.MeshNgonFaceVertices(objectId)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object.
Returns: ResizeArray<ResizeArray<int>>
(int ResizeArray ResizeArray) containing a nested List that define the vertex indices for
each face of the Mesh. Ngons, quad and triangle faces are returned.
|
Returns the vertex indices of all faces of a Ngon Mesh object.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.MeshOutline(meshes, ?view)
Parameters:
Mesh seq
-
(Mesh seq) Input Meshes.
?view : RhinoViewport
-
(Rhino.Display.RhinoViewport) Optional, default value: null. Viewport for the outline direction. Null uses the world XY plane.
Returns: ResizeArray<PolylineCurve>
(PolylineCurve ResizeArray) New outline Curves.
|
Creates Polyline Curve outlines of Meshes. Returns new geometry without adding it to a document.
|
Full Usage:
RhinoScriptSyntax.MeshOutline(objectIds, ?view)
Parameters:
Guid seq
-
(Guid seq) Identifiers of Meshes to outline
?view : string
-
(string) Optional, default value: Top View
View to use for outline direction
Returns: ResizeArray<Guid>
(Guid ResizeArray) Polyline Curve identifiers.
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.MeshQuadCount(mesh)
Parameters:
Mesh
-
(Mesh) Input geometry.
Returns: int
(int) The number of quad Mesh faces.
|
Returns the number of quad faces of a Mesh object.
|
Full Usage:
RhinoScriptSyntax.MeshQuadCount(objectId)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object
Returns: int
(int) The number of quad Mesh faces.
|
Returns the number of quad faces of a Mesh object.
|
Full Usage:
RhinoScriptSyntax.MeshQuadsToTriangles(objectId)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object
Returns: bool
(bool) True or False indicating success or failure.
|
Converts a Mesh object's quad faces to triangles.
|
|
|
|
|
|
Duplicates each Mesh polygon with a NURBS Surface and joins the Surfaces for each connected piece. Returns new geometry without adding it to a document.
|
Full Usage:
RhinoScriptSyntax.MeshToNurb(objectId, ?trimmedTriangles, ?deleteInput)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object
?trimmedTriangles : bool
-
(bool) Optional, default value: true
If True, triangles in the Mesh will be
represented by a trimmed Plane
?deleteInput : bool
-
(bool) Optional, default value: false
Delete input object
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers for the new breps.
|
Duplicates each polygon in a Mesh with a NURBS Surface. The resulting Surfaces are then joined into a Polysurface and added to the document.
|
Full Usage:
RhinoScriptSyntax.MeshTriangleCount(mesh)
Parameters:
Mesh
-
(Mesh) Input geometry.
Returns: int
(int) The number of triangular Mesh faces.
|
Returns number of triangular faces of a Mesh.
|
Full Usage:
RhinoScriptSyntax.MeshTriangleCount(objectId)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object
Returns: int
(int) The number of triangular Mesh faces.
|
Returns number of triangular faces of a Mesh.
|
Full Usage:
RhinoScriptSyntax.MeshVertexColors(meshId, colors)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object
colors : Color seq
-
(Drawing.Color seq), optional) A list of color values. Note, for each vertex, there must
be a corresponding vertex color. If the value is null or empty list , then any
existing vertex colors will be removed from the Mesh
|
Modifies vertex colors of a Mesh. |
|
|
|
|
Full Usage:
RhinoScriptSyntax.MeshVertexCount(mesh)
Parameters:
Mesh
-
(Mesh) Input geometry.
Returns: int
(int) The number of Mesh vertices.
|
Returns the vertex count of a Mesh.
|
Full Usage:
RhinoScriptSyntax.MeshVertexCount(objectId)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object
Returns: int
(int) The number of Mesh vertices.
|
Returns the vertex count of a Mesh.
|
Full Usage:
RhinoScriptSyntax.MeshVertexFaces(mesh, vertexIndex)
Parameters:
Mesh
-
(Mesh) Input geometry.
vertexIndex : int
-
(int) Index of the Mesh vertex to find faces for
Returns: int array
(int array) face indices.
|
Returns the Mesh faces that share a specified Mesh vertex.
|
Full Usage:
RhinoScriptSyntax.MeshVertexFaces(meshId, vertexIndex)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object
vertexIndex : int
-
(int) Index of the Mesh vertex to find faces for
Returns: int array
(int array) face indices.
|
Returns the Mesh faces that share a specified Mesh vertex.
|
|
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.MeshVolume(meshes)
Parameters:
Mesh seq
-
(Geometry.Mesh seq) Mesh Geometries
Returns: float
(float) total volume of all Meshes.
|
Returns the approximate volume of one or more closed Meshes.
|
Full Usage:
RhinoScriptSyntax.MeshVolume(objectIds)
Parameters:
Guid seq
-
(Guid seq) Identifiers of one or more Mesh objects
Returns: float
(float) total volume of all Meshes.
|
Returns the approximate volume of one or more closed Meshes.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.MessageBox(message, ?buttons, ?title)
Parameters:
string
-
(string) A prompt or message
?buttons : int
-
(int) Optional, default value: 0
Buttons and icon to display as a bit coded flag. Can be a combination of the
following flags. If omitted, an OK button and no icon is displayed
0 Display OK button only.
1 Display OK and Cancel buttons.
2 Display Abort, Retry, and Ignore buttons.
3 Display Yes, No, and Cancel buttons.
4 Display Yes and No buttons.
5 Display Retry and Cancel buttons.
16 Display Critical Message icon.
32 Display Warning Query icon.
48 Display Warning Message icon.
64 Display Information Message icon.
0 First button is the default.
256 Second button is the default.
512 Third button is the default.
768 Fourth button is the default.
0 Application modal. The user must respond to the message box
before continuing work in the current application.
4096 System modal. The user must respond to the message box
before continuing work in any application
?title : string
-
(string) Optional, default value: ""
The dialog box title
Returns: int
(int) an Int32 of indicating which button was clicked:
1 OK button was clicked.
2 Cancel button was clicked.
3 Abort button was clicked.
4 Retry button was clicked.
5 Ignore button was clicked.
6 Yes button was clicked.
7 No button was clicked.
_ A RhinoUserInteractionException is raised if input is cancelled.
|
Displays a message box. A message box contains a message and title, plus any combination of predefined icons and push buttons.
|
Full Usage:
RhinoScriptSyntax.MirrorObject(geometry, startPoint, endPoint)
Parameters:
GeometryBase
-
(GeometryBase) Input geometry to duplicate and transform.
startPoint : Point3d
-
(Point3d) Start of the mirror Plane
endPoint : Point3d
-
(Point3d) End of the mirror Plane
Returns: GeometryBase
(GeometryBase) The transformed geometry duplicate.
|
Returns a transformed duplicate of the input geometry. The input is unchanged and the result is not added to a document.
|
Full Usage:
RhinoScriptSyntax.MirrorObject(objectId, startPoint, endPoint, ?copy)
Parameters:
Guid
-
(Guid) The identifier of an object to mirror
startPoint : Point3d
-
(Point3d) Start of the mirror Plane
endPoint : Point3d
-
(Point3d) End of the mirror Plane
?copy : bool
-
(bool) Optional, default value: false
Copy the object. Copies of grouped objects are put into new groups
Returns: Guid
(Guid) Identifier of the mirrored object.
|
Mirrors a single object on World XY Plane. With copy=false the object in the document is transformed in place and keeps its Guid, with copy=true the original is left unchanged and a transformed copy is added to the document. The geometry overload returns a transformed duplicate instead and does not touch the document.
|
Full Usage:
RhinoScriptSyntax.MirrorObjects(geometries, startPoint, endPoint)
Parameters:
GeometryBase seq
-
(GeometryBase seq) Input geometry to duplicate and transform.
startPoint : Point3d
-
(Point3d) Start of the mirror Plane
endPoint : Point3d
-
(Point3d) End of the mirror Plane
Returns: ResizeArray<GeometryBase>
(GeometryBase ResizeArray) The transformed geometry duplicates.
|
Returns transformed duplicates of the input geometries. The input is unchanged and the result is not added to a document.
|
Full Usage:
RhinoScriptSyntax.MirrorObjects(objectIds, startPoint, endPoint, ?copy)
Parameters:
Guid seq
-
(Guid seq) Identifiers of objects to mirror
startPoint : Point3d
-
(Point3d) Start of the mirror Plane
endPoint : Point3d
-
(Point3d) End of the mirror Plane
?copy : bool
-
(bool) Optional, default value: false
Copy the objects. Copies of grouped objects are put into new groups
Returns: ResizeArray<Guid>
(Guid ResizeArray) List of identifiers of the mirrored objects.
|
Mirrors a list of objects on World XY Plane. With copy=false the objects in the document are transformed in place and keep their Guids, with copy=true the originals are left unchanged and transformed copies are added to the document. The geometry overload returns transformed duplicates instead and does not touch the document.
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.MultiListBox(items, ?message, ?title, ?defaultVals)
Parameters:
IList<string>
-
(string IList) A zero-based list of string items
?message : string
-
(string) Optional, A prompt or message
?title : string
-
(string) Optional, A dialog box title
?defaultVals : string
-
(string IList) Optional, a list if multiple items that are pre-selected
Returns: string array
(string array) an Array of containing the selected items.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Displays a list of items in a multiple-selection list box dialog.
|
Full Usage:
RhinoScriptSyntax.NamedCPlane(name)
Parameters:
string
-
(string) The name of the construction Plane
Returns: Plane
(Plane) a Plane.
|
Returns the Plane geometry of the specified named construction Plane.
|
Full Usage:
RhinoScriptSyntax.NamedCPlanes()
Returns: ResizeArray<string>
(string ResizeArray) The names of all named construction Planes in the document.
|
Returns the names of all named construction Planes in the document.
|
Full Usage:
RhinoScriptSyntax.NamedViews()
Returns: ResizeArray<string>
(string ResizeArray) The names of all named views in the document.
|
Returns the names of all named views in the document.
|
Full Usage:
RhinoScriptSyntax.NextObject(objectId, ?select, ?includeLights, ?includeGrips)
Parameters:
Guid
-
(Guid) The identifier of the object from which to get the next object
?select : bool
-
(bool) Optional, default value: false
Select the object
?includeLights : bool
-
(bool) Optional, default value: false
Include lights in the potential set
?includeGrips : bool
-
(bool) Optional, default value: false
Include grips in the potential set
Returns: Guid
(Guid) identifier of the object.
|
Returns the identifier of the next object in the document.
|
Full Usage:
RhinoScriptSyntax.NextObjectGrip(objectId, index, ?direction, ?enable)
Parameters:
Guid
-
(Guid) Identifier of the object
index : int
-
(int) Zero-based grip index from which to get the next grip index
?direction : int
-
(int) Optional, default value: 0
Direction to get the next grip index (0 = U, 1 = V)
?enable : bool
-
(bool) Optional, default value: true
If true, the next grip index found will be selected
Returns: int
(int) Index of the next grip.
|
Returns the next grip index from a specified grip index of an object.
|
Full Usage:
RhinoScriptSyntax.NormalObjects(?includeLights, ?includeGrips)
Parameters:
bool
-
(bool) Optional, default value: false
Include light objects. If omitted, light objects are not returned
?includeGrips : bool
-
(bool) Optional, default value: false
Include grips objects. If omitted, grips objects are not returned
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifier of normal objects.
|
Returns identifiers of all normal objects in the document. Normal objects are visible, can be snapped to, and are independent of selection state.
|
Full Usage:
RhinoScriptSyntax.Notes(newNotes)
Parameters:
string
-
(string) New notes to set
|
Sets the document's notes. Notes are generally created using Rhino's Notes command.
|
Full Usage:
RhinoScriptSyntax.Notes()
Returns: string
(string) The current notes.
|
Returns the document's notes. Notes are generally created using Rhino's Notes command.
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.ObjectColorSource(objectIds, source)
Parameters:
Guid seq
-
(Guid seq) Multiple identifiers
source : int
-
(int) New color source
0 = color from layer
1 = color from object
2 = color from material
3 = color from parent
|
Modifies the color source of multiple objects.
|
Full Usage:
RhinoScriptSyntax.ObjectColorSource(objectId, source)
Parameters:
Guid
-
(Guid) Single identifier
source : int
-
(int) New color source
0 = color from layer
1 = color from object
2 = color from material
3 = color from parent
|
Modifies the color source of an object.
|
Full Usage:
RhinoScriptSyntax.ObjectColorSource(objectId)
Parameters:
Guid
-
(Guid) Single identifier
Returns: int
(int) The current color source
0 = color from layer
1 = color from object
2 = color from material
3 = color from parent.
|
Returns the color source of an object.
|
Full Usage:
RhinoScriptSyntax.ObjectDescription(objectIds)
Parameters:
Guid seq
-
(Guid seq) Identifiers of objects
Returns: string
(string) A short text description of the object.
|
Returns the count for each object type in a List of objects.
|
Full Usage:
RhinoScriptSyntax.ObjectDescription(objectId)
Parameters:
Guid
-
(Guid) Identifier of an object
Returns: string
(string) A short text description of the object.
|
Returns a description of the object type (e.g. Line, Surface, Text,...).
|
Full Usage:
RhinoScriptSyntax.ObjectGripCount(objectId)
Parameters:
Guid
-
(Guid) Identifier of the object
Returns: int
(int) Number of grips.
|
Returns number of grips owned by an object.
|
|
|
|
Modifies the location of all grips owned by an object. The locations of the grips are returned in a list of Point3d with each position in the list corresponding to that grip's index. To modify the locations of the grips, you must provide a list of points that contains the same number of points as grips. |
|
Returns the location of all grips owned by an object. The locations of the grips are returned in a list of Point3d with each position in the list corresponding to that grip's index. To modify the locations of the grips, you must provide a list of points that contains the same number of points as grips.
|
Full Usage:
RhinoScriptSyntax.ObjectGripsOn(objectId)
Parameters:
Guid
-
(Guid) Identifier of the object
Returns: bool
(bool) True or false indicating grips state.
|
Checks if an object's grips are turned on.
|
Full Usage:
RhinoScriptSyntax.ObjectGripsSelected(objectId)
Parameters:
Guid
-
(Guid) Identifier of the object
Returns: bool
(bool) True or false indicating success or failure.
|
Checks if an object's grips are turned on and at least one grip is selected.
|
Full Usage:
RhinoScriptSyntax.ObjectGroups(objId)
Parameters:
Guid
-
(Guid) id of the object to query
Returns: ResizeArray<string>
(string ResizeArray) The group's names sorted from bottom to top. Or an empty List if object is not in a group.
|
Returns the names of all groups that an object is part of . This function primarily applies to objects that are members of nested groups.
|
Full Usage:
RhinoScriptSyntax.ObjectLayer(objectIds, layerIndex)
Parameters:
Guid seq
-
(Guid seq) The identifiers of the objects
layerIndex : int
-
(int) Index of layer in layer table
|
Modifies the layer of multiple objects, optionally creates layer if it does not exist yet.
|
Full Usage:
RhinoScriptSyntax.ObjectLayer(objectId, layerIndex)
Parameters:
Guid
-
(Guid) The identifier of the object
layerIndex : int
-
(int) Index of layer in layer table
|
Modifies the layer of an object.
|
Full Usage:
RhinoScriptSyntax.ObjectLayer(objectIds, layer, ?createLayerIfMissing, ?allowUnicode, ?collapseParents)
Parameters:
Guid seq
-
(Guid seq) The identifiers of the objects
layer : string
-
(string) Name of an existing layer
?createLayerIfMissing : bool
-
(bool) Optional, default value: false Set true to create Layer if it does not exist yet.
?allowUnicode : bool
-
(bool) Optional, Allow Ambiguous Unicode characters too
?collapseParents : bool
-
(bool) Optional, Collapse parent layers in Layer UI
|
Modifies the layer of multiple objects, optionally creates layer if it does not exist yet.
|
Full Usage:
RhinoScriptSyntax.ObjectLayer(objectId, layer, ?createLayerIfMissing, ?allowAllUnicode, ?collapseParents)
Parameters:
Guid
-
(Guid) The identifier of the object
layer : string
-
(string) Name of an existing layer
?createLayerIfMissing : bool
-
(bool) Optional, default value: false Set true to create Layer if it does not exist yet.
?allowAllUnicode : bool
-
(bool) Optional, Allow Ambiguous Unicode characters too
?collapseParents : bool
-
(bool) Optional, Collapse parent layers in Layer UI
|
Modifies the layer of an object , optionally creates layer if it does not exist yet.
|
Full Usage:
RhinoScriptSyntax.ObjectLayer(objectId)
Parameters:
Guid
-
(Guid) The identifier of the object
Returns: string
(string) The object's current layer.
|
Returns the full layer name of an object.
parent layers are separated by
|
Full Usage:
RhinoScriptSyntax.ObjectLayerShort(objectId)
Parameters:
Guid
-
(Guid) The identifier of the object
Returns: string
(string) The object's current layer.
|
Returns the short layer of an object. Without Parent Layers.
|
Full Usage:
RhinoScriptSyntax.ObjectLayout(objectIds, layout)
Parameters:
Guid seq
-
(Guid seq) Identifier of the objects
layout : string
-
(string) To change, or move, an objects from model space to page
layout space, or from one page layout to another, then specify the
title of an existing page layout view. To move an objects
from page layout space to model space, just specify an empty string.
|
Changes the layout or model space of an objects.
|
Full Usage:
RhinoScriptSyntax.ObjectLayout(objectId, layout)
Parameters:
Guid
-
(Guid) Identifier of the object
layout : string
-
(string) To change, or move, an object from model space to page
layout space, or from one page layout to another, then specify the
title of an existing page layout view. To move an object
from page layout space to model space, just specify an empty string.
|
Changes the layout or model space of an object.
|
Full Usage:
RhinoScriptSyntax.ObjectLayout(objectId)
Parameters:
Guid
-
(Guid) Identifier of the object
Returns: string
(string) The object's current page layout view, Empty String if it is in Model Space.
|
Returns the layout or model space of an object.
|
Full Usage:
RhinoScriptSyntax.ObjectLinetype(objectIds, linetype)
Parameters:
Guid seq
-
(Guid seq) Identifiers of objects
linetype : string
-
(string) Name of an existing linetype, not case sensitive
|
Modifies the linetype of multiple object.
|
Full Usage:
RhinoScriptSyntax.ObjectLinetype(objectId, linetype)
Parameters:
Guid
-
(Guid) Identifier of object
linetype : string
-
(string) Name of an existing linetype, not case sensitive
|
Modifies the linetype of an object.
|
Full Usage:
RhinoScriptSyntax.ObjectLinetype(objectId)
Parameters:
Guid
-
(Guid) Identifier of object
Returns: string
(string) The object's current linetype.
|
Returns the linetype of an object.
|
Full Usage:
RhinoScriptSyntax.ObjectLinetypeSource(objectIds, source)
Parameters:
Guid seq
-
(Guid seq) Identifiers of objects
source : int
-
(int) New linetype source.
If objectId is a list of identifiers, this parameter is required
0 = By Layer
1 = By Object
3 = By Parent
|
Modifies the linetype source of multiple objects.
|
Full Usage:
RhinoScriptSyntax.ObjectLinetypeSource(objectId, source)
Parameters:
Guid
-
(Guid) Identifier of object
source : int
-
(int) New linetype source.
If objectId is a list of identifiers, this parameter is required
0 = By Layer
1 = By Object
3 = By Parent
|
Modifies the linetype source of an object.
|
Full Usage:
RhinoScriptSyntax.ObjectLinetypeSource(objectId)
Parameters:
Guid
-
(Guid) Identifier of object
Returns: int
(int) The object's current linetype source
0 = By Layer
1 = By Object
3 = By Parent.
|
Returns the linetype source of an object.
|
Full Usage:
RhinoScriptSyntax.ObjectMaterialIndex(objectIds, materialIndex)
Parameters:
Guid seq
-
(Guid seq) Identifiers of an objects
materialIndex : int
-
(int) The new material index
|
Changes the material index multiple objects. Rendering materials are stored in Rhino's rendering material table. The table is conceptually an array. Render materials associated with objects and layers are specified by zero based indices into this array.
|
Full Usage:
RhinoScriptSyntax.ObjectMaterialIndex(objectId, materialIndex)
Parameters:
Guid
-
(Guid) Identifier of an object
materialIndex : int
-
(int) The new material index
|
Changes the material index of an object. Rendering materials are stored in Rhino's rendering material table. The table is conceptually an array. Render materials associated with objects and layers are specified by zero based indices into this array.
|
Full Usage:
RhinoScriptSyntax.ObjectMaterialIndex(objectId)
Parameters:
Guid
-
(Guid) Identifier of an object
Returns: int
(int) If the return value of ObjectMaterialSource is "material by object", then
the return value of this function is the index of the object's rendering
material. A material index of -1 indicates no material has been assigned,
and that Rhino's internal default material has been assigned to the object.
|
Returns the material index of an object. Rendering materials are stored in Rhino's rendering material table. The table is conceptually an array. Render materials associated with objects and layers are specified by zero based indices into this array.
|
Full Usage:
RhinoScriptSyntax.ObjectMaterialSource(objectIds, source)
Parameters:
Guid seq
-
(Guid seq) One or more objects identifiers
source : int
-
(int) The new rendering material source.
0 = Material from layer
1 = Material from objects
3 = Material from parent
|
Modifies the rendering material source of multiple objects.
|
Full Usage:
RhinoScriptSyntax.ObjectMaterialSource(objectId, source)
Parameters:
Guid
-
(Guid) One or more object identifiers
source : int
-
(int) The new rendering material source.
0 = Material from layer
1 = Material from object
3 = Material from parent
|
Modifies the rendering material source of an object.
|
Full Usage:
RhinoScriptSyntax.ObjectMaterialSource(objectId)
Parameters:
Guid
-
(Guid) One or more object identifiers
Returns: int
(int) The current rendering material source
0 = Material from layer
1 = Material from object
3 = Material from parent.
|
Returns the rendering material source of an object.
|
Full Usage:
RhinoScriptSyntax.ObjectName(objectIds, name)
Parameters:
Guid seq
-
(Guid seq)Id of objects
name : string
-
(string) The new objects name. Or empty string
|
Modifies the name of multiple objects.
|
Full Usage:
RhinoScriptSyntax.ObjectName(objectId, name)
Parameters:
Guid
-
(Guid)Id of object
name : string
-
(string) The new object name. Or empty string
|
Modifies the name of an object.
|
Full Usage:
RhinoScriptSyntax.ObjectName(objectId)
Parameters:
Guid
-
(Guid)Id of object
Returns: string
(string) The current object name, or empty string if no name given .
|
Returns the name of an object or "" if none given.
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.ObjectPrintColorSource(objectIds, source)
Parameters:
Guid seq
-
(Guid seq) Identifier of objects
source : int
-
(int) New print color source
0 = print color by layer
1 = print color by objects
2 = print color by display
3 = print color by parent
|
Modifies the print color source of multiple objects.
|
Full Usage:
RhinoScriptSyntax.ObjectPrintColorSource(objectId, source)
Parameters:
Guid
-
(Guid) Identifier of object
source : int
-
(int) New print color source
0 = print color by layer
1 = print color by object
2 = print color by display
3 = print color by parent
|
Modifies the print color source of an object.
|
Full Usage:
RhinoScriptSyntax.ObjectPrintColorSource(objectId)
Parameters:
Guid
-
(Guid) Identifier of object
Returns: int
(int) The object's current print color source
0 = print color by layer
1 = print color by object
2 = print color by display
3 = print color by parent.
|
Returns the print color source of an object.
|
Full Usage:
RhinoScriptSyntax.ObjectPrintWidth(objectIds, width)
Parameters:
Guid seq
-
(Guid seq) Identifier of objects
width : float
-
(float) New print width value in millimeters, where width = 0.0 means use
the default width, and width smaller than 0.0 (e.g. -1.0)means do-not-print (visible for screen display,
but does not show on print)
|
Modifies the print width of multiple objects.
|
Full Usage:
RhinoScriptSyntax.ObjectPrintWidth(objectId, width)
Parameters:
Guid
-
(Guid) Identifier of object
width : float
-
(float) New print width value in millimeters, where width = 0.0 means use
the default width, and width smaller than 0.0 (e.g. -1.0)means do-not-print (visible for screen display,
but does not show on print)
|
Modifies the print width of an object.
|
Full Usage:
RhinoScriptSyntax.ObjectPrintWidth(objectId)
Parameters:
Guid
-
(Guid) Identifier of object
Returns: float
(float) The object's current print width.
|
Returns the print width of an object.
|
Full Usage:
RhinoScriptSyntax.ObjectPrintWidthSource(objectIds, source)
Parameters:
Guid seq
-
(Guid seq) Identifier of objects
source : int
-
(int) New print width source
0 = print width by layer
1 = print width by objects
3 = print width by parent
|
Modifies the print width source of multiple objects.
|
Full Usage:
RhinoScriptSyntax.ObjectPrintWidthSource(objectId, source)
Parameters:
Guid
-
(Guid) Identifier of object
source : int
-
(int) New print width source
0 = print width by layer
1 = print width by object
3 = print width by parent
|
Modifies the print width source of an object.
|
Full Usage:
RhinoScriptSyntax.ObjectPrintWidthSource(objectId)
Parameters:
Guid
-
(Guid) Identifier of object
Returns: int
(int) The object's current print width source
0 = print width by layer
1 = print width by object
3 = print width by parent.
|
Returns the print width source of an object.
|
Full Usage:
RhinoScriptSyntax.ObjectTopGroup(objId)
Parameters:
Guid
-
(Guid) id of the object to query
Returns: string
(string) The top group's name. Fails if object is not in a group.
|
Returns the top most group name that an object is assigned. This function primarily applies to objects that are members of nested groups.
|
Full Usage:
RhinoScriptSyntax.ObjectType(objectId)
Parameters:
Guid
-
(Guid) Identifier of an object
Returns: int
(int) The object type .
The valid object types are as follows:
Value Description
0 Unknown object
1 Point
2 Point cloud
4 Curve
8 Surface or single-face brep
16 Polysurface or multiple-face
32 Mesh
256 Light
512 Annotation
4096 Instance or block reference
8192 Text dot object
16384 Grip object
32768 Detail
65536 Hatch
131072 Morph control
262144 SubD
134217728 Cage
268435456 Phantom
536870912 Clipping Plane
1073741824 Extrusion.
|
Returns the object type.
|
Full Usage:
RhinoScriptSyntax.ObjectsByColor(color, ?select, ?includeLights)
Parameters:
Color
-
(Drawing.Color) Color to get objects by
?select : bool
-
(bool) Optional, default value: false
Select the objects
?includeLights : bool
-
(bool) Optional, default value: false
Include lights in the set
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers of objects of the selected color.
|
Returns identifiers of all objects based on color.
|
Full Usage:
RhinoScriptSyntax.ObjectsByGroup(groupName, ?select)
Parameters:
string
-
(string) Name of the group
?select : bool
-
(bool) Optional, default value: false
Select the objects
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers for objects in the group.
|
Returns identifiers of all objects based on the objects' group name.
|
Full Usage:
RhinoScriptSyntax.ObjectsByLayer(layerName, ?select)
Parameters:
string
-
(string) Name of the layer
?select : bool
-
(bool) Optional, default value: false
Select the objects
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers for objects in the specified layer.
|
Returns identifiers of all objects based on the objects' layer name.
|
Full Usage:
RhinoScriptSyntax.ObjectsByName(name, ?select, ?includeLights, ?includeReferences)
Parameters:
string
-
(string) Name of the object or objects
?select : bool
-
(bool) Optional, default value: false
Select the objects
?includeLights : bool
-
(bool) Optional, default value: false
Include light objects
?includeReferences : bool
-
(bool) Optional, default value: false
Include reference objects such as work session objects
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers for objects with the specified name.
|
Returns identifiers of all objects based on user-assigned name.
|
Full Usage:
RhinoScriptSyntax.ObjectsByType(geometryType, ?select, ?state)
Parameters:
int
-
(int) The type(s) of geometry objects (points, Curves, Surfaces,
Meshes, etc.) that can be selected. Object types can be
added together as bit-coded flags to filter several different kinds of geometry.
Value Description
0 All objects
1 Point
2 Point cloud
4 Curve
8 Surface or single-face brep
16 Polysurface or multiple-face
32 Mesh
256 Light
512 Annotation
4096 Instance or block reference
8192 Text dot object
16384 Grip object
32768 Detail
65536 Hatch
131072 Morph control
262144 SubD
134217728 Cage
268435456 Phantom
536870912 Clipping Plane
1073741824 Extrusion
?select : bool
-
(bool) Optional, default value: false
Select the objects
?state : int
-
(int) Optional, default value: 0
The object state (normal, locked, and hidden). Object states can be
added together to filter several different states of geometry.
Value Description
0 All objects
1 Normal objects
2 Locked objects
4 Hidden objects
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers of object that fit the specified type(s).
|
Returns identifiers of all objects based on the objects' geometry type.
|
Full Usage:
RhinoScriptSyntax.OffsetCurve(curveGeo, direction, distance, ?normal, ?style)
Parameters:
Curve
-
(Curve) The input geometry.
direction : Point3d
-
(Point3d) Point describing direction of the offset
distance : float
-
(float) Distance of the offset
?normal : Vector3d
-
(Vector3d) Optional, default value: Vector3d.ZAxis
Normal of the Plane in which the offset will occur.
If omitted, the WorldXY Plane will be used
?style : int
-
(int) Optional, default value: 1
The corner style. If omitted, the style is sharp.
0 = None
1 = Sharp
2 = Round
3 = Smooth
4 = Chamfer
Returns: ResizeArray<Curve>
(Curve ResizeArray) The resulting geometry; it is not added to a document.
|
Computes OffsetCurve from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.OffsetCurve(curveId, direction, distance, ?normal, ?style)
Parameters:
Guid
-
(Guid) Identifier of a Curve object
direction : Point3d
-
(Point3d) Point describing direction of the offset
distance : float
-
(float) Distance of the offset
?normal : Vector3d
-
(Vector3d) Optional, default value: Vector3d.ZAxis
Normal of the Plane in which the offset will occur.
If omitted, the WorldXY Plane will be used
?style : int
-
(int) Optional, default value: 1
The corner style. If omitted, the style is sharp.
0 = None
1 = Sharp
2 = Round
3 = Smooth
4 = Chamfer
Returns: ResizeArray<Guid>
(Guid ResizeArray) list of ids for the new Curves.
|
Offsets a Curve by a distance. The offset Curve will be added to Rhino.
|
Full Usage:
RhinoScriptSyntax.OffsetCurveOnSurface(curveGeo, surfaceGeo, distance)
Parameters:
Curve
-
(Curve) The input geometry.
surfaceGeo : Surface
-
(Surface) The input geometry.
distance : float
-
(float)) The distance of the offset. Based on the Curve's direction, a positive value
will offset to the left and a negative value will offset to the right
Returns: ResizeArray<Curve>
(Curve ResizeArray) The resulting geometry; it is not added to a document.
|
Computes OffsetCurveOnSurface from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.OffsetCurveOnSurface(curveId, surfaceId, distance)
Parameters:
Guid
-
(Guid) The Curve identifiers
surfaceId : Guid
-
(Guid) The Surface identifiers
distance : float
-
(float)) The distance of the offset. Based on the Curve's direction, a positive value
will offset to the left and a negative value will offset to the right
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers of the new Curves.
|
Offset a Curve on a Surface. The source Curve must lie on the Surface. The offset Curve or Curves will be added to Rhino Document.
|
Full Usage:
RhinoScriptSyntax.OffsetCurveOnSurfaceUV(curveGeo, surfaceGeo, parameter)
Parameters:
Curve
-
(Curve) The input geometry.
surfaceGeo : Surface
-
(Surface) The input geometry.
parameter : Point2d
-
(Point2d)) U, V parameter that the Curve will be offset through
Returns: ResizeArray<Curve>
(Curve ResizeArray) The resulting geometry; it is not added to a document.
|
Computes OffsetCurveOnSurfaceUV from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.OffsetCurveOnSurfaceUV(curveId, surfaceId, parameter)
Parameters:
Guid
-
(Guid) Curve identifiers
surfaceId : Guid
-
(Guid) Surface identifiers
parameter : Point2d
-
(Point2d)) U, V parameter that the Curve will be offset through
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers of the new Curves.
|
Offset a Curve on a Surface. The source Curve must lie on the Surface. The offset Curve or Curves will be added to Rhino.
|
Full Usage:
RhinoScriptSyntax.OffsetSurface(surfaceGeo, distance, ?tolerance, ?bothSides, ?createSolid)
Parameters:
Brep
-
(Brep) The Surface
distance : float
-
(float) The distance to offset
?tolerance : float
-
(float) Optional, default value: 0.0
The offset tolerance. Use 0.0 to make a loose offset. Otherwise, the
document's absolute tolerance is usually sufficient
?bothSides : bool
-
(bool) Optional, default value: false
Offset to both sides of the input Surface
?createSolid : bool
-
(bool) Optional, default value: false
Make a solid object
Returns: Brep
(Brep) Newly created geometry. The caller owns the returned objects.
|
Offsets a trimmed or untrimmed Surface by a distance. The result is returned as a new Brep. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.OffsetSurface(surfaceId, distance, ?tolerance, ?bothSides, ?createSolid)
Parameters:
Guid
-
(Guid) The Surface's identifier
distance : float
-
(float) The distance to offset
?tolerance : float
-
(float) Optional, default value: 0.0
The offset tolerance. Use 0.0 to make a loose offset. Otherwise, the
document's absolute tolerance is usually sufficient
?bothSides : bool
-
(bool) Optional, default value: false
Offset to both sides of the input Surface
?createSolid : bool
-
(bool) Optional, default value: false
Make a solid object
Returns: Guid
(Guid) identifier of the new object.
|
Offsets a trimmed or untrimmed Surface by a distance. The offset Surface will be added to Rhino.
|
Full Usage:
RhinoScriptSyntax.OpenFileName(?title, ?filter, ?folder, ?filename, ?extension)
Parameters:
string
-
(string) Optional, A dialog box title
?filter : string
-
(string) Optional, A filter string. The filter must be in the following form:
"Description1|Filter1|Description2|Filter2||", where "||" terminates filter string.
If omitted, the filter (*.*) is used
?folder : string
-
(string) Optional, A default folder
?filename : string
-
(string) Optional, A default file name
?extension : string
-
(string) Optional, A default file extension
Returns: string
(string) A file name is successful.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Displays file open dialog box allowing the user to enter a file name. Note, this function does not open the file.
|
Full Usage:
RhinoScriptSyntax.OpenFileNames(?title, ?filter, ?folder, ?filename, ?extension)
Parameters:
string
-
(string) Optional, A dialog box title
?filter : string
-
(string) Optional, A filter string. The filter must be in the following form:
"Description1|Filter1|Description2|Filter2||", where "||" terminates filter string.
If omitted, the filter (*.*) is used
?folder : string
-
(string) Optional, A default folder
?filename : string
-
(string) Optional, A default file name
?extension : string
-
(string) Optional, A default file extension
Returns: string array
(string array) The selected file names.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Displays file open dialog box allowing the user to select one or more file names. Note, this function does not open the file.
|
Full Usage:
RhinoScriptSyntax.OpenToolbarCollection(file)
Parameters:
string
-
(string) Full path to the collection file
Returns: string
(string) Rhino-assigned name of the toolbar collection.
|
Opens a toolbar collection file.
|
Full Usage:
RhinoScriptSyntax.OrientObject(geometry, referencePts, targetPts, ?scale)
Parameters:
GeometryBase
-
(GeometryBase) Input geometry to duplicate and transform.
referencePts : IList<Point3d>
-
(IList of Point3d) list of 3D reference points.
targetPts : IList<Point3d>
-
(IList of Point3d) list of 3D target points.
?scale : bool
-
(bool) Optional, default value: false. Scale to match the target distance when both point lists contain two points.
Returns: GeometryBase
(GeometryBase) The transformed geometry duplicate.
|
Returns a transformed duplicate of the input geometry. The input is unchanged and the result is not added to a document.
|
Full Usage:
RhinoScriptSyntax.OrientObject(objectId, referencePts, targetPts, ?flags)
Parameters:
Guid
-
(Guid) Identifier of object
referencePts : IList<Point3d>
-
(IList of Point3d) list of 3D reference points.
targetPts : IList<Point3d>
-
(IList of Point3d) list of 3D target points.
?flags : int
-
(int) The orient flags values can be added together to specify multiple options.
Value Description
1 Copy object. The default is not to copy the object.
2 Scale object. The default is not to scale the object. Note, the scale option only applies if both reference and target contain only two 3-D points.
3 Scale and copy.
Returns: Guid
(Guid) The identifier of the oriented object. The original or the copied object. Depending on given flags
|
Orients a single object based on input points. If two 3-D points are specified, then this method will function similar to Rhino's Orient command. If more than two 3-D points are specified, then the function will orient similar to Rhino's Orient3Pt command. Without the copy flag the object in the document is transformed in place and keeps its Guid, with the copy flag the original is left unchanged and a transformed copy is added to the document. The geometry overload returns a transformed duplicate instead and does not touch the document.
|
Full Usage:
RhinoScriptSyntax.Ortho(enable)
Parameters:
bool
-
(bool) The new enabled status
|
Enables or disables Rhino's ortho modeling aid.
|
Full Usage:
RhinoScriptSyntax.Ortho()
Returns: bool
(bool) The current ortho status.
|
Get status of Rhino's ortho modeling aid.
|
Full Usage:
RhinoScriptSyntax.Osnap(enable)
Parameters:
bool
-
(bool) The new enabled status
|
Enables or disables Rhino's object snap modeling aid. Object snaps are tools for specifying points on existing objects.
|
Full Usage:
RhinoScriptSyntax.Osnap()
Returns: bool
(bool) The current object snap status.
|
Get status of Rhino's object snap modeling aid. Object snaps are tools for specifying points on existing objects.
|
Full Usage:
RhinoScriptSyntax.OsnapDialog(visible)
Parameters:
bool
-
(bool) The new visibility state.
|
Shows or hides Rhino's dockable object snap bar.
|
Full Usage:
RhinoScriptSyntax.OsnapDialog()
Returns: bool
(bool) The current visible state.
|
Get status of Rhino's dockable object snap bar.
|
Full Usage:
RhinoScriptSyntax.OsnapMode(mode)
Parameters:
int
-
(int) The object snap mode or modes to set.
0 None
2 Near
8 Focus
32 Center
64 Vertex
128 Knot
512 Quadrant
2048 Midpoint
8192 Intersection
131072 End
524288 Perpendicular
2097152 Tangent
134217728 Point
Object snap modes can be added together to set multiple modes
|
Sets the object snap mode. Object snaps are tools for specifying points on existing objects.
|
Full Usage:
RhinoScriptSyntax.OsnapMode()
Returns: int
(int) The current object snap mode(s)
0 None
2 Near
8 Focus
32 Center
64 Vertex
128 Knot
512 Quadrant
2048 Midpoint
8192 Intersection
131072 End
524288 Perpendicular
2097152 Tangent
134217728 Point
Object snap modes can be added together to set multiple modes
|
Returns the object snap mode. Object snaps are tools for specifying points on existing objects.
|
|
Object Table of the current active Rhino document
|
Full Usage:
RhinoScriptSyntax.ParentLayer(layer, parent)
Parameters:
string
-
(string) Name of an existing layer
parent : string
-
(string) Name of new parent layer. To remove the parent layer,
thus making a root-level layer, specify an empty string
|
Modify the parent layer of a layer.
|
Full Usage:
RhinoScriptSyntax.ParentLayer(layer)
Parameters:
string
-
(string) Name of an existing layer
Returns: string
(string) The name of the current parent layer or empty string if no parent present.
|
Return the parent layer of a layer or empty string if no parent present.
|
Full Usage:
RhinoScriptSyntax.Planar(enable)
Parameters:
bool
-
(bool) The new enable status.
|
Enables or disables Rhino's planar modeling aid.
|
Full Usage:
RhinoScriptSyntax.Planar()
Returns: bool
(bool) The current planar status.
|
Get status of Rhino's planar modeling aid.
|
Full Usage:
RhinoScriptSyntax.PlanarClosedCurveContainment(curveA, curveB, ?plane, ?tolerance)
Parameters:
Curve
-
(Curve) The input geometry.
curveB : Curve
-
(Curve) The input geometry.
?plane : Plane
-
(Plane) Optional, default value: Plane.WorldXY
Test Plane. If omitted, the Plane.WorldXY Plane is used
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Returns: int
(int) a number identifying the relationship
0 = the regions bounded by the Curves are disjoint
1 = the two Curves intersect
2 = the region bounded by CurveA is inside of CurveB
3 = the region bounded by CurveB is inside of CurveA.
|
Determines the relationship between the regions bounded by two coplanar simple closed Curves. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.PlanarClosedCurveContainment(curveA, curveB, ?plane, ?tolerance)
Parameters:
Guid
-
(Guid) identifier of the first planar, closed Curve
curveB : Guid
-
(Guid) identifier of the second planar, closed Curve
?plane : Plane
-
(Plane) Optional, default value: Plane.WorldXY
Test Plane. If omitted, the Plane.WorldXY Plane is used
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Returns: int
(int) a number identifying the relationship
0 = the regions bounded by the Curves are disjoint
1 = the two Curves intersect
2 = the region bounded by CurveA is inside of CurveB
3 = the region bounded by CurveB is inside of CurveA.
|
Determines the relationship between the regions bounded by two coplanar simple closed Curves.
|
Full Usage:
RhinoScriptSyntax.PlanarCurveCollision(curveA, curveB, ?plane, ?tolerance)
Parameters:
Curve
-
(Curve) The input geometry.
curveB : Curve
-
(Curve) The input geometry.
?plane : Plane
-
(Plane) Optional, default value: Plane.WorldXY
Test Plane. If omitted, the Plane.WorldXY Plane is used
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Returns: bool
(bool) True if the Curves intersect; otherwise False.
|
Determines if two coplanar Curves intersect. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.PlanarCurveCollision(curveA, curveB, ?plane, ?tolerance)
Parameters:
Guid
-
(Guid) identifier of the first planar Curve
curveB : Guid
-
(Guid) identifier of the second planar Curve
?plane : Plane
-
(Plane) Optional, default value: Plane.WorldXY
Test Plane. If omitted, the Plane.WorldXY Plane is used
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Returns: bool
(bool) True if the Curves intersect; otherwise False.
|
Determines if two coplanar Curves intersect.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.PlaneCurveIntersection(plane, curve, ?tolerance)
Parameters:
Plane
-
(Plane) The Plane to intersect
curve : Curve
-
(Curve) The Curve geometry to intersect
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
The intersection tolerance.
Returns: ResizeArray<int * Point3d * Point3d * Point3d * Point3d * float * float * float * float * float * float>
(ResizeArray of int * Point3d * Point3d * Point3d * Point3d * float * float * float * float* float * float)
A list of intersection information tuple . The list will contain one or more of the following tuple:
Element Type Description
[0] Number The intersection event type, either Point (1) or Overlap (2).
[1] Point3d If the event type is Point (1), then the intersection point on the Curve.
If the event type is Overlap (2), then intersection start point on the Curve.
[2] Point3d If the event type is Point (1), then the intersection point on the Curve.
If the event type is Overlap (2), then intersection end point on the Curve.
[3] Point3d If the event type is Point (1), then the intersection point on the Plane.
If the event type is Overlap (2), then intersection start point on the Plane.
[4] Point3d If the event type is Point (1), then the intersection point on the Plane.
If the event type is Overlap (2), then intersection end point on the Plane.
[5] Number If the event type is Point (1), then the Curve parameter.
If the event type is Overlap (2), then the start value of the Curve parameter range.
[6] Number If the event type is Point (1), then the Curve parameter.
If the event type is Overlap (2), then the end value of the Curve parameter range.
[7] Number If the event type is Point (1), then the U Plane parameter.
If the event type is Overlap (2), then the U Plane parameter for Curve at (n, 5).
[8] Number If the event type is Point (1), then the V Plane parameter.
If the event type is Overlap (2), then the V Plane parameter for Curve at (n, 5).
[9] Number If the event type is Point (1), then the U Plane parameter.
If the event type is Overlap (2), then the U Plane parameter for Curve at (n, 6).
[10] Number If the event type is Point (1), then the V Plane parameter.
If the event type is Overlap (2), then the V Plane parameter for Curve at (n, 6).
|
Intersect an infinite Plane and a Curve object.
|
Full Usage:
RhinoScriptSyntax.PlaneCurveIntersection(plane, curve, ?tolerance)
Parameters:
Plane
-
(Plane) The Plane to intersect
curve : Guid
-
(Guid) The identifier of the Curve object
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
The intersection tolerance.
Returns: ResizeArray<int * Point3d * Point3d * Point3d * Point3d * float * float * float * float * float * float>
(ResizeArray of int * Point3d * Point3d * Point3d * Point3d * float * float * float * float* float * float)
A list of intersection information tuple . The list will contain one or more of the following tuple:
Element Type Description
[0] Number The intersection event type, either Point (1) or Overlap (2).
[1] Point3d If the event type is Point (1), then the intersection point on the Curve.
If the event type is Overlap (2), then intersection start point on the Curve.
[2] Point3d If the event type is Point (1), then the intersection point on the Curve.
If the event type is Overlap (2), then intersection end point on the Curve.
[3] Point3d If the event type is Point (1), then the intersection point on the Plane.
If the event type is Overlap (2), then intersection start point on the Plane.
[4] Point3d If the event type is Point (1), then the intersection point on the Plane.
If the event type is Overlap (2), then intersection end point on the Plane.
[5] Number If the event type is Point (1), then the Curve parameter.
If the event type is Overlap (2), then the start value of the Curve parameter range.
[6] Number If the event type is Point (1), then the Curve parameter.
If the event type is Overlap (2), then the end value of the Curve parameter range.
[7] Number If the event type is Point (1), then the U Plane parameter.
If the event type is Overlap (2), then the U Plane parameter for Curve at (n, 5).
[8] Number If the event type is Point (1), then the V Plane parameter.
If the event type is Overlap (2), then the V Plane parameter for Curve at (n, 5).
[9] Number If the event type is Point (1), then the U Plane parameter.
If the event type is Overlap (2), then the U Plane parameter for Curve at (n, 6).
[10] Number If the event type is Point (1), then the V Plane parameter.
If the event type is Overlap (2), then the V Plane parameter for Curve at (n, 6).
|
Intersect an infinite Plane and a Curve object.
|
Full Usage:
RhinoScriptSyntax.PlaneEquation(plane)
Parameters:
Plane
-
(Plane) The Plane to deconstruct
Returns: float * float * float * float
(float * float * float * float) containing four numbers that represent the coefficients of the equation (A, B, C, D).
|
Returns the equation of a Plane as a tuple of four numbers. The standard equation of a Plane with a non-zero vector is Ax + By + Cz + D = 0.
|
|
|
Full Usage:
RhinoScriptSyntax.PlaneFromFrame(origin, xAxis, yAxis)
Parameters:
Point3d
-
(Point3d) A 3D point identifying the origin of the Plane
xAxis : Vector3d
-
(Vector3d) A non-zero 3D vector in the Plane that determines the X axis
direction
yAxis : Vector3d
-
(Vector3d) A non-zero 3D vector not parallel to xAxis that is used
to determine the Y axis direction. Note, yAxis does not
have to be perpendicular to xAxis
Returns: Plane
(Plane) The Plane.
|
Construct a Plane from a point, and two vectors in the Plane.
|
Full Usage:
RhinoScriptSyntax.PlaneFromNormal(origin, normal, ?xAxis)
Parameters:
Point3d
-
(Point3d) A 3D point identifying the origin of the Plane
normal : Vector3d
-
(Vector3d) A 3D vector identifying the normal direction of the Plane
?xAxis : Vector3d
-
(Vector3d) Optional, vector defining the Plane's x-axis
Returns: Plane
(Plane) The Plane.
|
Creates a Plane from an origin point and a normal direction vector.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.PlaneSphereIntersection(plane, spherePlane, sphereRadius)
Parameters:
Plane
-
(Plane) The Plane to intersect
spherePlane : Plane
-
(Plane) Equatorial Plane of the sphere. origin of the Plane is
the center of the sphere
sphereRadius : float
-
(float) Radius of the sphere
Returns: int * Plane * float
(int * Plane * float) of intersection results
Element Type Description
[0] number The type of intersection, where 0 = point and 1 = circle.
[1] Plane For a point intersection, Plane.Origin is the intersection point.
For a circle intersection, this is the circle's plane; its origin is the circle center.
[2] number If a circle intersection, then the radius of the circle.
|
Calculates the intersection of a Plane and a sphere.
|
|
|
Full Usage:
RhinoScriptSyntax.PlugInId(plugin)
Parameters:
string
-
(string) The name of the plug-in
Returns: Guid
(Guid) The Unique Guid of the plug-in.
|
Returns the identifier of a plug-in given the plug-in name.
|
Full Usage:
RhinoScriptSyntax.PlugIns(?types, ?status)
Parameters:
int
-
(int) Optional, default value: 0
The type of plug-ins to return.
0 = all
1 = render
2 = file export
4 = file import
8 = digitizer
16 = utility.
If omitted, all are returned
?status : int
-
(int) Optional, default value: 0
0 = both loaded and unloaded,
1 = loaded,
2 = unloaded. If omitted both statuses are returned
Returns: string array
(string array) array of registered Rhino plug-ins.
|
Returns an array of registered Rhino plug-ins.
|
|
|
Full Usage:
RhinoScriptSyntax.PointArrayBoundingBox(points, ?plane)
Parameters:
Point3d seq
-
(Point3d seq) A list of 3-D points
?plane : Plane
-
(Plane) Optional, default value: Plane.WorldXY
Plane to which the bounding box should be aligned,
If omitted, a world axis-aligned bounding box
will be calculated
Returns: Box
(Box) A Rhino.Geometry.Box.
|
Returns either a world axis-aligned or a construction Plane axis-aligned bounding box of an array of 3-D point locations.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.PointClosestObject(point, geometries)
Parameters:
Point3d
-
(Point3d) Point to test
geometries : GeometryBase seq
-
(GeometryBase seq) Geometry to compare directly
Returns: GeometryBase * Point3d * float
(GeometryBase * Point3d * float) Tuple of 3 values
[0] The closest input geometry
[1] the point on object
[2] the distance.
|
Finds the object that is closest to a test point.
|
Full Usage:
RhinoScriptSyntax.PointClosestObject(point, objectIds)
Parameters:
Point3d
-
(Point3d) Point to test
objectIds : Guid seq
-
(Guid seq) Identifiers of one or more objects
Returns: Guid * Point3d * float
(Guid * Point3d * float) Tuple of 3 values
[0] Guid, closest objectId
[1] the point on object
[2] the distance.
|
|
Full Usage:
RhinoScriptSyntax.PointCloudClosestPoints(ptCloud, needlePoints, distance)
Parameters:
Point3d seq
-
(Point3d seq) The point cloud to be searched, or the "hay stack". This can also be a list of points
needlePoints : Point3d seq
-
(Point3d seq) A list of points to search in the PointCloud. This can also be specified as a point cloud
distance : float
-
(float) The included limit for listing points
Returns: int[] seq
(int array seq) a seq of arrays with the indices of the found points.
|
Returns a list of lists of point indices in a point cloud that are closest to needlePoints. Each inner list references all points within or on the Surface of a sphere of distance radius.
|
Full Usage:
RhinoScriptSyntax.PointCloudCount(geometryObject)
Parameters:
PointCloud
-
(PointCloud) Geometry to use directly.
Returns: int
(int) number of points.
|
Returns the point count of a point cloud object.
|
Full Usage:
RhinoScriptSyntax.PointCloudCount(objectId)
Parameters:
Guid
-
(Guid) The point cloud object's identifier
Returns: int
(int) number of points.
|
Returns the point count of a point cloud object.
|
Full Usage:
RhinoScriptSyntax.PointCloudHasHiddenPoints(geometryObject)
Parameters:
PointCloud
-
(PointCloud) Geometry to use directly.
Returns: bool
(bool) True if cloud has hidden points, otherwise False.
|
Checks if a point cloud has hidden points.
|
Full Usage:
RhinoScriptSyntax.PointCloudHasHiddenPoints(objectId)
Parameters:
Guid
-
(Guid) The point cloud object's identifier
Returns: bool
(bool) True if cloud has hidden points, otherwise False.
|
Checks if a point cloud has hidden points.
|
Full Usage:
RhinoScriptSyntax.PointCloudHasPointColors(geometryObject)
Parameters:
PointCloud
-
(PointCloud) Geometry to use directly.
Returns: bool
(bool) True if cloud has point colors, otherwise False.
|
Checks if a point cloud has point colors.
|
Full Usage:
RhinoScriptSyntax.PointCloudHasPointColors(objectId)
Parameters:
Guid
-
(Guid) The point cloud object's identifier
Returns: bool
(bool) True if cloud has point colors, otherwise False.
|
Checks if a point cloud has point colors.
|
Full Usage:
RhinoScriptSyntax.PointCloudHidePoints(geometryObject)
Parameters:
PointCloud
-
(PointCloud) Geometry to use directly.
Returns: ResizeArray<bool>
(bool ResizeArray) List of point cloud hidden states.
|
Returns the hidden state of points in a point cloud object.
|
Full Usage:
RhinoScriptSyntax.PointCloudHidePoints(objectId, hidden)
Parameters:
Guid
-
(Guid) The point cloud object's identifier
hidden : bool seq
-
(bool seq) List of booleans matched to the index of points to be hidden, On empty seq all point wil be shown
|
Modifies the hidden points of a point cloud object.
|
Full Usage:
RhinoScriptSyntax.PointCloudHidePoints(objectId)
Parameters:
Guid
-
(Guid) The point cloud object's identifier
Returns: ResizeArray<bool>
(bool ResizeArray) List of point cloud hidden states.
|
Returns the hidden state of points in a point cloud object.
|
Full Usage:
RhinoScriptSyntax.PointCloudKNeighbors(ptCloud, needlePoints, ?amount)
Parameters:
Point3d seq
-
(Point3d seq) The point cloud to be searched, or the "hay stack".
This can also be a list of points
needlePoints : Point3d seq
-
(Point3d seq) A list of points to search in the PointCloud.
This can also be specified as a point cloud
?amount : int
-
(int) Optional, default value: 1
The amount of required closest points. Defaults to 1
Returns: int[] seq
(int array seq) nested lists with amount items within a list, with the indices of the found points.
|
Returns amount indices of points in a point cloud that are near needlePoints.
|
Full Usage:
RhinoScriptSyntax.PointCloudPointColors(geometryObject)
Parameters:
PointCloud
-
(PointCloud) Geometry to use directly.
Returns: ResizeArray<Color>
(Drawing.Color ResizeArray) List of point cloud colors.
|
Returns the point colors of a point cloud object.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.PointCloudPoints(geometryObject)
Parameters:
PointCloud
-
(PointCloud) Geometry to use directly.
Returns: Point3d array
(Point3d array) list of points.
|
Returns the points of a point cloud object.
|
|
|
Full Usage:
RhinoScriptSyntax.PointCompare(point1, point2, ?tolerance)
Parameters:
Point3d
-
(Point3d) Point1 of the points to compare
point2 : Point3d
-
(Point3d) Point2 of the points to compare
?tolerance : float
-
(float) Optional, default value: RhinoMath.ZeroTolerance
Tolerance to use for comparison.
Returns: bool
(bool) True or False.
|
|
|
|
|
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.PointInPlanarClosedCurve(point, curve, ?plane, ?tolerance)
Parameters:
Point3d
-
(Point3d) Text point
curve : Curve
-
(Curve) The input geometry.
?plane : Plane
-
(Plane) Optional, default value: Plane.WorldXY
Plane containing the closed Curve and point. If omitted, Plane.WorldXY is used
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Returns: int
(int) number identifying the result
0 = point is outside of the Curve
1 = point is inside of the Curve
2 = point is on the Curve.
|
Determines if a point is inside of a closed Curve, on a closed Curve, or outside of a closed Curve. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.PointInPlanarClosedCurve(point, curve, ?plane, ?tolerance)
Parameters:
Point3d
-
(Point3d) Text point
curve : Guid
-
(Guid) Identifier of a Curve object
?plane : Plane
-
(Plane) Optional, default value: Plane.WorldXY
Plane containing the closed Curve and point. If omitted, Plane.WorldXY is used
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Returns: int
(int) number identifying the result
0 = point is outside of the Curve
1 = point is inside of the Curve
2 = point is on the Curve.
|
Determines if a point is inside of a closed Curve, on a closed Curve, or outside of a closed Curve.
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.PointsAreCoplanar(points, ?tolerance)
Parameters:
Point3d seq
-
(Point3d seq) 3D points to test
?tolerance : float
-
(float) Optional, default value: 1.0e-12 (RhinoMath.ZeroTolerance)
Tolerance to use when verifying
Returns: bool
(bool) True or False.
|
Checks if a list of 3D points are coplanar.
|
Full Usage:
RhinoScriptSyntax.Polar(point, angleDegrees, distance, ?plane)
Parameters:
Point3d
-
(Point3d) The point to transform
angleDegrees : float
-
(float) Angle in degrees
distance : float
-
(float) Distance from point
?plane : Plane
-
(Plane) Optional, Plane to base the transformation. If omitted, the world
x-y Plane is used
Returns: Point3d
(Point3d) resulting point is successful.
|
Returns 3D point that is a specified angle and distance from a 3D point.
|
Full Usage:
RhinoScriptSyntax.PolyCurveCount(curveGeo, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
?segmentIndex : int
-
(int) Optional,
If `curveId` identifies a PolyCurve object, then `segmentIndex` identifies the Curve segment of the PolyCurve to query
Returns: int
(int) The number of Curve segments in a PolyCurve.
|
Returns the number of Curve segments that make up a PolyCurve. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.PolyCurveCount(curveId, ?segmentIndex)
Parameters:
Guid
-
(Guid) The object's identifier
?segmentIndex : int
-
(int) Optional,
If `curveId` identifies a PolyCurve object, then `segmentIndex` identifies the Curve segment of the PolyCurve to query
Returns: int
(int) The number of Curve segments in a PolyCurve.
|
Returns the number of Curve segments that make up a PolyCurve.
|
Full Usage:
RhinoScriptSyntax.PolylineVertices(curveGeo, ?segmentIndex)
Parameters:
Curve
-
(Curve) The input geometry.
?segmentIndex : int
-
(int) Optional,
If CurveId identifies a PolyCurve object, then segmentIndex identifies the Curve segment of the PolyCurve to query
Returns: ResizeArray<Point3d>
(Point3d ResizeArray) an list of Point3d vertex points.
|
Returns the vertices of a Polyline Curve. Uses the supplied geometry directly.
|
Full Usage:
RhinoScriptSyntax.PolylineVertices(curveId, ?segmentIndex)
Parameters:
Guid
-
(Guid) The object's identifier
?segmentIndex : int
-
(int) Optional,
If CurveId identifies a PolyCurve object, then segmentIndex identifies the Curve segment of the PolyCurve to query
Returns: ResizeArray<Point3d>
(Point3d ResizeArray) an list of Point3d vertex points.
|
Returns the vertices of a Polyline Curve.
|
Full Usage:
RhinoScriptSyntax.PopupMenu(items, ?modes, ?point, ?view)
Parameters:
string seq
-
(string seq) List of strings representing the menu items. An empty string or None
will create a separator
?modes : int
-
(int seq) Optional, List of numbers identifying the display modes. If omitted, all
modes are enabled.
0 = menu item is enabled
1 = menu item is disabled
2 = menu item is checked
3 = menu item is disabled and checked
?point : Point3d
-
(Point3d) Optional, A 3D point where the menu item will appear. If omitted, the menu
will appear at the current cursor position
?view : string
-
(string) Optional, If point is specified, the view in which the point is computed.
If omitted, the active view is used
Returns: int
(int) index of the menu item picked or -1 if no menu item was picked.
|
Display a context-style popup menu. The popup menu can appear almost anywhere, and can be dismissed by clicking the left or right mouse buttons.
|
Full Usage:
RhinoScriptSyntax.PrevObjectGrip(objectId, index, ?direction, ?enable)
Parameters:
Guid
-
(Guid) Identifier of the object
index : int
-
(int) Zero-based grip index from which to get the previous grip index
?direction : int
-
(int) Optional, default value: 0
Direction to get the previous grip index (0 = U, 1 = V)
?enable : bool
-
(bool) Optional, default value: true
If true, the previous grip index found will be selected
Returns: int
(int) Index of the previous grip.
|
Returns the previous grip index from a specified grip index of an object.
|
Full Usage:
RhinoScriptSyntax.Print(txt)
Parameters:
string
-
(string) the string to Print
|
Prints a string to the console and to the Rhino command line using F#'s %A formatting.
|
Full Usage:
RhinoScriptSyntax.Print(obj)
Parameters:
'T
-
(object) any object
Type parameters: 'T |
Prints any object to the console and to the Rhino command line using F#'s %A formatting.
|
Full Usage:
RhinoScriptSyntax.ProjectCurveToMesh(curveInputs, meshInputs, direction)
Parameters:
Curve seq
-
(Curve seq) The input objects.
meshInputs : Mesh seq
-
(Mesh seq) The input objects.
direction : Vector3d
-
(Vector3d) Projection direction
Returns: ResizeArray<Curve>
(Curve ResizeArray) The resulting curves, without adding them to the document.
|
Computes ProjectCurveToMesh from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.ProjectCurveToMesh(curveIds, meshIds, direction)
Parameters:
Guid seq
-
(Guid seq) Identifiers of Curves to project
meshIds : Guid seq
-
(Guid seq) Identifiers of Meshes to project onto
direction : Vector3d
-
(Vector3d) Projection direction
Returns: ResizeArray<Guid>
(Guid ResizeArray) list of identifiers for the resulting Curves.
|
Projects one or more Curves onto one or more Surfaces or Meshes.
|
Full Usage:
RhinoScriptSyntax.ProjectCurveToSurface(curveInputs, surfaceInputs, direction)
Parameters:
Curve seq
-
(Curve seq) The input objects.
surfaceInputs : Brep seq
-
(Brep seq) The input objects.
direction : Vector3d
-
(Vector3d) Projection direction
Returns: ResizeArray<Curve>
(Curve ResizeArray) The resulting curves, without adding them to the document.
|
Computes ProjectCurveToSurface from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.ProjectCurveToSurface(curveIds, surfaceIds, direction)
Parameters:
Guid seq
-
(Guid seq) Identifiers of Curves to project
surfaceIds : Guid seq
-
(Guid seq) Identifiers of Surfaces to project onto
direction : Vector3d
-
(Vector3d) Projection direction
Returns: ResizeArray<Guid>
(Guid ResizeArray) list of identifiers.
|
Projects one or more Curves onto one or more Surfaces or Polysurfaces.
|
Full Usage:
RhinoScriptSyntax.ProjectOsnaps(enable)
Parameters:
bool
-
(bool) The new enabled status.
|
Enables or disables object snap projection.
|
Full Usage:
RhinoScriptSyntax.ProjectOsnaps()
Returns: bool
(bool) The current object snap projection status.
|
Get status of object snap projection.
|
Full Usage:
RhinoScriptSyntax.ProjectPointToMesh(points, meshGeos, direction)
Parameters:
Point3d seq
-
(Point3d seq) One or more 3D points
meshGeos : Mesh seq
-
(Mesh seq) Meshes to use directly
direction : Vector3d
-
(Vector3d) Direction vector to project the points
Returns: Point3d array
(Point3d array) projected points.
|
|
Full Usage:
RhinoScriptSyntax.ProjectPointToMesh(points, meshIds, direction)
Parameters:
Point3d seq
-
(Point3d seq) One or more 3D points
meshIds : Guid seq
-
(Guid seq) Identifiers of one or more Meshes
direction : Vector3d
-
(Vector3d) Direction vector to project the points
Returns: Point3d array
(Point3d array) projected points.
|
Projects one or more points onto one or more Meshes.
|
Full Usage:
RhinoScriptSyntax.ProjectPointToSurface(points, surfaceGeos, direction)
Parameters:
Point3d seq
-
(Point3d seq) One or more 3D points
surfaceGeos : Brep seq
-
(Brep seq) Surface or polysurface Breps to use directly
direction : Vector3d
-
(Vector3d) Direction vector to project the points
Returns: Point3d array
(Point3d array) projected points.
|
Projects one or more points onto one or more Surfaces or Polysurfaces.
|
Full Usage:
RhinoScriptSyntax.ProjectPointToSurface(points, surfaceIds, direction)
Parameters:
Point3d seq
-
(Point3d seq) One or more 3D points
surfaceIds : Guid seq
-
(Guid seq) Identifiers of one or more Surfaces/polysurfaces
direction : Vector3d
-
(Vector3d) Direction vector to project the points
Returns: Point3d array
(Point3d array) projected points.
|
Projects one or more points onto one or more Surfaces or Polysurfaces.
|
Full Usage:
RhinoScriptSyntax.Prompt(?message)
Parameters:
string
-
(string) Optional, default value: "". The new prompt; omit to clear it.
|
Change Rhino's command window prompt.
|
Full Usage:
RhinoScriptSyntax.PropertyListBox(items, values, ?message, ?title)
Parameters:
IList<string>
-
(string IList) list of string items
values : IList<string>
-
(string IList) The corresponding values to the items
?message : string
-
(string) Optional, A prompt or message
?title : string
-
(string) Optional, A dialog box title
Returns: string array
(string array) An Array of new values.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Displays list of items and their values in a property-style list box dialog.
|
|
|
Full Usage:
RhinoScriptSyntax.PullCurve(surface, curve, ?deleteInput)
Parameters:
Guid
-
(Guid) The Surface's identifier
curve : Guid
-
(Guid) The Curve's identifier
?deleteInput : bool
-
(bool) Optional, default value: false
Should the input items be deleted
Returns: ResizeArray<Guid>
(Guid ResizeArray) List of new Curves.
|
|
Full Usage:
RhinoScriptSyntax.PullCurveToMesh(mesh, curve)
Parameters: Returns: PolylineCurve
(PolylineCurve) The new pulled Curve.
|
Pulls a polyline approximation of a Curve onto a Mesh. Returns new geometry without adding it to a document.
|
|
Pulls a Curve to a Mesh. The function makes a Polyline approximation of the input Curve and gets the closest point on the Mesh for each point on the polyline. Then it "connects the points" to create a Polyline on the Mesh.
|
Full Usage:
RhinoScriptSyntax.PullPoints(geometryObject, points)
Parameters:
GeometryBase
-
(GeometryBase) The Surface or Mesh geometry that pulls
points : Point3d seq
-
(Point3d seq) List of 3D points
Returns: Point3d array
(Point3d array) 3D points pulled onto Surface or Mesh.
|
Pulls an array of points to a Surface or Mesh object. For more information, see the Rhino help file Pull command.
|
|
Pulls an array of points to a Surface or Mesh object. For more information, see the Rhino help file Pull command.
|
Full Usage:
RhinoScriptSyntax.PurgeEmptyLayers(?keepCurrent)
Parameters:
bool
-
(bool) Optional, default value: true
'true' to keep the current Layer even if empty
'false' to remove current layer too if its empty. Any other non empty layer might be the new current
|
Removes all empty layers from the document. Even if it is current
|
Full Usage:
RhinoScriptSyntax.PurgeLayer(layer)
Parameters:
string
-
(string) The name of an existing empty layer
Returns: bool
(bool) True or False indicating success or failure.
|
Removes an existing layer and all its objects from the document. The layer will be removed even if it contains geometry objects. The layer to be removed cannot be the current layer.
|
Full Usage:
RhinoScriptSyntax.ReadFileVersion()
Returns: int
(int) The file version of the current document.
|
Returns the file version of the current document. Use this function to determine which version of Rhino last saved the document. Note, this function will not return values from referenced or merged files.
|
Full Usage:
RhinoScriptSyntax.RealBox(?message, ?defaultValNumber, ?title, ?minimum, ?maximum)
Parameters:
string
-
(string) Optional, default value: ""
A prompt message
?defaultValNumber : float
-
(float) Optional, A default number
?title : string
-
(string) Optional, default value: ""
A dialog box title
?minimum : float
-
(float) Optional, A minimum allowable value
?maximum : float
-
(float) Optional, A maximum allowable value
Returns: float
(float) The newly entered number.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Display a dialog box prompting the user to enter a number.
|
Full Usage:
RhinoScriptSyntax.RebuildCurve(curveId, degree, pointCount)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
degree : int
-
(int) New degree (must be greater than 0)
pointCount : int
-
(int) New point count, which must be bigger than degree
Returns: bool
(bool) True of False indicating success or failure.
|
Rebuilds a Curve to a given degree and control point count. For more information, see the Rhino help for the Rebuild command.
|
Full Usage:
RhinoScriptSyntax.RebuildSurface(objectId, ?degreeU, ?degreeV, ?pointcountU, ?pointcountV)
Parameters:
Guid
-
(Guid) The Surface's identifier
?degreeU : int
-
(int) Optional, default value: 3 degree of the Surface in the U directions
?degreeV : int
-
(int) Optional, default value: 3 degree of the Surface in the V directions
?pointcountU : int
-
(int) Optional, default value: 10* the Surface point count in U directions
?pointcountV : int
-
(int) Optional, default value: 10* the Surface point count in V directions
Returns: bool
(bool) True of False indicating success or failure.
|
Rebuilds a Surface to a given degree and control point count. For more information see the Rhino help file for the Rebuild command.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.Redraw()
|
Redraws all views. |
Full Usage:
RhinoScriptSyntax.RemoveCurveKnot(curve, parameter)
Parameters:
Guid
-
(Guid) The reference of the source object
parameter : float
-
(float) The parameter on the Curve. Note, if the parameter is not equal to one
of the existing knots, then the knot closest to the specified parameter
will be removed
Returns: bool
(bool) True of False indicating success or failure.
|
Deletes a knot from a Curve object.
|
Full Usage:
RhinoScriptSyntax.RemoveObjectFromAllGroups(objectId)
Parameters:
Guid
-
(Guid) The object identifier
Returns: bool
(bool) True or False indicating success or failure.
|
Removes a single object from any and all groups that it is a member. Neither the object nor the group can be reference objects.
|
Full Usage:
RhinoScriptSyntax.RemoveObjectFromGroup(objectId, groupName)
Parameters:
Guid
-
(Guid) The object identifier
groupName : string
-
(string) The name of an existing group
|
Remove a single object from an existing group.
|
Full Usage:
RhinoScriptSyntax.RemoveObjectsFromGroup(objectIds, groupName)
Parameters:
Guid seq
-
(Guid seq) A list of object identifiers
groupName : string
-
(string) The name of an existing group
|
Removes multiple objects from an existing group.
|
Full Usage:
RhinoScriptSyntax.RemoveSurfaceKnot(surface, uvParameter, vDirection)
Parameters:
Guid
-
(Guid) The reference of the Surface object
uvParameter : float * float
-
(float * float)) An indexable item containing a U, V parameter on the Surface. List, tuples and UVIntervals will work.
Note, if the parameter is not equal to one of the existing knots, then the knot closest to the specified parameter will be removed
vDirection : bool
-
(bool) If True, or 1, the V direction will be addressed. If False, or 0, the U direction
Returns: bool
(bool) True of False indicating success or failure.
|
Deletes a knot from a Surface object.
|
Full Usage:
RhinoScriptSyntax.RenameBlock(blockName, newName)
Parameters:
string
-
(string) Name of an existing block definition
newName : string
-
(string) Name to change to
Returns: bool
(bool) True or False indicating success or failure.
|
Renames an existing block definition.
|
Full Usage:
RhinoScriptSyntax.RenameDimStyle(oldStyle, newStyle)
Parameters:
string
-
(string) The name of an existing dimension style
newStyle : string
-
(string) The new dimension style name
|
Renames an existing dimension style.
|
Full Usage:
RhinoScriptSyntax.RenameGroup(oldName, newName)
Parameters:
string
-
(string) The name of an existing group
newName : string
-
(string) The new group name
|
Renames an existing group.
|
Full Usage:
RhinoScriptSyntax.RenameLayer(oldName, newName)
Parameters:
string
-
(string) Original layer name
newName : string
-
(string) New layer name
|
Renames an existing layer.
|
Full Usage:
RhinoScriptSyntax.RenameView(oldTitle, newTitle)
Parameters:
string
-
(string) The title of the view to rename
newTitle : string
-
(string) The new title of the view
|
Changes the title of the specified view.
|
Full Usage:
RhinoScriptSyntax.RenderAntialias(style)
Parameters:
int
-
(int) Level of antialiasing (0 = none, 1 = normal, 2 = best)
|
Sets render antialiasing style.
|
Full Usage:
RhinoScriptSyntax.RenderAntialias()
Returns: int
(int) The current antialiasing style (0 = none, 1 = normal, 2 = best).
|
Returns render antialiasing style.
|
Full Usage:
RhinoScriptSyntax.RenderColor(item, color)
Parameters:
int
-
(int)
0 = ambient light color,
1 = background color
color : Color
-
(Drawing.Color) The new color value
|
Sets the render ambient light or background color.
|
Full Usage:
RhinoScriptSyntax.RenderColor(item)
Parameters:
int
-
(int)
0 = ambient light color,
1 = background color
Returns: Color
(Drawing.Color) The current item color.
|
Returns the render ambient light or background color.
|
Full Usage:
RhinoScriptSyntax.RenderMeshDensity(density)
Parameters:
float
-
(float) The new render Mesh density, which is a number between 0.0 and 1.0
|
Sets the render Mesh density property of the active document. For more information on render Meshes, see the Document Properties: Mesh topic in the Rhino help file.
|
Full Usage:
RhinoScriptSyntax.RenderMeshDensity()
Returns: float
(float) The current render Mesh density.
|
Returns the render Mesh density property of the active document. For more information on render Meshes, see the Document Properties: Mesh topic in the Rhino help file.
|
Full Usage:
RhinoScriptSyntax.RenderMeshMaxAngle(angleDegrees)
Parameters:
float
-
(float) The new maximum angle, which is a nonnegative number in degrees; 0 disables this constraint.
|
Sets the render Mesh maximum angle property of the active document. For more information on render Meshes, see the Document Properties: Mesh topic in the Rhino help file.
|
Full Usage:
RhinoScriptSyntax.RenderMeshMaxAngle()
Returns: float
(float) The current maximum angle in degrees.
|
Returns the render Mesh maximum angle in degrees of the active document. For more information on render Meshes, see the Document Properties: Mesh topic in the Rhino help file.
|
Full Usage:
RhinoScriptSyntax.RenderMeshMaxAspectRatio(ratio)
Parameters:
float
-
(float) The render Mesh maximum aspect ratio. The suggested range, when not zero, is from 1 to 100; 0 disables this constraint.
|
Sets the render Mesh maximum aspect ratio property of the active document. For more information on render Meshes, see the Document Properties: Mesh topic in the Rhino help file.
|
Full Usage:
RhinoScriptSyntax.RenderMeshMaxAspectRatio()
Returns: float
(float) The current render Mesh maximum aspect ratio.
|
Returns the render Mesh maximum aspect ratio property of the active document. For more information on render Meshes, see the Document Properties: Mesh topic in the Rhino help file.
|
Full Usage:
RhinoScriptSyntax.RenderMeshMaxDistEdgeToSrf(distance)
Parameters:
float
-
(float) The render Mesh maximum distance, edge to Surface; 0 disables this constraint.
|
Sets the render Mesh maximum distance, edge to Surface parameter of the active document. For more information on render Meshes, see the Document Properties: Mesh topic in the Rhino help file.
|
Full Usage:
RhinoScriptSyntax.RenderMeshMaxDistEdgeToSrf()
Returns: float
(float) The current render Mesh maximum distance, edge to Surface.
|
Returns the render Mesh maximum distance, edge to Surface parameter of the active document. For more information on render Meshes, see the Document Properties: Mesh topic in the Rhino help file.
|
Full Usage:
RhinoScriptSyntax.RenderMeshMaxEdgeLength(distance)
Parameters:
float
-
(float) The render Mesh maximum edge length; 0 disables this constraint.
|
Sets the render Mesh maximum edge length parameter of the active document. For more information on render Meshes, see the Document Properties: Mesh topic in the Rhino help file.
|
Full Usage:
RhinoScriptSyntax.RenderMeshMaxEdgeLength()
Returns: float
(float) The current render Mesh maximum edge length.
|
Returns the render Mesh maximum edge length parameter of the active document. For more information on render Meshes, see the Document Properties: Mesh topic in the Rhino help file.
|
Full Usage:
RhinoScriptSyntax.RenderMeshMinEdgeLength(distance)
Parameters:
float
-
(float) The render Mesh minimum edge length; 0 disables this constraint.
|
Sets the render Mesh minimum edge length parameter of the active document. For more information on render Meshes, see the Document Properties: Mesh topic in the Rhino help file.
|
Full Usage:
RhinoScriptSyntax.RenderMeshMinEdgeLength()
Returns: float
(float) The current render Mesh minimum edge length.
|
Returns the render Mesh minimum edge length parameter of the active document. For more information on render Meshes, see the Document Properties: Mesh topic in the Rhino help file.
|
Full Usage:
RhinoScriptSyntax.RenderMeshMinInitialGridQuads(quads)
Parameters:
int
-
(int) The render Mesh minimum initial grid quads. The suggested range is from 0 to 10000; 0 disables this constraint.
|
Sets the render Mesh minimum initial grid quads parameter of the active document. For more information on render Meshes, see the Document Properties: Mesh topic in the Rhino help file.
|
Full Usage:
RhinoScriptSyntax.RenderMeshMinInitialGridQuads()
Returns: int
(int) The current render Mesh minimum initial grid quads.
|
Returns the render Mesh minimum initial grid quads parameter of the active document. For more information on render Meshes, see the Document Properties: Mesh topic in the Rhino help file.
|
Full Usage:
RhinoScriptSyntax.RenderMeshQuality(quality)
Parameters:
int
-
(int) The render Mesh quality, either:
0: Jagged and faster. Objects may look jagged, but they should shade and render relatively quickly.
1: Smooth and slower. Objects should look smooth, but they may take a very long time to shade and render.
2: Custom
|
Sets the render Mesh quality of the active document. For more information on render Meshes, see the Document Properties: Mesh topic in the Rhino help file.
|
Full Usage:
RhinoScriptSyntax.RenderMeshQuality()
Returns: int
(int) The current render Mesh quality .
0: Jagged and faster. Objects may look jagged, but they should shade and render relatively quickly.
1: Smooth and slower. Objects should look smooth, but they may take a very long time to shade and render.
2: Custom.
|
Returns the render Mesh quality of the active document. For more information on render Meshes, see the Document Properties: Mesh topic in the Rhino help file.
|
Full Usage:
RhinoScriptSyntax.RenderMeshSettings(settings)
Parameters:
int
-
(int) The render Mesh settings, which is a bit-coded number that allows or disallows certain features.
The bits can be added together in any combination to form a value between 0 and 7. The bit values are as follows:
0: No settings enabled.
1: Refine Mesh enabled.
2: Jagged seams enabled.
4: Simple Planes enabled.
8: Texture is packed, scaled and normalized; otherwise unpacked, unscaled and normalized
|
Sets the render Mesh settings of the active document. For more information on render Meshes, see the Document Properties: Mesh topic in the Rhino help file.
|
Full Usage:
RhinoScriptSyntax.RenderMeshSettings()
Returns: int
(int) The current render Mesh settings .
0: No settings enabled.
1: Refine Mesh enabled.
2: Jagged seams enabled.
4: Simple Planes enabled.
8: Texture is packed, scaled and normalized; otherwise unpacked, unscaled and normalized.
|
Returns the render Mesh settings of the active document. For more information on render Meshes, see the Document Properties: Mesh topic in the Rhino help file.
|
Full Usage:
RhinoScriptSyntax.RenderResolution(width, height)
Parameters:
int
-
(int) width and height of render
height : int
-
(int) height of render
|
Sets the render resolution.
|
Full Usage:
RhinoScriptSyntax.RenderResolution()
Returns: int * int
(int * int) The current resolution width, height.
|
Returns the render resolution.
|
Full Usage:
RhinoScriptSyntax.RenderSettings(settings)
Parameters:
int
-
(int) Bit-coded flags of render settings to modify.
0 = none,
1 = create shadows,
2 = use lights on layers that are off,
4 = render Curves and iso-curves,
8 = render dimensions and text
|
Sets render settings.
|
Full Usage:
RhinoScriptSyntax.RenderSettings()
Returns: int
(int) if settings are not specified, the current render settings in bit-coded flags
0 = none,
1 = create shadows,
2 = use lights on layers that are off,
4 = render Curves and iso-curves,
8 = render dimensions and text.
|
Returns render settings.
|
Full Usage:
RhinoScriptSyntax.ReplaceBlockObjects(blockName, newObjects, ?deleteInput)
Parameters:
string
-
(string) Name of an existing block definition
newObjects : Guid seq
-
(Guid seq) Objects for replacing existing objects, can be partially the same as current objects too
?deleteInput : bool
-
(bool) Optional, default value: true. Delete the input objects from document, so that they only exist in the block definition.
Returns: bool
(bool) True or False indicating success or failure.
|
Replaces the objects inside an existing block definition.
|
Full Usage:
RhinoScriptSyntax.ResetMaterial(materialIndex)
Parameters:
int
-
(int) Zero based material index
Returns: bool
(bool) True or False indicating success or failure.
|
Resets a material to Rhino's default material.
|
Full Usage:
RhinoScriptSyntax.RestoreNamedCPlane(cplaneName, ?view)
Parameters:
string
-
(string) Name of the construction Plane to restore
?view : string
-
(string) Optional, The title of the view. If omitted, the current
active view is used
Returns: string
(string) name of the restored named construction Plane.
|
Restores a named construction Plane to the specified view.
|
Full Usage:
RhinoScriptSyntax.RestoreNamedView(namedView, ?view, ?restoreBitmap)
Parameters:
string
-
(string) Name of the named view to restore
?view : string
-
(string) Optional, Title of the view to restore the named view.
If omitted, the current active view is used
?restoreBitmap : bool
-
(bool) Optional, default value: false
Restore the named view's background bitmap
|
Restores a named view to the specified view.
|
Full Usage:
RhinoScriptSyntax.ReverseCurve(curveId)
Parameters:
Guid
-
(Guid) Identifier of the Curve object
Returns: bool
(bool) True or False indicating success or failure.
|
Reverses the direction of a Curve object. Same as Rhino's Dir command.
|
Full Usage:
RhinoScriptSyntax.ReverseSurface(surfaceId, direction)
Parameters:
Guid
-
(Guid) Identifier of a Surface object
direction : int
-
(int) As a bit coded flag to swap
1 = reverse U
2 = reverse V
4 = transpose U and V (values can be combined)
|
Reverses U or V directions of a Surface, or swaps (transposes) U and V directions.
|
Full Usage:
RhinoScriptSyntax.RotateCamera(direction, angleDegrees, ?view)
Parameters:
int
-
(int)
The direction to rotate the camera where
0 = right
1 = left
2 = down
3 = up
angleDegrees : float
-
(float) The angle to rotate in degrees
?view : string
-
(string) Optional, Title of the view. If omitted, current active view is used
|
Rotates a perspective-projection view's camera. See the RotateCamera command in the Rhino help file for more details.
|
Full Usage:
RhinoScriptSyntax.RotateObject(geometry, centerPoint, rotationAngleDegrees, ?axis)
Parameters:
GeometryBase
-
(GeometryBase) Input geometry to duplicate and transform.
centerPoint : Point3d
-
(Point3d) The center of rotation
rotationAngleDegrees : float
-
(float) In degrees
?axis : Vector3d
-
(Vector3d) Optional, default value: Vector3d.ZAxis
Axis of rotation, If omitted, the Vector3d.ZAxis is used as the rotation axis
Returns: GeometryBase
(GeometryBase) The transformed geometry duplicate.
|
Returns a transformed duplicate of the input geometry. The input is unchanged and the result is not added to a document.
|
Full Usage:
RhinoScriptSyntax.RotateObject(objectId, centerPoint, rotationAngleDegrees, ?axis, ?copy)
Parameters:
Guid
-
(Guid) The identifier of an object to rotate
centerPoint : Point3d
-
(Point3d) The center of rotation
rotationAngleDegrees : float
-
(float) In degrees
?axis : Vector3d
-
(Vector3d) Optional, default value: Vector3d.ZAxis
Axis of rotation, If omitted, the Vector3d.ZAxis is used as the rotation axis
?copy : bool
-
(bool) Optional, default value: false. Copy the object. Copies of grouped objects are put into new groups
Returns: Guid
(Guid) Identifier of the rotated object.
|
Rotates a single object. With copy=false the object in the document is transformed in place and keeps its Guid, with copy=true the original is left unchanged and a transformed copy is added to the document. The geometry overload returns a transformed duplicate instead and does not touch the document.
|
Full Usage:
RhinoScriptSyntax.RotateObjects(geometries, centerPoint, rotationAngleDegrees, ?axis)
Parameters:
GeometryBase seq
-
(GeometryBase seq) Input geometry to duplicate and transform.
centerPoint : Point3d
-
(Point3d) The center of rotation
rotationAngleDegrees : float
-
(float) In degrees
?axis : Vector3d
-
(Vector3d) Optional, default value: Vector3d.ZAxis
Axis of rotation, If omitted, the Vector3d.ZAxis is used as the rotation axis
Returns: ResizeArray<GeometryBase>
(GeometryBase ResizeArray) The transformed geometry duplicates.
|
Returns transformed duplicates of the input geometries. The input is unchanged and the result is not added to a document.
|
Full Usage:
RhinoScriptSyntax.RotateObjects(objectIds, centerPoint, rotationAngleDegrees, ?axis, ?copy)
Parameters:
Guid seq
-
(Guid seq) Identifiers of objects to rotate
centerPoint : Point3d
-
(Point3d) The center of rotation
rotationAngleDegrees : float
-
(float) In degrees
?axis : Vector3d
-
(Vector3d) Optional, default value: Vector3d.ZAxis
Axis of rotation, If omitted, the Vector3d.ZAxis is used as the rotation axis
?copy : bool
-
(bool) Optional, default value: false. Copy the object. Copies of grouped objects are put into new groups
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers of the rotated objects.
|
Rotates multiple objects. With copy=false the objects in the document are transformed in place and keep their Guids, with copy=true the originals are left unchanged and transformed copies are added to the document. The geometry overload returns transformed duplicates instead and does not touch the document.
|
|
|
Full Usage:
RhinoScriptSyntax.RotateView(direction, angleDegrees, ?view)
Parameters:
int
-
(int) Optional, The direction to rotate the view where
0 = right
1 = left
2 = down
3 = up
angleDegrees : float
-
(float) The angle to rotate in degrees.
?view : string
-
(string) Optional, Title of the view. If omitted, the current active view is used
|
Rotates a view. See RotateView command in Rhino help for more information.
|
Full Usage:
RhinoScriptSyntax.SaveFileName(?title, ?filter, ?folder, ?filename, ?extension)
Parameters:
string
-
(string) Optional, A dialog box title
?filter : string
-
(string) Optional, A filter string. The filter must be in the following form:
"Description1|Filter1|Description2|Filter2||", where "||" terminates filter string.
If omitted, the filter (*.*) is used
?folder : string
-
(string) Optional, A default folder
?filename : string
-
(string) Optional, A default file name
?extension : string
-
(string) Optional, A default file extension
Returns: string
(string) the file name is successful.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Display a save dialog box allowing the user to enter a file name. Note, this function does not save the file.
|
Full Usage:
RhinoScriptSyntax.SaveToolbarCollection(name)
Parameters:
string
-
(string) Name of a currently open toolbar file
Returns: bool
(bool) True or False indicating success or failure.
|
Saves an open toolbar collection to disk.
|
Full Usage:
RhinoScriptSyntax.SaveToolbarCollectionAs(name, file)
Parameters:
string
-
(string) Name of a currently open toolbar file
file : string
-
(string) Full path to file name to save to
Returns: bool
(bool) True or False indicating success or failure.
|
Saves an open toolbar collection to a different disk file.
|
Full Usage:
RhinoScriptSyntax.ScaleObject(geometry, origin, scale)
Parameters:
GeometryBase
-
(GeometryBase) Input geometry to duplicate and transform.
origin : Point3d
-
(Point3d) The origin of the scale transformation
scale : float
-
(float) One numbers that identify the X, Y, and Z axis scale factors to apply
Returns: GeometryBase
(GeometryBase) The transformed geometry duplicate.
|
Returns a transformed duplicate of the input geometry. The input is unchanged and the result is not added to a document.
|
Full Usage:
RhinoScriptSyntax.ScaleObject(objectId, origin, scale, ?copy)
Parameters:
Guid
-
(Guid) The identifier of an object
origin : Point3d
-
(Point3d) The origin of the scale transformation
scale : float
-
(float) One numbers that identify the X, Y, and Z axis scale factors to apply
?copy : bool
-
(bool) Optional, default value: false. Copy the object. Copies of grouped objects are put into new groups
Returns: Guid
(Guid) Identifier of the scaled object.
|
Scales a single object. Uniform scale transformation. Scaling is based on the WorldXY Plane. With copy=false the object in the document is transformed in place and keeps its Guid, with copy=true the original is left unchanged and a transformed copy is added to the document. The geometry overload returns a transformed duplicate instead and does not touch the document.
|
Full Usage:
RhinoScriptSyntax.ScaleObject(geometry, origin, scale)
Parameters:
GeometryBase
-
(GeometryBase) Input geometry to duplicate and transform.
origin : Point3d
-
(Point3d) The origin of the scale transformation
scale : float * float * float
-
(float*float*float) Three numbers that identify the X, Y, and Z axis scale factors to apply
Returns: GeometryBase
(GeometryBase) The transformed geometry duplicate.
|
Returns a transformed duplicate of the input geometry. The input is unchanged and the result is not added to a document.
|
Full Usage:
RhinoScriptSyntax.ScaleObject(objectId, origin, scale, ?copy)
Parameters:
Guid
-
(Guid) The identifier of an object
origin : Point3d
-
(Point3d) The origin of the scale transformation
scale : float * float * float
-
(float*float*float) Three numbers that identify the X, Y, and Z axis scale factors to apply
?copy : bool
-
(bool) Optional, default value: false. Copy the object. Copies of grouped objects are put into new groups
Returns: Guid
(Guid) Identifier of the scaled object.
|
Scales a single object. Can be used to perform a uniform or non-uniform scale transformation. Scaling is based on the WorldXY Plane. With copy=false the object in the document is transformed in place and keeps its Guid, with copy=true the original is left unchanged and a transformed copy is added to the document. The geometry overload returns a transformed duplicate instead and does not touch the document.
|
Full Usage:
RhinoScriptSyntax.ScaleObjects(geometries, origin, scale)
Parameters:
GeometryBase seq
-
(GeometryBase seq) Input geometry to duplicate and transform.
origin : Point3d
-
(Point3d) The origin of the scale transformation
scale : float
-
(float) One numbers that identify the X, Y, and Z axis scale factors to apply
Returns: ResizeArray<GeometryBase>
(GeometryBase ResizeArray) The transformed geometry duplicates.
|
Returns transformed duplicates of the input geometries. The input is unchanged and the result is not added to a document.
|
Full Usage:
RhinoScriptSyntax.ScaleObjects(objectIds, origin, scale, ?copy)
Parameters:
Guid seq
-
(Guid seq) Identifiers of objects to scale
origin : Point3d
-
(Point3d) The origin of the scale transformation
scale : float
-
(float) One numbers that identify the X, Y, and Z axis scale factors to apply
?copy : bool
-
(bool) Optional, default value: false
Copy the objects. Copies of grouped objects are put into new groups
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers of the scaled objects.
|
Scales one or more objects. Uniform scale transformation. Scaling is based on the WorldXY Plane. With copy=false the objects in the document are transformed in place and keep their Guids, with copy=true the originals are left unchanged and transformed copies are added to the document. The geometry overload returns transformed duplicates instead and does not touch the document.
|
Full Usage:
RhinoScriptSyntax.ScaleObjects(geometries, origin, scale)
Parameters:
GeometryBase seq
-
(GeometryBase seq) Input geometry to duplicate and transform.
origin : Point3d
-
(Point3d) The origin of the scale transformation
scale : float * float * float
-
(float*float*float) Three numbers that identify the X, Y, and Z axis scale factors to apply
Returns: ResizeArray<GeometryBase>
(GeometryBase ResizeArray) The transformed geometry duplicates.
|
Returns transformed duplicates of the input geometries. The input is unchanged and the result is not added to a document.
|
Full Usage:
RhinoScriptSyntax.ScaleObjects(objectIds, origin, scale, ?copy)
Parameters:
Guid seq
-
(Guid seq) Identifiers of objects to scale
origin : Point3d
-
(Point3d) The origin of the scale transformation
scale : float * float * float
-
(float*float*float) Three numbers that identify the X, Y, and Z axis scale factors to apply
?copy : bool
-
(bool) Optional, default value: false. Copy the objects. Copies of grouped objects are put into new groups
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers of the scaled objects.
|
Scales one or more objects. Can be used to perform a uniform or non- uniform scale transformation. Scaling is based on the WorldXY Plane. With copy=false the objects in the document are transformed in place and keep their Guids, with copy=true the originals are left unchanged and transformed copies are added to the document. The geometry overload returns transformed duplicates instead and does not touch the document.
|
Full Usage:
RhinoScriptSyntax.ScreenSize()
Returns: int * int
(int * int) containing two numbers identifying the width and height in pixels.
|
Returns current width and height, of the screen of the primary monitor.
|
Full Usage:
RhinoScriptSyntax.SdkVersion()
Returns: int
(int) The signed integer version reported by the executing Rhino SDK.
|
Returns version of the Rhino SDK supported by the executing Rhino.
|
Full Usage:
RhinoScriptSyntax.SearchPathCount()
Returns: int
(int) The number of path items in Rhino's search path list.
|
Returns the number of path items in Rhino's search path list. See "Options Files settings" in the Rhino help file for more details.
|
Full Usage:
RhinoScriptSyntax.SearchPathList()
Returns: string array
(string array) list of search paths.
|
Returns all of the path items in Rhino's search path list. See "Options Files settings" in the Rhino help file for more details.
|
Full Usage:
RhinoScriptSyntax.SelectObject(objectId, ?forceVisible, ?ignoreErrors)
Parameters:
Guid
-
(Guid) The identifier of the object to select
?forceVisible : bool
-
(bool) Optional, default value: false whether to make objects that a hidden or layers that are off visible and unlocked
?ignoreErrors : bool
-
(bool) Optional, default value: false whether to ignore errors when object can be set visible
|
Selects a single object. Throws an exception if object can't be selected for some reason e.g. when locked , hidden, or on invisible layer .
|
Full Usage:
RhinoScriptSyntax.SelectObjectGrip(objectId, index)
Parameters:
Guid
-
(Guid) Identifier of the object
index : int
-
(int) Index of the grip to select
Returns: bool
(bool) True or false indicating success or failure.
|
Selects a single grip owned by an object. If the object's grips are not turned on, the grip will not be selected.
|
Full Usage:
RhinoScriptSyntax.SelectObjectGrips(objectId)
Parameters:
Guid
-
(Guid) Identifier of the object
Returns: int
(int) Number of grips selected.
|
Selects an object's grips. If the object's grips are not turned on, they will not be selected.
|
Full Usage:
RhinoScriptSyntax.SelectObjects(objectIds, ?forceVisible, ?ignoreErrors)
Parameters:
Guid seq
-
(Guid seq) Identifiers of the objects to select
?forceVisible : bool
-
(bool) Optional, default value: false whether to make objects that a hidden or layers that are off visible and unlocked
?ignoreErrors : bool
-
(bool) Optional, default value: false whether to ignore errors when object can be set visible
|
Selects one or more objects Throws an exception if object can't be selected for some reason e.g. when locked , hidden, or on invisible layer .
|
Full Usage:
RhinoScriptSyntax.SelectedObjectGrips(objectId)
Parameters:
Guid
-
(Guid) Identifier of the object
Returns: ResizeArray<int>
(int ResizeArray) List of indices.
|
Returns a list of grip indices identifying an object's selected grips.
|
Full Usage:
RhinoScriptSyntax.SelectedObjects(?includeLights, ?includeGrips)
Parameters:
bool
-
(bool) Optional, default value: false
Include light objects
?includeGrips : bool
-
(bool) Optional, default value: false
Include grip objects
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers of selected objects.
|
Returns the identifiers of all objects that are currently selected.
|
Full Usage:
RhinoScriptSyntax.SendKeystrokes(?keys, ?addReturn)
Parameters:
string
-
(string) Optional, default value: "". Characters to send; omit to send only the optional return.
?addReturn : bool
-
(bool) Optional, default value: true
Append a return character to the end of the string.
If omitted a return character will be added (True)
|
Sends a string of printable characters to Rhino's Commandline.
|
Full Usage:
RhinoScriptSyntax.SetDocumentData(section, entry, value)
Parameters:
string
-
(string) The section name
entry : string
-
(string) The entry name
value : string
-
(string) The string value
|
Adds or sets a user data string to the current document.
|
Full Usage:
RhinoScriptSyntax.SetDocumentUserText(key, value, ?allowAllUnicode)
Parameters:
string
-
(string) Key name to set. Cannot be empty string.
value : string
-
(string) The string value to set. Can be empty string. To delete a key use rs.DeleteDocumentUserText
?allowAllUnicode : bool
-
(bool) Optional, default value: false , set to true to allow all Unicode characters,
(even the ones that look like ASCII characters but are not ASCII) in the value
|
Sets a user text stored in the document.
|
Full Usage:
RhinoScriptSyntax.SetUserText(objectIds, key, value, ?attachToGeometry, ?allowAllUnicode)
Parameters:
Guid seq
-
(Guid seq) The object identifiers
key : string
-
(string) The key name to set. Cannot be an empty string.
value : string
-
(string) The nonempty string value to set. Rhino treats empty values as deletion; use rs.DeleteUserText to delete keys
?attachToGeometry : bool
-
(bool) Optional, default value: false Location on the object to store the user text
?allowAllUnicode : bool
-
(bool) Optional, default value: false , set to true to allow Unicode characters,
(even the ones that look like ASCII characters but are not ASCII) in the value
|
Sets or removes user text stored on multiple objects. Key and value must not contain ambiguous Unicode characters.
|
Full Usage:
RhinoScriptSyntax.SetUserText(objectId, key, value, ?attachToGeometry, ?allowAllUnicode)
Parameters:
Guid
-
(Guid) The object's identifier
key : string
-
(string) The key name to set. Cannot be an empty string.
value : string
-
(string) The nonempty string value to set. Rhino treats empty values as deletion; use rs.DeleteUserText to delete keys
?attachToGeometry : bool
-
(bool) Optional, default value: false Location on the object to store the user text
?allowAllUnicode : bool
-
(bool) Optional, default value: false , set to true to allow all Unicode characters,
(even the ones that look like ASCII characters but are not ASCII) in the value
|
Sets a user text stored on an object. Key and value must not contain ambiguous Unicode characters.
|
Full Usage:
RhinoScriptSyntax.ShearObject(geometry, origin, referencePoint, angleDegrees)
Parameters:
GeometryBase
-
(GeometryBase) Input geometry to duplicate and transform.
origin : Point3d
-
(Point3d) Origin point of the shear transformation
referencePoint : Point3d
-
(Point3d) Reference point of the shear transformation
angleDegrees : float
-
(float) The shear angle in degrees
Returns: GeometryBase
(GeometryBase) The transformed geometry duplicate.
|
Returns a transformed duplicate of the input geometry. The input is unchanged and the result is not added to a document. Uses the active view construction plane.
|
Full Usage:
RhinoScriptSyntax.ShearObject(objectId, origin, referencePoint, angleDegrees, ?copy)
Parameters:
Guid
-
(Guid) The identifier of an object
origin : Point3d
-
(Point3d) Origin point of the shear transformation
referencePoint : Point3d
-
(Point3d) Reference point of the shear transformation
angleDegrees : float
-
(float) The shear angle in degrees
?copy : bool
-
(bool) Optional, default value: false
Copy the objects. Copies of grouped objects are put into new groups
Returns: Guid
(Guid) Identifier of the sheared object.
|
Perform a shear transformation on a single object. With copy=false the object in the document is transformed in place and keeps its Guid, with copy=true the original is left unchanged and a transformed copy is added to the document. The geometry overload returns a transformed duplicate instead and does not touch the document.
|
Full Usage:
RhinoScriptSyntax.ShearObjects(geometries, origin, referencePoint, angleDegrees)
Parameters:
GeometryBase seq
-
(GeometryBase seq) Input geometry to duplicate and transform.
origin : Point3d
-
(Point3d) Origin point of the shear transformation
referencePoint : Point3d
-
(Point3d) Reference point of the shear transformation
angleDegrees : float
-
(float) The shear angle in degrees
Returns: ResizeArray<GeometryBase>
(GeometryBase ResizeArray) The transformed geometry duplicates.
|
Returns transformed duplicates of the input geometries. The input is unchanged and the result is not added to a document. Uses the active view construction plane.
|
Full Usage:
RhinoScriptSyntax.ShearObjects(objectIds, origin, referencePoint, angleDegrees, ?copy)
Parameters:
Guid seq
-
(Guid seq) The identifiers objects to shear
origin : Point3d
-
(Point3d) Origin point of the shear transformation
referencePoint : Point3d
-
(Point3d) Reference point of the shear transformation
angleDegrees : float
-
(float) The shear angle in degrees
?copy : bool
-
(bool) Optional, default value: false
Copy the objects. Copies of grouped objects are put into new groups
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers of the sheared objects.
|
Shears one or more objects. With copy=false the objects in the document are transformed in place and keep their Guids, with copy=true the originals are left unchanged and transformed copies are added to the document. The geometry overload returns transformed duplicates instead and does not touch the document.
|
Full Usage:
RhinoScriptSyntax.ShootRay(surfaceGeos, startPoint, direction, ?reflections)
Parameters:
Brep seq
-
(Brep seq) One of more Surface objects
startPoint : Point3d
-
(Point3d) Starting point of the ray
direction : Vector3d
-
(Vector3d) Vector identifying the direction of the ray
?reflections : int
-
(int) Optional, default value: 10
The maximum number of times the ray will be reflected
Returns: Point3d array
(Point3d array) The start point, followed by the reflection points, like in RhinoPython.
An empty array if the ray hits nothing.
|
Shoots a ray at a collection of Surfaces or Polysurfaces. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.ShootRay(surfaceIds, startPoint, direction, ?reflections)
Parameters:
Guid seq
-
(Guid seq) One of more Surface identifiers
startPoint : Point3d
-
(Point3d) Starting point of the ray
direction : Vector3d
-
(Vector3d) Vector identifying the direction of the ray
?reflections : int
-
(int) Optional, default value: 10
The maximum number of times the ray will be reflected
Returns: Point3d array
(Point3d array) The start point, followed by the reflection points, like in RhinoPython.
An empty array if the ray hits nothing.
|
Shoots a ray at a collection of Surfaces or Polysurfaces.
|
Full Usage:
RhinoScriptSyntax.ShortPath(surfaceGeo, startPoint, endPoint)
Parameters:
Surface
-
(Surface) Object of a Surface
startPoint : Point3d
-
(Point3d) Start point the short Curve
endPoint : Point3d
-
(Point3d) End point of the short Curve
Returns: Curve
(Curve) Newly created geometry. The caller owns the returned objects.
|
Creates the shortest possible Curve(geodesic) between two points on a Surface. For more details, see the ShortPath command in Rhino help. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.ShortPath(surfaceId, startPoint, endPoint)
Parameters:
Guid
-
(Guid) Identifier of a Surface
startPoint : Point3d
-
(Point3d) Start point the short Curve
endPoint : Point3d
-
(Point3d) End point of the short Curve
Returns: Guid
(Guid) identifier of the new Surface.
|
Creates the shortest possible Curve(geodesic) between two points on a Surface. For more details, see the ShortPath command in Rhino help.
|
Full Usage:
RhinoScriptSyntax.ShowGrid(view, show)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
show : bool
-
(bool) The grid state to set
|
Shows or hides a view's construction Plane grid. When the view's display mode overrides the document's grid settings, the state of the display mode is set. This affects every view using this display mode.
|
Full Usage:
RhinoScriptSyntax.ShowGrid(view)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
Returns: bool
(bool) The grid display state.
|
Get status of a view's construction Plane grid. When the view's display mode overrides the document's grid settings, the state of the display mode is returned.
|
Full Usage:
RhinoScriptSyntax.ShowGridAxes(view, show)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
show : bool
-
(bool) The state to set
|
Shows or hides a view's construction Plane grid axes. When the view's display mode overrides the document's grid settings, the state of the display mode is set. This affects every view using this display mode.
|
Full Usage:
RhinoScriptSyntax.ShowGridAxes(view)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
Returns: bool
(bool) The grid axes display state.
|
Get status of a view's construction Plane grid axes. When the view's display mode overrides the document's grid settings, the state of the display mode is returned.
|
Full Usage:
RhinoScriptSyntax.ShowGroup(groupName)
Parameters:
string
-
(string) The name of an existing group
Returns: int
(int) The number of objects that were shown.
|
Shows a group of previously hidden objects. Hidden objects are not visible, cannot be snapped to, and cannot be selected.
|
Full Usage:
RhinoScriptSyntax.ShowLayer(layerName)
Parameters:
string
-
(string) full or short layer name
|
Expand all parent layers in UI if this layer is hidden by a collapsed parent layer.
|
Full Usage:
RhinoScriptSyntax.ShowObject(objectId)
Parameters:
Guid
-
(Guid) Representing id of object to show
|
Shows a previously hidden object. Hidden objects are not visible, cannot be snapped to and cannot be selected.
|
Full Usage:
RhinoScriptSyntax.ShowObjects(objectIds)
Parameters:
Guid seq
-
(Guid seq) Ids of objects to show.
|
Shows one or more objects. Hidden objects are not visible, cannot be snapped to and cannot be selected.
|
Full Usage:
RhinoScriptSyntax.ShowViewTitle(view, show)
Parameters:
string
-
(string) Title of the view. If omitted, the current active view is used
show : bool
-
(bool) The state to set
|
Shows or hides the title window of a view.
|
Full Usage:
RhinoScriptSyntax.ShowViewTitle(view)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
Returns: bool
(bool) The state to View Title visibility.
|
Get status of the title window of a view.
|
Full Usage:
RhinoScriptSyntax.ShowWorldAxes(view, show)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
show : bool
-
(bool) The state to set
|
Shows or hides a view's world axis icon. When the view's display mode overrides the document's grid settings, the state of the display mode is set. This affects every view using this display mode.
|
Full Usage:
RhinoScriptSyntax.ShowWorldAxes(view)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
Returns: bool
(bool) The world axes display state.
|
Get status of a view's world axis icon. When the view's display mode overrides the document's grid settings, the state of the display mode is returned.
|
|
Shrinks the underlying untrimmed Surfaces near to the trimming boundaries. See the ShrinkTrimmedSrf command in the Rhino help. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.ShrinkTrimmedSurface(objectId, ?createCopy)
Parameters:
Guid
-
(Guid) The Surface's identifier
?createCopy : bool
-
(bool) Optional, default value: false
If True, the shrunk Surface is added as a new object and the original Surface is kept.
The new object's identifier is not returned, use LastCreatedObjects to find it.
Returns: bool
(bool) True if the Surface was shrunk (in place, or as a new copy).
False if there was nothing to shrink, then the document is not changed, like in RhinoPython.
|
Shrinks the underlying untrimmed Surfaces near to the trimming boundaries. See the ShrinkTrimmedSrf command in the Rhino help.
|
Full Usage:
RhinoScriptSyntax.SimplifyArray(points)
Parameters:
Point3d seq
-
(Point3d seq) Points to flatten
Returns: ResizeArray<float>
(float ResizeArray) A one-dimensional list containing real numbers.
|
Flattens an array of 3-D points into a one-dimensional list of real numbers. For example, if you had an array containing three 3-D points, this method would return a one-dimensional array containing nine real numbers.
|
Full Usage:
RhinoScriptSyntax.SimplifyCurve(curveId, ?flags)
Parameters:
Guid
-
(Guid) The object's identifier
?flags : int
-
(int) Optional, default value: 0
The simplification methods to use. By default, all methods are used (flags = 0)
Value Description
0 Use all methods.
1 Do not split NURBS Curves at fully multiple knots.
2 Do not replace segments with IsCurveLinear = True with line Curves.
4 Do not replace segments with IsArc = True with arc Curves.
8 Do not replace rational NURBS Curves with constant denominator with an equivalent non-rational NURBS Curve.
16 Do not adjust Curves at G1-joins.
32 Do not merge adjacent co-linear lines or co-circular arcs or combine consecutive line segments into a polyline
Returns: bool
(bool) True or False.
|
Replace a Curve with a geometrically equivalent PolyCurve. The PolyCurve will have the following properties: - All the PolyCurve segments are lines, polylines, arcs, or NURBS Curves. - The NURBS Curves segments do not have fully multiple interior knots. - Rational NURBS Curves do not have constant weights. - Any segment for which IsCurveLinear or IsArc is True: a line, Polyline segment, or an arc. - Adjacent co-linear or co-circular segments are combined. - Segments that meet with G1-continuity have there ends tuned up so that they meet with G1-continuity to within machine precision. - If the PolyCurve is a polyline, a Polyline will be created.
|
Full Usage:
RhinoScriptSyntax.Sleep(milliseconds)
Parameters:
int
-
(int) Thousands of a second
|
Suspends execution of a running script for the specified interval. Then refreshes Rhino UI.
|
Full Usage:
RhinoScriptSyntax.Snap(enable)
Parameters:
bool
-
(bool) The new enabled status.
|
Enables or disables Rhino's grid snap modeling aid.
|
Full Usage:
RhinoScriptSyntax.Snap()
Returns: bool
(bool) The current grid snap status.
|
Get status of Rhino's grid snap modeling aid.
|
Full Usage:
RhinoScriptSyntax.SortPointList(points, ?tolerance)
Parameters:
Point3d seq
-
(Point3d seq) The points to sort
?tolerance : float
-
(float) Optional, default value: RhinoMath.ZeroTolerance
Minimum distance between points. Points that fall within this tolerance
will be discarded.
Returns: Point3d array
(Point3d array) Array of sorted 3D points.
|
Sorts list of points so they will be connected in a "reasonable" Polyline order.
|
Full Usage:
RhinoScriptSyntax.SortPoints(points, ?ascending, ?order)
Parameters:
Point3d seq
-
(Point3d seq) Points to sort
?ascending : bool
-
(bool) Optional, default value: true
Ascending if omitted (True) or True, descending if False
?order : int
-
(int) Optional, default value: 0
The component sort order
Value Component Sort Order
0 (default) X, Y, Z
1 X, Z, Y
2 Y, X, Z
3 Y, Z, X
4 Z, X, Y
5 Z, Y, X
Returns: Point3d seq
(Point3d seq) sorted 3-D points.
|
Sorts the components of an array of 3D points.
|
|
|
Full Usage:
RhinoScriptSyntax.SplitBrep(brepId, cutterId, ?deleteInput)
Parameters:
Guid
-
(Guid) Identifier of the brep to split
cutterId : Guid
-
(Guid) Identifier of the brep to split with
?deleteInput : bool
-
(bool) Optional, default value: false
Delete input breps
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers of split pieces.
|
|
Full Usage:
RhinoScriptSyntax.SplitCurve(curveGeo, parameter)
Parameters:
Curve
-
(Curve) The input curve geometry.
parameter : float seq
-
(float seq) One or more parameters to split the Curve at
Returns: ResizeArray<Curve>
(Curve ResizeArray) The resulting curves, without adding them to the document.
|
Computes SplitCurve from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.SplitCurve(curveId, parameter, ?deleteInput)
Parameters:
Guid
-
(Guid) The Curve to split
parameter : float seq
-
(float seq) One or more parameters to split the Curve at
?deleteInput : bool
-
(bool) Optional, default value: true
Delete the input Curve
Returns: ResizeArray<Guid>
(Guid ResizeArray) list of new Curves.
|
Splits, or divides, a Curve at a specified parameter. The parameter must be in the interior of the Curve's domain.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.SpotLightHardness(geometryObject)
Parameters:
Light
-
(Light) The light geometry to use.
Returns: float
(float) The current hardness.
|
Returns the hardness of a spot light. Spotlight hardness controls the fully illuminated region.
|
Full Usage:
RhinoScriptSyntax.SpotLightHardness(objectIds, hardness)
Parameters:
Guid seq
-
(Guid seq) The light objects's identifiers
hardness : float
-
(float) The light's new hardness
|
Changes the hardness of multiple spot lights. Spotlight hardness controls the fully illuminated region.
|
Full Usage:
RhinoScriptSyntax.SpotLightHardness(objectId, hardness)
Parameters:
Guid
-
(Guid) The light object's identifier
hardness : float
-
(float) The light's new hardness
|
Changes the hardness of a spot light. Spotlight hardness controls the fully illuminated region.
|
Full Usage:
RhinoScriptSyntax.SpotLightHardness(objectId)
Parameters:
Guid
-
(Guid) The light object's identifier
Returns: float
(float) The current hardness.
|
Returns the hardness of a spot light. Spotlight hardness controls the fully illuminated region.
|
Full Usage:
RhinoScriptSyntax.SpotLightRadius(geometryObject)
Parameters:
Light
-
(Light) The light geometry to use.
Returns: float
(float) The current radius.
|
Returns the radius of a spot light.
|
Full Usage:
RhinoScriptSyntax.SpotLightRadius(objectIds, radius)
Parameters:
Guid seq
-
(Guid seq) The light objects's identifiers
radius : float
-
(float) The light's new radius
|
Changes the radius of multiple spot lights.
|
Full Usage:
RhinoScriptSyntax.SpotLightRadius(objectId, radius)
Parameters:
Guid
-
(Guid) The light object's identifier
radius : float
-
(float) The light's new radius
|
Changes the radius of a spot light.
|
Full Usage:
RhinoScriptSyntax.SpotLightRadius(objectId)
Parameters:
Guid
-
(Guid) The light object's identifier
Returns: float
(float) The current radius.
|
Returns the radius of a spot light.
|
Full Usage:
RhinoScriptSyntax.SpotLightShadowIntensity(geometryObject)
Parameters:
Light
-
(Light) The light geometry to use.
Returns: float
(float) The current intensity.
|
Returns the shadow intensity of a spot light.
|
Full Usage:
RhinoScriptSyntax.SpotLightShadowIntensity(objectIds, intensity)
Parameters:
Guid seq
-
(Guid seq) The light objects's identifiers
intensity : float
-
(float) The light's new intensity
|
Changes the shadow intensity of multiple spot lights.
|
Full Usage:
RhinoScriptSyntax.SpotLightShadowIntensity(objectId, intensity)
Parameters:
Guid
-
(Guid) The light object's identifier
intensity : float
-
(float) The light's new intensity
|
Changes the shadow intensity of a spot light.
|
Full Usage:
RhinoScriptSyntax.SpotLightShadowIntensity(objectId)
Parameters:
Guid
-
(Guid) The light object's identifier
Returns: float
(float) The current intensity.
|
Returns the shadow intensity of a spot light.
|
Full Usage:
RhinoScriptSyntax.StatusBarDistance(?distance)
Parameters:
float
-
(float) Optional, default value: 0.0. The distance to display.
|
Sets Rhino's status bar distance pane.
|
Full Usage:
RhinoScriptSyntax.StatusBarMessage(?message)
Parameters:
string
-
(string) Optional, default value: "". The message; omit to clear it.
|
Sets Rhino's status bar message pane.
|
Full Usage:
RhinoScriptSyntax.StatusBarPoint(?point)
Parameters:
Point3d
-
(Point3d) Optional, default value: Point3d.Origin. The coordinates to display.
|
Sets Rhino's status bar point coordinate pane.
|
Full Usage:
RhinoScriptSyntax.StatusBarProgressMeterHide()
|
Hide the progress meter. |
Full Usage:
RhinoScriptSyntax.StatusBarProgressMeterShow(label, lower, upper, ?embedLabel, ?showPercent)
Parameters:
string
-
(string) Short description of the progesss
lower : int
-
(int) Lower limit of the progress meter's range
upper : int
-
(int) Upper limit of the progress meter's range
?embedLabel : bool
-
(bool) Optional, default value: true
If true, the label will show inside the meter.
If false, the label will show to the left of the meter
?showPercent : bool
-
(bool) Optional, default value: true
Show the percent complete if True
Returns: bool
(bool) True or False indicating success or failure.
|
Start the Rhino status bar progress meter.
|
Full Usage:
RhinoScriptSyntax.StatusBarProgressMeterUpdate(position, ?absolute)
Parameters:
int
-
(int) The new position in the progress meter
?absolute : bool
-
(bool) Optional, default value: true
The position is set absolute (True) or relative (False) to its current position. If omitted the absolute (True) is used
|
Set the current position of the progress meter.
|
|
A Dictionary to store state between scripting session. Use RhinoScriptSyntax.Sticky.Clear() to reset it. Similar to scriptingcontext.sticky dictionary in Rhino Python.
|
Full Usage:
RhinoScriptSyntax.Str2Pt(point)
Parameters:
string
-
(string) A string that contains a delimited point like "1, 2, 3"
Returns: Point3d
(Point3d) Point structure from the input string.
|
convert a formatted string value into a 3D point value.
|
Full Usage:
RhinoScriptSyntax.StringBox(?message, ?defaultValValue, ?title)
Parameters:
string
-
(string) Optional, A prompt message
?defaultValValue : string
-
(string) Optional, A default string value
?title : string
-
(string) Optional, A dialog box title
Returns: string
(string) the newly entered string value.
A RhinoUserInteractionException is raised if input is cancelled via Esc Key.
|
Display a dialog box prompting the user to enter a string value.
|
Full Usage:
RhinoScriptSyntax.SurfaceArea(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The Surface
Returns: float
(float) of area.
|
Calculate the area of a Surface or Polysurface object. The results are based on the current drawing units. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.SurfaceArea(objectId)
Parameters:
Guid
-
(Guid) The Surface's identifier
Returns: float
(float) of area.
|
Calculate the area of a Surface or Polysurface object. The results are based on the current drawing units.
|
Full Usage:
RhinoScriptSyntax.SurfaceArea(brep)
Parameters:
Brep
-
(Geometry.Brep) The Polysurface geometry
Returns: float
(float) of area.
|
Calculate the area of a Brep / Polysurface Geometry. The results are based on the current drawing units.
|
Full Usage:
RhinoScriptSyntax.SurfaceArea(srf)
Parameters:
Surface
-
(Geometry.Surface) The Surface geometry
Returns: float
(float) of area.
|
Calculate the area of a Surface Geometry. The results are based on the current drawing units.
|
Full Usage:
RhinoScriptSyntax.SurfaceAreaCentroid(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The Surface
Returns: Point3d
(Point3d ) Area centroid.
|
Calculates the area centroid of a Surface or Polysurface. Uses the supplied objects directly.
|
|
|
Full Usage:
RhinoScriptSyntax.SurfaceAreaMoments(surfaceGeo)
Parameters:
GeometryBase
-
(GeometryBase) The Surface
Returns: ResizeArray<float * float * float>
((float*float*float) ResizeArray ) of moments and error bounds in tuples(X, Y, Z) - see help topic
Index Description
[0] First Moments.
[1] The absolute (+/-) error bound for the First Moments.
[2] Second Moments.
[3] The absolute (+/-) error bound for the Second Moments.
[4] Product Moments.
[5] The absolute (+/-) error bound for the Product Moments.
[6] Area Moments of Inertia about the World Coordinate Axes.
[7] The absolute (+/-) error bound for the Area Moments of Inertia about World Coordinate Axes.
[8] Area Radii of Gyration about the World Coordinate Axes.
[9] (Not implemented yet) The absolute (+/-) error bound for the Area Radii of Gyration about World Coordinate Axes.
[10] Area Moments of Inertia about the Centroid Coordinate Axes.
[11] The absolute (+/-) error bound for the Area Moments of Inertia about the Centroid Coordinate Axes.
[12] Area Radii of Gyration about the Centroid Coordinate Axes.
[13] (Not implemented yet) The absolute (+/-) error bound for the Area Radii of Gyration about the Centroid Coordinate Axes.
|
Calculates area moments of inertia of a Surface or Polysurface object. Returns 14 tuples: seven values, each followed by its error bound. See the Rhino help for "Mass Properties calculation details". Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.SurfaceAreaMoments(surfaceId)
Parameters:
Guid
-
(Guid) The Surface's identifier
Returns: ResizeArray<float * float * float>
((float*float*float) ResizeArray ) of moments and error bounds in tuples(X, Y, Z) - see help topic
Index Description
[0] First Moments.
[1] The absolute (+/-) error bound for the First Moments.
[2] Second Moments.
[3] The absolute (+/-) error bound for the Second Moments.
[4] Product Moments.
[5] The absolute (+/-) error bound for the Product Moments.
[6] Area Moments of Inertia about the World Coordinate Axes.
[7] The absolute (+/-) error bound for the Area Moments of Inertia about World Coordinate Axes.
[8] Area Radii of Gyration about the World Coordinate Axes.
[9] (Not implemented yet) The absolute (+/-) error bound for the Area Radii of Gyration about World Coordinate Axes.
[10] Area Moments of Inertia about the Centroid Coordinate Axes.
[11] The absolute (+/-) error bound for the Area Moments of Inertia about the Centroid Coordinate Axes.
[12] Area Radii of Gyration about the Centroid Coordinate Axes.
[13] (Not implemented yet) The absolute (+/-) error bound for the Area Radii of Gyration about the Centroid Coordinate Axes.
|
Calculates area moments of inertia of a Surface or Polysurface object. Returns 14 tuples: seven values, each followed by its error bound. See the Rhino help for "Mass Properties calculation details".
|
Returns U, V parameters of point on a Surface that is closest to a test point. Uses the supplied objects directly.
|
|
|
|
Full Usage:
RhinoScriptSyntax.SurfaceCone(surfaceGeo)
Parameters:
Surface
-
(Surface) The Surface
Returns: Plane * float * float
(Plane * float * float) containing the definition of the cone
[0] the Plane of the cone. The apex of the cone is at the
Plane's origin and the axis of the cone is the Plane's z-axis
[1] the height of the cone
[2] the radius of the cone.
|
Returns the definition of a Surface cone. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.SurfaceCone(surfaceId)
Parameters:
Guid
-
(Guid) The Surface's identifier
Returns: Plane * float * float
(Plane * float * float) containing the definition of the cone
[0] the Plane of the cone. The apex of the cone is at the
Plane's origin and the axis of the cone is the Plane's z-axis
[1] the height of the cone
[2] the radius of the cone.
|
Returns the definition of a Surface cone.
|
Full Usage:
RhinoScriptSyntax.SurfaceCurvature(surfaceGeo, parameter)
Parameters:
Surface
-
(Surface) The Surface
parameter : float * float
-
(float * float) U, v parameter
Returns: Point3d * Vector3d * float * Vector3d * float * Vector3d * float * float
(Point3d * Vector3d * float * Vector3d * float * Vector3d * float * float) of curvature information
[0] point at specified U, V parameter
[1] normal direction
[2] maximum principal curvature
[3] maximum principal curvature direction
[4] minimum principal curvature
[5] minimum principal curvature direction
[6] gaussian curvature
[7] mean curvature.
|
Returns the curvature of a Surface at a U, V parameter. See Rhino help for details of Surface curvature. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.SurfaceCurvature(surfaceId, parameter)
Parameters:
Guid
-
(Guid) The Surface's identifier
parameter : float * float
-
(float * float) U, v parameter
Returns: Point3d * Vector3d * float * Vector3d * float * Vector3d * float * float
(Point3d * Vector3d * float * Vector3d * float * Vector3d * float * float) of curvature information
[0] point at specified U, V parameter
[1] normal direction
[2] maximum principal curvature
[3] maximum principal curvature direction
[4] minimum principal curvature
[5] minimum principal curvature direction
[6] gaussian curvature
[7] mean curvature.
|
Returns the curvature of a Surface at a U, V parameter. See Rhino help for details of Surface curvature.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.SurfaceDegree(surfaceGeo)
Parameters:
Surface
-
(Surface) The Surface
Returns: int * int
(int*int) The degree in U and V direction.
|
Returns the U and V degrees of a Surface. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.SurfaceDegree(surfaceId)
Parameters:
Guid
-
(Guid) The Surface's identifier
Returns: int * int
(int*int) The degree in U and V direction.
|
Returns the U and V degrees of a Surface.
|
Full Usage:
RhinoScriptSyntax.SurfaceDomain(surfaceGeo, direction)
Parameters:
Surface
-
(Surface) The Surface
direction : int
-
(int) Domain direction 0 = U, or 1 = V
Returns: float * float
(float * float) containing the domain interval in the specified direction.
|
Returns the domain of a Surface object in the specified direction. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.SurfaceDomain(surfaceId, direction)
Parameters:
Guid
-
(Guid) The Surface's identifier
direction : int
-
(int) Domain direction 0 = U, or 1 = V
Returns: float * float
(float * float) containing the domain interval in the specified direction.
|
Returns the domain of a Surface object in the specified direction.
|
Full Usage:
RhinoScriptSyntax.SurfaceEditPointParameters(surfaceGeo, ?returnAll)
Parameters:
Surface
-
(Surface) The Surface
?returnAll : bool
-
(bool) Optional, default value: true
If True, all Surface edit points are returned. If False,
the function will return Surface edit points based on whether or not the
Surface is closed or periodic
Returns: ResizeArray<float * float>
((float*float) ResizeArray) a list of U and V parameters.
|
Returns the parameters at edit, or Greville points of a Surface object. For each Surface control point, there is a corresponding edit point. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.SurfaceEditPointParameters(surfaceId, ?returnAll)
Parameters:
Guid
-
(Guid) The Surface's identifier
?returnAll : bool
-
(bool) Optional, default value: true
If True, all Surface edit points are returned. If False,
the function will return Surface edit points based on whether or not the
Surface is closed or periodic
Returns: ResizeArray<float * float>
((float*float) ResizeArray) a list of U and V parameters.
|
Returns the parameters at edit, or Greville points of a Surface object. For each Surface control point, there is a corresponding edit point.
|
Full Usage:
RhinoScriptSyntax.SurfaceEditPoints(surfaceGeo, ?returnAll)
Parameters:
Surface
-
(Surface) The Surface
?returnAll : bool
-
(bool) Optional, default value: true
If True, all Surface edit points are returned. If False,
the function will return Surface edit points based on whether or not the
Surface is closed or periodic
Returns: ResizeArray<Point3d>
(Point3d ResizeArray) a list of 3D points.
|
Returns the edit, or Greville points of a Surface object. For each Surface control point, there is a corresponding edit point. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.SurfaceEditPoints(surfaceId, ?returnAll)
Parameters:
Guid
-
(Guid) The Surface's identifier
?returnAll : bool
-
(bool) Optional, default value: true
If True, all Surface edit points are returned. If False,
the function will return Surface edit points based on whether or not the
Surface is closed or periodic
Returns: ResizeArray<Point3d>
(Point3d ResizeArray) a list of 3D points.
|
Returns the edit, or Greville points of a Surface object. For each Surface control point, there is a corresponding edit point.
|
Full Usage:
RhinoScriptSyntax.SurfaceEvaluate(surfaceGeo, parameter, derivative)
Parameters:
Surface
-
(Surface) The Surface
parameter : float * float
-
(float * float) U, v parameter to evaluate
derivative : int
-
(int) Number of derivatives to evaluate
Returns: Point3d * ResizeArray<Vector3d>
(Point3d * Vector3d ResizeArray) list length (derivative + 1)*(derivative + 2)/2
Elements of tuple:
[fst] The 3-D point.
[snd] List of Vectors:
[0] The first derivative.
[1] The first derivative.
[2] The second derivative.
[3] The second derivative.
[4] The second derivative.
[5] etc...
|
A general purpose Surface evaluator. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.SurfaceEvaluate(surfaceId, parameter, derivative)
Parameters:
Guid
-
(Guid) The Surface's identifier
parameter : float * float
-
(float * float) U, v parameter to evaluate
derivative : int
-
(int) Number of derivatives to evaluate
Returns: Point3d * ResizeArray<Vector3d>
(Point3d * Vector3d ResizeArray) list length (derivative + 1)*(derivative + 2)/2
Elements of tuple:
[fst] The 3-D point.
[snd] List of Vectors:
[0] The first derivative.
[1] The first derivative.
[2] The second derivative.
[3] The second derivative.
[4] The second derivative.
[5] etc...
|
A general purpose Surface evaluator.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.SurfaceIsocurveDensity(surfaceIds, density)
Parameters:
Guid seq
-
(Guid seq) The Surface's identifiers
density : int
-
(int) The isocurve wireframe density. The possible values are
-1: Hides the Surface isocurves
0: Display boundary and knot wires
1: Display boundary and knot wires and one interior wire if there are no interior knots
bigger than 1: Display boundary and knot wires and (N + 1) interior wires
|
Sets the isocurve density of multiple Surface or Polysurface objects. An isoparametric Curve is a Curve of constant U or V value on a Surface. Rhino uses isocurves and Surface edge Curves to visualize the shape of a NURBS Surface.
|
Full Usage:
RhinoScriptSyntax.SurfaceIsocurveDensity(surfaceId, density)
Parameters:
Guid
-
(Guid) The Surface's identifier
density : int
-
(int) The isocurve wireframe density. The possible values are
-1: Hides the Surface isocurves
0: Display boundary and knot wires
1: Display boundary and knot wires and one interior wire if there are no interior knots
bigger than 1: Display boundary and knot wires and (N + 1) interior wires
|
Sets the isocurve density of a Surface or Polysurface object. An isoparametric Curve is a Curve of constant U or V value on a Surface. Rhino uses isocurves and Surface edge Curves to visualize the shape of a NURBS Surface.
|
Full Usage:
RhinoScriptSyntax.SurfaceIsocurveDensity(surfaceId)
Parameters:
Guid
-
(Guid) The Surface's identifier
Returns: int
(int) The current isocurve density
-1: Hides the Surface isocurves
0: Display boundary and knot wires
1: Display boundary and knot wires and one interior wire if there are no interior knots
bigger than 1: Display boundary and knot wires and (N + 1) interior wires.
|
Returns the isocurve density of a Surface or Polysurface object. An isoparametric Curve is a Curve of constant U or V value on a Surface. Rhino uses isocurves and Surface edge Curves to visualize the shape of a NURBS Surface.
|
Full Usage:
RhinoScriptSyntax.SurfaceKnotCount(surfaceGeo)
Parameters:
Surface
-
(Surface) The Surface object
Returns: int * int
(int * int) a list containing (U count, V count).
|
Returns the knot count of a Surface SurfaceId = the Surface's identifier. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.SurfaceKnotCount(surfaceId)
Parameters:
Guid
-
(Guid) The Surface object's identifier
Returns: int * int
(int * int) a list containing (U count, V count).
|
Returns the knot count of a Surface SurfaceId = the Surface's identifier.
|
Full Usage:
RhinoScriptSyntax.SurfaceKnots(surfaceGeo)
Parameters:
Surface
-
(Surface) The Surface
Returns: NurbsSurfaceKnotList * NurbsSurfaceKnotList
(NurbsSurfaceKnotList * NurbsSurfaceKnotList) knot values of the Surface.
The list will contain the following information:
Element Description
[0] Knot vectors in U direction
[1] Knot vectors in V direction.
|
Returns the knots, or knot vector, of a Surface object. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.SurfaceKnots(surfaceId)
Parameters:
Guid
-
(Guid) The Surface's identifier
Returns: NurbsSurfaceKnotList * NurbsSurfaceKnotList
(NurbsSurfaceKnotList * NurbsSurfaceKnotList) knot values of the Surface.
The list will contain the following information:
Element Description
[0] Knot vectors in U direction
[1] Knot vectors in V direction.
|
Returns the knots, or knot vector, of a Surface object.
|
|
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.SurfaceNormalizedParameter(surfaceGeo, parameter)
Parameters:
Surface
-
(Surface) The Surface
parameter : float * float
-
(float * float) The Surface parameter to convert
Returns: float * float
(float * float) normalized Surface parameter.
|
Converts Surface parameter to a normalized Surface parameter; one that ranges between 0.0 and 1.0 in both the U and V directions. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.SurfaceNormalizedParameter(surfaceId, parameter)
Parameters:
Guid
-
(Guid) The Surface's identifier
parameter : float * float
-
(float * float) The Surface parameter to convert
Returns: float * float
(float * float) normalized Surface parameter.
|
Converts Surface parameter to a normalized Surface parameter; one that ranges between 0.0 and 1.0 in both the U and V directions.
|
Full Usage:
RhinoScriptSyntax.SurfaceParameter(surfaceGeo, parameter)
Parameters:
Surface
-
(Surface) The Surface
parameter : float * float
-
(float * float) The normalized parameter to convert
Returns: float * float
(float * float) u and v Surface parameters.
|
Converts normalized Surface parameter to a Surface domain specific (regular) parameter. or a parameter within the Surface's domain. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.SurfaceParameter(surfaceId, parameter)
Parameters:
Guid
-
(Guid) The Surface's identifier
parameter : float * float
-
(float * float) The normalized parameter to convert
Returns: float * float
(float * float) u and v Surface parameters.
|
Converts normalized Surface parameter to a Surface domain specific (regular) parameter. or a parameter within the Surface's domain.
|
Full Usage:
RhinoScriptSyntax.SurfacePointCount(surfaceGeo)
Parameters:
Surface
-
(Surface) The Surface object
Returns: int * int
(int * int) THe number of control points in UV direction. (U count, V count).
|
Returns the control point count of a Surface SurfaceId = the Surface's identifier. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.SurfacePointCount(surfaceId)
Parameters:
Guid
-
(Guid) The Surface object's identifier
Returns: int * int
(int * int) THe number of control points in UV direction. (U count, V count).
|
Returns the control point count of a Surface SurfaceId = the Surface's identifier.
|
Full Usage:
RhinoScriptSyntax.SurfacePoints(surfaceGeo, ?returnAll)
Parameters:
Surface
-
(Surface) The Surface
?returnAll : bool
-
(bool) Optional, default value: true
If True all Surface edit points are returned. If False,
the function will return Surface edit points based on whether or not
the Surface is closed or periodic
Returns: ResizeArray<Point3d>
(Point3d ResizeArray) The control points.
|
Returns the control points, or control vertices, of a Surface object. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.SurfacePoints(surfaceId, ?returnAll)
Parameters:
Guid
-
(Guid) The Surface's identifier
?returnAll : bool
-
(bool) Optional, default value: true
If True all Surface edit points are returned. If False,
the function will return Surface edit points based on whether or not
the Surface is closed or periodic
Returns: ResizeArray<Point3d>
(Point3d ResizeArray) The control points.
|
Returns the control points, or control vertices, of a Surface object.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.SurfaceTorus(surfaceGeo)
Parameters:
Surface
-
(Surface) The Surface
Returns: Plane * float * float
(Plane * float * float) containing the definition of the torus
[0] the base Plane of the torus
[1] the major radius of the torus
[2] the minor radius of the torus.
|
Returns the definition of a Surface torus. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.SurfaceTorus(surfaceId)
Parameters:
Guid
-
(Guid) The Surface's identifier
Returns: Plane * float * float
(Plane * float * float) containing the definition of the torus
[0] the base Plane of the torus
[1] the major radius of the torus
[2] the minor radius of the torus.
|
|
Full Usage:
RhinoScriptSyntax.SurfaceVolume(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The Surface
Returns: float
(float) The volume.
|
Calculates volume of a closed Surface or Polysurface. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.SurfaceVolume(objectId)
Parameters:
Guid
-
(Guid) The Surface's identifier
Returns: float
(float) The volume.
|
Calculates volume of a closed Surface or Polysurface.
|
Full Usage:
RhinoScriptSyntax.SurfaceVolumeCentroid(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The Surface
Returns: Point3d
(Point3d) Volume Centroid.
|
Calculates volume centroid of a closed Surface or Polysurface. Uses the supplied objects directly.
|
|
|
Full Usage:
RhinoScriptSyntax.SurfaceVolumeMoments(geometryObject)
Parameters:
GeometryBase
-
(GeometryBase) The Surface
Returns: ResizeArray<float * float * float>
((float*float*float) ResizeArray) A List of moments and error bounds in tuple(X, Y, Z) - see help topic
Index Description
[ 0] First Moments.
[ 1] The absolute (+/-) error bound for the First Moments.
[ 2] Second Moments.
[ 3] The absolute (+/-) error bound for the Second Moments.
[ 4] Product Moments.
[ 5] The absolute (+/-) error bound for the Product Moments.
[ 6] Area Moments of Inertia about the World Coordinate Axes.
[ 7] The absolute (+/-) error bound for the Area Moments of Inertia about World Coordinate Axes.
[ 8] Area Radii of Gyration about the World Coordinate Axes.
[ 9] (0,0,0) NOT WORKING , but should be: The absolute (+/-) error bound for the Area Radii of Gyration about World Coordinate Axes.
[10] Area Moments of Inertia about the Centroid Coordinate Axes.
[11] The absolute (+/-) error bound for the Area Moments of Inertia about the Centroid Coordinate Axes.
[12] Area Radii of Gyration about the Centroid Coordinate Axes.
[13] (0,0,0) NOT WORKING , but should be: The absolute (+/-) error bound for the Area Radii of Gyration about the Centroid Coordinate Axes.
|
Calculates volume moments of inertia of a Surface or Polysurface object. Returns 14 tuples: seven values, each followed by its error bound. For more information, see Rhino help for "Mass Properties calculation details". Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.SurfaceVolumeMoments(objectId)
Parameters:
Guid
-
(Guid) The Surface's identifier
Returns: ResizeArray<float * float * float>
((float*float*float) ResizeArray) A List of moments and error bounds in tuple(X, Y, Z) - see help topic
Index Description
[ 0] First Moments.
[ 1] The absolute (+/-) error bound for the First Moments.
[ 2] Second Moments.
[ 3] The absolute (+/-) error bound for the Second Moments.
[ 4] Product Moments.
[ 5] The absolute (+/-) error bound for the Product Moments.
[ 6] Area Moments of Inertia about the World Coordinate Axes.
[ 7] The absolute (+/-) error bound for the Area Moments of Inertia about World Coordinate Axes.
[ 8] Area Radii of Gyration about the World Coordinate Axes.
[ 9] (0,0,0) NOT WORKING , but should be: The absolute (+/-) error bound for the Area Radii of Gyration about World Coordinate Axes.
[10] Area Moments of Inertia about the Centroid Coordinate Axes.
[11] The absolute (+/-) error bound for the Area Moments of Inertia about the Centroid Coordinate Axes.
[12] Area Radii of Gyration about the Centroid Coordinate Axes.
[13] (0,0,0) NOT WORKING , but should be: The absolute (+/-) error bound for the Area Radii of Gyration about the Centroid Coordinate Axes.
|
Calculates volume moments of inertia of a Surface or Polysurface object. Returns 14 tuples: seven values, each followed by its error bound. For more information, see Rhino help for "Mass Properties calculation details".
|
Full Usage:
RhinoScriptSyntax.SurfaceWeights(geometryObject)
Parameters:
Surface
-
(Surface) The Surface
Returns: ResizeArray<float>
(float ResizeArray) point weights.
|
Returns list of weight values assigned to the control points of a Surface. The number of weights returned will be equal to the number of control points in the U and V directions. Uses the supplied objects directly.
|
Full Usage:
RhinoScriptSyntax.SurfaceWeights(objectId)
Parameters:
Guid
-
(Guid) The Surface's identifier
Returns: ResizeArray<float>
(float ResizeArray) point weights.
|
Returns list of weight values assigned to the control points of a Surface. The number of weights returned will be equal to the number of control points in the U and V directions.
|
Full Usage:
RhinoScriptSyntax.TemplateFile(filename)
Parameters:
string
-
(string) The name of the new default template file.
|
Sets Rhino's default template file. This is the file used when Rhino starts.
|
Full Usage:
RhinoScriptSyntax.TemplateFile()
Returns: string
(string) The current default template file.
|
Returns Rhino's default template file. This is the file used when Rhino starts.
|
Full Usage:
RhinoScriptSyntax.TemplateFolder(folder)
Parameters:
string
-
(string) The location of Rhino's template files. Note, the location must exist
|
Sets the location of Rhino's template folder.
|
Full Usage:
RhinoScriptSyntax.TemplateFolder()
Returns: string
(string) The current template file folder.
|
Returns the location of Rhino's template folder.
|
Full Usage:
RhinoScriptSyntax.TextDotFont(geometryObject)
Parameters:
TextDot
-
(TextDot) Geometry to use directly.
Returns: string
(string) The current text dot font.
|
Returns the font of a text dot.
|
Full Usage:
RhinoScriptSyntax.TextDotFont(objectIds, fontFace)
Parameters:
Guid seq
-
(Guid seq) Identifiers of multiple text dot objects
fontFace : string
-
(string) New font face name
|
Modifies the font of multiple text dots.
|
Full Usage:
RhinoScriptSyntax.TextDotFont(objectId, fontFace)
Parameters:
Guid
-
(Guid) Identifier of a text dot object
fontFace : string
-
(string) New font face name
|
Modifies the font of a text dot.
|
Full Usage:
RhinoScriptSyntax.TextDotFont(objectId)
Parameters:
Guid
-
(Guid) Identifier of a text dot object
Returns: string
(string) The current text dot font.
|
Returns the font of a text dot.
|
Full Usage:
RhinoScriptSyntax.TextDotHeight(geometryObject)
Parameters:
TextDot
-
(TextDot) Geometry to use directly.
Returns: int
(int) The current text dot height.
|
Returns the font height of a text dot.
|
Full Usage:
RhinoScriptSyntax.TextDotHeight(objectIds, height)
Parameters:
Guid seq
-
(Guid seq) Identifiers of multiple text dot objects
height : int
-
(int) New font height
|
Modifies the font height of multiple text dots.
|
Full Usage:
RhinoScriptSyntax.TextDotHeight(objectId, height)
Parameters:
Guid
-
(Guid) Identifier of a text dot object
height : int
-
(int) New font height
|
Modifies the font height of a text dot.
|
Full Usage:
RhinoScriptSyntax.TextDotHeight(objectId)
Parameters:
Guid
-
(Guid) Identifier of a text dot object
Returns: int
(int) The current text dot height.
|
Returns the font height of a text dot.
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.TextDotText(geometryObject)
Parameters:
TextDot
-
(TextDot) Geometry to use directly.
Returns: string
(string) The current text dot text.
|
Returns the text on a text dot object.
|
Full Usage:
RhinoScriptSyntax.TextDotText(objectIds, text)
Parameters:
Guid seq
-
(Guid seq) The identifiers of multiple text dot objects
text : string
-
(string) A new string for the dot
|
Modifies the text on multiple text dot objects.
|
Full Usage:
RhinoScriptSyntax.TextDotText(objectId, text)
Parameters:
Guid
-
(Guid) The identifier of a text dot object
text : string
-
(string) A new string for the dot
|
Modifies the text on a text dot object.
|
Full Usage:
RhinoScriptSyntax.TextDotText(objectId)
Parameters:
Guid
-
(Guid) The identifier of a text dot object
Returns: string
(string) The current text dot text.
|
Returns the text on a text dot object.
|
Full Usage:
RhinoScriptSyntax.TextObjectFont(geometryObject)
Parameters:
TextEntity
-
(TextEntity) Geometry to use directly.
Returns: string
(string) The current font face name.
|
Returns the font used by a text object.
|
Full Usage:
RhinoScriptSyntax.TextObjectFont(objectIds, font)
Parameters:
Guid seq
-
(Guid seq) The identifiers of multiple text objects
font : string
-
(string) The new Font Name
|
Modifies the font used by multiple text objects. Keeps the current state of bold and italic when possible.
|
Full Usage:
RhinoScriptSyntax.TextObjectFont(objectId, font)
Parameters:
Guid
-
(Guid) The identifier of a text object
font : string
-
(string) The new Font Name
|
Modifies the font used by a text object. Keeps the current state of bold and italic when possible.
|
Full Usage:
RhinoScriptSyntax.TextObjectFont(objectId)
Parameters:
Guid
-
(Guid) The identifier of a text object
Returns: string
(string) The current font face name.
|
Returns the font used by a text object.
|
Full Usage:
RhinoScriptSyntax.TextObjectHeight(geometryObject)
Parameters:
TextEntity
-
(TextEntity) Geometry to use directly.
Returns: float
(float) The current text height.
|
Returns the height of a text object.
|
Full Usage:
RhinoScriptSyntax.TextObjectHeight(objectIds, height)
Parameters:
Guid seq
-
(Guid seq) The identifiers of multiple text objects
height : float
-
(float) The new text height
|
Modifies the height of multiple text objects.
|
Full Usage:
RhinoScriptSyntax.TextObjectHeight(objectId, height)
Parameters:
Guid
-
(Guid) The identifier of a text object
height : float
-
(float) The new text height
|
Modifies the height of a text object.
|
Full Usage:
RhinoScriptSyntax.TextObjectHeight(objectId)
Parameters:
Guid
-
(Guid) The identifier of a text object
Returns: float
(float) The current text height.
|
Returns the height of a text object.
|
Full Usage:
RhinoScriptSyntax.TextObjectPlane(geometryObject)
Parameters:
TextEntity
-
(TextEntity) Geometry to use directly.
Returns: Plane
(Plane) The current Plane.
|
Returns the Plane used by a text object.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.TextObjectPoint(geometryObject)
Parameters:
TextEntity
-
(TextEntity) Geometry to use directly.
Returns: Point3d
(Point3d) The 3D point identifying the current location.
|
Returns the location of a text object.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.TextObjectRichText(geometryObject)
Parameters:
TextEntity
-
(TextEntity) Geometry to use directly.
Returns: string
(string) The current RichText formatting string.
|
Returns the RichText formatting string of a text object.
|
Full Usage:
RhinoScriptSyntax.TextObjectRichText(objectIds, rtfString, ?style)
Parameters:
Guid seq
-
(Guid seq) The identifiers of multiple text objects
rtfString : string
-
(string) A new text RichText formatting string
?style : string
-
(string) Optional, default value: "" Name of dimension style
|
Modifies the RichText formatting string of multiple text objects.
|
Full Usage:
RhinoScriptSyntax.TextObjectRichText(objectId, rtfString, ?style)
Parameters:
Guid
-
(Guid) The identifier of a text object
rtfString : string
-
(string) A new text RichText formatting string
?style : string
-
(string) Optional, default value: "" Name of dimension style
|
Modifies the RichText formatting string of a text object.
|
Full Usage:
RhinoScriptSyntax.TextObjectRichText(objectId)
Parameters:
Guid
-
(Guid) The identifier of a text object
Returns: string
(string) The current RichText formatting string.
|
Returns the RichText formatting string of a text object.
|
Full Usage:
RhinoScriptSyntax.TextObjectStyle(geometryObject)
Parameters:
TextEntity
-
(TextEntity) Geometry to use directly.
Returns: int
(int) The current font style
0 = Normal
1 = Bold
2 = Italic
3 = Bold and Italic.
|
Returns the font style of a text object.
|
Full Usage:
RhinoScriptSyntax.TextObjectStyle(objectIds, style)
Parameters:
Guid seq
-
(Guid seq) The identifiers of multiple text objects
style : int
-
(int) The font style. Can be any of the following flags
0 = Normal
1 = Bold
2 = Italic
3 = Bold and Italic
|
Modifies the font style of multiple text objects. Keeps the font face
|
Full Usage:
RhinoScriptSyntax.TextObjectStyle(objectId, style)
Parameters:
Guid
-
(Guid) The identifier of a text object
style : int
-
(int) The font style. Can be any of the following flags
0 = Normal
1 = Bold
2 = Italic
3 = Bold and Italic
|
Modifies the font style of a text object.
|
Full Usage:
RhinoScriptSyntax.TextObjectStyle(objectId)
Parameters:
Guid
-
(Guid) The identifier of a text object
Returns: int
(int) The current font style
0 = Normal
1 = Bold
2 = Italic
3 = Bold and Italic.
|
Returns the font style of a text object.
|
Full Usage:
RhinoScriptSyntax.TextObjectText(geometryObject)
Parameters:
TextEntity
-
(TextEntity) Geometry to use directly.
Returns: string
(string) The current string value.
|
Returns the plain text string of a text object.
|
Full Usage:
RhinoScriptSyntax.TextObjectText(objectIds, text)
Parameters:
Guid seq
-
(Guid seq) The identifiers of multiple text objects
text : string
-
(string) A new text string
|
Modifies the plain text string of multiple text objects.
|
Full Usage:
RhinoScriptSyntax.TextObjectText(objectId, text)
Parameters:
Guid
-
(Guid) The identifier of a text object
text : string
-
(string) A new text string
|
Modifies the plain text string of a text object.
|
Full Usage:
RhinoScriptSyntax.TextObjectText(objectId)
Parameters:
Guid
-
(Guid) The identifier of a text object
Returns: string
(string) The current string value.
|
Returns the plain text string of a text object.
|
Full Usage:
RhinoScriptSyntax.TextOut(message, ?title)
Parameters:
string
-
(string) The message
?title : string
-
(string) Optional, The message title
|
Display a text dialog box similar to the one used by the _What command.
|
Full Usage:
RhinoScriptSyntax.TiltView(direction, angleDegrees, ?view)
Parameters:
int
-
(int) The direction to rotate the view where
0 = right
1 = left
angleDegrees : float
-
(float) The angle in degrees to rotate
?view : string
-
(string) Optional, Title of the view. If omitted, the current active view is used
|
Tilts a view by rotating the camera up vector. See the TiltView command in the Rhino help file for more details.
|
Full Usage:
RhinoScriptSyntax.ToolbarCollectionCount()
Returns: int
(int) The number of currently open toolbar collections.
|
Returns number of currently open toolbar collections.
|
Full Usage:
RhinoScriptSyntax.ToolbarCollectionNames()
Returns: ResizeArray<string>
(string ResizeArray) The names of all currently open toolbar collections.
|
Returns names of all currently open toolbar collections.
|
Full Usage:
RhinoScriptSyntax.ToolbarCollectionPath(name)
Parameters:
string
-
(string) Name of currently open toolbar collection
Returns: string
(string) The full path.
|
Returns full path to a currently open toolbar collection file.
|
Full Usage:
RhinoScriptSyntax.ToolbarCount(name, ?groups)
Parameters:
string
-
(string) Name of currently open toolbar collection
?groups : bool
-
(bool) Optional, default value: false
If true, return the number of toolbar groups in the file
Returns: int
(int) Number of toolbars.
|
Returns the number of toolbars or groups in a currently open toolbar file.
|
Full Usage:
RhinoScriptSyntax.ToolbarNames(name, ?groups)
Parameters:
string
-
(string) Name of currently open toolbar collection
?groups : bool
-
(bool) Optional, default value: false
If true, return the names of toolbar groups in the file
Returns: ResizeArray<string>
(string ResizeArray) Names of all toolbars (or toolbar groups).
|
Returns the names of all toolbars (or toolbar groups) found in a currently open toolbar file.
|
Full Usage:
RhinoScriptSyntax.TransformObject(geometry, matrix)
Parameters:
GeometryBase
-
(GeometryBase) Input geometry to duplicate and transform.
matrix : Transform
-
(Transform) The transformation matrix (4x4 array of numbers)
Returns: GeometryBase
(GeometryBase) The transformed geometry duplicate.
|
Returns a transformed duplicate of the input geometry. The input is unchanged and the result is not added to a document.
|
Full Usage:
RhinoScriptSyntax.TransformObject(objectId, matrix, ?copy)
Parameters:
Guid
-
(Guid) The identifier of the object
matrix : Transform
-
(Transform) The transformation matrix (4x4 array of numbers)
?copy : bool
-
(bool) Optional, default value: false
Copy the object. Copies of grouped objects are put into new groups
Returns: Guid
(Guid) The identifier of the transformed object.
|
Moves, scales, or rotates an object given a 4x4 transformation matrix. The matrix acts on the left. Use the geometry overload to return transformed duplicates without modifying document objects. With copy=false the object in the document is transformed in place and keeps its Guid, with copy=true the original is left unchanged and a transformed copy is added to the document. The geometry overload returns a transformed duplicate instead and does not touch the document.
|
Full Usage:
RhinoScriptSyntax.TransformObjects(geometries, matrix)
Parameters:
GeometryBase seq
-
(GeometryBase seq) Input geometry to duplicate and transform.
matrix : Transform
-
(Transform) The transformation matrix (4x4 array of numbers)
Returns: ResizeArray<GeometryBase>
(GeometryBase ResizeArray) The transformed geometry duplicates.
|
Returns transformed duplicates of the input geometries. The input is unchanged and the result is not added to a document.
|
Full Usage:
RhinoScriptSyntax.TransformObjects(objectIds, matrix, ?copy)
Parameters:
Guid seq
-
(Guid seq) List of object identifiers
matrix : Transform
-
(Transform) The transformation matrix (4x4 array of numbers)
?copy : bool
-
(bool) Optional, default value: false
Copy the objects. Copies of grouped objects are put into new groups
Returns: ResizeArray<Guid>
(Guid ResizeArray) IDs identifying the newly transformed objects.
|
Moves, scales, or rotates a list of objects given a 4x4 transformation matrix. The matrix acts on the left. Use the geometry overload to return transformed duplicates without modifying document objects. With copy=false the objects in the document are transformed in place and keep their Guids, with copy=true the originals are left unchanged and transformed copies are added to the document. The geometry overload returns transformed duplicates instead and does not touch the document.
|
Full Usage:
RhinoScriptSyntax.TrimBrep(geometryObject, cutter, ?tolerance)
Parameters:
Brep
-
(Brep) Surface or Polysurface object
cutter : Plane
-
(Plane) Plane performing the trim
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Returns: ResizeArray<Brep>
(Brep ResizeArray) Newly created geometry. The caller owns the returned objects.
|
Trims a Surface using an oriented cutter Plane. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.TrimBrep(geometryObject, cutter, ?tolerance)
Parameters:
Brep
-
(Brep) Surface or Polysurface object
cutter : Brep
-
(Brep) Surface or Polysurface performing the trim
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Returns: ResizeArray<Brep>
(Brep ResizeArray) Newly created geometry. The caller owns the returned objects.
|
Trims a Surface or Polysurface using an oriented cutter brep or Surface. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.TrimBrep(objectId, cutter, ?tolerance)
Parameters:
Guid
-
(Guid) Surface or Polysurface identifier
cutter : Plane
-
(Plane) Plane performing the trim
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers of retained components.
|
Trims a Surface using an oriented cutter Plane.
|
Full Usage:
RhinoScriptSyntax.TrimBrep(objectId, cutter, ?tolerance)
Parameters:
Guid
-
(Guid) Surface or Polysurface identifier
cutter : Guid
-
(Guid) Surface or Polysurface performing the trim
?tolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers of retained components.
|
Trims a Surface or Polysurface using an oriented cutter brep or Surface.
|
Full Usage:
RhinoScriptSyntax.TrimCurve(curveGeo, interval)
Parameters:
Curve
-
(Curve) The input curve geometry.
interval : float * float
-
(float * float) Two numbers identifying the interval to keep. Portions of
the Curve before domain[0] and after domain[1] will be removed. If the
input Curve is open, the interval must be increasing. If the input
Curve is closed and the interval is decreasing, then the portion of
the Curve across the start and end of the Curve is returned
Returns: Curve
(Curve) The trimmed curve, without adding it to the document.
|
Computes TrimCurve from geometry without modifying the document. Inputs are not modified.
|
Full Usage:
RhinoScriptSyntax.TrimCurve(curveId, interval, ?deleteInput)
Parameters:
Guid
-
(Guid) The Curve to trim
interval : float * float
-
(float * float) Two numbers identifying the interval to keep. Portions of
the Curve before domain[0] and after domain[1] will be removed. If the
input Curve is open, the interval must be increasing. If the input
Curve is closed and the interval is decreasing, then the portion of
the Curve across the start and end of the Curve is returned
?deleteInput : bool
-
(bool) Optional, default value: true
Delete the input Curve. If omitted the input Curve is deleted
Returns: Guid
(Guid) identifier of the new Curve.
|
Trims a Curve by removing portions of the Curve outside a specified interval.
|
|
Remove portions of the Surface outside of the specified interval in U direction. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.TrimSurfaceU(surfaceId, interval, ?deleteInput)
Parameters:
Guid
-
(Guid) Surface identifier
interval : float * float
-
(float*float) Sub section of the Surface to keep.
?deleteInput : bool
-
(bool) Optional, default value: false
Should the input Surface be deleted
Returns: Guid
(Guid) new Surface identifier.
|
Remove portions of the Surface outside of the specified interval in U direction.
|
Full Usage:
RhinoScriptSyntax.TrimSurfaceUV(surfaceGeo, intervalU, intervalV)
Parameters:
Surface
-
(Surface) Surface object
intervalU : float * float
-
(float*float) Sub section of the Surface to keep in U direction
intervalV : float * float
-
(float*float) Sub section of the Surface to keep in V direction
Returns: Surface
(Surface) Newly created geometry. The caller owns the returned objects.
|
Remove portions of the Surface outside of the specified interval ain U and V direction. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.TrimSurfaceUV(surfaceId, intervalU, intervalV, ?deleteInput)
Parameters:
Guid
-
(Guid) Surface identifier
intervalU : float * float
-
(float*float) Sub section of the Surface to keep in U direction
intervalV : float * float
-
(float*float) Sub section of the Surface to keep in V direction
?deleteInput : bool
-
(bool) Optional, default value: false
Should the input Surface be deleted
Returns: Guid
(Guid) new Surface identifier.
|
Remove portions of the Surface outside of the specified interval ain U and V direction.
|
|
Remove portions of the Surface outside of the specified interval in V direction. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.TrimSurfaceV(surfaceId, interval, ?deleteInput)
Parameters:
Guid
-
(Guid) Surface identifier
interval : float * float
-
(float*float) Sub section of the Surface to keep.
?deleteInput : bool
-
(bool) Optional, default value: false
Should the input Surface be deleted
Returns: Guid
(Guid) new Surface identifier.
|
Remove portions of the Surface outside of the specified interval in V direction.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.TryCoerceCurve(objectId, ?segmentIndex)
Parameters:
Guid
-
objectId (Guid or string) to be RhinoScriptSyntax.Coerced into a Curve
?segmentIndex : int
-
(int) Optional, index of segment to retrieve. To ignore segmentIndex give -1 as argument
Returns: Curve option
A Rhino.Geometry.Curve Option.
|
Attempt to get Curve geometry from the document with a given objectId.
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.TryCoerceGeometry(objectId)
Parameters:
Guid
-
Geometry identifier (Guid).
Returns: GeometryBase option
A Rhino.Geometry.GeometryBase option.
|
Attempt to get GeometryBase from a given Guid. Returns None on empty or unknown Guid.
|
|
|
Full Usage:
RhinoScriptSyntax.TryCoerceGuid(rhinoObject)
Parameters:
RhinoObject
-
(DocObjects.RhinoObject) The RhinoObject.
Returns: Guid option
A Guid option. None if the RhinoObject is null.
|
Attempt to get the Guid of a RhinoObject.
|
Full Usage:
RhinoScriptSyntax.TryCoerceGuid(input)
Parameters:
string
-
(string) The Guid as a string.
Returns: Guid option
A Guid option. None if the string is not a Guid or is the empty Guid.
|
Attempt to parse a Guid from a string.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.TryCoerceRhinoObject(objectId)
Parameters:
Guid
-
Object identifier (Guid or string).
Returns: RhinoObject option
A RhinoObject option.
|
Attempt to get a RhinoObject from the document with a given objectId.
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.TryGetUserText(objectId, key, ?attachedToGeometry)
Parameters:
Guid
-
(Guid) The object's identifier
key : string
-
(string) The key name
?attachedToGeometry : bool
-
(bool) Optional, default value: false
Location on the object to retrieve the user text
Returns: Option<string>
(string Option) If key is specified, Some(value) else None.
|
Returns user text stored on an object, returns Option.None if non-existing.
|
Full Usage:
RhinoScriptSyntax.UnCollapseLayer(layerName, ?childrenToo)
Parameters:
string
-
(string) full or short layer name
?childrenToo : bool
-
(bool) Optional, default value: false
'true' to expand any child layers too.
'false' to not change the child layers collapse state.(default)
|
Expand a layer in UI if it has children. This is the opposite of rs.CollapseLayer(..)
|
Full Usage:
RhinoScriptSyntax.UnifyMeshNormals(objectId)
Parameters:
Guid
-
(Guid) Identifier of a Mesh object
Returns: int
(int) The number of faces that were modified.
|
Fixes inconsistencies in the directions of faces of a Mesh.
|
Full Usage:
RhinoScriptSyntax.UnitAbsoluteTolerance(tolerance, modelUnits)
Parameters:
float
-
(float) A positive absolute tolerance.
modelUnits : bool
-
(bool) True for model units; False for page units.
|
Sets the absolute tolerance for model or page units.
|
Full Usage:
RhinoScriptSyntax.UnitAbsoluteTolerance(modelUnits)
Parameters:
bool
-
(bool) True for model units; False for page units.
Returns: float
(float) The absolute tolerance in the selected drawing units.
|
Returns the absolute tolerance for model or page units.
|
Full Usage:
RhinoScriptSyntax.UnitAbsoluteTolerance(tolerance)
Parameters:
float
-
(float) The absolute tolerance to set
|
Sets the document's absolute tolerance. Absolute tolerance is measured in drawing units. See Rhino's document properties command (Units and Page Units Window) for details.
|
Full Usage:
RhinoScriptSyntax.UnitAbsoluteTolerance()
Returns: float
(float) The current absolute tolerance.
|
Returns the document's absolute tolerance. Absolute tolerance is measured in drawing units. See Rhino's document properties command (Units and Page Units Window) for details.
|
Full Usage:
RhinoScriptSyntax.UnitAngleTolerance(angleToleranceDegrees, modelUnits)
Parameters:
float
-
(float) A positive angle tolerance in degrees.
modelUnits : bool
-
(bool) True for model units; False for page units.
|
Sets the angle tolerance for model or page units.
|
Full Usage:
RhinoScriptSyntax.UnitAngleTolerance(modelUnits)
Parameters:
bool
-
(bool) True for model units; False for page units.
Returns: float
(float) The angle tolerance in degrees.
|
Returns the angle tolerance in degrees for model or page units.
|
Full Usage:
RhinoScriptSyntax.UnitAngleTolerance(angleToleranceDegrees)
Parameters:
float
-
(float) The angle tolerance to set in degrees
|
Set the document's angle tolerance. Angle tolerance is measured in degrees. See Rhino's DocumentProperties command (Units and Page Units Window) for details.
|
Full Usage:
RhinoScriptSyntax.UnitAngleTolerance()
Returns: float
(float) The current angle tolerance in degrees.
|
Return the document's angle tolerance in degrees. Angle tolerance is measured in degrees. See Rhino's DocumentProperties command (Units and Page Units Window) for details.
|
Full Usage:
RhinoScriptSyntax.UnitDistanceDisplayPrecision(precision, modelUnits)
Parameters:
int
-
(int) The distance display precision, from 0 through 20.
modelUnits : bool
-
(bool) True for model units; False for page units.
|
Sets distance display precision for model or page units.
|
Full Usage:
RhinoScriptSyntax.UnitDistanceDisplayPrecision(modelUnits)
Parameters:
bool
-
(bool) True for model units; False for page units.
Returns: int
(int) The distance display precision.
|
Returns distance display precision for model or page units.
|
Full Usage:
RhinoScriptSyntax.UnitDistanceDisplayPrecision(precision)
Parameters:
int
-
(int) The distance display precision. If the current distance display mode is Decimal, then precision is the number of decimal places.
Valid values are >= 0 and <= 20.
If the current distance display mode is Fractional (including Feet and Inches), then the denominator = (1/2)^precision.
Use UnitDistanceDisplayMode to get the current distance display mode
|
Set the document's distance display precision.
|
Full Usage:
RhinoScriptSyntax.UnitDistanceDisplayPrecision()
Returns: int
(int) The current distance display precision.
|
Return the document's distance display precision.
|
Full Usage:
RhinoScriptSyntax.UnitRelativeTolerance(relativeTolerance, modelUnits)
Parameters:
float
-
(float) A positive relative tolerance in percent.
modelUnits : bool
-
(bool) True for model units; False for page units.
|
Sets the relative tolerance for model or page units.
|
Full Usage:
RhinoScriptSyntax.UnitRelativeTolerance(modelUnits)
Parameters:
bool
-
(bool) True for model units; False for page units.
Returns: float
(float) The relative tolerance in percent.
|
Returns the relative tolerance for model or page units.
|
Full Usage:
RhinoScriptSyntax.UnitRelativeTolerance(relativeTolerance)
Parameters:
float
-
(float) The relative tolerance in percent
|
Set the document's relative tolerance. Relative tolerance is measured in percent. See Rhino's DocumentProperties command (Units and Page Units Window) for details.
|
Full Usage:
RhinoScriptSyntax.UnitRelativeTolerance()
Returns: float
(float) The current tolerance in percent.
|
Return the document's relative tolerance. Relative tolerance is measured in percent. See Rhino's DocumentProperties command (Units and Page Units Window) for details.
|
Full Usage:
RhinoScriptSyntax.UnitScale(toSystem)
Parameters:
UnitSystem
-
(Rhino.UnitSystem) The destination unit system.
Returns: float
(float) The scale factor from the current model units.
|
Returns the scale factor from the document model units to another unit system.
|
Full Usage:
RhinoScriptSyntax.UnitScale(toSystem)
Parameters:
int
-
(int) The destination unit system, using the values documented by the two-argument overload.
Returns: float
(float) The scale factor from the current model units.
|
Returns the scale factor from the document model units to another unit system.
|
Full Usage:
RhinoScriptSyntax.UnitScale(toSystem, fromSystem)
Parameters:
int
-
(int) The destination unit-system value.
fromSystem : UnitSystem
-
(Rhino.UnitSystem) The source unit system.
Returns: float
(float) The scale factor from the source units to the destination units.
|
Returns the scale factor for changing between unit systems.
|
Full Usage:
RhinoScriptSyntax.UnitScale(toSystem, fromSystem)
Parameters:
UnitSystem
-
(Rhino.UnitSystem) The destination unit system.
fromSystem : int
-
(int) The source unit-system value.
Returns: float
(float) The scale factor from the source units to the destination units.
|
Returns the scale factor for changing between unit systems.
|
Full Usage:
RhinoScriptSyntax.UnitScale(toSystem, fromSystem)
Parameters:
UnitSystem
-
(Rhino.UnitSystem) The destination unit system.
fromSystem : UnitSystem
-
(Rhino.UnitSystem) The source unit system.
Returns: float
(float) The scale factor from the source units to the destination units.
|
Returns the scale factor for changing between unit systems.
|
Full Usage:
RhinoScriptSyntax.UnitScale(toSystem, fromSystem)
Parameters:
int
-
(int) The unit system to convert to. The unit systems are are:
0 - No unit system
1 - Microns (1.0e-6 meters)
2 - Millimeters (1.0e-3 meters)
3 - Centimeters (1.0e-2 meters)
4 - Meters
5 - Kilometers (1.0e + 3 meters)
6 - Microinches (2.54e-8 meters, 1.0e-6 inches)
7 - Mils (2.54e-5 meters, 0.001 inches)
8 - Inches (0.0254 meters)
9 - Feet (0.3048 meters, 12 inches)
10 - Miles (1609.344 meters, 5280 feet)
11 - *Reserved for custom Unit System*
12 - Angstroms (1.0e-10 meters)
13 - Nanometers (1.0e-9 meters)
14 - Decimeters (1.0e-1 meters)
15 - Dekameters (1.0e + 1 meters)
16 - Hectometers (1.0e + 2 meters)
17 - Megameters (1.0e + 6 meters)
18 - Gigameters (1.0e + 9 meters)
19 - Yards (0.9144 meters, 36 inches)
20 - Printer point (1/72 inches, computer points)
21 - Printer pica (1/6 inches, (computer picas)
22 - Nautical mile (1852 meters)
23 - Astronomical (1.4959787e + 11)
24 - Lightyears (9.46073e + 15 meters)
25 - Parsecs (3.08567758e + 16)
fromSystem : int
-
(int) The unit system to convert from (see above)
Returns: float
(float) scale factor for changing between unit systems.
|
Return the scale factor for changing between unit systems.
|
Full Usage:
RhinoScriptSyntax.UnitSystem(unitSystem, scale, modelUnits)
Parameters:
UnitSystem
-
(Rhino.UnitSystem) The new unit system. Uses the same validation as the integer overload.
scale : bool
-
(bool) True to scale existing geometry for the new units.
modelUnits : bool
-
(bool) True for model units; False for page units.
|
Sets the model or page unit system, optionally scaling existing geometry.
|
Full Usage:
RhinoScriptSyntax.UnitSystem(unitSystem, scale, modelUnits)
Parameters:
int
-
(int) The new unit system, from 0 through 25.
scale : bool
-
(bool) True to scale geometry for the new units.
modelUnits : bool
-
(bool) True for model units; False for page units.
|
Sets the model or page unit system, optionally scaling existing geometry.
|
Full Usage:
RhinoScriptSyntax.UnitSystem(modelUnits)
Parameters:
bool
-
(bool) True for model units; False for page units.
Returns: int
(int) The unit system, using the same values as the parameterless getter.
|
Returns the model or page unit system.
|
Full Usage:
RhinoScriptSyntax.UnitSystem(unitSystem, ?scale)
Parameters:
UnitSystem
-
(Rhino.UnitSystem) The new unit system. Uses the same validation as the integer overload.
?scale : bool
-
(bool) Optional, default value: false. True to scale existing geometry for the new units.
|
Sets the document model unit system, optionally scaling existing geometry.
|
Full Usage:
RhinoScriptSyntax.UnitSystem(unitSystem, ?scale)
Parameters:
int
-
(int) The unit system to set the document to. The unit systems are:
0 - No unit system
1 - Microns (1.0e-6 meters)
2 - Millimeters (1.0e-3 meters)
3 - Centimeters (1.0e-2 meters)
4 - Meters
5 - Kilometers (1.0e + 3 meters)
6 - MicroInches (2.54e-8 meters, 1.0e-6 inches)
7 - Mils (2.54e-5 meters, 0.001 inches)
8 - Inches (0.0254 meters)
9 - Feet (0.3048 meters, 12 inches)
10 - Miles (1609.344 meters, 5280 feet)
11 - *Reserved for custom Unit System*
12 - Angstroms (1.0e-10 meters)
13 - Nanometers (1.0e-9 meters)
14 - Decimeters (1.0e-1 meters)
15 - Dekameters (1.0e + 1 meters)
16 - Hectometers (1.0e + 2 meters)
17 - Megameters (1.0e + 6 meters)
18 - Gigameters (1.0e + 9 meters)
19 - Yards (0.9144 meters, 36 inches)
20 - Printer point (1/72 inches, computer points)
21 - Printer pica (1/6 inches, (computer picas)
22 - Nautical mile (1852 meters)
23 - Astronomical (1.4959787e + 11)
24 - Lightyears (9.46073e + 15 meters)
25 - Parsecs (3.08567758e + 16)
?scale : bool
-
(bool) Optional, default value: false
Scale existing geometry based on the new unit system.
If not specified, any existing geometry is not scaled (False)
|
Set the document's unit system. See Rhino's DocumentProperties command (Units and Page Units Window) for details.
|
Full Usage:
RhinoScriptSyntax.UnitSystem()
Returns: int
(int) The current unit system
0 - No unit system
1 - Microns (1.0e-6 meters)
2 - Millimeters (1.0e-3 meters)
3 - Centimeters (1.0e-2 meters)
4 - Meters
5 - Kilometers (1.0e + 3 meters)
6 - MicroInches (2.54e-8 meters, 1.0e-6 inches)
7 - Mils (2.54e-5 meters, 0.001 inches)
8 - Inches (0.0254 meters)
9 - Feet (0.3048 meters, 12 inches)
10 - Miles (1609.344 meters, 5280 feet)
11 - *Reserved for custom Unit System*
12 - Angstroms (1.0e-10 meters)
13 - Nanometers (1.0e-9 meters)
14 - Decimeters (1.0e-1 meters)
15 - Dekameters (1.0e + 1 meters)
16 - Hectometers (1.0e + 2 meters)
17 - Megameters (1.0e + 6 meters)
18 - Gigameters (1.0e + 9 meters)
19 - Yards (0.9144 meters, 36 inches)
20 - Printer point (1/72 inches, computer points)
21 - Printer pica (1/6 inches, (computer picas)
22 - Nautical mile (1852 meters)
23 - Astronomical (1.4959787e + 11)
24 - Lightyears (9.46073e + 15 meters)
25 - Parsecs (3.08567758e + 16).
|
Return the document's unit system. See Rhino's DocumentProperties command (Units and Page Units Window) for details.
|
Full Usage:
RhinoScriptSyntax.UnitSystemName(?capitalize, ?singular, ?abbreviate, ?modelUnits)
Parameters:
bool
-
(bool) Optional, default value: false
Capitalize the first character of the units system name (e.g. return "Millimeter" instead of "millimeter"). The default is not to capitalize the first character (false)
?singular : bool
-
(bool) Optional, default value: true
Return the singular form of the units system name (e.g. "millimeter" instead of "millimeters"). The default is to return the singular form of the name (true)
?abbreviate : bool
-
(bool) Optional, default value: false
Abbreviate the name of the units system (e.g. return "mm" instead of "millimeter"). The default is not to abbreviate the name (false)
?modelUnits : bool
-
(bool) Optional, default value: true
Return the document's model units (True) or the document's page units (False). The default is True
Returns: string
(string) The name of the current units system.
|
Returns the name of the current unit system.
|
Full Usage:
RhinoScriptSyntax.UnlockGroup(groupName)
Parameters:
string
-
(string) The name of an existing group
Returns: int
(int) The number of objects that were unlocked.
|
Unlocks a group of previously locked objects. Locks objects are visible, can be snapped to, but cannot be selected.
|
Full Usage:
RhinoScriptSyntax.UnlockObject(objectId)
Parameters:
Guid
-
(Guid) The identifier of an object
|
Unlocks an object. Locked objects are visible, and can be snapped to, but they cannot be selected.
|
Full Usage:
RhinoScriptSyntax.UnlockObjects(objectIds)
Parameters:
Guid seq
-
(Guid seq) The identifiers of objects
|
Unlocks one or more objects. Locked objects are visible, and can be snapped to, but they cannot be selected.
|
Full Usage:
RhinoScriptSyntax.UnrollSurface(surfaceGeo, ?explode, ?followingGeometry, ?absoluteTolerance, ?relativeTolerance)
Parameters:
Brep
-
(Brep) The Surface
?explode : bool
-
(bool) Optional, default value: false
If True, the resulting Surfaces are not joined
?followingGeometry : GeometryBase
-
(GeometryBase seq) Optional, List of Curves, dots, and points which
should be unrolled with the Surface
?absoluteTolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Absolute tolerance
?relativeTolerance : float
-
(float) Optional, default value: State.Doc.ModelRelativeTolerance
Relative tolerance
Returns: ResizeArray<Brep> * ResizeArray<GeometryBase>
(Brep ResizeArray * GeometryBase ResizeArray) Unrolled Breps and following geometry, in curve, point, then text-dot order. The caller owns the returned objects.
|
Flattens a develop-able Surface or Polysurface. Returns geometry without adding it.
|
Full Usage:
RhinoScriptSyntax.UnrollSurface(surfaceId, ?explode, ?followingGeometry, ?absoluteTolerance, ?relativeTolerance)
Parameters:
Guid
-
(Guid) The Surface's identifier
?explode : bool
-
(bool) Optional, default value: false
If True, the resulting Surfaces are not joined
?followingGeometry : Guid
-
(Guid seq) Optional, List of Curves, dots, and points which
should be unrolled with the Surface
?absoluteTolerance : float
-
(float) Optional, default value: State.Doc.ModelAbsoluteTolerance
Absolute tolerance
?relativeTolerance : float
-
(float) Optional, default value: State.Doc.ModelRelativeTolerance
Relative tolerance
Returns: ResizeArray<Guid> * ResizeArray<Guid>
(Guid ResizeArray * Guid ResizeArray) Two lists: List of unrolled Surface ids and list of following objects.
|
Flattens a develop-able Surface or Polysurface.
|
Full Usage:
RhinoScriptSyntax.UnselectAllObjects()
Returns: int
(int) The number of objects that were unselected.
|
Unselects all objects in the document.
|
Full Usage:
RhinoScriptSyntax.UnselectObject(objectId)
Parameters:
Guid
-
(Guid) Id of object to unselect.
|
Unselects a single selected object.
|
Full Usage:
RhinoScriptSyntax.UnselectObjectGrip(objectId, index)
Parameters:
Guid
-
(Guid) Identifier of the object
index : int
-
(int) Index of the grip to unselect
Returns: bool
(bool) True or false indicating success or failure.
|
Unselects a single grip owned by an object. If the object's grips are not turned on, the grip will not be unselected.
|
Full Usage:
RhinoScriptSyntax.UnselectObjectGrips(objectId)
Parameters:
Guid
-
(Guid) Identifier of the object
Returns: int
(int) Number of grips unselected.
|
Unselects an object's grips. Note, the grips will not be turned off.
|
Full Usage:
RhinoScriptSyntax.UnselectObjects(objectIds)
Parameters:
Guid seq
-
(Guid seq) Identifiers of the objects to unselect.
|
Unselects multiple selected objects.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.VectorCompare(vector1, vector2)
Parameters:
Vector3d
-
(Vector3d) Vector1 of the two vectors to compare
vector2 : Vector3d
-
(Vector3d) Vector2 of the two vectors to compare
Returns: int
(int) result of comparing the vectors.
-1 if vector1 is less than vector2
0 if vector1 is equal to vector2
1 if vector1 is greater than vector2.
|
Compares two 3D vectors.
|
|
|
Full Usage:
RhinoScriptSyntax.VectorCrossProduct(vector1, vector2)
Parameters:
Vector3d
-
(Vector3d) Vector1 of the vectors to perform cross product on
vector2 : Vector3d
-
(Vector3d) Vector2 of the vectors to perform cross product on
Returns: Vector3d
(Vector3d) The resulting cross product direction.
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.VectorLength(vector)
Parameters:
Vector3d
-
(Vector3d) The 3-D vector
Returns: float
(float) The length of the vector.
|
Returns the length of a 3D vector.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.ViewCPlane(view, plane)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
plane : Plane
-
(Plane) The new construction Plane if setting
|
Set a view's construction Plane.
|
Full Usage:
RhinoScriptSyntax.ViewCPlane(view)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
Returns: Plane
(Plane) The current construction Plane.
|
Return a view's construction Plane.
|
Full Usage:
RhinoScriptSyntax.ViewCamera(view, cameraLocation)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
cameraLocation : Point3d
-
(Point3d) A 3D point identifying the new camera location
|
Sets the camera location of the specified view.
|
Full Usage:
RhinoScriptSyntax.ViewCamera(view)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
Returns: Point3d
(Point3d) The current camera location.
|
Returns the camera location of the specified view.
|
Full Usage:
RhinoScriptSyntax.ViewCameraLens(view, length)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
length : float
-
(float) The new 35mm camera lens length
|
Sets the 35mm camera lens length of the specified perspective projection view.
|
Full Usage:
RhinoScriptSyntax.ViewCameraLens(view)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
Returns: float
(float) The current lens length.
|
Returns the 35mm camera lens length of the specified perspective projection view.
|
Full Usage:
RhinoScriptSyntax.ViewCameraPlane(?view)
Parameters:
string
-
(string) Optional, Title of the view. If omitted, the current active view is used
Returns: Plane
(Plane) The view's camera Plane.
|
Returns the orientation of a view's camera.
|
Full Usage:
RhinoScriptSyntax.ViewCameraTarget(view, camera, target)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
camera : Point3d
-
(Point3d) 3d point identifying the new camera location
target : Point3d
-
(Point3d) 3d point identifying the new target location
|
|
|
|
Full Usage:
RhinoScriptSyntax.ViewCameraUp(view, upVector)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
upVector : Vector3d
-
(Vector3d) 3D vector identifying the new camera up direction
|
Sets the camera up direction of a specified.
|
Full Usage:
RhinoScriptSyntax.ViewCameraUp(view)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
Returns: Vector3d
(Vector3d) The current camera up direction.
|
Returns the camera up direction of a specified.
|
Full Usage:
RhinoScriptSyntax.ViewDisplayMode(view, mode)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
mode : string
-
(string) Name of a display mode
|
Set a view display mode.
|
Full Usage:
RhinoScriptSyntax.ViewDisplayMode(view)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
Returns: string
(string) The current mode.
|
Return a view display mode.
|
Full Usage:
RhinoScriptSyntax.ViewDisplayModeId(name)
Parameters:
string
-
(string) Name of the display mode
Returns: Guid
(Guid) The id of the display mode.
|
Return id of a display mode given it's name.
|
Full Usage:
RhinoScriptSyntax.ViewDisplayModeName(modeId)
Parameters:
Guid
-
(Guid) The identifier of the display mode obtained from the ViewDisplayModes method
Returns: string
(string) The name of the display mode.
|
Return name of a display mode given it's id.
|
Full Usage:
RhinoScriptSyntax.ViewDisplayModes()
Returns: ResizeArray<string>
(string ResizeArray) strings identifying the display mode names.
|
Return list of display modes.
|
Full Usage:
RhinoScriptSyntax.ViewNames(?viewType)
Parameters:
int
-
(int) Optional, default value: 0. The standard model views.
The type of view to return
0 = standard model views
1 = page layout views
2 = both standard and page layout views
Returns: ResizeArray<string>
(string ResizeArray) List of the view names.
|
Return the names/titles, of all views in the document.
|
Full Usage:
RhinoScriptSyntax.ViewNearCorners(?view)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
Returns: Point3d * Point3d * Point3d * Point3d
(Point3d * Point3d * Point3d * Point3d) Four Point3d that define the corners of the rectangle (counter-clockwise order).
|
Return 3d corners of a view's near clipping Plane rectangle. Useful in determining the "real world" size of a parallel-projected view.
|
Full Usage:
RhinoScriptSyntax.ViewProjection(view, mode)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
mode : int
-
(int) The projection mode
1 = parallel
2 = perspective
3 = two point perspective
|
Set a view's projection mode.
|
Full Usage:
RhinoScriptSyntax.ViewProjection(view)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
Returns: int
(int) The current projection mode for the specified view
1 = parallel
2 = perspective
3 = two point perspective.
|
Return a view's projection mode.
|
Full Usage:
RhinoScriptSyntax.ViewRadius(view, radius, ?mode)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
radius : float
-
(float) The view radius
?mode : bool
-
(bool) Optional, default value: false. Perform a "dolly" magnification by moving the camera
towards/away from the target so that the amount of the screen
subtended by an object changes. true = perform a "zoom"
magnification by adjusting the "lens" angle
|
Sets the radius of a parallel-projected view. Useful when you need an absolute zoom factor for a parallel-projected view.
|
Full Usage:
RhinoScriptSyntax.ViewRadius(view)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
Returns: float
(float) The current view radius for the specified view.
|
Returns the radius of a parallel-projected view. Useful when you need an absolute zoom factor for a parallel-projected view.
|
Full Usage:
RhinoScriptSyntax.ViewSize(?view)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
Returns: int * int
(int * int ) of two numbers identifying width and height.
|
Returns the width and height in pixels of the specified view.
|
Full Usage:
RhinoScriptSyntax.ViewSpeedTest(?view, ?frames, ?freeze, ?direction, ?angleDegrees)
Parameters:
string
-
(string) Optional, The title of the view. If omitted, the current active view is used
?frames : int
-
(int) Optional, default value: 100
The number of frames, or times to regenerate the view. If omitted, the view will be regenerated 100 times
?freeze : bool
-
(bool) Optional, default value: true
If True (Default), then Rhino's display list will not be updated with every frame redraw. If False, then Rhino's display list will be updated with every frame redraw
?direction : int
-
(int) Optional, default value: 0
The direction to rotate the view. The default direction is Right (0). Modes:
0 = Right
1 = Left
2 = Down
3 = Up
?angleDegrees : float
-
(float) Optional, default value: 5
The angle to rotate. If omitted, the rotation angle of 5.0 degrees will be used
Returns: float
(float) The number of seconds it took to regenerate the view frames number of times.
|
Test's Rhino's display performance.
|
Full Usage:
RhinoScriptSyntax.ViewTarget(view, target)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
target : Point3d
-
(Point3d) 3d point identifying the new target location
|
Sets the target location of the specified view.
|
Full Usage:
RhinoScriptSyntax.ViewTarget(view)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
Returns: Point3d
(Point3d) The current target location.
|
Returns the target location of the specified view.
|
Full Usage:
RhinoScriptSyntax.ViewTitle(viewId)
Parameters:
Guid
-
(Guid) The identifier of the view
Returns: string
(string) name or title of the view.
|
Returns the name, or title, of a given view's identifier.
|
Full Usage:
RhinoScriptSyntax.VisibleObjectsInView(?view, ?select, ?includeLights, ?includeGrips)
Parameters:
string
-
(string) Optional, The view to use. If omitted, the current active view is used
?select : bool
-
(bool) Optional, default value: false
Select the objects
?includeLights : bool
-
(bool) Optional, default value: false
Include light objects
?includeGrips : bool
-
(bool) Optional, default value: false
Include grip objects
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers of the visible objects.
|
Return identifiers of all objects that are visible in a specified view. This function is the same as rs.VisibleObjects in Rhino Python. use rs.ShownObjects to get all objects that are not hidden or on turned-off layers. .
|
Full Usage:
RhinoScriptSyntax.Wallpaper(view, filename)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
filename : string
-
(string) Name of the bitmap file to set as wallpaper
|
Sets the wallpaper bitmap of the specified view. To remove a wallpaper bitmap, pass an empty string "".
|
Full Usage:
RhinoScriptSyntax.Wallpaper(view)
Parameters:
string
Returns: string
(string option) The current wallpaper bitmap filename. Or an empty string if none found.
|
Returns the wallpaper bitmap of the specified view. To remove a (string) Title of the view. Use "" empty string for the current active view wallpaper bitmap, pass an empty string "".
|
Full Usage:
RhinoScriptSyntax.WallpaperGrayScale(view, grayscale)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
grayscale : bool
-
(bool) Display the wallpaper in gray(True) or color (False)
|
Sets the gray-scale display option of the wallpaper bitmap in a specified view.
|
Full Usage:
RhinoScriptSyntax.WallpaperGrayScale(view)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
Returns: bool
(bool) The current gray-scale display option.
|
Returns the gray-scale display option of the wallpaper bitmap in a specified view.
|
Full Usage:
RhinoScriptSyntax.WallpaperHidden(view, hidden)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
hidden : bool
-
(bool) Show or hide the wallpaper
|
Sets the visibility of the wallpaper bitmap in a specified view.
|
Full Usage:
RhinoScriptSyntax.WallpaperHidden(view)
Parameters:
string
-
(string) Title of the view. Use "" empty string for the current active view
Returns: bool
(bool) The current hidden state.
|
Returns the visibility of the wallpaper bitmap in a specified view.
|
Full Usage:
RhinoScriptSyntax.WindowHandle()
Returns: IntPtr
(IntPtr) The Window's handle of Rhino's main window. IntPtr is a platform-specific type that is used to represent a pointer or a handle.
|
Returns the windows handle of Rhino's main window.
|
Full Usage:
RhinoScriptSyntax.WindowPick(corner1, corner2, ?view, ?select, ?inWindow)
Parameters:
Point3d
-
(Point3d) Corner1 of selection window
corner2 : Point3d
-
(Point3d) Corner2 of selection window
?view : string
-
(string) Optional, View to perform the selection in
?select : bool
-
(bool) Optional, default value: false
Select picked objects
?inWindow : bool
-
(bool) Optional, default value: true
If False, then a crossing window selection is performed
Returns: ResizeArray<Guid>
(Guid ResizeArray) identifiers of selected objects.
|
Picks objects using either a window or crossing selection.
|
Full Usage:
RhinoScriptSyntax.WorkingFolder(folder)
Parameters:
string
-
(string) The new working folder for the current Rhino session
|
Sets Rhino's working folder (directory). The working folder is the default folder for all file operations.
|
Full Usage:
RhinoScriptSyntax.WorkingFolder()
Returns: string
(string) The current working folder.
|
Returns Rhino's working folder (directory). The working folder is the default folder for all file operations.
|
|
Returns Rhino's world XY Plane.
|
|
Returns Rhino's world YZ Plane.
|
|
Returns Rhino's world ZX Plane.
|
|
|
Full Usage:
RhinoScriptSyntax.XformChangeBasis2(x0, y0, z0, x1, y1, z1)
Parameters:
Vector3d
-
(Vector3d) X of initial basis
y0 : Vector3d
-
(Vector3d) Y of initial basis
z0 : Vector3d
-
(Vector3d) Z of initial basis
x1 : Vector3d
-
(Vector3d) X of final basis
y1 : Vector3d
-
(Vector3d) Y of final basis
z1 : Vector3d
-
(Vector3d) Z of final basis
Returns: Transform
(Transform) The 4x4 transformation matrix.
|
Returns a change of basis transformation matrix or None on error.
|
|
|
Full Usage:
RhinoScriptSyntax.XformDeterminant(xForm)
Parameters:
Transform
-
(Transform) Rhino.Geometry.Transform. A 4x4 transformation matrix
Returns: float
(float) The determinant.
|
Returns the determinant of a transformation matrix. If the determinant of a transformation matrix is 0, the matrix is said to be singular. Singular matrices do not have inverses.
|
Full Usage:
RhinoScriptSyntax.XformDiagonal(diagonalValue)
Parameters:
float
-
(float) The diagonal value
Returns: Transform
(Transform) The 4x4 transformation matrix.
|
Returns a diagonal transformation matrix. Diagonal matrices are 3x3 with the bottom row [0, 0, 0, 1].
|
Full Usage:
RhinoScriptSyntax.XformIdentity()
Returns: Transform
(Transform) The 4x4 transformation matrix.
|
returns the identity transformation matrix.
|
|
|
Full Usage:
RhinoScriptSyntax.XformMirror(mirrorPlanePoint, mirrorPlaneNormal)
Parameters:
Point3d
-
(Point3d) Point on the mirror Plane
mirrorPlaneNormal : Vector3d
-
(Vector3d) A 3D vector that is normal to the mirror Plane
Returns: Transform
(Transform) mirror Transform matrix.
|
|
Full Usage:
RhinoScriptSyntax.XformMultiply(xForm1, xForm2)
Parameters:
Transform
-
(Transform) Rhino.Geometry.Transform. The first 4x4 transformation matrix to multiply
xForm2 : Transform
-
(Transform) Rhino.Geometry.Transform. The second 4x4 transformation matrix to multiply
Returns: Transform
(Transform) result transformation.
|
Multiplies two transformation matrices, where result = xForm1 * xForm2.
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.XformRotation2(angleDegrees, rotationAxis, centerPoint)
Parameters:
float
-
(float) Rotation angle in degrees
rotationAxis : Vector3d
-
(Vector3d) Rotation axis
centerPoint : Point3d
-
(Point3d) Rotation center
Returns: Transform
(Transform) The 4x4 transformation matrix.
|
|
Full Usage:
RhinoScriptSyntax.XformRotation3(startDirection, endDirection, centerPoint)
Parameters:
Vector3d
-
(Vector3d) Start direction
endDirection : Vector3d
-
(Vector3d) End direction
centerPoint : Point3d
-
(Point3d) The rotation center
Returns: Transform
(Transform) The 4x4 transformation matrix.
|
Calculate the minimal transformation that rotates startDirection to endDirection while fixing centerPoint.
|
Full Usage:
RhinoScriptSyntax.XformRotation4(x0, y0, z0, x1, y1, z1)
Parameters:
Vector3d
-
(Vector3d) X of Vector defining the initial orthonormal frame
y0 : Vector3d
-
(Vector3d) Y of Vector defining the initial orthonormal frame
z0 : Vector3d
-
(Vector3d) Z of Vector defining the initial orthonormal frame
x1 : Vector3d
-
(Vector3d) X of Vector defining the final orthonormal frame
y1 : Vector3d
-
(Vector3d) Y of Vector defining the final orthonormal frame
z1 : Vector3d
-
(Vector3d) Z of Vector defining the final orthonormal frame
Returns: Transform
(Transform) The 4x4 transformation matrix.
|
Returns a rotation transformation.
|
|
|
Full Usage:
RhinoScriptSyntax.XformScale(scaleX, scaleY, scaleZ, plane)
Parameters:
float
-
(float) Scale in the X direction of the Plane
scaleY : float
-
(float) Scale in the Y direction of the Plane
scaleZ : float
-
(float) Scale in the Z direction of the Plane
plane : Plane
-
(Plane) The Plane, its origin is the center of scale
Returns: Transform
(Transform) The 4x4 transformation matrix.
|
Creates a scale transformation about the origin of a Plane and along the Plane's axes.
|
|
|
Full Usage:
RhinoScriptSyntax.XformScale(scale)
Parameters:
float
-
(float) Scale in X , Y and Z direction
Returns: Transform
(Transform) The 4x4 transformation matrix.
|
Creates a scale transformation based on World Origin point.
|
Full Usage:
RhinoScriptSyntax.XformScale(scaleX, scaleY, scaleZ, point)
Parameters:
float
-
(float) Scale in X direction
scaleY : float
-
(float) Scale in Y direction
scaleZ : float
-
(float) Scale in Z direction
point : Point3d
-
(Point3d) Center of scale
Returns: Transform
(Transform) The 4x4 transformation matrix.
|
|
Full Usage:
RhinoScriptSyntax.XformScreenToWorld(point, ?view, ?screenCoordinates)
Parameters:
Point3d
-
(Point3d) 2D point
?view : string
-
(string) Optional, Title of a view. If omitted, the active view is used
?screenCoordinates : bool
-
(bool) Optional, default value: false
If False, point is in client-area coordinates. If True,
point is in screen-area coordinates
Returns: Point3d
(Point3d) The transformedPoint.
|
Transforms a point from either client-area coordinates of the specified view or screen coordinates to world coordinates. The resulting coordinates are represented as a 3-D point.
|
Full Usage:
RhinoScriptSyntax.XformShear(plane, x, y, z)
Parameters:
Plane
-
(Plane) Plane.Origin is the fixed point
x : Vector3d
-
(Vector3d) X axis scale vector
y : Vector3d
-
(Vector3d) Y axis scale vector
z : Vector3d
-
(Vector3d) Z axis scale vector
Returns: Transform
(Transform) The 4x4 transformation matrix.
|
|
|
|
|
|
Full Usage:
RhinoScriptSyntax.XformWorldToScreen(point, ?view, ?screenCoordinates)
Parameters:
Point3d
-
(Point3d) 3D point in world coordinates
?view : string
-
(string) Optional, Title of a view. If omitted, the active view is used
?screenCoordinates : bool
-
(bool) Optional, default value: false
If False, the function returns the results as
client-area coordinates. If True, the result is in screen-area coordinates
Returns: Point2d
(Point2d) 2D point.
|
Transforms a point from world coordinates to either client-area coordinates of the specified view or screen coordinates. The resulting coordinates are represented as a 2D point.
|
Full Usage:
RhinoScriptSyntax.XformZero()
Returns: Transform
(Transform) A zero transformation matrix.
|
Returns a zero transformation matrix.
|
Full Usage:
RhinoScriptSyntax.ZoomBoundingBox(boundingBox, ?view, ?all)
Parameters:
BoundingBox
-
(Geometry.BoundingBox) a BoundingBox class instance
?view : string
-
(string) Optional, Title of the view. If omitted, current active view is used
?all : bool
-
(bool) Optional, default value: false
Zoom extents in all views
|
Zooms to the extents of a specified bounding box in the specified view.
|
Full Usage:
RhinoScriptSyntax.ZoomExtents(?view, ?all)
Parameters:
string
-
(string) Optional, Title of the view. If omitted, current active view is used
?all : bool
-
(bool) Optional, default value: false
Zoom extents in all views
|
Zooms to extents of visible objects in the specified view.
|
Full Usage:
RhinoScriptSyntax.ZoomSelected(?view, ?all)
Parameters:
string
-
(string) Optional, Title of the view. If omitted, active view is used
?all : bool
-
(bool) Optional, default value: false
Zoom extents in all views
|
Zoom to extents of selected objects in a view.
|
Rhino.Scripting