Fr:Selector

Selector
Télécharger	(archive)
Dévelopeur	Kounch
Version	1.2
Page Web	Site Officiel
Etat	Diffusé

Selector est une interface graphique pour les logiciels de la GP2X qui vous permez d'avoir une interface graphique pour les logiciels qui n'en ont pas et qui on besoin d'avoir un choix de fichier ou d'options de ligne de commande.

Pour pouvoir utiliser Selector, il faut avoir trois fichiers:

1. "Selector", ce fichier est le programe qui fait tout le travail.
2. Un fichier de configuration. L'explication de ce fichier est détaillé plus bas.
3. Un fichier script de lancement qui indique à selector où trouver le fichier de configuration et qui lorsqu'on quitte l'application relance le menu de la GP2x. L'explication sur ca mise en place est détaillé plus bas.

Contrôles

• Une fois configuré et après le lancement du script, une inteface avec un selecteur de fichier devrait apparaitre dans lequel vous pourrez naviguer en utilisant le joystick, et choisir un fichier en utilisant B, X, Select ou le bouton du joystick.
• Les boutons A et Y vous permètent de selectionner différentes options de ligne de commande (très utilie pour lancer, par exemple, Quake avec différentes options de lancement, ou gnuboy2x avec diférentes qualité sonores ou desactiver le son).
• Les boutons L et R sont utilisé pour naviguer plus rapidement (écran par écran).

Fichier de Configuration

Le fichier de configuration est un fichier texte avec des fin de ligne de type UNIX (pas MS-DOS/Windows).

Chaque ligne du fichier de configuration peut être en un des formats suivant:

• (Optionel) Toutes les lignes précédées par # sont considérées comme des commentaires et seront ignorées.

• (Optionel) Une ligne commancant par le mot clée langCode= suivie par un code de langue (Actuellement seulement EN pour anglais, TR pour turque et ES pour espagnole sont des codes de langue valides). La valeur par défaut est l'espagnole.

• (Optionel) Une ligne commancant par le mot clée skinPath= suivie d'un chemin. Le logiciel regardera dans le répertoire indiqué par le chemin pour un fichier image PNG se nommant fondo.PNG, qui doit avoir une taille de 320x240 pixels et il l'utilisera en tant que fond d'écran pour l'interface. Il y a quelques exemples dans le répertoire Skins de l'archive de selector. La valeur par défaut est sans skin (fond vert).

• (Optionel) Une ligne commancant par le mot clée layoutCode= suivi par un nombre qui indique un nombre de disposition pour les éléments d'interface. Actuellement il n'y à que deux options:
  • 0, où l'écran est mise à jour avec un message de copyright en haut de l'écran suivit de la ligne de comande actuellement selectionnée, avec un message d'aide en bas de l'écran.
  • 1, sans message de copyright et le bas de l'écran ne contient pas de message d'aide mais plutot le nom de la ligne de commande actuellement selectionnée.

• (Obligatoire) Une ligne (ou des lignes) commencant par le mot clée cmdLine= suivi du chemin d'un fichier éxécutable de la GP2X, incluant tous les paramètre voulu. Chaqu'unes de ces lignes sera une option de lancement à partir de selector.

• (Obligatoire) Une ligne commencant avec le mot clée baseDir= suivie avec un chemin qui sera pris comme chemin par défaut dans l'interface du logiciel. Au lancement de selector, il affichera les répertoires et les fichiers filtrés dans ce répertoire, et vous permetra de naviguer dans ce répertoire ainsi que ces sous répertoires mais pas dans les répertoire supperieurs au répertoire défini.

• (Optionel) Une ligne (ou des lignes) commencant avec le mot clée fileFilter= suivie avec une extension de fichier qui est utilisé en tant que filtre lors de l'affichage des fichiers dans le selecteur de fichier. S'il n'y a pas de lignes avec ce mot, selector affichera tous les fichiers dans les répertoires.

Script de lancement

Comme selector nécéssite comme paramète le nom du fichier de configuration utilisé, un script shell (.GPE ou .GPU) est nécéssaire pour le lancer aussi bien que nécéssaire pour lancer le menu de la GP2x quand on le quitte.

Voici un exemple de script:

 #!/bin/sh
 ./selector ./gnuboy_config
 sync
 cd /usr/gp2x/
 exec /usr/gp2x/gp2xmenu

En utilisant le script sur votre carte SD avec selector et son fichier de configuration (gnuboy_config dans ntre exemple du dessu), vous aurez selector qui se lancera avec ce fichier de configuration qui sync tla carte SD en quittant et execute le menu principale de la GP2X.

Il est important de se rappeller que le fichier script est un fichier texte avec des fin de ligne en UNIX (pas MS-DOS/Windows) et qu'il doit avoir une extension .gpe (lancement par le menu Games de la GP2x) ou .gpu (lancement par le menu Utility de la GP2x).

Problèmes connus

• Clignotement de l'écran (travail dessu).
• Les chemins de fichiers et de répertoires dans la cmdLine ne doivent pas avoir d'espaces blanc pour le moment.

Améliorations futures, fonctionnalitées, etc.

• Son?

Historique des version

• 1.2
  • Ajout d'un selectionneur de vitesse pour le processeur
  • Ajout de symboles textuels dans les options.
  • Ajout d'un changement d'option en utilisant le joystick vers la gauche ou la droite.
• 1.1
  • Ajout de l'option "DoubleColumn" et "Scroll Wrap".
  • Vitesse du CPU re-changé à 60mhz pour la compatibilité avec la sortie TV.
• 1.0
  • Final Release
  • Nettoyages de code mineur.
  • Ajout des appels vsync avec le "RGB flipping".
• 0.9 :
  • Ajout du support des caractères ISO-8859-1 pour l'affichage des noms et des répertoires.
  • Changement de l'affichage de l'écran en utilisant les Minimal Lib 0.B.
  • Changement de la vitesse du processeur dans le menu à 56MHz pour corriger le problème de brillance avec le dernier firmware 2.0.0.
  • Ajout de l'option SelectRectangle.
• 0.7 Added turkish translation, thanks to techFreak from gp32 Extreme boards.
• 0.6 Troisième version diffusé au publique. Utilisation de Minimal Lib 0.B. Ajout du controle pour une naviguation plus rapide avec L et R. Meilleur support de skin. ajout de plusieurs couches.
• 0.5 Deuxième version diffusé au publique. Support des images de fond au format PNG.
• 0.4 (Interne). La vitesse du CPU définit à 60MHz lorsqu'on est dans selector, retour à la valeur d'avant lorsqu'on quitte selector.
• 0.3 (Interne). Problème d'identification du répertoire corrigé. Ajout des messages d'erreursAdded error message inplementation.
• 0.2 (Interne). Localisation des textes en anglais et espagnole.
• 0.1 Première version diffusé au publique. Fonction basic.