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


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

:Created:
      2010-02-18T17:33:18

:Changed:
      2011-02-19T14:41:23.120000000

:Classification:
      image_crop

:Description:
      The keywords help with categorizing and tagging of the manuals. You can combine two or more keywords and add additional keywords yourself. Please use at least one keyword from both lists. If your manual is NOT in english, see next tab "language" ---- forEditors (use this for editors / german "Redakteure") forAdmins (use this for Administrators) forDevelopers (use this for Developers) forBeginners (manuals covering TYPO3 basics) forIntermediates (manuals going into more depth) forAdvanced (covering the most advanced TYPO3 topics) see more: http://wiki.typo3.org/doc_template#tags ----

:Keywords:
      image, crop, cropping, tt_content, scale, gravity

:Author:
      Sigfried Arnol

:Email:
      s.arnold@rebell.at

:Info 4:


:Language:
      en


|img-1| |img-2| Image Crop - image\_crop


.. _Image-Crop:

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

Extension Key: image\_crop

Language: en

Keywords: image, crop, cropping, tt\_content, scale, gravity

Copyright 2000-2010, Sigfried Arnol, <s.arnold@rebell.at>

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
-----------------

`Image Crop 1 <#__RefHeading__669_1711010350>`_

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

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

`Screenshots 3 <#__RefHeading__675_1711010350>`_

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

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

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

`Reference 6 <#__RefHeading__683_1711010350>`_

**`ChangeLog 7 <#__RefHeading__687_1711010350>`_**


.. _Introduction:

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


.. _What-does-it-do:

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

This extension adds the a cropping function to tt\_content images .


.. _Screenshots:

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

|img-3|


.. _Users-manual:

Users manual
------------

- Just enter your preferred target width and height and enable the
  cropping (checkbox) and select an alignment for your cropping
  operation. The alignment is set to “center” by default.

- Keep in mind that the the alignment will only show an effect if the
  ratio of width and height you entered is different from the aspect
  ratio of the original image.

- The effect will not be added permanently to the image, it will only
  affect the generated image. So if you want to choose another
  dimensions or another alignment setting it will simply take the
  original image again and crop it a different way. It works in a
  similar way to the “Effect” option (and of course it can be combined).

|img-3|


.. _Administration:

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

The two new fields for cropping are not defined as exclude fields, so
there is no further configuration needed. If you don't wish a specific
user to use the cropping features you can simply remove the fields via
TSconfig. The fields are named tx\_imagecrop\_crop and
tx\_imagecrop\_gravity.


.. _Configuration:

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

Just install the extension – it should work right away, usually there
is no configuration needed.


.. _Reference:

Reference
^^^^^^^^^

This configuration is added automatically by an
ext\_typoscript\_setup.txt

::

   includeLibs.image_crop = typo3conf/ext/image_crop/pi1/class.tx_imagecrop_pi1.php
   tt_content.image.20.1.stdWrap.postUserFunc = tx_imagecrop_pi1->main

If it does not right away the issue is probably that you have included
CSS Styled Content in a “Basis Template”. Therefore the changes made
by ext\_typoscript\_setup.txt will be overwritten by the default
TypoScript of CSS Styled Content.To fix this you have three options:

Check the Checkbox “Include Static Templates After Basis Templates” in
your Template (though this will have some side effects if other
configuration relies on the fact that it is the other way around).

Include the static template of CSS Styled Content directly into your
primary Template

Add the 2 Lines of TypoScript manually to your Template.


.. _ChangeLog:

ChangeLog
---------

See `ChangeLog online <http://typo3.org/extensions/repository/view/ima
ge_crop/current/info/ChangeLog/>`_

|img-2| 7


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

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

.. |img-2| image:: img-2.png
.. :border: 0
.. :height: 21
.. :hspace: 9
.. :id: Grafik2
.. :name: Grafik2
.. :width: 87

.. |img-3| image:: img-3.png
.. :align: left
.. :border: 0
.. :height: 462
.. :id: Grafik3
.. :name: Grafik3
.. :width: 474