What is a Rhino Plugin?
This guide outlines what a Rhino plugin is and what forms it comes in.
A Rhino plugin is a software module that extends the functionality of Rhino or Grasshopper by adding commands, features, or capabilities. A Rhino plugin is a Dynamic Link Library, or DLL.
On Windows, a Rhino plugin built with the C/C++ SDK is a regular DLL using shared MFC DLL.
On Windows and Mac, a Rhino plugin built with the RhinoCommon SDK is a .NET assembly.
Types of Plugins
Rhino supports five different types of plugins:
- General Utility: A general purpose utility that can contain one or more commands.
- File Import: Imports data from other file formats into Rhino; can support more that one format.
- File Export: Exports data from Rhino to other file formats; can support more than one format.
- Custom Rendering: Applies materials, textures, and lights to a scene to produce rendered images.
- 3D Digitizing: Interfaces with 3D digitizing devices, such as those made by MicroScribe, Faro, & Romer.
Note: File Import, File Export, Custom Rendering and 3D Digitizing plugins are all specialized enhancements to the General Utility plugin. Thus, all plugin types can contain one or more commands.
For Rhino to successfully load and run your plugin, several conditions must be met:
- The “RhinoSdkVersion” number of your plugin must match the “RhinoSdkVersion” of Rhino.
- The “RhinoSdkServiceRelease” number of Rhino must be greater than or equal to the “RhinoSdkServiceRelease” of your plugin.
We occasionally make changes to our SDKs. When we do, we change the “RhinoSdkServiceRelease” number.
As a plugin developer you are unlikely to encounter a problem with the first condition. This would occur, for instance, if a user tried to load a plugin built for Rhino 6 in Rhino 4.
You may however, occassionally encounter problems with the second condition. If you compiled your plugin using the 6.2 (RhinoSdkVersion.RhinoSdkServiceRelease) SDK and a user running a 6.1 Rhino tries to run it, they will get an error message and the plugin will refuse to load. If your customer gets this message, they need to get the latest Rhino (could be 6.2 or greater in this example) and that should resolve the problem.