Crate rexif

Expand description

RExif is a native Rust create, written to extract EXIF data from JPEG and TIFF images.

Note that it is in very early stages of development. Any sort of feedback is welcome!

The crate contains a sample binary called ‘rexiftool’ that accepts files as arguments and prints the EXIF data. It gives a rough idea on how to use the crate. Get some sample images and run

cargo run [image file 1] [image file 2] ...

To learn to use this crate, start by the documentation of function parse_file(), and the struct ExifData that is returned by the parser. The rest falls more or less into place.

Code sample lightly edited from src/bin.rs:

use std::error::Error;

let file_name = "foo.jpg";
match rexif::parse_file(&file_name) {
    Ok(exif) => {
        println!("{} {} exif entries: {}", file_name, exif.mime, exif.entries.len());
        for entry in &exif.entries {
            println!("\t{}: {}", entry.tag, entry.value_more_readable);
        }
    },
    Err(e) => {
        eprintln!("Error in {}: {}", &file_name, e)
    }
}

Structs§

ExifData
Top-level structure that contains all parsed metadata inside an image
ExifEntry
Structure that represents a parsed EXIF tag.
IRational
Encapsulation of the TIFF type that represents a signed rational number
IfdEntry
Structure that represents a parsed IFD entry of a TIFF image
URational
Encapsulation of the TIFF type that represents an unsigned rational number

Enums§

ExifError
Possible fatal errors that may happen when an image is parsed.
ExifTag
Enumeration that represents recognized EXIF tags found in TIFF IFDs.
IfdFormat
Enumeration that represents the possible data formats of an IFD entry.
IfdKind
Namespace
Enumeration that represent EXIF tag namespaces. Namespaces exist to accomodate future parsing of the manufacturer-specific tags embedded within the MarkerNote tag.
TagValue
Tag value enumeration. It works as a variant type. Each value is actually a vector because many EXIF tags are collections of values. Exif tags with single values are represented as single-item vectors.

Constants§

EXIF_HEADER
The value of the Exif header.

Functions§

parse_buffer
Parse a byte buffer that should contain a TIFF or JPEG image. Tries to detect format and parse EXIF data.
parse_buffer_quiet
Parse a byte buffer that should contain a TIFF or JPEG image. Tries to detect format and parse EXIF data.
parse_file
Opens an image (passed as a file name), tries to read and parse it.
read_file
Try to read and parse an open file that is expected to contain an image

Type Aliases§