3 releases
0.1.2 | Mar 10, 2024 |
---|---|
0.1.1 | Feb 1, 2024 |
0.1.0 | Feb 1, 2024 |
#528 in Images
3MB
1.5K
SLoC
A safe Rust wrapper aroung libexif.
Libexif is a C library for extracting EXIF data from picture files. This crate contains a safe
wrapper around libexif. This crate also exposes unsafe rust bindings for libexif through the bindings
module.
The libexif static library will be linked statically during build time. Libexif needs to be
installed to build the bindings. The bindings are generated using bindgen. By default, the
libexif static library is searched using pkg-config. To manually give a file path to the
libexif.a file, set the LIBEXIF_STATIC_LIBRARY_PATH
environment variable during build time.
Run
cargo add libexif-wrapper
to add this crate as a dependency.
Example
use libexif_wrapper::{Exif, ExifIfd, ExifTag};
fn main() {
let exif = Exif::from_jpeg_file("test_resources/DSC_5613.jpg").unwrap();
let datetime = exif.get_entry_value(ExifIfd::IfdExif, ExifTag::DateTimeOriginal).unwrap();
println!("The picture was taken on: {}", datetime);
}
Extracting maker notes
In addition to standardized EXIF tags, most camera manufacturers use the maker note exif tag to store useful information about the
photo. Maker notes are specific to the camera manufacturer. Note that libexif may not be able
to decode all maker note tags.
use libexif_wrapper::{Exif, ExifIfd, ExifTag};
fn main() {
let exif = Exif::from_jpeg_file("test_resources/DSC_5613.jpg").unwrap();
let make = exif.get_entry_value(ExifIfd::Ifd0, ExifTag::Make).unwrap();
println!("The picture was taken with a camera by {}", make);
// Get maker notes specific to Nikon cameras
if make == "NIKON CORPORATION" {
// 0x0084 is the maker note tag ID for lens type in Nikon's photos.
// A list of maker notes for specific camera manudacturers can be found at https://exiftool.org/TagNames/index.html
let lens = exif.get_maker_note(0x0084).unwrap();
println!("The lens used was: {}", lens.value);
}
}
Installing libexif
curl -L https://github.com/libexif/libexif/releases/download/v0.6.24/libexif-0.6.24.tar.bz2 | tar -jsx
cd libexif-0.6.24
./configure && make
sudo make install
Libexif is only required during build time, as it is linked statically.
Libexif is licensed under the LGPL-2.1 license
This crate is licensed under the Apache-2.0 license.