# IfcOpenShell - IFC toolkit and geometry engine # Copyright (C) 2021 Dion Moult # # This file is part of IfcOpenShell. # # IfcOpenShell is free software: you can redistribute it and/or modify # it under the terms of the GNU Lesser General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # # IfcOpenShell is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General Public License # along with IfcOpenShell. If not, see . from typing import Any, Union import ifcopenshell def edit_surface_style( file: ifcopenshell.file, style: ifcopenshell.entity_instance, attributes: dict[str, Any] ) -> None: """Edits the attributes of an IfcPresentationItem For more information about the attributes and data types of an IfcPresentationItem, consult the IFC documentation. The IfcPresentationItem is expected to be one of IfcSurfaceStyleShading, IfcSurfaceStyleRendering, IfcSurfaceStyleWithTextures, IfcSurfaceStyleLighting, IfcSurfaceStyleReflectance, or IfcExternallyDefinedSurfaceStyle. To represent a colour, a nested dictionary should be used. See the example below. :param style: The IfcPresentationStyle entity you want to edit :param attributes: a dictionary of attribute names and values. :return: None Example: .. code:: python # Create a new surface style style = ifcopenshell.api.style.add_style(model) # Create a blank rendering style. rendering = ifcopenshell.api.style.add_surface_style(model, style=style, ifc_class="IfcSurfaceStyleRendering") # Edit the attributes of the rendering style. ifcopenshell.api.style.edit_surface_style(model, style=rendering, attributes={ # A surface colour and transparency is still supplied for # viewport display only. This will supersede the shading # presentation item. "SurfaceColour": { "Name": None, "Red": 1.0, "Green": 0.8, "Blue": 0.8 }, "Transparency": 0., # 0 is opaque, 1 is transparent # NOTDEFINED is assumed to be a PHYSICAL (PBR) lighting # model. In IFC4X3, you may choose PHYSICAL directly. "ReflectanceMethod": "NOTDEFINED", # For PBR shading, you may specify these parameters: "DiffuseColour": { "Name": None, "Red": 0.9, "Green": 0.8, "Blue": 0.8 }, "SpecularColour": 0.1, # Metallic factor "SpecularHighlight": {"SpecularRoughness": 0.5}, # Roughness factor }) """ usecase = Usecase() usecase.file = file return usecase.execute(style, attributes) class Usecase: file: ifcopenshell.file def execute(self, style: ifcopenshell.entity_instance, attributes: dict[str, Any]) -> None: self.style = style attribute_types: dict[str, str] = {} for attribute in style.wrapped_data.declaration().as_entity().all_attributes(): attribute_type = attribute.type_of_attribute() if attribute_type.as_aggregation_type() is None: attribute_type = attribute_type.declared_type().name() else: # doesn't have .declared_type() attribute_type = attribute_type.type_of_element() attribute_types[attribute.name()] = attribute_type for key, value in attributes.items(): attribute_class = attribute_types.get(key) if attribute_class == "IfcColourRgb": self.edit_colour_rgb(key, value) elif key == "SpecularHighlight": self.edit_specular_highlight(value) elif attribute_class == "IfcColourOrFactor": self.edit_colour_or_factor(key, value) else: setattr(style, key, value) def edit_colour_rgb(self, name: str, value: dict[str, Any]): if (attribute := getattr(self.style, name)) is None: attribute = self.file.createIfcColourRgb() setattr(self.style, name, attribute) attribute.Name = value.get("Name", None) attribute.Red = value["Red"] attribute.Green = value["Green"] attribute.Blue = value["Blue"] def edit_colour_or_factor(self, name: str, value: Union[dict[str, Any], ifcopenshell.entity_instance, None]): if isinstance(value, dict): attribute = getattr(self.style, name) if not attribute or not attribute.is_a("IfcColourRgb"): colour = self.file.createIfcColourRgb(None, 0, 0, 0) setattr(self.style, name, colour) attribute = getattr(self.style, name) attribute[1] = value["Red"] attribute[2] = value["Green"] attribute[3] = value["Blue"] else: # assume it's float value for IfcNormalisedRatioMeasure or None existing_value = getattr(self.style, name) if existing_value and existing_value.id(): self.file.remove(existing_value) if value is not None: value = self.file.create_entity("IfcNormalisedRatioMeasure", value) setattr(self.style, name, value) def edit_specular_highlight(self, value: Union[dict[str, Any], None]) -> None: if value is None: self.style.SpecularHighlight = None elif value.get("IfcSpecularExponent", None): self.style.SpecularHighlight = self.file.createIfcSpecularExponent(value["IfcSpecularExponent"]) elif value.get("IfcSpecularRoughness", None): self.style.SpecularHighlight = self.file.createIfcSpecularRoughness(value["IfcSpecularRoughness"])