drawlib.preset_styles & preset_colors

Built-in style theme catalogs (DefaultStyles, DefaultStyles1–DefaultStyles6, GoogleStyles, MonochromeStyles) and curated color palettes (DefaultColors, DefaultColors1–DefaultColors6, GoogleColors, MonochromeColors, CssColors). Configure project themes in styles.py via from drawlib.preset_styles import DefaultStyles, GoogleStyles, MonochromeStyles and from drawlib.preset_colors import CssColors, DefaultColors, GoogleColors, MonochromeColors.

from drawlib.canvas import save, setup
from drawlib.icons import phosphor
from drawlib.preset_styles import DefaultStyles, GoogleStyles, MonochromeStyles
from drawlib.shapes import rectangle
from drawlib.styles import Colors, Styles
from drawlib.text import text

setup(width=120, height=58)

ds = DefaultStyles()
gs = GoogleStyles()
ms = MonochromeStyles()

text(
    (60.0, 52.5),
    "Built-In Theme Catalogs & 6-Tone Palettes",
    style=Styles.DarkBold.patch(text_size=12.2),
)

# Column 1: DefaultStyles
rectangle((22.5, 33.0), width=35, height=28, style=ds.Neutral.patch(shape_r=2.0))
phosphor.swatches((9.5, 42.8), width=3.6, style=ds.PrimaryBold)
text((12.5, 42.8), "DefaultStyles", style=ds.DarkBold.patch(text_size=10.8, halign="left"))
rectangle(
    (22.5, 34.5),
    width=29,
    height=7.5,
    style=ds.PrimaryFlat.patch(shape_r=1.5),
    text="PrimaryFlat",
    text_style=ds.WhiteBold.patch(text_size=10.2),
)
rectangle(
    (22.5, 24.5),
    width=29,
    height=7.5,
    style=ds.SecondaryNeutral.patch(shape_r=1.5),
    text="SecondaryNeutral",
    text_style=ds.DarkBold.patch(text_size=10.0),
)

# Column 2: GoogleStyles
rectangle((60.0, 33.0), width=35, height=28, style=gs.Neutral.patch(shape_r=2.0))
phosphor.presentation_chart((47.0, 42.8), width=3.6, style=gs.PrimaryBold)
text((50.0, 42.8), "GoogleStyles", style=gs.DarkBold.patch(text_size=10.8, halign="left"))
rectangle(
    (60.0, 34.5),
    width=29,
    height=7.5,
    style=gs.PrimaryFlat.patch(shape_r=1.5),
    text="PrimaryFlat",
    text_style=gs.WhiteBold.patch(text_size=10.2),
)
rectangle(
    (60.0, 24.5),
    width=29,
    height=7.5,
    style=gs.PrimaryNeutral.patch(shape_r=1.5),
    text="PrimaryNeutral",
    text_style=gs.DarkBold.patch(text_size=10.0),
)

# Column 3: MonochromeStyles
rectangle((97.5, 33.0), width=35, height=28, style=ms.Neutral.patch(shape_r=2.0))
phosphor.printer((84.5, 42.8), width=3.6, style=ms.DarkBold)
text((87.5, 42.8), "Monochrome", style=ms.DarkBold.patch(text_size=10.8, halign="left"))
rectangle(
    (97.5, 34.5),
    width=29,
    height=7.5,
    style=ms.PrimaryBold.patch(shape_r=1.5),
    text="PrimaryBold",
    text_style=ms.DarkBold.patch(text_size=10.2),
)
rectangle(
    (97.5, 24.5),
    width=29,
    height=7.5,
    style=ms.Gray2.patch(shape_r=1.5),
    text="Gray2 Card",
    text_style=ms.DarkBold.patch(text_size=10.0),
)

# Bottom Strip: 6-Tone Scale (DefaultColors1..6 / Blue1..6)
rectangle((60.0, 10.0), width=110, height=11.0, style=Styles.Neutral.patch(shape_r=2.0))
text((17.5, 10.0), "6-Tone Scale:", style=Styles.DarkBold.patch(text_size=10.2))
tones = [Colors.Blue1, Colors.Blue2, Colors.Blue3, Colors.Blue4, Colors.Blue5, Colors.Blue6]
for idx, tone_color in enumerate(tones, start=1):
    tx = 37.5 + (idx - 1) * 13.5
    label_style = Styles.DarkBold.patch(text_size=10.0) if idx <= 3 else Styles.WhiteBold.patch(text_size=10.0)
    swatch = Styles.NeutralFlat.patch(
        shape_fill_color=tone_color,
        shape_line_color=Colors.Gray4,
        shape_line_width=0.6,
        shape_r=1.2,
    )
    rectangle((tx, 10.0), width=12.0, height=6.8, style=swatch, text=f"T{idx}", text_style=label_style)

save()

classDefaultStyles#

Standard preset style catalog (drawlib.preset_styles.DefaultStyles, subclass of BaseStyles) backing drawlib.styles.Styles by default (style = "default" in drawlib.toml). Centered on Tone 4 (DefaultColors4) for semantic anchors while exposing all 6 tone levels (Primary1–Primary6, Blue1–Blue6), 8 semantic roles across 17 orthogonal variants, and calm *Neutral card tokens (2,239 style tokens total).

# styles.py
from drawlib.preset_colors import DefaultColors
from drawlib.preset_styles import DefaultStyles

Colors = DefaultColors()
Styles = DefaultStyles()

classDefaultStyles1#

Tone-1 (ultra-light pastel) view of the default theme (drawlib.preset_styles.DefaultStyles1, subclass of BaseStyles). Maps unnumbered semantic and chromatic tokens (Primary, Secondary, Blue, Green, etc.) directly to Tone 1 (#e8f2ff primary fill), suited for pastel container backdrops and low-contrast background layers.

from drawlib.preset_styles import DefaultStyles1

Styles = DefaultStyles1()  # Primary fill -> #e8f2ff (Tone 1)

classDefaultStyles2#

Tone-2 (light card background) view of the default theme (drawlib.preset_styles.DefaultStyles2, subclass of BaseStyles). Maps base semantic and hue tokens (Primary, Secondary, Blue, Teal, etc.) to Tone 2 (#b0c4fa primary fill) for soft card surfaces with dark text.

from drawlib.preset_styles import DefaultStyles2

Styles = DefaultStyles2()  # Primary fill -> #b0c4fa (Tone 2)

classDefaultStyles3#

Tone-3 (medium-soft) view of the default theme (drawlib.preset_styles.DefaultStyles3, subclass of BaseStyles). Maps base semantic and chromatic tokens to Tone 3 (#7891f2 primary fill) for balanced mid-tone diagrams and chart series.

from drawlib.preset_styles import DefaultStyles3

Styles = DefaultStyles3()  # Primary fill -> #7891f2 (Tone 3)

classDefaultStyles4#

Tone-4 (standard high-contrast base) view of the default theme (drawlib.preset_styles.DefaultStyles4, subclass of BaseStyles). Matches DefaultStyles (#4862da primary fill), providing crisp white-text contrast on *Flat focal cards.

from drawlib.preset_styles import DefaultStyles4

Styles = DefaultStyles4()  # Equivalent tone anchor to DefaultStyles()

classDefaultStyles5#

Tone-5 (deep tone) view of the default theme (drawlib.preset_styles.DefaultStyles5, subclass of BaseStyles). Maps base semantic and chromatic tokens to Tone 5 (#263ea0 primary fill) for executive decks and rich dark-accent callouts.

from drawlib.preset_styles import DefaultStyles5

Styles = DefaultStyles5()  # Primary fill -> #263ea0 (Tone 5)

classDefaultStyles6#

Tone-6 (darkest shade) view of the default theme (drawlib.preset_styles.DefaultStyles6, subclass of BaseStyles). Maps base semantic and chromatic tokens to Tone 6 (#12205f primary fill) for maximum stroke contrast and deep header banners.

from drawlib.preset_styles import DefaultStyles6

Styles = DefaultStyles6()  # Primary fill -> #12205f (Tone 6)

classGoogleStyles#

Google Workspace, Slides, and Material-aligned preset style catalog (drawlib.preset_styles.GoogleStyles, subclass of BaseStyles; style = "google" in drawlib.toml). Exposes the full semantic role matrix plus Google-specific color tokens (GoogleBlue, GoogleGreen, GoogleYellow, GoogleRed, CornflowerBlue, RedBerry; 2,596 style tokens total).

# styles.py
from drawlib.preset_colors import GoogleColors
from drawlib.preset_styles import GoogleStyles

Colors = GoogleColors()
Styles = GoogleStyles()

classMonochromeStyles#

Grayscale print, academic publication, patent, and e-ink preset style catalog (drawlib.preset_styles.MonochromeStyles, subclass of BaseStyles; style = "monochrome" in drawlib.toml). Replaces chromatic fills with high-contrast black outlines, white cards, and 8-step gray ramps (335 style tokens total).

# styles.py
from drawlib.preset_colors import MonochromeColors
from drawlib.preset_styles import MonochromeStyles

Colors = MonochromeColors()
Styles = MonochromeStyles()

classCssColors#

Complete W3C CSS Color Module catalog (drawlib.preset_colors.CssColors, subclass of BaseColors) providing 141 standardized named web colors (140 CSS named colors plus Transparent).

from drawlib.preset_colors import CssColors

colors = CssColors()
fill = colors.AliceBlue       # Color(240, 248, 255, 1.0)
stroke = colors.MidnightBlue  # Color(25, 25, 112, 1.0)
clear = colors.Transparent    # Color(0, 0, 0, 0.0)

classDefaultColors#

Standard color palette class (drawlib.preset_colors.DefaultColors, subclass of BaseColors) backing drawlib.styles.Colors (149 Color tokens). Combines 8 chromatic 6-tone scales, 8 gray levels, semantic role anchors (Tone 4), and calm *Neutral card fills.

from drawlib.preset_colors import DefaultColors

palette = DefaultColors()
hero_hex = palette.Primary.hex        # '#4862da'
card_fill = palette.SecondaryNeutral  # Calm teal-tinted neutral Color

classDefaultColors1#

Tone-1 (ultra-light pastel) color palette class (drawlib.preset_colors.DefaultColors1, subclass of BaseColors). Resolves unnumbered role and hue attributes (Primary, Secondary, Blue, Green, etc.) to Tone 1.

from drawlib.preset_colors import DefaultColors1

c1 = DefaultColors1()
assert c1.Primary.hex == "#e8f2ff"

classDefaultColors2#

Tone-2 (light card background) color palette class (drawlib.preset_colors.DefaultColors2, subclass of BaseColors). Resolves base semantic and hue attributes to Tone 2.

from drawlib.preset_colors import DefaultColors2

c2 = DefaultColors2()
assert c2.Primary.hex == "#b0c4fa"

classDefaultColors3#

Tone-3 (medium-soft) color palette class (drawlib.preset_colors.DefaultColors3, subclass of BaseColors). Resolves base semantic and hue attributes to Tone 3.

from drawlib.preset_colors import DefaultColors3

c3 = DefaultColors3()
assert c3.Primary.hex == "#7891f2"

classDefaultColors4#

Tone-4 (standard high-contrast base) color palette class (drawlib.preset_colors.DefaultColors4, subclass of BaseColors). Matches the default tone anchors of DefaultColors.

from drawlib.preset_colors import DefaultColors4

c4 = DefaultColors4()
assert c4.Primary.hex == "#4862da"

classDefaultColors5#

Tone-5 (deep tone) color palette class (drawlib.preset_colors.DefaultColors5, subclass of BaseColors). Resolves base semantic and hue attributes to Tone 5.

from drawlib.preset_colors import DefaultColors5

c5 = DefaultColors5()
assert c5.Primary.hex == "#263ea0"

classDefaultColors6#

Tone-6 (darkest shade) color palette class (drawlib.preset_colors.DefaultColors6, subclass of BaseColors). Resolves base semantic and hue attributes to Tone 6.

from drawlib.preset_colors import DefaultColors6

c6 = DefaultColors6()
assert c6.Primary.hex == "#12205f"

classGoogleColors#

Google Workspace and Google Slides palette catalog (drawlib.preset_colors.GoogleColors, subclass of BaseColors; 170 Color tokens) paired with GoogleStyles.

from drawlib.preset_colors import GoogleColors

gc = GoogleColors()
blue = gc.GoogleBlue    # '#4285f4'
green = gc.GoogleGreen  # '#34a853'

classMonochromeColors#

Grayscale color palette catalog (drawlib.preset_colors.MonochromeColors, subclass of BaseColors; 37 Color tokens) paired with MonochromeStyles for black-and-white printing and patent illustrations.

from drawlib.preset_colors import MonochromeColors

mc = MonochromeColors()
card = mc.Gray2   # Color(230, 230, 230, 1.0) -> '#e6e6e6'
ink = mc.Black    # Color(0, 0, 0, 1.0) -> '#000000'

classStyle#

Re-exported style specification class (drawlib.preset_styles.Style) for authoring custom preset catalogs in styles.py with a single import. See Style in drawlib.styles for full fields and methods (.copy(), .patch()).

classColor#

Re-exported immutable RGBA color class (drawlib.preset_colors.Color) for defining custom palette classes in styles.py. See Color in drawlib.styles for full constructor parameters, .hex, and .alpha().

defget_intermediate_color(color1, color2, ratio=0.5)#

Re-exported linear RGBA interpolation helper (drawlib.preset_colors.get_intermediate_color). See get_intermediate_color() in drawlib.styles for full parameter details.

defget_intermediate_colors(color1, color2, num=1, *, include_ends=False)#

Re-exported multi-step RGBA gradient generator (drawlib.preset_colors.get_intermediate_colors). See get_intermediate_colors() in drawlib.styles for full parameter details.