Module améliorant et facilitant l'utilisation de l'écran 1.8in Waveshare pour microbit

If you don't speak french, you can use a translator

Conventions de ce README.md

1. Les variables que vous devez nommer vous-même sont écrites entre simple guillemets
2. Les variables suivi d'un '?' sont facultatives

Comment afficher une image

1. Créer un ficher qui regroupera toutes les images d'une même familles (les différentes images d'un même personnage par exemple). Par convention, on appellera ce fichier du même nom que la famille d'image (différentes images de pikachu --> pikachu.ts). Chaque image sera par ailleurs stockée dans une fonction.

2. Pour créer cette fonction, il vous suffira de télécharger et d'exécuter correctement le fichier convertisseur.py puis de copier coller le contenu du fichier de sortie dans votre fichier 'famille'.ts.

Pour plus de détails sur l'utilisation correcte de ce fichier, vous pouvez vous référer à la section "Convertisseur"

3. Appeler la fonction "displayImage()" avec x et y respectivement l'absisse et l'ordonnée du point en haut à gauche du placement de l'image (comme ci-après).
   displayImage(x, y, 'la fonction de votre image'(), transparence?, taille_pixel?)

4. Magie, l'image s'affiche toute seule aux coordonnées que vous lui avez donnés !

Utilisation du fichier convertisseur

Pour obtenir les couleurs de chaque pixel dans le bon format, vous pouvez utiliser le logiciel lcd-image-converter (téléchargeable gratuitement ici ).
Il vous suffit ensuite d'ouvrir l'application, le choisir "New Image" et d'importer votre image.
Allez ensuite dans "Options --> Convertion".
Vérifiez le bon réglage de quelques options :

• "Preset" doit être réglé sur "Color R5G6B5"
• "Main Scan Direction" doit être réglé sur "Top to Bottom" et "Line Scan Direction" sur "Forward"
• Dans l'onglet "Image", "Block size" doit être réglé sur "16 bits", le préfixe doit être "0x", le délitieur doit être ", " et il ne doit pas y avoir de suffixe

Ensuite, il vous suffit de cliquer sur "Show Preview" puis de copier / coller la liste des couleurs dans le fichier colors_in_RGB565.txt

Ce convertisseur doit se placer dans le même dossier que votre fichier de couleurs issue du logiciel ci-dessus.
Le fichier contenant les couleurs doivent se trouver dans un fichier texte nommé colors_in_RGB565.txt .
Lancez ensuite le convertisseur, entrez les informations requises par le programme.
Le fichier de sortie s'appellera display'VotreImage'.txt et contiendra la fonction à copier coller tel quel dans votre code.

Comment afficher du texte ?

Il vous suffit tout simplement d'utiliser la fonction displayDialogue(x, y, 'votreTexte', 'color', 'speed')
La vitesse correspond au temps en miliseconde qu'il y a entre l'écriture de 2 lettres (même en mettant 0, l'affichage ne sera pas instentané à cause de la vitesse d'exécution des instructions. Pour avoir un rendu immédiat, préférez l'utilisation de disString(...) suivi d'un rafraichissement de l'écran).

Documentation

Une documentation sommaire est disponible dans le fichier 'documentation_LCD1IN8.txt'. Si vous avez une idée d'amélioration ou une réctification pour cette documentation, n'hésitez pas !

Crédit : Grégoire Lefaure et Maxime Dautriche