Klasse StdDraw
Die Klasse bietet verschiedene Methoden an, um Grafikprimitive, und/oder Fotos/Bilder (JPG, PNG) darzustellen und ggf. zu animieren.
Grundlegende Funktionsweise/Zusammenarbeit mit Swing:
Die Zeichenoperationen bleiben im Programmthread. Der EDT kümmert sich um die Swing-Oberfläche, nicht um die Berechnung und Erzeugung grafischer Objekte.
Hinweis: Die Funktionalität und Namenskonventionen dieser Bibliothek orientieren sich an der bewährten "StdLib" der Princeton University (Sedgewick/Wayne), wurden jedoch vollständig neu und modern implementiert.
- Version:
- 1.0 (2026-10-15)
Historie/Updates: Die folgende Dokumentation berichtet auch über Interna, die der Anwender ignorieren kann.
2026-10-10 - (0.1)
- Urversion
2026-10-13 - (0.2)
- Das Laden eines Bildes wurde eliminiert. Das obliegt jetzt ausschließlich
Picture.StdRawarbeitet nur noch mit dessenBufferedImage.
2026-10-15 - (1.0)
-
point(double, double, double, StdColor): 1-Pixel-Fallback für extreme Skalierungen - Zeichenoperationen von Synchronisationsproblemen der gepufferten Images getrennt:
bufferlockund Verlagerung der Anzeige nachCanvas - Linienkorrekturen, sodass jetzt alle Linien in der voreingestellten Stärke korrekt sind:
drawShape(Graphics2D g, Shape shape, double strokeWidth)
als Hilfsmethode.
Bei
executeDrawOperation(g -> {g.setColor(color.getAwtColor());kann dadurch auch der ehedem erste ParameterstrokeWidthentfallen, weil diese Methode die Berechnung der Strichstärke nicht mehr macht. - Polygonzug wird jetzt bei Bedarf geschlossen.
- Ungültige Skalierungsintervalle werden jetzt abgefangen:
validateScale(double min, double max)
- Autor:
- Karsten Brodmann (karsten.brodmann@osnanet.de)
-
Konstruktorübersicht
Konstruktoren -
Methodenübersicht
Modifikator und TypMethodeBeschreibungvoidZeichnet einen Kreis (Umriss).voidclear()Setzt die Leinwand zurück und zeichnet ggf. die Koordinatenachsen, wenn der Schalter gesetzt ist.voiddisplay()Bringt den fertigen Puffer, das im Hintergrund gezeichnete Bild, auf den Bildschirm.voiddisplay(int delay) Kontrolliertes Pausieren (für Animationen).voiddrawPicture(Picture pic) Zeichnet ein übergebenes Picture-Objekt exakt in den weißen Canvas-Bereich.voidZeichnet eine Ellipse (Umriss).voidMalt ein senkrechten Balken zentriert überx.voidfilledCircle(double x, double y, double radius, StdColor color) Malt einen gefüllten Kreis.voidfilledEllipse(double x, double y, double radiusX, double radiusY, StdColor color) Malt eine gefüllte Ellipse.voidMalt ein gefülltes Tortenstück um (x, y).voidfilledPolygon(double[] x, double[] y, StdColor color) Malt ein gefülltes Polygon aus Paaren von (x, y)-Koordinaten.voidfilledRectangle(double x, double y, double w, double h, StdColor color) Malt ein gefülltes Rechteck.voidfilledSquare(double x, double y, double size, StdColor color) Malt ein gefülltes Quadrat.booleanisFrozen()Prüfe, ob Animation eingefroren wurde.voidZeichnet eine Linie.voidLädt ein Foto (auch riesige Kamerabilder), passt sich an eine manuell gesetzte Fenstergröße an und bettet das Foto absolut unverzerrt (proportional) ein.voidpicture(double x, double y, BufferedImage img, double w) Bild im Bild zeichnen: Der Anwender gibt nur die gewünschte Breite (w) vor.voidpie(double x, double y, double radius, double startAngle, double extentAngle, double strokeWidth, StdColor color) Zeichnet ein Tortenstück, Linienzug um (x, y).voidZeichnet einen einzelnen Punkt.voidZeichnet einen Polygonzug (Umriss) aus Paaren von (x, y)-Koordinaten.voidZeichnet ein Rechteck (Umriss).voidsetAutoUpdate(boolean active) Bestimmen, ob Grafiken nach jeder Zeichenoperation neu dargestellt werden.voidsetScale(double min, double max) Quadratische Skalierung.voidsetSize(int newWidth, int newHeight) Ändert die Größe der inneren Zeichenfläche (Canvas) zur Laufzeit.voidTitel des Anzeigefensters ändern.voidsetXScale(double min, double max) X-Skalierung des Fensters.voidsetYScale(double min, double max) Y-Skalierung des Fensters.voidshowAxes(boolean visible) Koordinatenachsen anzeigen.voidshowFrame(boolean visible) Im Standard ist der Rahmen um die Zeichenfläche eingeschaltet und belegt jeweils ein Pixel an den Außenkanten.voidZeichnet ein Quadrat (Umriss).voidAusgabe eines Textes (Zentriert über der mathematischen Koordinate).
-
Konstruktordetails
-
StdDraw
Konstruktor für ein neues Zeichenfenster.- Parameter:
title- Fenstertitel
-
StdDraw
Konstruktor für ein neues Zeichenfenster.- Parameter:
title- FenstertitelcanvasWidth- Breite der ZeichenflächecanvasHeight- Höhe der Zeichenfläche
-
-
Methodendetails
-
setTitle
Titel des Anzeigefensters ändern.- Parameter:
newTitle- neuer Fenstertitel- Löst aus:
IllegalArgumentException- wenn Fenstertitelnull
-
setSize
public void setSize(int newWidth, int newHeight) Ändert die Größe der inneren Zeichenfläche (Canvas) zur Laufzeit. Aktualisiert die Puffer im RAM sofort synchron, um Timing-Fehler zu verhindern.Größenänderungen werden synchron auf dem EDT ausführt.
- Parameter:
newWidth- neue Breite des FensternewHeight- neue Höhe des Fenster
-
loadPictureAndAutoscale
Lädt ein Foto (auch riesige Kamerabilder), passt sich an eine manuell gesetzte Fenstergröße an und bettet das Foto absolut unverzerrt (proportional) ein.- Parameter:
img- Bild (BufferedImage)
-
picture
Bild im Bild zeichnen: Der Anwender gibt nur die gewünschte Breite (w) vor. Die Methode berechnet die passende Höhe (h) vollautomatisch anhand des echten Bild-Seitenverhältnisses. Verzerrung komplett ausgeschlossen!- Parameter:
x- x-Koordinatey- y-Koordinateimg- Bild (BufferedImage)w- gewünschte Breite
-
drawPicture
Zeichnet ein übergebenes Picture-Objekt exakt in den weißen Canvas-Bereich.- Parameter:
pic- Bild
-
showAxes
public void showAxes(boolean visible) Koordinatenachsen anzeigen.Semantik:
showAxes(true)aktiviert die Darstellung der Koordinatenachsen.- Die Achsen verlaufen ausschließlich durch den mathematischen Ursprung (0, 0).
- Liegt die jeweilige Nullkoordinate außerhalb des sichtbaren Koordinatenbereichs, wird die entsprechende Achse nicht gezeichnet.
- Die Achsen werden beim Neuaufbau des Bildes als Hintergrund gezeichnet und können anschließend von Figuren überdeckt werden.
showAxes(false)deaktiviert die Achsendarstellung für nachfolgende Bildaufbauten.
- Parameter:
visible-trueanzeigen,falseausblenden
-
showFrame
public void showFrame(boolean visible) Im Standard ist der Rahmen um die Zeichenfläche eingeschaltet und belegt jeweils ein Pixel an den Außenkanten.showFrame(false)schaltet den Rahmen für den folgenden Bildaufbau aus.- Parameter:
visible-trueAchsen anzeigen, sonstfalse
-
isFrozen
public boolean isFrozen()Prüfe, ob Animation eingefroren wurde.- Gibt zurück:
true, wenn eingefroren, ansonstenfalse
-
setXScale
public void setXScale(double min, double max) X-Skalierung des Fensters. Vorgabe: 0.0 .. 1.0.- Parameter:
min- Minimum von x-Achsemax- Maximum von x-Achse
-
setYScale
public void setYScale(double min, double max) Y-Skalierung des Fensters. Vorgabe: 0.0 .. 1.0.- Parameter:
min- Minimum von y-Achsemax- Maximum von y-Achse
-
setScale
public void setScale(double min, double max) Quadratische Skalierung. Vorgabe: 0.0 .. 1.0.- Parameter:
min- x-/y-Minimummax- x-/y-Maximum
-
setAutoUpdate
public void setAutoUpdate(boolean active) Bestimmen, ob Grafiken nach jeder Zeichenoperation neu dargestellt werden. Tipp: Wenn man die Operationen nicht live mit ansehen möchte, dannfalseeinstellen.- Parameter:
active-true, direkt neu zeichnen,falseabwarten, bisdisplay()aufgerufen wird.
-
display
public void display()Bringt den fertigen Puffer, das im Hintergrund gezeichnete Bild, auf den Bildschirm. -
display
public void display(int delay) Kontrolliertes Pausieren (für Animationen). Blockiert bei ESC dauerhaft.- Parameter:
delay- Wartezeit im Millisekunden
-
clear
public void clear()Setzt die Leinwand zurück und zeichnet ggf. die Koordinatenachsen, wenn der Schalter gesetzt ist.Hinweis: Wenn das Zeichnen des Rahmens aktiviert ist, wird dieser gezeichnet. Er belegt jeweils ein Pixel an den äußeren Rändern. Wenn eine Zeichnung in diesen Bereich zeichnet, wird der Rahmen überschrieben, was zu eventuell weniger schönen Darstellung führt. Wollen Sie den Rahmen jedoch erhalten, so fügen Sie Ihrer Zeichnung am Ende ein entsprechendes Rechteck hinzu, welches den Rahmen über Ihrer eigentlichen Zeichnung neu zeichnet.
-
point
Zeichnet einen einzelnen Punkt.Bei einer Stärke von 0.0 (oder kleiner) wird als Fallback immer ein exakt 1 Pixel großes physisches Bildschirm-Pixel gezeichnet – unabhängig von extremen Achsenskalierungen.
- Parameter:
x- x-Koordinate im mathematischen Systemy- y-Koordinate im mathematischen SystemstrokeWidth- Stiftstärke (Größer als 0.0: skaliert, 0.0: exakt 1 Pixel)color- Farbe
-
line
Zeichnet eine Linie.- Parameter:
x1- x-Startkoordinatey1- y-Startkoordinatex2- x-Endkoordinatey2- y-EndkoordinatestrokeWidth- Stiftstärkecolor- Farbe
-
ellipse
public void ellipse(double x, double y, double radiusX, double radiusY, double strokeWidth, StdColor color) Zeichnet eine Ellipse (Umriss).- Parameter:
x- x-Koordinate des Zentrumsy- y-Koordinate des ZentrumsradiusX- x-RadiusradiusY- y-RadiusstrokeWidth- Stiftstärkecolor- Farbe
-
circle
Zeichnet einen Kreis (Umriss).- Parameter:
x- x-Koordinate des Zentrumsy- y-Koordinate des Zentrumsradius- RadiusstrokeWidth- Stiftstärkecolor- Farbe
-
rectangle
Zeichnet ein Rechteck (Umriss).- Parameter:
x- x-Koordinate links unteny- y-Koordinate links untenw- Breiteh- HöhestrokeWidth- Stiftstärkecolor- Farbe
-
square
Zeichnet ein Quadrat (Umriss).- Parameter:
x- x-Koordinate links unteny- y-Koordinate links untensize- KantenlängestrokeWidth- Stiftstärkecolor- Farbe
-
polygon
Zeichnet einen Polygonzug (Umriss) aus Paaren von (x, y)-Koordinaten.- Parameter:
x- Array der x-Koordinateny- Array der y-Koordinatenclosed-truegeschlossen,falseoffenstrokeWidth- Stiftstärkecolor- Farbe
-
pie
public void pie(double x, double y, double radius, double startAngle, double extentAngle, double strokeWidth, StdColor color) Zeichnet ein Tortenstück, Linienzug um (x, y).- Parameter:
x- x-Koordinatey- y-Koordinateradius- RadiusstartAngle- StartwinkelextentAngle- RotationswinkelstrokeWidth- Strichstärkecolor- Farbe
-
filledEllipse
Malt eine gefüllte Ellipse.- Parameter:
x- x-Koordinate des Zentrumsy- y-Koordinate des ZentrumsradiusX- x-RadiusradiusY- y-Radiuscolor- Farbe
-
filledCircle
Malt einen gefüllten Kreis.- Parameter:
x- x-Koordinate des Zentrumsy- y-Koordinate des Zentrumsradius- Radiuscolor- Farbe
-
filledRectangle
Malt ein gefülltes Rechteck.- Parameter:
x- x-Koordinate links unteny- y-Koordinate links untenw- Breiteh- Höhecolor- Farbe
-
filledSquare
Malt ein gefülltes Quadrat.- Parameter:
x- x-Koordinate links unteny- y-Koordinate links untensize- Kantenlängecolor- Farbe
-
filledPolygon
Malt ein gefülltes Polygon aus Paaren von (x, y)-Koordinaten.- Parameter:
x- Array der x-Koordinateny- Array der y-Koordinatencolor- Farbe
-
filledPie
public void filledPie(double x, double y, double radius, double startAngle, double extentAngle, StdColor color) Malt ein gefülltes Tortenstück um (x, y).- Parameter:
x- x-Koordinatey- y-Koordinateradius- RadiusstartAngle- StartwinkelextentAngle- Rotationswinkelcolor- Farbe
-
filledBar
Malt ein senkrechten Balken zentriert überx.- Parameter:
x- x-Koordinate links unteny- y-Koordinate links untenwidth- Breiteheight- Höhecolor- Farbe
-
text
-