Enum ImageFormat

#[non_exhaustive]
pub enum ImageFormat {
    Png,
    Jpeg,
    Gif,
    WebP,
    Pnm,
    Tiff,
    Tga,
    Dds,
    Bmp,
    Ico,
    Hdr,
    OpenExr,
    Farbfeld,
    Avif,
    Qoi,
}

An enumeration of supported image formats. Not all formats support both encoding and decoding.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Png

An Image in PNG Format

Jpeg

An Image in JPEG Format

Gif

An Image in GIF Format

WebP

An Image in WEBP Format

Pnm

An Image in general PNM Format

Tiff

An Image in TIFF Format

Tga

An Image in TGA Format

Dds

An Image in DDS Format

Bmp

An Image in BMP Format

Ico

An Image in ICO Format

Hdr

An Image in Radiance HDR Format

OpenExr

An Image in OpenEXR Format

Farbfeld

An Image in farbfeld Format

Avif

An Image in AVIF format.

Qoi

An Image in QOI format.

Implementations

impl ImageFormat

pub fn from_extension<S>(ext: S) -> Option<ImageFormat>

where S: AsRef<OsStr>,

Return the image format specified by a path’s file extension.

Example

use image::ImageFormat;

let format = ImageFormat::from_extension("jpg");
assert_eq!(format, Some(ImageFormat::Jpeg));

pub fn from_path<P>(path: P) -> Result<ImageFormat, ImageError>

where P: AsRef<Path>,

Return the image format specified by the path’s file extension.

Example

use image::ImageFormat;

let format = ImageFormat::from_path("images/ferris.png")?;
assert_eq!(format, ImageFormat::Png);

pub fn from_mime_type<M>(mime_type: M) -> Option<ImageFormat>

where M: AsRef<str>,

Return the image format specified by a MIME type.

Example

use image::ImageFormat;

let format = ImageFormat::from_mime_type("image/png").unwrap();
assert_eq!(format, ImageFormat::Png);

pub fn to_mime_type(&self) -> &'static str

Return the MIME type for this image format or “application/octet-stream” if no MIME type exists for the format.

Some notes on a few of the MIME types:

• The portable anymap format has a separate MIME type for the pixmap, graymap and bitmap formats, but this method returns the general “image/x-portable-anymap” MIME type.
• The Targa format has two common MIME types, “image/x-targa” and “image/x-tga”; this method returns “image/x-targa” for that format.
• The QOI MIME type is still a work in progress. This method returns “image/x-qoi” for that format.

Example

use image::ImageFormat;

let mime_type = ImageFormat::Png.to_mime_type();
assert_eq!(mime_type, "image/png");

pub fn can_read(&self) -> bool

Return if the ImageFormat can be decoded by the lib.

pub fn can_write(&self) -> bool

Return if the ImageFormat can be encoded by the lib.

pub fn extensions_str(self) -> &'static [&'static str]

Return a list of applicable extensions for this format.

All currently recognized image formats specify at least on extension but for future compatibility you should not rely on this fact. The list may be empty if the format has no recognized file representation, for example in case it is used as a purely transient memory format.

The method name extensions remains reserved for introducing another method in the future that yields a slice of OsStr which is blocked by several features of const evaluation.

pub fn reading_enabled(&self) -> bool

Return the ImageFormats which are enabled for reading.

pub fn writing_enabled(&self) -> bool

Return the ImageFormats which are enabled for writing.

pub fn all() -> impl Iterator<Item = ImageFormat>

Return all ImageFormats

Trait Implementations

impl Clone for ImageFormat

fn clone(&self) -> ImageFormat

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ImageFormat

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl From<IcoEntryImageFormat> for ImageFormat

fn from(val: IcoEntryImageFormat) -> ImageFormat

Converts to this type from the input type.

impl From<ImageFormat> for ImageFormatHint

fn from(format: ImageFormat) -> ImageFormatHint

Converts to this type from the input type.

impl From<ImageFormat> for ImageOutputFormat

fn from(fmt: ImageFormat) -> ImageOutputFormat

Converts to this type from the input type.

impl Hash for ImageFormat

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ImageFormat

fn eq(&self, other: &ImageFormat) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for ImageFormat

impl Eq for ImageFormat

impl StructuralPartialEq for ImageFormat