文章目录

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



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


Java 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.h
 
void 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.作者答疑

  如有疑问，请留言。