AMAZE

NOMBRE
SINOPSIS
CONFIGURACIÓN
DESCRIPCIÓN
OPCIONES
ESTADO DE SALIDA
ERRORES
ENTORNO
ARCHIVOS
VERSIONES
CONFORME A
NOTAS
DEFICIENCIAS
EJEMPLO
AUTORES
VE TAMBIÉN

NOMBRE

amaze − aplicación gráfica para generar e imprimir laberintos

SINOPSIS

amaze [−x columnas] [−y filas] [−wall ancho] [−path ancho] [−stay cuenta] [−cuts cuenta] [−s] [−creep ms] [−opción
... ]

CONFIGURACIÓN

Los ajustes, como los colores, se pueden cambiar en la interfaz gráfica de usuario. Para saber dónde se guardan entre sesiones, utilice: amaze −init
Para restaurar todos los valores predeterminados, y pasar por alto la configuración guardada, utilice la opción −no−restore.

DESCRIPCIÓN

amaze es una aplicación gráfica para generar e imprimir laberintos simples. Las propiedades de laberinto (tamaño y aspecto) se pueden establecer en la interfaz gráfica, o predeterminado usando argumentos de la línea de comandos.

Terminología
Decimos un laberinto consiste en una cuadrícula de losas, y un conjunto de paredes entre las losas. Entre cada dos losas vecinas allí tampoco es una pared o no lo hay; si no hay ninguno, entonces las dos losas se dice que son conectadas. Cuando una losa A está conectado a la losa B y de B a C, entonces A y C están también conectadas (a través de B). Llamamos a la secuencia de losas ABC un camino de A a C. Cada laberinto tiene una losa de entrada y una losa de destino; el camino entre estas dos losas se llama la solución del laberinto (sólo puede haber uno de estos caminos). La alegría y el desafío de un laberinto, tradicionalmente, es encontrar la ruta de solución a través del laberinto.

Acciones
La interfaz gráfica muestra un conjunto de controles de laberinto y un solo laberinto. El laberinto se genera aleatoriamente cada vez que las dimensiones del laberinto cambian (ver los controles "Altura" y "Ancho"), y cada vez que seleccione la acción Archivo> Nuevo del menú. Con Editar> Muestra  ruta se puede elegir si se muestra la ruta de solución (el "rastro de migas de pan", si se quiere) tras el laberinto en la pantalla o no. Cada vez que lo enciende, el modo de visualización del camino alternará entre estable y animado ("progresiva" a través del laberinto). Ve también la opción −creep. Al imprimir el laberinto (utilizando Archivo>Imprime...) se producen dos páginas: primero el laberinto sin la ruta de solución indicada, y luego el laberinto con una línea de puntos que muestren la ruta.

Silueta
Puede utilizar una imagen de silueta (también conocido como "máscara") para definir la forma del laberinto. Por defecto, el laberinto llenará toda la cuadrícula rectangular de losas disponibles. Una máscara constará de una imagen y un color "muerto". Actualmente, el color muerto es el del píxel (0,0) en la imagen. Cualquier píxel de la máscara con este color se llama un píxel muerto. Cuando se define una máscara, se estira para cubrir ese rectángulo, y luego todas las losas cuyo píxel de media posición corresponde a un píxel muerto en la máscara están excluidos del laberinto. Así que si la imagen de la máscara es una imagen de un gato en un fondo (monocromo!) blanco, el laberinto tendrá la forma de un gato. Puede definir la imagen del esquema utilizando Archivo > Abre silueta, o simplemente arrastrar una imagen (debe ser un archivo local) en el lienzo.

Nota
Internamente, el laberinto se representa como un conjunto de células. Para losas en forma de cuadro o triángulo, una losa es igual a una célula; para losas de hexágono, cada losa tiene dos células de altura; para octágono, una o tres. Algunas notas de la documentación puede ser confusas si usted no es consciente de esta distinción.

La versión de amaze que se ejecuta en MS Windows es una aplicación gráfica pura, sin un adjunta ventana de consola. Esto implica que no hay "salida estándar", así que si quieres el resultado de, por ejemplo, −init necesita utilizar la opción −outarchivo precediéndole en la línea de comando.

OPCIONES

−x columnas

especifica el número de columnas de losas en la cuadrícula de laberinto. Posteriormente puede ajustar esto en la interfaz gráfica mediante el "Ancho" spin-cuadro o deslizador.

−y filas

especifica el número de filas de losas en la cuadrícula de laberinto. Posteriormente puede ajustar esto en la interfaz gráfica mediante el "Altura" spin-cuadro o deslizador.

−p/−path píxeles

define la anchura, en píxeles, de la ruta de solución a través del laberinto, cuando eso aparece en la interfaz gráfica (consulte la opción −s). Posteriormente puede ajustar esto en la interfaz gráfica mediante el "Ruta" spin-cuadro o deslizador. Si el área de visualización es demasiado pequeño, la ruta puede dibujarse más estrecha que esta.

−wall píxeles

define la anchura, en píxeles, de las paredes del laberinto. Posteriormente puede ajustar esto en la interfaz gráfica mediante el "Pared" spin-cuadro o deslizador. Si el área de visualización es demasiado pequeño, las paredes pueden dibujarse más estrecha que esta.

−stay factor

determina cuanto cada paso en el laberinto trata de continuar en la misma dirección. Con un valor de 1, la dirección es enteramente al azar por cada losa; ajustado a N, la probabilidad es de 1 en N de ser aleatorio. Tenga en cuenta que los laberintos totalmente aleatorios tienden a tener rutas de solución relativamente largas.

−cuts cuenta

tratará de añadir el número dado de cortes transversales adicionales entre células adyacentes no en la ruta. Cero cortes significa el laberinto no contendrá bucles en las rutas; mas de cero significa que algunas paredes no pueden tienen conexión con el exterior. La cuenta es un límite superior, el laberinto puede tener menos cortes.

−tile forma

forma de losas del laberinto: triangle (triángulo), square (cuadro), hexagon (hexágono) o octagon (octágono).

−mask archivo

utilizará el imagen en el archivo para enmascarar parte del piso, utilizando el color del píxel a (0,0) como el color transparente. Así que si tiene una foto de algo sobre un fondo monocromo, se obtiene un laberinto en la misma forma. Casos especiales de archivo son "[total]" (sin máscara), "[round]" (forma circular), y "[heart]" (forma de corazón para el Día de San Valentín). Si usted realmente debe utilizar un archivo con un nombre literalmente comenzando con "[", prefíjelo con "[image]".

−path-color color

establece el color de la ruta de solución. Para una discusión detallada de formatos de nombres de colores, ve http://doc.qt.nokia.com/4.7/qcolor.html#setNamedColor. Ejemplos: "steelblue", "#112233".

−tile-color color

establece el color de las losas. Compare opción −path-color.

−text-color color

establece el color de la mensaje. Cf. opción −path-color.

−text texto

establece el texto del mensaje. Este texto se encadenan a lo largo de la ruta de la solución (una letra por losa, con un espaciado aleatorio), por lo que encontrando la ruta de solución usted también podrá leer el mensaje.

−wall-color color

establece el color de las paredes. Cf. opción −tile-color.

−s

muestra la ruta de solución como una línea de puntos en la laberinto por la pantalla.

−cover 0-100

determina el porcentaje máximo de la ruta que se muestra durante la animación de la ruta. El camino empieza a crecer desde el punto de entrada, añadiendo el incremento en cada paso (véase la opción −steps). En cuando este porcentaje es alcanzado, la cola comienza a retraer hacia el punto de destino.

−creep ms

especifica el intervalo (en milisegundos) entre los pasos de animación de la ruta. Si el valor es cero, el camino no está animado en absoluto.

−steps cuenta

animará la ruta para pasar de entrada hasta destino en este número de pasos. El incremento efectivo por paso será al menos una célula.

−out ruta

redirige la salida normal estándar al archivo dado. En MS Windows, necesitará esto para conseguir cualquier resulto de por ejemplo −help o −init.

−err ruta

redirige la salida de error estándar al archivo dado. En MS Windows, necesitará esto para conseguir algún mensaje de error no gráfico.

−std ruta

redirige tanto los estándares de salida normal y de error en el archivo dado. El uso de ambos −out y −err al mismo archivo en lugar no es bueno, que hará que uno de sobrescribir el otro.

−locale localización

elecciona explícitamente una localización de dialogo. Actualmente (parcialmente) en apoyo son: "da", "de", "en_GB", "en_US", "eo", "es" (Castellano), "fr", "nl", y "zh_CN".

−mini

simplifica la interfaz para que quepa en una pantalla más pequeña. Con esto, usted puede utilizar amaze efectivamente bajar a alrededor de 320×200 píxeles.

−do-splash

muestra una pantalla de bienvenida al iniciar.

−no-splash

no muestra una pantalla de bienvenida al iniciar.

−no-restore

ignora cualquier configuración guardada, volviendo a los valores predeterminados incorporados.

−no-retain

suprime guardar los cambios de los ajustes.

−init

imprime la ruta de acceso al archivo donde se guardan los ajustes.

Qt Opciones Comunales
(Solamente disponible en la versión ingles de esta página.)

X11 Opciones Comunales
(Solamente disponible en la versión ingles de esta página.)

ESTADO DE SALIDA

Amaze devuelve un estado distinto de cero sólo en caso de errores internos fatales, o parámetros de línea de comandos no válidos.

ERRORES

Errores entre los argumentos de la línea de comando son reportados a la salida de error estándar. Problemas del uso de la interfaz gráfica por parte del usuario normalmente se muestran en las ventanas de diálogo localizadas y modales.

ENTORNO

No hay variables de entorno que se utilizan para configurar la parte de aplicación de este programa. Las bibliotecas vinculadas (por Qt y X11 bajo Linux) pueden tener dependencias de variables de entorno.

ARCHIVOS

Tenga en cuenta que las rutas de los archivos que se dan aquí son para Ubuntu, y puede ser diferente en otras plataformas.

/usr/share/amaze/*.qm

− las archivos de localización para Qt

/usr/share/applications/amaze.desktop
/usr/share/app-install/desktop/amaze.desktop

− para el menú del escritorio

/usr/share/doc/amaze/*

− derechos de autor y tal

/usr/share/icons/hicolor/*x*/apps/amaze.png

− iconos para escritorio y menú de aplicaciones

/usr/share/man/eo/man1/amaze.1.gz

− esta página del manual

/usr/bin/amaze

− el ejecutable

$HOME/.config/Morgul/amaze.conf

− los ajustes guardados entre las sesiones de este usuario

http://qtamaze.sourceforge.net/version.html

− donde la verificación de actualización busca el número de versión actual

Ve la opción −init para el archivo, específico del sistema y del usuario, utilizado para guardar los ajustes entre sesiones.

VERSIONES

Esta es la tercera versión, 1.2. (La primera versión, 1.0, ya está obsoleto.) Está disponible en http://qtamaze.sourceforge.net como fuente (vía CVS), como un paquete de Ubuntu/Debian, y como un archivo de Windows XP MSI.

CONFORME A

Amaze trata de seguir las directrices de la GUI y muestras de Qt en la Documentación de Qt 4.5 a 4.7, las directrices de Gnome para el archivo ".desktop", y las recomendaciones de WiX para el instalador MSI.

NOTAS

Generar laberintos no es algo exactamente nuevo o desafiante en sí mismo, pero suficientemente divertido como tema de un proyecto para mí.

Para más detalles sobre los temas pendientes y los cambios en curso, visite el rastreador de proyecto en http://qtamaze.sourceforge.net/, o recupera las fuentes a través de CVS allí y mira el archivo amaze/TODO.

A hacer
(Solamente disponible en la versión ingles de esta página.)

Formatos de salida
(Solamente disponible en la versión ingles de esta página.)

Configuración
(Solamente disponible en la versión ingles de esta página.)

DEFICIENCIAS

(Solamente disponible en la versión ingles de esta página.)

EJEMPLO

amaze −no−splash −s

AUTORES

tinco en SourceForge

VE TAMBIÉN

xlaby(1).