modules/watermark/README.txt

$Id: README.txt,v 1.2.2.1 2007/06/25 00:47:34 kbahey Exp $

Image Watermark

by Khalid Baheyeldin of http://2bits.com
modified by schnizZzla for http://BerlinerStrassen.com

Scaling option based on patch (http://drupal.org/node/81161)
by michael curry (inactivist) of http://exodusdev.com/

Description:
-------------

This modules allows a Drupal site running the image module to overlay each image
with a watermark.

- Path for watermark is configurable.
- The location of the watermark can be any one of nine positions.
- Can select which images to apply the watermark to (e.g. preview and _original, but
  not thumbnail.
- Preserve original image type after watermark has been applied
- Support alpha blending
- Apply watermark only when a new image is uploaded, do not not apply watermarks twice!
- Apply watermark on previews, too
- Watermark can be scaled, percentage of image width and minimum width in pixels can be set.
- Toggle: Exclude image nodes with specific gallery terms from watermark

Known Limitations:
- Changing watermark settings does not work retroactive, watermark settings apply to
  new images only.
- Saving image module settings "breaks" watermark SETTINGS, even if you did not change
  anything. That means watermarks disappear or apply to all image sizes, when the node
  or gallery is viewed.


Requirements:
-------------

This module requires no patches to Drupal nor image module.

It does require the PHP GD library to be configured by your host, and
PHP must be compiled in with --enable-exif.

GD is enabled by default in PHP 4.3 and later, and can be added
to earlier version if compiled in them.
For more information see http://php.net/image

The module was tested with PHP 4.4.0 and 5.1.2, but should work with other
versions that had GD.

Check the output of phpinfo() from your server to see if you have all
required pieces.

Usage:
------

Enable the module and navigate to admin/settings/image_watermark to enable watermark processing
for new image uploads.

To do:
------
- complete implementation of watermark_admin_settings_validate
- complete watchdog error reports
- animated gif support (a detection to exclude gif images automatically or a method to process animated gifs)
1	$Id: README.txt,v 1.2.2.1 2007/06/25 00:47:34 kbahey Exp $
2
3	Image Watermark
4
5	by Khalid Baheyeldin of http://2bits.com
6	modified by schnizZzla for http://BerlinerStrassen.com
7
8	Scaling option based on patch (http://drupal.org/node/81161)
9	by michael curry (inactivist) of http://exodusdev.com/
10
11	Description:
12	-------------
13
14	This modules allows a Drupal site running the image module to overlay each image
15	with a watermark.
16
17	- Path for watermark is configurable.
18	- The location of the watermark can be any one of nine positions.
19	- Can select which images to apply the watermark to (e.g. preview and _original, but
20	not thumbnail.
21	- Preserve original image type after watermark has been applied
22	- Support alpha blending
23	- Apply watermark only when a new image is uploaded, do not not apply watermarks twice!
24	- Apply watermark on previews, too
25	- Watermark can be scaled, percentage of image width and minimum width in pixels can be set.
26	- Toggle: Exclude image nodes with specific gallery terms from watermark
27
28	Known Limitations:
29	- Changing watermark settings does not work retroactive, watermark settings apply to
30	new images only.
31	- Saving image module settings "breaks" watermark SETTINGS, even if you did not change
32	anything. That means watermarks disappear or apply to all image sizes, when the node
33	or gallery is viewed.
34
35
36	Requirements:
37	-------------
38
39	This module requires no patches to Drupal nor image module.
40
41	It does require the PHP GD library to be configured by your host, and
42	PHP must be compiled in with --enable-exif.
43
44	GD is enabled by default in PHP 4.3 and later, and can be added
45	to earlier version if compiled in them.
46	For more information see http://php.net/image
47
48	The module was tested with PHP 4.4.0 and 5.1.2, but should work with other
49	versions that had GD.
50
51	Check the output of phpinfo() from your server to see if you have all
52	required pieces.
53
54	Usage:
55	------
56
57	Enable the module and navigate to admin/settings/image_watermark to enable watermark processing
58	for new image uploads.
59
60	To do:
61	------
62	- complete implementation of watermark_admin_settings_validate
63	- complete watchdog error reports
64	- animated gif support (a detection to exclude gif images automatically or a method to process animated gifs)