<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY date "February 2009">
<!ENTITY version "@PACKAGE_VERSION@">
<!ENTITY application "@PACKAGE_NAME@">
]>
<article id="xfce4-screenshooter" lang="it">

  <!-- Header -->
  <articleinfo>
    <title>Xfce4 Screenshooter</title>

    <pubdate>&date;</pubdate>

    <copyright>
      <year>2008</year>
      <year>2009</year>
      <holder>Jérôme Guelfucci</holder>
    </copyright>

    <copyright>
      <year>2009</year>
      <holder>Sam Swift</holder>
    </copyright>

    <legalnotice id="legalnotice">
      <para>È garantito il diritto di copiare, distribuire e/o modificare questo documento nel rispetto dei termini della licenza GNU Free Documentation License, versione 1.1 o qualsiasi versione successiva pubblicata dalal Free Software Foundation; senza Invariant Section senza testi di Front-Cover e senza testi di Back-Cover. Il testo della licenza completa è reso disponibile dalla <ulink type="http" url="http://www.gnu.org/">Free Software Foundation</ulink>. </para>
    </legalnotice>

    <authorgroup>
      <author>
        <firstname>Jérôme</firstname>
        <surname>Guelfucci</surname>
        <affiliation>
          <address><email>jeromeg@xfce.org</email></address>
        </affiliation>
      </author>
      <author>
        <firstname>Sam</firstname>
        <surname>Swift</surname>
        <affiliation>
          <address><email>renmush@gmail.com</email></address>
        </affiliation>
      </author>
    </authorgroup>

    <releaseinfo>Questo manuale descrive la versione @PACKAGE_VERSION@ di Xfce4 Screenshooter.</releaseinfo>
  </articleinfo>

  <sect1 id="intro">
    <title>Introduzione a Xfce4 screenshooter</title>

    <para>
      This application allows you to capture the entire screen, the
      active window or a selected region. You can set the delay that
      elapses before the screenshot is taken and the action to be
      performed afterwards: save the screenshot to a PNG file, copy it
      to the clipboard, open it using another application, or host it on
      <ulink type="http" url="http://www.zimagez.com">ZimageZ</ulink>,
      a free online image hosting service.
    </para>

    <para>Un plugin per il pannello di Xfce è già disponibile</para>

  </sect1>

  <sect1 id="using-the-application">
    <title>Utilizzare l'applicazione</title>

    <sect2 id="user-interface">
      <title>Attraverso l'interfaccia utente</title>

      <para>Per lanciare l'applicazione, utilizzare l'elemento «Istantanea» nella categoria «Accessori» del menu principale di Xfce.</para>

      <para>Verrà visualizzata questa finestra:</para>

      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="images/xfce4-screenshooter-dialog1.png" format="PNG"/>
          </imageobject>

          <textobject>
            <phrase>La finestra di Xfce4 screenshooter</phrase>
          </textobject>
        </mediaobject>
      </screenshot>

      <sect4 id="region-to-capture">
        <title>Regione da catturare</title>

        <para>
          The <emphasis>"Region to capture"</emphasis> section allows
          you to set what the screenshot will be taken of:
        </para>

        <itemizedlist>
          <listitem>«Schermo intero» cattura un'istantanea di tutto lo schermo così com'è visualizzato.</listitem>
          <listitem>
            "Active window" takes a screenshot of the active window.
            This will be the one that was active before this dialog
            appeared, or if you set a delay, the one that is active
            after the delay.
          </listitem>
          <listitem>
            "Select a region" allows you to select a region to be
            captured by clicking and dragging a rectangle over the area
            of screen that you wish to capture, before releasing the
            mouse button.
          </listitem>
        </itemizedlist>
      </sect4>

      <sect4 id="include-pointer">
        <title>Capturing the pointer</title>

        <para>
          The <emphasis>"Capture the mouse pointer"</emphasis>
          option allows you to select whether or not the screenshot will
          include the mouse pointer.
        </para>
      </sect4>

      <sect4 id="delay">
        <title>Ritardo prima di scattare l'istantanea</title>

        <para>
          The <emphasis>"Delay before capturing"</emphasis>
          section allows you to set the delay that will elapse between
          pressing the <emphasis>"OK"</emphasis> button and screenshot
          being taken. This delay will allow you to open menus or to
          perform whatever action you require to see displayed in the
          screenshot.
        </para>
      </sect4>
    </sect2>
    
    <sect3 id="after-capturing">
      <title>Dopo la cattura</title>
      
      <para>
        After pressing the <emphasis>"OK"</emphasis> button a second
        window will be displayed:
      </para>

      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="images/xfce4-screenshooter-dialog2.png" format="PNG"/>
          </imageobject>

          <textobject>
            <phrase>The window of Xfce4 Screenshooter after taking a
            screenshot</phrase>
          </textobject>
        </mediaobject>
      </screenshot>

      <sect4 id="preview">
        <title>Preview</title> 

        <para>
          The <emphasis>"Preview"</emphasis> section displays a
          thumbnail of the screenshot.
        </para>
      </sect4>

      <sect4 id="action">
        <title>Azione</title>

        <para>
          The <emphasis>"Action"</emphasis> section allows you to choose
          what should be performed on the screenshot.
        </para>

        <sect5 id="save">
          <title>Save</title>

          <para>
            The <emphasis>"Save"</emphasis> option will save the
            screenshot to a PNG file. A save dialog will be
            displayed. You will be able to set the save location, and
            the name of the file.
          </para>

          <para>Xfce4 Screenshooter è inoltre in grado di salvare l'istantanea in qualsiasi file system remoto supportato da GVfs, quale FTP, SAMBA, SFTP, computer remoti accessibili via SSH... È semplicemente necessario connettere questi file system remoti utilizzando <emphasis>gvfs-connect</emphasis> o <ulink type="http" url="http://www.uvena.de/gigolo/">Gigolo</ulink> e verranno resi disponibili nella colonna di sinistra della finestra di salvataggio.</para>
        </sect5>

        <sect5 id="copy-to-clipboard">
          <title>Copia negli appunti</title>

          <para>
            The <emphasis>"Copy to the clipboard"</emphasis> option
            allows you to paste the screenshot in another application,
            such as a word processor. This option is only available when
            a clipboard manager is running.
          </para>
        </sect5>

        <sect5 id="open-with">
          <title>Apri con</title>

          <para>
            The <emphasis>"Open with"</emphasis> option saves the
            screenshot to the system's temporary directory and opens it
            with the application chosen from the drop-down list.
            Applications which support images are automatically detected
            and added to the drop-down list.
          </para>
        </sect5>

        <sect5 id="zimagez">
          <title>Ospita su ZimageZ</title>
          
          <para>L'opzione <emphasis>«Ospita su ZimageZ»</emphasis> permette all'utente di far ospitare la propria istantanea su questo servizio gratuito online, in modo da poterla condividere in modo più semplice con altre persone. ZimageZ genera automaticamente una miniatura più grande e una più piccola dell'istantanea, che può essere usata per creare dei collegamenti che puntano all'immagine a dimensione intera.</para>

          <para>Dopo aver premuto il pulsante <emphasis>«OK»</emphasis>, verrà visualizzata la seguente finestra:</para>

          <screenshot>
            <mediaobject>
              <imageobject>
                <imagedata fileref="images/xfce4-screenshooter-zimagez-login-dialog.png" format="PNG"/>
              </imageobject>

              <textobject>
                <phrase>La finestra per poter far ospitare un'istantanea su ZimageZ</phrase>
              </textobject>
            </mediaobject>
          </screenshot>

          <para>Se non si è in possesso di un nome utente per ZimageZ, sarà necessario crearne uno dal <ulink type="http" url="http://www.zimagez.com">sito di ZimageZ</ulink>. Questo sito è disponibile in diverse lingue che possono essere selezionate utilizzando il menu in alto a destra. È necessario compilare tutti i campi in questa finestra. Una volta premuto il tasto <emphasis>«OK»</emphasis>, il caricamento avrà inizio.</para>
          
          <para>La finestra più sotto fornirà il collegamento all'istantanea a dimensione intera, alla miniatura più grande, a quella più piccola, ma anche a esempi di codice HTML e BBcode utili per creare una miniatura che punta all'istantanea a dimensione intera:</para>

          <screenshot>
            <mediaobject>
              <imageobject>
                <imagedata fileref="images/xfce4-screenshooter-zimagez-result-dialog.png" format="PNG"/>
              </imageobject>

              <textobject>
                <phrase>La finestra che fornisce il collegomento alla propria istantanea su ZimageZ</phrase>
              </textobject>
            </mediaobject>
          </screenshot>

        </sect5>
      </sect4>
    </sect3>

    <sect2 id="command-line">
      <title>Attraverso la linea di comando</title>

      <para>
        Command line options allow you to take screenshots quickly. They
        also allow you to configure the Print Screen key on the upper
        right of most keyboards so that it takes screenshots. To do so,
        configure the key-bindings of your desktop environment so that
        it launches xfce4-screenshooter with one or several of the
        following options when the Prt Scrn key is pressed.
      </para>

      <sect3 id="options">
        <title>Le opzioni per la linea di comando</title>

        <sect4 id="w-option">
          <title>L'opzione -w</title>

          <para>L'opzione <emphasis>-w</emphasis> consente di catturare un'istantanea della finestra attiva.</para>
        </sect4>

        <sect4 id="f-option">
          <title>L'opzione -f</title>

          <para>L'opzione <emphasis>-f</emphasis> consente di catturare un'istantanea di tutto lo schermo.</para>
        </sect4>

        <sect4 id="r-option">
          <title>L'opzione -r</title>

          <para>
            The <emphasis>-r</emphasis> option allows you to select a
            region to be captured by clicking and dragging a rectangle
            over the area of screen that you wish to capture, before
            releasing the mouse button.
          </para>
        </sect4>

        <sect4 id="d-option">
          <title>L'opzione -d</title>

          <para>
            The <emphasis>-d</emphasis> option followed by a positive
            integer allows you to set the delay before taking the
            screenshot when the <emphasis>-w</emphasis>, the
            <emphasis>-f</emphasis> or the <emphasis>-r</emphasis>
            option is given.
          </para>
        </sect4>

        <sect4 id="s-option">
          <title>L'opzione -s</title>

          <para>
            The <emphasis>-s</emphasis> option followed by the path to
            an existing folder allows you to set where the screenshots
            are saved. This option only has an effect if the
            <emphasis>-w</emphasis>, the <emphasis>-f</emphasis> or
            the <emphasis>-r</emphasis> option is given.
          </para>
        </sect4>

        <sect4 id="o-option">
          <title>L'opzione -o</title>

          <para>
            If the <emphasis>-o</emphasis> option is given, followed by
            an application name, the screenshot will be saved to the
            system's temporary directory and opened with the application
            whose name is to be given after <emphasis>-o</emphasis>.
            This option only has an effect if the
            <emphasis>-w</emphasis>, the <emphasis>-f</emphasis> or the
            <emphasis>-r</emphasis> option is given.
          </para>
        </sect4>

        <sect4 id="u-option">
          <title>L'opzione -u</title>

          <para>
            If the <emphasis>-u</emphasis> option is given, the screenshot
            will be hosted on ZimageZ. See above for more details.
            This option only has an effect if the
            <emphasis>-w</emphasis>, the <emphasis>-f</emphasis> or the
            <emphasis>-r</emphasis> option is given.
          </para>
        </sect4>
      </sect3>
    </sect2>
  </sect1>

  <sect1 id="panel-plugin">
    <title>Using the Xfce panel plugin</title>

    <sect2 id="add">
      <title>Aggiungere il plugin</title>

      <para>Per aggiungere il plugin al pannello, fare clic con il tasto destro del mouse sul pannello e selezionare la voce <emphasis>«aggiungi nuovo elemento»</emphasis>. Selezionare il plugin denominato <emphasis>«istantanea»</emphasis> e aggiungerlo.</para>
    </sect2>

    <sect2 id="set">
      <title>Configuring the plugin</title>

      <para>
        You can configure how screenshots are taken by right clicking on
        the plugin and selecting <emphasis>"Properties"</emphasis>. A
        preferences dialog similar to the dialog of the main application
        will appear. Please have a look above for the different
        preferences.
      </para>
    </sect2>

    <sect2 id="use">
      <title>Utilizzare il plugin</title>

      <para>
        To take a screenshot, just click on the plugin. You can use the
        scroll wheel on the plugin button to switch between the different
        regions to be captured.
      </para>
    </sect2>

  </sect1>

</article>
