Your First Python Script in Rhino (Windows)

This guide demonstrates how to create Python scripts in Rhino for Windows.

You will learn how to display a message box in Rhino that says “Hello World.” It covers the most basic concepts for editing, loading, and running scripts.

The Complete Script

import rhinoscriptsyntax as rs

rs.MessageBox ("Hello World")

To test the Script:

  • Start Rhino
  • At the command prompt, type EditScript and press Enter.
  • The Edit Script dialog box appears.
  • In the script Code window, type the code sample above.
  • Click the “Run the script” button.
  • The Edit Script dialog box disappears, and the message below appears:

The HelloWorld Function

If you were writing a more complex script, and wanted to display “Hello World” at strategic points throughout the script, you could write this code every time you wanted the message to appear.

But if you changed your mind and wanted it to say “Howdy World” instead, you’d have to search for all the places “Hello World” was used, and replace them.

An easier way to solve this problem is to write a Function (def is used to define the function). At several places throughout your script, you call the function. The function handles displaying the message, so you only have to change the message in one place.

Here’s what the function definition looks like:

import rhinoscriptsyntax as rs

def HelloWorld()
    rs.MessageBox ("Hello World")

If you click the run button at this time nothing will happen. Nothing happened? That’s because the RhinoScript defined the Subroutine but did not actually call it. To call the subroutine, either add this line of code and click Run.

To call this function, simply add this to the bottom of the script:

HelloWorld()

In Python the functions definitions need to come before being called in the code.

Testing HelloWorld

  • At the command prompt, type EditScript and press Enter.
  • The Edit Script dialog box appears.
  • In the script Code window, type
import rhinoscriptsyntax as rs

def HelloWorld()
    rs.MessageBox ("Hello World")

HelloWorld()
  • Click the Run button.

When you do more than write a couple lines of script, it becomes necessary to save the script to a file so that you can run the script without typing it every time.

To save your script:

In the Edit Script dialog box, Click the Save button. Save the file as “Hello World.rvb”.

Running HelloWorld.rvb

  • At the Command prompt, type LoadScript and press Enter.
  • In the Load Scrip Filet dialog box, click Add…
  • Select “Hello World.rvb” and click Open.
  • In the Select Script File list, select “Hello World.rvb”.
  • Click Load.

Your script will run, and display the familiar “Hello World” dialog box.