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

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,530评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 86,403评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,120评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,770评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,758评论 5 367
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,649评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,021评论 3 398
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,675评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,931评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,659评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,751评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,410评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,004评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,969评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,203评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,042评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,493评论 2 343

推荐阅读更多精彩内容