https://github.com/porglezomp/pixel-canvas

A crate to make drawing in a buffer of pixels easy!
https://github.com/porglezomp/pixel-canvas

art crate graphics interactive rust

Last synced: 2 months ago
JSON representation

A crate to make drawing in a buffer of pixels easy!

• Host: GitHub
• URL: https://github.com/porglezomp/pixel-canvas
• Owner: porglezomp
• Created: 2019-08-20T07:26:43.000Z (over 5 years ago)
• Default Branch: develop
• Last Pushed: 2023-08-31T22:17:16.000Z (over 1 year ago)
• Last Synced: 2024-10-11T03:17:42.893Z (3 months ago)
• Topics: art, crate, graphics, interactive, rust
• Language: Rust
• Homepage: https://docs.rs/pixel-canvas/
• Size: 28.3 KB
• Stars: 30
• Watchers: 5
• Forks: 9
• Open Issues: 3
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
[![Crates.io](https://img.shields.io/crates/v/pixel-canvas.svg)](https://crates.io/crates/pixel-canvas)

[![Docs.rs](https://docs.rs/pixel-canvas/badge.svg)](https://docs.rs/pixel-canvas)

[![Build Status](https://travis-ci.org/porglezomp/pixel-canvas.svg?branch=develop)](https://travis-ci.org/porglezomp/pixel-canvas)

# 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

 and ,

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

```rust

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):

```sh

cargo +nightly run --example api_example

```

License: MIT OR Apache-2.0