本博客内容正在持续更新,最后一次更新时间:2020.08.06
【本文重点】
1.查文档:RhinoCommon SDK
2.专栏地址:专栏:Rhino (Grasshopper) 二次开发 (C#)
推荐阅读:
【C#】:本文以介绍 Rhino, Grasshopper 的二次开发为主,具体有关 C# 语法的知识点欢迎参考 专栏:C#
【Grasshopper】:有关 Grasshopper 部分知识点和操作欢迎参考 专栏:Rhino (Grasshopper) 二次开发 (C#) 内的 Grasshopper 学习笔记
【视频教程】:本文部分内容来自油管教程 C# Scripting and Plugin Development for Grasshopper
1 Preparations
1.1 IDE
Visual Studio 2019 (2017 也完全ok,再往前版本不推荐,可能存在不兼容的问题)。
1.2 Template
To write plug-in for Grasshopper,需要先下载 Grasshopper templates for v6,安装完成后再次打开 VS2019 的新建项目界面,就能找到相应的项目模板
输入项目名以及项目地址并点击创建后,还出弹出一个设置窗口,这个窗口不需要进行任何修改,直接选择确定即可
1.3 Rhino
作者用的是 Rhino6,不太清楚 Rhino5 是否可行
2 Get Started
2.1 初始类
成功创建项目后,右侧的资源管理器中会显示两个 .cs
文件,我们主要编辑的的是 XXXComponent.cs
文件,作者创建的项目名为 Workshop,因此显示的是 WorkshopComponents.cs
该文件在创建之初就会包含一些代码以注释,为了简洁起见作者直接删去了注释部分的内容,删完之后的代码界面如下,可以看到初始类包含一个构造函数以及五个类方法
2.1.1 构造函数:public XXXComponent() {}
这是一个空的构造函数
public MyFirstGhComponent(): base("Workshop", "Nickname","Description","Category", "Subcategory"){}
base() 中的前三个字符串将直接在鼠标移至电池上时显示:Component:电池名称,Nickname:电池简称,Discription:对电池功能的描述
后两个字符串 Category 和 Subcategory 显示的是该电池在电池菜单栏中的位置
具体代码示例
public MyFirstGhComponent(): base("Zhekai's First Grasshopper Component", "Zhekai's first ghc","This is a my firt lovely grasshopper plug-in","Workshop", "Mics."){}