| 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> |