Enum MediaType 

#[non_exhaustive]
pub enum MediaType {
    Jpeg,
    Png,
    Webp,
    Avif,
    Svg,
    Bmp,
    Tiff,
    Gif,
}

Supported media types for the current implementation phase.

Examples

use truss::MediaType;
use std::str::FromStr;

let mt = MediaType::from_str("png").unwrap();
assert_eq!(mt, MediaType::Png);
assert_eq!(mt.as_name(), "png");
assert_eq!(mt.as_mime(), "image/png");
assert!(!mt.is_lossy());
assert!(mt.is_raster());

assert!(MediaType::Jpeg.is_lossy());
assert!(!MediaType::Svg.is_raster());

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.

Jpeg

JPEG image data.

Png

PNG image data.

Webp

WebP image data.

Avif

AVIF image data.

Svg

SVG image data.

Bmp

BMP image data.

Tiff

TIFF image data.

Gif

GIF image data.

GIF is an input-only format: truss decodes it but never encodes it, the same way it treats a raster input requesting SVG output. Requesting gif output returns TransformError::UnsupportedOutputMediaType.

Implementations

impl MediaType

pub const fn as_name(self) -> &'static str

Returns the canonical media type name used by the API and CLI.

pub const fn as_mime(self) -> &'static str

Returns the canonical MIME type string.

pub const fn is_lossy(self) -> bool

Reports whether the media type is typically encoded with lossy quality controls.

pub const fn supports_optimization(self) -> bool

Returns true if the format participates in the optimization pipeline.

pub const fn supports_lossy_optimization(self) -> bool

Returns true if the format supports lossy optimization controls.

pub const fn supports_icc_profile(self) -> bool

Returns true if the encoded format can carry an embedded ICC profile.

AVIF signals color through the container’s colr box rather than a profile truss can write, and BMP/TIFF/SVG output has no profile path in this pipeline.

pub const fn is_raster(self) -> bool

Returns true if this is a raster (bitmap) format, false for vector formats.

pub const fn is_encodable(self) -> bool

Returns true if truss can encode this format, not merely decode it.

GIF is decode-only: animation, palette quantization, and frame disposal are a different problem from the single-frame pipeline, so truss reads GIF input and writes one of the formats it fully supports. SVG is encodable only in the sense that an SVG input can be sanitized back out as SVG, which crate::codecs::transform handles on its own path.

pub const fn default_output(self) -> Self

The output format to use when a request does not name one.

Normally that is the input’s own format, so a transform without an explicit format does not silently re-encode into something else. A decode-only input has no such option: GIF falls back to PNG, which is lossless and reproduces a palette and a transparent color index exactly.

Every adapter that has to resolve a missing format goes through here, so the rule cannot drift between the CLI, the server, and the WASM build.

Examples

use truss::MediaType;

assert_eq!(MediaType::Jpeg.default_output(), MediaType::Jpeg);
assert_eq!(MediaType::Gif.default_output(), MediaType::Png);

Trait Implementations

impl Clone for MediaType

fn clone(&self) -> MediaType

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for MediaType

impl Debug for MediaType

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

Formats the value using the given formatter.

impl Display for MediaType

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

Formats the value using the given formatter.

impl Eq for MediaType

impl FromStr for MediaType

type Err = String

The associated error which can be returned from parsing.

fn from_str(value: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl PartialEq for MediaType

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for MediaType