2005-04-30 Lutz Mueller <lutz@users.sourceforge.net>
[platform/upstream/libexif.git] / 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 FEATURES
12 --------
13
14 libexif supports parsing, editing and saving of EXIF data. In addition, it
15 has gettext support. All EXIF tags described in EXIF standard 2.1
16 are supported.
17
18 REQUIREMENTS
19 ------------
20
21 libexif is written in plain C and does not require any additional library.
22
23 LIMITATIONS
24 -----------
25
26 libexif can only handle some maker notes, and even those not very well. More
27 work needs to be done. Note that libmnote has been merged with libexif - it
28 is no longer needed.
29
30 USAGE
31 -----
32
33 Until someone writes some documentation, you need to refer to the header 
34 files. The short test-program test/test-mem illustrates how to create valid
35 EXIF data from scratch, how to save EXIF data and how to load EXIF data 
36 from data in memory. Don't hesitate to contact us 
37 (<libexif-devel@lists.sourceforge.net>) if you've got any questions
38 on how to use libexif.
39
40 FRONTENDS
41 ---------
42
43 Right now, I know of the following frontends to libexif:
44  - exif:     A small command-line utility to show EXIF information in JPEG
45              files (http://www.sourceforge.net/projects/libexif).
46  - gexif:    A GTK+ frontend for editing EXIF data
47              (http://www.sourceforge.net/projects/libexif).
48  - gphoto2:  A command-line frontend to libgphoto2, a library to access a 
49              wide range of digital cameras (http://www.gphoto.org).
50  - gtkam:    A GTK+ frontend to libgphoto2 (http://www.topfrose.de).
51  - thirdeye: Digital photos organizer and driver for eComStation
52              (http://ecomstation.ru/thirdeye).
53  - digicam:  
54 If you would like to migrate your program to use libexif or add EXIF support
55 to it, don't hesitate to contact the authors.
56
57 LIBRARIES
58 ---------
59
60 I know of the following libraries that use or have been inspired by libexif:
61  - pel: PHP-Code (http://pel.sourceforge.net)
62
63 AUTHORS
64 -------
65
66 libexif has originally been written by Curtis Galloway
67 <curtisg@users.sourceforge.net>. Because of the original design not
68 supporting editing and saving, Lutz Müller <lutz@users.sourceforge.net>
69 rewrote libexif from scratch.
70
71 LINKS
72 -----
73
74 Some links you might want to check out if you are interested in further
75 information about EXIF.
76
77  - http://drewnoakes.com/code/exif: metadata extraction framework in Java
78  - http://www.pima.net: This is where I got the exif standard from. Site is
79    down as of 2002/12/31.
80  - http://www.jeida.or.jp: Can't remember any more. Site is down as of
81    2002/12/31.
82  - http://www.exif.org: information about the EXIF standard.