Site Tools


Sidebar

Registering Plug-ins for Rhino 5

Developer: C++, .NET
Summary: Step-by-step instructions for registering your plug-in.
Note: To register plug-ins for Rhino 4, view this article.

Overview

While a Rhino plug-in can simply be distributed as an RHP file, and loaded using Rhino's PlugInManager command, it is often necessary to install the plug-in as part of a product installation process. To install plug-ins from an installer, your installer will be required to access a number of entries in the Windows Registry.

While reading this article, it is helpful to use the standard Windows Registry editing tool, REGEDIT.EXE, to follow along and see how Rhino's Registry entries are structured.

Finding the Rhino Registry Key

Rhino plug-ins are registered in the following locations in the Windows Registry:

On 32-bit Windows

Rhino 5 32-bit

HKEY_LOCAL_MACHINE\Software\McNeel\Rhinoceros\5.0\Plug-ins

On 64-bit Windows

Rhino 5 64-bit

HKEY_LOCAL_MACHINE\Software\McNeel\Rhinoceros\5.0x64\Plug-ins

Rhino 5 32-bit

HKEY_LOCAL_MACHINE\Software\Wow6432Node\McNeel\Rhinoceros\5.0\Plug-ins

Registering Your Plug-in

To register your plug-in with Rhino, you will need to create a new Registry key in the following locations depending on the Rhino version. The name of the Registry key will be your plug-in's GUID, the value returned by your plug-in's CRhinoPlugIn::PlugInID() derived member, formatted as a string. For example:

On 32-bit Windows

Rhino 5 32-bit

HKEY_LOCAL_MACHINE\SOFTWARE\McNeel\Rhinoceros\5.0\Plug-ins\<your_plugin_guid>

On 64-bit Windows

Rhino 5 64-bit

HKEY_LOCAL_MACHINE\Software\McNeel\Rhinoceros\5.0x64\Plug-ins\<your_plugin_guid>

Rhino 5 32-bit

HKEY_LOCAL_MACHINE\Software\Wow6432Node\McNeel\Rhinoceros\5.0\Plug-ins\<your_plugin_guid>

Under this new Registry key, create two new value names, Name and FileName that contain strings that identify your plug-in's name and the full path to the .RHP file, respectively. For example, if I had created a new plug-in named “FooBar” that I has installed in Rhino'

developer/installingandregisteringaplugin.txt · Last modified: 2015/05/21 (external edit)