2004-09-01 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 FRONTENDS
31 ---------
32
33 Right now, I know of the following frontends to libexif:
34  - exif:     A small command-line utility to show EXIF information in JPEG
35              files (http://www.sourceforge.net/projects/libexif).
36  - gexif:    A GTK+ frontend for editing EXIF data
37              (http://www.sourceforge.net/projects/libexif).
38  - gphoto2:  A command-line frontend to libgphoto2, a library to access a 
39              wide range of digital cameras (http://www.gphoto.org).
40  - gtkam:    A GTK+ frontend to libgphoto2 (http://www.topfrose.de).
41  - thirdeye: Digital photos organizer and driver for eComStation
42              (http://ecomstation.ru/thirdeye).
43  - digicam:  
44 If you would like to migrate your program to use libexif or add EXIF support
45 to it, don't hesitate to contact the authors.
46
47 LIBRARIES
48 ---------
49
50 I know of the following libraries that use or have been inspired by libexif:
51  - pel: PHP-Code (http://pel.sourceforge.net)
52
53 BUGS
54 ----
55
56 libexif includes a 'libjpeg' that is 'educational code to illustrate the
57 syntax of JPEG files'. Please ignore it. It is a bug that it is 
58 distributed, but I think it may be useful for other people.
59
60 TODO
61 ----
62
63 We should probably support the generation of an empty EXIF structure with all
64 mandatory tags. First ideas are in exif-tag.c. This has not yet been finished.
65
66 AUTHORS
67 -------
68
69 libexif has originally been written by Curtis Galloway
70 <curtisg@users.sourceforge.net>. Because of the original design not
71 supporting editing and saving, Lutz Müller <lutz@users.sourceforge.net>
72 rewrote libexif from scratch.
73
74 LINKS
75 -----
76
77 Some links you might want to check out if you are interested in further
78 information about EXIF.
79
80  - http://drewnoakes.com/code/exif: metadata extraction framework in Java
81  - http://www.pima.net: This is where I got the exif standard from. Site is
82    down as of 2002/12/31.
83  - http://www.jeida.or.jp: Can't remember any more. Site is down as of
84    2002/12/31.
85  - http://www.exif.org: information about the EXIF standard.