getTextCursor()

Récupère l'ordonnée du curseur texte

Exemples d'utilisation

if (getTextCursorY()==0) text("On est en haut");

Référence

int getTextCursorY(void);

Paramètre passé

Aucun

Valeur retournée

ordonnée du point-curseur

Voir aussi

- setTextCursor(); Fixe les coordonnés le point-curseur texte
- getTextCursorX(); Retourne l'abscisse du point-curseur texte
- textCursorX; Contient l'abscisse du point-curseur texte
- textCursorY; contient l'ordonnée du point-curseur texte
- Fonte vectorielle Définition de la fonte utilisée
- text(); Écrit du texte
- setTextSize(); Taille des caractères
- setTextBold(); Gras ou normal
- setTextItalic(); Italique ou normal
- setTextSerif(); Avec ou sans empattement
- setTextCursor(); Direction d'écriture des textes
- setTextKeep(); Choisit l'action si le texte déborde
- getTextWidth(); getTextHeight(); Retourne la taille de l'écriture de la chaine passée

Notes

Le curseur texte est le point le plus en haut à gauche qui sera utilisé lors de la prochaine écriture. Après une écriture, il est positionné après le dernier caractère écrit, augmenté de l'espace inter caractère. L'espace ainsi laissé est de "taille" pixels (2 pixels par défaut, la taille étant 2). L'espace entre deux lignes est le double (parfois un peu moins car certains jambages dépassent de la matrice).

L'origine de l'écran est, comme pour le mode dessin, en haut à gauche. Les abscisses sont croissantes vers la droite et les ordonnées vers le bas. Si on fait pivoter le système d'écriture par la fonction setTextOrient(), cela fait aussi pivoter les axes définissant le curseur.

L'ordonnée du curseur se lire par la fonction getTextCursorY() ou grâce à la variable textCursorY. C'est mieux de passer par les fonctions, mais utiliser par les variables nécessite moins d'octets dans un contexte de carte Uno, c'est une économie.

Les coordonnés du curseur dépendent de la taille de l'écran, du mode paysage ou portrait et du sens de l'écriture. Si l'écriture se fait vers l'ouest, le point de coordonné (0,0) est en bas à droite. Ne pas confondre le mode PAYSAGE, PORTAIT, qui réinitialise l'écran et impose les directions pour les graphiques et dans un premier temps pour les texte, avec les directions d'écriture qui peuvent être choisi pour chaque affichage. On ne peut pas être en PORTRAIT et PAYSAGE en même temps, alors qu'on peut avoir des affichages vers l'est et vers le nord en même temps.

Exemple

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

// Avec getTextCursorX() et getTextCursorY(), on peut savoir où écrire le prochain caractère.
// Pour faire un smile par exemple

#include <PecheuxGraph_ILI9341_8bits.h>
void setup() 
{
  setGraphMode(PAYSAGE); // Initialisation générale
  
  for (char c=0x20; c<0x7F; c++) text(String(c)); // Ecriture de texte. On ne sait plus ou l'on est
  
  circle(getTextCursorX()+7,getTextCursorY()+6,6,GREEN); // Tracé d'un objet, ce pourrait être une icône
  point(getTextCursorX()+7,getTextCursorY()+6); // le nez
  point(getTextCursorX()+4,getTextCursorY()+4); // Un œuil
  point(getTextCursorX()+10,getTextCursorY()+4); // L'autre
  hLine(getTextCursorX()+5,getTextCursorX()+9,getTextCursorY()+9); // La bouche
}

void loop()
{
}

Résultat: