Struct CubeCoord 

pub struct CubeCoord {
    pub r: f64,
    pub g: f64,
    pub b: f64,
}

A position in the theme-relative color cube.

Each axis ranges from 0.0 to 1.0, representing a fractional position between theme anchor colors:

• r: red axis — interpolates bg→red, green→yellow, blue→magenta, cyan→fg
• g: green axis — interpolates between the r-axis edge pairs
• b: blue axis — interpolates between the g-axis face results

Designers think in percentages: cube(60%, 20%, 0%) maps to CubeCoord { r: 0.6, g: 0.2, b: 0.0 }.

Fields

r: f64

Red axis fraction (0.0–1.0).

g: f64

Green axis fraction (0.0–1.0).

b: f64

Blue axis fraction (0.0–1.0).

Implementations

impl CubeCoord

pub fn new(r: f64, g: f64, b: f64) -> Result<Self, String>

Creates a new cube coordinate with fractional values (0.0–1.0 per axis).

Returns an error if any component is outside the valid range.

pub fn from_percentages(r: f64, g: f64, b: f64) -> Result<Self, String>

Creates a cube coordinate from percentage values (0.0–100.0 per axis).

This is the natural syntax for style definitions: cube(60%, 20%, 0%) maps to from_percentages(60.0, 20.0, 0.0).

pub fn quantize(&self, levels: u8) -> (u8, u8, u8)

Quantizes this coordinate to the nearest grid point for a given number of subdivisions per axis.

For the standard 256-color palette, levels = 6 (producing a 6×6×6 cube). Returns the integer grid coordinates (r, g, b) each in 0..levels.

pub fn to_palette_index(&self, levels: u8) -> u8

Returns the 256-color palette index for this coordinate.

Uses the standard formula: 16 + 36*r + 6*g + b where r, g, b are quantized to 0..levels. The offset of 16 accounts for the base16 ANSI colors that occupy indices 0–15.

Trait Implementations

impl Clone for CubeCoord

fn clone(&self) -> CubeCoord

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CubeCoord

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for CubeCoord

fn eq(&self, other: &CubeCoord) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for CubeCoord

impl Eq for CubeCoord

impl StructuralPartialEq for CubeCoord