82 lines
3.3 KiB
Plaintext
82 lines
3.3 KiB
Plaintext
##### INFORMATIONS IMPORTANTES #####
|
|
Nom : EasyInput
|
|
Auteur : Dark Storm (L.GATIN)
|
|
Dernière mise à jour : 16/02/2015
|
|
Version : 3.2
|
|
Licence : GNU General Public License
|
|
####################################
|
|
|
|
|
|
##### Présentation #####
|
|
|
|
EasyInput est une librairie de fonctions destinée à simplifier les méthodes de saisie de texte par un utilisateur.
|
|
Elle est utilisable gratuitement, vous pouvez la télécharger sur http://www.planete-casio.fr, rubrique "Logiciels" puis "Snippets".
|
|
|
|
|
|
##### Utilisation #####
|
|
--- Fichiers ---
|
|
Quoi qu'il arrive, vous avez besoin des fichiers <EasyInput.c> et <EasyInput.h>
|
|
Selon votre compilateur, il vous faut chosir le bon fichier de syscalls :
|
|
- Pour le Fx9860 SDK : gardez le fichier <EasyInput_.src>
|
|
- Pour GCC : gardez le fichier <EasyInput_.s>
|
|
|
|
--- Initialisation ---
|
|
Utilisez EI_init() pour mettre toutes les valeurs de configuration par défaut.
|
|
Ensuite, vous pouvez modifier les paramètres suivants en appelant la fonction EI_manage_config(int parameter, int value) :
|
|
EI_SET_COLUMN : Un nombre entre 1 et 21 qui correspond à la colonne de début de la zone de texte ;
|
|
EI_SET_ROW : Idem, mais entre 1 et 8 pour les lignes ;
|
|
EI_SET_BOX_LENGTH : La longueur de la zone de texte, en caractères, une valeur minimale de 3 est requise pour un bon fonctionnement ;
|
|
EI_SET_ALIGN : Le mode d'alignement du texte (EI_LEFT, EI_CENTER, EI_RIGHT) ;
|
|
EI_SET_START_MODE : Le mode de départ du curseur (EI_NORMAL, EI_ALPHA, EI_ALPHA_LOCKED) ;
|
|
EI_SET_Aa_KEY : Le code de la touche qui servira à changer la casse.
|
|
Exemple, pour fixer le mode de départ du curseur : EI_manage_config(EI_SET_START_MODE, EI_ALPHA);
|
|
Si <value> est égale à 0, la fonction retourne un pointeur sur l'élément demandé. Cela permet de récupérer les valeurs de configuration.
|
|
Exemple, récupérer la valeur de la longueur de la box : longueur = EI_manage_config(EI_SET_LENGHT_BOX, 0);
|
|
|
|
--- Appel ---
|
|
La fonction EI_input_string(int string_length, const char *chars_allowed) retourne un pointeur sur la chaine et doit être appellée de la manière suivante :
|
|
char *my_string = NULL;
|
|
my_string = EI_input_string(21, (const char*)".0123456789");
|
|
La chaine <chars_allowed> contient tout les caractères dont la saisie est autorisée.
|
|
|
|
--- Annexes ---
|
|
Retrouvez plus d'informations ici : http://www.planet-casio.com/Fr/forums/lecture_sujet.php?id=12979
|
|
|
|
|
|
##### CHANGELOG #####
|
|
--- V3.2 ---
|
|
- Ajout des caractères `+`, `-`, `*`, `/`, `_`, `#` à la liste de ceux traités.
|
|
|
|
--- V3.1 ---
|
|
- Simplification du système de configuration
|
|
|
|
--- V3.0 ---
|
|
- Réécriture de la boucle principale
|
|
- Correction des bugs concernant les syscalls à destination de l'OS 2.00 et ultérieur (merci à Nemhardy pour l'info)
|
|
- Correction des bugs concernant les ajouts de caractères impromptus
|
|
- Correction des bugs concernant les alignements de texte
|
|
|
|
--- V2.3 ---
|
|
- Refonte du système d'affichage
|
|
|
|
--- V2.2 ---
|
|
- Refonte du système de configuration
|
|
- Ajout de la gestion des minuscules
|
|
|
|
--- V2.1 ---
|
|
- Ajout de la "regex" pour les caractères autorisés
|
|
- Correction d'une fuite de mémoire lorsque l'on quitte avec Ac/ON
|
|
- Passage sous license GNU GPL
|
|
|
|
--- V2.0 ---
|
|
- Modification du mode de retour de la chaine
|
|
|
|
--- V1.2 ---
|
|
- Correction de quelques bugs
|
|
|
|
--- V1.1 ---
|
|
- Correction de bugs
|
|
- Optimisation de l'entrée
|
|
|
|
--- V1.0 ---
|
|
- Création de la librairie |