modules/imagefield_crop/README.txt

$Id: README.txt,v 1.1.4.2 2009/01/29 10:12:10 yhager Exp $

= Overview =
imagefield_crop provides a widget for cropping an image after upload.


= Usage =
When the user uploads an image, the image is presented inside a cropping area.
A cropping box is shown inside, and the user can resize and move it. Upon
clicking 'preview' or 'submit', the image is cropped and the result is saved
within the node.

== Features ==

* Dynamic preview is presented during cropping
* Original image is displayed every time for re-cropping
* The original image is used for cropping, for best quality
* Ability to define the crop interface resolution
* Ability to define the output image resolution and enforce it


= Prerequisites =
You will need imagefield and imageapi enabled in order to use this module.


= Installation =
* Install the module and enable it.
* [opt.] Patch imagefield, as described below
* On the imagefield configuration page (admin/content/types/<content_type>/fields/<your_image_field>) choose the 'Image with cropping' widget.
* Save your field, and edit it again. There you can see the widget settings form where you can choose the cropping box size, and other configuration options.
* Upon uploading an image, or editing an existing node, the image cropping interface will be presented.

== Patch imagefield ==
In order to see the cropped images without a manual browser refresh, use the
patch in http://drupal.org/node/353405#comment-1224788. 
1	$Id: README.txt,v 1.1.4.2 2009/01/29 10:12:10 yhager Exp $
2
3	= Overview =
4	imagefield_crop provides a widget for cropping an image after upload.
5
6
7	= Usage =
8	When the user uploads an image, the image is presented inside a cropping area.
9	A cropping box is shown inside, and the user can resize and move it. Upon
10	clicking 'preview' or 'submit', the image is cropped and the result is saved
11	within the node.
12
13	== Features ==
14
15	* Dynamic preview is presented during cropping
16	* Original image is displayed every time for re-cropping
17	* The original image is used for cropping, for best quality
18	* Ability to define the crop interface resolution
19	* Ability to define the output image resolution and enforce it
20
21
22	= Prerequisites =
23	You will need imagefield and imageapi enabled in order to use this module.
24
25
26	= Installation =
27	* Install the module and enable it.
28	* [opt.] Patch imagefield, as described below
29	* On the imagefield configuration page (admin/content/types/<content_type>/fields/<your_image_field>) choose the 'Image with cropping' widget.
30	* Save your field, and edit it again. There you can see the widget settings form where you can choose the cropping box size, and other configuration options.
31	* Upon uploading an image, or editing an existing node, the image cropping interface will be presented.
32
33	== Patch imagefield ==
34	In order to see the cropped images without a manual browser refresh, use the
35	patch in http://drupal.org/node/353405#comment-1224788.