Forme primitive e testo

Funzioni per creare grafiche primitive (forme e testo)

ellisse(larghezza: float, altezza: float, colore: Colore) → Grafica

Crea un ellisse delle dimensioni indicate, riempito con un colore.

Quando larghezza e altezza coincidono, l’ellisse diventa un cerchio di diametro pari alla dimensione indicata.

Parameters:

  • larghezza – larghezza dell’ellisse, in pixel

  • altezza – altezza dell’ellisse, in pixel

  • colore – colore da usare per riempire l’ellisse

Returns:

una grafica con l’ellisse specificato

grafica_vuota() → Grafica

Crea una grafica vuota. Quando una grafica vuota viene composta con ogni altra grafica, si comporta da elemento neutro: il risultato è sempre uguale all’altra grafica.

Una grafica vuota non può essere visualizzata né salvata.

Returns:

una grafica vuota (larghezza e altezza 0 pixel)

rettangolo(larghezza: float, altezza: float, colore: Colore) → Grafica

Crea un rettangolo delle dimensioni indicate, riempito con un colore.

Parameters:

  • larghezza – larghezza del rettangolo, in pixel

  • altezza – altezza del rettangolo, in pixel

  • colore – colore da usare per riempire il rettangolo

Returns:

una grafica con il rettangolo specificato

settore_circolare(raggio: float, angolo: float, colore: Colore) → Grafica

Crea un settore circolare appartenente a un cerchio del raggio indicato, riempito con un colore.

Un settore circolare è una porzione di cerchio racchiusa tra due raggi e un arco. Considerando il cerchio come un orologio, il primo raggio “punta” in direzione delle ore 3. L’angolo determina la posizione del secondo raggio, calcolata a partire dalla posizione del primo in senso orario.

Parameters:

  • raggio – raggio del cerchio da cui è preso il settore circolare, in pixel

  • angolo – angolo al centro, in gradi

  • colore – colore da usare per riempire il settore circolare

Returns:

una grafica con il settore circolare specificato

testo(contenuto: str, font: str, punti: float, colore: Colore) → Grafica

Crea una grafica con il testo renderizzato usando font, dimensione e colore indicati.

Quando il font True-Type indicato non è disponibile nel sistema, al suo posto viene usato un font estremamente basilare e sempre disponibile. La grafica risultante ha la dimensione minima in modo da racchiudere l’intero testo.

Parameters:

  • contenuto – il testo di cui fare rendering

  • font – il nome del font (ad esempio “arial” su Windows, “Arial” su macOS)

  • punti – dimensione in punti tipografici (ad esempio 16)

  • colore – colore da usare per fare il rendering del testo

Returns:

una grafica con il testo specificato

triangolo(lato: float, colore: Colore) → Grafica

Crea un triangolo equilatero del lato indicato con la punta verso l’alto, riempito con un colore.

Parameters:

  • lato – lunghezza del lato del triangolo, in pixel

  • colore – colore da usare per riempire il triangolo

Returns:

una grafica con il triangolo specificato