23. Revit API: 几何对象（四）- BrepBuilder

已于 2024-09-14 15:52:54 修改
阅读量452 收藏 13
点赞数 4
分类专栏： Revit # Revit API 文章标签： 笔记
于 2024-09-14 15:51:29 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/tzq2821448839/article/details/142260301
版权

一、前言

上一篇写了Solid的创建、展示、变换、布尔操作，这一篇写另一种Solid的创建方法。

需要再次强调的是，BrepBuilder不适合用来创建Solid。

二、边界表示

【Wiki】：边界表示（Boundary representation，简称B-Rep），是一种通过定义其体积限制来表示3D形状的方法。实体表示为连接的曲面元素的集合，这些曲面元素定义内部点和外部点之间的边界。

还有个叫 CSG（Constructive Solid Geometry）的，和一些其它表示方法。我不知道Revit用的是哪种，当然了，API调用仔调API就行了，也只能按开放的接口用。如果不爽调用这破API，可以去看“Open Cascade”，整会了就可以自个儿玩了。

Brep，简单来讲，就是定义每个面，定义面上的范围（边），再把它们严丝合缝的拼起来。

“Geometric Modeling”里面介绍了一些几何建模的方法，了解一下就行了。

三、BRepBuilder

3.1. 使用流程

以创建一个正方体为例。

Ⅰ 准备阶段：

  1. 创建BRepBuilder实例
  2. 创建Surface，即前后左右上下6个平面。
  3. 创建Curve，即正方体12条直线边。

Ⅱ 组装填充阶段：

  1. AddFace
  2. AddEdge
  3. AddLoop
  4. AddCoEdge
  5. FinishLoop,FinishFace
  6. Finish

3.2. 样例代码解释

正方体生成的代码和其它例子，可以查看SDK目录下的“SDKSample/BRepBuilderExample/CreateCube.cs”，或者查看GitHub。

直接看代码可能有点迷糊，这里对组装填充的步骤进行解释。

请结合图来看。

在这里插入图片描述

// 摘自 RevitSdkSamples 
private BRepBuilder CreateCubeImpl()
{
    // create a BRepBuilder; add faces to build a cube

    // BRepType.Solid，表示面都需要朝外；朝内就是Void
    BRepBuilder brepBuilder = new BRepBuilder(BRepType.Solid);
    
    // a cube 100x100x100, from (0,0,0) to (100, 100, 100)
    
    // 1. Planes.
    // 6个面，面的朝向如图
    Plane bottom = Plane.CreateByOriginAndBasis(new XYZ(50, 50, 0), new XYZ(1, 0, 0), new XYZ(0, 1, 0)); // bottom. XY plane, Z = 0, normal pointing inside the cube.
    Plane top = Plane.CreateByOriginAndBasis(new XYZ(50, 50, 100), new XYZ(1, 0, 0), new XYZ(0, 1, 0)); // top. XY plane, Z = 100, normal pointing outside the cube.
    Plane front = Plane.CreateByOriginAndBasis(new XYZ(100, 50, 50), new XYZ(0, 0, 1), new XYZ(0, 1, 0)); // front side. ZY plane, X = 0, normal pointing inside the cube.
    Plane back = Plane.CreateByOriginAndBasis(new XYZ(0, 50, 50), new XYZ(0, 0, 1), new XYZ(0, 1, 0)); // back side. ZY plane, X = 0, normal pointing outside the cube.
    Plane left = Plane.CreateByOriginAndBasis(new XYZ(50, 0, 50), new XYZ(0, 0, 1), new XYZ(1, 0, 0)); // left side. ZX plane, Y = 0, normal pointing inside the cube
    Plane right = Plane.CreateByOriginAndBasis(new XYZ(50, 100, 50), new XYZ(0, 0, 1), new XYZ(1, 0, 0)); // right side. ZX plane, Y = 100, normal pointing outside the cube
                                                   
    // 2. Faces.
    // 填充Face，注意参数True/False，表示面是否需要翻转
    // 面需要朝外，看图，bottom/front/left 都需要翻转面朝向
    BRepBuilderGeometryId faceId_Bottom = brepBuilder.AddFace(BRepBuilderSurfaceGeometry.Create(bottom, null), true);
    BRepBuilderGeometryId faceId_Top = brepBuilder.AddFace(BRepBuilderSurfaceGeometry.Create(top, null), false);
    BRepBuilderGeometryId faceId_Front = brepBuilder.AddFace(BRepBuilderSurfaceGeometry.Create(front, null), true);
    BRepBuilderGeometryId faceId_Back = brepBuilder.AddFace(BRepBuilderSurfaceGeometry.Create(back, null), false);
    BRepBuilderGeometryId faceId_Left = brepBuilder.AddFace(BRepBuilderSurfaceGeometry.Create(left, null), true);
    BRepBuilderGeometryId faceId_Right = brepBuilder.AddFace(BRepBuilderSurfaceGeometry.Create(right, null), false);
    
    // 3. Edges.
    
    // 3.a (define edge geometry)
    // 定义12条边，边的方向如图
    // walk around bottom face
    BRepBuilderEdgeGeometry edgeBottomFront = BRepBuilderEdgeGeometry.Create(new XYZ(100, 0, 0), new XYZ(100, 100, 0));
    BRepBuilderEdgeGeometry edgeBottomRight = BRepBuilderEdgeGeometry.Create(new XYZ(100, 100, 0), new XYZ(0, 100, 0));
    BRepBuilderEdgeGeometry edgeBottomBack = BRepBuilderEdgeGeometry.Create(new XYZ(0, 100, 0), new XYZ(0, 0, 0));
    BRepBuilderEdgeGeometry edgeBottomLeft = BRepBuilderEdgeGeometry.Create(new XYZ(0, 0, 0), new XYZ(100, 0, 0));
    
    // now walk around top face
    BRepBuilderEdgeGeometry edgeTopFront = BRepBuilderEdgeGeometry.Create(new XYZ(100, 0, 100), new XYZ(100, 100, 100));
    BRepBuilderEdgeGeometry edgeTopRight = BRepBuilderEdgeGeometry.Create(new XYZ(100, 100, 100), new XYZ(0, 100, 100));
    BRepBuilderEdgeGeometry edgeTopBack = BRepBuilderEdgeGeometry.Create(new XYZ(0, 100, 100), new XYZ(0, 0, 100));
    BRepBuilderEdgeGeometry edgeTopLeft = BRepBuilderEdgeGeometry.Create(new XYZ(0, 0, 100), new XYZ(100, 0, 100));
    
    // sides
    BRepBuilderEdgeGeometry edgeFrontRight = BRepBuilderEdgeGeometry.Create(new XYZ(100, 100, 0), new XYZ(100, 100, 100));
    BRepBuilderEdgeGeometry edgeRightBack = BRepBuilderEdgeGeometry.Create(new XYZ(0, 100, 0), new XYZ(0, 100, 100));
    BRepBuilderEdgeGeometry edgeBackLeft = BRepBuilderEdgeGeometry.Create(new XYZ(0, 0, 0), new XYZ(0, 0, 100));
    BRepBuilderEdgeGeometry edgeLeftFront = BRepBuilderEdgeGeometry.Create(new XYZ(100, 0, 0), new XYZ(100, 0, 100));

    // 3.b (define the edges themselves)
    // 填充边
    BRepBuilderGeometryId edgeId_BottomFront = brepBuilder.AddEdge(edgeBottomFront);
    BRepBuilderGeometryId edgeId_BottomRight = brepBuilder.AddEdge(edgeBottomRight);
    BRepBuilderGeometryId edgeId_BottomBack = brepBuilder.AddEdge(edgeBottomBack);
    BRepBuilderGeometryId edgeId_BottomLeft = brepBuilder.AddEdge(edgeBottomLeft);
    BRepBuilderGeometryId edgeId_TopFront = brepBuilder.AddEdge(edgeTopFront);
    BRepBuilderGeometryId edgeId_TopRight = brepBuilder.AddEdge(edgeTopRight);
    BRepBuilderGeometryId edgeId_TopBack = brepBuilder.AddEdge(edgeTopBack);
    BRepBuilderGeometryId edgeId_TopLeft = brepBuilder.AddEdge(edgeTopLeft);
    BRepBuilderGeometryId edgeId_FrontRight = brepBuilder.AddEdge(edgeFrontRight);
    BRepBuilderGeometryId edgeId_RightBack = brepBuilder.AddEdge(edgeRightBack);
    BRepBuilderGeometryId edgeId_BackLeft = brepBuilder.AddEdge(edgeBackLeft);
    BRepBuilderGeometryId edgeId_LeftFront = brepBuilder.AddEdge(edgeLeftFront);

    // 4. Loops.
    // 填充轮廓
    BRepBuilderGeometryId loopId_Bottom = brepBuilder.AddLoop(faceId_Bottom);
    BRepBuilderGeometryId loopId_Top = brepBuilder.AddLoop(faceId_Top);
    BRepBuilderGeometryId loopId_Front = brepBuilder.AddLoop(faceId_Front);
    BRepBuilderGeometryId loopId_Back = brepBuilder.AddLoop(faceId_Back);
    BRepBuilderGeometryId loopId_Right = brepBuilder.AddLoop(faceId_Right);
    BRepBuilderGeometryId loopId_Left = brepBuilder.AddLoop(faceId_Left);
    
    // 5. Co-edges. 
    // 定义轮廓，即 向loop中填充边，
    // ① 边需要首尾相连；② 边按右手螺旋定则，方向需要和面一致（即朝外）
    // Bottom face. All edges reversed
    brepBuilder.AddCoEdge(loopId_Bottom, edgeId_BottomFront, true); // other direction in front loop
    brepBuilder.AddCoEdge(loopId_Bottom, edgeId_BottomLeft, true);  // other direction in left loop
    brepBuilder.AddCoEdge(loopId_Bottom, edgeId_BottomBack, true);  // other direction in back loop
    brepBuilder.AddCoEdge(loopId_Bottom, edgeId_BottomRight, true); // other direction in right loop
    brepBuilder.FinishLoop(loopId_Bottom);  // 完成底面轮廓的定义
    brepBuilder.FinishFace(faceId_Bottom);  // 完成底面的定义
    
    // Top face. All edges NOT reversed.
    brepBuilder.AddCoEdge(loopId_Top, edgeId_TopFront, false);  // other direction in front loop.
    brepBuilder.AddCoEdge(loopId_Top, edgeId_TopRight, false);  // other direction in right loop
    brepBuilder.AddCoEdge(loopId_Top, edgeId_TopBack, false);   // other direction in back loop
    brepBuilder.AddCoEdge(loopId_Top, edgeId_TopLeft, false);   // other direction in left loop
    brepBuilder.FinishLoop(loopId_Top);
    brepBuilder.FinishFace(faceId_Top);
    
    // Front face.
    // 略，详情看源码
    // Back face
    // Right face
    // Left face
    
    brepBuilder.Finish();  // 完成构建
    return brepBuilder;
}

// 获取构件结果
Solid mySolid = CreateCubeImpl().GetResult();

3.3. API实用性分析

第一点就是使用繁杂，容易出错。我们看到了，即使是生成一个最简单的正方体，都要大费周章。

而若是使用上一篇写的“GeometryCreationUtilities”呢？

public Solid CreateBox()
{
    XYZ point1 = XYZ.Zero;
    XYZ point2 = new XYZ(100, 0, 0);
    XYZ point3 = new XYZ(100, 100, 0);
    XYZ point4 = new XYZ(0, 100, 0);

    CurveLoop curveLoop = new CurveLoop();
    curveLoop.Append(Line.CreateBound(point1, point2));
    curveLoop.Append(Line.CreateBound(point2, point3));
    curveLoop.Append(Line.CreateBound(point3, point4));
    curveLoop.Append(Line.CreateBound(point4, point1));

    Solid solid = GeometryCreationUtilities.CreateExtrusionGeometry(new List<CurveLoop>() { curveLoop }, XYZ.BasisZ, 100);

    return solid;
}

第二点就是使用难度高。正方体是简单，但若复杂一点呢？曲面、锥面、直纹面、赫尔米特曲面的组合呢，这些面都有现成的API，但问题在于“Edge”，如何去计算多个曲面的交界边是BrepBuilder使用难度高的主要原因。

我这小卡拉米，是算不出曲面与曲面的交线的，就算是最简单的一个平面斜切圆柱，都得写写画画好一会儿。

虽然 Revit Face类提供了计算面交线的方法，但是Surface可没有。Face没有构造方法，只能从Solid上获取。而要使用Brep生成Solid，就需要知道面的交线。这样就死循环了，所以还是得算，这也就是使用难度高。

当然了，该方法有时还是挺好用的，比如说，对一个现有的曲面进行拉伸。

四、总结

这一篇简单写了BrepBilder的使用流程，结合示例进行了解释。

杂鱼Tong
关注
专栏目录
rhino.inside-revit:这是Rhino.Inside:registered:.Revit的开源存储库
03-28
Rhino.Inside:registered:.Revit 请参阅 ，以获取有关如何使用该项目的更多信息。 下面列出的部分为想要为该项目或Wiki做出贡献的开发人员提供了有关代码库的更多信息。 概述 Rhino.Inside:registered:技术允许...
RevitAPI.chm官方文档（2015-2019）
09-28
Revit API是Autodesk Revit软件的开发接口，允许开发者通过编程方式与Revit进行交互，实现自动化任务、扩展功能和定制化工作流。这个压缩包包含从2015年至2019年的官方chm文档，这些文档详细阐述了Revit API的发展...
22. Revit API: 几何对象（三）- Solid操作
杂鱼Tong的博客
09-11 1423
Solid 的创建、展示、变换、布尔操作。
17. Revit API: Creation
杂鱼Tong的博客
07-12 1047
Revit API Creation 命名空间下的各个类介绍，各种创建方法介绍
Revit API 开发 (9): BRepBuilder 创建原生几何图形
极客BIM工作室
01-18 3166
前言 原生集合图形的好处不言而喻，如何创建一个复杂的原生图形，Revit API 也提供了对应的功能。 流程 如何使用 BRepBuilder 创建一个圆柱体，并且用DirectShape在Revit中创建。代码请参考Revit SDK。 BRepBuilder开始和结束 BRepBuilder brepBuilder = new BRepBuilder(BRepType.Solid); brep...
Revit API 几何专题 5： 体 - Solid
极客BIM工作室
03-22 3869
体 - Solid 一个 Solid 是由 Face 和 Edge 来定义它边界的实体。 Solid 类接口： namespace Autodesk.Revit.DB { public class Solid : GeometryObject { //体积 public double Volume { get; } //表面积 ...
revitapidocs：在线Revit API文档：2015、2016、2017、2017.1、2018
02-05
Revit API是Autodesk Revit软件的开发接口，允许程序员通过编写代码来自动化和扩展Revit的功能。这个压缩包文件“revitapidocs-master”似乎包含了一套完整的在线文档资源，覆盖了Revit API从2015到2018年的版本。...
RevitAPI_REVIT_Revit二次开发_chm_API_RevitAPI_
10-03
6. **图元选择和过滤**：API提供了选择集和过滤器，用于从Revit模型中选择特定类型的元素，以便进行进一步操作。 7. **图元导出和导入**：RevitAPI支持导出和导入Revit模型数据，与其他系统集成，或者备份和恢复...
Revit.Async:使用基于任务的异步模式（TAP）从任何执行上下文中运行Revit API代码
05-07
如果您遇到过Revit API异常消息，即“无法在Revit API上下文之外执行Revit API”，通常，当您想从无模式窗口执行Revit API代码时，可能需要此库来挽救生命。 解决此异常的常见方法是使用IExternalEventHandler包装...
STM32学习笔记（二、初识stm32单片机）
tommorrowwill的博客
09-10 762
首先stm32是意法半导体公司（ST）使用ARM公司的Cortex-M为核心生产的32位的单片机。其中，ST---意法半导体公司，即SOC厂商。M---为Microelectronics的缩写，即微型处理器。32---表示控制器为32位的。103---表示F系列的子系列。
C++学习笔记----6、内存管理（五）---- 智能指针（3）
weixin_71738303的博客
09-11 1125
与指向特定类型的原始指针可以转化为不同类型的指针一样，shared_ptr保存特定的类型可以转化为一个另一种类型的shared_ptr。转化shared_ptr的函数是const_pointer_cast()，dynamic_pointer_cast(),static_pointer_cast()和reinterpret_pointer_cast()。前面简要提过，当拥有共享属主的智能指针，例如shared_ptr不在活动范围或者被重置时，只有它是最后指向的智能指针时才能释放其指向的资源。
UEFI学习笔记（五）：EDK II PCD的概念、类型、使用
qq_44189622的博客
09-11 811
如果在BIOS里面有一些模块是binary方式集成进来的而这些binary又需要用到PCD（用于Binary Release），那么这些Binary集成的要用到的PCD就必须要设置为。PCD的值存在memory里面，下次启动时，上次更改的值丢失了，每次启动都是从default值开始。是存在VPD空间的（在FLASH上，只读），一般是出厂配置。如果platform是从源码build出来的，没有binary在里面的时候，PCD用的都是。作用域在一个模块中（模块级的），可以在Binary Level进行修改。
【学习笔记】手写Tomcat 二
LearnTech_123的博客
09-11 1048
在昨天的基础上，再进一步优化，能够响应HTML文件，图片等静态资源。
OJ在线判题系统项目笔记
今天不coding的博客
09-11 760
OJ在线判题系统项目笔记
经验笔记：Web 浏览器存储手段
qq_45831414的博客
09-10 852
以上就是使用 IndexedDB 的基本步骤。IndexedDB 提供了强大的数据存储能力，并且可以通过索引来优化数据检索性能。在实际应用中，可能还需要处理更复杂的场景，比如数据迁移、错误处理等。务必确保你的代码能够妥善处理各种异常情况。
网络工程师学习笔记——网络互连与互联网
最新发布
2301_77279557的博客
09-14 656
网络互连相关技术
C++学习笔记----7、使用类与对象获得高性能（一）---- 书写类（1）
weixin_71738303的博客
09-13 923
public:private:第一行指出这是一个叫做spreadsheet_cell的模块的定义。每一类的定义都是以class关键字开始后接类的名字。如果类定义在一个模块中，该类一定要import进来才可见，定义时一定要在class关键字之前加上export。类的定义就是声明并且以分号结束。类的定义通常在一个其名字的文件中。例如，SpreadsheetCell类定义在一个叫做SpreadsheetCell.cppm的文件中。有些编译器要求使用特定的扩展名；有些则不要求。
GS-SLAM论文阅读笔记--MM-Gaussian
qq_45795134的博客
09-10 1328
传统的SLAM方法往往受到地图表示的限制，如点云,surfel和voxel，它们只能以固定的分辨率重建地图。这一限制阻碍了对场景复杂纹理的捕捉，并阻碍了SLAM实现合成新视点等功能.此外，户外场景由于其无界特性，带来的挑战呈现出特别的复杂性。现存方法通常是基于RGB-D或单目相机。单目相机中深度数据的缺失会导致三维高斯分布的不准确。同时，RGB-D相机捕获的深度信息范围有限，使其在广阔的户外场景中的使用变得复杂。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值