3D建模软件：Rhino二次开发_（3）.RhinoCommonAPI详解.docx

PAGE1

PAGE1

RhinoCommonAPI详解

1.RhinoCommon概述

RhinoCommon是Rhino3D建模软件的.NETAPI，它提供了一套强大的工具和方法，使得开发者可以利用C#、VB.NET等.NET语言对Rhino进行二次开发。RhinoCommon不仅可以用于创建和操纵几何对象，还可以扩展Rhino的功能，例如添加自定义命令、创建交互式工具、处理文件导入导出等。

1.1RhinoCommon的特点

跨平台：RhinoCommon可以在Windows和Mac平台上运行。

丰富的功能：提供了大量的几何操作和建模功能。

易于学习：基于.NET的开发环境，对于有.NET开发经验的开发者来说，上手较快。

强大的社区支持：有大量的开发者和教程资源，可以快速解决问题。

1.2安装和配置

要开始使用RhinoCommon，首先需要安装Rhino3D软件，并确保安装了RhinoWIP版本或更高版本。接下来，需要在VisualStudio中创建一个.NET项目，并引用RhinoCommon库。

1.2.1创建项目

打开VisualStudio。

选择“文件”“新建”“项目”。

选择“类库(.NETStandard)”模板，点击“下一步”。

填写项目名称和保存位置，点击“创建”。

1.2.2引用RhinoCommon

在解决方案资源管理器中，右键点击“依赖项”“管理NuGet包”。

在NuGet包管理器中，搜索“RhinoCommon”。

选择并安装RhinoCommon包。

1.3第一个RhinoCommon插件

为了演示如何使用RhinoCommon，我们来编写一个简单的插件，该插件在Rhino中创建一个立方体。

1.3.1创建插件项目

打开VisualStudio。

选择“文件”“新建”“项目”。

选择“RhinoPlug-In”模板，点击“下一步”。

填写项目名称和保存位置，点击“创建”。

1.3.2编写插件代码

usingSystem;

usingRhino;

usingRhino.Commands;

usingRhino.Geometry;

usingRhino.Input;

usingRhino.Input.Custom;

publicclassCreateBoxCommand:Command

{

publicoverridestringEnglishName=CreateBox;

protectedoverrideResultRunCommand(RhinoDocdoc,RunModemode)

{

//创建一个立方体

Point3dcorner1=newPoint3d(0,0,0);

Point3dcorner2=newPoint3d(10,10,10);

Brepbox=Brep.CreateFromBox(newBox(newPlane(Point3d.Origin,Vector3d.XAxis,Vector3d.YAxis),newInterval(0,10),newInterval(0,10),newInterval(0,10)));

//将立方体添加到文档中

doc.Objects.AddBrep(box,newObjectAttributes());

//重新计算视图

doc.Views.Redraw();

returnResult.Success;

}

}

//注册命令

publicclassCreateBoxPlugin:Rhino.PlugIns.PlugIn

{

publicCreateBoxPlugin()

{

Instance=this;

}

publicstaticCreateBoxPluginInstance{get;privateset;}

protectedoverrideLoadReturnCodeOnLoad(refstringerrorMessage)

{

Rhino.Commands.Com