Colors Module¶

This module provides functions and constants to manage all kinds of colors in DXF documents.

Converter Functions¶

ezdxf.colors.rgb2int(rgb: RGB | tuple[int, int, int]) → int¶: Combined integer value from (r, g, b) tuple.

ezdxf.colors.int2rgb(value: int) → RGB¶: Split RGB integer value into (r, g, b) tuple.

ezdxf.colors.aci2rgb(index: int) → RGB¶: Convert AutoCAD Color Index (ACI) into (r, g, b) tuple, based on default AutoCAD colors.

ezdxf.colors.luminance(color: RGB) → float¶: Returns perceived luminance for an RGB color in the range [0.0, 1.0] from dark to light.

ezdxf.colors.decode_raw_color(value: int) → tuple[int, int | RGB]¶: Decode raw-color value as tuple(type, Union[aci, (r, g, b)]), the true color value is a (r, g, b) tuple.

ezdxf.colors.decode_raw_color_int(value: int) → tuple[int, int]¶: Decode raw-color value as tuple(type, int), the true color value is a 24-bit int value.

ezdxf.colors.encode_raw_color(value: int | RGB) → int¶: Encode true-color value or AutoCAD Color Index (ACI) color value into a :term: raw color value.

ezdxf.colors.transparency2float(value: int) → float¶

Returns transparency value as float from 0 to 1, 0 for no transparency (opaque) and 1 for 100% transparency.

Parameters:: value – DXF integer transparency value, 0 for 100% transparency and 255 for opaque

ezdxf.colors.float2transparency(value: float) → int¶

Returns DXF transparency value as integer in the range from 0 to 255, where 0 is 100% transparent and 255 is opaque.

Parameters:: value – transparency value as float in the range from 0 to 1, where 0 is opaque and 1 is 100% transparent.

class ezdxf.colors.RGB(r: int, g: int, b: int)¶

Named tuple representing an RGB color value.

red channel in range [0, 255]

green channel in range [0, 255]

blue channel in range [0, 255]

property luminance: float¶: Returns perceived luminance for an RGB color in range [0.0, 1.0] from dark to light.

classmethod from_hex(color: str) → Self¶: Returns an RGB instance from a hex color string, the color string is a hex string “RRGGBB” with an optional leading “#”, an appended alpha channel is ignore.

to_floats() → tuple[float, float, float]¶: Returns the color value as a tuple of floats in range [0, 1].

classmethod from_floats(rgb: tuple[float, float, float]) → Self¶: Returns an RGB instance from floats in range [0, 1].

Common AutoCAD Color Index (ACI) values, also accessible as IntEnum ezdxf.enums.ACI

Default color mappings from AutoCAD Color Index (ACI) to true-color values.

model space	DXF_DEFAULT_COLORS
paper space	DXF_DEFAULT_PAPERSPACE_COLORS