Struct Exif

Source

pub struct Exif { /* private fields */ }

Expand description

Represents parsed Exif information, can be converted from an ExifIter like this: let exif: Exif = iter.into().

Implementations§

Source §

impl Exif

Source

pub fn get(&self, tag: ExifTag) -> Option<&EntryValue>

Get entry value for the specified tag in ifd0 (the main image).

Note:

The parsing error related to this tag won’t be reported by this method. Either this entry is not parsed successfully, or the tag does not exist in the input data, this method will return None.
If you want to handle parsing error, please consider to use ExifIter.

If you have any custom defined tag which does not exist in ExifTag, you can always get the entry value by a raw tag code, see Self::get_by_code.

§Example

use nom_exif::*;

fn main() -> Result<()> {
    let mut parser = MediaParser::new();
     
    let ms = MediaSource::open("./testdata/exif.jpg")?;
    assert_eq!(ms.kind(), MediaKind::Image);
    let iter = parser.parse_exif(ms)?;
    let exif: Exif = iter.into();

    assert_eq!(exif.get(ExifTag::Model).unwrap(), &"vivo X90 Pro+".into());
    Ok(())
}

Source

pub fn get_in(&self, ifd: IfdIndex, tag: ExifTag) -> Option<&EntryValue>

Get entry value for the specified tag in the specified ifd.

Note:

The parsing error related to this tag won’t be reported by this method. Either this entry is not parsed successfully, or the tag does not exist in the input data, this method will return None. Use Self::errors to inspect per-entry errors.

For raw tag codes (e.g. unrecognized tags), use Self::get_by_code.

§Example

use nom_exif::*;

fn main() -> Result<()> {
    let mut parser = MediaParser::new();
    let ms = MediaSource::open("./testdata/exif.jpg")?;
    let iter = parser.parse_exif(ms)?;
    let exif: Exif = iter.into();

    assert_eq!(exif.get_in(IfdIndex::MAIN, ExifTag::Model).unwrap(),
               &"vivo X90 Pro+".into());
    Ok(())
}

Source

pub fn get_by_code(&self, ifd: IfdIndex, code: u16) -> Option<&EntryValue>

Get entry value for the specified raw code in the specified ifd. Used for tags not in the recognized ExifTag enum.

Source

pub fn iter(&self) -> impl Iterator<Item = ExifEntry<'_>>

Iterate every parsed entry in every IFD.

Order is: IFD0 entries first (in HashMap order — not stable), then IFD1, etc. Filter by IFD with .iter().filter(|e| e.ifd == IfdIndex::MAIN).

Source

pub fn gps_info(&self) -> Option<&GPSInfo>

Get parsed GPS information.

Returns None if the source had no GPSInfo IFD or if its parse failed (failures land in Self::errors).

Source

pub fn errors(&self) -> &[(IfdIndex, TagOrCode, EntryError)]

Per-entry errors collected during From<ExifIter> conversion. Each tuple is (ifd, tag, error). Empty slice if the parse was clean.

Source

pub fn has_embedded_track(&self) -> bool

Whether the source file is known to embed a paired media track that this parse path did not surface — a Pixel/Google or Samsung Galaxy Motion Photo (JPEG with GCamera:MotionPhoto XMP and an MP4 trailer). Use crate::MediaParser::parse_track on the same source to extract the embedded track.

Content-detected, not MIME-guessed: returns true only when parse_exif observed a concrete content signal (GCamera:MotionPhoto="1" plus a Container:Directory / MotionPhotoOffset / MicroVideoOffset). A plain JPEG or HEIC without such signals returns false.

Coverage: Pixel/Google Motion Photos and Samsung Galaxy Motion Photos that use the Adobe XMP Container directory format (JPEG variants).

Source