Struct PixelCanvas

pub struct PixelCanvas {
    pub width: u32,
    pub height: u32,
    pub background_color: [u8; 3],
    pub buffer: Vec<u8>,
    pub margin: u32,
}

A structure representing a pixel-based drawing canvas.

Fields

width: u32

Width of the canvas in pixels.

height: u32

Height of the canvas in pixels.

background_color: [u8; 3]

Background color of the canvas (RGB format).

buffer: Vec<u8>

Buffer storing pixel data as a linear array.

margin: u32

Margin around the canvas (in pixels).

Implementations

impl PixelCanvas

pub fn new( width: u32, height: u32, background_color: [u8; 3], margin: u32, ) -> Self

Creates a new PixelCanvas with the specified dimensions, background color, and margin.

Parameters

• width: The width of the canvas in pixels.
• height: The height of the canvas in pixels.
• background_color: The RGB color of the canvas background.
• margin: Margin size in pixels.

Returns

A new PixelCanvas instance.

pub fn clear(&mut self)

Clears the canvas by filling it with the background color.

pub fn draw_pixel(&mut self, x: u32, y: u32, color: [u8; 3])

Draws a single pixel at the specified coordinates with the given color.

Parameters

• x: The x-coordinate of the pixel.
• y: The y-coordinate of the pixel.
• color: The RGB color of the pixel.

pub fn blend_pixel(&mut self, x: u32, y: u32, color: [u8; 3], alpha: f64)

Blends a pixel with the specified color and alpha value.

Parameters

• x: The x-coordinate of the pixel.
• y: The y-coordinate of the pixel.
• color: The RGB color to blend.
• alpha: The transparency value (0.0 to 1.0).

pub fn draw_horizontal_line(&mut self, y: u32, color: [u8; 3])

Draws a horizontal line at the specified y-coordinate.

Parameters

• y: The y-coordinate of the line.
• color: The RGB color of the line.

pub fn draw_vertical_line(&mut self, x: u32, color: [u8; 3])

Draws a vertical line at the specified x-coordinate.

Parameters

• x: The x-coordinate of the line.
• color: The RGB color of the line.

pub fn draw_grid(&mut self, grid_size: &[usize; 2], color: [u8; 3])

Draws a grid on the canvas.

Parameters

• grid_size: An array specifying the spacing of grid lines in the x and y directions.
• color: The RGB color of the grid lines.

pub fn draw_text_vertical( &mut self, x: u32, y: u32, text: &str, color: [u8; 3], font: &FontRef<'_>, scale: PxScale, )

Draws text vertically at the specified position.

Parameters

• x: The x-coordinate for the text.
• y: The y-coordinate for the text.
• text: The text content.
• color: The RGB color of the text.
• font: The font reference for rendering text.
• scale: The scaling factor for the font size.

pub fn draw_text( &mut self, x: u32, y: u32, text: &str, color: [u8; 3], font: &FontRef<'_>, scale: PxScale, )

Draws text at the specified position.

Parameters

• x: The x-coordinate for the text.
• y: The y-coordinate for the text.
• text: The text content.
• color: The RGB color of the text.
• font: The font reference for rendering text.
• scale: The scaling factor for the font size.

pub fn draw_line( &mut self, x1: i32, y1: i32, x2: i32, y2: i32, color: [u8; 3], line_type: LineType, )

Draws a line with the specified type (solid, dashed, or dotted).

Parameters

• x1, y1: Coordinates of the start point.
• x2, y2: Coordinates of the end point.
• color: The RGB color of the line.
• line_type: The type of line to draw (LineType).

pub fn save_as_image(&self, file_path: &str)

Saves the current canvas as an image file.

Parameters

• file_path: The path to save the image file.

Panics

Panics if the image cannot be saved.