Klasse StdDraw

java.lang.Object
StdLib.StdDraw

public class StdDraw extends Object
Abstraktion für grafische Ausgaben.

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. StdRaw arbeitet nur noch mit dessen BufferedImage.

2026-10-15 - (1.0)

  • point(double, double, double, StdColor): 1-Pixel-Fallback für extreme Skalierungen
  • Zeichenoperationen von Synchronisationsproblemen der gepufferten Images getrennt: bufferlock und Verlagerung der Anzeige nach Canvas
  • 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 Parameter strokeWidth entfallen, 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
    Konstruktor
    Beschreibung
    StdDraw(String title)
    Konstruktor für ein neues Zeichenfenster.
    StdDraw(String title, int canvasWidth, int canvasHeight)
    Konstruktor für ein neues Zeichenfenster.
  • Methodenübersicht

    Modifikator und Typ
    Methode
    Beschreibung
    void
    circle(double x, double y, double radius, double strokeWidth, StdColor color)
    Zeichnet einen Kreis (Umriss).
    void
    Setzt die Leinwand zurück und zeichnet ggf. die Koordinatenachsen, wenn der Schalter gesetzt ist.
    void
    Bringt den fertigen Puffer, das im Hintergrund gezeichnete Bild, auf den Bildschirm.
    void
    display(int delay)
    Kontrolliertes Pausieren (für Animationen).
    void
    Zeichnet ein übergebenes Picture-Objekt exakt in den weißen Canvas-Bereich.
    void
    ellipse(double x, double y, double radiusX, double radiusY, double strokeWidth, StdColor color)
    Zeichnet eine Ellipse (Umriss).
    void
    filledBar(double x, double y, double width, double height, StdColor color)
    Malt ein senkrechten Balken zentriert über x.
    void
    filledCircle(double x, double y, double radius, StdColor color)
    Malt einen gefüllten Kreis.
    void
    filledEllipse(double x, double y, double radiusX, double radiusY, StdColor color)
    Malt eine gefüllte Ellipse.
    void
    filledPie(double x, double y, double radius, double startAngle, double extentAngle, StdColor color)
    Malt ein gefülltes Tortenstück um (x, y).
    void
    filledPolygon(double[] x, double[] y, StdColor color)
    Malt ein gefülltes Polygon aus Paaren von (x, y)-Koordinaten.
    void
    filledRectangle(double x, double y, double w, double h, StdColor color)
    Malt ein gefülltes Rechteck.
    void
    filledSquare(double x, double y, double size, StdColor color)
    Malt ein gefülltes Quadrat.
    boolean
    Prüfe, ob Animation eingefroren wurde.
    void
    line(double x1, double y1, double x2, double y2, double strokeWidth, StdColor color)
    Zeichnet eine Linie.
    void
    Lädt ein Foto (auch riesige Kamerabilder), passt sich an eine manuell gesetzte Fenstergröße an und bettet das Foto absolut unverzerrt (proportional) ein.
    void
    picture(double x, double y, BufferedImage img, double w)
    Bild im Bild zeichnen: Der Anwender gibt nur die gewünschte Breite (w) vor.
    void
    pie(double x, double y, double radius, double startAngle, double extentAngle, double strokeWidth, StdColor color)
    Zeichnet ein Tortenstück, Linienzug um (x, y).
    void
    point(double x, double y, double strokeWidth, StdColor color)
    Zeichnet einen einzelnen Punkt.
    void
    polygon(double[] x, double[] y, boolean closed, double strokeWidth, StdColor color)
    Zeichnet einen Polygonzug (Umriss) aus Paaren von (x, y)-Koordinaten.
    void
    rectangle(double x, double y, double w, double h, double strokeWidth, StdColor color)
    Zeichnet ein Rechteck (Umriss).
    void
    setAutoUpdate(boolean active)
    Bestimmen, ob Grafiken nach jeder Zeichenoperation neu dargestellt werden.
    void
    setScale(double min, double max)
    Quadratische Skalierung.
    void
    setSize(int newWidth, int newHeight)
    Ändert die Größe der inneren Zeichenfläche (Canvas) zur Laufzeit.
    void
    setTitle(String newTitle)
    Titel des Anzeigefensters ändern.
    void
    setXScale(double min, double max)
    X-Skalierung des Fensters.
    void
    setYScale(double min, double max)
    Y-Skalierung des Fensters.
    void
    showAxes(boolean visible)
    Koordinatenachsen anzeigen.
    void
    showFrame(boolean visible)
    Im Standard ist der Rahmen um die Zeichenfläche eingeschaltet und belegt jeweils ein Pixel an den Außenkanten.
    void
    square(double x, double y, double size, double strokeWidth, StdColor color)
    Zeichnet ein Quadrat (Umriss).
    void
    text(double x, double y, String text, int pt, StdColor color)
    Ausgabe eines Textes (Zentriert über der mathematischen Koordinate).

    Von Klasse geerbte Methoden Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Konstruktordetails

    • StdDraw

      public StdDraw(String title)
      Konstruktor für ein neues Zeichenfenster.
      Parameter:
      title - Fenstertitel
    • StdDraw

      public StdDraw(String title, int canvasWidth, int canvasHeight)
      Konstruktor für ein neues Zeichenfenster.
      Parameter:
      title - Fenstertitel
      canvasWidth - Breite der Zeichenfläche
      canvasHeight - Höhe der Zeichenfläche
  • Methodendetails

    • setTitle

      public void setTitle(String newTitle)
      Titel des Anzeigefensters ändern.
      Parameter:
      newTitle - neuer Fenstertitel
      Löst aus:
      IllegalArgumentException - wenn Fenstertitel null
    • 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 Fenster
      newHeight - neue Höhe des Fenster
    • loadPictureAndAutoscale

      public void loadPictureAndAutoscale(BufferedImage img)
      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

      public void picture(double x, double y, BufferedImage img, double w)
      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-Koordinate
      y - y-Koordinate
      img - Bild (BufferedImage)
      w - gewünschte Breite
    • drawPicture

      public void drawPicture(Picture pic)
      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 - true anzeigen, false ausblenden
    • 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 - true Achsen anzeigen, sonst false
    • isFrozen

      public boolean isFrozen()
      Prüfe, ob Animation eingefroren wurde.
      Gibt zurück:
      true, wenn eingefroren, ansonsten false
    • setXScale

      public void setXScale(double min, double max)
      X-Skalierung des Fensters. Vorgabe: 0.0 .. 1.0.
      Parameter:
      min - Minimum von x-Achse
      max - 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-Achse
      max - Maximum von y-Achse
    • setScale

      public void setScale(double min, double max)
      Quadratische Skalierung. Vorgabe: 0.0 .. 1.0.
      Parameter:
      min - x-/y-Minimum
      max - 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, dann false einstellen.
      Parameter:
      active - true, direkt neu zeichnen, false abwarten, bis display() 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

      public void point(double x, double y, double strokeWidth, StdColor color)
      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 System
      y - y-Koordinate im mathematischen System
      strokeWidth - Stiftstärke (Größer als 0.0: skaliert, 0.0: exakt 1 Pixel)
      color - Farbe
    • line

      public void line(double x1, double y1, double x2, double y2, double strokeWidth, StdColor color)
      Zeichnet eine Linie.
      Parameter:
      x1 - x-Startkoordinate
      y1 - y-Startkoordinate
      x2 - x-Endkoordinate
      y2 - y-Endkoordinate
      strokeWidth - Stiftstärke
      color - 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 Zentrums
      y - y-Koordinate des Zentrums
      radiusX - x-Radius
      radiusY - y-Radius
      strokeWidth - Stiftstärke
      color - Farbe
    • circle

      public void circle(double x, double y, double radius, double strokeWidth, StdColor color)
      Zeichnet einen Kreis (Umriss).
      Parameter:
      x - x-Koordinate des Zentrums
      y - y-Koordinate des Zentrums
      radius - Radius
      strokeWidth - Stiftstärke
      color - Farbe
    • rectangle

      public void rectangle(double x, double y, double w, double h, double strokeWidth, StdColor color)
      Zeichnet ein Rechteck (Umriss).
      Parameter:
      x - x-Koordinate links unten
      y - y-Koordinate links unten
      w - Breite
      h - Höhe
      strokeWidth - Stiftstärke
      color - Farbe
    • square

      public void square(double x, double y, double size, double strokeWidth, StdColor color)
      Zeichnet ein Quadrat (Umriss).
      Parameter:
      x - x-Koordinate links unten
      y - y-Koordinate links unten
      size - Kantenlänge
      strokeWidth - Stiftstärke
      color - Farbe
    • polygon

      public void polygon(double[] x, double[] y, boolean closed, double strokeWidth, StdColor color)
      Zeichnet einen Polygonzug (Umriss) aus Paaren von (x, y)-Koordinaten.
      Parameter:
      x - Array der x-Koordinaten
      y - Array der y-Koordinaten
      closed - true geschlossen, false offen
      strokeWidth - Stiftstärke
      color - 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-Koordinate
      y - y-Koordinate
      radius - Radius
      startAngle - Startwinkel
      extentAngle - Rotationswinkel
      strokeWidth - Strichstärke
      color - Farbe
    • filledEllipse

      public void filledEllipse(double x, double y, double radiusX, double radiusY, StdColor color)
      Malt eine gefüllte Ellipse.
      Parameter:
      x - x-Koordinate des Zentrums
      y - y-Koordinate des Zentrums
      radiusX - x-Radius
      radiusY - y-Radius
      color - Farbe
    • filledCircle

      public void filledCircle(double x, double y, double radius, StdColor color)
      Malt einen gefüllten Kreis.
      Parameter:
      x - x-Koordinate des Zentrums
      y - y-Koordinate des Zentrums
      radius - Radius
      color - Farbe
    • filledRectangle

      public void filledRectangle(double x, double y, double w, double h, StdColor color)
      Malt ein gefülltes Rechteck.
      Parameter:
      x - x-Koordinate links unten
      y - y-Koordinate links unten
      w - Breite
      h - Höhe
      color - Farbe
    • filledSquare

      public void filledSquare(double x, double y, double size, StdColor color)
      Malt ein gefülltes Quadrat.
      Parameter:
      x - x-Koordinate links unten
      y - y-Koordinate links unten
      size - Kantenlänge
      color - Farbe
    • filledPolygon

      public void filledPolygon(double[] x, double[] y, StdColor color)
      Malt ein gefülltes Polygon aus Paaren von (x, y)-Koordinaten.
      Parameter:
      x - Array der x-Koordinaten
      y - Array der y-Koordinaten
      color - 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-Koordinate
      y - y-Koordinate
      radius - Radius
      startAngle - Startwinkel
      extentAngle - Rotationswinkel
      color - Farbe
    • filledBar

      public void filledBar(double x, double y, double width, double height, StdColor color)
      Malt ein senkrechten Balken zentriert über x.
      Parameter:
      x - x-Koordinate links unten
      y - y-Koordinate links unten
      width - Breite
      height - Höhe
      color - Farbe
    • text

      public void text(double x, double y, String text, int pt, StdColor color)
      Ausgabe eines Textes (Zentriert über der mathematischen Koordinate).
      Parameter:
      x - x-Position im mathematischen System
      y - y-Position im mathematischen System
      text - Text
      pt - Punktgröße des Fonts
      color - Farbe