Selector - Una interfaz de archivos para GP2X

GP2X_front_small captura GP2X_small.png
NovedadesCómo funciona - Info y Descargas
Introducción

Selector es un programa para GP2X que ayuda a lanzar desde la consola otros programas que necesiten como parámetro la ruta a un archivo (como por ejemplo las primeras versiones beta de GNUBoy2X), o que tengan múltiples opciones de linea de comandos (como por ejemplo el Quake para la ejecución de MODs).

Para poder utilizar Selector, se necesitan tres archivos distintos:

1. selector. Este es el programa que hace todo el trabajo.

2. Un archivo de configuración. Léase a continuación para conocer el formato.

3. Un script de lanzamiento que llame a selector indicando el archivo de configuración y que luego vuelva a lanzar el menú principal de la GP2X. Léase a continuación para ver un ejemplo..


Archivo de configuración

Cada linea del archivo de configuración puede ser de uno de los siguientes formatos:

-(Opcional) Líneas precedidas por #. Se consideran como comentarios y son ignoradas.

-(Opcional)  Línea con la palabra clave langCode= seguida de un código de idioma (en este momento sólo son validos los códigos EN para ingles, TR para turco y ES para español). Si no se incluye, utiliza español por defecto.

-(Opcional) Línea con la palabra clave skinPath= seguida de una ruta. El programa buscará en el directorio indicado por la ruta, un archivo llamado fondo.png, que debe tener un tamaño de 320x340 pixels, y que será utilizado como imagen de fondo para la interfaz. Véanse varios ejemplos en el directorio Skins. Por defecto no se carga ninguna imagen y se presenta un fondo verde.

-(Opcional) Línea con la palabra clave layoutCode= seguida de un número que indica la disposición de los elementos de la interfaz. Por el momento hay dos opciones;
0, con lo que se presenta la pantalla incluyendo un mensaje de copyright en la parte superior de la pantalla junto con la opción de comando seleccionada, y un mensaje de ayuda en la parte inferior de la pantalla.
1, con lo que se presenta la pantalla sin los datos de copyright, y se sustituye la parte inferior de la pantalla por la opción de comando seleccionada.

-(Opcional) Línea con la palabra clave scrollWrap= seguida de un número que indica si se debe activar o no la opción de desplazamiento infinito (al llegar al final de un listado, se vuelve al comienzo del mismo, y viceversa). Por defecto está activo. Por el momento hay dos opciones;
0, desactivado.
1, activado.

-(Opcional) Línea con la palabra clave doubleColumn= seguida de un número que indica si se debe activar o no la opción de mostrar los listados de archivos con dos columnas, en vez de la opción por defecto con una sola columna. Por el momento hay dos opciones;
0, Vista de una columna.
1, Vista de dos columnas.

-(Opcional) Línea con la palabra clave selectRectangle= seguida de un número que indica el tipo de rectángulo de selección que usará la interfaz. Por el momento hay dos opciones;
0, ningún rectángulo de selección.
1, un rectángulo de selección relleno en color verde.

-(Obligatoria) Línea (o líneas) con la palabra clave cmdLine= seguida por una ruta completa a un ejecutable de  la consola,incluyendo los parámetros que se deseen de la linea de comandos. Cada una de estas que se incluya, se convertirá en una opción de ejecutable a lanzar por selector.

-(Obligatoria) Línea con la palabra clave baseDir= seguida por una ruta al directorio que se desea que se tome como base al iniciar la interfaz del programa. Al iniciar selector, mostrara los directorios y archivos filtrados (léase a continuación para mas detalles) de este directorio, y permitirá navegar por el mismo y por sus subdirectorios, pero no permitirá navegar por directorios superiores a el.

-(Opcional) Línea (o líneas) con la palabra clave fileFilter= seguida de una extensión de archivo que se desee que la interfaz de selector presente. Permite definir diferentes extensiones de archivo que se desea que aparezcan (por ejemplo, gb o gc para el simulador de GameBoy). Si no apareciera ninguna de estas lineas, selector mostrara todos los archivos de todos los directorios.

Controles

Una vez configurado, al lanzarlo aparecerá un selector de archivos por el que se puede desplazar usando el joystick de la consola, y se puede elegir el archivo  que se quiera, pulsando B, X, Select o el botón del joystick.
Los botones A, Y sirven para elegir diferentes opciones de línea de comandos (útil para lanzar, por ejemplo, el Quake con distintas opciones de arranque, o el gnuboy2x con distintas calidades de sonido, o incluso sin él).
Los botones L y R sirven para desplazarsse pantalla a pantalla al navegar por los archivos.



Script de ejecución

Puesto que selector necesita como parámetro el nombre del archivo de configuración, y debido a su funcionamiento, se debe utilizar un script de consola (shell) para iniciar el mismo así como para volver al menú principal de la GP2X. Un ejemplo sencillo de script sería el siguiente:

--------------------------------
#!/bin/sh

./selector ./gnuboy_config
sync

cd /usr/gp2x/
exec /usr/gp2x/gp2xmenu
--------------------------------

Así, copiando este script en un directorio de una tarjeta SD junto con selector y un archivo de configuración llamado gnuboy_config, lanzaría a selector con dicha configuración, sincronizaría la tarjeta al salir, y volvería a lanzar el menú principal de la consola.

Es importante recordar que el script debe nombrarse con la extensión .gpe para lanzarse desde el menú de juegos, y con la extensión .gpu para lanzarse desde el menú de Utilidades.
Este programa se distribuye con la esperanza de que sea útil, pero SIN NINGUNA GARANTÍA, sin ninguna garantía MERCANTIL implícita y sin garantizar la CONVENIENCIA PARA UN PROPÓSITO PARTICULAR. Véase la GNU General Public License para más detalles.

Copyright (c)  2006  kounch.
Se concede permiso para copiar, distribuir y/o modificar este documento según los términos de la GNU Free Documentation License, Versión 1.2 o cualquier otra versión publicada por la Free Software Foundation.

Los nombres de productos utilizados en este sitio web son sólo con fines informativos. Todas las marcas y marcas registradas son propiedad de sus respectivos propietarios.

SourceForge.net Logo Support This Project Valid HTML 4.01!