Debian Codegraph @

exifgrep.1.html

raw
1 <HTML>
2 <BODY>
3 <PRE>
4 <!-- Manpage converted by man2html 3.0.1 -->
5
6 <B>EXIFGREP(1)</B> <B>EXIFGREP(1)</B>
7
8
9
10 <B>NAME</B>
11 exifgrep - select and reformat the output of <B>exifprobe</B>
12
13
14 <B>SYNOPSIS</B>
15 <B>exifgrep</B> [options] [<I>egrep</I><B>_</B><I>options</I>] <I>egrep</I><B>_</B><I>pattern</I> [<I>NOT</I> <I>egrep-pattern]</I>
16 <I>filename(s)</I>
17
18
19 <B>DESCRIPTION</B>
20 <B>Exifgrep</B> is a shell script which applies <B>egrep(1)</B> to the output of
21 <B>exifprobe</B> <I>-L</I>, permitting easy selection and minor reformatting of out-
22 put items.
23
24 <B>exifprobe</B> is small, fast, and utterly sycophantic in its desire to
25 report <I>everything</I> it finds in an image. <B>exifgrep</B> applies the regular
26 expression matching capabilities of <B>egrep</B> to the output barrage to
27 extract only wanted information.
28
29 <B>exifgrep</B> also performs a mild form of selection on the output fields of
30 <B>exifprobe</B> <I>-L</I>. Many items reported by exifprobe are represented in the
31 image file by a <I>number</I> which compactly represents a defined value.
32
33 E.g. <B>exifprobe</B> <I>-L</I> may report
34
35 TIFF.Ifd1.ResolutionUnit = 2 = 'pixels per inch'
36
37 where the value "2" must be interpreted to mean that resolution values
38 (<I>TIFF.IFd1.Xresolution</I> and IFF.IFd1.YResolution) are recorded in pixels
39 per inch, rather than, say, pixels per centimeter. <B>exifprobe</B> reports
40 both fields; <B>exifprobe</B> may also report interpreted values for items
41 which are recorded in unfamiliar units, such as
42
43 JPEG.APP1.Ifd0.Exif.FNumber = 5.6 APEX = 'f7.0'
44
45 In all such cases, <B>exifgrep</B> reports (by default) only the "human read-
46 able" field:
47
48 TIFF.Ifd1.ResolutionUnit = 'pixels per inch'
49 JPEG.APP1.Ifd0.Exif.FNumber = 'f7.0'
50
51 unless the "<I>-num</I>" option is given to select the numerical value.
52
53 In addition, a `variable' format may be selected ("<I>-var</I>") which elimi-
54 nates whitespace, providing a format which typical shells may use
55 directly to set variables for further processing. E.g.
56
57 TIFF.Ifd1.ResolutionUnit='pixels per inch'
58 JPEG.APP1.Ifd0.Exif.FNumber='f7.0'
59
60
61
62 <B>OPTIONS</B>
63 -r <I>file</I> arguments may be directories, which will be searched via
64 <B>find</B> for all image types recognized by <B>exifprobe</B>.
65
66 -n force <B>exifprobe</B> to print a filename for each line of its out-
67 put, which <I>exifgrep</I> will turn into a comment at the end of
68 each matching line.
69
70 -t force <B>exifprobe</B> to print tag numbers for all itemes that have
71 them, so that matches may be made on hex or decimal tag
72 numbers.
73
74 -c turn on color output from <B>exifprobe</B>
75
76 -h print a usage message (help)
77
78 -var report in "variable" format, which may be directly `sourced'
79 by any Bourne-compatible shell (except that most shells will
80 insist that the dots must be replaced, e.g. by underscores).
81
82 -export report in "variable" format, but with a Bourne-compatible
83 <I>export</I> command
84
85 -num report numerical values rather than interpreted strings, for
86 fields which have both.
87
88
89 NOTE: the <I>-var</I> and <I>-export</I> options are obsolescent; they are retained
90 for compatibility with earlier versions of <I>exifprobe</I>. A post-processor
91 such as <I>reformat.sh</I> may be more effective for the current version if
92 shell-compatible output is desired.
93
94
95 Any option not recognized by the script will be passed on to <B>egrep</B>.
96
97 The first non-option argument will be used as the pattern passed to
98 <B>egrep</B>. This may be followed by the keyword <I>NOT</I> and an expression rep-
99 resenting matches to be <I>rejected</I>. This pattern will be passed to <B>egrep</B>
100 <I>-v</I>. Only one argument of each type may be given, and the "accept"
101 expression (if given) must appear before the "reject" expression.
102
103 All remaining arguments are interpreted as image filenames.
104
105
106 <B>SEE</B> <B>ALSO</B>
107 <B>exifprobe(1)</B>
108
109
110 <B>AUTHOR</B>
111 Duane H. Hesser
112 [email protected]
113
114
115
116
117 LOCAL <B>EXIFGREP(1)</B>
118 </PRE>
119 <HR>
120 <ADDRESS>
121 Man(1) output converted with
122 <a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
123 </ADDRESS>
124 </BODY>
125 </HTML>