<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/"
      xmlns:its="http://www.w3.org/2005/11/its" type="task" style="task"
      id="tools_selection">

  <info>
    <link type="guide" xref="index#tools"/>
    <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>
    <credit type="author">
      <name>Romain F. T.</name>
      <email its:translate="no">rrroschan@gmail.com</email>
    </credit>
    <desc>Select a part of the image</desc>
  </info>

  <title>Selection</title>

  <section>
    <title>Selecting an area</title>

    <p>Tools such as <gui style="button">Rectangle Selection</gui> or <gui
    style="button">Free Selection</gui> are available in the side bar, along
    with <link xref="tools_classic">the other tools</link>. You can use them
    to define a part of the image for further manipulations.</p>

    <p>Aside of defining the contour of an area with the mouse, the selection
    can also be created in various ways:</p>
    <list>
      <item>
        <p><gui style="button">Import</gui> an existing file as your selection.</p>
      </item>
      <item>
        <p><gui style="button">Paste</gui> an image from your clipboard.</p>
      </item>
      <item>
        <p>Right-click, <gui style="menuitem">Select all</gui>.</p>
      </item>
    </list>

    <note style="tip">
      <p>A tool named <gui style="button">Color Selection</gui> also exists, and
      tries to select an area according to its color, but it doesn't always work
      as expected so this tool is <link xref="preferences#tools">disabled by
      default</link>.</p>
    </note>
  </section>

  <section>
    <title>Using the selection</title>

    <p>Once the selection is defined, you can then perform various actions with
    this selected area:</p>
    <list>
      <item>
        <p>Move it on the canvas.</p>
      </item>
      <item>
        <p>Copy it (or cut it) to the clipboard.</p>
      </item>
      <item>
        <p>Transform it with tools. <link xref="tools_transform">The compatible
        tools</link> can be accessed with a right-click on the selection.</p>
        <media type="image" mime="image/png" width="80%" its:translate="no"
               src="figures/screenshot_selection.png" />
      </item>
      <item>
        <p>Delete it.</p>
      </item>
      <item>
        <p>Open it as a new image.</p>
      </item>
      <item>
        <p>Export it as a new file.</p>
      </item>
    </list>
    <p>Click outside of the selected area to unselect, or use the <gui
    style="menuitem">Unselect</gui> menu item.</p>
  </section>

</page>

