image

Encoding and decoding images in Rust

Latest version: 0.25.2 registry icon
Maintenance score
100
Safety score
91
Popularity score
100
Check your open source dependency risks. Get immediate insight about security, stability and licensing risks.
Security
  Vulnerabilities
Version Suggest Low Medium High Critical
0.25.2 0 0 0 0 0
0.25.1 0 0 0 0 0
0.25.0 0 0 0 0 0
0.24.9 0 0 0 0 0
0.24.8 0 0 0 0 0
0.24.7 0 0 0 0 0
0.24.6 0 0 0 0 0
0.24.5 0 0 0 0 0
0.24.4 0 0 0 0 0
0.24.3 0 0 0 0 0
0.24.2 0 0 0 0 0
0.24.1 0 0 0 0 0
0.24.0 0 0 0 0 0
0.23.14 0 0 0 0 0
0.23.13 0 0 0 0 0
0.23.12 0 0 0 0 0
0.23.11 0 0 1 0 0
0.23.10 0 0 1 0 0
0.23.9 0 0 1 0 0
0.23.8 0 0 1 0 0
0.23.7 0 0 1 0 0
0.23.6 0 0 1 0 0
0.23.5 0 0 1 0 0
0.23.4 0 0 1 0 0
0.23.3 0 0 1 0 0
0.23.2 0 0 1 0 0
0.23.1 0 0 1 0 0
0.23.0 0 0 1 0 0
0.22.5 0 0 1 0 0
0.22.4 0 0 1 0 0
0.22.3 0 0 1 0 0
0.22.2 0 0 1 0 0
0.22.1 0 0 1 0 0
0.22.0 0 0 1 0 0
0.21.3 0 0 1 0 0
0.21.2 0 0 2 0 0
0.21.1 0 0 2 0 0
0.21.0 0 0 2 0 0
0.20.1 0 0 2 0 0
0.20.0 0 0 2 0 0
0.19.0 0 0 2 0 0
0.18.0 0 0 2 0 0
0.17.0 0 0 2 0 0
0.16.0 0 0 2 0 0
0.15.0 0 0 2 0 0
0.14.0 0 0 2 0 0
0.13.0 0 0 2 0 0
0.12.4 0 0 2 0 0
0.12.3 0 0 2 0 0
0.12.2 0 0 2 0 0
0.12.1 0 0 2 0 0
0.12.0 0 0 2 0 0
0.11.1 0 0 2 0 0
0.11.0 0 0 2 0 0
0.10.4 0 0 2 0 0
0.10.3 0 0 2 0 0
0.10.2 0 0 2 0 0
0.10.1 0 0 1 0 0
0.10.0 0 0 1 0 0
0.9.1 0 0 1 0 0
0.9.0 0 0 1 0 0
0.8.0 0 0 1 0 0
0.7.2 0 0 1 0 0
0.7.1 0 0 1 0 0
0.7.0 0 0 1 0 0
0.6.1 0 0 1 0 0
0.6.0 0 0 1 0 0
0.5.4 0 0 1 0 0
0.5.3 0 0 1 0 0
0.5.2 0 0 1 0 0
0.5.1 0 0 1 0 0
0.5.0 0 0 1 0 0
0.4.1 0 0 1 0 0
0.4.0 0 0 1 0 0
0.3.15 0 0 1 0 0
0.3.14 0 0 1 0 0
0.3.13 0 0 1 0 0
0.3.12 0 0 1 0 0
0.3.11 0 0 1 0 0
0.3.10 0 0 1 0 0
0.3.9 0 0 1 0 0
0.3.8 0 0 1 0 0
0.3.7 0 0 1 0 0
0.3.6 0 0 1 0 0
0.3.5 0 0 1 0 0
0.3.4 0 0 1 0 0
0.3.3 0 0 1 0 0
0.3.2 0 0 1 0 0
0.3.1 0 0 1 0 0
0.3.0 0 0 1 0 0
0.2.4 0 0 1 0 0
0.2.3 0 0 1 0 0
0.2.2 0 0 1 0 0
0.2.1 0 0 1 0 0
0.2.0 0 0 1 0 0

Stability
Latest release:

0.25.2 - This version is safe to use because it has no known security vulnerabilities at this time. Find out if your coding project uses this component and get notified of any reported security vulnerabilities with Meterian-X Open Source Security Platform

Licensing

Maintain your licence declarations and avoid unwanted licences to protect your IP the way you intended.

Apache-2.0   -   Apache License 2.0

Not a wildcard

Not proprietary

OSI Compliant


MIT   -   MIT License

Not a wildcard

Not proprietary

OSI Compliant



Image

crates.io Documentation Build Status Gitter

Maintainers: @HeroicKatora, @fintelia

How to contribute

An Image Processing Library

This crate provides basic image processing functions and methods for converting to and from various image formats.

All image processing functions provided operate on types that implement the GenericImageView and GenericImage traits and return an ImageBuffer.

High level API

Load images using [ImageReader]:

use std::io::Cursor;
use image::ImageReader;

let img = ImageReader::open("myimage.png")?.decode()?;
let img2 = ImageReader::new(Cursor::new(bytes)).with_guessed_format()?.decode()?;

And save them using [save] or [write_to] methods:

img.save("empty.jpg")?;

let mut bytes: Vec<u8> = Vec::new();
img2.write_to(&mut Cursor::new(&mut bytes), image::ImageFormat::Png)?;

Supported Image Formats

With default features enabled, image provides implementations of many common image format encoders and decoders.

Format Decoding Encoding
AVIF Yes (8-bit only) * Yes (lossy only)
BMP Yes Yes
DDS Yes ---
Farbfeld Yes Yes
GIF Yes Yes
HDR Yes Yes
ICO Yes Yes
JPEG Yes Yes
EXR Yes Yes
PNG Yes Yes
PNM Yes Yes
QOI Yes Yes
TGA Yes Yes
TIFF Yes Yes
WebP Yes Yes (lossless only)
  • * Requires the avif-native feature, uses the libdav1d C library.

Image Types

This crate provides a number of different types for representing images. Individual pixels within images are indexed with (0,0) at the top left corner.

An image parameterised by its Pixel type, represented by a width and height and a vector of pixels. It provides direct access to its pixels and implements the GenericImageView and GenericImage traits.

A DynamicImage is an enumeration over all supported ImageBuffer<P> types. Its exact image type is determined at runtime. It is the type returned when opening an image. For convenience DynamicImage reimplements all image processing functions.

Traits that provide methods for inspecting (GenericImageView) and manipulating (GenericImage) images, parameterised over the image's pixel type.

A view into another image, delimited by the coordinates of a rectangle. The coordinates given set the position of the top left corner of the rectangle. This is used to perform image processing functions on a subregion of an image.

All image format decoders implement the ImageDecoder trait which provide basic methods for getting image metadata and decoding images. Some formats additionally provide ImageDecoderRect implementations which allow for decoding only part of an image at once.

The most important methods for decoders are...

  • dimensions: Return a tuple containing the width and height of the image.
  • color_type: Return the color type of the image data produced by this decoder.
  • read_image: Decode the entire image into a slice of bytes.

Pixels

image provides the following pixel types:

  • Rgb: RGB pixel
  • Rgba: RGB with alpha (RGBA pixel)
  • Luma: Grayscale pixel
  • LumaA: Grayscale with alpha

All pixels are parameterised by their component type.

Image Processing Functions

These are the functions defined in the imageops module. All functions operate on types that implement the GenericImage trait. Note that some of the functions are very slow in debug mode. Make sure to use release mode if you experience any performance issues.

  • blur: Performs a Gaussian blur on the supplied image.
  • brighten: Brighten the supplied image.
  • huerotate: Hue rotate the supplied image by degrees.
  • contrast: Adjust the contrast of the supplied image.
  • crop: Return a mutable view into an image.
  • filter3x3: Perform a 3x3 box filter on the supplied image.
  • flip_horizontal: Flip an image horizontally.
  • flip_vertical: Flip an image vertically.
  • grayscale: Convert the supplied image to grayscale.
  • invert: Invert each pixel within the supplied image This function operates in place.
  • resize: Resize the supplied image to the specified dimensions.
  • rotate180: Rotate an image 180 degrees clockwise.
  • rotate270: Rotate an image 270 degrees clockwise.
  • rotate90: Rotate an image 90 degrees clockwise.
  • unsharpen: Performs an unsharpen mask on the supplied image.

For more options, see the imageproc crate.

Examples

Opening and Saving Images

image provides the open function for opening images from a path. The image format is determined from the path's file extension. An io module provides a reader which offer some more control.

use image::GenericImageView;

// Use the open function to load an image from a Path.
// `open` returns a `DynamicImage` on success.
let img = image::open("tests/images/jpg/progressive/cat.jpg").unwrap();

// The dimensions method returns the images width and height.
println!("dimensions {:?}", img.dimensions());

// The color method returns the image's `ColorType`.
println!("{:?}", img.color());

// Write the contents of this image to the Writer in PNG format.
img.save("test.png").unwrap();

Generating Fractals

//! An example of generating julia fractals.
let imgx = 800;
let imgy = 800;

let scalex = 3.0 / imgx as f32;
let scaley = 3.0 / imgy as f32;

// Create a new ImgBuf with width: imgx and height: imgy
let mut imgbuf = image::ImageBuffer::new(imgx, imgy);

// Iterate over the coordinates and pixels of the image
for (x, y, pixel) in imgbuf.enumerate_pixels_mut() {
    let r = (0.3 * x as f32) as u8;
    let b = (0.3 * y as f32) as u8;
    *pixel = image::Rgb([r, 0, b]);
}

// A redundant loop to demonstrate reading image data
for x in 0..imgx {
    for y in 0..imgy {
        let cx = y as f32 * scalex - 1.5;
        let cy = x as f32 * scaley - 1.5;

        let c = num_complex::Complex::new(-0.4, 0.6);
        let mut z = num_complex::Complex::new(cx, cy);

        let mut i = 0;
        while i < 255 && z.norm() <= 2.0 {
            z = z * z + c;
            i += 1;
        }

        let pixel = imgbuf.get_pixel_mut(x, y);
        let image::Rgb(data) = *pixel;
        *pixel = image::Rgb([data[0], i as u8, data[2]]);
    }
}

// Save the image as “fractal.png”, the format is deduced from the path
imgbuf.save("fractal.png").unwrap();

Example output:

A Julia Fractal, c: -0.4 + 0.6i

Writing raw buffers

If the high level interface is not needed because the image was obtained by other means, image provides the function save_buffer to save a buffer to a file.

let buffer: &[u8] = unimplemented!(); // Generate the image data

// Save the buffer as "image.png"
image::save_buffer("image.png", buffer, 800, 600, image::ExtendedColorType::Rgb8).unwrap()