Struct Color 

pub struct Color {
    pub r: u8,
    pub g: u8,
    pub b: u8,
}

Represents an RGB color with red, green, and blue components.

Each component is a value between 0 and 255, where:

• 0 represents no intensity
• 255 represents full intensity

Examples

use tinterm::Color;

// Create a red color
let red = Color::new(255, 0, 0);

// Use predefined colors
let blue = Color::BLUE;

// Create from hex string
let orange = Color::from_hex("#FF8000").unwrap();

Fields

r: u8

Red component (0-255)

g: u8

Green component (0-255)

b: u8

Blue component (0-255)

Implementations

impl Color

pub fn new(r: u8, g: u8, b: u8) -> Self

Creates a new Color with the specified RGB values.

Arguments

• r - Red component (0-255)
• g - Green component (0-255)
• b - Blue component (0-255)

Examples

use tinterm::Color;

let purple = Color::new(128, 0, 128);

Examples found in repository

examples/art_and_logos.rs (line 211)

fn display_fire_effect() {
    println!("\nFire Effect:");

    let flames = vec![
        "                    ░░░",
        "                  ░░▒▒░",
        "                ░▒▒▓▓▒░",
        "              ░▒▓▓██▓▒░",
        "            ░▒▓██████▓▒░",
        "          ░▒▓████████▓▒░",
        "        ░▒▓▓██████████▓▒░",
        "      ░▒▓▓████████████▓▓▒░",
        "    ░▒▓▓██████████████▓▓▒░",
        "  ░▒▓▓████████████████▓▓▒░░",
    ];

    for (i, flame) in flames.iter().enumerate() {
        let intensity = (flames.len() - i) as f32 / flames.len() as f32;
        let red_component = (255.0 * intensity) as u8;
        let yellow_component = (255.0 * intensity * 0.8) as u8;

        let fire_color = Color::new(red_component, yellow_component, 0);
        println!("  {}", flame.color(fire_color));
    }
}

examples/comprehensive_demo.rs (line 11)

fn main() {
    println!("🎨 Tinterm Comprehensive Demo 🎨\n");

    // Section 1: Basic Colors
    println!("=== 1. BASIC COLORS ===");
    println!("{}", "Red Text".color(Color::RED));
    println!("{}", "Green Background".bg(Color::GREEN));
    println!("{}", "Blue on Yellow".fg(Color::BLUE).bg(Color::YELLOW));
    println!("{}", "Custom RGB Color".color(Color::new(255, 165, 0))); // Orange
    println!("{}", "Hex Color".color(Color::from_hex("#FF69B4").unwrap())); // Hot Pink
    println!();

    // Section 2: Text Styling
    println!("=== 2. TEXT STYLING ===");
    println!("{}", "Bold Text".bold());
    println!("{}", "Italic Text".italic());
    println!("{}", "Underlined Text".underline());
    println!("{}", "Strikethrough Text".strikethrough());
    println!("{}", "Dim Text".dim());
    println!("{}", "Bright Text".bright());
    println!("{}", "Reversed Text".reverse());
    println!("{}", "Blinking Text".blink());
    println!();

    // Section 3: Method Chaining
    println!("=== 3. METHOD CHAINING ===");
    println!(
        "{}",
        "Bold Red on Blue".bold().color(Color::RED).bg(Color::BLUE)
    );
    println!(
        "{}",
        "Italic Underlined Green"
            .italic()
            .underline()
            .color(Color::GREEN)
    );
    println!(
        "{}",
        "Bright Magenta with Cyan BG"
            .bright()
            .color(Color::MAGENTA)
            .bg(Color::CYAN)
    );
    println!();

    // Section 4: Gradients
    println!("=== 4. GRADIENTS ===");
    println!("Foreground Gradients:");
    println!(
        "{}",
        "Red to Blue Gradient".gradient(Color::RED, Color::BLUE, None)
    );
    println!(
        "{}",
        "Green to Purple Gradient".gradient(Color::GREEN, Color::PURPLE, None)
    );
    println!(
        "{}",
        "Sunset Colors".gradient(Color::ORANGE, Color::DEEP_PINK, None)
    );

    println!("\nBackground Gradients:");
    println!(
        "{}",
        "Ocean Waves".gradient_bg(Color::DEEP_SKY_BLUE, Color::TEAL, None)
    );
    println!(
        "{}",
        "Forest Floor".gradient_bg(Color::DARK_GREEN, Color::BROWN, None)
    );

    println!("\nMultiline Gradients:");
    let multiline = "Line One\nLine Two\nLine Three";
    println!("Block mode (each line separate):");
    println!(
        "{}",
        multiline.gradient(Color::RED, Color::BLUE, Some(true))
    );
    println!("Continuous mode (across lines):");
    println!(
        "{}",
        multiline.gradient(Color::CYAN, Color::MAGENTA, Some(false))
    );
    println!();

    // Section 5: Shimmer Effects
    println!("=== 5. SHIMMER EFFECTS ===");
    println!("Static Shimmer Renders:");
    println!(
        "{}",
        "✨ Golden Shimmer ✨"
            .shimmer(Color::GOLD, None)
            .static_render()
    );
    println!(
        "{}",
        "💎 Diamond Shine 💎".shine(Color::WHITE).static_render()
    );
    println!(
        "{}",
        "🌟 Stellar Glow 🌟"
            .glow(Color::YELLOW, 200)
            .static_render()
    );
    println!(
        "{}",
        "🌈 Rainbow Gradient 🌈"
            .shimmer_gradient(Color::RED, Color::VIOLET, None)
            .static_render()
    );
    println!();

    // Section 6: Predefined Colors Showcase
    println!("=== 6. PREDEFINED COLORS SHOWCASE ===");
    let colors = vec![
        ("Fire", Color::RED),
        ("Ocean", Color::BLUE),
        ("Forest", Color::GREEN),
        ("Sun", Color::YELLOW),
        ("Lavender", Color::LAVENDER),
        ("Coral", Color::CORAL),
        ("Gold", Color::GOLD),
        ("Silver", Color::SILVER),
        ("Rose", Color::HOT_PINK),
        ("Emerald", Color::LIME_GREEN),
    ];

    for (name, color) in colors {
        println!("{}", format!("● {}", name).color(color));
    }
    println!();

    // Section 7: Creative Combinations
    println!("=== 7. CREATIVE COMBINATIONS ===");

    // Logo-style text
    println!(
        "{}",
        "T".color(Color::RED).to_string()
            + &"I".color(Color::ORANGE).to_string()
            + &"N".color(Color::YELLOW).to_string()
            + &"T".color(Color::GREEN).to_string()
            + &"E".color(Color::BLUE).to_string()
            + &"R".color(Color::INDIGO).to_string()
            + &"M".color(Color::VIOLET)
    );

    // Progress bar simulation
    let _progress_full = "████████████████████";
    let _progress_empty = "░░░░░░░░░░░░░░░░░░░░";
    println!(
        "Progress: [{}{}] 75%",
        "███████████████".bg(Color::GREEN),
        "░░░░░".color(Color::DARK_GRAY)
    );

    // Status indicators
    println!("Status: {} Ready", "●".color(Color::GREEN));
    println!("Status: {} Warning", "●".color(Color::YELLOW));
    println!("Status: {} Error", "●".color(Color::RED));

    // Syntax highlighting simulation
    println!("\nSyntax Highlighting Example:");
    println!(
        "{} {} {} {}{}{}",
        "fn".color(Color::PURPLE),
        "main".color(Color::BLUE),
        "()".color(Color::YELLOW),
        "{".color(Color::WHITE),
        "\n    println!".color(Color::CYAN),
        "();".color(Color::WHITE)
    );
    println!("{}", "}".color(Color::WHITE));
    println!();

    // Section 8: Performance Test
    println!("=== 8. PERFORMANCE TEST ===");
    let start = std::time::Instant::now();
    for i in 0..1000 {
        let _colored = format!("Line {}", i).color(Color::BLUE);
    }
    let duration = start.elapsed();
    println!("Rendered 1000 colored strings in: {:?}", duration);

    // Final showcase
    println!(
        "\n{}",
        "🎉 Tinterm Demo Complete! 🎉".gradient(Color::RED, Color::BLUE, None)
    );
    println!(
        "{}",
        "Thank you for using Tinterm!"
            .shimmer(Color::GOLD, None)
            .static_render()
    );
}

pub fn rgb(r: u8, g: u8, b: u8) -> Self

Creates a new Color with the specified RGB values.

This is an alias for Color::new.

Examples

use tinterm::Color;

let cyan = Color::rgb(0, 255, 255);

pub fn from_hex(hex: &str) -> Result<Self, &'static str>

Creates a new Color from a hexadecimal color string.

Supports both 6-digit (e.g., “#FF0000” or “FF0000”) and 3-digit (e.g., “#F00” or “F00”) formats. The ‘#’ prefix is optional.

Arguments

• hex - A hex color string

Returns

• Ok(Color) - If the hex string is valid
• Err(&str) - If the hex string is invalid

Examples

use tinterm::Color;

let red = Color::from_hex("#FF0000").unwrap();
let green = Color::from_hex("00FF00").unwrap();
let blue = Color::from_hex("#00F").unwrap();

Examples found in repository

examples/comprehensive_demo.rs (line 12)

fn main() {
    println!("🎨 Tinterm Comprehensive Demo 🎨\n");

    // Section 1: Basic Colors
    println!("=== 1. BASIC COLORS ===");
    println!("{}", "Red Text".color(Color::RED));
    println!("{}", "Green Background".bg(Color::GREEN));
    println!("{}", "Blue on Yellow".fg(Color::BLUE).bg(Color::YELLOW));
    println!("{}", "Custom RGB Color".color(Color::new(255, 165, 0))); // Orange
    println!("{}", "Hex Color".color(Color::from_hex("#FF69B4").unwrap())); // Hot Pink
    println!();

    // Section 2: Text Styling
    println!("=== 2. TEXT STYLING ===");
    println!("{}", "Bold Text".bold());
    println!("{}", "Italic Text".italic());
    println!("{}", "Underlined Text".underline());
    println!("{}", "Strikethrough Text".strikethrough());
    println!("{}", "Dim Text".dim());
    println!("{}", "Bright Text".bright());
    println!("{}", "Reversed Text".reverse());
    println!("{}", "Blinking Text".blink());
    println!();

    // Section 3: Method Chaining
    println!("=== 3. METHOD CHAINING ===");
    println!(
        "{}",
        "Bold Red on Blue".bold().color(Color::RED).bg(Color::BLUE)
    );
    println!(
        "{}",
        "Italic Underlined Green"
            .italic()
            .underline()
            .color(Color::GREEN)
    );
    println!(
        "{}",
        "Bright Magenta with Cyan BG"
            .bright()
            .color(Color::MAGENTA)
            .bg(Color::CYAN)
    );
    println!();

    // Section 4: Gradients
    println!("=== 4. GRADIENTS ===");
    println!("Foreground Gradients:");
    println!(
        "{}",
        "Red to Blue Gradient".gradient(Color::RED, Color::BLUE, None)
    );
    println!(
        "{}",
        "Green to Purple Gradient".gradient(Color::GREEN, Color::PURPLE, None)
    );
    println!(
        "{}",
        "Sunset Colors".gradient(Color::ORANGE, Color::DEEP_PINK, None)
    );

    println!("\nBackground Gradients:");
    println!(
        "{}",
        "Ocean Waves".gradient_bg(Color::DEEP_SKY_BLUE, Color::TEAL, None)
    );
    println!(
        "{}",
        "Forest Floor".gradient_bg(Color::DARK_GREEN, Color::BROWN, None)
    );

    println!("\nMultiline Gradients:");
    let multiline = "Line One\nLine Two\nLine Three";
    println!("Block mode (each line separate):");
    println!(
        "{}",
        multiline.gradient(Color::RED, Color::BLUE, Some(true))
    );
    println!("Continuous mode (across lines):");
    println!(
        "{}",
        multiline.gradient(Color::CYAN, Color::MAGENTA, Some(false))
    );
    println!();

    // Section 5: Shimmer Effects
    println!("=== 5. SHIMMER EFFECTS ===");
    println!("Static Shimmer Renders:");
    println!(
        "{}",
        "✨ Golden Shimmer ✨"
            .shimmer(Color::GOLD, None)
            .static_render()
    );
    println!(
        "{}",
        "💎 Diamond Shine 💎".shine(Color::WHITE).static_render()
    );
    println!(
        "{}",
        "🌟 Stellar Glow 🌟"
            .glow(Color::YELLOW, 200)
            .static_render()
    );
    println!(
        "{}",
        "🌈 Rainbow Gradient 🌈"
            .shimmer_gradient(Color::RED, Color::VIOLET, None)
            .static_render()
    );
    println!();

    // Section 6: Predefined Colors Showcase
    println!("=== 6. PREDEFINED COLORS SHOWCASE ===");
    let colors = vec![
        ("Fire", Color::RED),
        ("Ocean", Color::BLUE),
        ("Forest", Color::GREEN),
        ("Sun", Color::YELLOW),
        ("Lavender", Color::LAVENDER),
        ("Coral", Color::CORAL),
        ("Gold", Color::GOLD),
        ("Silver", Color::SILVER),
        ("Rose", Color::HOT_PINK),
        ("Emerald", Color::LIME_GREEN),
    ];

    for (name, color) in colors {
        println!("{}", format!("● {}", name).color(color));
    }
    println!();

    // Section 7: Creative Combinations
    println!("=== 7. CREATIVE COMBINATIONS ===");

    // Logo-style text
    println!(
        "{}",
        "T".color(Color::RED).to_string()
            + &"I".color(Color::ORANGE).to_string()
            + &"N".color(Color::YELLOW).to_string()
            + &"T".color(Color::GREEN).to_string()
            + &"E".color(Color::BLUE).to_string()
            + &"R".color(Color::INDIGO).to_string()
            + &"M".color(Color::VIOLET)
    );

    // Progress bar simulation
    let _progress_full = "████████████████████";
    let _progress_empty = "░░░░░░░░░░░░░░░░░░░░";
    println!(
        "Progress: [{}{}] 75%",
        "███████████████".bg(Color::GREEN),
        "░░░░░".color(Color::DARK_GRAY)
    );

    // Status indicators
    println!("Status: {} Ready", "●".color(Color::GREEN));
    println!("Status: {} Warning", "●".color(Color::YELLOW));
    println!("Status: {} Error", "●".color(Color::RED));

    // Syntax highlighting simulation
    println!("\nSyntax Highlighting Example:");
    println!(
        "{} {} {} {}{}{}",
        "fn".color(Color::PURPLE),
        "main".color(Color::BLUE),
        "()".color(Color::YELLOW),
        "{".color(Color::WHITE),
        "\n    println!".color(Color::CYAN),
        "();".color(Color::WHITE)
    );
    println!("{}", "}".color(Color::WHITE));
    println!();

    // Section 8: Performance Test
    println!("=== 8. PERFORMANCE TEST ===");
    let start = std::time::Instant::now();
    for i in 0..1000 {
        let _colored = format!("Line {}", i).color(Color::BLUE);
    }
    let duration = start.elapsed();
    println!("Rendered 1000 colored strings in: {:?}", duration);

    // Final showcase
    println!(
        "\n{}",
        "🎉 Tinterm Demo Complete! 🎉".gradient(Color::RED, Color::BLUE, None)
    );
    println!(
        "{}",
        "Thank you for using Tinterm!"
            .shimmer(Color::GOLD, None)
            .static_render()
    );
}

pub fn to_hex(&self) -> String

Converts the color to a hexadecimal string representation.

Returns a 6-digit uppercase hex string with ‘#’ prefix.

Examples

use tinterm::Color;

let red = Color::new(255, 0, 0);
assert_eq!(red.to_hex(), "#FF0000");

impl Color

Predefined colors for convenience

pub const RED: Color

pub const GREEN: Color

pub const BLUE: Color

pub const YELLOW: Color

pub const MAGENTA: Color

pub const CYAN: Color

pub const WHITE: Color

pub const BLACK: Color

pub const PINK: Color

pub const LIGHT_PINK: Color

pub const HOT_PINK: Color

pub const DEEP_PINK: Color

pub const PALE_VIOLET_RED: Color

pub const MEDIUM_VIOLET_RED: Color

pub const LIGHT_SALMON: Color

pub const SALMON: Color

pub const DARK_SALMON: Color

pub const LIGHT_CORAL: Color

pub const INDIAN_RED: Color

pub const CRIMSON: Color

pub const FIRE_BRICK: Color

pub const DARK_RED: Color

pub const ORANGE_RED: Color

pub const TOMATO: Color

pub const CORAL: Color

pub const DARK_ORANGE: Color

pub const ORANGE: Color

pub const LIGHT_YELLOW: Color

pub const LEMON_CHIFFON: Color

pub const LIGHT_GOLDENROD_YELLOW: Color

pub const PAPAYA_WHIP: Color

pub const MOCCASIN: Color

pub const PEACH_PUFF: Color

pub const PALE_GOLDENROD: Color

pub const KHAKI: Color

pub const DARK_KHAKI: Color

pub const GOLD: Color

pub const CORNSILK: Color

pub const BLANCHED_ALMOND: Color

pub const BISQUE: Color

pub const NAVAJO_WHITE: Color

pub const WHEAT: Color

pub const BURLYWOOD: Color

pub const TAN: Color

pub const ROSY_BROWN: Color

pub const SANDY_BROWN: Color

pub const GOLDENROD: Color

pub const DARK_GOLDENROD: Color

pub const PERU: Color

pub const CHOCOLATE: Color

pub const SADDLE_BROWN: Color

pub const SIENNA: Color

pub const BROWN: Color

pub const MAROON: Color

pub const GREEN_YELLOW: Color

pub const CHARTREUSE: Color

pub const LAWN_GREEN: Color

pub const LIME: Color

pub const LIME_GREEN: Color

pub const PALE_GREEN: Color

pub const LIGHT_GREEN: Color

pub const MEDIUM_SPRING_GREEN: Color

pub const SPRING_GREEN: Color

pub const MEDIUM_SEA_GREEN: Color

pub const SEA_GREEN: Color

pub const FOREST_GREEN: Color

pub const DARK_GREEN: Color

pub const YELLOW_GREEN: Color

pub const OLIVE_DRAB: Color

pub const OLIVE: Color

pub const DARK_OLIVE_GREEN: Color

pub const MEDIUM_AQUAMARINE: Color

pub const DARK_SEA_GREEN: Color

pub const LIGHT_SEA_GREEN: Color

pub const DARK_CYAN: Color

pub const TEAL: Color

pub const AQUA: Color

pub const LIGHT_CYAN: Color

pub const PALE_TURQUOISE: Color

pub const AQUAMARINE: Color

pub const TURQUOISE: Color

pub const MEDIUM_TURQUOISE: Color

pub const DARK_TURQUOISE: Color

pub const CADET_BLUE: Color

pub const STEEL_BLUE: Color

pub const LIGHT_STEEL_BLUE: Color

pub const POWDER_BLUE: Color

pub const LIGHT_BLUE: Color

pub const SKY_BLUE: Color

pub const LIGHT_SKY_BLUE: Color

pub const DEEP_SKY_BLUE: Color

pub const DODGER_BLUE: Color

pub const CORNFLOWER_BLUE: Color

pub const MEDIUM_SLATE_BLUE: Color

pub const ROYAL_BLUE: Color

pub const MEDIUM_BLUE: Color

pub const DARK_BLUE: Color

pub const NAVY: Color

pub const MIDNIGHT_BLUE: Color

pub const LAVENDER: Color

pub const THISTLE: Color

pub const PLUM: Color

pub const VIOLET: Color

pub const ORCHID: Color

pub const FUCHSIA: Color

pub const MEDIUM_ORCHID: Color

pub const MEDIUM_PURPLE: Color

pub const BLUE_VIOLET: Color

pub const DARK_VIOLET: Color

pub const DARK_ORCHID: Color

pub const DARK_MAGENTA: Color

pub const PURPLE: Color

pub const INDIGO: Color

pub const SLATE_BLUE: Color

pub const DARK_SLATE_BLUE: Color

pub const GAINSBORO: Color

pub const LIGHT_GRAY: Color

pub const SILVER: Color

pub const DARK_GRAY: Color

pub const GRAY: Color

pub const DIM_GRAY: Color

pub const LIGHT_SLATE_GRAY: Color

pub const SLATE_GRAY: Color

pub const DARK_SLATE_GRAY: Color

pub const ALICE_BLUE: Color

pub const GHOST_WHITE: Color

pub const HONEYDEW: Color

pub const IVORY: Color

pub const AZURE: Color

pub const SNOW: Color

pub const FLORAL_WHITE: Color

pub const WHITE_SMOKE: Color

pub const SEASHELL: Color

pub const BEIGE: Color

pub const OLD_LACE: Color

pub const MINT_CREAM: Color

pub const LAVENDER_BLUSH: Color

pub const MISTY_ROSE: Color

Trait Implementations

impl Clone for Color

fn clone(&self) -> Color

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Color

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

Formats the value using the given formatter.

impl PartialEq for Color

fn eq(&self, other: &Color) -> 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 Color

impl Eq for Color

impl StructuralPartialEq for Color