tui-banner 0.2.1

// Copyright (c) 2025 Lei Zhang
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

use crate::grid::Grid;

/// Fill strategy for visible cells.
#[derive(Clone, Copy, Debug)]
pub enum Fill {
    /// Replace visible cells with a single character.
    Solid(char),
    /// Replace visible cells with `#`.
    Blocks,
    /// Keep original glyph characters.
    Keep,
    /// Pixel fill using a block character, with optional dot dithering.
    Pixel {
        /// Block character to use.
        block: char,
        /// Optional dither configuration.
        dither: Option<Dither>,
    },
}

/// Dot dither configuration.
#[derive(Clone, Copy, Debug)]
pub struct Dither {
    /// Dither pattern.
    pub mode: DitherMode,
    /// Primary dot character.
    pub dot: char,
    /// Alternate dot character.
    pub alt: char,
}

/// Dither pattern selection.
#[derive(Clone, Copy, Debug)]
pub enum DitherMode {
    /// Checkerboard pattern with period.
    Checker {
        /// Pattern period.
        period: u8,
    },
    /// Hash-noise pattern with threshold.
    Noise {
        /// Noise seed.
        seed: u32,
        /// Threshold (0..=255).
        threshold: u8,
    },
}

impl Dither {
    /// Checkerboard dither with dot characters (1 or 2 chars).
    pub fn checker(period: u8, dots: &str) -> Self {
        let (dot, alt) = parse_dots(dots);
        Self {
            mode: DitherMode::Checker { period },
            dot,
            alt,
        }
    }

    /// Hash-noise dither with dot characters (1 or 2 chars).
    pub fn noise(seed: u32, threshold: u8, dots: &str) -> Self {
        let (dot, alt) = parse_dots(dots);
        Self {
            mode: DitherMode::Noise { seed, threshold },
            dot,
            alt,
        }
    }
}

impl Fill {
    /// Default block fill.
    pub fn default_blocks() -> Self {
        Fill::Blocks
    }

    /// Pixel fill using a single block character.
    pub fn pixel(block: char) -> Self {
        Fill::Pixel {
            block,
            dither: None,
        }
    }

    /// Pixel fill with built-in dot dithering.
    pub fn pixel_with_dither(block: char, dither: Dither) -> Self {
        Fill::Pixel {
            block,
            dither: Some(dither),
        }
    }
}

/// Apply fill to a grid in-place.
pub fn apply_fill(grid: &mut Grid, fill: Fill) {
    let height = grid.height();
    let width = grid.width();
    for r in 0..height {
        for c in 0..width {
            if let Some(cell) = grid.cell_mut(r, c) {
                if !cell.visible {
                    continue;
                }
                match fill {
                    Fill::Solid(ch) => {
                        cell.ch = ch;
                    }
                    Fill::Blocks => {
                        cell.ch = '#';
                    }
                    Fill::Keep => {}
                    Fill::Pixel { block, dither } => {
                        cell.ch = block;
                        if let Some(dither) = dither
                            && should_dither(r, c, dither.mode)
                        {
                            cell.ch = if (r + c) % 2 == 0 {
                                dither.dot
                            } else {
                                dither.alt
                            };
                        }
                    }
                }
            }
        }
    }
}

fn should_dither(row: usize, col: usize, mode: DitherMode) -> bool {
    match mode {
        DitherMode::Checker { period } => {
            if period == 0 {
                false
            } else {
                (row + col).is_multiple_of(period as usize)
            }
        }
        DitherMode::Noise { seed, threshold } => {
            let hash = mix(seed, row as u32, col as u32);
            (hash & 0xFF) < threshold as u32
        }
    }
}

fn mix(seed: u32, x: u32, y: u32) -> u32 {
    let mut v = seed ^ x.wrapping_mul(0x9E3779B1) ^ y.wrapping_mul(0x85EBCA77);
    v ^= v >> 16;
    v = v.wrapping_mul(0x7FEB352D);
    v ^= v >> 15;
    v = v.wrapping_mul(0x846CA68B);
    v ^= v >> 16;
    v
}

fn parse_dots(dots: &str) -> (char, char) {
    let mut iter = dots.chars();
    let first = iter.next().unwrap_or('·');
    let second = iter.next().unwrap_or(first);
    (first, second)
}