revue 2.71.1

A Vue-style TUI framework for Rust with CSS styling
Documentation
//! Canvas widget implementations

use super::braille::{BrailleContext, BrailleGrid};
use super::draw::DrawContext;
use crate::widget::traits::{RenderContext, View};

/// A canvas widget for custom drawing (character-based)
pub struct Canvas<F>
where
    F: Fn(&mut DrawContext),
{
    draw_fn: F,
}

impl<F> Canvas<F>
where
    F: Fn(&mut DrawContext),
{
    /// Create a new canvas with a drawing function
    pub fn new(draw_fn: F) -> Self {
        Self { draw_fn }
    }
}

impl<F> View for Canvas<F>
where
    F: Fn(&mut DrawContext),
{
    fn render(&self, ctx: &mut RenderContext) {
        let mut draw_ctx = DrawContext::new(ctx.buffer, ctx.area);
        (self.draw_fn)(&mut draw_ctx);
    }
}

/// Create a canvas with a drawing function
pub fn canvas<F>(draw_fn: F) -> Canvas<F>
where
    F: Fn(&mut DrawContext),
{
    Canvas::new(draw_fn)
}

/// A high-resolution canvas using braille patterns
///
/// Each terminal cell represents a 2x4 dot matrix, providing
/// 2x horizontal and 4x vertical resolution.
///
/// # Example
///
/// ```rust,ignore
/// use revue::prelude::*;
///
/// let chart = BrailleCanvas::new(|ctx| {
///     // Draw a sine wave
///     let points: Vec<(f64, f64)> = (0..ctx.width())
///         .map(|x| {
///             let y = (x as f64 * 0.1).sin() * 10.0 + 20.0;
///             (x as f64, y)
///         })
///         .collect();
///     ctx.points(points, Color::CYAN);
///
///     // Draw a circle
///     ctx.circle(40.0, 20.0, 15.0, Color::YELLOW);
/// });
/// ```
pub struct BrailleCanvas<F>
where
    F: Fn(&mut BrailleContext),
{
    draw_fn: F,
}

impl<F> BrailleCanvas<F>
where
    F: Fn(&mut BrailleContext),
{
    /// Create a new braille canvas with a drawing function
    pub fn new(draw_fn: F) -> Self {
        Self { draw_fn }
    }
}

impl<F> View for BrailleCanvas<F>
where
    F: Fn(&mut BrailleContext),
{
    fn render(&self, ctx: &mut RenderContext) {
        let mut grid = BrailleGrid::new(ctx.area.width, ctx.area.height);
        let mut braille_ctx = BrailleContext::new(&mut grid);
        (self.draw_fn)(&mut braille_ctx);
        grid.render(ctx.buffer, ctx.area);
    }
}

/// Create a braille canvas with a drawing function
pub fn braille_canvas<F>(draw_fn: F) -> BrailleCanvas<F>
where
    F: Fn(&mut BrailleContext),
{
    BrailleCanvas::new(draw_fn)
}