ch.aplu.ev3

Class TurtleRobot

java.lang.Object

ch.aplu.ev3.LegoRobot

ch.aplu.ev3.TurtleRobot

public class TurtleRobot
extends LegoRobot

Implementation of the basic Logo turtle movements.

Constructor Summary

Constructors

Constructor and Description
TurtleRobot() Creates a TurtleLegoRobot instance.
TurtleRobot(boolean waitStart) Creates TurtleLegoRobot instance and delays execution until the user presses the ENTER button.

Method Summary

Methods

Modifier and Type	Method and Description
TurtleRobot	backward(int steps) Moves the turtle backward the given number of steps.
TurtleRobot	forward(int steps) Moves the turtle forward the given number of steps.
Gear	getGear() Returns the gear used as component of the turtle.
int	getTurtleSpeed() Returns the current turtle speed.
TurtleRobot	left(int angle) Turns the turtle to the left for the given angle.
TurtleRobot	right(int angle) Turns the turtle to the right for the given angle.
TurtleRobot	setTurtleSpeed(int speed) Sets the turtle speed to the given value.

Methods inherited from class ch.aplu.ev3.LegoRobot

addButtonListener, addPart, clearDisplay, drawString, drawStringAt, exit, getBatteryLevel, getHitButtonID, getRobotProperties, getVersion, isButtonHit, isDownHit, isEnterHit, isEscapeHit, isLeftHit, isRightHit, isUpHit, playTone, setLED, setVolume

Methods inherited from class java.lang.Object

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

Constructor Detail

TurtleRobot

public TurtleRobot(boolean waitStart)

Creates TurtleLegoRobot instance and delays execution until the user presses the ENTER button. Motors should be plugged into port A and B.

Parameters:

waitStart - if true, the execution is stopped until the ENTER button is hit.

TurtleRobot

public TurtleRobot()

Creates a TurtleLegoRobot instance.

Method Detail

getGear

public Gear getGear()

Returns the gear used as component of the turtle.

Returns:

the reference of the Gear instance

setTurtleSpeed

public TurtleRobot setTurtleSpeed(int speed)

Sets the turtle speed to the given value. The TurtleRotationSpeed remains unchanged. The speed will be changed to the new value at the next movement call only.

Parameters:

speed - 0..100

Returns:

the object reference to allow method chaining

getTurtleSpeed

public int getTurtleSpeed()

Returns the current turtle speed.

Returns:

speed 0..100

forward

public TurtleRobot forward(int steps)

Moves the turtle forward the given number of steps. The methods blocks until the turtle is at the final position. The actual distance depends on the "TurtleStepFactor" as defined in the ev3jlib.properties file. The turtle speed corresponds to the "TurtleSpeed" as defined in ShareConstants interface.

Parameters:

steps - the number of steps to go.

Returns:

the object reference to allow method chaining

backward

public TurtleRobot backward(int steps)

Moves the turtle backward the given number of steps. The methods blocks until the turtle is at the final position. The actual distance depends on the "TurtleStepFactor" as defined in the ev3jlib.properties file. The turtle speed corresponds to the "TurtleSpeed" as defined in the ev3jlib.properties file.

Parameters:

steps - the number of steps to go.

Returns:

the object reference to allow method chaining

left

public TurtleRobot left(int angle)

Turns the turtle to the left for the given angle. The methods blocks until the turtle is at the final position. Due to the construction of the EV3 the accuracy is limited. It depends on the "TurtleRotationFactor" and the "TurtleRotationSpeed" as defined in the ev3jlib.properties file.

Parameters:

angle - the angle in degree to rotate.

Returns:

the object reference to allow method chaining

right

public TurtleRobot right(int angle)

Turns the turtle to the right for the given angle. The methods blocks until the turtle is at the final position. Due to the construction of the EV3 the accuracy is limited. It depends on the "TurtleRotationFactor" and the "TurtleRotationSpeed" as defined in the ev3jlib.properties file.

Parameters:

angle - the angle in degree to rotate.

Returns:

the object reference to allow method chaining