def add(
self,
name: str,
*,
color: int = const.BYLAYER,
true_color: int = None,
linetype: str = "Continuous",
lineweight: int = const.LINEWEIGHT_BYLAYER,
plot: bool = True,
transparency: Optional[float] = None,
dxfattribs: Dict = None,
) -> "Layer":
"""Add a new :class:`~ezdxf.entities.Layer`.
Args:
name (str): layer name
color (int): :ref:`ACI` value, default is BYLAYER
true_color (int): true color value, use :func:`ezdxf.rgb2int` to
create ``int`` values from RGB values
linetype (str): line type name, default is "Continuous"
lineweight (int): line weight, default is BYLAYER
plot (bool): plot layer as bool, default is ``True``
transparency: transparency value in the range [0, 1], where 1 is
100% transparent and 0 is opaque
dxfattribs (dict): additional DXF attributes
.. versionadded:: 0.17
"""
dxfattribs = dict(dxfattribs or {})
if validator.is_valid_aci_color(color):
dxfattribs["color"] = color
else:
raise const.DXFValueError(f"invalid color: {color}")
dxfattribs["linetype"] = linetype
if validator.is_valid_lineweight(lineweight):
dxfattribs["lineweight"] = lineweight
else:
raise const.DXFValueError(f"invalid lineweight: {lineweight}")
if true_color is not None:
dxfattribs["true_color"] = int(true_color)
dxfattribs["plot"] = int(plot)
layer = cast("Layer", self.new(name, dxfattribs))
if transparency is not None:
layer.transparency = transparency
return layer
def test_is_valid_aci_color():
assert is_valid_aci_color(-1) is False
assert is_valid_aci_color(0) is True
assert is_valid_aci_color(257) is True
assert is_valid_aci_color(258) is False
def color(self, value: int):
if validator.is_valid_aci_color(value):
self._aci_color = value
else:
raise const.DXFValueError(f"invalid ACI color value '{value}'")
def set_current_color(doc: "Drawing", color: int):
"""Set current :ref:`ACI`."""
if not validator.is_valid_aci_color(color):
raise const.DXFValueError(f'invalid ACI color value: "{color}"')
doc.header[CURRENT_COLOR] = color