"""
Funktionen zum Erzeugen primitiver Grafiken (Figuren und Texte).
Falls nicht anders angegeben befindet sich die Fixierposition
in der Mitte des Begrenzungsrahmens der erzeugten Grafik.
"""
from __future__ import annotations
import pytamaro as _pytamaro
from pytamaro.de.color import Farbe
from pytamaro.de.graphic import Grafik
[docs]
def rechteck(breite: float, hoehe: float, farbe: Farbe) -> Grafik:
"""
Erzeugt ein Rechteck mit der gegebenen Breite und Höhe,
gefüllt in der gegebenen Farbe.
:param breite: die Breite des Rechtecks
:param hoehe: die Höhe des Rechtecks
:param farbe: Füllfarbe des Rechtecks
:returns: eine Grafik mit dem gegebenen Rechteck
"""
return _pytamaro.rectangle(breite, hoehe, farbe)
[docs]
def leere_grafik() -> Grafik:
"""
Erzeugt eine leere Grafik.
Wenn eine leere Grafik mit einer anderen Grafik kombiniert wird
verhält sie sich als neutrales Element:
das Ergebnis der Komposition ist einfach gleich der anderen Grafik.
:returns: eine leere Grafik (Breite und Höhe sind 0)
"""
return _pytamaro.empty_graphic()
[docs]
def ellipse(breite: float, hoehe: float, farbe: Farbe) -> Grafik:
"""
Erzeugt eine Ellipse mit der gegebenen Breite und Höhe,
gefüllt in der gegebenen Farbe.
Wenn Breite und Höhe gleich gross sind wird die Ellipse zum Kreis
mit dem entsprechenden Durchmesser.
:param breite: Breite der Ellipse
:param hoehe: Höhe der Ellipse
:param farbe: Füllfarbe der Ellipse
:returns: eine Grafik mit der gegebenen Ellipse
"""
return _pytamaro.ellipse(breite, hoehe, farbe)
[docs]
def kreis_sektor(radius: float, winkel: float, farbe: Farbe) -> Grafik:
"""
Erzeugt einen Kreissektor mit dem gegebenen Radius,
der den gegebenen Winkel umspannt,
gefüllt in der gegebenen Farbe.
Ein Kreissektor ist ein Teil eines Kreises
begrenzt durch zwei Radien und einen Bogen.
Wenn man den Kreis als Uhr betrachtet
dann zeigt der erste Radius in Richtung 3 Uhr.
Der Winkel bestimmt die Position des zweiten Radius,
ausgehend vom ersten Radius im Gegenuhrzeigersinn.
Ein Winkel von 360 Grad entspricht einem ganzen Kreis.
Die Fixierposition liegt in der Mitte des Kreises,
aus dem der Kreissektor ausgeschnitten wurde.
:param radius: Kreisradius
:param winkel: Winkel des Sektors, in Grad
:param farbe: Füllfarbe des Kreissektors
:returns: eine Grafik mit dem gegebenen Kreissektor
"""
return _pytamaro.circular_sector(radius, winkel, farbe)
[docs]
def dreieck(seite1: float, seite2: float, winkel: float, farbe: Farbe) -> Grafik:
"""
Erzeugt ein Dreieck mit den gegebenen Seitenlängen und dem gegebenen Winkel,
gefüllt in der gegebenen Farbe.
Die erste Seite verläuft horizontal nach rechts. Die zweite Seite verläuft
vom linken Endpunkt der ersten Seite aus, gedreht gegen den Uhrzeigersinn um
den gegebenen Winkel. Dieser Punkt befindet sich unten links in der Grafik,
es sei denn, der gegebene Winkel beträgt mehr als 90 Grad.
Die Fixierposition liegt auf dem Schwerpunkt des Dreiecks.
:param seite1: Länge der ersten, horizontalen Seite
:param seite2: Länge der zweiten Seite
:param winkel: Winkel von der ersten zu der zweiten Seiten, in Grad
:param farbe: Farbe des Dreiecks
:returns: eine Grafik mit dem gegebenen Dreieck
"""
return _pytamaro.triangle(seite1, seite2, winkel, farbe)
[docs]
def text(inhalt: str, schriftart: str, punkte: float, farbe: Farbe) -> Grafik:
"""
Erzeugt einen Text in der gegebenen Schriftart und Schriftgrösse,
gefüllt in der gegebenen Farbe.
Falls für die gegebene Schriftart auf dem System keine True-Type Schrift
zur Verfügung steht, wird eine einfache Standardschriftart verwendet.
Die resultierende Grafik hat die minimale Grösse,
die den gesamten Text umschliesst.
Die Fixierposition liegt auf der linken Kante des Begrenzungsrahmens,
auf der Höhe der Grundlinie des Textes.
:param inhalt: der Text, der dargestellt werden soll
:param schriftart: der Name der Schriftart
(zum Beispiel "Arial" oder "Fira Sans")
:param punkte: Schriftgrösse in typografischen Punkten (zum Beispiel 16)
:param farbe: Farbe, in der der Text dargestellt werden soll
:returns: eine Grafik bestehend aus dem gegebenen Text
"""
return _pytamaro.text(inhalt, schriftart, punkte, farbe)