mirror of
https://github.com/IfcOpenShell/IfcOpenShell.git
synced 2026-08-09 09:21:46 +00:00
Petru Conduraru
c8f29bb843
Addresses aothms's review comment on PR #8759: "I think serializers will also need to be adapted. OBJ, Collada, etc." Adds a proper "points" primitive to IfcGeom::Representation:: Triangulation (points_/points_item_ids_/points_material_ids_, addPoint()), alongside the existing faces_/edges_, for vertices that stand alone as a representation item (Vertex/Point/PointCloud, see #134/#1409/#5218) rather than belonging to a face or edge. points_material_ids_ is a separate array from the shared faces+edges material_ids_, not folded into it: material_ids_ is a single running sequence consumed in strict per-item emission order by every writer below, and interleaving points into it would desync that sequence whenever an item with points is triangulated before/after an item with edges in the same file. - WaveFrontOBJSerializer: emits "p" records for these points (the only way OBJ marks a vertex as a rendered primitive in its own right). Previously these vertices were written as bare "v" lines with no primitive referencing them at all. - GltfSerializer: adds a POINTS (mode 0) primitive branch. Also fixes a latent bug: write() unconditionally returned early when material_ids() was empty, which is exactly the case for point-only geometry, silently dropping the whole node/mesh; and the later material-id iteration would have incremented an already-at-end iterator (UB) had that early return not caught it first. - ColladaSerializer: COLLADA's schema has no points primitive (only lines/polygons/triangles), so there is nothing to write beyond the raw position source; logs a warning instead of silently producing an empty-but-successful mesh. - IfcGeomWrapper.i: exposes points()/points_item_ids()/ points_material_ids() (plus *_buffer variants) symmetrically with the existing edges_item_ids() etc. Ported onto a clean v0.8.0 base (the original prototype was built on top of Dion Moult's experimental ifcviewer-wgpu branch, PR #8759). Fixes two build-time mismatches against that base's API: the logger header is ifcparse/IfcLogger.h here, and Logger only exposes a capitalized Warning(code_prefix, code_number, message, instance) method, not a lowercase warning(); and material name sanitization is IfcUtil::sanitate_material_name(), matching every other call site in this file, not ifcopenshell::sanitate_material_name(). This contribution was produced with the assistance of an AI coding tool.
IfcOpenShell
IfcOpenShell is an open source (LGPL) software library for working with Industry Foundation Classes (IFC). Complete parsing support is provided for IFC2x3 TC1, IFC4 Add2 TC1, IFC4x1, IFC4x2, and IFC4x3 Add2. Extensive geometric support is implemented for the IFC releases IFC2x3 TC1 and IFC4 Add2 TC1. Extending with support for arbitrary IFC schemas is possible at compile-time when using C++ and at run-time when using Python.
In addition to a C++ and Python API, IfcOpenShell comes with an ecosystem of tools, notably including IfcConvert (an application to convert IFC models to other formats), Bonsai (an add-on to Blender providing a graphical IFC authoring platform), and many other libraries, CLI apps, and more. Support is also provided for auxiliary standards such as BCF and IDS.
For more information, see:
Development is sponsored through your generous donations!
Contents
| Name | Description | License | Service |
|---|---|---|---|
| bcf | Library to read and write BCF-XML and query OpenCDE BCF-API modules | LGPL-3.0-or-later |   |
| bonsai | Add-on to Blender providing a graphical native IFC authoring platform | GPL-3.0-or-later |    |
| bsdd | Library to query the bSDD API | LGPL-3.0-or-later |  |
| ifc2ca | Utility to convert IFC structural analysis models to Code_Aster | LGPL-3.0-or-later | |
| ifc4d | Convert to and from IFC and project management software | LGPL-3.0-or-later |  |
| ifc5d | Report and optimise cost information from IFC | LGPL-3.0-or-later |  |
| ifcbimtester | Wrapper for Gherkin based unit testing for IFC models | LGPL-3.0-or-later | |
| ifcblender | Historic Blender IFC import add-on | LGPL-3.0-or-later* | |
| ifccityjson | Convert CityJSON to IFC | LGPL-3.0-or-later |  |
| ifcclash | Clash detection library and CLI app | LGPL-3.0-or-later |  |
| ifcconvert | CLI app to convert IFC to many other formats | LGPL-3.0-or-later* |   |
| ifccsv | Library and CLI app to export and import schedules from IFC | LGPL-3.0-or-later |  |
| ifcdiff | Compare changes between IFC models | LGPL-3.0-or-later |  |
| ifcedit | CLI wrapper for ifcopenshell.api IFC model mutation functions | LGPL-3.0-or-later |  |
| ifcfm | Extract IFC data for FM handover requirements | LGPL-3.0-or-later |  |
| ifcmax | Historic extension for IFC support in 3DS Max | LGPL-3.0-or-later* | |
| ifcmcp | MCP server for querying and editing IFC building models | LGPL-3.0-or-later |  |
| ifcopenshell-python | Python library for IFC manipulation | LGPL-3.0-or-later* |         |
| ifcpatch | Utility to run pre-packaged scripts to manipulate IFCs | LGPL-3.0-or-later |  |
| ifcquery | CLI tool for querying and inspecting IFC building models | LGPL-3.0-or-later |  |
| ifcsverchok | Blender Add-on for visual node programming with IFC | GPL-3.0-or-later |  |
| ifctester | Library, CLI and webapp for IDS model auditing | LGPL-3.0-or-later |  |
The IfcOpenShell C++ codebase is split into multiple interal libraries:
| Name | Description | License |
|---|---|---|
| ifcgeom | Internal library for IfcOpenShell | LGPL-3.0-or-later* |
| ifcgeom_schema_agnostic | Internal library for IfcOpenShell | LGPL-3.0-or-later* |
| ifcgeomserver | Internal library for IfcOpenShell | LGPL-3.0-or-later* |
| ifcjni | Internal library for IfcOpenShell | LGPL-3.0-or-later* |
| ifcparse | Internal library for IfcOpenShell | LGPL-3.0-or-later* |
| ifcwrap | Internal library for IfcOpenShell | LGPL-3.0-or-later* |
| qtviewer | Internal library for IfcOpenShell | LGPL-3.0-or-later* |
| serializers | Internal library for IfcOpenShell | LGPL-3.0-or-later* |