Blackbird|乌鸫 for Grasshopper 内测版文档
source link: https://jiaomubaobao233.github.io/2021/11/27/Blackbird/
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
Blackbird|乌鸫 for Grasshopper 内测版文档
11月 28 2021
个人练习之用制作的插件包，更新中
Blackbird: a Plug-in for Grasshopper
Developed by Yefan Zhi
School of Design, University of Pennsylvania
使用.ghuser方式封装的建模和数据处理常用插件，欢迎反馈各类bug和建议。
Domain 区间
Mid Len Domain 中点宽度区间
Remap Domain 映射区间
List 列表
List Max 列表最大值
List Min 列表最小值
List Sum 列表求和
List to String 数列转字符串
List Drop 列表去尾
Random Dispatch 随机分配
Dispatch into Tree 分配成树
Number Count 数数
Tree to String 树转字符串
Solid 实体
Center Line Box 中心线长方体
Fillet Pipe 倒角成管
Michelin Pipe 米其林管
Handrail 扶手
Stair 楼梯
Arrange Layout 平铺
Stack Along 对齐堆叠
Stack Parallel 平行堆叠
Surface 曲面
UV Pattern UV图案
Orthogonality Check 正交检测
插件和示例程序：
方法一：
将.ghuser插件拖入Grasshopper界面中。
方法二：
Grasshopper → File → Special Folders → User Object Folder 打开文件夹，将.ghuser插件解压在该文件夹内。
安装完成后，Blackbird会出现在Grasshopper插件栏内。更新版本时请替换旧版本。
部分功能使用说明
Handrail 扶手 ⚐
根据平台边沿生成扶手。
Input
Polyline 基准线，可以成环，但一次只能一条单条curve。建议使用平台边沿线join后得到的多段线。
Offset 栏杆中心线与基准线的偏移距离。
Reverse Offset Boolean值，为True时反转偏移方向。
Column Distance 杆间距。非严格按此距离划分，而是贴近此距离平分各段。
Column Size 杆的尺寸（底面正方形边长）。
Column Height 杆高。
Handrail Size 扶手尺寸（截面正方形边长）。
除Polyline之外，输入参数以米为单位内置了默认值。
Stair 楼梯 ⚐
根据楼板生成楼梯和扶手。
Input
Surface/Brep 楼板上表面，单个曲面或多重曲面。可以一次输入多个曲面。
Thickness 楼板厚度。
Step Distance 沿斜坡分割踏步的距离。非严格按此距离划分，而是贴近此距离平分各段。
Handrail Offset 栏杆中心线与楼板边缘的偏移距离。
Column Distance 杆间距。非严格按此距离划分，而是贴近此距离平分各段。
Column Size 杆的尺寸（底面正方形边长）。
Column Height 杆高。
Handrail Size 扶手尺寸（截面正方形边长）。
除Surface/Brep之外，输入参数以米为单位内置了默认值。
Arrange Layout 平铺 ⚐
将一些零件在地面沿格子平铺开来，并统一朝向。
Input
Brep 需要平铺的零件（多重曲面）。
Unit Size 格子边长（模数）。
Min Margin 零件到边框的最小距离。
N of Rows 列数（平铺会优先铺满前一行，再新开一行，依此类推）。默认值为10。
Base Point 平铺的基点。默认值为原点。
Output
Brep 平铺后的零件。
Base 每个零件的底座（长方形）。
Hull 整体底座（长方形）。
UV Pattern UV图案 ⚐
根据可以分为U、V两个方向扩展的图案平铺一个平面。常见的平铺，包括三角形、六边形等都可以按此逻辑完成。图中黄色的非输入值，为便于理解之用。
平铺过程使用了深度优先搜索（DFS）算法。
Input
Surface 平铺的表面。
Pattern Crv 平铺的图案单元（可以是多条curve）。
Pattern Pt 该单元的基准点。需在该单元之内或边缘上。
U Next Pt U方向的下一个基准点。
V Next Pt V方向的下一个基准点。
Rotation 旋转图案（0到360）。
Surface Base Pt 平铺表面的基准点，可缺省。
U Tune [0,1] U方向的位置微调（0到1）。
V Tune [0,1] V方向的位置微调（0到1）。
默认图案为The MET Breuer表皮。
Orthogonality Check 正交检测 ⚐
判断曲面和曲线是否是正交的（横平竖直的），以及标识过于接近的可能是bug的点。用于形体建模过程中的检测。由于犀牛本身的精度限制，判断精度设为0.0001。
Input
S/B 检测的（多重）曲面。
C 检测的曲线。
P 检测的点。
T 过于接近的点的Tolerance，默认为0.3。
Size 显示尺寸，默认为0.5。
Output
Orthogonal S 正交的曲面，即法向量恰有一个非零分量。以绿色高亮。
1A S 经过一次绕坐标轴旋转的曲面，即法向量恰有两个非零分量。以黄色高亮。
2A S 经过两次绕坐标轴旋转的曲面，即法向量恰有三个非零分量。以红色高亮。
Orthogonal C 正交的曲线，即对应的向量恰有一个非零分量。以绿色高亮。
1A C 经过一次绕坐标轴旋转的曲线，即对应的向量恰有两个非零分量。以黄色高亮。
2A C 经过两次绕坐标轴旋转的曲线，即对应的向量恰有三个非零分量。以红色高亮。
P 过于接近的点。以红色标识。
注：实际判断曲线时，视每一段均为直线段（以各段首尾点相连结果判断）。
2021.11.28
内测版发布。
2021.11.29 Handrail v0.04 修复单条直线无法生成bug。
Stair v0.03 与Handrail扶手高度对齐，均为到扶手中心线高度。
UV Pattern v0.05 旋转角度为弧度bug，不铺完整bug，多条曲线失效bug。更新示例。
2021.11.30 UV Pattern v0.06 增加可选表面基准点。
2021.12.03 Orthogonality Check v0.03 发布。
2021.12.29 UV Pattern v0.11 表面基准点可原离目标平面，意味着可以统一多曲面的图案相位。优化修剪逻辑提高效率。修复图案非闭合曲线时的bug。
2022.01.19 Arrange Layout v0.01 发布。
2022.01.26 Mid Len Domain v0.01 发布。
Remap Domain 0.01 发布。
List to String v0.01 发布。
Dispatch into Tree v0.01 发布。
Tree to String v0.01 发布。
Center Line Box v0.01 发布。
Arrange Layout v0.02 修复排布bug。
UV Pattern v0.13 增加定位点输出。修改图标。
Michelin Pipe v0.03 修改图标。
Fillet Pipe v0.04 修改图标。
Orthogonality Check v0.05 修改图标。
2022.02.05 Center Line Box v0.02 修复多个曲线输入的bug。
2022.03.04 Number Count v0.01 发布。
2022.03.26 Center Line Box v0.03 加入基准平面输入。默认为XY平面。
2022.04.06 Center Line Box v0.04 修复数据结构bug。基准平面缺失时改为自动根据线的首端Frame生成。
Stack Along v0.02 发布。
Stack Parallel v0.03 发布。
Recommend
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK