Formes primitives et texte

Fonctions pour créer des graphiques primitifs (formes et texte). À moins d’être spécifié autrement, le point d’ancrage initial est le centre du cadre de délimitation (bounding box) du graphique.

ellipse(largeur: float, hauteur: float, couleur: Color) → Graphic

Créé une ellipse avec les dimensions indiquées et rempli avec la couleur donnée.

Lorsque la largeur et la hauteur coïncident, l’ellipse devient un cercle dont le diamètre est égal à la taille indiquée.

Parameters:

• largeur – largeur de l’ellipse

• hauteur – hauteur de l’ellipse

• couleur – couleur à utiliser pour remplir l’ellipse

Returns:

un graphique avec l’ellipse spécifié

graphique_vide() → Graphic

Créé un graphique vide. Quand un graphique vide est composé avec n’importe quel autre graphique, il se comporte comme l’élément neutre: le résultat est toujours égal à l’autre graphique.

Returns:

un graphique vide (largeur et hauteur 0)

rectangle(largeur: float, hauteur: float, couleur: Color) → Graphic

Créé un rectangle de dimensions indiquées et rempli avec la couleur donnée.

Parameters:

• largeur – largeur du rectangle

• hauteur – hauteur du rectangle

• couleur – couleur qui remplira le rectangle

Returns:

un graphique avec le rectangle spécifié

secteur_circulaire(rayon: float, angle: float, couleur: Color) → Graphic

Crée un secteur circulaire appartenant à un cercle du rayon indiqué, rempli d’une couleur.

Un secteur circulaire est une portion de cercle comprise entre deux rayons et un arc. Si l’on considère le cercle comme une horloge, le premier rayon “pointe” dans la direction de 3 heures. L’angle détermine la position du deuxième rayon, calculée à partir de la position du premier rayon dans le sens inverse des aiguilles d’une montre. Un angle de 360 degrés correspond à un cercle complet.

Le point d’ancrage se trouve au centre du cercle à partir duquel le secteur circulaire est pris.

Parameters:

• rayon – rayon du cercle duquel est pris le secteur circulaire

• angle – angle au centre, en degrés

• couleur – couleur à utiliser pour remplir le secteur circulaire

Returns:

un graphique avec le secteur circulaire spécifié

texte(contenu: str, police: str, points: float, couleur: Color) → Graphic

Crée un graphique avec le texte rendu à l’aide de la police, de la taille et de la couleur spécifiées.

Lorsque la police True-Type indiquée n’est pas disponible dans le système, une police très basilaire toujours disponible est utilisée à la place. Le graphique qui en résulte a la taille minimale nécessaire pour contenir l’ensemble du texte.

La point d’ancrage est alignée horizontalement sur la gauche et verticalement sur la ligne de base du texte.

Parameters:

• contenu – le texte à présenter

• font – le nom de la police (par exemple, “arial” sous Windows, “Arial” sous macOS)

• points – la taille en points typographiques (par exemple, 16)

• couleur – la couleur à utiliser pour le rendu du texte

Returns:

le texte spécifié sous forme de graphique

triangle(cote1: float, cote2: float, angle: float, couleur: Color) → Graphic

Crée un triangle en spécifiant deux côtés et l’angle qui les sépare, remplis d’une couleur. Le premier côté s’étend horizontalement vers la droite. L’angle spécifie la rotation du deuxième côté, dans le sens inverse des aiguilles d’une montre, par rapport au premier.

Pour tous les triangles, à l’exception des triangles obtus, le point inférieur gauche du graphique résultant coïncide avec le sommet du triangle dont l’angle a été spécifié.

Le point d’ancrage est le centroïde du triangle.

Parameters:

• cote1 – longueur du premier côté (horizontal) du triangle

• cote2 – longueur du second côté du triangle

• angle – angle compris entre les deux côté, en degrés

• couleur – couleur à utiliser pour remplir le secteur circulaire

Returns:

un graphique avec le triangle spécifié