Package de.pirckheimer_gymnasium.engine_pi.little_engine

Class Turtle

java.lang.Object
de.pirckheimer_gymnasium.engine_pi.little_engine.Turtle
public class Turtle extends Object
Eine Schildkröte auf der Zeichenfläche.
Version:
1.0
Author:
Albert Wiedemann

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    String
    color
    Die Farbe der Schildkröte.
    boolean
    penDown
    Die Stiftposition.
    int
    rotation
    Der Drehwinkel (mathemtisch positiver Drehsinn) der Schildkröte in Grad.
    int
    size
    Die Größe der Schildkröte.
    boolean
    visible
    Die Sichtbarkeit der Schildkröte.
    int
    x
    Die x-Position der Schildkröte.
    int
    y
    Die y-Position der Schildkröte.

  • Constructor Summary

    Constructors
    Constructor
    Description
    Turtle()
    Konstruktor der Schildkröte Erzeugt eine Turtle und versetzt sie in einen gültigen Startzustand.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    bringToBack()
    Bringt die Schildkröte in die hinterste Ebene.
    void
    bringToFront()
    Bringt die Schildkröte in die vorderste Ebene.
    int
    getRotation()
    Gibt den aktuellen Winkel der Schildkröte zurück.
    int
    getX()
    Gibt die x-Koordinate der Schildkröte zurück.
    int
    getY()
    Gibt die y-Koordinate der Schildkröte zurück.
    boolean
    isTouching()
    Testet, ob die Schildkröte eine Figur berührt.
    boolean
    isTouching(Object object)
    Testet, ob die Schildkröte die angegebene Figur berührt.
    boolean
    isTouching(String color)
    Testet, ob die Schildkröte eine Figur in der angegebenen Farbe berührt.
    void
    liftPen()
    Die Schildkröte wechselt in den Modus „nicht zeichnen“.
    void
    lowerLayer()
    Bringt die Schildkröte eine Ebene nach hinten.
    void
    lowerPen()
    Die Schildkröte wechselt in den Modus „zeichnen“.
    void
    move(double length)
    Bewegt die Schildkröte nach vorne.
    void
    moveToStartPoint()
    Setzt die Schildkröte wieder an ihre Ausgangsposition.
    void
    onKeyPressed(char key)
    Die eigentliche Aktionsmethode für gedrückte Tasten.
    void
    onMouseClick(int x, int y, int clickCount)
    Die eigentliche Aktionsmethode für einen Mausklick.
    void
    onSpecialKeyPressed(int key)
    Die eigentliche Aktionsmethode für gedrückte Sondertasten.
    void
    performAction()
    Methode wird aufgerufen, wenn die Schildkröte handeln soll.
    void
    raiseLayer()
    Bringt die Schildkröte eine Ebene nach vorn.
    void
    remove()
    Entfernt die Schildkröte aus dem Zeichenfenster.
    void
    reset()
    Versetzt die Zeichenfläche und die Schilkröte in den Ausgangszustand.
    void
    rotate(int rotation)
    Dreht die Schildkröte.
    void
    setColor(String color)
    Setzt die Farbe der Linie.
    void
    setPosition(int x, int y)
    Setzt die Position der Schildkröte.
    void
    setRotation(int rotation)
    Setzt den Drehwinkel der Schildkröte.
    void
    setSize(int size)
    Setzt die Größe des Turtlesymbols.
    void
    setSymbolVisibility(boolean visible)
    Schaltet die Sichtbarkeit der Schildkröte ein oder aus.
    void
    setVisibility(boolean visible)
    Schaltet die Sichtbarkeit der Schildkröte ein oder aus.

    Methods inherited from class java.lang.Object

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

  • Field Details

    • x

      public int x
      Die x-Position der Schildkröte.

    • y

      public int y
      Die y-Position der Schildkröte.

    • size

      public int size
      Die Größe der Schildkröte.

      Der ursprünglich deutsche Name dieses Attributs war größe.

    • color

      public String color
      Die Farbe der Schildkröte.

      Der ursprünglich deutsche Name dieses Attributs war farbe.

    • visible

      public boolean visible
      Die Sichtbarkeit der Schildkröte.

      Der ursprünglich deutsche Name dieses Attributs war sichtbar.

    • rotation

      public int rotation
      Der Drehwinkel (mathemtisch positiver Drehsinn) der Schildkröte in Grad.

      Der ursprünglich deutsche Name dieses Attributs war winkel.

    • penDown

      public boolean penDown
      Die Stiftposition. Wenn wahr, dann ist der Stift unten, er schreibt also.

      Der ursprünglich deutsche Name dieses Attributs war stiftUnten.

  • Constructor Details

    • Turtle

      public Turtle()
      Konstruktor der Schildkröte Erzeugt eine Turtle und versetzt sie in einen gültigen Startzustand.

  • Method Details

    • performAction

      public void performAction()
      Methode wird aufgerufen, wenn die Schildkröte handeln soll. Die vordefinierte Methode tut nichts.

      Der ursprünglich deutsche Name dieser Methode war AktionAusführen.

    • onKeyPressed

      public void onKeyPressed(char key)
      Die eigentliche Aktionsmethode für gedrückte Tasten.
      Muss bei Bedarf von einer Unterklasse überschrieben werden.

      Der ursprünglich deutsche Name dieser Methode war TasteGedrückt.

      Parameters:
      key - die gedrückte Taste

    • onSpecialKeyPressed

      public void onSpecialKeyPressed(int key)
      Die eigentliche Aktionsmethode für gedrückte Sondertasten.
      Muss bei Bedarf von einer Unterklasse überschrieben werden.

      Der ursprünglich deutsche Name dieser Methode war SonderTasteGedrückt.

      Parameters:
      key - KeyCode der gedrückten Taste

    • onMouseClick

      public void onMouseClick(int x, int y, int clickCount)
      Die eigentliche Aktionsmethode für einen Mausklick.
      Muss bei Bedarf von einer Unterklasse überschrieben werden.

      Der ursprünglich deutsche Name dieser Methode war MausGeklickt.

      Parameters:
      x - x-Position des Mausklicks
      y - y-Position des Mausklicks
      clickCount - Anzahl der aufeinanderfolgenden Mausklicks

    • setPosition

      public void setPosition(int x, int y)
      Setzt die Position der Schildkröte.

      Der ursprünglich deutsche Name dieser Methode war PositionSetzen.

      Parameters:
      x - x-Position der Schildkröte
      y - y-Position der Schildkröte

    • setSize

      public void setSize(int size)
      Setzt die Größe des Turtlesymbols.

      Der ursprünglich deutsche Name dieser Methode war GrößeSetzen.

      Parameters:
      size - (neue) Größe

    • setColor

      public void setColor(String color)
      Setzt die Farbe der Linie.

      Die möglichen Farbnamen sind über die Dokumentation der Klasse ColorContainer einzusehen.

      Der ursprünglich deutsche Name dieser Methode war FarbeSetzen.

      Parameters:
      color - Der (neue) Farbname (Mögliche Farbnamen: siehe Auflistung).

    • setRotation

      public void setRotation(int rotation)
      Setzt den Drehwinkel der Schildkröte.

      Die Winkelangabe ist in Grad, positive Werte drehen gegen den Uhrzeigersinn, negative Werte drehen im Uhrzeigersinn (mathematisch positiver Drehsinn), d. h. 0˚: Die Schilkröte schaut nach rechts, 90˚: Die Schilkröte schaut nach oben, 180˚: Die Schilkröte schaut nach links, 270˚bzw. -90˚: Die Schilkröte schaut nach unten.

      Der ursprünglich deutsche Name dieser Methode war WinkelSetzen.

      Parameters:
      rotation - der (neue) Drehwinkel der Schildkröte

    • setVisibility

      public void setVisibility(boolean visible)
      Schaltet die Sichtbarkeit der Schildkröte ein oder aus. Erlaubte Parameterwerte: true, false

      Der ursprünglich deutsche Name dieser Methode war SichtbarkeitSetzen.

      Parameters:
      visible - (neue) Sichtbarkeit der Schildkröte

    • remove

      public void remove()
      Entfernt die Schildkröte aus dem Zeichenfenster.

      Der ursprünglich deutsche Name dieser Methode war Entfernen.

    • raiseLayer

      public void raiseLayer()
      Bringt die Schildkröte eine Ebene nach vorn.

      Der ursprünglich deutsche Name dieser Methode war NachVornBringen.

    • bringToFront

      public void bringToFront()
      Bringt die Schildkröte in die vorderste Ebene.

      Der ursprünglich deutsche Name dieser Methode war GanzNachVornBringen.

    • lowerLayer

      public void lowerLayer()
      Bringt die Schildkröte eine Ebene nach hinten.

      Der ursprünglich deutsche Name dieser Methode war NachHintenBringen.

    • bringToBack

      public void bringToBack()
      Bringt die Schildkröte in die hinterste Ebene.

      Der ursprünglich deutsche Name dieser Methode war GanzNachHintenBringen.

    • moveToStartPoint

      public void moveToStartPoint()
      Setzt die Schildkröte wieder an ihre Ausgangsposition.

      Der ursprünglich deutsche Name dieser Methode war ZumStartpunktGehen.

    • move

      public void move(double length)
      Bewegt die Schildkröte nach vorne.

      Der ursprünglich deutsche Name dieser Methode war Gehen.

      Parameters:
      length - Die Anzahl der Längeneinheiten.

    • rotate

      public void rotate(int rotation)
      Dreht die Schildkröte.

      Der ursprünglich deutsche Name dieser Methode war Drehen.

      Parameters:
      rotation - Der Drehwinkel (mathematisch positiver Drehsinn) im Gradmaß.

    • reset

      public void reset()
      Versetzt die Zeichenfläche und die Schilkröte in den Ausgangszustand.

      Der ursprünglich deutsche Name dieser Methode war Löschen.

    • liftPen

      public void liftPen()
      Die Schildkröte wechselt in den Modus „nicht zeichnen“.

      Der ursprünglich deutsche Name dieser Methode war StiftHeben.

    • lowerPen

      public void lowerPen()
      Die Schildkröte wechselt in den Modus „zeichnen“.

      Der ursprünglich deutsche Name dieser Methode war StiftSenken.

    • getRotation

      public int getRotation()
      Gibt den aktuellen Winkel der Schildkröte zurück.

      Die Winkelangabe ist in Grad, positive Werte drehen gegen den Uhrzeigersinn, negative Werte drehen im Uhrzeigersinn (mathematisch positiver Drehsinn), d. h. 0˚: Die Schildkröte schaut nach rechts, 90˚: Die Schildkröte schaut nach oben, 180˚: Die Schildkröte schaut nach links, 270˚ bzw. -90˚: Die Schildkröte schaut nach unten.

      Der ursprünglich deutsche Name dieser Methode war WinkelGeben.

      Returns:
      Derr Winkel im Gradmaß.

    • getX

      public int getX()
      Gibt die x-Koordinate der Schildkröte zurück.

      Der ursprünglich deutsche Name dieser Methode war XPositionGeben.

      Returns:
      Die x-Koordinate.

    • getY

      public int getY()
      Gibt die y-Koordinate der Schildkröte zurück.

      Der ursprünglich deutsche Name dieser Methode war YPositionGeben.

      Returns:
      Die y-Koordinate.

    • setSymbolVisibility

      public void setSymbolVisibility(boolean visible)
      Schaltet die Sichtbarkeit der Schildkröte ein oder aus.

      Erlaubte Parameterwerte: true, false.

      Der ursprünglich deutsche Name dieser Methode war SichtbarkeitFürSymbolSetzen.

      Parameters:
      visible - Die (neue) Sichtbarkeit der Schildkröte.

    • isTouching

      public boolean isTouching()
      Testet, ob die Schildkröte eine Figur berührt.

      Der ursprünglich deutsche Name dieser Methode war Berührt.

      Returns:
      true, wenn die Schildkrötekoordinaten innerhalb einer Grafikfigur sind.

    • isTouching

      public boolean isTouching(String color)
      Testet, ob die Schildkröte eine Figur in der angegebenen Farbe berührt.

      Der ursprünglich deutsche Name dieser Methode war Berührt.

      Parameters:
      color - Die Farbe, die die berührte Figur haben muss.
      Returns:
      true, wenn die Schildkrötekoordinaten innerhalb einer Grafikfigur in der angegebenen Farbe sindl

    • isTouching

      public boolean isTouching(Object object)
      Testet, ob die Schildkröte die angegebene Figur berührt.

      Der ursprünglich deutsche Name dieser Methode war Berührt.

      Parameters:
      object - Das Objekt, das getestet werden soll.
      Returns:
      true, wenn die Schildkrötekoordinaten innerhalb der angegebenen Grafikfigur sind.