<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY kblackbox "<application>kblackbox</application>">
]>
<book lang="pt">
<bookinfo>
<title>Manual do &kblackbox;</title>
<authorgroup>
<author>
<surname></surname>
</author>
</authorgroup>
<date>10/02/1998</date>
<releaseinfo>?.??.??</releaseinfo>
<keywordset>
<keyword>KBlackBox</keyword>
<keyword>kde</keyword>
<keyword>blackbox</keyword>
<keyword>jogo</keyword>
<keyword>K Desktop environment</keyword>
</keywordset>
<abstract>
<para>
Este documento descreve o jogo &kblackbox;.
</para>
<para>
&kblackbox; é um excelente jogo lógico, inspirado pelo blackbox do emacs.
</para>
</abstract>
</bookinfo>

<chapter id="o-que-e-o-kblackbox">
<title>O que é o &kblackbox;?</title>
<para>
&kblackbox; é um excelente jogo lógico, inpirado pelo blackbox do emacs.
A maior parte deste ficheiro de ajuda é baseado na ajuda original do emacs.
</para>
<para>
&kblackbox é um jogo de escondidas jogado numa grelha de caixotes. O teu
oponenete (gerador de números aleatórios, neste caso) escondeu várias bolas
nesta caixa. Disparando raios para dentro da caixa e observando onde é que eles
voltam a aparecer é possível deduzir as posições das bolas escondidas.
Quanto menos raios utilizares para encontrar as bolas, mais baixa será a tua
pontuação.
</para>
</chapter>

<chapter id="interface">
<title>A interface</title>

<para><itemizedlist>
<listitem>
<para><emphasis remap="bf">Menús</emphasis>
<itemizedlist>

<listitem><para><emphasis remap="bf">Ficheiro</emphasis>
<itemizedlist>
<listitem><para>
<emphasis remap="bf">Sair</emphasis> -
É um pouco difícil de explicar...
</para></listitem>
</itemizedlist>
</para></listitem>

<listitem><para><emphasis remap="bf">Jogo</emphasis>
<itemizedlist>
<listitem><para>
<emphasis remap="bf">Novo</emphasis> - 
Começa um novo jogo (e abandona o jogo actual). 
</para></listitem>
<listitem><para>
<emphasis remap="bf">Desistir</emphasis> - 
Mostra a posição das bolas.
</para></listitem>
<listitem><para>
<emphasis remap="bf">Concluído</emphasis> - 
Verifica se todas as bolas foram colocadas; se sim, termina o jogo actual, 
calcula a pontuação e indica as verdadeiras posições das bolas. O botão do
meio do rato tem a mesma função.
</para></listitem>
<listitem><para>
<emphasis remap="bf">Mudar tamanho</emphasis> -
Muda o tamanho da janela principal, de modo a que o seu tamanho seja o
correcto em relação ao conteúdo. Útil, se mudar acidentalmente o tamanho da
janela...
</para></listitem>
</itemizedlist>
</para></listitem>

<listitem><para><emphasis remap="bf">Opções</emphasis>
<itemizedlist>
<listitem><para>
<emphasis remap="bf">Tamanho</emphasis> - 
Muda o tamanho do campo de jogo (caixa negra).
</para></listitem>
<listitem><para>
<emphasis remap="bf">Bolas</emphasis> - 
Muda o número de bolas colocadas na caixa negra
</para></listitem>
<listitem><para>
<emphasis remap="bf">Guia</emphasis> -
Liga/desliga o modo de guia (ou seja, podes ver onde as bolas estão).
</para></listitem>
</itemizedlist>
</para></listitem>

<listitem>
<para><emphasis remap="bf">Ajuda</emphasis>
<itemizedlist>
<listitem><para>
<emphasis remap="bf">Conteúdo</emphasis> -
Mostra esta ajuda.
</para></listitem>
<listitem>
<para><emphasis remap="bf">Acerca</emphasis> - 
Mostra informações sobre o &kblackbox;.
</para></listitem>
</itemizedlist>
</para>
</listitem>
</itemizedlist>
</para>
</listitem>
<listitem><para>
<emphasis remap="bf">Barra de ferramentas:</emphasis>
A barra de ferramentas disponibiliza de forma rápida as funções mais utilizadas
dos menús, na seguinte ordem:
<itemizedlist>
<listitem>
<para><emphasis remap="bf">Sair</emphasis></para>
</listitem>
<listitem>
<para><emphasis remap="bf">Novo</emphasis></para>
</listitem>
<listitem>
<para><emphasis remap="bf">Desistir</emphasis></para>
</listitem>
<listitem>
<para><emphasis remap="bf">Concluído</emphasis></para>
</listitem>
</itemizedlist>
</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Barra de estado:</emphasis>
Mostra informações úteis.
</para>
</listitem>
</itemizedlist>
</para>
</chapter>

<chapter id="descricao-do-jogo">
<title>Descrição do jogo</title>

<para>
Na primeira parte desta secção vamos descrver o tabuleiro de jogo.
A segundo parte descreve a interacção entre o utilizador e o tabuleiro,
e finalmente na terceira parte são explicadas as regras do jogo.

</para>
<sect1 id="descricao-do-tabuleiro-de-jogo">
<title>Descripção do tabuleiro de jogo</title>

<para>
O tabuleiro de jogo é formado pelos seguintes tipos de casos:
</para>

<para><itemizedlist>
<listitem><para>
<emphasis remap="bf">cinzento</emphasis> -
A caixa preta. É aqui que marcas as posições onde achas que as bolas estão.
</para></listitem>
<listitem><para>
<emphasis remap="bf">verde</emphasis> - 
Lasers, que disparam raios de luz quando ligados.
</para></listitem>
<listitem><para>
<emphasis remap="bf">branco</emphasis> - 
nada de interesse - o bordo do tabuleiro.
</para></listitem>
<listitem><para>
<emphasis remap="bf">azul escuro</emphasis> -
"Aqui deve estar uma!", pensas tu.
</para>
</listitem>
<listitem><para>
<emphasis remap="bf">azul claro</emphasis> -
As verdadeiras posições das bolas.
</para></listitem>
<listitem><para>
<emphasis remap="bf">vermelho</emphasis> - Wrong positions of balls are indicated by this type. </para>
</listitem>
<listitem>
<para><emphasis remap="bf">&quot;brown&quot;</emphasis> - Marking colour. </para>
</listitem>
</itemizedlist>
</para>
<para><emphasis remap="bf">NOTE:</emphasis> The names of colours are used just for identifying the different types
of the fields in this text. They <emphasis>might not</emphasis> be in any relation with the
actual colour of the fields. Simply said: the black box is in the centre, around are
the lasers and around them is the border. Remap the colours yourself :-). </para>
</sect1>

<sect1 id="user-interaction">
<title>User Interaction</title>
<para>The cursor (a circle) can be moved around the box with the standard cursor
movement keys. Switching of lasers or marking of black boxes is done by the left
mouse button, or by pressing &quot;Return&quot; or &quot;Enter&quot; keys. You can mark the fields,
where a ball can't be, too. Just press the right mouse button. It often helps
you to find an area, where a ball could possibly be. To clear any marks (blue or
brown) press the left mouse button. Brown marks can't overwrite blue marks. This
way you can't erase the blue marks (guessed balls) by accident when playing with
the right mouse button. </para>
<para>When you think the configuration of balls you have placed is correct, press the
middle mouse button. You will be informed whether you are correct or not, and be
given your score. Your score is the number of letters and numbers around the
outside of the box plus five for each incorrectly placed ball. If you placed any
balls incorrectly, they will be indicated with red fields, and their actual
positions indicated with cyan fields.</para>
</sect1>
<sect1 id="game-rules">
<title>Game rules</title>
<para>You have to find balls hidden in the black box. Your means are limited - you can
just fire lasers which are around the box. There are three possible outcomes for
each ray you send into the box:  </para>
<para><itemizedlist>
<listitem>
<para><emphasis remap="bf">Detour</emphasis> - The ray is deflected and emerges somewhere other than where
you sent it in. On the playfield, detours are denoted by matching pairs
of numbers - one where the ray went in, and the other where it came out.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Reflection</emphasis> - The ray is reflected and emerges in the same place it was
sent in. On the playfield, reflections are denoted by the letter `R'.</para>
</listitem>
<listitem>
<para><emphasis remap="bf">Hit</emphasis> The ray strikes a ball directly and is absorbed. It does not
emerge from the box. On the playfield, hits are denoted by the letter `H'.</para>
</listitem>
</itemizedlist>
</para>
<para>
As regras de como as bolas deflectem os raios são simples e mais fáceis
de explicar por exemplo.
</para>
<para>
As a ray approaches a ball it is deflected ninety degrees. Rays can be deflected
multiple times. In the diagrams below, the dashes represent empty box locations
and the letter `O' represents a ball. The entrance and exit points of each ray
are marked with numbers as described under &quot;Detour&quot; above. Note that the
entrance and exit points are always interchangeable. &quot;*&quot; denotes the
path taken by the ray.</para>

<para>
Vê a posição relativa da bola e a defleção de noventa graus que ela provoca.
<programlisting>
           1                                            
         - * - - - - - -         - - - - - - - -         - - - - - - - -       
         - * - - - - - -         - - - - - - - -         - - - - - - - -       
       1 * * - - - - - -         - - - - - - - -         - O - - - - O -       
         - - O - - - - -         - - O - - - - -         - - * * * * - -
         - - - - - - - -         - - - * * * * * 2     3 * * * - - * - -
         - - - - - - - -         - - - * - - - -         - - - O - * - -      
         - - - - - - - -         - - - * - - - -         - - - - * * - -       
         - - - - - - - -         - - - * - - - -         - - - - * - O -       
                                       2                         3</programlisting>
</para>

<para>
Como foi mencionado antes, uma refleção ocorre quando uma raio emerge no
mesmo ponto donde foi enviado. Isto pode acontecer de várias maneiras:
</para>

<para><programlisting>         - - - - - - - -         - - - - - - - -          - - - - - - - -
         - - - - O - - -         - - O - O - - -          - - - - - - - -
       R * * * * - - - -         - - - * - - - -          O - - - - - - -
         - - - - O - - -         - - - * - - - -        R - - - - - - - -
         - - - - - - - -         - - - * - - - -          - - - - - - - -
         - - - - - - - -         - - - * - - - -          - - - - - - - -
         - - - - - - - -       R * * * * - - - -          - - - - - - - -
         - - - - - - - -         - - - - O - - -          - - - - - - - -</programlisting>

No primeiro exemplo, o raio é deflectido para baixo pela bola de cima,
depois para a esquerda pela bola de baixo, e finalmente volta pela mesmo
caminho donde veio. O segundo exemplo é semelhante.
O terceiro exemplo é um pouco estranho, mas examinando a situação
conclui-se que o raio nunca chega a entrar na caixa; alternativamente,
pode-se pensar que o raio é reflectido para baixo, e sai imediatamente da
caixa.
</para>

<para>Uma colisão ocorre quando um raio bate directamente numa bola:
<programlisting>         - - - - - - - -         - - - - - - - -          - - - - - - - -
         - - - - - - - -         - - - - - - - -          - - - - O - - -
         - - - - - - - -         - - - - O - - -        H * * * * - - - -
         - - - - - - - -       H * * * * O - - -          - - - * - - - -
         - - - - - - - -         - - - - O - - -          - - - O - - - -
       H * * * O - - - -         - - - - - - - -          - - - - - - - -
         - - - - - - - -         - - - - - - - -          - - - - - - - -
         - - - - - - - -         - - - - - - - -          - - - - - - - -</programlisting>

Compara o segundo exemplo de colisão com o primeiro exemplo de reflexão.
</para>
</sect1>
</chapter>

<chapter id="epilogo">
<title>epílogo</title>
<sect1 id="author">
<title>Autor</title>
<para> 
Robert Cimrman <email>cimrman3@students.zcu.cz</email>
</para>

<para>
Tradução da documentação por Pedro Morais <email>morais@kde.org</email>
</para>     

</sect1>
<sect1 id="copyright">
<title>Copyright</title>
<para>KBlackBox está disponível sob a Licença GPL. </para>
</sect1>
</chapter>

</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->

<!-- actualizado para a versão CVS :1.4: -->  


