omage 0.3.11

`omage` is a Rust library for image processing. It provides functionality for handling images, drawing basic shapes, and configuring image properties.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

use image::Pixel;

use super::{ComponentTrait, Config, CustomError, Error, ImageBuffer, Rgba};

/// Represents a rectangle component with a specified height (`h`), width (`w`), position (`(x, y)`), and color.
#[derive(Clone, Copy)]
pub struct Rectangle {
    /// Height of the rectangle.
    h: u32,
    /// Width of the rectangle.
    w: u32,
    /// X-coordinate of the top-left corner of the rectangle.
    x: u32,
    /// Y-coordinate of the top-left corner of the rectangle.
    y: u32,
    /// Color of the rectangle in Rgba format.
    color: Rgba<u8>,
}

impl Rectangle {
    /// Creates a new rectangle with the specified parameters.
    pub fn new(h: u32, w: u32, x: u32, y: u32, color: Rgba<u8>) -> Self {
        Self { h, w, x, y, color }
    }
}

impl ComponentTrait for Rectangle {
    /// Draws the rectangle on the provided image buffer using the specified configuration.
    ///
    /// # Arguments
    ///
    /// * `config` - Configuration for the drawing canvas.
    /// * `buffer` - Image buffer to draw the rectangle on.
    ///
    /// # Errors
    ///
    /// Returns an error if the rectangle goes beyond the canvas boundaries.
    fn draw(
        &self,
        config: Config,
        buffer: &mut ImageBuffer<Rgba<u8>, Vec<u8>>,
    ) -> Result<(), Box<dyn Error>> {
        for x in self.x..self.x + self.w {
            if x > config.width {
                return Err(Box::new(CustomError::OutOfCanvas));
            }
            for y in self.y..self.y + self.h {
                if y > config.height {
                    return Err(Box::new(CustomError::OutOfCanvas));
                }
                buffer.get_pixel_mut(x, y).blend(&self.color)
            }
        }

        Ok(())
    }
}