RhinoScript Labs

SummaryUpdates to RhinoScript for Rhino 4.0 SR3.

UpdatedJune 20, 2008

Overview

RhinoScript is a scripting language based on Microsoft's VBScript language. With RhinoScript, you can quickly add functionality to Rhino, or automate repetitive tasks.

The Labs version of RhinoScript contains additions and modifications to the version of RhinoScript included with Rhino 4.0 SR3.

What's New?

New Methods

AddSweep1 - Adds a surface created through profile curves that define the surface shape and one curve that defines a surface edge.
AddSweep2 - Adds a surface created through profile curves that define the surface shape and two curves that define the surface edges.
ColorAdjustLuma - Changes the luminance of an RGB value.
ColorBlueValue - Retrieves an intensity value for the blue component of a red-green-blue (RGB) value.
ColorGreenValue - Retrieves an intensity value for the green component of a red-green-blue (RGB) value.
ColorHLSToRGB - Converts colors from hue-luminance-saturation (HLS) to RGB format.
ColorRedValue - Retrieves an intensity value for the red component of a red-green-blue (RGB) value.
ColorRGBToHLS - Converts colors from RGB to hue-luminance-saturation (HLS) format.
CurveClosestObject - Returns the locations on two objects where they are closest to each other.
DisplayOleAlerts - Enables or disables the display of OLE "busy" and "not responding" dialog boxes.
FlashObject - Flashes one or more objects.
HideGroup - Hides a group of visible objects.
IsCone - Determines if a surface is a portion of a cone.
IsCylinder - Determines if a surface is a portion of a cylinder.
IsParameterOnSurface - Verifies that a parameter space point is on a trimmed surface.
IsSphere - Determines if a surface is a portion of a sphere.
IsTorus - Determines if a surface is a portion of a torus.
LeaderText - Returns or modifies a leader object's text string.
LockGroup - Locks a group of visible objects.
MakeArray - Creates a new, initialized array of a user-specified bounds.
ProjectCurveToSurface - Projects one or more curves onto one or more surfaces or polysurfaces.
ProjectPointToSurface - Projects one or more points onto one or more surfaces or polysurfaces.
ShowGroup - Shows a group of hidden objects.
SurfaceCone - Returns the definition of a cone.
SurfaceCylinder - Returns the definition of a cylinder.
SurfaceSphere - Returns the definition of a sphere.
SurfaceTorus - Returns the definition of a torus.
UnitScale - Returns the scale factor for changing unit systems.
UnlockGroup - Unlocks a group of locked objects.

Changed Methods

AddCone - Additional argument and override added.
AddCylinder - Additional argument and override added.
AddHatch - Fixed a crash bug.
AddLeader - Additional argument added.
AddTorus - Additional override added.
CopyObject - Now creates in-place copy of starting and ending points are coincident. Also, method now accepts 3-D translation vector.
CopyObjects - Now creates in-place copies of starting and ending points are coincident. Also, method now accepts 3-D translation vector.
Distance - Additional override added.
DivideCurve - Additional argument added.
DivideCurveLength - Additional argument added.
GetPointOnMesh - Fixed bug in that the optional prompt was being ignored.
GetRectangle - Additional argument added.
HtmlBox - Fixed bug when passing statically declared arrays as argument.
LastCreatedObjects - Fixed bug where it would return too many objects.
LineLineIntersection - Additional argument added.
MaterialTexture - Path to texture bitmap file is no longer verified.
MoveObject - Method now accepts 3-D translation vector.
MoveObjects - Method now accepts 3-D translation vector.
PopupMenu - Fixed bug in return value when menu separators were added.
RectangularLightPlane - Small tune-up.
SplitCurve - Additional override added.
SortStrings - Additional argument added.

Changed Commands

EditScript - Window now forced on the screen if a monitor or display resolution setting change is detected.

Installation

Make sure you are running Rhino 4.0 SR3.
Close all open copies of Rhino 4.0.
In the \Program Files\Rhinoceros 4.0\Plug-ins folder, backup the following files:

Contents