Enum ImageFormat 

#[non_exhaustive]
pub enum ImageFormat {
    Png,
    Jpeg,
    Gif,
    Bmp,
    Wmf,
    Emf,
    Unknown(String),
}

Supported image formats.

Marked #[non_exhaustive] so new formats can be added in future phases without a breaking change.

Examples

use hwpforge_core::image::ImageFormat;

let fmt = ImageFormat::Png;
assert_eq!(fmt.to_string(), "PNG");

let unknown = ImageFormat::Unknown("SVG".to_string());
assert_eq!(unknown.to_string(), "svg");

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

Portable Network Graphics.

Jpeg

JPEG.

Gif

Graphics Interchange Format.

Bmp

Windows Bitmap.

Wmf

Windows Metafile.

Emf

Enhanced Metafile.

Unknown(String)

Unrecognized format with its extension or MIME type.

Implementations

impl ImageFormat

pub fn from_extension(path: &str) -> Self

Infers an ImageFormat from a file path’s extension.

The extension is extracted from everything after the last '.' in the path string and matched case-insensitively. If no dot is found, or the extension is not recognized, ImageFormat::Unknown is returned containing the lowercase extension (or an empty string when absent).

Examples

use hwpforge_core::image::ImageFormat;

assert_eq!(ImageFormat::from_extension("photo.png"),  ImageFormat::Png);
assert_eq!(ImageFormat::from_extension("image.JPG"),  ImageFormat::Jpeg);
assert_eq!(ImageFormat::from_extension("file.jpeg"), ImageFormat::Jpeg);
assert_eq!(ImageFormat::from_extension("doc.gif"),   ImageFormat::Gif);
assert_eq!(ImageFormat::from_extension("img.bmp"),   ImageFormat::Bmp);
assert_eq!(ImageFormat::from_extension("chart.wmf"), ImageFormat::Wmf);
assert_eq!(ImageFormat::from_extension("dia.emf"),   ImageFormat::Emf);
assert_eq!(
    ImageFormat::from_extension("file.xyz"),
    ImageFormat::Unknown("xyz".to_string()),
);
assert_eq!(
    ImageFormat::from_extension("noext"),
    ImageFormat::Unknown(String::new()),
);
assert_eq!(ImageFormat::from_extension("multi.dot.png"), ImageFormat::Png);

Trait Implementations

impl Clone for ImageFormat

fn clone(&self) -> ImageFormat

Returns a duplicate 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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ImageFormat

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ImageFormat

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

Formats the value using the given formatter.

impl Hash for ImageFormat

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

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 JsonSchema for ImageFormat

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

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 Serialize for ImageFormat

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ImageFormat

impl StructuralPartialEq for ImageFormat