What's New?



Your Ad Here

January 18, 2007

What's New in RhinoScript 4.0?

New Methods

 

Method

Description

AddAlias

Adds a command alias to Rhino.

AddArc

Adds an arc curve.

AddEllipse

Adds an elliptical curve.

AddEllipse3Pt

Adds a 3 point elliptical curve.

AddInterpCrvOnSrfUV

Adds an interpolated curve on a surface using surface uv coordinates.

AddPlaneSurface

Adds a plane surface.

AddStartupScript

Adds a startup script to RhinoScript.

AddSubCrv

Adds a new curve based on a portion of an existing curve.

AliasCount

Returns the number of command aliases.

AliasMacro

Returns or modifies the macro of a command alias.

AliasNames

Returns a list of all alias names.

AttributeDataCount

Returns the number of RhinoScript user data items stored on an object's attributes.

CapPlanarHoles

Cap planar holes in a surface or polysurface.

CompareGeometry

Determines if two objects are geometrically identical.

CurveArcLengthPoint

Returns an arc length point on a curve.

CurveArea

Returns the area of a closed planar curve.

CurveAreaCentroid

Returns the area centroid of a closed planar curve.

CurveDeviation

Returns the deviation between two curves.

CurveFrame

Returns a plane at a parameter.

CurvePerpFrame

Returns a perpendicular plane at a parameter.

CurvePlane

Returns the plane in which a planar curve lies.

DeleteAlias

Deletes a command alias from Rhino.

DeleteAttributeData

Removes RhinoScript user data stored on an object's attributes.

DeleteStartupScript

Removes a startup script to RhinoScript.

DimensionStyle

Returns or modifies the dimension style of a dimension object.

DimStyleLeaderArrowSize

Returns or changes the leader arrow size of a dimension style.

DisjointMeshCount

Returns the number of meshes that could be created by calling SplitDisjointMesh.

DistanceToPlane

Returns the distance from a plane to a point.

DuplicateEdgeCurves

Duplicates the edge curves of a surface or polysurface.

ExpandLayer

Expands or contracts a layer.

FairCurve

Fairs a curve object.

FlipSurface

Returns or modifies the normal direction of a surface.

GetAttributeData

Returns a RhinoScript user data item stored on an object's attributes.

GetBoolean

Displays boolean command-line option toggles.

GetLayer

Displays a layer selection dialog box.

GetLinetype

Displays a linetype selection dialog box.

GetPlugInObject

Returns a scriptable object from a plug-in.

GetPointCoordinates

Prompts the user to pick point objects, and returns their coordinates.

GetPrintWidth

Displays a print width selection dialog.

InsertBlock

Inserts a block whose definition already exists in the document.

IsAlias

Verifies that a command alias exists.

IsAttributeData

Verifies that an object's attributes contains RhinoScript user data.

IsLayerChildOf

Verifies a layer is a child of another layer.

IsLayerExpanded

Verifies a layer is expanded.

IsLayerParentOf

Verifies a layer is a parent of another layer.

IsLinetype

Verifies a linetype exists.

IsLinetypeReference

Verifies a linetype is reference.

IsOrdinateDimension

Verifies an object is an ordinate dimension.

IsPlaneSurface

Verifies an object is a plane surface.

IsToolbarDocked

Verifies a visible toolbar is docked.

IsVectorParallelTo

Compares two vectors to see if they are parallel.

IsVectorPerpendicularTo

Compares two vectors to see if they are perpendicular.

IsVectorTiny

Verifies a vector is tiny.

IsVectorZero

Verifies a vector is zero.

LayerChildCount

Returns the number of child layers of a layer.

LayerChildren

Returns the names of a layer's child layers.

LayerLinetype

Returns or changes a layer's linetype.

LayerLocked

Returns or changes a layer's locked property.

LayerPrintColor

Returns or changes a layer's print color.

LayerPrintWidth

Returns or changes a layer's print width.

LayerVisible

Returns or changes a layer's visibility property.

LinetypeCount

Returns the number of linetypes.

LinetypeNames

Returns the names of all linetypes.

MeshHasFaceNormals

Verifies a mesh object has face normals.

MeshHasTextureCoordinates

Verifies a mesh object has texture coordinates.

MeshHasVertexColors

Verifies a mesh object has vertex colors.

MeshHasVertexNormals

Verifies a mesh object has vertex normals.

MeshOffset

Offsets a mesh object.

MeshVertexColors

Returns or modifies the vertex colors of a mesh object.

MovePlane

Moves the origin of a plane.

ObjectDump

Returns a detailed description of the object.

ObjectLinetype

Returns or changes an object's linetype.

ObjectLinetypeSource

Returns or changes an object's linetype source.

ObjectNames

Returns or changes the names of one or more objects.

OffsetCurve

Offsets a curve.

OffsetSurface

Offsets a surface.

ParentLayer

Returns a layer's parent layer.

PI

Returns the PI constant.

PlaneClosestPoint

Returns the closest point on a plane from a point.

PlaneEquation

Returns the equation of a plane.

PlaneFromFrame

Creates a plane from an origin point, x-axis direction, and y-axis direction.

PlaneFromNormal

Creates a plane from an origin point, and a normal direction.

PlaneFromPoints

Creates a plane from three non-colinear points.

PointAdd

Adds a point or a vector to a point.

PointCompare

Compares two points.

PointDivide

Divides a point by a value.

PointScale

Scales a point by a value.

PointSubtract

Subtracts a point or a vector from a point.

PointTransform

Transforms a point.

Polar

Returns the 3D point that is a specified angle and distance from a 3D point.

PullCurveToMesh

Pulls a curve object to a mesh object.

PullPoints

Pulls an array of points to a surface or mesh object.

RemapObject

Remaps an object to a different coordinate system.

RemapObjects

Remaps one or more objects to a different coordinate system.

RotatePlane

Rotates a plane.

RotateView

Rotates a view by an angle.

SetAttributeData

Adds or sets a RhinoScript user data item stored on an object's attributes.

ShortPath

Creates the shortest possible curve (geodesic) between two points on a surface.

ShrinkTrimmedSurface

Shrinks a surfaces or polysurfaces underlying untrimmed surfaces near to trimming boundaries.

SimplifyArray

Converts an array of 3D ponts into a single-dimensional array.

SortPointList

Sorts an array of 3D points.

SortStrings

Sorts an array of strings.

SplitBrep

Splits a brep with another brep.

SplitDisjointMesh

Splits up a mesh object into its unconnected pieces.

StartupScriptCount

Returns the number of startup scripts.

StartupScriptList

Return the list of startup script files.

SurfaceCurvatureAnalysis

Returns the curvature of a surface.

SurfaceFrame

Returns the plane, or frame, of a surface at a U,V parameter.

SurfacePrincipalCurvature

Adds curvature curves at the evaluated point on a surface.

ToDegrees

Converts an angle in radians to degrees.

ToRadians

Converts an angle in degrees to radians.

UnifyMeshNormals

Fixes inconsistencies in the directions of faces of a mesh object.

VectorAdd

Adds two vectors.

VectorCompare

Compares two vectors.

VectorCreate

Creates a vector from two 3D points.

VectorCrossProduct

Returns the cross product of two vectors.

VectorDivide

Divides a vector.

VectorDotProduct

Returns the dot product of two vectors.

VectorLength

Returns the length of a vector.

VectorMultiply

Multiplies two vectors.

VectorReverse

Reverses a vector.

VectorRotate

Rotates a vector.

VectorScale

Scales a vector.

VectorSubtract

Subtracts two vectors.

VectorUnitize

Unitizes, or normalizes, a vector.

WorldXYPlane

Returns Rhino's world XY plane.

WorldYZPlane

Returns Rhino's world YZ plane.

WorldZXPlane

Returns Rhino's world ZX plane.

 

Changed Methods

Globally changed the way planes are handled. Planes are now represented as an array of four items: the plane's origin (3D point), the plane's X axis direction (3D vector), the plane's Y axis direction (3D vector) and the plane's Z axis direction (3D vector). In Rhino 3.0 planes were represented as an array of four 3D points: the plane's origin, a point on the plane's X axis, a point on the plane's Y axis, and a point on the plane's Z axis. For more information, see RhinoScript Fundamentals.

 

Method

Changes

AddCircle

The method has changed.

AddLayer

Additional, optional argument added.

AddLeader

The method has changed.

AddMesh

Additional, optional argument added.

CurveDirectionsMatch

Now supports both open and closed curves.

CurveFilletPoints

Modified to reflect change in plane representation.

CurveTangent

Modified to reflect change in plane representation.

IsCurveInPlane

Modified to reflect change in plane representation.

DeleteLayer

The return value has changed.

GetPointOnSurface

Now works with both surfaces and polysurfaces.

HtmlBox

Additional, optional argument added.

MeshContourPoints

The return value has changed.

NamedCPlane

Modified to reflect change in plane representation.

PlanarClosedCurveContainment

Modified to reflect change in plane representation.

PlanarCurveCollision

Modified to reflect change in plane representation.

PointInPlanarClosedCurve

Modified to reflect change in plane representation.

RotateObject

Modified to reflect change in plane representation.

RotateObjects

Modified to reflect change in plane representation.

Sort

Renamed to SortStrings.

SurfaceContourPoints

The return value has changed.

SurfaceNormal

Modified to reflect change in plane representation.

TextObjectPlane

Modified to reflect change in plane representation.

ViewCPlane

Modified to reflect change in plane representation.

XformCPlaneToWorld

Modified to reflect change in plane representation.

XformWorldToCPlane

Modified to reflect change in plane representation.

 

Return to Rhino Index


Your Ad Here