A lossy image compression algorithm, based in a per-block level of detail detection, implemented in Rust.

pixzlr

• pixzlr
  • Installing
  • Using
    • Before using it
    • Using the old API
    • Using the new API
  • CLI
  • Core concept

Installing

Just put pixlzr = "0" as one of the [dependencies] into your Cargo.toml.

Using

Before using it

Now, the crate pixlzr have two parallel APIs, with different uses and functionalities.

The base use, of reducing / shrinking a crate image::DynamicImage, is present in both. But in the future, the old API will be either deleted or rewritten based on the new one, which supports file saving / readding.

Using the old API

use image::{open, DynamicImage};
use pixlzr::process::{
    process,
    tree::{
        process as tree_process,
        full as tree_full_process
    }
};

// ...

let image: DynamicImage = open("img.png")?;

process(&image, 64, Some(|v| v / 4.0)): DynamicImage
    .save("img-processed.png")?;

tree_process(&image, 64, 0.25, Some(|v| v / 6.0)): DynamicImage
    .save("img-processed-tree.png")?;

tree_full_process(&image, 0.25, Some(|v| v / 6.0)): DynamicImage
    .save("img-processed-tree-full.png")?;

Using the new API

// Importing
use image::{open, DynamicImage};
use pixlzr::{FilterType, Pixlzr};

// Convert to
let png: DynamicImage = open("img.png");

let mut pix = Pixlzr::from_image(&img, 64, 64u32);
pix.shrink_by(FilterType::Gaussian, 0.8);

pix.save("pix-lized image.pixlzr")?;

// Convert from
let pix = Pixlzr::open("pix-lized image.pixlzr")?;
let img = pix.to_image(FilterType::Nearest)?;
img.save("reduced-img.png");

CLI

The CLI can be understood with a run of pixlzr -h.

Pixlzr - A rust lib and CLI for the pixlzr image format

Usage: pixlzr [OPTIONS] --input <INPUT> --output <OUTPUT>

Options:
  -i, --input <INPUT>                The input image file
  -o, --output <OUTPUT>              The output image file
  -b, --block-width <BLOCK_WIDTH>    The width of each block [default: 64]
      --block-height <BLOCK_HEIGHT>  The height of each block
  -k, --shrink-by <SHRINK_BY>        The shrinking factor [default: 1]
      --filter <FILTER>              The filter used when resizing the image blocks [default: lanczos3] [possible values: nearest, triangle, catmull-rom, gaussian, lanczos3]
  -h, --help                         Print help (see more with '--help')
  -V, --version                      Print version

It converts from and to the pixlzr format, with use of the crate image.

Core concept

Yet to be written...
Please check GitHub:guiga-zalu/smart-pixelizer, as it's the implementation in Node JS.