### Eclipse Workspace Patch 1.0
#P imagefield_crop-HEAD[downloadManuallyFromDrupal.org]
Index: README.txt
===================================================================
RCS file: /cvs/drupal/contributions/modules/imagefield_crop/README.txt,v
retrieving revision 1.1
diff -u -r1.1 README.txt
--- README.txt	13 Jan 2008 20:54:34 -0000	1.1
+++ README.txt	15 Apr 2010 02:54:00 -0000
@@ -1,29 +1,57 @@
-$Id: README.txt,v 1.1 2008/01/13 20:54:34 yhager Exp $
+$Id: README.txt,v 1.1.4.6 2010/02/08 09:24:19 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 show 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.
+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.
+
+Watch the screencast[1] by capellic[2]
+
+  [1] http://capellic.com/blog/imagefield-crop
+  [2] http://drupal.org/user/192467
+
+= 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 =
-The imagefield_crop module uses interface elements library to implement the resize interface. The following modules are required:
-* jquery_interface (which by itself requires jquery_update).
-* imagefield (since imagefield_crop is just an image widget module, not a field module)
+* imagefield (http://drupal.org/project/imagefield)
+* filefield (http://drupal.org/project/filefield)
+* imageapi (http://drupal.org/project/imageapi)
+* Graphics processing engine (gd, imagemagick, or anything else imageapi.module can work with).
 
 
 = Installation =
+* To install the module copy the 'imagefield_crop' folder to your sites/all/modules directory.
+* Go to admin/build/modules. Enable the module.
+  Read more about installing modules at http://drupal.org/node/70151
 
-* Install the module and enable it.
-* Then on the image field 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.
+
+= Configuration and usage =
+* We assume that you have already created a new content type. Edit your content type fields at admin/content/types
+* Click on appropriate MANAGE FIELDS link.
+* Add a new field. To do so click on SELECT A FIELD TYPE dropdown menu. Select FILE. Click on FILE UPLOAD dropdown menu. Select IMAGE WITH CROPPING.
+* Click on SAVE button.
+* Follow instructions on the next page. You can choose the cropping box size, and other configuration options. If unsure leave default configuration. Click on SAVE FIELD SETTINGS button.
+* Create a new item at /node/add
+* Click on BROWSE button. Select an image.
+* Click on UPLOAD button
 * Upon uploading an image, or editing an existing node, the image cropping interface will be presented.
 
 
-= Issues that you could help with =
+= Contribute. Report issue. Request support. Request new feature. =
+* Go to the module issue queue at http://drupal.org/project/issues/imagefield_crop?status=All&categories=All
+* Click on CREATE A NEW ISSUE link.
+* Fill the form.
+* To get a status report on your request go to http://drupal.org/project/issues/user
 
-* Sometimes you will need to use the 'refresh' button on your browser to see the updated image. I haven't tracked this down yet and help will be appreciated.
-* Only one widget per page is supported (no multiple values, no multiple fields with this widget in the node). This is mostly a limitation of the javascript part of this module, and help here will be appreciated.
-* The module requires the PHP GD library, and will not work if any other library is selected. I believe this limitation can be removed for Drupal 6, where the drupal image library is improved.