IfcPlusPlus 核心API速查BuildingModel、ReaderSTEP、GeometryConverter 完全清單【免費(fèi)下載鏈接】ifcplusplusIfcPlusPlus is an open source C class model, as well as a reader and writer for IFC files in STEP format. Features: Easy and efficient memory management using smart pointers. Parallel reader for very fast parsing on multi-core CPUs. Additionally, theres a simple IFC viewer application, using Qt and OpenSceneGraph. It can be used as starting point for all kinds of applications around the open building model standard IFC.項(xiàng)目地址: https://gitcode.com/gh_mirrors/if/ifcplusplus想快速上手 IFC 建筑模型開(kāi)發(fā)本文給出 IfcPlusPlusIFC核心 API 速查清單圍繞BuildingModel、ReaderSTEP、GeometryConverter三大核心類列全了關(guān)鍵方法、文件位置與調(diào)用順序。IfcPlusPlus 是開(kāi)源 C 類模型與 IFCSTEP 格式文件讀取/寫(xiě)入器配合智能指針管理內(nèi)存、多線程并行解析是開(kāi)發(fā)開(kāi)放建筑模型應(yīng)用的理想起點(diǎn)文末附示例工程路徑照做即可跑通。一、3 個(gè)核心類一眼看懂 核心類一句話職責(zé)源碼位置BuildingModel建筑模型容器存放全部 IFC 實(shí)體IfcPlusPlus/src/ifcpp/model/BuildingModel.hReaderSTEP讀取 IFC STEP 文件多核并行、速度快IfcPlusPlus/src/ifcpp/reader/ReaderSTEP.hGeometryConverter把 IFC 幾何表示轉(zhuǎn)換為 Carve 網(wǎng)格IfcPlusPlus/src/ifcpp/geometry/GeometryConverter.h輔助類同樣值得收藏WriterSTEP把模型寫(xiě)回 IFC 文件IfcPlusPlus/src/ifcpp/writer/WriterSTEP.hStatusCallback統(tǒng)一的消息/進(jìn)度/取消回調(diào)基類IfcPlusPlus/src/ifcpp/model/StatusCallback.h三個(gè)核心類都繼承自它GeometrySettings幾何轉(zhuǎn)換參數(shù)如圓周頂點(diǎn)數(shù)、布爾運(yùn)算 epsilonIfcPlusPlus/src/ifcpp/geometry/GeometrySettings.h二、BuildingModel 類速查模型實(shí)體全在這BuildingModel是整個(gè)應(yīng)用的數(shù)據(jù)中樞內(nèi)部用std::unordered_mapint, shared_ptrBuildingEntity按 STEP tag 存放所有實(shí)體。2.1 實(shí)體增刪BuildingModel.h 第 42–47 行方法作用getMapIfcEntities()獲取實(shí)體映射表遍歷模型最快入口insertEntity(e, overwrite, warn)插入實(shí)體可覆蓋已有 tagremoveEntity(e)/removeEntity(tag)按對(duì)象或 tag 刪除實(shí)體removeUnreferencedEntities()清理無(wú)引用實(shí)體省內(nèi)存getLowestUnusedEntityTagSlow()找最小可用 tag填補(bǔ)空隙getNextUnusedEntityTagFast()快速取下一個(gè)可用 tag2.2 模型信息與單位getIfcProject()拿到根實(shí)體 IfcProjectgetIfcSchemaVersionOfLoadedFile()已加載文件的 IFC 版本IFC2X3/IFC4/IFC4X3…getIfcSchemaVersionCurrent()庫(kù)當(dāng)前實(shí)現(xiàn)的最高 IFC 版本getUnitConverter()單位換算器毫米/米等幾何轉(zhuǎn)換前務(wù)必確認(rèn)getFileName()/getFileHeader()/getFileDescription()文件元信息2.3 加載控制resolveInverseAttributes()/unsetInverseAttributes()解析/釋放反向引用cancelLoading()/isLoadingCancelled()取消正在進(jìn)行的加載配合 GUI 的取消按鈕 小技巧實(shí)體類定義在IfcPlusPlus/src/ifcpp/IFC4X3/include/下每個(gè) IFC 實(shí)體一個(gè)頭文件如IfcWall.h、IfcProject.h屬性直接以m_Name、m_GlobalId等成員變量訪問(wèn)非常直觀。三、ReaderSTEP 類速查最快讀取 IFC 文件ReaderSTEP封裝了 STEP 文件解析支持從文件或直接流讀取內(nèi)部用多線程并行解析大文件也能快速完成。方法作用loadModelFromFile(filePath, model)一步到位打開(kāi)文件→解析→實(shí)體填入模型最常用loadModelFromStream(content, pos, model)從內(nèi)存流加載適合網(wǎng)絡(luò)/嵌入場(chǎng)景readHeader(in, model)只讀文件頭schema 版本、單位、文件名readData(in, end, model)解析實(shí)體數(shù)據(jù)段readSingleStepLine(line, obj)解析單行 STEP 語(yǔ)句底層接口3.1 消息回調(diào)必接一步ReaderSTEP繼承自StatusCallback調(diào)用setMessageCallBack(...)注冊(cè)回調(diào)后解析進(jìn)度MESSAGE_TYPE_PROGRESS_VALUE、警告、錯(cuò)誤都會(huì)推給你——這是實(shí)現(xiàn)進(jìn)度條和錯(cuò)誤日志的關(guān)鍵。四、GeometryConverter 類速查IFC 幾何轉(zhuǎn)網(wǎng)格GeometryConverter是模型→可渲染網(wǎng)格的轉(zhuǎn)換器接收BuildingModel后調(diào)用convertGeometry()內(nèi)部并行處理每個(gè) IfcProduct輸出ProductShapeData含網(wǎng)格、變換矩陣、子產(chǎn)品樹(shù)。4.1 核心方法方法作用convertGeometry()主入口多線程轉(zhuǎn)換全部幾何getShapeInputData()結(jié)果獲取GUID→ProductShapeData扁平映射setModel(model)換綁另一個(gè)模型setCsgEps(eps)設(shè)置 CSG 布爾運(yùn)算容差示例常用 1.5e-9resetModel()/clearInputCache()釋放緩存、清理內(nèi)存getBuildingModel()/getGeomSettings()取回模型與幾何設(shè)置4.2 內(nèi)部子轉(zhuǎn)換器清單GeometryConverter組合了RepresentationConverter后者又編排了一整套子轉(zhuǎn)換器都在IfcPlusPlus/src/ifcpp/geometry/下PointConverter點(diǎn)坐標(biāo)PointConverter.hCurveConverter曲線/樣條CurveConverter.hPlacementConverter放置與變換矩陣PlacementConverter.hFaceConverter面/殼三角化FaceConverter.hSolidModelConverter實(shí)體、布爾運(yùn)算SolidModelConverter.hProfileCache輪廓緩存提升重復(fù)截面性能ProfileCache.hCSG_Adapter布爾切減如墻體開(kāi)洞CSG_Adapter.h 性能調(diào)參GeometrySettings中setNumVerticesPerCircle()控制圓弧細(xì)分默認(rèn) 14頂點(diǎn)越多越圓滑、越耗內(nèi)存。五、WriterSTEP三行寫(xiě)回 IFC 文件需要導(dǎo)出模型時(shí)WriterSTEP非常輕量shared_ptrWriterSTEP writer(new WriterSTEP()); writer-writeModelToStream(stream, ifc_model);m_writeNumberPrecision可調(diào)整輸出小數(shù)精度默認(rèn) 15。六、典型調(diào)用順序4 步跑通全流程 ?建模型與讀取器new BuildingModel()new ReaderSTEP()給兩者注冊(cè)setMessageCallBack加載文件step_reader-loadModelFromFile(xx.ifc, ifc_model)轉(zhuǎn)換幾何new GeometryConverter(ifc_model)→ 配置setCsgEps→convertGeometry()取結(jié)果getShapeInputData()拿扁平網(wǎng)格映射或從ifc_model-getIfcProject()出發(fā)用反向?qū)傩匀鏼_IsDecomposedBy_inverse遍歷空間樹(shù) 完整可運(yùn)行的參考實(shí)現(xiàn)在examples/LoadFileExample/src/main.cpp含樹(shù)遍歷與網(wǎng)格遍歷演示想從零創(chuàng)建墻體的看examples/CreateIfcWallAndWriteFile/src/main.cpp帶 QtOpenSceneGraph 的 3D 查看器示例在examples/SimpleViewerExampleQt/可直接作為你應(yīng)用的起點(diǎn)。七、新手避坑清單單位不一致轉(zhuǎn)換前先查getUnitConverter()IFC 常用毫米幾何輸出按米縮放忘記接回調(diào)不注冊(cè)setMessageCallBack時(shí)進(jìn)度與錯(cuò)誤信息會(huì)丟失Debug 下打印到控制臺(tái)GUID 重復(fù)convertGeometry()會(huì)自動(dòng)檢測(cè)重復(fù) GUID 并追加后綴注意看回調(diào)里的錯(cuò)誤消息大文件內(nèi)存轉(zhuǎn)換完成后及時(shí)clearInputCache()可顯著降低駐留內(nèi)存取消加載UI 取消時(shí)調(diào)用ifc_model-cancelLoading()讀取器會(huì)協(xié)作退出掌握這份 BuildingModel、ReaderSTEP、GeometryConverter 速查清單你就能獨(dú)立完成 IFC 文件讀取、幾何轉(zhuǎn)換與導(dǎo)出的全鏈路開(kāi)發(fā)。動(dòng)手從examples/LoadFileExample開(kāi)始是最快的學(xué)習(xí)路徑【免費(fèi)下載鏈接】ifcplusplusIfcPlusPlus is an open source C class model, as well as a reader and writer for IFC files in STEP format. Features: Easy and efficient memory management using smart pointers. Parallel reader for very fast parsing on multi-core CPUs. Additionally, theres a simple IFC viewer application, using Qt and OpenSceneGraph. It can be used as starting point for all kinds of applications around the open building model standard IFC.項(xiàng)目地址: https://gitcode.com/gh_mirrors/if/ifcplusplus創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考