<?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> which are available in the side bar
    (along with <link xref="tools_classic">the other tools</link>), allow you to
    define a part of the image for further manipulations.</p>
    <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 disabled by default.</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>
  </section>

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

    <p>Once the selection is defined, you can then perform various actions with
    this area:</p>
    <list>
      <item>
        <p>Move it on the canvas.</p>
      </item>
      <item>
        <p>Cut or copy it to the clipboard.</p>
      </item>
      <item>
        <p>Edit it with <link xref="tools_canvas">tools</link>. You can access
        the compatible tools with a right-click on the selection.</p>
        <media type="image" mime="image/png" width="80%"
               src="figures/screenshot_selection.png" its:translate="no"/>
      </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>
