greenfoot

Class Greenfoot

java.lang.Object

greenfoot.Greenfoot

public class Greenfoot
extends java.lang.Object

This utility class provides methods to control the simulation and interact with the system.

Key names

Part of the functionality provided by this class is the ability to retrieve keyboard input. The methods getKey() and isKeyDown() are used for this and they return/understand the following key names:

• "a", "b", .., "z" (alphabetical keys), "0".."9" (digits), most punctuation marks. getKey() also returns uppercase characters when appropriate.
• "up", "down", "left", "right" (the cursor keys)
• "enter", "space", "tab", "escape", "backspace", "shift", "control"
• "F1", "F2", .., "F12" (the function keys)

Droidfoot

The class Greenfoot for Droidfoot differs from the original Greenfoot-class Greenfoot in the following aspects:

• getMicLevel is not supported
• getKey is not supported
• isKeyDown is not supported
• mouseMoved is not supported
• mouseClicked is not supported
• mousePressed returns true in case of a touch event

Version:

2.4, 2.0

Author:

Davin McCall, Dietrich Boles (Modifications for Android)

Constructor Summary

Constructors

Constructor and Description
Greenfoot()

Method Summary

Methods

Modifier and Type	Method and Description
static void	delay(int time) Delay the current execution by a number of time steps.
static MouseInfo	getMouseInfo() Return a mouse info object with information about the state of the mouse.
static int	getRandomNumber(int limit) Return a random number between 0 (inclusive) and limit (exclusive).
static boolean	mouseDragEnded(java.lang.Object obj) True if a mouse drag has ended.
static boolean	mouseDragged(java.lang.Object obj) True if the mouse is currently being dragged on the given object.
static boolean	mousePressed(java.lang.Object obj) True if the mouse has been pressed (changed from a non-pressed state to being pressed) on the given object.
static void	playSound(java.lang.String soundFile) Play sound from a file.
static void	setSpeed(int speed) Set the speed of the execution.
static void	setWorld(World world) Sets the World to run to the one given.
static void	start() Run (or resume) the execution.
static void	stop() Pause the execution.

Methods inherited from class java.lang.Object

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

Constructor Detail

Greenfoot

public Greenfoot()

Method Detail

delay

public static void delay(int time)

Delay the current execution by a number of time steps. The size of one time step is defined by the Greenfoot environment (the speed slider).

See Also:

setSpeed(int)

getMouseInfo

public static MouseInfo getMouseInfo()

Return a mouse info object with information about the state of the mouse.

Returns:

The info about the current state of the mouse, or null if the mouse cursor is outside the world boundary (unless being dragged).

getRandomNumber

public static int getRandomNumber(int limit)

Return a random number between 0 (inclusive) and limit (exclusive).

mouseDragEnded

public static boolean mouseDragEnded(java.lang.Object obj)

True if a mouse drag has ended. This happens when the mouse has been dragged and the mouse button released.

If the parameter is an Actor the method will only return true if the drag started on the given actor. If there are several actors at the same place, only the top most actor will receive the drag. If the parameter is a World then true will be returned if the drag action was started on the world background. If the parameter is null, then true will be returned for any drag action, independent of the target clicked on.

Parameters:

obj - Typically one of Actor, World or null

Returns:

True if the mouse has been dragged as explained above

mouseDragged

public static boolean mouseDragged(java.lang.Object obj)

True if the mouse is currently being dragged on the given object. The mouse is considered to be dragged on an object if the drag started on that object - even if the mouse has since been moved outside of that object.

If the parameter is an Actor the method will only return true if the drag started on the given actor. If there are several actors at the same place, only the top most actor will receive the drag. If the parameter is a World then true will be returned if the drag action was started on the world background. If the parameter is null, then true will be returned for any drag action, independent of the target clicked on.

Parameters:

obj - Typically one of Actor, World or null

Returns:

True if the mouse has been dragged as explained above

mousePressed

public static boolean mousePressed(java.lang.Object obj)

True if the mouse has been pressed (changed from a non-pressed state to being pressed) on the given object. If the parameter is an Actor the method will only return true if the mouse has been pressed on the given actor. If there are several actors at the same place, only the top most actor will receive the press. If the parameter is a World then true will be returned if the mouse was pressed on the world background. If the parameter is null, then true will be returned for any mouse press, independent of the target pressed on.

Parameters:

obj - Typically one of Actor, World or null

Returns:

True if the mouse has been pressed as explained above

playSound

public static void playSound(java.lang.String soundFile)

Play sound from a file. The following formats are supported: AIFF, AU and WAV.

The file name may be an absolute path, a base name for a file located in the project directory or in the sounds directory of the project directory.

Parameters:

soundFile - Typically the name of a file in the sounds directory in the project directory.

Throws:

java.lang.IllegalArgumentException - If the sound can not be loaded.

setSpeed

public static void setSpeed(int speed)

Set the speed of the execution.

Parameters:

speed - The new speed. the value must be in the range (1..100)

setWorld

public static void setWorld(World world)

Sets the World to run to the one given. This World will now be the main World that Greenfoot runs with on the next act.

Parameters:

world - The World to switch running to, cannot be null.

start

public static void start()

Run (or resume) the execution.

stop

public static void stop()

Pause the execution.