pixel-canvas

Crates.iopixel-canvas
lib.rspixel-canvas
version0.2.3
sourcesrc
created_at2019-08-25 08:59:35.15211
updated_at2022-06-19 22:40:28.170575
descriptionA crate to make it easy to build interactive computer art with just a pixel buffer.
homepage
repositoryhttps://github.com/porglezomp/pixel-canvas
max_upload_size
id159517
size77,948
Plonky2 - release (github:0xpolygonzero:plonky2-release)

documentation

README

Crates.io Docs.rs Build Status

Pixel Canvas

This crate is designed to make it easy to build interactive computer art with just a pixel buffer. For inspiration, consider looking at https://shadertoy.com and http://www.iquilezles.org/www/index.htm, there are a lot of cool art pieces to see and explanations of fun techniques!

Usage

To make a piece of art, you create and configure a Canvas object, and then you ask it to render with your code. The canvas will do state management and hand you an image to modify. Whatever modifications you make to the image will be displayed on the screen.

Example

use pixel_canvas::{Canvas, Color, input::MouseState};

fn main() {
    // Configure the window that you want to draw in. You can add an event
    // handler to build interactive art. Input handlers for common use are
    // provided.
    let canvas = Canvas::new(512, 512)
        .title("Tile")
        .state(MouseState::new())
        .input(MouseState::handle_input);
    // The canvas will render for you at up to 60fps.
    canvas.render(|mouse, image| {
        // Modify the `image` based on your state.
        let width = image.width() as usize;
        for (y, row) in image.chunks_mut(width).enumerate() {
            for (x, pixel) in row.iter_mut().enumerate() {
                let dx = x as i32 - mouse.x;
                let dy = y as i32 - mouse.y;
                let dist = dx * dx + dy * dy;
                *pixel = Color {
                    r: if dist < 128 * 128 { dy as u8 } else { 0 },
                    g: if dist < 128 * 128 { dx as u8 } else { 0 },
                    b: (x * y) as u8,
                }
            }
        }
    });
}

or run an included example (with nightly):

cargo +nightly run --example api_example

License: MIT OR Apache-2.0

Commit count: 27

cargo fmt