<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kuickshow;">
  <!ENTITY package "kdegraphics">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Portuguese "INCLUDE"
><!-- change language only here -->
]>

<!-- The language must NOT be changed here. -->
<book lang="&language;">

<bookinfo>
<title
>O Manual do &kuickshow;</title>

<authorgroup>
<author
><firstname
>Carsten</firstname
> <surname
>Pfeiffer</surname
> <affiliation
> <address
><email
>pfeiffer@kde.org</email
></address>
</affiliation>
</author>
</authorgroup>

<othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>jncp@netcabo.pt</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 

<copyright>
<year
>2001</year>
<holder
>Carsten Pfeiffer</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2002-01-09</date>
<releaseinfo
>1.01.00</releaseinfo>

<!-- Abstract about this handbook -->

<abstract>
<para
>O &kuickshow; é um visualizador/navegador de imagens confortável. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdegraphics</keyword>
<keyword
>kuickshow</keyword>
<keyword
>imagem</keyword>
<keyword
>visualizador</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introdução</title>

<para
>O &kuickshow; é um visualizador/navegador de imagens confortável. Ele mostra um selector de ficheiros onde você poderá seleccionar as imagens que são nele apresentadas. </para>

<!-- LW: put a nice screenshot here -->

<para
>São suportados os seguintes formatos de imagens:</para>
<itemizedlist>
<listitem
><para
>jpg</para>
</listitem>
<listitem
><para
>gif</para>
</listitem>
<listitem
><para
>tiff</para>
</listitem>
<listitem
><para
>png</para>
</listitem>
<listitem
><para
>bmp</para>
</listitem>
<listitem
><para
>psd</para>
</listitem>
<listitem
><para
>xmp</para>
</listitem>
<listitem
><para
>xbm</para>
</listitem>
<listitem
><para
>eim</para>
</listitem>
</itemizedlist>

<para
>As imagens poderão ser mostradas na sua própria janela, de forma tão grande como a imagem em si, ou em todo o ecrã.</para>

</chapter>

<chapter id="using-kuickshow">
<title
>Usar o &kuickshow;</title>

<para
>A utilização do &kuickshow; é muito simples. O selector de ficheiros enumera os mesmos, e você poderá então seleccionar alguns deles com um duplo-click, com a tecla <keycap
>Return</keycap
> ou com a opção <guimenuitem
>Ver</guimenuitem
> no menu de contexto do botão <mousebutton
>direito</mousebutton
> do rato.</para>

<screenshot>
<screeninfo
>Aqui está uma imagem do &kuickshow;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot.png" format="PNG"/>
	  </imageobject>
	  <imageobject>
	    <imagedata fileref="screenshot.eps" format="EPS"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Imagem</phrase>
	  </textobject>
	</mediaobject>
</screenshot>


<sect1 id="kuickshow-features">
<title
>Mais funcionalidades do &kuickshow;</title>

<para
>A janela de opções disponibiliza mais possibilidades:</para>

<itemizedlist>
<listitem
><para
>As imagens poder-se-ão encolher para caber no ecrã, se estas forem maiores.</para>
</listitem>
<listitem
><para
>Você pode configurar se as imagens deverão aparecer nas suas próprias janelas, ou se deverão usar sempre a mesma.</para>
</listitem>
<listitem
><para
>Você poderá definir o tempo de espera entre imagens numa apresentação.</para>
</listitem>
<listitem
><para
>Você poderá indicar ao selector de ficheiros quais os tipos de imagem a mostrar.</para>
</listitem>
<listitem
><para
>Você poderá ajustar a relação velocidade/qualidade</para
></listitem>
</itemizedlist>

<para
>Se você estiver à procura de um determinado ficheiro, basta indicar os primeiros caracteres do seu nome no selector. Irá aparecer uma pequena janela de edição no canto inferior direito. Quando for encontrado um ficheiro correspondente, este fica realçado. Você poderá abandonar a janela de edição se carregar em <keycap
>Return</keycap
> ou em &Esc;.</para>

</sect1>
</chapter>

<chapter id="configuration-dialog">
<title
>A Janela de <guilabel
>Configuração do &kuickshow;</guilabel
></title>

<para
>A janela de <guilabel
>Configuração do &kuickshow;</guilabel
> contém 4 páginas. Duas delas, a <link linkend="general-options"
><guilabel
>Geral</guilabel
></link
> e a <link linkend="modifications-options"
><guilabel
>Modificações</guilabel
></link
> e a <link linkend="slideshow-options"
><guilabel
>Apresentação</guilabel
></link
> configuram a operação do &kuickshow;, enquanto que as outras duas, a <guilabel
>Atalhos do Visualizador</guilabel
> e a <guilabel
>Atalhos do Navegador</guilabel
> permitem-lhe personalizar as configurações de teclas para as janelas respectivas.</para>

<sect1 id="general-options">
<title
>Opções <guilabel
>Gerais</guilabel
></title>

<para
>A página <guilabel
>Geral</guilabel
> contém as opções para configurar e afinar o &kuickshow;.</para>

<variablelist>
<title
><guilabel
>Configuração</guilabel
></title>
<varlistentry>
<term
><guilabel
>Modo de ecrã completo</guilabel
></term>
<listitem>
<para
>Se isto estiver seleccionado, as imagens aparecem a ocupar todo o ecrã. Se a imagem não for suficientemente grade, o resto do ecrã é preenchido com a cor de fundo seleccionada em baixo. Por omissão, está desligada a opção.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Pré-carregar a imagem seguinte</guilabel
></term>
<listitem>
<para
>Se esta opção estiver seleccionada, o &kuickshow; irá carregar a próxima imagem da pasta, enquanto você está a ver a actual. Isto diminui o tempo de espera para seleccionar a próxima imagem, e é particularmente útil nas apresentações.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Cor de fundo</guilabel
></term>
<listitem>
<para
>Carregue na barra colorida para seleccionar uma cor de fundo. Esta é usada para preencher o ecrã no modo de ecrã completo, ou a janela, se a tiver redimensionado para um tamanho maior que a imagem.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Mostrar só os ficheiros com a extensão:</guilabel
></term>
<listitem>
<para
>Você pode configurar o &kuickshow; para mostrar apenas alguns dos tipos de ficheiros que ele consegue abrir.</para>
</listitem>
</varlistentry>

</variablelist>

<variablelist>
<title
><guilabel
>Qualidade / Velocidade</guilabel
></title>
<varlistentry>
<term
><guilabel
>"Rendering" rápido</guilabel
></term>
<listitem
><para
>Desenha as coisas rapidamente.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Apresentar em modos HiColor (15/16 bits)</guilabel
></term>
<listitem
><para
><!-- LW: Maybe these should be on an advanced tab -->
<!-- Write an example what this does here -->
</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Apresentar em modos LowColor (&lt;= 8 bits)</guilabel
></term>
<listitem
><para
><!-- And here -->
</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Usar uma paleta de cores própria</guilabel
></term>
<listitem
><para
><!-- and this one -->
</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Rearranjo da paleta rápido</guilabel
></term>
<listitem>
<para
><!-- and this one -->
</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Tamanho máximo da 'cache' (MB):</guilabel
></term>
<listitem>
<para
><!-- and another -->
</para
></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="modifications-options">
<title
>A Página de <guilabel
>Modificações</guilabel
></title>

<para
>Ainda não documentado</para>

</sect1>

<sect1 id="slideshow-options">
<title
>A Página da <guilabel
>Apresentação</guilabel
></title>

<variablelist>

<varlistentry>
<term
><guilabel
>Mudar para o ecrã completo</guilabel
></term>
<listitem>
<para
>Indica se o KuickShow deverá mudar para o modo de ecrã completo, quando iniciar a apresentação no ecrã. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Inicia pela imagem actual:</guilabel
></term>
<listitem>
<para
>Indica se a apresentação deverá começar com a primeira imagem da pasta ou se deverá começar pela imagem que está seleccionada. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Atraso entre as imagens:</guilabel
></term>
<listitem>
<para
>O intervalo de tempo entre as mudanças de imagens quando você criar uma apresentação. Você poderá usar a barra deslizante, indicar um novo valor no campo respectivo ou usar as setas pequenas para aumentar ou diminuir o valor. O valor por omissão é 30, o que corresponde a 3 segundos.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Iterações:</guilabel
></term>
<listitem>
<para
>O número de iterações. Se for igual a 0, ela irá entrar em ciclo até ser interrompida por si. Você poderá usar a barra deslizante, indicar um novo valor no campo respectivo ou usar as setas pequenas para aumentar ou diminuir o valor. O valor por omissão é 1.</para>
</listitem>
</varlistentry>

</variablelist>
</sect1>

</chapter>

<chapter id="commands">
<title
>Referência de Comandos</title>

<sect1 id="keybindings">
<title
>A Janela de Imagens</title>

<para
>Todos os atalhos de teclado são configuráveis a partir da <link linkend="configuration-dialog"
>Janela de Configuração</link
>.</para>

<table>
<title
>Atalhos de Teclado da Janela de Imagens</title>
<tgroup cols="2">
<thead>
<row>
<entry
>Tecla</entry>
<entry
>Acção</entry>
</row>
</thead>
<tbody>
<row>
<entry
><keycap
>Page Down</keycap
></entry>
<entry
>Carrega a próxima imagem</entry>
</row>
<row>
<entry
><keycap
>Page Up</keycap
></entry>
<entry
>Carrega a imagem anterior</entry>
</row>
<row>
<entry
><keycap
>Home</keycap
></entry>
<entry
>Carrega a primeira imagem</entry>
</row>
<row>
<entry
><keycap
>+</keycap
></entry>
<entry
>Amplia a imagem</entry>
</row>
<row>
<entry
><keycap
>-</keycap
></entry>
<entry
>Reduz a imagem</entry>
</row>
<row>
<entry
><keycap
>*</keycap
></entry>
<entry
>Cria um espelho da imagem na horizontal</entry>
</row>
<row>
<entry
><keycap
>/</keycap
></entry>
<entry
>Cria um espelho da imagem na vertical</entry>
</row>
<row>
<entry
><keycap
>7</keycap
></entry>
<entry
>Toda a imagem 270 graus no sentido dos ponteiros do relógio (ou seja, 90 graus no sentido contrário ao dos ponteiros)</entry>
</row>
<row>
<entry
><keycap
>9</keycap
></entry>
<entry
>Roda a imagem 90 graus no sentido dos ponteiros do relógio</entry>
</row>
<row>
<entry
>Teclas de <keycap
>setas</keycap
></entry>
<entry
>Move a imagem (ou, por outra, o visualizador), se esta for maior que o ecrã</entry>
</row>
<row>
<entry
><keycap
>Return</keycap
></entry>
<entry
>Alterna entre o modo de ecrã completo e de janela</entry>
</row>
<row>
<entry
><keycap
>Espaço</keycap
></entry>
<entry
>Comuta (activa ou desactiva) a visibilidade do selector de ficheiros</entry>
</row>
<row>
<entry
>&Esc;</entry>
<entry
>Fecha a janela de imagens. Isto irá fechar o &kuickshow; por completo, se você não tiver uma janela de navegação aberta.</entry>
</row>
<row>
<entry
><keycap
>B</keycap
>/<keycombo action="simul"
>&Shift;<keycap
>B</keycap
></keycombo
></entry>
<entry
>Põe a imagem mais clara/escura</entry>
</row>
<row>
<entry
><keycap
>C</keycap
>/<keycombo action="simul"
>&Shift;<keycap
>C</keycap
></keycombo
></entry>
<entry
>Adiciona/remove contraste da imagem</entry>
</row>
<row>
<entry
><keycap
>G</keycap
>/<keycombo action="simul"
>&Shift;<keycap
>G</keycap
></keycombo
></entry>
<entry
>Aumenta/diminui o factor de <firstterm
>gama</firstterm
></entry>
</row>
<row>
<entry
><keycap
>O</keycap
></entry>
<entry
>Mostra a imagem no tamanho original. Isto só é útil quando você activou o redimensionamento automático.</entry>
</row>
<row>
<entry
><keycap
>Enter</keycap
></entry>
<entry
>Volta a mostrar a imagem com a configuração e tamanho predefinidos.</entry>
</row>
<row>
<entry
><keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
></entry>
<entry
>Abre a janela de <guilabel
>Gravar Como</guilabel
></entry>
</row>
<row>
<entry
><keycap
>Delete</keycap
></entry>
<entry
>Apaga a imagem actual. Ser-lhe-á pedida uma confirmação do pedido efectuado.</entry>
</row>
<row>
<entry
><keycombo action="simul"
>&Shift;<keycap
>Delete</keycap
></keycombo
></entry>
<entry
>Apaga a imagem actual sem pedir nenhuma confirmação</entry>
</row>
<row>
<entry
><keycap
>F1</keycap
></entry>
<entry
>Abre a ajuda 'online' (este ficheiro)</entry>
</row>
<row>
<entry
><keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
></entry>
<entry
>Sai do &kuickshow;</entry>
</row>
</tbody>
</tgroup>
</table>

<table>
<title
>Utilização do Rato na Janela de Imagens</title>
<tgroup cols="2">
<thead>
<row>
<entry
>Botão do rato</entry>
<entry
>Acção</entry>
</row>
</thead>
<tbody>
<row>
<entry
>'Click' do botão <mousebutton
>direito</mousebutton
></entry>
<entry
>Abre o menu de contexto com várias opções</entry>
</row>
<row>
<entry
>Arrasto com o botão <mousebutton
>esquerdo</mousebutton
></entry>
<entry
>Move a imagem, se não couber na janela.</entry>
</row>
<row>
<entry
>Arrasto com <keycombo action="simul"
>&Shift;<mousebutton
>Esquerdo</mousebutton
> </keycombo
></entry>
<entry
>Marca um rectângulo para o qual ampliar.</entry>
</row>
<row>
<entry
>Duplo-click com o botão <mousebutton
>esquerdo</mousebutton
></entry>
<entry
>Fecha a imagem actual</entry>
</row>
</tbody>
</tgroup>
</table>

</sect1>

<sect1 id="browser-window">
<title
>A Janela de Navegação</title>

<table>
<title
>Atalhos de Teclado da Janela de Navegação</title>
<tgroup cols="2">
<thead>
<row>
<entry
>Atalho de teclado</entry>
<entry
>Acção</entry>
</row>
</thead>
<tbody>
<row>
<entry
><keycap
>Return</keycap
></entry>
<entry
>Entra numa pasta, ou abre uma janela de imagem, dependendo do item seleccionado.</entry>
</row>
<row>
<entry
><keycap
>Page Down</keycap
></entry>
<entry
>Avança uma página na lista de ficheiros</entry>
</row>
<row>
<entry
><keycap
>Page Up</keycap
></entry>
<entry
>Anda uma página para trás na lista de ficheiros</entry>
</row>
<row>
<entry
><keycap
>Home</keycap
></entry>
<entry
>Selecciona o primeiro ficheiro ou pasta</entry>
</row>
<row>
<entry
><keycap
>End</keycap
></entry>
<entry
>Selecciona o último ficheiro ou pasta</entry>
</row>
<row>
<entry
><keycap
>Espaço</keycap
></entry>
<entry
>Comuta (activa ou desactiva) a visibilidade do navegador, se estiver aberta alguma janela de imagem</entry>
</row>
<row>
<entry
><keycap
>qualquer carácter alfanumérico</keycap
></entry>
<entry
>Abre o campo de edição que é usado para a <quote
>completação</quote
>. Indique os primeiros caracteres do nome de um ficheiro a procurar para que, se for encontrado algum ficheiro correspondente, este seja seleccionado.</entry>
</row>
<row>
<entry
><keycombo
action="simul"
>&Ctrl;<keycap
>G</keycap
></keycombo
></entry>
<entry
><quote
>Ir para</quote
> &mdash; permite-lhe indicar uma pasta para a qual mudar.</entry>
</row>
<row>
<entry
><keycap
>Delete</keycap
></entry>
<entry
>Apaga o ficheiro actual. Ser-lhe-á pedida a confirmação dessa acção.</entry>
</row>
<row>
<entry
><keycombo
action="simul"
>&Shift;<keycap
>Delete</keycap
></keycombo
></entry>
<entry
>Apaga o ficheiro actual sem pedir nenhuma confirmação.</entry>
</row>
<row>
<entry
><keycap
>F1</keycap
></entry>
<entry
>Abre a ajuda 'online' (este ficheiro)</entry>
</row>
<row>
<entry
><keycombo
action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
></entry>
<entry
>Sai do &kuickshow;</entry>
</row>
</tbody>
</tgroup>
</table>

<table>
<title
>Utilização do Rato na Janela de Navegação</title>
<tgroup cols="2">
<thead>
<row>
<entry
>Utilização do Rato</entry>
<entry
>Acção</entry>
</row>
</thead>
<tbody>
<row>
<entry
>'Click' com o botão <mousebutton
>esquerdo</mousebutton
></entry>
<entry
>Entra numa pasta ou selecciona uma janela de imagem.</entry>
</row>
<row>
<entry
>'Click' do botão <mousebutton
>direito</mousebutton
></entry>
<entry
>Abre um menu de contexto com várias opções.</entry>
</row>
<row>
<entry
>Duplo-click</entry>
<entry
>Abre a janela seleccionada ou entra na pasta seleccionada</entry>
</row>
</tbody>
</tgroup>

</table>

</sect1>
</chapter>

<chapter id="credits">

<!-- Include credits for the programmers, documentation writers, and
contributors here. The license for your software should then be included below
the credits with a reference to the appropriate license file included in the KDE
distribution. -->

<title
>Créditos e Licença</title>

<para
>&kuickshow; </para>
<para
>Programa copyright 1998-2002 Carsten Pfeiffer <email
>pfeiffer@kde.org</email
> </para>

<para
>Documentação copyright 2001 Carsten Pfeiffer <email
>pfeiffer@kde.org</email
> </para>
<para
>Convertido para DocBook &XML; e extendido por Lauri Watts <email
>lauri@kde.org</email
></para>

<para
>Tradução de José Nuno Pires <email
>jncp@netcabo.pt</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Instalação</title>

<sect1 id="getting-kuickshow">
<title
>Como obter o &kuickshow;</title>
&install.intro.documentation; </sect1>

<sect1 id="requirements">
<title
>Requisitos</title>

<para
>A ser escrito</para>
<!--
List any special requirements for your application here. This should include:
.Libraries or other software that is not included in kdesupport,
kdelibs, or kdebase.
.Hardware requirements like amount of RAM, disk space, graphics card
capabilities, screen resolution, special expansion cards, etc.
.Operating systems the app will run on. If your app is designed only for a
specific OS, (you wrote a graphical LILO configurator for example) put this
information here.


<para>
In order to successfully use &kuickshow;, you need &kde; 1.1. Foobar.lib is
required in order to support the advanced &kuickshow; features. &kuickshow; uses
about 5 megs of memory to run, but this may vary depending on your
platform and configuration.
</para>

<para>
All required libraries as well as &kuickshow; itself can be found
on <ulink url="ftp://ftp.kapp.org"
>The &kuickshow; home page</ulink
>.
</para>
-->

<!-- For a list of updates, you may refer to the application web site
or the ChangeLog file, or ... 
<para>
You can find a list of changes at <ulink
url="http://apps.kde.org/kapp"
>http://apps.kde.org/kapp</ulink
>.
</para
>-->
</sect1>

<sect1 id="compilation">
<title
>Compilação e Instalação</title>
&install.compile.documentation; </sect1>

</appendix>

&documentation.index;
</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->

