# Documentation de p5Visuel

## par André Boileau

## Catégorie : p5.js

Voyons comment se déroule l'exécution d'un programme p5Visuel. Quand on clique sur le bouton Exécuter, certaines actions de préparation sont d'abord exécutées (dont la fonction avant de commencer, si elle est présente), puis la fonction actions initiales est appelée. Par la suite, la fonction actions en boucle est appelée jusqu'à 60 fois par seconde.
En fait, la fonction actions en boucle peut être appelée moins de 60 fois par seconde si l'ordinateur n'est pas assez rapide pour l'exécuter aussi souvent en une seconde. Elle peut aussi être appelée à un rythme moins grand, dicté par le bloc vitesse de la boucle. Elle peut enfin être appelée une seule fois, si le bloc 'actions en boucle' appelée une seule fois a été activé.

#### Marge gauche

Paramètres
• une valeur marge (0 ci-dessus, mais qui peut être une expression numérique quelconque)
Fonctionnement
• spécifie que la page web créée lors de l'exécution aura une marge gauche de marge pixels
Remarques
• sans un appel à ce bloc, la marge gauche de la page web sera de zéro pixels, ce qui n'est pas très esthétique

#### Dimensions canvas

Paramètres
• une valeur horiz (800 ci-dessus, mais qui peut être une expression numérique quelconque)
• une valeur vert (600 ci-dessus, mais qui peut être une expression numérique quelconque)
Fonctionnement
• crée un canvas dont les dimensions sont spécifiées (en pixels)
Note : le canvas est la zone où p5Visuel trace tous ses graphiques
Remarques
• p5Visuel ne peut utiliser qu'un seul canvas :
si le présent bloc est utilisé plus d'une fois dans un programme, le résultat sera imprévisible...

#### Largeur du canvas

Paramètres : aucun
Fonctionnement
• retourne la largeur du canvas (en pixels)

#### Hauteur du canvas

Paramètres : aucun
Fonctionnement
• retourne la hauteur du canvas (en pixels)

#### Enregistrer l'image du canvas

Paramètres : aucun
Fonctionnement
• enregistre l'image contenue dans le canvas
Remarques
• le fichier image est placé à l'endroit spécifié dans les préférences du navigateur web

#### Pas de canvas

Paramètres : aucun
Fonctionnement
• ce bloc était présent dans les versions préliminaires de p5Visuel, mais il n'est plus utilisé maintenant

#### La fonction actions en boucles n'est appelée qu'une fois (ne boucle pas)

Paramètres : aucun
Fonctionnement
• en fonctionnement normal, p5Visuel tente d'appeler la fonction actions en boucle soixante fois par seconde
• ce bloc demande à p5Visuel de n'appeler la fonction actions en boucle qu'une seule fois, après l'exécution de la
fonction actions initiales

#### Fréquence des appels à la fonction actions en boucles

Paramètres
• une valeur rythme (60 ci-dessus, mais qui peut être une expression numérique quelconque)
Fonctionnement
• en fonctionnement normal, p5Visuel tente d'appeler la fonction actions en boucle soixante fois par seconde
• ce bloc demande à p5Visuel d'appeler la fonction en question rythme fois par seconde
Remarques
• rythme doit être un entier positif inférieur à 60

#### Expression p5

Paramètres
• une valeur expression (vide ci-dessus, mais qui peut être une expression textuelle quelconque)
Fonctionnement
• évalue une expression JavaScript (pouvant contenir des éléments de p5.js) et retourne le résultat obtenu
Remarques
• pour les utilisateurs plus avancés

#### Commande p5

Paramètres
• une valeur commande (vide ci-dessus, mais qui peut être une expression textuelle quelconque)
Fonctionnement
• exécute une commande JavaScript (pouvant contenir des éléments de p5.js)
Remarques
• pour les utilisateurs plus avancés