Colors Module¶

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

Converter Functions¶

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

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

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

ezdxf.colors.luminance(color: Tuple[int, int, int]) → 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, Union[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: Union[int, Tuple[int, int, int]]) → 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.

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