Aloe Colour Crate

Aloe Colour is a powerful Rust library for managing and manipulating colours and gradients in graphics programming. This crate facilitates the creation and application of complex colour gradients, supports detailed ARGB and RGB handling, and incorporates advanced blending and compositing operations essential for high-performance graphics rendering.

Features

• ColourPoint: Represents a point with a specific colour, allowing for position-based colour application.
• ColourGradient: Allows the creation of linear and radial colour gradients, facilitating smooth transitions between colours.
• Colour Representation: Handles colours with transparency using 8-bit ARGB values, enabling nuanced shading and opacity effects.
• Pixel Compositing: Premultiplied alpha handling and pixel compositing operations streamline complex imaging tasks.
• Colour Transformations: Supports modification and interpolation of colours based on ARGB and RGB values and includes utilities for HSV/HSL transformations.

Usage

Integrate Aloe Colour into your project to manage sophisticated colour gradients and enhance your graphic rendering processes. Access various methods to manipulate colours, such as modifying hue, saturation, brightness, and creating lookup tables for gradient interpolation.

Example

use aloe_colour::{Colour, ColourGradient, ColourPoint};

// Create Colours
let start_colour = Colour::new_from_rgb(255, 0, 0); // Red
let end_colour = Colour::new_from_rgb(0, 0, 255);   // Blue

// Define Gradient
let gradient = ColourGradient::vertical(start_colour, end_colour, rectangle_area);

// Add intermediate point
gradient.add_colour(0.5, Colour::new_from_rgb(0, 255, 0)); // Green

// Apply Gradient
// Your canvas or drawing logic here...

Advanced Concepts

Aloe Colour supports premultiplied alpha via PixelARGB, which optimizes blending operations by handling transparency at the pixel level, crucial for rendering pipeline efficiency. The HSV and HSL transformation capabilities provide flexibility in adjusting colour properties, ideal for dynamic animations and rich graphical applications.

Note: This README.md file was generated by an AI model and while its content is intended to be accurate, it may not perfectly represent the library's most current state. Always refer to the official documentation and source code.

License

This project is licensed under the GPL-3.0 License.

Contributions

We welcome contributions from the community. Please refer to our contribution guidelines on the GitHub repository: aloe-rs GitHub Repository

Authors

• klebs tpk3.mx@gmail.com

This crate is a translation of the JUCE module.

JUCE is a c++ software framework for developing high performance audio applications.

Usage falls under the GPLv3 as well as the JUCE commercial license.

See github.com/juce-framework/JUCE and the JUCE license page for details.

This crate is in the process of being translated from c++ to rust. For progress updates, please see the workspacer rust project. designed specifically for rust projects.