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

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


20210221150007553.gif

  为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.作者答疑


  如有疑问,请留言。

提示: 作者知了-联系方式1
提示: 作者知了-联系方式2

©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容