Crate omage

omage

omage is a Rust crate for creating images with various components.

Features

• Configurable Canvas: Easily create customizable canvases with specified dimensions, background color, and optional borders.
• Draw Components: Utilize a variety of drawable components, including circles, rectangles, lines, and text, to create complex images.
• Convenient Color Constants: Access a set of common RGBA colors through the colors module.

Usage

To use omage, you can start by creating a Config for your canvas, adding drawable components with the Components struct, and rendering the image with the Image struct.

use omage::{Config, Components, Image, Rgba};

// Create a new canvas configuration
let config = Config::new(800, 600, Rgba([255, 255, 255, 255]), Some(Rgba([0, 0, 0, 255])),
                         "path/to/canvas/image.png", Some("path/to/font.ttf"));

// Creane new drawable components
let components = vec![
    Components::Circle(50, 50, 30, Rgba([255, 0, 0, 255])),
    Components::Rectangle(40, 60, 10, 20, Rgba([0, 255, 0, 255])),
    Components::Line(10, 10, 80, 80, Rgba([0, 0, 255, 255])),
    Components::Text(30, 40, 16, "Hello, Rust!", Rgba([255, 255, 255, 255]), Some((Rgba([0, 0, 0, 255]), 2))),
];

// Create a new image with the specified configuration
let mut image = Image::new();
image.config(config).init().unwrap().add_components(components).draw().unwrap();

Modules

• colors: Constants for common RGBA colors.
• components: Convenience methods for creating different types of drawable components.
• config: Configuration settings for the drawing canvas.
• error: Custom error types for the omage crate.
• images: Represents an image with configurable settings and drawable components.

Example

use omage::colors::*;
use omage::{Components, Config, Image, Rgba};

const HEIGHT: u32 = 100;
const WIDTH: u32 = 300;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let config = Config::new(
        WIDTH,
        HEIGHT,
        Rgba([255, 255, 255, 0]),
        Some(WHITE),
        "output.png",
        Some("./fonts/Roboto-Medium.ttf"),
    );

    let mut image = Image::new();

    let circle1 = Components::Circle(50, 55, 30, Rgba([255, 0, 0, 200]));
    let circle2 = Components::Circle(75, 55, 30, Rgba([0, 255, 0, 200]));
    let circle3 = Components::Circle(65, 35, 30, Rgba([0, 0, 255, 200]));

    let text = "OMAGE";
    let text = Components::Text(
        config.width / 2 - 40,
        config.height / 2 - 25,
        50,
        text,
        Rgba([255, 255, 255, 255]),
        Some((BLACK, 3)),
    );

    image
        .config(config)
        .init()?
        .add_components(vec![&text, &circle1, &circle2, &circle3])
        .draw()?;
    Ok(())
}

License

This crate is licensed under the MIT License - see the LICENSE file for details.

Modules

colors

Constants for common RGBA colors.

Structs

Components

A struct providing convenience methods for creating different types of components.

Config

The Config struct holds configuration settings for the drawing canvas.

Image

Represents an image with configurable settings and drawable components.

Rgba

RGB colors + alpha channel