guides.md

layout	title	description	permalink	order
toc-page	Guides	All the guides available for developing for Rhino or Grasshopper.	/guides/	2

Guides

---

[General]({{ site.baseurl }}/guides/general)

{: #general }

Guides that apply across platforms and SDKs

Overview

• [Developing Software In Public]({{ site.baseurl }}/guides/general/developing-software-in-public)
• [Rhino Technology Overview]({{ site.baseurl }}/guides/general/rhino-technology-overview)
• [Frequently Asked Questions (FAQ)]({{ site.baseurl }}/guides/general/frequently-asked-questions)

Getting Started

• [Developer Prerequisites]({{ site.baseurl }}/guides/general/rhino-developer-prerequisites)
• [Developer Training]({{ site.baseurl }}/guides/general/developer-training)
• [Contributing]({{ site.baseurl }}/guides/general/contributing)

Fundamentals

• [What is a Rhino Plugin?]({{ site.baseurl }}/guides/general/what-is-a-rhino-plugin)
• [Rhino Installer Engine]({{ site.baseurl }}/guides/general/rhino-installer-engine)
• [Simple Command Macros]({{ site.baseurl }}/guides/general/creating-command-macros/)

[Essential Mathematics]({{ site.baseurl }}/guides/general/essential-mathematics)

• [Introduction]({{ site.baseurl }}/guides/general/essential-mathematics)
• [Vector Mathematics]({{ site.baseurl }}/guides/general/essential-mathematics/vector-mathematics)
• [Matrices and Transformations]({{ site.baseurl }}/guides/general/essential-mathematics/matrices-transformations)
• [Parametric Curves and Surfaces]({{ site.baseurl }}/guides/general/essential-mathematics/parametric-curves-surfaces)
• Download Essential Mathematics for Computational Design as a single PDF

This Site

• [How This Site Works]({{ site.baseurl }}/guides/general/how-this-site-works)
• [Getting Started with Developer Docs](https://github.com/mcneel/developer-rhino3d-com/blob/{{ site.git_branch | default: "master" }}/README.md)
• [Developer Docs Style Guide]({{ site.baseurl }}/guides/general/developer-docs-style-guide)

---

[RhinoCommon]({{ site.baseurl }}/guides/rhinocommon)

{: #rhinocommon }

The cross-platform .NET plugin SDK for Rhino.

Overview

• [What is RhinoCommon?]({{ site.baseurl }}/guides/rhinocommon/what-is-rhinocommon/)
• [What are Mono & Xamarin?]({{ site.baseurl }}/guides/rhinocommon/what-are-mono-and-xamarin/)
• [What's New/Changes?]({{ site.baseurl }}/guides/rhinocommon/whats-new/)

Getting Started

• Installing Tools ([Windows]({{ site.baseurl }}/guides/rhinocommon/installing-tools-windows/), [Mac]({{ site.baseurl }}/guides/rhinocommon/installing-tools-mac/))
• Your First Plugin ([Windows]({{ site.baseurl }}/guides/rhinocommon/your-first-plugin-windows/), [Mac]({{ site.baseurl }}/guides/rhinocommon/your-first-plugin-mac/), [Cross-Platform]({{ site.baseurl }}/guides/rhinocommon/your-first-plugin-crossplatform/))
• Plugin Installers ([Windows]({{ site.baseurl }}/guides/rhinocommon/plugin-installers-windows/), [Mac]({{ site.baseurl }}/guides/rhinocommon/plugin-installers-mac/))

Fundamentals

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'RhinoCommon' and guide.categories contains 'Fundamentals' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Rendering

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'RhinoCommon' and guide.categories contains 'Rendering' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Advanced

{% assign guides = site.guide_topics | sort:"order" %}

• API Reference
• Eto.Forms guides
{% for guide in guides %} {% if guide.sdk contains 'RhinoCommon' and guide.categories contains 'Advanced' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Zoo

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'RhinoCommon' and guide.categories contains 'Zoo' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Cloud Zoo

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'RhinoCommon' and guide.categories contains 'CloudZoo' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

---

[Rhino.Python]({{ site.baseurl }}/guides/rhinopython)

{: #rhinopython }

Quickly add functionality to Rhino or automate repetitive tasks.

Overview

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'RhinoPython' and guide.categories contains 'Overview' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Getting Started

• Your First Python Script in Rhino ([Windows]({{ site.baseurl }}/guides/rhinopython/your-first-python-script-in-rhino-windows), [Mac]({{ site.baseurl }}/guides/rhinopython/your-first-python-script-in-rhino-mac), [Grasshopper]({{ site.baseurl }}/guides/rhinopython/your-first-python-script-in-grasshopper))
• [Where to get help...]({{ site.baseurl }}/guides/rhinopython/python-where-to-find-help)
• [Troubleshooting Installation]({{ site.baseurl }}/guides/rhinopython/python-troubleshooting-install)

Python Editor for Windows

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'RhinoPython' and guide.categories contains 'Python Windows' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Python in Grasshopper

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'RhinoPython' and guide.categories contains 'GhPython' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Fundamentals

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'RhinoPython' and guide.categories contains 'Fundamentals' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Python in Rhino

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'RhinoPython' and guide.categories contains 'Python in Rhino' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

[Rhino.Python 101]({{ site.baseurl }}/guides/rhinopython/primer-101)

   [Introduction]({{ site.baseurl }}/guides/rhinopython/primer-101)
   [Where to find help]({{ site.baseurl }}/guides/rhinopython/primer-101/where-to-find-help/)
   1. [What's it all about?]({{ site.baseurl }}/guides/rhinopython/primer-101/1-whats-it-all-about/)
   2. [Python Essentials]({{ site.baseurl }}/guides/rhinopython/primer-101/2-python-essentials/)
   3. [Script anatomy]({{ site.baseurl }}/guides/rhinopython/primer-101/3-script-anatomy/)
   4. [Operators and functions]({{ site.baseurl }}/guides/rhinopython/primer-101/4-operators-and-functions/)
   5. [Conditional execution]({{ site.baseurl }}/guides/rhinopython/primer-101/5-conditional-execution/)
   6. [Tuples, Lists and Dictionaries]({{ site.baseurl }}/guides/rhinopython/primer-101/6-tuples-lists-dictionaries/)
   7. [Classes]({{ site.baseurl }}/guides/rhinopython/primer-101/7-classes/)
   8. [Geometry]({{ site.baseurl }}/guides/rhinopython/primer-101/8-geometry/)

   Download the Rhino.Python 101 Primer as a single PDF

Intermediate

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'RhinoPython' and guide.categories contains 'Intermediate' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Custom Dialogs in Eto

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'RhinoPython' and guide.categories contains 'Eto' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Other Resources

• Rhino Scripting Forum (Discourse)
• [Rhino.Python Samples]({{ site.baseurl }}/samples/#rhinopython)
• [Rhino.Python Developer Samples GitHub](https://github.com/mcneel/rhino-developer-samples/tree/{{ site.git_branch | default: "master" }}/rhinopython)
• Designalyze Python Tutorials
• Plethora Project
• Steve Baer's Blog
• Python Beginner's Guide
• Tutorials Point Python Series
• Rhino.Python Dash Docset
• Nature of Code Video Tutorials

---

[openNURBS]({{ site.baseurl }}/guides/opennurbs)

{: #opennurbs }

Read/Write Rhino 3dm files in your application.

Overview

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'openNURBS' and guide.categories contains 'Overview' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Getting Started

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'openNURBS' and guide.categories contains 'Getting Started' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Fundamentals

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'openNURBS' and guide.categories contains 'Fundamentals' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Advanced

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'openNURBS' and guide.categories contains 'Advanced' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

---

[C/C++]({{ site.baseurl }}/guides/cpp)

{: #cpp }

Native SDK for Rhino for Windows plugins.

Overview

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'C/C++' and guide.categories contains 'Overview' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Getting Started

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'C/C++' and guide.categories contains 'Getting Started' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Fundamentals

{% assign guides = site.guide_topics | sort:"title" %}

{% for guide in guides %} {% if guide.sdk contains 'C/C++' and guide.categories contains 'Fundamentals' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Advanced

{% assign guides = site.guide_topics | sort:"title" %}

{% for guide in guides %} {% if guide.sdk contains 'C/C++' and guide.categories contains 'Advanced' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Rendering (RDK)

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'C/C++' and guide.categories contains 'RDK' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Zoo

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'C/C++' and guide.categories contains 'Zoo' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Troubleshooting

{% assign guides = site.guide_topics | sort:"title" %}

{% for guide in guides %} {% if guide.sdk contains 'C/C++' and guide.categories contains 'Troubleshooting' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

---

[Grasshopper]({{ site.baseurl }}/guides/grasshopper)

{: #grasshopper }

Create custom Grasshopper components and plugins.

Overview

• [What is a Grasshopper Component?]({{ site.baseurl }}/guides/grasshopper/what-is-a-grasshopper-component/)

Getting Started

• Installing Tools ([Windows]({{ site.baseurl }}/guides/grasshopper/installing-tools-windows/), [Mac]({{ site.baseurl }}/guides/grasshopper/installing-tools-mac/))
• Your First Component ([Windows]({{ site.baseurl }}/guides/grasshopper/your-first-component-windows/), [Mac]({{ site.baseurl }}/guides/grasshopper/your-first-component-mac/))

Fundamentals

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'Grasshopper' and guide.categories contains 'Fundamentals' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Advanced

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'Grasshopper' and guide.categories contains 'Advanced' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

In Depth

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'Grasshopper' and guide.categories contains 'In Depth' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

---

[RhinoScript]({{ site.baseurl }}/guides/rhinoscript)

{: #rhinoscript }

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

Overview

• [What are VBScript and RhinoScript?]({{ site.baseurl }}/guides/rhinoscript/what-are-vbscript-rhinoscript)

[RhinoScript 101]({{ site.baseurl }}/guides/rhinoscript/primer-101)

   [Introduction]({{ site.baseurl }}/guides/rhinoscript/primer-101)
   [Where to find help]({{ site.baseurl }}/guides/rhinoscript/primer-101/where-to-find-help/)
   1. [What's it all about?]({{ site.baseurl }}/guides/rhinoscript/primer-101/1-whats-it-all-about/)
   2. [RhinoScript Essentials]({{ site.baseurl }}/guides/rhinoscript/primer-101/2-vbscript-essentials/)
   3. [Script anatomy]({{ site.baseurl }}/guides/rhinoscript/primer-101/3-script-anatomy/)
   4. [Operators and functions]({{ site.baseurl }}/guides/rhinoscript/primer-101/4-operators-and-functions/)
   5. [Conditional execution]({{ site.baseurl }}/guides/rhinoscript/primer-101/5-conditional-execution/)
   6. [Arrays]({{ site.baseurl }}/guides/rhinoscript/primer-101/6-arrays/)
   7. [Geometry]({{ site.baseurl }}/guides/rhinoscript/primer-101/7-geometry/)
   Download the RhinoScript 101 Primer as a single PDF

Fundamentals

{% assign guides = site.guide_topics | sort:"order" %}

{% for guide in guides %} {% if guide.sdk contains 'RhinoScript' and guide.categories contains 'Fundamentals' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Intermediate

{% assign guides = site.guide_topics | sort:"title" %}

{% for guide in guides %} {% if guide.sdk contains 'RhinoScript' and guide.categories contains 'Intermediate' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Advanced

{% assign guides = site.guide_topics | sort:"title" %}

{% for guide in guides %} {% if guide.sdk contains 'RhinoScript' and guide.categories contains 'Advanced' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Troubleshooting

{% assign guides = site.guide_topics | sort:"title" %}

{% for guide in guides %} {% if guide.sdk contains 'RhinoScript' and guide.categories contains 'Troubleshooting' %} {% if guide.title and guide.order %}
• {{ guide.title }}
{% endif %} {% endif %} {% endfor %}

Other Resources

• Pascal Golay's scripted utilities for Rhino
• RhinoScript Samples on GitHub
• RhinoScript Dash Docset
• RhinoScript Help File On-Line

---

[RhinoMobile]({{ site.baseurl }}/guides/rhinomobile)

{: #rhinomobile }

3D mobile application development.

Overview

• [What is RhinoMobile?]({{ site.baseurl }}/guides/rhinomobile/what-is-rhinomobile/)

Getting Started

• Installing Tools ([Windows]({{ site.baseurl }}/guides/rhinomobile/installing-tools-windows/), [Mac]({{ site.baseurl }}/guides/rhinomobile/installing-tools-mac/))
• Your First App ([Windows]({{ site.baseurl }}/guides/rhinomobile/your-first-app-windows/), [Mac]({{ site.baseurl }}/guides/rhinomobile/your-first-app-mac/))

Fundamentals

• [Using Simulators]({{ site.baseurl }}/guides/rhinomobile/using-simulators/)
• [Testing On Devices]({{ site.baseurl }}/guides/rhinomobile/testing-on-devices/)

---

Developer Services

{: #services }

Localization

Our regional office in Europe provides a translation and localization service for third-party developers and anyone else interested in translating their products to French, German, Italian, Spanish, etc. Details…

Marketing Support

If you have developed a Rhino add-on that you would like to make available to other Rhino users, food4Rhino is the place to post the details about your plug-ins for Rhino and Grasshopper. Food4Rhino is the Plug-in Community Service by McNeel. Users can find the newest Rhino Plug-ins, Grasshopper Add-ons, Materials, Textures and Backgrounds, Scripts and much more. It is free. See the frequently asked questions...