modules/iptc/README.txt

// $Id: README.txt,v 1.3 2007/12/03 23:53:51 fronbow Exp $

iptc is a module that will extract iptc caption and keyword tags from images added to drupal.
It relies on the image module (http://drupal.org/project/image) to function.

It uses a plugin system to allow different libraries to be utilised to extract the data from
an image.

Currently the module supports the standard php functions, the exiftool binary, the exiv2 binary.


This module is sponsored by photoscout.co.uk


Requirements
------------
(optional) http://www.exiv2.org - exiv2 binaries
(optional) http://www.sno.phy.queensu.ca/~phil/exiftool/ - exiftool binary
php5 (not tested on php4)

In the unlikely! event that someone wants to utilise this for their own modules/procedures 
I have added a new function that will correctly load the proper libraries and return the data.
The function is
iptc_get_iptc($filename)
where $filename is a full path to the image.

Todo
----
A future addition may will be the "php jpeg metadata toolkit" and possibly any other applications
that I can find to accomplish this task.

At the present time I'm not taking any notice of the exif tags as this is handled by the
Exif module; but I am in the process of making this module extract the exif tags and store them
in the database rather than reading them on-the-fly.

I've just realised that the exiftool library might not be working, and the php library may be incomplete.

1	// $Id: README.txt,v 1.3 2007/12/03 23:53:51 fronbow Exp $
2
3	iptc is a module that will extract iptc caption and keyword tags from images added to drupal.
4	It relies on the image module (http://drupal.org/project/image) to function.
5
6	It uses a plugin system to allow different libraries to be utilised to extract the data from
7	an image.
8
9	Currently the module supports the standard php functions, the exiftool binary, the exiv2 binary.
10
11
12	This module is sponsored by photoscout.co.uk
13
14
15	Requirements
16	------------
17	(optional) http://www.exiv2.org - exiv2 binaries
18	(optional) http://www.sno.phy.queensu.ca/~phil/exiftool/ - exiftool binary
19	php5 (not tested on php4)
20
21	In the unlikely! event that someone wants to utilise this for their own modules/procedures
22	I have added a new function that will correctly load the proper libraries and return the data.
23	The function is
24	iptc_get_iptc($filename)
25	where $filename is a full path to the image.
26
27	Todo
28	----
29	A future addition may will be the "php jpeg metadata toolkit" and possibly any other applications
30	that I can find to accomplish this task.
31
32	At the present time I'm not taking any notice of the exif tags as this is handled by the
33	Exif module; but I am in the process of making this module extract the exif tags and store them
34	in the database rather than reading them on-the-fly.
35
36	I've just realised that the exiftool library might not be working, and the php library may be incomplete.
37