Glassvision/IfcOpenShell
1
0
Fork 0
mirror of https://github.com/IfcOpenShell/IfcOpenShell.git synced 2026-09-26 18:21:59 +00:00
Code Issues Packages Projects Releases Wiki Activity

Geometry settings documentation fixes #5312

Browse Source
This commit is contained in:
Andrej730
2024-09-05 10:55:41 +05:00
parent ea6df7f617
commit deb41d2158
1 changed files with 7 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/ifcopenshell-python/docs/ifcopenshell/geometry_settings.rst
+7 -4
View File
@@ -61,7 +61,7 @@ APPLY_DEFAULT_MATERIALS
+------+-------------------+---------+ +------+-------------------+---------+
| Type | IfcConvert Option | Default | | Type | IfcConvert Option | Default |
+======+===================+=========+ +======+===================+=========+
| BOOL | Always enabled | False | | BOOL | Always enabled | True |
+------+-------------------+---------+ +------+-------------------+---------+
Given the command invocation: Given the command invocation:
@@ -82,6 +82,8 @@ The interactive session below shows how with this setting enabled you will get a
>>> import ifcopenshell, ifcopenshell.geom >>> import ifcopenshell, ifcopenshell.geom
>>> f = ifcopenshell.open("model.ifc") >>> f = ifcopenshell.open("model.ifc")
>>> s = ifcopenshell.geom.settings() >>> s = ifcopenshell.geom.settings()
>>> # By default setting is enabled, we disable it for demonstration.
>>> s.set("apply-default-materials", False)
>>> c = f["3bXiCStxP6Fgxdej$yc50U"] >>> c = f["3bXiCStxP6Fgxdej$yc50U"]
>>> >>>
>>> shp = ifcopenshell.geom.create_shape(s, c) >>> shp = ifcopenshell.geom.create_shape(s, c)
@@ -90,12 +92,12 @@ The interactive session below shows how with this setting enabled you will get a
>>> [(m.name, m.diffuse) for m in shp.geometry.materials] >>> [(m.name, m.diffuse) for m in shp.geometry.materials]
[] []
>>> >>>
>>> s.set(s.APPLY_DEFAULT_MATERIALS, True) >>> s.set("apply-default-materials", True)
>>> shp = ifcopenshell.geom.create_shape(s, c) >>> shp = ifcopenshell.geom.create_shape(s, c)
>>> shp.geometry.material_ids >>> shp.geometry.material_ids
(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0) (0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0)
>>> [(m.name, m.diffuse) for m in shp.geometry.materials] >>> [(m.name, m.diffuse) for m in shp.geometry.materials]
[('IfcCovering', (0.7, 0.7, 0.7))] [('IfcCovering', colour 0.7 0.7 0.7)]
This is enabled by default for the IfcConvert serializers as they will not gracefully handle -1 material indices and allows users to quickly assign colours based on entity types in their modelling applications. This is enabled by default for the IfcConvert serializers as they will not gracefully handle -1 material indices and allows users to quickly assign colours based on entity types in their modelling applications.
@@ -611,7 +613,8 @@ USE_PYTHON_OPENCASCADE
Only available in Python when an import of ``OCC.Core.BRepTools`` or ``OCC.BRepTools`` succeeds. Only available in Python when an import of ``OCC.Core.BRepTools`` or ``OCC.BRepTools`` succeeds.
This implies ``USE_WORLD_COORDS`` ``USE_BREP_DATA`` and ``DISABLE_TRIANGULATION``. The serialized TopoDS_Shape of ``USE_BREP_DATA`` is deserialized by Python OpenCASCADE. This implies ``USE_WORLD_COORDS`` and ``ITERATOR_OUTPUT`` set to ``SERIALIZED``.
The serialized TopoDS_Shape from iterator output is deserialized by Python OpenCASCADE.
USE_WORLD_COORDS USE_WORLD_COORDS
---------------- ----------------