
  TETRIS Queen - Versin 1.3
  Copyright (C) 1999, 2000, 2001 por David A. Capello 
  --------------------------------------------------------------------------

  Este programa es software libre; usted puede redistribuirlo y/o
  modificarlo bajo los trminos de la Licencia Pblica General GNU
  (o GNU General Public License) publicada por la Fundacin de Software
  Libre (Free Software Foundation); cualquier versin 2 de la Licencia,
  o (a su eleccin) alguna versin ms antigua.

  Este programa es distribuido con la esperanza de que sea til,
  pero SIN GARANTA ALGUNA; sin incluso la garanta implcita
  de COMERCIALIZACIN o IDONEIDAD PARA UN PROPOSITO PARTICULAR.
  Vea la GNU General Public License para ms detalles.

  Usted debe de haber recibido una copia de la GNU General Public
  License junto con este programa; si no, 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;
    - MS-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:

    -i, --nointro   no muestra la introduccin
    -s, --nosound   no instala los sonidos
    -j, --nojoy     no instala el joystick
    -?, --help      muestra la ayuda del programa (en ingls)

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

    qtetris -s


  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 "RESET" 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
  --------------------------------------------------------------------------

  Si realmente est interesado en programar TETRIS Queen, con mucha libertad
  le dejo entrar en el cdigo fuente y hacer las modificaciones que se le
  plasca (si puede entender algo :-).

  Antes que nada, hay dos formas de obtener el cdigo fuente, mediante el
  paquete "qtetris*-src.tar.gz" o directamente desde el repositorio CVS.
  De todos modos, si desea compilar el cdigo, necesitar SI O SI los
  fuentes de los datos, es decir, el paquete "qtetris*-dat.tar.gz", esto se
  debe principalmente a que al recompilar el juego, el fichero "qtetris.dat"
  se genera automticamente en este proceso.

  Para compilar satisfactoriamente el juego, deber antes que nada 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 archivos fixdjgpp, fixmingw, fixmsvc, fixunix o fixwat
  (dependiendo del compilador y plataforma). 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, algunas versiones tienen problemas al crear el archivo de
  datos a partir de data.h, por lo que una buena opcin y forma de compilar
  todo sera:

    fix*****
    make depend
    make data.h
    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 (MS-DOS, Windows, Unix,
     GNU/Linux).

  P: Habr nuevas versiones?
  R: Por ahora no, pero en el futuro nadie sabe, tena algunos planes para
     TETRIS Queen II, pero...

  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 listo.

  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://www.talula.demon.co.uk/allegro/digmid.html

  P: Cmo descomprimo los archivos *.tar.gz?
  R: Utilizando los programas gzip y tar, los puede encontrar en la
     siguiente direccin FTP con los nombres gzp*b.zip y tar*.zip:

       ftp://ftp.demon.co.uk/pub/mirrors/simtelnet/gnu/djgpp/v2gnu/

     Una vez que los consiga, debe ejecutar:

       tar -xzvf ase*.tar.gz

  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: Tengo problemas y no hay mucha documentacin :-(
     Dnde encuentro ms ayuda?
  R: Puede enviarme un email a mi direccin personal:

       davidcapello@yahoo.com

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


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

  Programador, grficos, sonidos, documentacin, testeador, y otras cosas:

    David A. Capello (davidcapello@yahoo.com)
    http://come.to/davidcapello/ 

  Traduccin de la documentacin al ingls:

    Grzegorz Adam Hankiewicz (gradha@iname.com), realmente gracias a su
    colaboracin desinteresada (por ahora :-) de traducir la documentacin
    y perder su preciado tiempo en este horrible trabajo. Realmente gracias.
    http://gradha.infierno.org

  Msicas MIDI e imgenes de los lbumes:

    Todas las msicas de Queen en el juego, y las tapas de cada lbum,
    fueron bajadas desde el sitio:

      http://www.queentrivia.mcmail.com/ 

    Aqu encontrar un link hacia msicas MIDIs, donde tambin podr ver los
    autores de cada una.


  GRACIAS ESPECIALMENTE A:
  --------------------------------------------------------------------------

  Shawn Hargreaves (shawn@talula.demon.co.uk) y a las cientos de personas
  de todo el mundo que ayudaron a crear la librera Allegro.
  http://www.talula.demon.co.uk/allegro/

  DJ Delorie y toda la gente que ayud a crear el compilador DJGPP.
  http://www.delorie.com/djgpp/

  Robert Hhne (robert.hoehne@gmx.net), Salvador Eduardo Tropea (SET)
  (salvador@inti.gov.ar), Andris Pavenis (pavenis@lanet.lv), y de ms gente
  que contribuy con RHIDE.
  http://www.lanet.lv/~pavenis/rhide.html

  Charles W Sandmann (sandmann@clio.rice.edu) por el servidor DPMI para DOS.

  Alexey Pajitnov por hacer uno de los juegos ms adictivos de la historia.

  Y por supuesto, a Freddie Mercury, Roger Taylor, John Deacon, y Brian May,
  por hacer la mejor msica de todos los tiempos.

  --------------------------------------------------------------------------
                         Copyright (C) 1999, 2000, 2001 por David A. Capello
