rhino插件-创建犀牛软件皮肤-rhino皮肤-界面开发-犀牛插件

文章目录

1.创建皮肤DLL
2.创建皮肤插件
3.安装
4.附加信息
5.作者答疑

本文翻译至官网，方便读者阅读。Rhino允许开发人员自定义Rhino的大部分接口，这样应用程序就像他们自己的一样。我们称之为自定义皮肤。通过自定义皮肤，您可以更改应用程序图标、启动屏幕、菜单栏、应用程序标题栏、关于框和工具栏。

为Rhino创建自定义皮肤需要创建两个代码模块:
<skin name>.rhs是一个常规的MFC DLL，它实现皮肤的图标、启动屏幕和可选的菜单。在本文中，我们将其称为皮肤DLL。
<skin name>.rhp是一个Rhino实用程序插件，它实现了菜单处理程序(如果需要的话)和一个或多个定制命令。在本文中，我们将其称为皮肤插件。

1.创建皮肤DLL

皮肤DLL是一个常规的MFC DLL，它实现皮肤的图标、启动屏幕和(可选的)菜单。要创建皮肤DLL，请启动Visual Studio并运行Rhino SDK安装的Rhino皮肤DLL向导。

Rhino Skin DLL向导创建了三个类:
一个CWinApp-derived类。 这是DLL的入口点。
一个CRhinoSkinDLL-derived类。 这个类允许您指定Rhino的图标、启动屏幕和菜单。关于这个类的更多信息，请参见rhinoSdkSkinDLL.h。
CSplashWnd类。 这是一个启动屏幕类的基本实现。如果您需要更高级的东西，可以用您自己的实现替换它。
修改项目的图标和启动画面位图。如果你的皮肤要覆盖Rhino的主菜单，那么你也需要创建你的菜单资源。记住填写在DLL’s .CPP文件顶部找到的开发人员信息块。这个模块类似于Rhino插件。

2.创建皮肤插件

皮肤插件是实现菜单处理程序(如果需要的话)和一个或多个自定义命令的Rhino实用程序插件。
要创建Rhino实用程序插件，请启动Visual Studio并运行Rhino SDK安装的Rhino插件向导。在选择要运行的向导时，请确保将新项目添加到开放解决方案中，而不是创建新解决方案。这样，您的皮肤项目就被组织到单个解决方案中。如果皮肤DLL提供了一个自定义菜单，那么将插件AppWizard生成的UUID复制到皮肤的CRhinoSkinDLL::SkinPlugInID()成员中。重要!这两个方法必须返回相同的UUID。这是一个关键的步骤，因为它确定了Rhino将加载的主要插件来管理其菜单和扩展Rhino命令集。 在你的CRhinoPlugIn派生类的头文件中添加以下重写:

// Skin DLL menu update handler
void OnInitPlugInMenuPopups(WPARAM wparam, LPARAM lparam);// Skin DLL menu command handler
BOOL OnPlugInMenuCommand(WPARAM wparam );// Change to CRhinoPlugIn::load_plugin_at_startup
plugin_load_time PlugInLoadTime();

将以下定义添加到您的CRhinoPlugIn派生类的. cpp文件中。

CRhinoPlugIn::plugin_load_time CSkinPlugInSamplePlugIn::PlugInLoadTime()
{// Override to change load time to "at startup"return CRhinoPlugIn::load_plugin_at_startup;
}

如果您的皮肤DLL提供了一个自定义菜单，那么将一个名为MenuHandler.cpp的源文件添加到插件项目中，并将CRhinoPlugIn::OnInitPlugInMenuPopups()和CRhinoPlugIn::OnPlugInMenuCommand()的定义放在这个文件中。重要!在MenuHandler.cpp中包含皮肤DLL的resource.h文件，以提供对皮肤DLL的菜单资源标识符的访问。 例如:

#include "stdafx.h"
#include "MySkinPlugIn.h"
#include "../MySkinDLL/Resource.h"// Put these to overrides in a separate CPP file so they could
// include the MySkinDLL/Resource.h file without conflicting
// with this projects resource.hvoid CSkinPlugInSamplePlugIn::OnInitPlugInMenuPopups(WPARAM wParam, LPARAM lParam)
{HMENU hMenu = (HMENU)wParam;if( NULL == hMenu )return;switch( GetMenuItemID(hMenu, LOWORD(lParam)) ){case IDM_SAMPLE_DISABLE:::EnableMenuItem( hMenu, IDM_SAMPLE_DISABLE, MF_BYCOMMAND|MF_DISABLED|MF_GRAYED );break;case IDM_SAMPLE_SUB_DISABLE:::EnableMenuItem( hMenu, IDM_SAMPLE_SUB_DISABLE, MF_BYCOMMAND|MF_DISABLED|MF_GRAYED );break;// TODO...}
}BOOL CSkinPlugInSamplePlugIn::OnPlugInMenuCommand(WPARAM wParam)
{ON_wString w;switch( (UINT)wParam ){case IDM_SAMPLE_ONE:w = L"Test Item One";break;case IDM_SAMPLE_TWO:w = L"Two";break;case IDM_SAMPLE_DISABLE:w = L"Disabled";break;case IDM_SAMPLE_SUB_A:w = L"Sub Menu A";break;case IDM_SAMPLE_SUB_B:w = L"Sub Menu B";break;case IDM_SAMPLE_SUB_DISABLE:w = L"Sub Menu Disabled";break;default:return true;}::RhinoMessageBox( w, L"OnMenu", MB_OK );return true;
}

接着，编译皮肤插件。使用Rhino的PluginManager命令加载皮肤插件，这样它就有机会进行自我注册。

3.安装

要安装自定义皮肤，请使用REGEDIT.EXE将scheme键添加到注册表中，该键具有皮肤DLL的路径。例如:

Item	Value
Subkey	HKEY_LOCAL_MACHINE\SOFTWARE\McNeel\Rhinoceros\4.0\Scheme: MySkin
Entry name	SkinDLLPath
Type	REG_SZ
Data value	C:\Src\MySkin\MySkinDLL\Release\MySkinDLL.rhs

现在，您可以通过使用/scheme= " <上一步中的方案名> "作为命令行参数创建Rhino可执行文件的快捷方式来测试您的自定义皮肤。例如:

"C:\Program Files\Rhinoceros 4.0\System\Rhino4.exe" /scheme=MySkin

4.附加信息

如果用户选择不运行您的带皮肤版本的Rhino，那么您可能希望阻止加载您的带皮肤插件。可以通过检查Rhino使用的方案名是否与您的皮肤的方案名匹配来实现这一点。通过检入插件的CRhinoPlugIn::OnLoadPlugIn()成员来实现这一点。

BOOL CSkinPlugInSamplePlugIn::OnLoadPlugIn()
{ON_wString scheme = RhinoApp().RegistrySchemeName();if( scheme.CompareNoCase(L"Scheme: MySkin") != 0 )return -1; // Fail silently...// TODO...return CRhinoUtilityPlugIn::OnLoadPlugIn();
}

合理的脚本代码可以有效的提高工作效率，减少重复劳动。

5.作者答疑

如有疑问，请留言。