<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
<!ENTITY palapeli "<application
>Palapeli</application
>">
<!ENTITY kappname "&palapeli;">
<!ENTITY package "kdegames">
<!ENTITY % Portuguese "INCLUDE">
<!ENTITY % addindex "IGNORE">
]>
<book lang="&language;">
  <bookinfo>
    <title
>Capítulo do 'plugin' de divisão em peças Goldberg para o &palapeli;</title>
    <authorgroup>
      <author
><firstname
>Johannes</firstname
> <surname
>L&#xF6;hnert</surname
> <affiliation
> <address
> <email
>loehnert_kde@gmx.de</email>
          </address>
        </affiliation>
      </author>
      <othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>zepires@gmail.com</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 
    </authorgroup>
    <copyright>
      <year
>2009, 2010</year>
      <holder
>Johannes L&#xF6;hnert, Stefan Majewsky</holder>
    </copyright>
    <legalnotice
>&FDLNotice;</legalnotice>
    <date
>2010-06-28</date>
    <releaseinfo
>0.4</releaseinfo>
    <abstract>
      <para
>Este capítulo é para ser incluído na documentação do Palapeli quando o 'plugin' for movido para lá.</para>
    </abstract>
    <keywordset>
      <keyword
>KDE</keyword>
      <keyword
>kdegames</keyword>
      <keyword
>jogo</keyword>
      <keyword
>jogo de 'puzzle'</keyword>
      <keyword
>'puzzle'</keyword>
      <keyword
>palapeli</keyword>
    </keywordset>
  </bookinfo>
  <chapter id="creating">
    <title
>Criar um 'puzzle' novo</title>
    <para
>Podem ser definidas as seguintes opções ao criar um 'puzzle':</para>
    <sect1 id="tesselation-type">
      <title
>Tipo de tesselagem</title>
      <para
>define qual a grelha que é usada para dividir a imagem ou, posto de outra forma, qual a forma que terão as peças do 'puzzle'. Terá as seguintes opções:</para>
      <variablelist>
        <varlistentry>
            <term
><guimenuitem
>Grelha Rectangular</guimenuitem
></term>
            <listitem
><para
>O 'puzzle' normal que todos conhecemos e adoramos.</para
></listitem>
        </varlistentry>
        <varlistentry>
            <term
><guimenuitem
>Cairo pentagonal</guimenuitem
></term>
            <listitem
><para
>Peças de cinco lados com ângulos entre arestas diferentes.</para
></listitem>
        </varlistentry>
        <varlistentry>
            <term
><guimenuitem
>Hexagonal</guimenuitem
></term>
            <listitem
><para
>Peças de seis lados.</para
></listitem>
        </varlistentry>
        <varlistentry>
            <term
><guimenuitem
>Rotrex (rombi-trihexagonal)</guimenuitem
></term>
            <listitem
><para
>Hexágonos rodeados por rectângulos e triângulos. Parece-se com vários círculos em intersecção.</para
></listitem>
        </varlistentry>
        <varlistentry>
            <term
><guimenuitem
>Irregular</guimenuitem
></term>
            <listitem
><para
>Peças aleatórias. O programa <application
>qvoronoi</application
> (que faz parte do <application
>qhull</application
>) é necessário para gerar 'puzzles' irregulares.</para
></listitem>
        </varlistentry>
      </variablelist>
      <para
>A tesselagem Cairo é mais difícil de gerar 'puzzles', dado que as peças se encaixam em conjunto de uma forma pouco familiar. A tesselagem Rotrex é mais simples que a grelha rectangular e parece mais bonita ao ser posta em conjunto.</para>
    </sect1>
    <sect1 id="piece-count">
      <title
>Número aprox. de peças</title>
      <para
>é usado para calcular o tamanho da grelha. Na maioria dos casos, o número actual será ligeiramente maior ou menor do que o definido por si.</para>
    </sect1>
    <sect1 id="flipped-edges">
      <title
>Percentagem de lados invertidos</title>
      <para
>define a probabilidade de cada aresta (encaixe) ser "invertida". Um encaixe é "invertido" se apontar na direcção oposta à que teria numa grelha perfeitamente regular. Na grelha rectangular, isto resulta em peças com 3 ou 4 encaixes que apontam para dentro ou para fora, respectivamente.</para>
      <itemizedlist>
        <listitem
><para
>0% (barra à esquerda): não são invertidas nenhumas arestas, grelha perfeitamente regular</para
></listitem>
        <listitem
><para
>50% (barra ao meio): Todas as arestas são aleatórias.</para
></listitem>
        <listitem
><para
>100% (barra à direita): Grelha completamente regular de novo, mas agora com uma regra "alternada".</para
></listitem>
      </itemizedlist>
      <para
>Uma regra "alternada" <emphasis
>não</emphasis
> significa simplesmente uma inversão em média de todos os encaixes. Na grelha rectangular alternada, cada peça tem 4 encaixes para dentro ou para fora. Para as outras tesselagens, basta experimentar.</para>
      <para
>Esta opção não faz efeito ao usar a tesselagem irregular.</para>
    </sect1>
    <sect1 id="edge-curviness">
      <title
>Curvatura das arestas</title>
      <para
>define quão curvas são as arestas, &ie;, com que intensidade os contornos se definem para dentro ou para fora.</para>
      <itemizedlist>
        <listitem
><para
>0%: as arestas são linhas rectas (excepto nos encaixes)</para
></listitem>
        <listitem
><para
>100%: as arestas são bastante curvadas.</para
></listitem>
      </itemizedlist>
    </sect1>
    <sect1 id="plug-size">
      <title
>Tamanho do encaixe</title>
      <para
>define o tamanho da parte de "encaixe" de cada aresta. A definição por omissão (intermédia) é escolhida de modo a parecer-se com um 'puzzle' real.</para>
      <itemizedlist>
        <listitem
><para
>0%: os encaixes têm metade do tamanho predefinido.</para
></listitem>
        <listitem
><para
>100%: os encaixes têm 1,5x o tamanho predefinido, o que já parece algo extremamente grande.</para
></listitem>
      </itemizedlist>
      <para
>O programa tenta ao máximo evitar colisões entre os encaixes. As arestas em colisão são formatadas de novo várias vezes e encolhidas em pequenos passos. Contudo, existem ainda alguns casos em que não é possível chegar a uma solução, especialmente no caso de encaixes grandes.</para>
    </sect1>
    <sect1 id="diversity-curviness">
      <title
>Diversidade das curvas</title>
      <para
>define como é que a "curvatura" (ver acima) varia entre extremos.</para>
      <itemizedlist>
        <listitem
><para
>0%: Os encaixes parecem-se todos iguais.</para
></listitem>
        <listitem
><para
>100%: Existem contornos bastante curvados e rectos.</para
></listitem>
      </itemizedlist>
    </sect1>
    <sect1 id="diversity-position">
      <title
>Diversidade da posição do encaixe</title>
      <para
>define como é que a posição do encaixe varia:</para>
      <itemizedlist>
        <listitem
><para
>0%: Os encaixes estão todos no meio do seu contorno.</para
></listitem>
        <listitem
><para
>100%: Os encaixes poderão estar em qualquer lado, entre os extremos dos contornos.</para
></listitem>
      </itemizedlist>
    </sect1>
    <sect1 id="diversity-plugs">
      <title
>Diversidade dos encaixes</title>
      <para
>define quão individualizados são os encaixes.</para>
      <itemizedlist>
        <listitem
><para
>0%: Os encaixes parecem-se todos iguais.</para
></listitem>
        <listitem
><para
>Cada encaixe será uma peça de arte desenhada especialmente para si.</para
></listitem>
      </itemizedlist>
    </sect1>
    <sect1 id="diversity-size">
      <title
>Irr.: Diversidade do tamanho das peças</title>
      <para
>aplica-se só na tesselagem irregular, e define como é que o tamanho das peças varia.</para>
      <itemizedlist>
        <listitem
><para
>100%: peças muito grandes e muito pequenas.</para
></listitem>
        <listitem
><para
>50%: (por omissão) as peças são aproximadamente do mesmo tamanho.</para
></listitem>
        <listitem
><para
>0%: as peças são aproximadamente do mesmo tamanho, com algumas estruturas em cristais.</para
></listitem>
      </itemizedlist>
    </sect1>
    <sect1 id="piece-outlines">
      <title
>Contornos das peças</title>
      <para
>Desenha um contorno fino a preto em torno de cada peça, de modo que as peças individuais fiquem distintas no 'puzzle' montado.</para>
    </sect1>
    <sect1 id="dump-grid">
      <title
>Apresentar a imagem da grelha</title>
      <para
>Grava uma imagem da grelha (contornos pretos num fundo branco). É gravada no ficheiro <filename
>~/goldber-slicer-dump.png</filename
>. Se já existir uma apresentação anterior, será substituída.</para>
    </sect1>
  </chapter>

<chapter id="credits">
<title
>Créditos e Licença</title>
<para
>Documentação com 'Copyright' &copy; 2010 de Johannes Löhnert <email
>loehnert_kde@gmx.de</email
> </para>
<para
>Tradução de José Nuno Pires <email
>zepires@gmail.com</email
></para
> 
&underFDL; </chapter>
&documentation.index;

</book>
