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
Wrapperklasse für die Turtle auf der Zeichenfläche.
Version:
1.0
Author:
Albert Wiedemann

  • Field Summary

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

  • Constructor Summary

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

  • Method Summary

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

    • y

      public int y
      y-Position der Turtle.

    • size

      public int size
      Größe der Turtle.

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

    • color

      public String color
      Farbe der Turtle.

      Die ursprünglich deutsche Name dieses Attributs war farbe.

    • visible

      public boolean visible
      Sichtbarkeit der Turtles.

      Die ursprünglich deutsche Name dieses Attributs war sichtbar.

    • rotation

      public int rotation
      Drehwinkel (mathemtisch positiver Drehsinn) der Turtle in Grad.

      Die ursprünglich deutsche Name dieses Attributs war winkel.

    • penDown

      public boolean penDown
      Stiftposition

      Die ursprünglich deutsche Name dieses Attributs war stiftUnten.

  • Constructor Details

    • Turtle

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

  • Method Details

    • performAction

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

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

    • onKeyPressed

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

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

      Parameters:
      taste - die gedrückte Taste

    • onSpecialKeyPressed

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

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

      Parameters:
      taste - KeyCode der gedrückten Taste

    • onMouseClick

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

      Die ursprünglich deutsche Name dieser Methode war MausGeklickt.

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

    • setPosition

      public void setPosition(int x, int y)
      Setzt die Position der Turtle.

      Die ursprünglich deutsche Name dieser Methode war PositionSetzen.

      Parameters:
      x - x-Position der Turtle
      y - y-Position der Turtle

    • setSize

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

      Die 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. Erlaubte Farben sind: "weiß", "weiss", "rot", "grün", "gruen", "blau", "gelb", "magenta", "cyan", "hellgelb", "hellgrün", "hellgruen", "orange", "braun", "grau", "schwarz" Alle anderen Eingaben werden auf die Farbe schwarz abgebildet.

      Die ursprünglich deutsche Name dieser Methode war FarbeSetzen.

      Parameters:
      color - (neue) Farbe

    • setAngle

      public void setAngle(int rotation)
      Setzt den Drehwinkel der Turtle. Die Winkelangabe ist in Grad, positive Werte drehen gegen den Uhrzeigersinn, negative Werte drehen im Uhrzeigersinn (mathematisch positiver Drehsinn), d. h. 0˚: Turtle schaut nach rechts, 90˚: Turtle schaut nach oben, 180˚: Turtle schaut nach links, 270˚bzw. -90˚: Turtle schaut nach unten

      Die ursprünglich deutsche Name dieser Methode war WinkelSetzen.

      Parameters:
      rotation - der (neue) Drehwinkel der Turtle

    • setVisibility

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

      Die ursprünglich deutsche Name dieser Methode war SichtbarkeitSetzen.

      Parameters:
      visible - (neue) Sichtbarkeit der Turtle

    • remove

      public void remove()
      Entfernt die Turtle aus dem Zeichenfenster.

      Die ursprünglich deutsche Name dieser Methode war Entfernen.

    • raiseLayer

      public void raiseLayer()
      Bringt die Turtle eine Ebene nach vorn.

      Die ursprünglich deutsche Name dieser Methode war NachVornBringen.

    • bringToFront

      public void bringToFront()
      Bringt die Turtle in die vorderste Ebene.

      Die ursprünglich deutsche Name dieser Methode war GanzNachVornBringen.

    • lowerLayer

      public void lowerLayer()
      Bringt die Turtle eine Ebene nach hinten.

      Die ursprünglich deutsche Name dieser Methode war NachHintenBringen.

    • bringToBack

      public void bringToBack()
      Bringt die Turtle in die hinterste Ebene.

      Die ursprünglich deutsche Name dieser Methode war GanzNachHintenBringen.

    • moveToStartPoint

      public void moveToStartPoint()
      Setzt die Turtle wieder an ihre Ausgangsposition.

      Die ursprünglich deutsche Name dieser Methode war ZumStartpunktGehen.

    • move

      public void move(double länge)
      Bewegt die Turtle nach vorne.

      Die ursprünglich deutsche Name dieser Methode war Gehen.

      Parameters:
      länge - Anzahl der Längeneinheiten

    • rotate

      public void rotate(int rotation)
      Dreht die Turtle

      Die ursprünglich deutsche Name dieser Methode war Drehen.

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

    • reset

      public void reset()
      Versetzt Zeichenfläche und Turtle in den Ausgangszustand.

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

    • liftPen

      public void liftPen()
      Turtle wechselt in den Modus "nicht zeichnen"

      Die ursprünglich deutsche Name dieser Methode war StiftHeben.

    • lowerPen

      public void lowerPen()
      Turtle wechselt in den Modus "zeichnen"

      Die ursprünglich deutsche Name dieser Methode war StiftSenken.

    • getRotation

      public int getRotation()
      Gibt den aktuellen Winkel der Turtle zurück. Die Winkelangabe ist in Grad, positive Werte drehen gegen den Uhrzeigersinn, negative Werte drehen im Uhrzeigersinn (mathematisch positiver Drehsinn), d. h. 0˚: Turtle schaut nach rechts, 90˚: Turtle schaut nach oben, 180˚: Turtle schaut nach links, 270˚bzw. -90˚: Turtle schaut nach unten

      Die ursprünglich deutsche Name dieser Methode war WinkelGeben.

      Returns:
      Winkel im Gradmass

    • getX

      public int getX()
      Gibt die x-Koordinate der Turtle zurück

      Die ursprünglich deutsche Name dieser Methode war XPositionGeben.

      Returns:
      x-Koordinate

    • getY

      public int getY()
      Gibt die y-Koordinate der Turtle zurück.

      Die ursprünglich deutsche Name dieser Methode war YPositionGeben.

      Returns:
      y-Koordinate

    • setSymbolVisibility

      public void setSymbolVisibility(boolean visible)
      Schaltet die Sichtbarkeit des Turtlesymbols ein oder aus. Erlaubte Parameterwerte: true, false

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

      Parameters:
      visible - (neue) Sichtbarkeit des Turtlesymbols

    • isTouching

      public boolean isTouching()
      Testet, ob die Turtle eine Figur berührt.

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

      Returns:
      true, wenn die Turtlekoordinaten innerhalb einer Grafikfigur sind

    • isTouching

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

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

      Parameters:
      color - die Farbe, die die berührte Figur haben muss.
      Returns:
      true, wenn die Turtlekoordinaten innerhalb einer Grafikfigur in der angegebenen Farbe sind

    • isTouching

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

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

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