gufo 0.5.0

Gufo
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

use gufo_common::types::Rational;
use gufo_common::{geography, hardware, orientation, physical_dimension};
use gufo_exif::Exif;
use gufo_xmp::Xmp;

use crate::Metadata;

impl Metadata {
    /// Owner of the camera used in photography
    pub fn camera_owner_name(&self) -> Option<String> {
        self.lookup_exif_xmp(Exif::camera_owner_name, Xmp::camera_owner_name)
    }

    /// Name of the main person who created the image
    pub fn creator(&self) -> Option<String> {
        self.lookup_exif_xmp_keyval(Exif::artist, Xmp::creator, |x| x.get("Author").cloned())
    }

    #[cfg(feature = "chrono")]
    pub fn date_time_original(&self) -> Option<gufo_common::datetime::DateTime> {
        self.lookup_exif_xmp(Exif::date_time_original, Xmp::date_time_original)
    }

    pub fn digital_zoom_ratio(&self) -> Option<Rational<u32>> {
        self.lookup_exif_xmp(Exif::digital_zoom_ratio, Xmp::digital_zoom_ratio)
    }

    /// Exposure time in seconds
    ///
    /// Fraction of first element devided by second element. The first element
    /// is typically one, such that the value is given in its common for like
    /// "1/60 sec".
    pub fn exposure_time(&self) -> Option<Rational<u32>> {
        self.lookup_exif_xmp(Exif::exposure_time, Xmp::exposure_time)
    }

    /// Aperture
    pub fn f_number(&self) -> Option<f32> {
        self.lookup_exif_xmp(|x| Exif::f_number(x).map(|x| x.as_f32()), Xmp::f_number)
    }

    /// Focal length in millimeters
    pub fn focal_length(&self) -> Option<Rational<u32>> {
        self.lookup_exif_xmp(Exif::focal_length, Xmp::focal_length)
    }

    pub fn gps_location(&self) -> Option<geography::Location> {
        // TODO: XMP
        self.lookup_exif(Exif::gps_location)
    }

    /// ISO
    pub fn iso_speed_rating(&self) -> Option<u16> {
        self.lookup_exif_xmp(Exif::iso_speed_rating, Xmp::iso_speed_rating)
    }

    pub fn lens_make(&self) -> Option<String> {
        self.lookup_exif_xmp(Exif::lens_make, Xmp::lens_make)
    }

    pub fn lens_model(&self) -> Option<String> {
        self.lookup_exif_xmp(Exif::lens_model, Xmp::lens_model)
    }

    pub fn lens_specification(&self) -> Option<hardware::LensSpecification> {
        // TODO: XMP
        self.lookup_exif(Exif::lens_specification)
    }

    /// Camera manifacturer
    pub fn make(&self) -> Option<String> {
        self.lookup_exif_xmp(Exif::make, Xmp::make)
    }

    /// Camera model
    pub fn model(&self) -> Option<String> {
        self.lookup_exif_xmp(Exif::model, Xmp::model)
    }

    /// Image orientation
    ///
    /// Rotation and mirroring that have to be applied to show the image
    /// correctly
    pub fn orientation(&self) -> Option<orientation::Orientation> {
        self.lookup_exif_xmp(Exif::orientation, Xmp::orientation)
    }

    /// Copyright information
    pub fn rights(&self) -> Option<String> {
        self.lookup_exif_xmp_keyval(Exif::copyright, Xmp::rights, |x| {
            x.get("Copyright").cloned()
        })
    }

    /// URL with usage rights information
    pub fn rights_web_statement(&self) -> Option<String> {
        self.lookup_xmp(Xmp::rights_web_statement)
    }

    /// Resolution (Pixel Density)
    ///
    /// Number of pixels per physical unit like DPI
    pub fn resolution(&self) -> Option<physical_dimension::PixelDensity> {
        self.lookup_exif_xmp(Exif::resolution, Xmp::resolution)
    }

    /// Name and version of software or firmware
    ///
    /// In practice, this often contains the name, version, and operating system
    /// of the image editing software used to edit an image.
    pub fn software(&self) -> Option<String> {
        self.lookup_exif_xmp_keyval(Exif::software, Xmp::creator_tool, |x| {
            x.get("Software").cloned()
        })
    }

    /// Freely write keywords or comments on the image
    pub fn user_comment(&self) -> Option<String> {
        self.lookup_exif_xmp_keyval(Exif::user_comment, Xmp::user_comment, |x| {
            x.get("Comment").cloned()
        })
    }

    pub fn pixel_density(&self) -> Option<physical_dimension::PixelDensity> {
        self.pixel_density.clone()
    }
}