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

  <info>
    <link type="guide" xref="index#main"/>
    <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>Opening and saving files.</desc>
  </info>

  <title>Basic features</title>

  <p>"Drawing" is a basic drawing application for the GNOME desktop, which can
  edit or create pictures (PNG, JPEG or BMP).</p>
  <p>Basic features are located in the header of the window, such as the
  <gui style="button">Open</gui> button, the <gui style="button">Save</gui>
  button, and the main menu.</p>

  <section>
    <title>The "Open" button</title>

    <p>Open a picture file from your documents.</p>
    <p>If the window size is too small to display its button, the
    <gui style="button">Open</gui> menu is available in the main menu.</p>
  </section>

  <section>
    <title>The "New" menu</title>

    <p>This menu allows you to create a new image. Several options are
    available:</p>
    <list>
      <item>
        <p>Create a new blank image, in a new tab. Such an new image can use the
        <link xref="preferences">default size and background color</link>, or
        you can set custom values.</p>
      </item>
      <item>
        <p>Create a new image from the current <link xref="selection_tools">
        selection</link>.</p>
      </item>
      <item>
        <p>Create a new image from the clipboard content.</p>
      </item>
      <item>
        <p>Open a new window with a new blank image.</p>
      </item>
    </list>
    <p>If the window size is too small to display its button, the
    <gui style="button">New</gui> menu is merged in the main menu.</p>
  </section>

  <section id="main-menu">
    <title>The main menu</title>

    <media type="image" mime="image/png" width="80%"
           src="figures/screenshot_menu.png" its:translate="no"/>
    <list>
      <item>
        <p>Print the picture.</p>
      </item>
      <item>
        <p>See the pictures properties, such as its size and colorspace.</p>
      </item>
      <item>
        <p>Export the image or save it as a new file. Both options don't overwrite
        the original file. With <gui style="menuitem">Export as…</gui>, you keep
        editing the original file, but <gui style="menuitem">Save as…</gui> closes
        the original file and makes you edit the new one.</p>
      </item>
      <item>
        <p>Show tools names. Edit <link xref="preferences">preferences</link>.</p>
      </item>
    </list>
  </section>

  <section>
    <title>Edition</title>

    <p>You can edit the opened picture with the <link xref="drawing_tools">tools
    </link> in the side bar. The <gui style="button">Undo</gui> and
    <gui style="button">Redo</gui> buttons are located in the header of the
    window.</p>
  </section>

  <section>
    <title>Preview</title>

    <p>In the bottom bar, the <gui style="button">Preview</gui> button (not
    available with <link xref="canvas_tools">some tools</link>) displays a
    thumbnail of the full picture you're editing.</p>
  </section>

</page>
