2016-10-06 09:36:23 -04:00
|
|
|
//
|
|
|
|
// Copyright (c) 2016 KAMADA Ken'ichi.
|
|
|
|
// All rights reserved.
|
|
|
|
//
|
|
|
|
// Redistribution and use in source and binary forms, with or without
|
|
|
|
// modification, are permitted provided that the following conditions
|
|
|
|
// are met:
|
|
|
|
// 1. Redistributions of source code must retain the above copyright
|
|
|
|
// notice, this list of conditions and the following disclaimer.
|
|
|
|
// 2. Redistributions in binary form must reproduce the above copyright
|
|
|
|
// notice, this list of conditions and the following disclaimer in the
|
|
|
|
// documentation and/or other materials provided with the distribution.
|
|
|
|
//
|
|
|
|
// THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
|
|
|
// ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
|
|
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
|
|
// ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
|
|
|
// FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
|
|
// DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
|
|
// OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
|
|
// HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
|
|
// LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
|
|
// OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
|
|
// SUCH DAMAGE.
|
|
|
|
//
|
|
|
|
|
2017-03-04 18:18:53 -05:00
|
|
|
//! This is a pure-Rust library to parse Exif data.
|
|
|
|
//! This library can parse TIFF and JPEG images and extract Exif
|
|
|
|
//! attributes.
|
2016-12-18 09:38:11 -05:00
|
|
|
//!
|
|
|
|
//! # Examples
|
|
|
|
//!
|
2017-03-04 18:19:37 -05:00
|
|
|
//! An example to parse JPEG/TIFF files:
|
2016-12-18 09:38:11 -05:00
|
|
|
//!
|
|
|
|
//! ```
|
2017-03-04 18:19:37 -05:00
|
|
|
//! for path in &["tests/exif.jpg", "tests/exif.tif"] {
|
|
|
|
//! let file = std::fs::File::open(path).unwrap();
|
|
|
|
//! let reader = exif::Reader::new(
|
|
|
|
//! &mut std::io::BufReader::new(&file)).unwrap();
|
|
|
|
//! for f in reader.fields() {
|
2018-01-13 09:33:45 -05:00
|
|
|
//! println!("{} {} {}",
|
2019-04-20 10:16:01 -04:00
|
|
|
//! f.tag, f.ifd_num, f.display_value().with_unit(&reader));
|
2017-03-04 18:19:37 -05:00
|
|
|
//! }
|
2016-12-18 09:38:11 -05:00
|
|
|
//! }
|
|
|
|
//! ```
|
2017-03-26 08:29:33 -04:00
|
|
|
//!
|
2019-12-22 08:20:49 -05:00
|
|
|
//! # Upgrade Guide (0.3.x to 0.4.x)
|
2017-03-26 08:29:33 -04:00
|
|
|
//!
|
2019-12-22 08:20:49 -05:00
|
|
|
//! ## API compatibilities
|
2017-03-26 08:29:33 -04:00
|
|
|
//!
|
2019-12-22 08:20:49 -05:00
|
|
|
//! * Use struct `In` instead of `bool` to indicate primary/thumbnail images.
|
|
|
|
//! - On `Reader::get_field`, the old code in 0.3.x:
|
|
|
|
//! ```ignore
|
|
|
|
//! reader.get_field(Tag::DateTime, false)
|
|
|
|
//! ```
|
|
|
|
//! The new code in 0.4.x:
|
|
|
|
//! ```
|
|
|
|
//! # use exif::{In, Reader, Tag};
|
|
|
|
//! # let file = std::fs::File::open("tests/exif.tif").unwrap();
|
|
|
|
//! # let reader = Reader::new(
|
|
|
|
//! # &mut std::io::BufReader::new(&file)).unwrap();
|
|
|
|
//! reader.get_field(Tag::DateTime, In::PRIMARY)
|
|
|
|
//! # ;
|
|
|
|
//! ```
|
|
|
|
//! As an additional feature, access to the 2nd or further IFD,
|
|
|
|
//! which some RAW formats may have, is also possible in 0.4.x:
|
|
|
|
//! ```
|
|
|
|
//! # use exif::{In, Reader, Tag};
|
|
|
|
//! # let file = std::fs::File::open("tests/exif.tif").unwrap();
|
|
|
|
//! # let reader = Reader::new(
|
|
|
|
//! # &mut std::io::BufReader::new(&file)).unwrap();
|
|
|
|
//! reader.get_field(Tag::ImageWidth, In(2))
|
|
|
|
//! # ;
|
|
|
|
//! ```
|
|
|
|
//! - On `Field`, the old code in 0.3.x:
|
|
|
|
//! ```ignore
|
|
|
|
//! if field.thumbnail {
|
|
|
|
//! // for the thumbnail image
|
|
|
|
//! } else {
|
|
|
|
//! // for the primary image
|
|
|
|
//! }
|
|
|
|
//! ```
|
|
|
|
//! The new code in 0.4.x:
|
|
|
|
//! ```
|
|
|
|
//! # use exif::{In, Reader};
|
|
|
|
//! # let file = std::fs::File::open("tests/exif.tif").unwrap();
|
|
|
|
//! # let reader = Reader::new(
|
|
|
|
//! # &mut std::io::BufReader::new(&file)).unwrap();
|
|
|
|
//! # let field = reader.fields().next().unwrap();
|
|
|
|
//! match field.ifd_num {
|
|
|
|
//! In::PRIMARY => {}, // for the primary image
|
|
|
|
//! In::THUMBNAIL => {}, // for the thumbnail image
|
|
|
|
//! _ => {},
|
|
|
|
//! }
|
|
|
|
//! ```
|
2019-12-14 07:57:56 -05:00
|
|
|
//! * `Reader::fields` now returns an iterator instead of a slice.
|
2019-12-22 08:20:49 -05:00
|
|
|
//! * Enum variants of `Context` and `Error` are no longer exhaustive.
|
|
|
|
//! You need a wildcard arm (`_`) in a match expression.
|
|
|
|
//! * The associated value of `Value::Undefined` and `Value::Ascii` has
|
|
|
|
//! been changed from a slice to a `Vec`.
|
|
|
|
//!
|
|
|
|
//! ## Other new features
|
|
|
|
//!
|
|
|
|
//! * `Field::display_value` has been introduced.
|
|
|
|
//! It is usually handier than `Value::display_as`.
|
|
|
|
//! ```
|
|
|
|
//! # let file = std::fs::File::open("tests/exif.tif").unwrap();
|
|
|
|
//! # let reader = exif::Reader::new(
|
|
|
|
//! # &mut std::io::BufReader::new(&file)).unwrap();
|
|
|
|
//! # let field = reader.fields().next().unwrap();
|
|
|
|
//! assert_eq!(field.display_value().to_string(),
|
|
|
|
//! field.value.display_as(field.tag).to_string());
|
|
|
|
//! ```
|
|
|
|
//! * Displaying a value with its unit is supported.
|
|
|
|
//! ```
|
|
|
|
//! # let file = std::fs::File::open("tests/exif.tif").unwrap();
|
|
|
|
//! # let reader = exif::Reader::new(
|
|
|
|
//! # &mut std::io::BufReader::new(&file)).unwrap();
|
|
|
|
//! # let field = reader.fields().next().unwrap();
|
|
|
|
//! // Display the value only.
|
|
|
|
//! println!("{}", field.display_value());
|
|
|
|
//! // Display the value with its unit. If the unit depends on another
|
|
|
|
//! // field, it is taken from the reader.
|
|
|
|
//! println!("{}", field.display_value().with_unit(&reader));
|
|
|
|
//! ```
|
|
|
|
//! * `Value` and `Field` are self-contained and no longer borrow the raw
|
|
|
|
//! buffer or `Reader` (thanks to the change of `Value::Undefined`
|
|
|
|
//! and `Value::Ascii` described above).
|
2016-10-06 09:36:23 -04:00
|
|
|
|
|
|
|
pub use error::Error;
|
|
|
|
pub use jpeg::get_exif_attr as get_exif_attr_from_jpeg;
|
2017-02-22 09:00:25 -05:00
|
|
|
pub use reader::Reader;
|
2019-03-31 10:50:04 -04:00
|
|
|
pub use tag::{Context, Tag};
|
2019-04-20 10:16:01 -04:00
|
|
|
pub use tiff::{DateTime, Field, In};
|
2019-12-14 07:57:35 -05:00
|
|
|
pub use tiff::parse_exif_compat03 as parse_exif;
|
2016-10-26 09:46:20 -04:00
|
|
|
pub use value::Value;
|
2016-11-19 06:28:17 -05:00
|
|
|
pub use value::{Rational, SRational};
|
2016-10-06 09:36:23 -04:00
|
|
|
|
2018-01-13 09:33:45 -05:00
|
|
|
/// The interfaces in this module are experimental and unstable.
|
2017-07-01 06:17:37 -04:00
|
|
|
pub mod experimental {
|
2019-04-01 08:11:54 -04:00
|
|
|
pub use crate::writer::Writer;
|
2017-07-01 06:17:37 -04:00
|
|
|
}
|
|
|
|
|
2016-10-08 20:11:10 -04:00
|
|
|
#[cfg(test)]
|
|
|
|
#[macro_use]
|
|
|
|
mod tmacro;
|
|
|
|
|
2016-10-26 09:46:20 -04:00
|
|
|
mod endian;
|
2016-10-06 09:36:23 -04:00
|
|
|
mod error;
|
2020-01-19 06:48:04 -05:00
|
|
|
mod isobmff;
|
2016-10-06 09:36:23 -04:00
|
|
|
mod jpeg;
|
2017-02-22 09:00:25 -05:00
|
|
|
mod reader;
|
2019-03-31 10:50:04 -04:00
|
|
|
mod tag;
|
2016-10-26 09:46:20 -04:00
|
|
|
mod tiff;
|
2016-10-06 09:36:23 -04:00
|
|
|
mod util;
|
2016-10-26 09:46:20 -04:00
|
|
|
mod value;
|
2017-06-30 10:23:03 -04:00
|
|
|
mod writer;
|