README

   1                                     libexif
   2                                     -------
   3
   4 DESCRIPTION
   5 -----------
   6
   7 libexif is a library for parsing, editing, and saving EXIF data. It is
   8 intended to replace lots of redundant implementations in command-line
   9 utilities and programs with GUIs.
  10
  11
  12 FEATURES
  13 --------
  14
  15 libexif supports parsing, editing and saving of EXIF data. In addition, it
  16 has gettext support. All EXIF tags described in EXIF standard 2.1
  17 are supported.
  18
  19
  20 REQUIREMENTS
  21 ------------
  22
  23 libexif is written in plain C and does not require any additional library.
  24
  25
  26 LIMITATIONS
  27 -----------
  28
  29 libexif can only handle some maker notes, and even those not very well. More
  30 work needs to be done. Note that libmnote has been merged with libexif - it
  31 is no longer needed.
  32
  33
  34 USAGE
  35 -----
  36
  37 We have started documenting the libexif API using doxygen and are making
  38 the results available at http://libexif.sourceforge.net/api/
  39
  40 Until someone writes some better documentation however, you need to refer
  41 to the header files.
  42
  43 The short test-program test/test-mem illustrates how to create valid
  44 EXIF data from scratch, how to save EXIF data and how to load EXIF data
  45 from data in memory. Don't hesitate to contact us
  46 (<libexif-devel@lists.sourceforge.net>) if you've got any questions
  47 on how to use libexif.
  48
  49 To link to libexif into your own package, we recommend using the
  50 pkgconfig utility (cf. http://pkg-config.freedesktop.org/wiki/). For
  51 your convenience, libexif both provides libexif-uninstalled.pc and
  52 installs libexif.pc.
  53
  54
  55 FRONTENDS
  56 ---------
  57
  58 Right now, I know of the following frontends to libexif:
  59  - exif:     A small command-line utility to show EXIF information in JPEG
  60              files (http://www.sourceforge.net/projects/libexif).
  61  - gexif:    A GTK+ frontend for editing EXIF data
  62              (http://www.sourceforge.net/projects/libexif).
  63  - gphoto2:  A command-line frontend to libgphoto2, a library to access a
  64              wide range of digital cameras (http://www.gphoto.org).
  65  - gtkam:    A GTK+ frontend to libgphoto2 (http://www.topfrose.de).
  66  - thirdeye: Digital photos organizer and driver for eComStation
  67              (http://ecomstation.ru/thirdeye).
  68  - digicam:
  69 If you would like to migrate your program to use libexif or add EXIF support
  70 to it, don't hesitate to contact the authors.
  71
  72
  73 LIBRARIES
  74 ---------
  75
  76 I know of the following libraries that use or have been inspired by libexif:
  77  - pel: PHP-Code (http://pel.sourceforge.net)
  78
  79
  80 BUILDING
  81 --------
  82
  83 It really depends on your environment what to do in order to get libexif
  84 to build. In my case, I do something like:
  85 - gettextize
  86 - mv po/Makevars.template po/Makevars
  87 - aclocal -I auto-m4 -I m4m
  88 - autoheader
  89 - libtoolize --force
  90 - automake --add-missing
  91 - autoconf
  92 - configure
  93 - make
  94
  95
  96 AUTHORS
  97 -------
  98
  99 libexif has originally been written by Curtis Galloway
 100 <curtisg@users.sourceforge.net>. Because of the original design not
 101 supporting editing and saving, Lutz Müller <lutz@users.sourceforge.net>
 102 rewrote libexif from scratch.
 103
 104
 105 LINKS
 106 -----
 107
 108 Some links you might want to check out if you are interested in further
 109 information about EXIF.
 110
 111  - http://drewnoakes.com/code/exif: metadata extraction framework in Java
 112  - http://www.pima.net: This is where I got the exif standard from. Site is
 113    down as of 2002/12/31.
 114  - http://www.jeida.or.jp: Can't remember any more. Site is down as of
 115    2002/12/31.
 116  - http://www.exif.org: information about the EXIF standard.
 117  - http://www.sno.phy.queensu.ca/~phil/exiftool/TagNames/index.html: Looks
 118    like libexif in Perl. Seems to support a lot of MakerNotes.