TETRIS Queen - Versin 1.4.1
Copyright (C) 1999-2002 por David A. Capello
--------------------------------------------

Este programa es software libre. Puede redistribuirlo y/o modificarlo bajo
los trminos de la Licencia Pblica General GNU segn es publicada por la
Free Software Foundation, bien de la versin 2 de dicha Licencia o bien
(segn su eleccin) de cualquier versin posterior.

Este programa es distribuido con la esperanza de que sea til, pero SIN
GARANTIA ALGUNA, incluso sin la garanta implcita de COMERCIALIZACION o
IDONEIDAD PARA UN PROPOSITO PARTICULAR. Vase la Licencia Pblica General
de GNU para ms detalles.

Debera haber recibido una copia de la Licencia Pblica General junto con
este programa. Si no ha sido as, escriba a la Free Software Foundation,
Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA


1. NDICE
---------

   1. ndice
   2. Introduccin
   3. Requerimientos
   4. Configuracin
   5. Controles
   6. Mens
   7. Jugando
   8. Programando
   9. Faq
  10. Crditos


2. INTRODUCCIN
---------------

Soy David A. Capello y le presento uno de los tantos clones del TETRIS
original de Arcade creado por el TEAM TETRIS en el ao 1988. El juego no
es una rplica idntica del viejo TETRIS pero s tiene el mismo concepto
creado por Alexey Pajitnov por aquellos viejos tiempos.

Para ponerle un poco ms de emocin a esto, inclu un nuevo modo de juego
exclusivo de TETRIS Queen: "el destructor" ( "destroyer"). Y dems est
decir, que el "Queen" del ttulo se debe nada ms y nada menos a que el
juego es un total tributo a la famosa banda inglesa de msica: Queen.

Para ms informacin y actualizaciones del juego, puede visitar el sitio
oficial de TETRIS Queen en:

  http://qtetris.sourceforge.net

Adis y espero sus comentarios.


3. REQUERIMIENTOS
-----------------

Estos son los requerimientos mnimos que necesita TETRIS Queen:

  - 486 DX (podra que funcione en una 386);
  - 4 MB de RAM (mejor seran 8 megas, y con 16 ests hecho);
  - Tarjeta VGA;
  - DOS ( UNIX);
  - Teclado;

Aqu tiene los requerimientos recomendados:

  - Pentium 166 Mhz o superior;
  - 32 MB de RAM;
  - Tarjeta VGA;
  - Sound Blaster;
  - Windows 95/98 ( GNU/Linux);
  - Teclado y dos joysticks;


4. CONFIGURACIN
----------------

Toda la configuracin del juego se encuentra en el archivo qtetris.cfg,
usualmente no debera tocar nada aqu ms que la seccin [tetris] donde
se encuentra la configuracin especfica del juego y no la del sistema.

Por otro lado, para otras configuraciones "rpidas", puede utilizar la
lnea de comandos, donde podr iniciar el juego con diferentes opciones:

  qtetris [OPCIONES]

Las opciones disponibles son:

  -r, --resolution ANCHO ALTO     usar una resolucin especial (en 8 bpp)
  -i, --nointro                   no mostrar la introduccin
  -s, --nosound                   no instalar el sonido
  -j, --nojoy                     no instalar el joystick
  -m, --merge ARCHIVO_HOF         adjuntar otro "saln de la fama" al actual
  -h, --help                      visualizar la ayuda del programa (en ingls)
      --version                   mostrar informacin sobre la versin

Por ejemplo, si desea iniciar sin instalar el sonido (ya que est
escuchando sus MP3s favoritos con otro programa), y no quiere la
introduccin, puede iniciar el juego de la siguiente manera:

  qtetris -is


5. CONTROLES
------------

Las teclas generales en el juego son:

  ESC       sale del juego, vuelve en los mens, y realiza cualquier cosa
            para cancelar algo;
  CTRL+Q    aborta el juego y vuelve al sistema operativo;
  F11       pone pausa;
  F12       captura la pantalla guardndola como un archivo BMP;

Las teclas para algunas funciones extras cuando se est jugando:

  F1        baja el volumen del sonido;
  F2        sube el volumen del sonido;
  F3        baja el volumen de la msica;
  F4        sube el volumen de la msica;
  F5        salta a la msica anterior;
  F6        salta a la prxima msica;
  F7        cambia la msica por una al azar;

Las teclas POR DEFECTO de cada jugador son:

  PLAYER1:       PLAYER2:
  Izquierda      A            mueve la pieza hacia la izquierda;
  Derecha        D            mueve la pieza hacia la derecha;
  Abajo          S            baja la pieza rpidamente;
  Supr/Delete    1            rota la pieza hacia la izquierda;
  Fin/End        2            rota la pieza hacia la derecha;

Las teclas de cada jugador, pueden ser reconfiguradas desde el men
OPTIONS/CONTROLS/PLAYER X. Por ejemplo, si desea mover la pieza hacia
abajo del jugador 1 con el botn nmero 1 del primer joystick conectado
a la computadora:

  - entre en "OPTIONS/CONTROLS/PLAYER 1";
  - seleccione la opcin "DOWN: ...", y presione ENTER;
  - luego, presione la palanca (stick direccional) del joystick 1 hacia
    abajo;
  - y listo, ahora, si quiere volver a los valores anteriores de todas las
    teclas, solamente debe seleccionar la opcin "RESTORE" que se encuentra
    en este mismo men;

NOTA IMPORTANTE AL INGRESAR UN NUEVO RECORD: cuando hay que ingresar una
nueva puntuacin, le aparecern tres letras, usando las teclas para mover
la pieza hacia los costados, puede ir cambiando entre la 1era, 2da y 3er
letra, utilizando los botones para rotar, puede cambiar la letra actual,
y pulsando hacia abajo acepta. Tenga mucho cuidado al hacer esta
operacin, ya que podra colocar iniciales no deseadas.


6. MENS
--------

  MAIN (men principal):
  |
  +- 1 PLAYER:       comienza un juego con un jugador (antes deber elegir
  |                  el modo de juego);
  |
  +- 2 PLAYERS:      comienza un juego con dos jugadores;
  |
  +- HALL OF FAME:   muestra las mejores puntuaciones;
  |
  +- OPTIONS (opciones):
  |  |
  |  +- SOUND:       modifica el volumen del sonido;
  |  |
  |  +- MUSIC:       modifica el volumen de la msica;
  |  |
  |  +- SOUND TEST (prueba de sonido):
  |  |  |
  |  |  +- LEFT:     reproduce un sonido que se escucha desde la izquierda;
  |  |  |
  |  |  +- CENTRE:   reproduce un sonido que se escucha desde el centro;
  |  |  |
  |  |  +- RIGHT:    reproduce un sonido que se escucha desde la derecha;
  |  |  |
  |  |  `- FLIP PAN: invierte la orientacin del sonido (si los sonidos no
  |  |               salen correctamente por los lados que se indican,
  |  |               utilice esta opcin y vuelva a probar);
  |  |
  |  +- CONTROLS (controles):
  |  |  |
  |  |  +- PLAYER 1: muestra la configuracin de los botones del 1er jugador;
  |  |  |
  |  |  +- PLAYER 2: muestra la configuracin de los botones del 2do jugador;
  |  |  |
  |  |  `- CALIBRATE
  |  |     JOYSTICK: muestra una pantalla donde se pueden calibrar los dos
  |  |               joysticks;
  |  |
  |  `- RESET HIGH
  |     SCORES:      borra las puntuaciones, restaurndolas por los valores
  |                  por defecto (antes deber elegir la tabla de records
  |                  especfica del modo de juego que quiera borrar);
  |
  +- CREDITS:        muestra los crditos del juegos;
  |
  `- EXIT:           sale del juego y vuelve al sistema operativo;


7. JUGANDO
----------

Los diferentes modos de juego de TETRIS Queen son:

1 PLAYER (un jugador):

  CLASSIC (clsico):

    El clsico modo de juego de todo TETRIS. El principal objetivo es ir
    haciendo lneas con las piezas que se le van dando, si se hacen dos,
    tres o hasta cuatro lneas al mismo tiempo nos dar ms puntaje. Aqu
    tiene la lista de puntajes:

      SINGLE:  1 lnea   10 puntos
      DOUBLE:  2 lneas  50 puntos
      TRIPLE:  3 lneas  200 puntos
      TETRIS:  4 lneas  500 puntos

  DESTROYER (destructor):

    Igual que el clsico, solamente que las piezas ahora tendrn una
    bomba, ninguna, o estarn llenas de bombas. Al hacer una lnea, se
    activarn todas las bombas que se encuentren en la misma, explotando y
    tirando, fuera del panel, los bloques que estn pegados a la misma. Si
    la onda expansiva llega a tocar otra bomba, esta tambin explotar,
    pudiendo as generar "reacciones en cadena".

    Pero eso no es todo, si llegamos a juntar 4 bombas, podemos generar
    una Mega-Bomba, la cual tendr una onda expansiva mucho ms grande.

    Romper bombas, tambin nos dar puntaje, siempre y cuando la bomba se
    encuentre en la lnea que rompimos, en ningn caso se le adicionar
    puntaje extra por las bombas que exploten por ondas expansivas.

    Los puntajes son:

      BOMB:       10 puntos
      MEGA-BOMB:  50 puntos

    Y por ltimo, para hacer ms emocionante el juego, cada 10 segundos,
    se le agregar una lnea "mala", por lo que se deber apurar en hacer
    las cosas.

2 PLAYERS (dos jugadores):

  CLASSIC (clsico):
  DESTROYER (destructor):

    Igual que los modos de un jugador, solamente que las lneas que
    hacemos se van acumulando, y cada 10 segundos, por cada lnea que
    hicimos, se le pasar una lnea "mala" al otro jugador. Igualmente, si
    el otro jugador va haciendo lneas, va contrarrestando el efecto,
    hasta tal punto que puede hacer ms lneas que nosotros en el perodo
    de 10 segundos, lo que nos dara como resultado que a nosotros nos
    aumenten las lneas "malas".


8. PROGRAMANDO
--------------

Para conseguir el cdigo fuente de TETRIS Queen y comenzar a modificar cosas,
puede hacerlo bajndose el paquete "qtetris*-src.zip" o directamente desde el
repositorio CVS (mire la seccin FAQ para ms informacin sobre este tema),
cualquier sea el modo que utilice, junto a esto necesitar el paquete
"qtetris*-dat.zip" que contiene los fuentes de los datos (.BMP, .PCX, .WAV,
.MID, etc.) para poder crear el fichero de datos y su archivo de cabecera
correspondiente.

Para compilar satisfactoriamente el juego, deber tener la librera Allegro,
y si tiene Allegro, se supone que tiene una mnima idea sobre cmo
compilarlo. Ahora, el proceso para TETRIS Queen es exactamente el mismo (o
bastante parecido). Vaya al directorio `qtetris/src', y ejecute uno de los
dos archivos fix.sh o fix.bat (dependiendo de su sistema operativo). Luego,
ejecute `make depend' y finalmente `make' desde la lnea de comandos. Si
todo sale bien, tendr el juego hecho y listo para ejecutar, y si no, me
deber avisar que algo anda mal, ya que algunas versiones ni fueron probadas
(la de Watcom por ej.).

Por otro lado, si es la primera vez que compila el juego (o modifica los
datos fuentes), deber reconstruir el archivo de datos ejecutando
`makedata.bat' (en plataformas basadas en DOS) o el archivo `makedata.sh'
(en plataformas basadas en Unix).

Aqu tiene un ejemplo de cmo sera compilar el juego en DOS con DJGPP:

  >fix.bat djgpp
  >makedata.bat
  >make depend
  >make

Tambin puede utilizar opciones como `make DEBUGMODE=1' para poder depurar
el cdigo de TETRIS Queen, o como `make STATICLINK=1' para que en algunas
versiones (como en Windows y Unix) se utilicen las libreras estticas de
Allegro antes que las dinmicas (como ficheros .DLL o .os).


9. FAQ
------

P: Qu hay de nuevo en esta versin?
R: Un poco ms de documentacin y varias mejoras internas para poder
   reconstruir el programa en otras plataformas (DOS, Windows, Unix,
   GNU/Linux, QNX). Y la nueva opcin `-r' para poder ejecutar el juego
   en diferentes resoluciones (o tamaos de ventanas), y tambin `-m'
   para mezclar records de tus amigos con los tuyos.

P: Estuviste 3 aos para un simple TETRIS?
R: En realidad habr sido 1 y sin ganas :-) La razn principal era que
   cambiaba de idea cada da (cosa que no se debe hacer si se realiza un
   buen diseo previo :-), y no me daba ganas de programar algo que no tiene
   mucho futuro (con un simple TETRIS nadie se sorprende no?), pero ahora
   slo hago versiones de mantenimiento (si Allegro cambia, TETRIS tambin),
   y por eso se van agregando aos (2001 por ejemplo). De todos modos, no se
   por qu le interesa tanto cunto demor, al fin y al cabo, el juego ya
   est hecho.

P: Las msicas se escuchan con muy baja calidad Cmo puedo mejorar esto?
R: La nica forma, por ahora, es bajarse unos WAVETABLES para que los
   "pobres" sonidos MIDI sean reemplazados por los "poderosos" samples que
   traen estos ficheros (los wavetables). Puede encontrar varios enlaces
   desde la misma pgina de Allegro:

     http://alleg.sourceforge.net/digmid.es.html

P: Dnde consigo la utilidad CVS?
R: La versin para Windows de CVS (Concurrent Versions System) se encuentra
   en:

     ftp://ftp.cvshome.org/pub/cvs-1.11/windows/cvs1-11.zip

   Para otras versiones de este programa puede dirigirse a:

     http://www.cvshome.org

P: Cmo consigo el cdigo fuente desde el repositorio CVS?
R: Una vez que tenga la utilidad cvs, debe seguir estos pasos:

   1) Debemos ingresar al repositorio de forma annima mediante:

      cvs -d :pserver:anonymous@cvs.qtetris.sourceforge.net:/cvsroot/qtetris login

   2) Realizamos el primer checkout, lo que significa que sacaremos una
      copia "fresca" de TETRIS Queen:

      cvs -z3 -d :pserver:anonymous@cvs.qtetris.sourceforge.net:/cvsroot/qtetris checkout qtetris

   3) Una vez esto, cada vez que quiera actualizar la copia local con la del
      repositorio, slo deber ejecutar en el directorio `qtetris/':

      cvs update

   IMPORTATE: cuando obtenga la versin CVS, no borre los directorios CVS ni
   el contenido dentro de ellos, es para uso interno de este programa.

P: Cuando quiero compilar el juego aparece algo como esto:
   make.exe: *** No rule to make target `data.h', needed by `obj/block.o'.  Stop.
   Qu hago?
R: Esto se debe a que todava no ha reconstruido el archivo de datos, para
   hacerlo, ejecute makedata.bat o makedata.sh, espere un rato e intntelo
   nuevamente.

P: Tengo problemas y no hay mucha documentacin :-(
   Dnde encuentro ms ayuda?
R: Puede enviarme un email a mi direccin personal:

     dacap@users.sourceforge.net

   Si encuentra un bug, error de documentacin o algo extrao o confuso, no
   dude en ponerse en contacto y avisarme al respecto.


10. CRDITOS
------------

Mire `autores.txt' para ver quien particip directamente en el proyecto y
`gracias.txt' para ver los agradecimientos a las personas que sin su ayuda
sera imposible la existencia de TETRIS Queen hoy en da.
