Glassvision/IfcOpenShell
1
0
Fork 0
mirror of https://github.com/IfcOpenShell/IfcOpenShell.git synced 2026-08-10 09:48:32 +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 |
+======+===================+=========+
| BOOL | Always enabled | False |
| BOOL | Always enabled | True |
+------+-------------------+---------+
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
>>> f = ifcopenshell.open("model.ifc")
>>> s = ifcopenshell.geom.settings()
>>> # By default setting is enabled, we disable it for demonstration.
>>> s.set("apply-default-materials", False)
>>> c = f["3bXiCStxP6Fgxdej$yc50U"]
>>>
>>> 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]
[]
>>>
>>> s.set(s.APPLY_DEFAULT_MATERIALS, True)
>>> s.set("apply-default-materials", True)
>>> shp = ifcopenshell.geom.create_shape(s, c)
>>> shp.geometry.material_ids
(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0)
>>> [(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.
@@ -611,7 +613,8 @@ USE_PYTHON_OPENCASCADE
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
----------------