File: exifgrep.1.html

package info (click to toggle)
exifprobe 2.0.1%2Bgit20170416.3c2b769-5
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, bullseye
  • size: 2,904 kB
  • sloc: ansic: 34,799; sh: 413; makefile: 82
file content (125 lines) | stat: -rw-r--r-- 4,826 bytes parent folder | download | duplicates (6)
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
<HTML>
<BODY>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->

<B>EXIFGREP(1)</B>                                                        <B>EXIFGREP(1)</B>



<B>NAME</B>
       exifgrep - select and reformat the output of <B>exifprobe</B>


<B>SYNOPSIS</B>
       <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>
       <I>filename(s)</I>


<B>DESCRIPTION</B>
       <B>Exifgrep</B> is a shell script which applies  <B>egrep(1)</B>  to  the  output  of
       <B>exifprobe</B> <I>-L</I>,  permitting easy selection and minor reformatting of out-
       put items.

       <B>exifprobe</B> is small, fast, and utterly  sycophantic  in  its  desire  to
       report  <I>everything</I>  it finds in an image.  <B>exifgrep</B> applies the regular
       expression matching capabilities of <B>egrep</B>  to  the  output  barrage  to
       extract only wanted information.

       <B>exifgrep</B> also performs a mild form of selection on the output fields of
       <B>exifprobe</B> <I>-L</I>.  Many items reported by exifprobe are represented in  the
       image file by a <I>number</I> which compactly represents a defined value.

       E.g. <B>exifprobe</B> <I>-L</I> may report

       TIFF.Ifd1.ResolutionUnit              = 2 = 'pixels per inch'

       where  the value "2" must be interpreted to mean that resolution values
       (<I>TIFF.IFd1.Xresolution</I> and IFF.IFd1.YResolution) are recorded in pixels
       per  inch,  rather than, say, pixels per centimeter.  <B>exifprobe</B> reports
       both fields; <B>exifprobe</B> may also report  interpreted  values  for  items
       which are recorded in unfamiliar units, such as

       JPEG.APP1.Ifd0.Exif.FNumber           = 5.6 APEX = 'f7.0'

       In  all such cases, <B>exifgrep</B> reports (by default) only the "human read-
       able" field:

       TIFF.Ifd1.ResolutionUnit = 'pixels per inch'
       JPEG.APP1.Ifd0.Exif.FNumber = 'f7.0'

       unless the "<I>-num</I>" option is given to select the numerical value.

       In addition, a `variable' format may be selected ("<I>-var</I>") which  elimi-
       nates  whitespace,  providing  a  format  which  typical shells may use
       directly to set variables for further processing.  E.g.

       TIFF.Ifd1.ResolutionUnit='pixels per inch'
       JPEG.APP1.Ifd0.Exif.FNumber='f7.0'



<B>OPTIONS</B>
       -r        <I>file</I> arguments may be directories, which will be searched via
                 <B>find</B> for all image types recognized by <B>exifprobe</B>.

       -n        force <B>exifprobe</B> to print a filename for each line of its out-
                 put, which <I>exifgrep</I> will turn into a comment at  the  end  of
                 each matching line.

       -t        force <B>exifprobe</B> to print tag numbers for all itemes that have
                 them, so that matches may be  made  on  hex  or  decimal  tag
                 numbers.

       -c        turn on color output from <B>exifprobe</B>

       -h        print a usage message (help)

       -var      report  in "variable" format, which may be directly `sourced'
                 by any Bourne-compatible shell (except that most shells  will
                 insist  that the dots must be replaced, e.g. by underscores).

       -export   report in "variable" format,  but  with  a  Bourne-compatible
                 <I>export</I> command

       -num      report  numerical values rather than interpreted strings, for
                 fields which have both.


       NOTE: the <I>-var</I> and <I>-export</I> options are obsolescent; they  are  retained
       for compatibility with earlier versions of <I>exifprobe</I>.  A post-processor
       such as <I>reformat.sh</I> may be more effective for the  current  version  if
       shell-compatible output is desired.


       Any option not recognized by the script will be passed on to <B>egrep</B>.

       The  first  non-option  argument  will be used as the pattern passed to
       <B>egrep</B>.  This may be followed by the keyword <I>NOT</I> and an expression  rep-
       resenting matches to be <I>rejected</I>.  This pattern will be passed to <B>egrep</B>
       <I>-v</I>.  Only one argument of each type may  be  given,  and  the  "accept"
       expression (if given) must appear before the "reject" expression.

       All remaining arguments are interpreted as image filenames.


<B>SEE</B> <B>ALSO</B>
       <B>exifprobe(1)</B>


<B>AUTHOR</B>
       Duane H. Hesser
       dhh@virtual-cafe.com




                                     LOCAL                         <B>EXIFGREP(1)</B>
</PRE>
<HR>
<ADDRESS>
Man(1) output converted with
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
</ADDRESS>
</BODY>
</HTML>