bmpDraw()

Dessine un bitmap de format .BMP provenant de la carte SD

Exemples d'utilisation

bmpDraw("photo.bmp",0,0); // Dessine l'image BMP
bmpDraw("photo.bmp"); // Équivalent
bmpDraw("/photo.bmp"); // "/" en début indique la racine. 
bmpDraw("rep/photo.bmp"); // Dessine l'image BMP
bmpDraw("photo.bmp",230,230); // N'affiche rien si l'image "dépasse"

Référence

byte bmpDraw(String fileName, int x = -1, int y = -1);

Paramètres passés

fileName: nom du fichier sur la carte SD (format 8+3).
x,y: position du coin en haut à gauche du bitmap

Valeur retournée

Le code d'erreur:
0: tout s'est bien passé
1: problème d'initialisation de la carte SD
2: le fichier spécifié n'existe pas
3: le bitmap ne tient pas dans l'écran

Voir aussi

- bmpSave(); Sauvegarde un bitmap .BMP sur la carte SD
- bpxDraw(); Charge un bitmap .BPX de la carte SD
- bpxSave(); Sauvegarde un bitmap .BPX sur la carte SD
- setLimites(); Limite la zone de dessin
- screenPrint(); Copie d'écran sur la carte SD
- initSD(); Initialisation de la carte SD
- point(); Dessine un point

Notes

Si le paramètre x (resp y) est omis ou si il vaut -1, l'image sera placée le plus à gauche (resp haut), en accord avec la limite qui peut avoir été définie avec la fonction setLimites().

Si l'image est trop grande et ne tient pas dans l'écran ou dans les limites fixées par la fonction setLimites(), elle ne sera pas dessinée.

Attention n'est reconnu que les .BMP qui sont en vraies couleurs non compressés. Cela permet de diminuer la taille du code. En particulier les .BMP en noir et blanc afficheront n'importe quoi.

La carte doit être au format FAT16 ou FAT32. Si le nom est trop long (plus de 8 caractères), le fichier n'est pas trouvé et rien n'est dessiné. Les répertoires sont séparés par le caractère '/'.

Exemple

PecheuxGraph_ILI9341_8bits.zip\PecheuxGraph_ILI9341_8bits\examples\Documentation\Exemple-400-bmpDraw\Exemple-400-bmpDraw.ino (dans votre fichier téléchargé):

// Ce programme affiche une image sur toute la surface. C'est un bitmap, affiché en commençant par le bas.
// Seule une image est affichée car l'autre ne tient pas.

// Pour que le programme fonctionne, il faut insérer une carte microSD qui contienne le répertoire SD contenu dans
// PecheuxGraph.zip/examples

#
  $menu = ":PG";
  include <PecheuxGraph_ILI9341_8bits.h>
void setup() 
{
  setGraphMode(PAYSAGE); // Initialisation de l'écran

  // Affiche un seul fond d'écran
  if ( // Test pour voir si il y a bien la carte SD
    bmpDraw("320x240/1.bmp")* // Affiché seulement en mode paysage
    bmpDraw("240x320/20.bmp") // Affiché seulement en mode portrait
  // Si les deux copies ont échoué, la multiplication des deux codes d'erreurs est non nulle
  !=0) text("Il n'y a pas la carte SD,\nou le répertoire \"SD\" n'a pas été\nrecopié sur la carte"); 
}

void loop()
{
}

Résultat: