vLine()

Dessine une droite verticale

Exemples d'utilisation

vLine(MAX_X/2, 0, MAX_Y); // Dessine une droite verticale au milieu
vLine(random(LARGEUR), random(HAUTEUR), random(HAUTEUR), RANDOM_COLOR); // Droite verticale quelconque
vLine(100, 500, 600); // Ne trace rien, y est trop grand
setLimites(10, 10, 20, 20); vLine(15, 30, 40); // Ne trace rien (en dehors de limites)
setLimites(10, 10, 20, 20); vLine(15, 10, 40); // Identique à vLine(15, 10, 20);

Référence

void vLine(int x, int y1 ,int y2, word couleur);
void vLine(int x, int y1 ,int y2);

Paramètres passés

x: abscisse de la ligne
y1, y2: ordonnés des extrémités
couleur: couleur de la droite, voir BLACK, WHITE, ... ou RGBcolor

Valeur retournée

Aucune

Voir aussi

- hLine(); Trace une ligne horizontale
- line(); Trace une ligne
- lineTo(); Trace une ligne qui part de la dernière ligne tracée
- setLimites(); Limite la zone de dessin
- rect(); Trace les bords d'un cadre
- fillRect(); Trace une boîte pleine
- RGBcolor(); Transforme un triplet RGB en un code couleur
- MAX_X, MAX_Y... Valeurs des coordonnés graphiques
- BLACK, WHITE, ... Constantes couleurs
- setDrawInverse(); Choix du mode dessin ou inversion
- point(); Dessine un point
- circle(); Trace un cercle
- text(); Écrit du texte

Notes

En mode NORMAL, dessine la droite verticale avec la couleur spécifiée si présente, ou avec la dernière couleur utilisée par point(), rect(), circle(),... si le paramètre couleur n'est pas passé. La nouvelle couleur est mémorisée pour les prochains tracés graphiques. En mode INVERSE, cette fonction inverse la couleur sans tenir compte de la couleur éventuellement passée en paramètre; la nouvelle couleur de la droite n'est pas mémorisée.

Il est plus rapide et le code est plus optimisé, de tracer des verticales ou des horizontales par les procédures adéquates que de les dessiner avec line().

N'est dessiné que la partie qui tient dans les limites données par la fonction setLimites() (tout l'écran par défaut).

Exemple

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

// Ce programme dessine des lignes horizontales. Pour qu'il n'y en ait pas trop, il dessine
// aussi des lignes noires, ce qui "efface" les lignes colorées en trop.
 
#
  $menu = ":PG";
  include <PecheuxGraph_ILI9341_8bits.h>
void setup() 
{
  setGraphMode(PAYSAGE);
}

void loop()
{
  vLine(random(LARGEUR),random(HAUTEUR),random(HAUTEUR),RANDOM_COLOR); // Trace des lignes
  vLine(random(LARGEUR),0,MAX_Y,BLACK); // Efface des lignes
  delay(100); // Attendre un peu ne fait pas de mal 
}

Résultat:

Côté technique

Pour dessiner des lignes verticales, on définit des limites et on remplit cette zone en envoyant le mot de la couleur sans rappeler les coordonnés. Pour dessiner une droite quelconque, il faut calculer la position du prochain point, demander à restreindre la zone et envoyer la donnée. Beaucoup de calculs et de repositionnement ralentissent le programme. Tracer une droite horizontale va donc beaucoup plus vite.