Syntaxe :
CIRCLE [FILL] x, y, rayon [{TO | PLOT} angleDepart, etendueAngle]
Description :
Cette commande dessine un cercle, un arc ou un secteur avec la couleur de premier, le motif et la taille courants de la plume. Si un cercle (ou une portion de cercle) est dessiné en utilisant le mot-clé FILL, il sera dessiné avec le motif courant de la plume. La commande CIRCLE peut être utilisée en combinaison avec la commande RATIO pour dessiner des ellipses, des arcs elliptiques ou des portions d’ellipses.
Si le RATIO courant est mis à 0,0 (valeur par défaut), alors CIRCLE se comporte comme suit:
Si, seuls, les paramètres x, y et rayon sont spécifiés, alors un cercle complet est dessiné, ayant son centre au point (x, y) et un rayon de rayon pixels.
Si le mot-clé TO est spécifié, alors une portion est dessinée (deux rayons et un arc). Le premier rayon est dessiné dans l’orientation spécifiée par angleDepart, qui est mesuré en unités “brads” (voir ci-dessous). Les angles sont mesurés dans le sens inverse des aiguilles d’une montre en partant de la position “3 heures”, ce qui correspond à zéro brad. Le paramètre etendueAngle spécifie la largeur angulaire de la portion (en brads également); la portion s’étend toujours dans le sens inverse des aiguilles d’une montre depuis la position angleDepart. Notez que, la largeur d’une portion peut être plus grande qu’un demi-cercle, auquel cas, elle ressemble à un Pac-Man.
Si le mot-clé PLOT est spécifié, alors un arc est dessiné sans les rayons. La position et la taille de l’arc sont les mêmes que lorsque le mot-clé TO est spécifié. Si les mots-clés PLOT et FILL sont tous les deux spécifiés, alors la commande CIRCLE ne fait rien.
Le “brad” est une unité angulaire pour laquelle un cercle entier correspond à 256 brads. Un brad est donc légèrement plus grand qu’un degré (pour être exact, il vaut 360/256 de degré). Un demi-cercle est donc égal à 128 brads, et un angle droit est égal à 64 brads.
Si le RATIO courant est mis à 0,0 (valeur par défaut), alors CIRCLE se comporte comme suit:
Si, seuls, les paramètres x, y et rayon sont spécifiés, alors un cercle complet est dessiné, ayant son centre au point (x, y) et un rayon de rayon pixels.
Si le mot-clé TO est spécifié, alors une portion est dessinée (deux rayons et un arc). Le premier rayon est dessiné dans l’orientation spécifiée par angleDepart, qui est mesuré en unités “brads” (voir ci-dessous). Les angles sont mesurés dans le sens inverse des aiguilles d’une montre en partant de la position “3 heures”, ce qui correspond à zéro brad. Le paramètre etendueAngle spécifie la largeur angulaire de la portion (en brads également); la portion s’étend toujours dans le sens inverse des aiguilles d’une montre depuis la position angleDepart. Notez que, la largeur d’une portion peut être plus grande qu’un demi-cercle, auquel cas, elle ressemble à un Pac-Man.
Si le mot-clé PLOT est spécifié, alors un arc est dessiné sans les rayons. La position et la taille de l’arc sont les mêmes que lorsque le mot-clé TO est spécifié. Si les mots-clés PLOT et FILL sont tous les deux spécifiés, alors la commande CIRCLE ne fait rien.
Le “brad” est une unité angulaire pour laquelle un cercle entier correspond à 256 brads. Un brad est donc légèrement plus grand qu’un degré (pour être exact, il vaut 360/256 de degré). Un demi-cercle est donc égal à 128 brads, et un angle droit est égal à 64 brads.
Exemple :
Exemple CD : Circle.basComportement du runtime Console :
Dans le runtime Console, la commande CIRCLE active toujours la Fenêtre Graphique avant de dessiner. Vous ne pouvez pas utiliser CIRCLE pour dessiner des cercles et des arcs dans la Fenêtre Texte, ou sur l’imprimante; vous pouvez utiliser à la place les procédures de la Toolbox FrameOval, FrameArc ou PaintOval. Comme alternative, vous pouvez activer la Fenêtre Graphique et sélectionner “Imprimer…” depuis le menu “Fichier”.
Note :
Si vous utilisez des valeurs en dehors de la plage 0..255 pour angleDepart et/ou etendueAngle, alors les valeurs modulo 256 seront utilisées.