1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
3                       "http://www.docbook.org/xml/4.3/docbookx.dtd">
4<!-- section history:
5  2007-11-07 j.h: added example 'en','fr'
6  2007-09-25 AntI: Added 'es'
7  2006-07-28 scb: revised 'en'
8-->
9<sect2 id="plug-in-autocrop">
10  <title>Autocrop Image</title>
11
12  <indexterm>
13    <primary>Image</primary>
14    <secondary>Crop</secondary>
15    <tertiary>Autocrop</tertiary>
16  </indexterm>
17  <indexterm>
18    <primary>Autocrop</primary>
19  </indexterm>
20
21  <para>
22    The <guimenuitem>Autocrop Image</guimenuitem> command removes the
23    borders from an image. It searches the active layer for the largest
24    possible border area that is all the same color, and then crops this
25    area from the image, as if you had used the
26    <link linkend="gimp-tool-crop">Crop</link> tool.
27  </para>
28  <caution>
29    <para>
30      Note carefully that this command only uses the
31      <emphasis>active layer</emphasis>
32      of the image to find borders. Other layers are cropped according to
33      the same limits as limits in the active layer.
34    </para>
35  </caution>
36
37  <sect3>
38    <title>Activate the Command</title>
39    <itemizedlist>
40      <listitem>
41        <para>
42          You can access this command from the image menubar through
43          <menuchoice>
44            <guimenu>Image</guimenu>
45            <guimenuitem>Autocrop Image</guimenuitem>
46          </menuchoice>.
47        </para>
48      </listitem>
49    </itemizedlist>
50  </sect3>
51
52  <sect3>
53    <title>Example</title>
54    <figure>
55      <title><quote>Autocrop</quote> example</title>
56      <mediaobject>
57        <imageobject>
58          <imagedata format="PNG"
59            fileref="images/menus/image/autocrop-1.png"/>
60        </imageobject>
61        <caption>
62          <para>
63            This image is made of three layers. One with a red square,
64            another with a green square; both on a yellow semi-transparent
65            background. The green layer is active.
66          </para>
67        </caption>
68      </mediaobject>
69      <mediaobject>
70        <imageobject>
71          <imagedata format="PNG"
72            fileref="images/menus/image/autocrop-2.png"/>
73        </imageobject>
74        <caption>
75          <para>
76            <quote>Autocrop</quote> has cropped the green square and made a
77            layer from it. The other layers have been cropped to the same
78            size as the green one. Only a small part of the red square has
79            been kept.
80          </para>
81        </caption>
82      </mediaobject>
83    </figure>
84  </sect3>
85</sect2>
86