.. You may want to use the usual include line. Uncomment and adjust the path. 
.. include:: ../Includes.txt


==========
Crop Image
==========

:Author:
      Christopher

:Created:
      2010-12-18T19:57:23

:Changed:
      2014-10-29T11:04:29.320000000

:Classification:
      pb_crop_image

:Keywords:
      image, crop, cropping, filelist

:Author:
      Peter Benke

:Email:
      peter.benke@nttdata.com

:Language:
      en


.. _img-1-img-2-Crop-Image:

|img-1| |img-2| Crop Image
==========================

Extension Key: pb\_crop\_image

Language: en

Version: x.y.z

Keywords: image, crop, cropping, filelist

Copyright 2012-2014, Peter Benke, <peter.benke@nttdata.com>

This document is published under the Open Content License

available from http://www.opencontent.org/opl.shtml

The content of this document is related to TYPO3

\- a GNU/GPL CMS/Framework available from www.typo3.org

.. _Table-of-Contents:

Table of Contents
-----------------

**`Crop Image 1 <#__RefHeading__5708_1738894311>`_**

**`Introduction 3 <#__RefHeading__5710_1738894311>`_**

`What does it do? 3 <#__RefHeading__463_413120346>`_

`Screenshots 3 <#__RefHeading__465_413120346>`_

**`Users manual 4 <#__RefHeading__467_413120346>`_**

`Features 4 <#__RefHeading__31507_818911409>`_

`FAQ 4 <#__RefHeading__31509_818911409>`_

**`Administration 5 <#__RefHeading__31511_818911409>`_**

`Installation 5 <#__RefHeading__20367_337469319>`_

`Setup 5 <#__RefHeading__20369_337469319>`_

**`Configuration 6 <#__RefHeading__31515_818911409>`_**

**`Known problems 7 <#__RefHeading__31525_818911409>`_**

**`ChangeLog 8 <#__RefHeading__31623_818911409>`_**


.. _Introduction:

Introduction
------------


.. _What-does-it-do:

What does it do?
^^^^^^^^^^^^^^^^

This Extension gives you the possibility to crop images in the
filelist-module. There is a new item in the context-menu of every
image.

The Javascript is based on jcrop, the jQuery image cropping plugin:
`http://code.google.com/p/jcrop/ <http://code.google.com/p/jcrop/>`_

This extension only is tested in version 6.2!

The Version 2.0.0 of this extension works in TYPO3 4.7


.. _Screenshots:

Screenshots
^^^^^^^^^^^

|img-3| |img-4| 
Users manual
------------

- Go to the filelist and click on the new menu-item in the context-menu
  of an image.

- Make your selection for cropping by drawing a rectangle.

- When you are finished click on “Crop image!”.

- The new file will be saved in the same directory with the filename:
  filename\_[width]x[height].[extension].

- If you want, change the standard size (which is defined in the
  extension configuration) and click on “Change size”.


.. _Features:

Features
^^^^^^^^

- If your image is larger than the browser-viewport, it will be resized
  by css, so you can see the whole width of the image.

- If the selection is smaller than the defined image size, the image
  section has a red border. Maybe the quality of the image is going down
  in this case.

- You can drag the form to any position you want.


.. _FAQ:

FAQ
^^^

**Q:** Is this extension working with DAM? **A:** No.


.. _Administration:

Administration
--------------


.. _Installation:

Installation
^^^^^^^^^^^^

Download the extension and install it with the extension manager.


.. _Setup:

Setup
^^^^^

.. ### BEGIN~OF~TABLE ###


.. _finalWidth:

finalWidth
""""""""""

.. container:: table-row

   Variable
         finalWidth
   
   Definition
         The standard width of the target image
   
   Default
         600px



.. _finalHeight:

finalHeight
"""""""""""

.. container:: table-row

   Variable
         finalHeight
   
   Definition
         The standard height of the target image
   
   Default
         400px



.. _imageExtension:

imageExtension
""""""""""""""

.. container:: table-row

   Variable
         imageExtension
   
   Definition
         Extension of the target image
   
   Default
         web(the same extension asthe source image)


.. ###### END~OF~TABLE ######


.. _Configuration:

Configuration
-------------

Nothing to config.


.. _Known-problems:

Known problems
--------------

None at the moment.


.. _ChangeLog:

ChangeLog
---------

.. ### BEGIN~OF~TABLE ###


.. _1-0-0:

1.0.0
^^^^^

.. container:: table-row

   Version
         1.0.0
   
   Changes
         Init Version.



.. _2-0-0:

2.0.0
^^^^^

.. container:: table-row

   Version
         2.0.0
   
   Changes
         Some Bugfixes



.. _3-0-0:

3.0.0
^^^^^

.. container:: table-row

   Version
         3.0.0
   
   Changes
         Breaking Changes! The extension only works in TYPO3 6.2!If you use
         TYPO3 4.7, you can use the version 2.0.0


.. ###### END~OF~TABLE ######


.. ######CUTTER_MARK_IMAGES######

.. |img-1| image:: img-1.png
.. :align: left
.. :border: 0
.. :height: 44
.. :id: graphics5
.. :name: graphics5
.. :vspace: 57
.. :width: 161

.. |img-2| image:: img-2.png
.. :align: left

.. |img-3| image:: img-3.png
.. :align: left
.. :border: 0
.. :height: 153
.. :id: Grafik1
.. :name: Grafik1
.. :width: 156

.. |img-4| image:: img-4.png
.. :align: left
.. :border: 0
.. :height: 365
.. :id: Grafik2
.. :name: Grafik2
.. :width: 444