// Version 1.0.0 #ifndef _PxGraph_ILI9341_Shield_ #define _PxGraph_ILI9341_Shield_ //########################################################################### //#### REGLAGES DE LA LIBRAIRIE #### //#### PEUT ETRE MODIFIE PAR L'UTILISATEUR #### //########################################################################### #define FILL_MAX (1<<5) // 32 départs maximum ; doit être une puissance de 2 #define TABULATEUR 20 // Tous les 20 pixels (environ 3 caractères) #define BUFFER_SD 10 // Nombre de words pour la lecture/écriture de la SD // Avec une Uno et un shiled ST7781, un image 320*240 aura un temps en // millisecondes de: // BUFFER_SD bmpDraw bmpSave bpxDraw bpxSave // 1 8960 11784 5130 7469 // 2 7359 9667 4063 6087 // 3 6831 8972 3712 5611 // 4 6559 8694 3531 5378 // 6 6297 8318 3356 5155 // 10 6086 8092 3215 4968 // 15 5979 7879 3143 4875 // 20 5925 7859 3108 4861 // 30 5873 7737 3073 4786 // 50 5831 7695 3043 4748 // 100 5798 7666 3023 4748 // 10 semble une bonne valeur (occupe 20 octets), on ne gagne plus // beaucoup si on "consomme" plus d'octets //########################################################################### //########################################################################### //#### #### //#### Olivier Pécheux #### //#### (33) +6 69 77 82 58 #### //#### http://arduino.dansetrad.fr/PxGraph #### //#### #### //########################################################################### //########################################################################### //########################################################################### //########################################################################### //#### #### //#### Partie 1: Base #### //#### #### //########################################################################### //########################################################################### //########################################################################### //## Constantes ## //########################################################################### //######################## Variables globales: Ecran ######################## extern int _largeur_; // Largeur physique de l'écran extern int _hauteur_; // Hauteur physique de l'écran #define LARGEUR (_largeur_+0) // Largeur de l'écran pour l'utilisateur, lecture seule #define HAUTEUR (_hauteur_+0) #define MAX_X (_largeur_-1) #define MAX_Y (_hauteur_-1) #define DEMI_LARGEUR (_largeur_>>1) #define DEMI_HAUTEUR (_hauteur_>>1) #define PETIT_COTE 240 #define GRAND_COTE 320 extern int _min_x_draw_, _max_x_draw_, _min_y_draw_, _max_y_draw_; // Zone dans laquelle on dessine, voir setLimites() #define MIN_X_DRAW (_min_x_draw_+0) // Voir setLimites, lecture seule #define MAX_X_DRAW (_max_x_draw_+0) #define MIN_Y_DRAW (_min_y_draw_+0) #define MAX_Y_DRAW (_max_y_draw_+0) extern int _min_x_text_, _max_x_text_, _min_y_text_, _max_y_text_; // Zone de texte, normalement MinXDraw... mais remis en cause par les orientations du texte #define MIN_X_TEXT (_min_x_text_+0) // Zone de texte, normalement MIN_X_DRAW... mais remis en cause par les orientations du texte #define MAX_X_TEXT (_max_x_text_+0) // lecture seule #define MIN_Y_TEXT (_min_y_text_+0) #define MAX_Y_TEXT (_max_y_text_+0) extern byte _graphMode_; // PAYSAGE=0 PORTRAIT=1 PORTRAIT_INVERSE=2 PAYSAGE_INVERSE=3 extern word _drawColor_; // Dernière couleur employée pour les dessins extern word _textColor_; // Dernière couleur employée pour les textes extern boolean _drawInverse_; // true pour NORMAL, false pour MODE_INVERSION extern boolean _fillMode_; // true pour COCCINELLE, false pour STAR extern int _textCursorX_; // Coordonnées du point en haut à gauche du caractère à écrire (curseur) extern int _textCursorY_; extern int _textSize_; // Hauteur des caractères=7*textSize environ (certains caractères dépassent) extern int _textBold_; // Nombre de lignes rajoutées extern boolean _textItalic_; // Mode italique, pas top car les cercles restent des cercles et pas des éllipses, mais pas cher extern boolean _textSerif_; // Jambages: un petit trait vers la gauche pour les lignes verticales qui partent d'en haut, // un petit trait de chaque côté en bas pour les lignes qui descendent le plus extern byte _textKeep_; // On ne garde pas le texte si on dépase le bas de l'écran extern byte _textOrient_; // Sens de l'écriture des textes; EST="vers la droite" dans le sens défini par PORTRAIT, PAYSAGE... //################ Définition des couleurs et de leur nombre ################ #define MAX_RED 31 // Rouge va de 0 à 31 #define MAX_GREEN 63 // La définition est plus importante dans le vert #define MAX_BLUE 31 #define MAX_GREY 31 // Mais on aura que 32 gris #define RANDOM_RED (random(27)+5) // RANDOM_RED est une composante rouge quelconque, on évite les noirs #define RANDOM_GREEN (random(54)+10) #define RANDOM_BLUE (random(27)+5) #define RANDOM_GREY (random(27)+5) #define RANDOM_COLOR (RGBcolor(random(27)+5,random(54)+10,random(27)+5)) // RANDOM_COLOR est une couleur quelconque // Couleurs grises #define BLACK 0x0000 // 0,0,0 #define DARK_GREY 0x7BEF // 15,31,15 #define GREY 0xD6FA // 26,55,26 #define LIGHT_GREY 0xF7DE // 31,63,31 #define WHITE 0xFFFF // 31,63,31 // Les 6 couleurs primaires #define RED 0xF800 // 31,0,0 #define GREEN 0x07E0 // 0,63,0 #define BLUE 0x001F // 0,0,31 #define CYAN 0x07FF // 0,63,31 #define MAGENTA 0xF81F // 31,0,31 #define YELLOW 0xFFE0 // 31,63,0 // Les 6 couleurs primaires plus claires #define LIGHT_RED 0xFFBE // 31,61,30 #define LIGHT_GREEN 0xF7FE // 30,63,30 #define LIGHT_BLUE 0xF7BF // 30,61,31 #define LIGHT_CYAN 0xF7FF // 30,63,31 #define LIGHT_MAGENTA 0xFFBF // 31,61,31 #define LIGHT_YELLOW 0xFFFE // 31,63,30 // Les 6 couleurs primaires plus fonçé #define DARK_RED 0xC800 // 25,0,0 #define DARK_GREEN 0x0600 // 0,48,0 #define DARK_BLUE 0x0018 // 0,0,24 #define DARK_CYAN 0x0618 // 0,48,24 #define DARK_MAGENTA 0xC818 // 25,0,24 // Couleurs diverses #define BISQUE 0xF79C // 30,60,28 #define LIME 0xF7E0 // 30,63,0 #define MAROON 0xD000 // 26,0,0 #define OLIVE 0xD5E0 // 26,47,0 #define ORANGE 0xFF20 // 31,57,0 #define DEEP_PINK 0xF81D // 31,0,29 #define ROYAL_BLUE 0xE81F // 29,0,31 #define SEA_GREEN 0x9720 // 18,57,0 #define STEEL_BLUE 0x73D // 0,57,29 //############################# Modes graphiques ############################ #define PAYSAGE 0 // Alimentation à gauche #define PORTRAIT 1 // Alimentation en haut #define PORTRAIT_INVERSE 2 // Alimentation en bas #define PAYSAGE_INVERSE 3 // Alimentation à droite //#################### Directions possibles de l'écriture ################### #define NORD 0x03 #define EST 0x00 #define SUD 0x01 #define OUEST 0x02 //################ Départs et arrivée pour les arcs de cercle ############### #define DEPART_NORD 0x00 #define DEPART_NORD_EST 0x10 #define DEPART_EST 0x20 #define DEPART_SUD_EST 0x30 #define DEPART_SUD 0x40 #define DEPART_SUD_OUEST 0x50 #define DEPART_OUEST 0x60 #define DEPART_NORD_OUEST 0x70 #define ARRIVEE_NORD 0x00 #define ARRIVEE_NORD_EST 0x01 #define ARRIVEE_EST 0x02 #define ARRIVEE_SUD_EST 0x03 #define ARRIVEE_SUD 0x04 #define ARRIVEE_SUD_OUEST 0x05 #define ARRIVEE_OUEST 0x06 #define ARRIVEE_NORD_OUEST 0x07 //################################## Divers ################################# #define NORMAL 0 // false ou 0x00 #define INVERSE true #define BOLD 0xFF #define ITALIC true #define SERIF true #define KEEP 1 #define CUT 2 #define COCCINELLE true #define STAR false //####################### Noms pour les boutons radio ####################### #define BOUTON_0 0 #define BOUTON_1 1 #define BOUTON_2 2 #define BOUTON_3 3 #define BOUTON_4 4 #define BOUTON_5 5 #define BOUTON_6 6 #define BOUTON_7 7 #define BOUTON_8 8 #define BOUTON_9 9 #define GROUPE_0 0 #define GROUPE_1 1 #define GROUPE_2 2 #define GROUPE_3 3 //########################################################################### //## Fonctions utiles ## //########################################################################### //############################# Initialisations ############################# void setGraphMode(byte mode); // Initialisation de l'écran et de son pilote inline byte getGraphMode(void) { return _graphMode_; } // retourne PAYSAGE, PORTRAIT, PORTRAIT_INVERSE ou PAYSAGE_INVERSE void setLimites(int x1 = 0, int y1 = 0, int x2 = 32000, int y2 = 32000); // Limites dans laquelle peuvenr se faire les dessins boolean initSD(void); // Initialise la carte SD si ce n'est pas déja fait word RGBcolor(byte rouge, byte vert, byte bleu); // Transforme le triplet RGB en couleur 16 bits word RGBcolor(byte gris); // Transforme le gris 6 bits en gris 16 bits void setDrawColor(word couleur); // Choisit la couleur utilisée pour dessiner word getDrawColor(void); // Retourne la couleur utilisée pour dessiner void setDrawInverse(boolean mode); // Choisit le mode NORMAL ou INVERSE boolean getDrawInverse(void); // Retourne NORMAL ou INVERSE void clrscr(word couleur = BLACK); // Colorie tout l'écran //################################ Graphiques ############################### void point(int x, int y, word couleur); // Dessine un point aux coordonnés x et y void point(int x, int y); // Dessine un point aux coordonnés x et y word getPoint(int x, int y); // Lit la couleur d'un point de l'écran void fillRect(int x1, int y1, int x2, int y2, word couleur); // Pavé plein; Peut servir pour effacer l'écran void fillRect(int x1, int y1, int x2, int y2); // Pavé plein; Peut servir pour effacer l'écran void hLine(int x1, int x2 , int y, word couleur); // Ligne horizontale. Va plus vite que line dans ce cas void hLine(int x1, int x2 , int y); // Ligne horizontale. Va plus vite que line dans ce cas void vLine(int x, int y1 , int y2, word couleur); // Ligne verticale. Va plus vite que line dans ce cas void vLine(int x, int y1 , int y2); // Ligne verticale. Va plus vite que line dans ce cas void line(int x1, int y1, int x2, int y2, word couleur); // Ligne quelconque qui va de (x1,y1) à (x2,y2) void line(int x1, int y1, int x2, int y2); // Ligne quelconque qui va de (x1,y1) à (x2,y2) void lineTo(int x, int y, word couleur); // Ligne quelconque qui va jusqu'à (x,y) void lineTo(int x, int y); // Ligne quelconque qui va jusqu'à (x,y) void rect(int x1, int y1, int x2, int y2, word couleur); // rect vide, seulement les bords void rect(int x1, int y1, int x2, int y2); // rect vide, seulement les bords void arc(int x, int y, word rayon, byte arc, word couleur); // Tracé de 8ème de cercle void arc(int x, int y, word rayon, byte arc); // Tracé de 8ème de cercle void circle(int x, int y, word rayon, word couleur); // (x,y) est le centre void circle(int x, int y, word rayon); // (x,y) est le centre void fillCircle(int x, int y, word rayon, word couleur); // Cercle plein void fillCircle(int x, int y, word rayon); // Cercle plein void fill(int x, int y, word couleur); // Remplit à partir de (x,y) avec la couleur demandée void setFillMode(boolean mode); // Choisit le type de remplissage boolean getFillMode(void); // Retourne COCCINELLE ou STAR //################################## Textes ################################# void text(String phrase); // Écrit sur l'écran le texte donné avec les paramères initialisés avant; retour à la ligne pour le caractère qui dépasserait void setTextColor(word couleur); // Choisit la couleur du texte word getTextColor(void); // Retourne la couleur du texte void setTextCursor(int x); // Impose l'abscisse du point-curseur texte (point le plus en haut à gauche du prochain caractère) void setTextCursor(int x, int y); // Impose la place du point-curseur texte int getTextCursorX(void); // Retourne l'abscisse du point-curseur texte int getTextCursorY(void); // Retourne l'ordonnée du point-curseur texte void setTextSize(int taille); // Taille des caractères: la hauteur est environ de 7*taille pixels int getTextSize(void); // Retourne la taille des caractères void setTextBold(byte epaisseur); // Gestion des caractères gras ou pas byte getTextBold(void); // Retourne le nombre de traits supplémentaires void setTextItalic(boolean italique); // Choisit droit ou italique boolean getTextItalic(void); // Retourne droit ou italique void setTextSerif(boolean empattement); // Si empattement=true on a des petits traits horizontaux sur cetaines lettres (ABDEFH...) boolean getTextSerif(void); // Retourne true si empattement void setTextOrient(byte orientation); // Sens de l'écriture des textes byte getTextOrient(void); // Retourne le sens de l'écriture des textes void setTextKeep(byte garde); // Permet de garder la page si elle est trop remplie byte getTextKeep(void); // Retourne l'action à faire si le texte déborde int getTextWidth(String phrase); // Retoune la largeur de la phrase en pixels int getTextHeight(void); // Retoune la hauteur de la phrase en pixels //################################## Images ################################# byte bpxDraw(String fileName, int x = -1, int y = -1); // Dessine si il tient entier un bitmap au format .Bpx stocké sur la SD. (x,y) est le point en haut à gauche byte bpxSave(String fileName, int x1 = -1, int y1 = -1, int x2 = -1, int y2 = -1); // Sauve une zone de l'écran sous forme de bitmap .Bxp byte bmpDraw(String fileName, int x = -1, int y = -1); // Dessine si il tient entier un bitmap au format .Bmp stocké sur la SD. (x,y) est le point en haut à gauche byte bmpSave(String fileName, int x1 = -1, int y1 = -1, int x2 = -1, int y2 = -1); // Sauve une zone de l'écran sous forme de bitmap .Bmp void screenPrint(void); // Copie d'écran sur SD //######################### Fonctions de bas niveau ######################### void writeRegister(byte registre); // Valide un registres de l'afficheur void writeData8(byte donnee); // Écrit un octet de donnée dans l'afficheur void writeData16(word donnee); // Écrit un word de donnée dans l'afficheur byte readData8(void); // Lit un byte de donnée de l'afficheur #endif