1exif(n) EXIF parsing exif(n)
2______________________________________________________________________________
6
8 exif - Tcl EXIF extracts and parses EXIF fields from digital images
9
11 package require Tcl 8.2
12 package require exif ?1.1.2?
14 exif::analyze channel ?thumbnail?
16 exif::analyzeFile filename ?thumbnail?
18 exif::fieldnames
20_________________________________________________________________
22
24 The EXIF package is a recoding of Chris Breeze's Perl package to do the
25 same thing. This version accepts a channel as input and returns a
26 serialized array with all the recognised fields parsed out.
27 There is also a function to obtain a list of all possible field names
29 that might be present, which is useful in building GUIs that present
30 such information.
31
33 exif::analyze channel ?thumbnail?
34 channel should be an open file handle rewound to the start. It
35 does not need to be seekable. channel will be set to binary
36 mode and is left wherever it happens to stop being parsed, usu‐
37 ally at the end of the file or the start of the image data. You
38 must open and close the stream yourself. If no error is thrown,
39 the return value is a serialized array with informative English
40 text about what was found in the EXIF block. Failure during
41 parsing or I/O throw errors.
42 If thumbnail is present and not the empty string it will be
44 interpreted as the name of a file, and the thumbnail image con‐
45 tained in the exif data will be written into it.
46 exif::analyzeFile filename ?thumbnail?
48 This is a file-based wrapper around exif::analyze. Instead of
49 taking a stream it takes a filename and analyzes the contents of
50 the specified file.
51 exif::fieldnames
53 This returns a list of all possible field names. That is, the
54 array returned by exif::analyze will not contain keys that are
55 not listed in the return from exif::fieldnames. Of course, if
56 information is missing in the image file, exif::analyze may not
57 return all the fields listed in the return from exif::field‐
58 names. This function is expected to be primarily useful for
59 building GUIs to display results.
60 N.B.: Read the implementation of exif::fieldnames before modify‐
62 ing the implementation of exif::analyze.
63
65 (c) 2002 Darren New Hold harmless the author, and any lawful use is
66 allowed.
67
69 This code is a direct translation of version 1.3 of exif.pl by Chris
70 Breeze. See the source for full headers, references, etc.
71
73 This document, and the package it describes, will undoubtedly contain
74 bugs and other problems. Please report such in the category exif of
75 the Tcllib SF Trackers [http://source‐
76 forge.net/tracker/?group_id=12883]. Please also report any ideas for
77 enhancements you may have for either package and/or documentation.
78exif 1.1.2 exif(n)