Use scripting

Scripting extends Rhino functionality.

All Rhino commands can be used in command macros. Command macros can be run by typing the command at the command prompt, from toolbar buttons, shortcut keys, command aliases, from the ReadCommandFile command, or using the Paste command into Rhino's command stream.

Some commands are provided to facilitate scripting actions usually performed through the Rhino interface.

Specialized commands for scripting

Action

Cancel

Cancel the current command and deselects objects.

Delete

Removes objects or sub-objects.

Echo

Turn on echoing of script commands to the command history window.

EditPythonScript

Edit a Python script.

Enter

Simulate the Enter key in a script.

EnterEnd

Simulate the Enter key to complete a command string in a script.

GetDocumentUserText

Retrieve text information attached to a file with the SetDocumentUserText command.

GetUserText

Retrieve text information attached to an object using the SetUserText command.

MacroEditor

Open an edit window for script creation and testing.

NoEcho

Turn off echoing of script commands to the command history window.

Pause

Stop a script for user input.

ReadCommandFile

Read and execute a command script from a text file.

RunPythonScript

Run a Python script.

SetDisplayMode

Specify a viewport display mode.

SetDocumentUserText

Attach text information to the file.

SetObjectName

Assign a name to an object.

SetRedrawOff

Disable screen redraw, construction plane, and view changes during scripts.

SetRedrawOn

Enable screen redraw, construction plane, and view changes during scripts.

SetUserText

Attach text information to an object.

Interface

ClearUndo

Clear the undo buffer to free memory.

CloseRenderWindow

Close the render display window.

CopyRenderWindowToClipboard

Copy the image in the render window to the Clipboard.

DocumentPropertiesPage

Open the Document Properties dialog box at the specified page.

Exit

Close Rhino.

Maximize

Maximize the Rhino model window.

MaxViewport

Maximize the active viewport.

NewFloatingViewport

Create a new free-floating viewport.

NextOrthoViewport

Activate the next viewport with an orthogonal projection.

NextPerspectiveViewport

Activate the next viewport with a perspective projection.

NextViewport

Activate the next viewport.

Ortho

Restrict cursor movement to an angle.

OrthoAngle

Set the angle for cursor ortho movement.

PrevViewport

Activate the previous viewport.

PropertiesPage

Open the Properties panel at a specified page.

SetActiveViewport

Activate a named viewport.

SetMaximizedViewport

Maximize a named viewport inside the application window.

SetOrtho

Turn ortho mode on, off, or toggle the current state.

SetPlanar

Turn Planar mode on, off, or toggle the current state.

SetSnap

Turn grid snap on, off, or toggle the current state.

ShowOsnap

Show the OSnap panel.

Snap

Toggle the current snap mode state.

SnapSize

Specify the grid snap spacing.

Import/Export

ComputeVertexColors

Evaluate texture coordinates and set vertex colors.

See also

Command Macros and Scripting