@database Soliton
@master Soliton.guide
@$VER: Soliton Documentation 1.30 (97-03-09)
@author "Kai Nickel"
@(c) "Copyright ©1997 Kai Nickel"


@node "MAIN" "Tabla de Contenidos"

                     @{b}S o l i t o n@{ub}

              Juego de cartas de Solitario
                   

@{b}Introducción@{ub}   @{" Descripción            " link "DESCRIPTION" }
               @{" Instalación            " link "INSTALLATION"}
               @{" Autor                  " link "AUTHOR"      }

@{b}Uso@{ub}            @{" Ventana principal      " link "MAINWINDOW"  }
               @{" Ajustes                " link "SETTINGS"    }
               @{" Crear juegos de cartas " link "CARDS"       }

@{b}Apéndice@{ub}       @{" Historia               " link "HISTORY"     }
               @{" Copyright              " link "COPYRIGHT"   }
               @{" MUI                    " link "MUI"         }
@endnode





@node "DESCRIPTION" "Descripción"
                                   @{b}D e s c r i p c i ó n@{ub}


@{b}Características@{ub}  Soliton es un juego de cartas de Solitario con las siguientes
                          características:

                 * Las barajas son cargadas a través de datatypes. También puedes
                   @{"hacerlas" link "CARDS"} tú mismo facilmente usando el tamaño o número
                   de colores que quieras.
                 * Interfaz del usuario amigable con el sistema @{"MUI" link "MUI"} , funciona
                   en el workbench o en cualquier otra pantalla. También trabaja muy
                   bien en tarjetas gráficas.
                 * Patrón de fondo seleccionable.
                 * Movimiento de arrastrar y soltar de las cartas opaco.
                 * Diferentes opciones de juego, contador de tiempo, estadísticas,
                   indicador de movimiento.
                 * Idiomas: Inglés, Alemán, Noruego, Francés, Italiano, Sueco, Español
                 * @{"Giftware" link "COPYRIGHT"}.

@{b}Requisitos@{ub}       Para jugar a Soliton necesitas el Kickstart 3.0 (o superior) y
                       @{"MUI" link "MUI"} Versión 3.6 (o superior).
@endnode





@node "INSTALLATION" "Instalación"
                               @{b}I n s t a l a c i ó n@{ub}


@{b}Automática@{ub}        La mejor forma de instalar Soliton es ejecutar el script
                  "Soliton-Install". No te preocupes: ¡No se copiará ningún
                  fichero a tus directorios del Sistema!

@{b}A mano@{ub}            Si no te gustan los scripts o el Installer, sólo tienes que arrastrar
                  el cajón "Soliton" a cualquier lugar de tu disco duro.
                  Entonces coge el "Soliton.guide" de tu idioma preferido desde
                  "Soliton/Docs/<idioma>/" y muevelo al cajón "Soliton/" para que
                  pueda ser usada para la ayuda en-línea.

@{b}Desinstalación@{ub}    Para deshacerte de Soliton sólo tienes que borrar el cajón Soliton.
                           Eso es todo.
@endnode





@node "AUTHOR" "Autor"
                                 @{b}A u t o r@{ub}


               Soliton ha sido escrito por Kai Nickel

@{b}Correo@{ub}           Kai Nickel
               Herzogstrasse 29
               67435 Neustadt
               Germany

@{b}eMail@{ub}          un7x@rz.uni-karlsruhe.de
               kai@rpsbbs.palatinate.de

@{b}WWW@{ub}            http://www.uni-karlsruhe.de/~un7x/

               En mi página hogar se pueden encontrar actualizaciones y una galeria de
               barajas, o en Aminet (game/think y game/data).


@{b}Traducción@{ub}     Todas las traducciones fueron realizadas por la Amiga Translators
                   Organisation @{b}ATO@{ub}. Quisiera dar las gracias a las siguientes
                   personas por su trabajo:

               Francais:

               Franck Aniere     <aniere@univ-mlv.fr>          (Guide, Install)
               Francis Labrie    <fb691875@er.uqam.ca>         (Catalog)
               Franck Routier    <alci@club-internet.fr>       (Corrector)

               Svenska:

               Magnus Holmgren   <cmh@lls.se>                  (Traductor)
               Linus Silvander   <linus.silvander@parnet.fi>   (Corrector)

               Norsk:

               Audun Vaaler      <audunv@powertech.no>

               Italiano:

               Luca Nora         <ln546991@silab.dsi.unimi.it> (Traductor)
               Roberto Patriarca <R.Patriarca@flashnet.it>     (Corrector)

               Español:

               Arturo Roa        <aroa@redestb.es>             (Traductor)
               Samuel Aguilera   <slyguy92@arrakis.es>         (Corrector)

@endnode









@node "MAINWINDOW" "Ventana principal"
                                 @{b}V e n t a n a   p r i n c i p a l@{ub}


               La ventana consiste principalmente en la zona de juego. Las cartas se mueven
               arrastrando y soltando: Pulsa en la carta, mantén presionado el botón del ratón y
               sueltalo sobre la zona de destino.


@{b}Botones@{ub}        En lo alto o a la izquierda de la ventana hay un barra de botones. Los
               botones pertenecen a los términos de menú más importantes. Para saber que hacen,
               mira el correspondiente termino del menú.

               El botón  'Mover' indica una posibilidad de movimiento y lo ejecuta
               si lo pulsas.

               En la barra de botones hay también un contador de tiempo que comienza desde cero
               cada vez que empieces una nueva partida. ¡Sólo funciona mientras la ventana
               Soliton esté activa!

               El aspecto de la barra de botones y la existencia del indicador
               Mover es @{"configurable" link "SETTINGS"}.


@{b}Menú@{ub}           El menú ofrece las siguientes funciones:

               Proyecto

               Nuevo        :  Comenzar un nuevo juego.

               Limpiar      :  Intenta mover automáticamente todas las cartas
                               a sus destinos.

               Deshacer     :  Deshace el último movimiento.

               Sobre        :  Muestra información sobre Soliton.

               Ayuda        :  Abre la ayuda en-línea, como presionar la tecla HELP.

               Estadísticas :  Abre la ventana de estadísticas del juego.

               Iconificar   :  Cierra Soliton y pone un icono en el workbench
                               para despertar a Soliton de nuevo.

               Salir        :  Acaba Soliton.

               Perfiles

               Aquí puedes cambiar entre perfiles diferentes. Un perfil es
               una combinación de una baraja y un patrón. Puedes definir
               perfiles en la ventana @{"ajustes" link "SETTINGS"}.

               Ajustes

               Soliton      :  Abre la ventana @{"ajustes" link "SETTINGS"} de Soliton.

               MUI          :  Abre las preferencias de MUI para Soliton.


@{b}Ayuda@{ub}          Si presionas la tecla HELP abrirás una ventana de ayuda en-línea
               conteniendo esta documentación.
               Si no mueves el puntero del ratón durante un tiempo, verás
               un bocadillo con información sobre el objeto que esté bajo
               el puntero del ratón.
@endnode





@node "SETTINGS" "Ajustes"
                                   @{b}O p c i o n e s@{ub}


               Los ajustes del programa están divididos en tres páginas:


@{b}Forma de juego@{ub} 
               
               @{b}Abrir cartas@{ub}

               Número de cartas que deben ser abiertas cuando
               pulses el mazo de arriba a la izquierda. Cuanto más alto más
               difícil será el juego.

               @{b}Movimiento en bloques@{ub}

               Si se activa, tienes que mover las cartas desde los montones todas
               juntas como un bloque. Si no, puedes coger algunas de las
               cartas y moverlas. La opción hace el juego más difícil.

               @{b}Auto apertura@{ub}

               Vuelve la carta más alta del mazo tan pronto como es descubierta.
               Esta opción no afecta a la dificultad del juego.

               @{b}Abrir automáticamente arriba a la izquierda@{ub}

               Hace a Soliton descubrir la(s) primera(s) (1, 2 ó 3) carta(s) después
               de haber vuelto el mazo "fuente". Esta opción no afecta a la 
               dificultad del juego.

               @{b}Indicar movimientos@{ub}

               Muestra el botón 'Mover' cada vez que exista un posible movimiento.


@{b}Apariencia@{ub}     @{b}Botones@{ub}

               Puedes elegir entre el "Botones molones" y el feo
               "Botones normales". Los botones molones quedan mejor, eso es todo
               lo que hay que decir sobre ello. Si no te gusta ninguno,
               puedes elegir "Sin botones" y usar el menú en vez de estos.

               @{b}Velocidad de vuelo@{ub}

               Velocidad de las cartas cuando están 'volando' a sus destinos,
               e.g. Porque has pulsado en 'Limpiar'. También puedes selecionar 
               'no animación' para hacer que las cartas salten inmediátamente a
               su destino.

               @{b}Cartas opacas@{ub}

               Muestra la carta 'completa' cuando se mueva, en lugar de un aburrido 
               borde.

               @{b}Pitido@{ub}

               Usa el pitido del sistema cuando ocurre un error.

               @{b}Requester@{ub}

               Pregunta antes de comenzar una nueva partida o salir del programa.


@{b}Perfiles@{ub}       Aquí puedes definir hasta 10 perfiles distintos. Un perfil
               es una combinación de una baraja y un patrón de fondo que puede ser
               seleccionado en el menú perfiles. Todos los perfiles son listados
               a la izquierda.

               @{b}Perfil@{ub}

               Nombre del perfil seleccionado.

               @{b}Baraja@{ub}

               Soliton puede cargar barajas de dos formas diferentes:

               1. Todas las cartas en un fichero de imagen. Sólo tienes que seleccionar 
                  este fichero aquí.

               2. Cada carta en un fichero separado en un directorio común.
                  En este caso, por favor selecciona este directorio (pero no
                  el fichero).

               Puedes crear facilmente @{"tus propias cartas" link "CARDS"}.

               @{b}Patrón@{ub}

               Patrón de fondo de la zona de juego. Puedes usar cualquier fichero
               de imagen que quieras.

@endnode



@node "CARDS" "Crear juegos de cartas"
                            @{b}C r e a r   j u e g o s   d e   c a r t a s@{ub}


@{b}Formato@{ub}          Lo que debes saber:

               * Todas las cartas de una baraja tienen que ser rectangulares y del
                 mismo tamaño. Si las cartas son muy grandes necesitarás una
                 pantalla muy grande para jugar con ellas. Las cartas con un tamaño de
                 80*120 todavía entrarán en una pantalla de 640*512.

               * Dependiendo de la altura de la ventana Soliton siempre muestra por
                 lo menos 1/9 de una carta cubierta. Por eso el valor (K, Q, J,
                 10, ...) de la carta debe estár visible en el primer 9° de la carta
                 - si es posible.

               * Puedes usar cuantos colores quieras. Soliton remapeará
                 la baraja para el modo de pantalla disponible mientras
                 lo carga. NO USAR MODOS HAM, porque estos no pueden ser
                 remapeados para ser mostrados en modos de pantalla "normales".

               * Puedes usar cualquier formato de dibujo que pueda ser cargado con
                 datatypes. Como no todo el mundo tiene todos los datatypes exóticos,
                 creo que IFF, JPEG, o PNG son la mejor elección.

@{b}Ficheros@{ub}         Soliton ppuede cargar cartas de dos formas distintas:

               * Todas las cartas en un fichero de imagen. Tienen que estar juntas
                 las unas con las otras de la forma en que se presenta en el fichero
                 "Cards_Default.iff".
                 Graba el dibujo entero exactamente sin borde (e.g. como una brocha)
                 porque Soliton asume que el tamaño del fichero es 1/14
                 del ancho del dibujo * 1/4 de la altura del dibujo.

                 Ventaja     : Carga bastante rápida.
                 Desventaja  : Tienes que remapear todas las cartas a una paleta de
                               color común.

               * Cada carta en un fichero separado en un directorio común. Los
                 nombres de los ficheros que se esperan son como estos:

                   "Back"     para los reversos
                   "Empty"    para el lugar de las cartas vacio

                   "Clubs_A"  para el as de Tréboles
                   "Clubs_2"  para el dos de Tréboles
                      .
                      .
                      .
                   "Clubs_K"  Para el rey de Tréboles

                   Y lo mismo para: "Diamonds_#" (Diamantes)
                                    "Hearts_#"   (Corazones)
                                    "Spades_#"   (Picas)

                 Ventaja   : Paleta de color individual para cada carta
                 Desventaja: Aumento del tiempo de carga


@{b}Publicación@{ub}    Por supuesto puedes publicar tus cartas como quieras.
               Pienso que Aminet/game/data es el mejor lugar para las barajas.
               Por favór no olvides incluir un fichero .readme.



                              ¡ ¡ ¡ D I S F R U T A  ! ! !
@endnode


@node "HISTORY" "Historia"
                              @{b}H i s t o r i a@{ub}


@{b}V1.30@{ub}          * Botón indicador de Mover.
09-03-97       * "Botones molones" ;-) en el lado izquierdo de la ventana.
               * Las cartas 'vuelan' a sus destinos.
               * Baraja-patrón-perfiles selecionables via menú.
               * Areglado un bug con las cartas arrastradas manchando la pantalla.
               * El interruptor cartas opacas ha sido ignorado a veces.
               * El pitido de la pantalla y 'Auto volver arriba a la izquierda' pueden ser desactivados.
               * Arreglado la opción 'Ayuda' del menú.
               * Scripts de ImageFX para convertir juegos de cartas al formato de Solton.
               * Arreglado un bug con Limpiar cuando auto abrir estaba apagado.
               * Reglas arregladas : A en 2 ahora posible (bastante inutil de todos modos),
                 pero no más K en A. Posibilidad de mover las cartas atras desde los 
                 cuatro montones de destino.
               * Requesters-estás-seguro opcionales antes de 'Nuevo juego' y 'Salir'.
               * Nuevos idiomas.


@{b}V1.20@{ub}          * Contador de tiempo.
18-02-97       * Ventana de estadísticas.
               * Soporte para los V43-Datatypes para conseguir más de 256 colores.
               * Incrementada la velocidad de rendeo en pantallas con más de 256
                 colores (especialmente en sistemas CyberGraphics).
               * Nuevos catalogs: Francés, Sueco
               * Mejorada un poco la baraja por defecto.
               * El punto de arrastre puede saltar lejos cuando se arrastren cartas muy rápido.
               * Script de instalación revisado.


@{b}V1.10@{ub}          * Deshacer mejorado.
08-02-97       * Movimiento opaco opcional.
               * Arrastrar y soltar comienza cuando mueves el ratón, no antes.
                 El botón derecho del ratón aborta el arrastrar y soltar.
               * El tamaño de las cartas cubiertas depende de la altura de la ventana.
               * Volver automáticamente las cartas de arriba puede ser apagado ahora
               * Mejoras cosméticas en algunos requesters y la ventana de ajustes.
                 Nuevo icono.
               * Nuevos juegos eran inmediatamente limpiados a veces. Oops.
               * Internamente: KaiLib ;-)


@{b}V1.00@{ub}          * Primera versión
01-02-97
@endnode



@node "COPYRIGHT" "Copyright"
                                   @{b}C o p y r i g h t@{ub}


               Soliton es copyright ©1997 por Kai Nickel.

               Soliton es GIFTWARE. Se te permite jugar con el y copiarlo
               mientras no tengas un interés comercial.
               El archivo original debe permanecer completo y sin cambios
               cuando copies Soliton.

               !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

               Si te gusta el programa sólo se te pide que mandes un pequeño presente
               a el @{"autor" link "author"}. ¿No sabes que? Bien, entonces pon algo de dinero
               en una carta... :-)

               !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

               Se da permiso explícito para publicar Soliton a las series de CD
               Meeting-Pearls y Aminet.

               El autor no puede garantizar el correcto funcionamiento de Soliton
               y no puede ser hecho responsable de cualquier consecuencia negativa
               que pueda resultar del uso de Soliton.

               Soliton usa el @{"sistema MUI" link "MUI"} por Stefan Stuntz.

               @{"Traducciones" link "AUTHOR"} realizadas por ATO.
@endnode




@node "MUI" "MUI"
                                      @{b}M U I@{ub}


                               Esta aplicación usa

                              MUI - MagicUserInterface

                        (c) Copyright 1993-97 por Stefan Stuntz


               MUI es un sistema para generar y mantener interfaces gráficos
               de usuario. Con la ayuda de un programa de preferencias, el usuario
               de una aplicación tiene la capacidad de personalizar el conjunto
               de acuerdo a sus gustos personales.

               MUI se distribuye como shareware. Para obtener un paquete completo
               conteniendo muchos ejemplos y más información sobre el registro
               por favor busca un fichero llamado "muiXXusr.lha" (XX significa
               el número de la última versión) en tus bulletin boards o en discos
               de dominio público.

               Si quieres registrarte directamente, sientete libre para mandar


                                DM 30.-  o  US$ 20.-

                                        a

                                   Stefan Stuntz
                             Eduard-Spranger-Straße 7
                                   80935 München
                                     GERMANY



@{b}MUI en Soliton@{ub} Soliton necesita MUI 3.6 o súperior para ser instalado. Se te
               permite usar MUI @{b}sin@{ub} registrarte - pero cuando te registres
               podrás disfrutar de algunas funciones extendidas en las preferencias de MUI.
               Es muy recomendable leer la documentación de MUI cuidadosamente - especialmente de
               las preferencias de MUI. A pesar de que quisiera mostrarte en la siguiente lista
               @{i}algunas@{ui} ventajas de los programas MUI que pueden ser útiles usando 
               Soliton:

               Si quieres que Soliton trabaje en una @{b}pantalla@{ub} propia, entonces
               puedes hacerlo con las preferencias de MUI para Soliton.

               Las ventanas de la aplicaciones MUI son @{b}escalables@{ub} y completamente
               @{b}sensibles a los tipos de fuente@{ub}.

               Las aplicaciones pueden ser @{b}iconificadas@{ub} en cualquier momento con un
               gadget extra en las barras de título de las ventanas.
@endnode
