exif(n) EXIF parsing exif(n)

NAME
       exif - Tcl EXIF extracts and parses EXIF fields from digital images

SYNOPSIS
       package require TTccll  88..22

       package require eexxiiff  ??11..11..11??

       eexxiiff::::aannaallyyzzee channel ?thumbnail?

       eexxiiff::::aannaallyyzzeeFFiillee filename ?thumbnail?

       eexxiiff::::ffiieellddnnaammeess



DESCRIPTION
       The EXIF package is a recoding of Chris Breeze's Perl package to do the
       same thing.  This version accepts a channel  as  input  and  returns  a
       serialized array with all the recognised fields parsed out.

       There  is  also a function to obtain a list of all possible field names
       that might be present, which is useful in building  GUIs  that  present
       such information.

CCOOMMMMAANNDDSS
       eexxiiff::::aannaallyyzzee channel ?thumbnail?
              channel  should be an open file handle rewound to the start.  It
              does not need to be seekable.  channel will  be  set  to  binary
              mode  and is left wherever it happens to stop being parsed, usu-
              ally at the end of the file or the start of the image data.  You
              must open and close the stream yourself.  If no error is thrown,
              the return value is a serialized array with informative  English
              text  about  what  was  found in the EXIF block.  Failure during
              parsing or I/O throw errors.

              If thumbnail is present and not the  empty  string  it  will  be
              interpreted  as the name of a file, and the thumbnail image con-
              tained in the exif data will be written into it.

       eexxiiff::::aannaallyyzzeeFFiillee filename ?thumbnail?
              This is a file-based wrapper around  eexxiiff::::aannaallyyzzee.  Instead  of
              taking a stream it takes a filename and analyzes the contents of
              the specified file.

       eexxiiff::::ffiieellddnnaammeess
              This returns a list of all possible field names.  That  is,  the
              array  returned  by eexxiiff::::aannaallyyzzee will not contain keys that are
              not listed in the return from eexxiiff::::ffiieellddnnaammeess.  Of  course,  if
              information  is missing in the image file, eexxiiff::::aannaallyyzzee may not
              return all the fields listed in  the  return  from  exif::field-
              names.   This  function  is  expected to be primarily useful for
              building GUIs to display results.

              N.B.: Read the implementation of eexxiiff::::ffiieellddnnaammeess before modify-
              ing the implementation of eexxiiff::::aannaallyyzzee.

COPYRIGHTS       (c)  2002  Darren  New  Hold harmless the author, and any lawful use is
       allowed.

AACCKKNNOOWWLLEEDDGGEEMMEENNTTSS
       This code is a direct translation of version 1.3 of  exif.pl  by  Chris
       Breeze.  See the source for full headers, references, etc.



exif                                 1.1.1                             exif(n)