Skip to content

pierogis/mmpx-rs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mmpx-rs

Crates.io

This is a Rust version of the MMPX image magnifying algorithm as presented by Morgan McGuire and Mara Gagiu.

All rights to this algorithm belong to the authors, and their choice of the MIT license applies to this implementation as well (see LICENSE.md).

algorithm

The algorithm is designed for scaling up pixel art 2x by testing various rules against the neighborhood of each source pixel to map the 4 outcome pixels. It borrows and builds on some concepts from nearest neighbor and EPX (other common methods for pixel art scaling).

The algorithm offers modular neighborhood based rules that operate sequentially, enabling some future work to potentially add more rules under this same multithreaded processing "environment".

A key assumption in these rules is that nearby pixels have the same RGB value, meaning non pixel art style images will likely fall back to nearest neighbor.

cli

$ cargo install mmpx
$ mmpx input.png --output output.png

library

Cargo.toml
[dependencies.mmpx]
version = "0.1.0"
main.rs
use mmpx;
use image::RgbaImage;
.
.
.
// Load using image
let image: RgbaImage = image::open(input_path).unwrap().to_rgba8();
// Magnify 2x
let output: RgbaImage = mmpx::magnify(&image);

implementation

This implementation uses Rust for memory safety and the rayon crate to process pixels in parallel. The only processing logic that intentionally differs from the C version offered by the authors is in the calculation of luma for a given pixel (a minor effect, if any).

Performance seems similar to the single threaded C implementation, making this potentially usable for realtime rendering. Testing has been minimal and improvements could come from using a dry image buffer like the c version instead of the image crate's ImageBuffer.

About

an image magnifying algorithm implementation

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages