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

  <!-- 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><copyright><year>2008, 2009.</year><holder>Leandro Regueiro (leandro.regueiro@gmail.com)</holder></copyright>

    <legalnotice id="legalnotice">
      <para>
        Permission is granted to copy, distribute and/or modify this document
        under the terms of the GNU Free Documentation License, Version 1.1 or
        any later version published by the Free Software Foundation; with no
        Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
        Texts. The complete license text is available from the <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>Este manual describe a versión @PACKAGE_VERSION@ de Xfce4 Screenshooter.</releaseinfo>
  </articleinfo>

  <sect1 id="intro">
    <title>Introdución a Xfce4 Screenshooter</title>

    <para>Este aplicativo permítelle capturar toda a pantalla, a fiestra activa ou unha zona seleccionada. Pode definir o tempo de espera que transcorre antes de que se tome a captura de pantalla e a acción que se realizará ca captura de pantalla: gardala nun ficheiro PNG, copiala ao portarretallos, abrila usando outro aplicativo, ou aloxala en <ulink type="http" url="http://www.zimagez.com">ZimageZ</ulink>, un servizo de aloxamento de imaxes en liña gratuito.</para>

    <para>Tamén hai un engadido para o panel de Xfce.</para>

  </sect1>

  <sect1 id="using-the-application">
    <title>Uso da aplicación</title>

    <sect2 id="user-interface">
      <title>A través da interface de usuario</title>

      <para>Para iniciar a aplicación use o elemento "Captura de pantalla" na categoría "Accesorios" do menú principal de Xfce.</para>

      <para>Mostrarase esta fiestra:</para>

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

          <textobject>
            <phrase>A fiestra de Xfce4 Screenshooter</phrase>
          </textobject>
        </mediaobject>
      </screenshot>

      <sect4 id="region-to-capture">
        <title>Zona a capturar</title>

        <para>A sección <emphasis>"Zona a capturar"</emphasis> permítelle definir de onde se vai tomar a captura de pantalla:</para>

        <itemizedlist>
          <listitem>"Toda a pantalla" toma unha captura de pantalla da pantalla completa tal como a ve vostede.</listitem>
          <listitem>"Fiestra activa" realiza unha captura de pantalla da fiestra activa, sendo esta a que estaba activa antes de que aparecera este diálogo, ou se se define un tempo de espera, a que estea activa cando remate dito tempo de espera.</listitem>
          <listitem>"Seleccionar unha zona" permítelle seleccionar a zona a capturar premendo nun punto da pantalla e sen soltar o botón do rato, arrastrando o punteiro do rato á esquina oposta da zona, e soltando o botón do rato.</listitem>
        </itemizedlist>
      </sect4>

      <sect4 id="include-pointer">
        <title>Capturar o punteiro</title>

        <para>A sección <emphasis>"Capturar o punteiro do rato"</emphasis> permítelle definir se se inclúe na captura de pantalla o punteiro do rato:</para>
      </sect4>

      <sect4 id="delay">
        <title>Atraso antes da captura</title>

        <para>A sección <emphasis>"Tempo de espera antes da captura"</emphasis> permítelle definir o tempo de espera que transcorrerá dende que se prema o botón <emphasis>"Aceptar"</emphasis> ata que se realice a captura de pantalla. Este tempo de espera permitiralle abrir menús ou facer calquera acción que desexe que se vexa na captura de pantalla.</para>
      </sect4>
    </sect2>
    
    <sect3 id="after-capturing">
      <title>Despois de capturar</title>
      
      <para>Despois de premer no botón <emphasis>"Aceptar"</emphasis> háselle mostrar unha segunda fiestra:</para>

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

          <textobject>
            <phrase>A fiestra de Xfce4 Screenshooter despois de realizar unha captura de pantalla</phrase>
          </textobject>
        </mediaobject>
      </screenshot>

      <sect4 id="preview">
        <title>Vista previa</title> 

        <para>A sección <emphasis>"Vista previa"</emphasis> mostra unha miniatura da captura de pantalla.</para>
      </sect4>

      <sect4 id="action">
        <title>Acción</title>

        <para>A sección <emphasis>"Acción"</emphasis> permítelle escoller que se vai facer ca captura de pantalla.</para>

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

          <para>A opción <emphasis>"Gardar"</emphasis> gardará a captura de pantalla nun ficheiro PNG. Mostrarase un diálogo para que poida seleccionar onde se vai gardar e o nome do ficheiro.</para>

          <para>Xfce4 Screenshooter tamén ten a capacidade de gardar a captura de pantalla en calquera sistema de ficheiros remoto soportado por GVfs, como FTP, SAMBA, SFTP, ordenadores remotos accesibles mediante SSH... Só ten que conectarse a este sistema de ficheiros remoto usando <emphasis>gvfs-connect</emphasis> ou <ulink type="http" url="http://www.uvena.de/gigolo/">Gigolo</ulink> e estará dispoñible na columna da esquerda do menú de gardar.</para>
        </sect5>

        <sect5 id="copy-to-clipboard">
          <title>Copiar ó portarretallos</title>

          <para>A opción <emphasis>"Copiar ao portarretallos"</emphasis> permítelle pegar a captura de pantalla noutra aplicación, por exemplo nun procesador de textos. Esta opción só está dispoñible cando se está executando un xestor de portarretallos.</para>
        </sect5>

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

          <para>A opción <emphasis>"Abrir con"</emphasis> garda a captura de pantalla no directorio temporal do sistema e ábrea co aplicativo seleccionado na lista despregable da dereita. Os aplicativos que soportan imaxes detéctanse automaticamente e engádense á lista despregable.</para>
        </sect5>

        <sect5 id="zimagez">
          <title>Gardar en ZimageZ</title>
          
          <para>A opción <emphasis>"Gardar en ZimageZ"</emphasis> permítelle gardar a súa captura de pantalla neste servizo de aloxamento en liña gratuíto, de forma que poida compartila facilmente con outra xente. ZimageZ xera automaticamente unha miniatura grande e outra pequena da súa captura de pantalla, as cales se poden usar para crear miniaturas que apunten á captura de pantalla a tamaño completo.</para>

          <para>Despois de premer no botón <emphasis>"Aceptar"</emphasis> háselle mostrar este diálogo:</para>

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

              <textobject>
                <phrase>O diálogo para gardar unha captura de pantalla en ZimageZ</phrase>
              </textobject>
            </mediaobject>
          </screenshot>

          <para>Se non ten un nome de usuario de ZimageZ, terá que crear un no <ulink type="http" url="http://www.zimagez.com">sitio web de ZimageZ</ulink>. Hai varios idiomas dispoñibles neste sitio web, e pode cambiar de idioma usando o menú na esquina superior dereita. Debe cubrir tódolos campos deste diálogo. Unha vez que prema no botón <emphasis>"Aceptar"</emphasis> comezará a suba do ficheiro.</para>
          
          <para>O diálogo de embaixo proporciónalle ligazóns á captura de pantalla a tamaño completo, á miniatura grande e á pequena, así como exemplos de HTML e BBcode para crear unha miniatura que apunte á captura de pantalla a tamaño completo:</para>

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

              <textobject>
                <phrase>O diálogo que proporciona as ligazóns á súa captura de pantalla en ZimageZ</phrase>
              </textobject>
            </mediaobject>
          </screenshot>

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

    <sect2 id="command-line">
      <title>A través da liña de comandos</title>

      <para>As opcións de liña de comandos permítenlle realizar capturas de pantalla rapidamente. Tamén lle permiten configurar a tecla Imprimir pantalla que está na parte superior dereita da maior parte dos teclados de xeito que realice capturas de pantalla. Para facer isto, configure as asociacións de teclas do seu ambiente de escritorio de forma que inicie xfce4-screenshooter con unha ou varias das seguintes opcións cando se prema a tecla Impr pant.</para>

      <sect3 id="options">
        <title>As opcións de liña de comandos</title>

        <sect4 id="w-option">
          <title>A opción -w</title>

          <para>A opción <emphasis>-w</emphasis> permítelle realizar unha captura de pantalla da fiestra activa.</para>
        </sect4>

        <sect4 id="f-option">
          <title>A opción -f</title>

          <para>A opción <emphasis>-f</emphasis> permítelle realizar unha captura de pantalla de toda a pantalla.</para>
        </sect4>

        <sect4 id="r-option">
          <title>A opción -r</title>

          <para>A opción <emphasis>-r</emphasis> permítelle seleccionar a zona que se vai capturar premendo nun punto da pantalla e sen soltar o botón do rato, arrastrando o punteiro ata a esquina oposta da zona, e soltando o botón do rato.</para>
        </sect4>

        <sect4 id="d-option">
          <title>A opción -d</title>

          <para>A opción <emphasis>-d</emphasis> seguida por un número enteiro positivo permítelle definir o tempo de espera antes de realizar a captura de pantalla cando se proporciona a opción <emphasis>-w</emphasis>, a opción <emphasis>-f</emphasis> ou a opción <emphasis>-r</emphasis>.</para>
        </sect4>

        <sect4 id="s-option">
          <title>A opción -s</title>

          <para>A opción <emphasis>-s</emphasis> seguida pola ruta dun cartafol existente permítelle definir onde se gardan as capturas de pantalla. Esta opción só ten efecto se proporciona a opción <emphasis>-w</emphasis>, a opción <emphasis>-f</emphasis> ou a opción <emphasis>-r</emphasis>.</para>
        </sect4>

        <sect4 id="o-option">
          <title>A opción -o</title>

          <para>Se se proporciona a opción <emphasis>-o</emphasis>, seguida por un nome de aplicativo, a captura de pantalla gardarase no directorio temporal do sistema e abrirase co aplicativo cuxo nome se indicou despois da opción <emphasis>-o</emphasis>. Esta opción só ten efecto se se proporciona a opción  a opción <emphasis>-w</emphasis>, <emphasis>-f</emphasis> ou a opción <emphasis>-r</emphasis>.</para>
        </sect4>

        <sect4 id="u-option">
          <title>A opción -u</title>

          <para>Se se proporciona a opción <emphasis>-u</emphasis> hase gardar a captura de pantalla en ZimageZ. Consulte enriba para obter máis detalles. Esta opción só ten efecto se se proporcionan a opción <emphasis>-w</emphasis>, a opción <emphasis>-f</emphasis> ou a opción <emphasis>-r</emphasis>.</para>
        </sect4>
      </sect3>
    </sect2>
  </sect1>

  <sect1 id="panel-plugin">
    <title>Uso do engadido do panel de Xfce</title>

    <sect2 id="add">
      <title>Engadir o engadido</title>

      <para>Para engadir o engadido ao panel, prema co botón dereito e seleccione  <emphasis>"Engadir novo elemento"</emphasis>. Seleccione o engadido chamado <emphasis>"Captura de pantalla"</emphasis>, e engádao.</para>
    </sect2>

    <sect2 id="set">
      <title>Configurar o engadido</title>

      <para>Pode configurar como se realizan as capturas de pantalla premendo co botón dereito no engadido e seleccionando <emphasis>"Propiedades"</emphasis>. Aparecerá un diálogo de preferencias semellante ao diálogo da aplicación principal. Bótelle unha ollada ao texto anterior para coñecer as diferentes preferencias.</para>
    </sect2>

    <sect2 id="use">
      <title>Uso do engadido</title>

      <para>Para realizar unha captura de pantalla simplemente prema no engadido. Pode usar a roda do rato sobre o botón do engadido para escoller a zona a capturar.</para>
    </sect2>

  </sect1>

</article>
