<?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="canvas_tools">

  <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>Transform the image canvas or the current selection</desc>
  </info>

  <title>Edit the canvas or the selection</title>

  <p>These tools are available from the side bar (along with
  <link xref="drawing_tools">the other tools</link>), or from a right click on
  the canvas while using the <gui style="button">Selection</gui> tool.</p>
  <p>If a selection is defined, these tools will have an effect on the selected
  area, otherwise they will have an effect on the picture as a whole.</p>

  <list>
    <item>
      <p>Crop: change the size of the image, using the values in the bottom bar,
      or with the mouse. The cursor gives you an indication about the side of
      the image affected if you click at given coordinates. The previewed image
      might not be at a 100% scale.</p>
    </item>
    <item>
      <p>Scale: resize the image, using the values in the bottom bar, or with
      the left click.</p>
    </item>
    <item>
      <p>Rotate: change the orientation of the image, using the buttons in the
      bottom bar.</p>
    </item>
    <item>
      <p>Flip: flip the image, using the buttons in the bottom bar.</p>
    </item>
    <item>
      <p>Saturate: edit the saturation of the image, using the value in the
      bottom bar.</p>
      <media type="image" mime="image/png" width="450"
      src="figures/screenshot_saturate.png" its:translate="no"/>
      <p>A saturation bigger than 100% will boost the colors, a saturation
      smaller than 100% will produce a greyish image.</p>
    </item>
  </list>

  <p>After finding the value you need, you have to apply the result with the
  <gui style="button">Apply</gui> button at the right. Otherwise you can cancel
  the edition with the <gui style="button">Cancel</gui> button at the left.</p>

</page>
