Playground

java.lang.Object
- android.content.Context
- - android.content.ContextWrapper
  - - android.view.ContextThemeWrapper
    - - android.app.Activity
      - turtle.GameGrid
        
        turtle.Playground

All Implemented Interfaces:

android.content.ComponentCallbacks, android.media.MediaPlayer.OnCompletionListener, android.view.KeyEvent.Callback, android.view.LayoutInflater.Factory, android.view.View.OnCreateContextMenuListener, android.view.Window.Callback
```
public class Playground
extends GameGrid
```
Class that represents a grapics window where the turtles live. The coordintate system is centered in the middle of the window and the range is -200..200 in both direction (x coordinate to the right, y coordinate to the top). The class is derived from GameGrid, but most of the GameGrid methods are made protected, so they are only exposed indirectly to the user and not seen in the JavaDoc.

When the playground appears, a green colored turtle, called the global turtle is created too. It is invisible until showTurtle() or st() is called. but it may draw traces right from the start. The global turtle is affected by Turtle methods reproduced in the Playground class. If the turtle was never shown, its speed is MAXSPEED; when it is shown the first time, its speed is 5.

All playground touch events run in distinct separate threads to allow multi-turtle movements.

If an application class constructor is used, it must be declared public..

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`BIGSIZE` Constants for the turtle magnification (augmented to double the standard size).
`static int`	`BLACK` Short for Color.BLACK.
`static int`	`BLUE` Short for Color.BLUE.
`static int`	`CYAN` Short for Color.CYAN.
`static int`	`DKGRAY` Short for Color.DKGRAY.
`static int`	`GRAY` Short for Color.GRAY.
`static int`	`GREEN` Short for Color.GREEN.
`static int`	`LTGRAY` Short for Color.LTGRAY.
`static int`	`MAGENTA` Short for Color.MAGENTA.
`static int`	`MAXSPEED` Maximum speed (no animation).
`static int`	`MEDIUMSIZE` Constants for the turtle magnification (standard size).
`static int`	`RED` Short for Color.RED.
`static int`	`SMALLSIZE` Constants for the turtle magnification (reduced to half the standard size).
`static int`	`TRANSPARENT` Short for Color.TRANSPARENT.
`static int`	`WHITE` Short for Color.WHITE.
`static int`	`YELLOW` Short for Color.YELLOW.

Fields inherited from class turtle.GameGrid
turtleImage

Fields inherited from class android.app.Activity
DEFAULT_KEYS_DIALER, DEFAULT_KEYS_DISABLE, DEFAULT_KEYS_SEARCH_GLOBAL, DEFAULT_KEYS_SEARCH_LOCAL, DEFAULT_KEYS_SHORTCUT, RESULT_CANCELED, RESULT_FIRST_USER, RESULT_OK

Fields inherited from class android.content.Context
ACCESSIBILITY_SERVICE, ACCOUNT_SERVICE, ACTIVITY_SERVICE, ALARM_SERVICE, AUDIO_SERVICE, BIND_AUTO_CREATE, BIND_DEBUG_UNBIND, BIND_NOT_FOREGROUND, CLIPBOARD_SERVICE, CONNECTIVITY_SERVICE, CONTEXT_IGNORE_SECURITY, CONTEXT_INCLUDE_CODE, CONTEXT_RESTRICTED, DEVICE_POLICY_SERVICE, DROPBOX_SERVICE, INPUT_METHOD_SERVICE, KEYGUARD_SERVICE, LAYOUT_INFLATER_SERVICE, LOCATION_SERVICE, MODE_APPEND, MODE_PRIVATE, MODE_WORLD_READABLE, MODE_WORLD_WRITEABLE, NOTIFICATION_SERVICE, POWER_SERVICE, SEARCH_SERVICE, SENSOR_SERVICE, TELEPHONY_SERVICE, UI_MODE_SERVICE, VIBRATOR_SERVICE, WALLPAPER_SERVICE, WIFI_SERVICE, WINDOW_SERVICE

Constructor Summary

Constructors
Constructor and Description
`Playground()` Creates a square sized playground that fits the device screen.
`Playground(java.lang.String turtleImage)` Same as Playground(), but the turtle seed image is loaded from the sdcard.

Method Summary

Methods
Modifier and Type	Method and Description
`Turtle`	`back(double s)` Moves the global turtle back.
`static void`	`beep()` Emits a beep (1000 Hz sine wave of 100 ms duration).
`Turtle`	`bk(double s)` Short for back().
`static void`	`clean()` Erases the playground by filling it with the current playground color.
`static void`	`clean(int color)` Erases the playground by filling it with the given color.
`static void`	`clear()` Clears the playground by filling it with the current playground color.
`static void`	`clear(int color)` Clears the playground by filling it with the given color.
`Turtle`	`clone()` Creates a clone of the current global turtle by performing a deep copy of all its properties.
`static void`	`delay(long timeout)` Halts the current thread for the given time.
`double`	`distance(double x, double y)` Returns the distance from the current position of the global turtle to the given position.
`Turtle`	`dot()` Draws a single point (dot) at the current turtle position using the current pen color.
`Turtle`	`fd(double s)` Short for forward().
`Turtle`	`fill()` Same as fill(x, y), but using the current turtle position.
`Turtle`	`fill(double x, double y)` Fills a bounded region of the playground with the current pen color (flood fill).
`Turtle`	`fillOff()` Stops the filling started by calling fillToPoint(), fillToHorizontal() or fillToVertical().
`Turtle`	`fillToHorizontal(double y)` Draws a imaginary horizonatal line at given y coordinate.
`Turtle`	`fillToPoint(double x, double y)` Attachs a imaginary rubber band between the global turtle and the given anchor point.
`Turtle`	`fillToVertical(double x)` Draws a imaginary vertical line at given x coordinate.
`Turtle`	`forward(double s)` Moves the global turtle forward.
`int`	`getColor()` Returns the current global turtle color.
`double`	`getHeading()` Returns the current heading (moving direction) of the global turtle.
`int`	`getPenColor()` Returns the current pen color of the global turtle.
`int`	`getPenWidth()` Returns the current pen width of the global turtle.
`int`	`getPlaygroundColor()` Returns the color of the playground.
`int`	`getSpeed()` Returns the current speed (0..10, -1 for MAXSPEED) of the global turtle.
`Turtle`	`getTopTurtleNear(double xCenter, double yCenter, double radius)` Returns the topmost turtle reference that intersect with the given circle.
`java.util.ArrayList<Turtle>`	`getTurtlesNear(double xCenter, double yCenter, double radius)` Returns the list of turtles that intersect with the given circle (in paint order: subsequent turtle in the list are painted on top of preceding actors.
`double`	`getX()` Returns the current x coordinate of the global turtle.
`double`	`getY()` Returns the current y coordinate of the global turtle.
`double`	`getZoomFactor()` Returns the quotient between pixel and turtle distances.
`Turtle`	`hideTurtle()` Hides the global turtle.
`Turtle`	`home()` Puts the global turtle at home (center of playground, coordinates (0, 0).
`Turtle`	`ht()` Short for hideTurtle().
`boolean`	`isBackValid(double s)` Checks if the backward movement using the given step moves the turtle to a position outside the visible playground.
`boolean`	`isForwardValid(double s)` Checks if the forward movement using the given step moves the turtle to a position outside the visible playground.
`boolean`	`isHidden()` Reports the current visibility of the global turtle.
`boolean`	`isOnBoarder(int borderId)` Returns true, if the turtle is on the selected border line.
`boolean`	`isOnBorder()` Returns true, if the global turtle is on any of the 4 border lines.
`boolean`	`isPenDown()` Reports the current pen state of the global turtle.
`Turtle`	`label(java.lang.String text)` Same as label(text, textColor, textSize) with textColor = Color.WHITE and textSize = 15.
`Turtle`	`label(java.lang.String text, int textColor, int textSize)` Paints the given text with given text color and given text height at the current global turtle position
`Turtle`	`left(double angle)` Turns global the turtle to the left (counter clockwise).
`Turtle`	`lt(double angle)` Short for left().
`Turtle`	`moveTo(double x, double y)` Puts the global turtle to the given position.
`Turtle`	`pd()` Short for penDown().
`Turtle`	`penDown()` Lowers the global turtle's pen, so it draws traces when it moves.
`Turtle`	`penUp()` Lifts the global turtle's pen, so is does not draw traces when it moves.
`void`	`playgroundClicked(double x, double y)` Event notification when the playground is clicked.
`void`	`playgroundDragged(double x, double y)` Event notification when the playground is dragged.
`void`	`playgroundLongPressed(double x, double y)` Event notification when the playground is long pressed.
`void`	`playgroundPressed(double x, double y)` Event notification when the playground is pressed.
`void`	`playgroundReleased(double x, double y)` Event notification when the playground is released.
`Turtle`	`pu()` Short for penUp().
`double`	`readDouble(java.lang.String title, java.lang.String prompt)` Same as readDouble(title, prompt, init), but no initial value is displayed.
`double`	`readDouble(java.lang.String title, java.lang.String prompt, double init)`
`int`	`readInt(java.lang.String title, java.lang.String prompt)` Same as readInt(title, prompt, init), but no initial value is displayed.
`int`	`readInt(java.lang.String title, java.lang.String prompt, int init)`
`java.lang.String`	`readString(java.lang.String title, java.lang.String prompt)` Same as readString(title, prompt, init), but no initial value is displayed.
`java.lang.String`	`readString(java.lang.String title, java.lang.String prompt, java.lang.String init)`
`java.lang.String`	`readStringWithCancel(java.lang.String title, java.lang.String prompt, java.lang.String init)`
`Turtle`	`right(double angle)` Turns the global turtle to the right (clockwise).
`Turtle`	`rt(double angle)` Short for right().
`Turtle`	`setColor(int color)` Sets the current global turtle color.
`Turtle`	`setHeading(double heading)` Sets the current heading (moving direction) of the gloabal turtle.
`Turtle`	`setPenColor(int color)` Sets the current pen color of the global turtle.
`Turtle`	`setPenWidth(int width)` Sets the current pen width.
`Turtle`	`setPos(double x, double y)` Puts the global turtle to the given position.
`Turtle`	`setSize(int size)` Sets the current turtle size.
`Turtle`	`setSpeed(int speed)` Sets the global turtle's speed.
`Turtle`	`setX(double x)` Puts the global turtle to the given x coordinate.
`Turtle`	`setY(double y)` Puts the global turtle to the given y coordinate.
`void`	`showToast(java.lang.String text)` Displays an Android "toast" message (notification that pops up shortly) at system defined position.
`Turtle`	`showTurtle()` Shows the global turtle if it was hidden before.
`void`	`showValue(java.lang.String title, boolean value)` Displays a modal information dialog with an Ok button.
`void`	`showValue(java.lang.String title, double value)` Displays a modal information dialog with an Ok button.
`void`	`showValue(java.lang.String title, float value)` Displays a modal information dialog with an Ok button.
`void`	`showValue(java.lang.String title, int value)` Displays a modal information dialog with an Ok button.
`void`	`showValue(java.lang.String title, long value)` Displays a modal information dialog with an Ok button.
`void`	`showValue(java.lang.String title, short value)` Displays a modal information dialog with an Ok button.
`void`	`showValue(java.lang.String title, java.lang.String value)` Displays a modal information dialog with an Ok button.
`static void`	`sleep(int time)` Delays the execution for the given time.
`Turtle`	`st()` Short for showTurtle().
`double`	`towards(double x, double y)` Returns the direction (heading) of the global turtle from the current position to the given position.
`void`	`turtleClicked(Turtle turtle, double x, double y)` Event notification when a turtle is clicked.
`void`	`turtleDragged(Turtle turtle, double x, double y)` Event notification when a turtle is dragged.
`void`	`turtleLongPressed(Turtle turtle, double x, double y)` Event notification when a turtle is long pressed.
`void`	`turtlePressed(Turtle turtle, double x, double y)` Event notification when a turtle is pressed.
`void`	`turtleReleased(Turtle turtle, double x, double y)` Event notification when a turtle is released.

Methods inherited from class turtle.GameGrid
act, addStatusBar, addStatusBar, onCompletion, onConfigurationChanged, onKeyDown, onKeyLongPress, onKeyUp, playgroundDragged, playgroundFlung, playgroundPointerPressed, playgroundPointerReleased, playgroundPressed, playgroundReleased, playSound, playSound, refresh, setDragEnabled, setMultiDragEnabled, setMultiTouchEnabled, setTouchEnabled

Methods inherited from class android.app.Activity
addContentView, closeContextMenu, closeOptionsMenu, createPendingResult, dismissDialog, dispatchKeyEvent, dispatchPopulateAccessibilityEvent, dispatchTouchEvent, dispatchTrackballEvent, findViewById, finish, finishActivity, finishActivityFromChild, finishFromChild, getApplication, getCallingActivity, getCallingPackage, getChangingConfigurations, getComponentName, getCurrentFocus, getInstanceCount, getIntent, getLastNonConfigurationInstance, getLayoutInflater, getLocalClassName, getMenuInflater, getParent, getPreferences, getRequestedOrientation, getSystemService, getTaskId, getTitle, getTitleColor, getVolumeControlStream, getWallpaperDesiredMinimumHeight, getWallpaperDesiredMinimumWidth, getWindow, getWindowManager, hasWindowFocus, isChild, isFinishing, isTaskRoot, managedQuery, moveTaskToBack, onAttachedToWindow, onBackPressed, onContentChanged, onContextItemSelected, onContextMenuClosed, onCreateContextMenu, onCreateDescription, onCreateOptionsMenu, onCreatePanelMenu, onCreatePanelView, onCreateThumbnail, onCreateView, onDetachedFromWindow, onKeyMultiple, onLowMemory, onMenuItemSelected, onMenuOpened, onOptionsItemSelected, onOptionsMenuClosed, onPanelClosed, onPrepareOptionsMenu, onPreparePanel, onRetainNonConfigurationInstance, onSearchRequested, onTouchEvent, onTrackballEvent, onUserInteraction, onWindowAttributesChanged, onWindowFocusChanged, openContextMenu, openOptionsMenu, overridePendingTransition, registerForContextMenu, removeDialog, requestWindowFeature, runOnUiThread, setContentView, setContentView, setContentView, setDefaultKeyMode, setFeatureDrawable, setFeatureDrawableAlpha, setFeatureDrawableResource, setFeatureDrawableUri, setIntent, setPersistent, setProgress, setProgressBarIndeterminate, setProgressBarIndeterminateVisibility, setProgressBarVisibility, setRequestedOrientation, setResult, setResult, setSecondaryProgress, setTitle, setTitle, setTitleColor, setVisible, setVolumeControlStream, showDialog, showDialog, startActivity, startActivityForResult, startActivityFromChild, startActivityIfNeeded, startIntentSender, startIntentSenderForResult, startIntentSenderFromChild, startManagingCursor, startNextMatchingActivity, startSearch, stopManagingCursor, takeKeyEvents, triggerSearch, unregisterForContextMenu

Methods inherited from class android.view.ContextThemeWrapper
getTheme, setTheme

Methods inherited from class android.content.ContextWrapper
bindService, checkCallingOrSelfPermission, checkCallingOrSelfUriPermission, checkCallingPermission, checkCallingUriPermission, checkPermission, checkUriPermission, checkUriPermission, clearWallpaper, createPackageContext, databaseList, deleteDatabase, deleteFile, enforceCallingOrSelfPermission, enforceCallingOrSelfUriPermission, enforceCallingPermission, enforceCallingUriPermission, enforcePermission, enforceUriPermission, enforceUriPermission, fileList, getApplicationContext, getApplicationInfo, getAssets, getBaseContext, getCacheDir, getClassLoader, getContentResolver, getDatabasePath, getDir, getExternalCacheDir, getExternalFilesDir, getFilesDir, getFileStreamPath, getMainLooper, getPackageCodePath, getPackageManager, getPackageName, getPackageResourcePath, getResources, getSharedPreferences, getWallpaper, grantUriPermission, isRestricted, openFileInput, openFileOutput, openOrCreateDatabase, peekWallpaper, registerReceiver, registerReceiver, removeStickyBroadcast, revokeUriPermission, sendBroadcast, sendBroadcast, sendOrderedBroadcast, sendOrderedBroadcast, sendStickyBroadcast, sendStickyOrderedBroadcast, setWallpaper, setWallpaper, startInstrumentation, startService, stopService, unbindService, unregisterReceiver

Methods inherited from class android.content.Context
getString, getString, getText, obtainStyledAttributes, obtainStyledAttributes, obtainStyledAttributes, obtainStyledAttributes

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - SMALLSIZE
```
public static final int SMALLSIZE
```
    Constants for the turtle magnification (reduced to half the standard size).
    
    See Also:
    Constant Field Values
  - MEDIUMSIZE
```
public static final int MEDIUMSIZE
```
    Constants for the turtle magnification (standard size).
    
    See Also:
    Constant Field Values
  - BIGSIZE
```
public static final int BIGSIZE
```
    Constants for the turtle magnification (augmented to double the standard size).
    
    See Also:
    Constant Field Values
  - MAXSPEED
```
public static int MAXSPEED
```
    Maximum speed (no animation). (MAXSPEED = -1)
  - BLACK
```
public static final int BLACK
```
    Short for Color.BLACK.
    
    See Also:
    Constant Field Values
  - BLUE
```
public static final int BLUE
```
    Short for Color.BLUE.
    
    See Also:
    Constant Field Values
  - CYAN
```
public static final int CYAN
```
    Short for Color.CYAN.
    
    See Also:
    Constant Field Values
  - DKGRAY
```
public static final int DKGRAY
```
    Short for Color.DKGRAY.
    
    See Also:
    Constant Field Values
  - GRAY
```
public static final int GRAY
```
    Short for Color.GRAY.
    
    See Also:
    Constant Field Values
  - GREEN
```
public static final int GREEN
```
    Short for Color.GREEN.
    
    See Also:
    Constant Field Values
  - LTGRAY
```
public static final int LTGRAY
```
    Short for Color.LTGRAY.
    
    See Also:
    Constant Field Values
  - MAGENTA
```
public static final int MAGENTA
```
    Short for Color.MAGENTA.
    
    See Also:
    Constant Field Values
  - RED
```
public static final int RED
```
    Short for Color.RED.
    
    See Also:
    Constant Field Values
  - TRANSPARENT
```
public static final int TRANSPARENT
```
    Short for Color.TRANSPARENT.
    
    See Also:
    Constant Field Values
  - WHITE
```
public static final int WHITE
```
    Short for Color.WHITE.
    
    See Also:
    Constant Field Values
  - YELLOW
```
public static final int YELLOW
```
    Short for Color.YELLOW.
    
    See Also:
    Constant Field Values
- Constructor Detail
  - Playground
```
public Playground(java.lang.String turtleImage)
```
    Same as Playground(), but the turtle seed image is loaded from the sdcard. The given filename is a relative path starting from the root "/mnt/sdcard/". The sprite image size should be chosen optimal compared to the virtual -200..200 playground size. (The image is automatically zoomed at runtime accordingly to the current current screen resolution.) The sprite image should be oriented to the east and use a transparent background. white pixels (0xFFFFFF, any alpha) take the current turtle color. Other pixel colors will display unchanged.
    
    The turtle image cannot be selected individually for each turtle. Use JDroidLib if you want to create animated actor games.
    
    If the image cannot be loaded, the app is terminated with an error message.
    
    Parameters:
    turtleImage - the relative path to the image file (best is png format) e.g "sprites/car.png"
    
    If an application class constructor is used, it must be declared public..
  - Playground
```
public Playground()
```
    Creates a square sized playground that fits the device screen. It's orientation depends on the device orientation when the application starts, but it remains fixed, when the device is rotated. The background color is dark blue (Color.rgb(0, 0, 128)) and the border color white. The turtle coordinate system is a independent of the pixel resolution with double coordinates x = -200..200 from left to right and y = -200..200 from bottom to top (center in the middle of the playground).
    
    If an application class constructor is used, it must be declared public..
- Method Detail
  - getPlaygroundColor
```
public int getPlaygroundColor()
```
    Returns the color of the playground.
    
    Returns:
    the playground color
  - getZoomFactor
```
public double getZoomFactor()
```
    Returns the quotient between pixel and turtle distances.
    
    Returns:
    the zoom factor applied to turtle coordinate increments to transform them to screen pixel increments.
  - playgroundPressed
```
public void playgroundPressed(double x,
                     double y)
```
    Event notification when the playground is pressed. Empty implementation, override to get your own notification. Override to get your own notification.
    
    Overrides:
    
    playgroundPressed in class GameGrid
    
    Parameters:
    x - the x coordinate of the touch event (turtle coordinate system)
    y - the y coordinate of the touch event (turtle coordinate system)
  - playgroundReleased
```
public void playgroundReleased(double x,
                      double y)
```
    Event notification when the playground is released. Empty implementation, override to get your own notification.
    
    Overrides:
    
    playgroundReleased in class GameGrid
    
    Parameters:
    x - the x coordinate of the touch event (turtle coordinate system)
    y - the y coordinate of the touch event (turtle coordinate system)
  - playgroundLongPressed
```
public void playgroundLongPressed(double x,
                         double y)
```
    Event notification when the playground is long pressed. Empty implementation, override to get your own notification.
    
    Overrides:
    
    playgroundLongPressed in class GameGrid
    
    Parameters:
    x - the x coordinate of the touch event (turtle coordinate system)
    y - the y coordinate of the touch event (turtle coordinate system)
  - playgroundClicked
```
public void playgroundClicked(double x,
                     double y)
```
    Event notification when the playground is clicked. Empty implementation, override to get your own notification.
    
    Overrides:
    
    playgroundClicked in class GameGrid
    
    Parameters:
    x - the x coordinate of the touch event (turtle coordinate system)
    y - the y coordinate of the touch event (turtle coordinate system)
  - playgroundDragged
```
public void playgroundDragged(double x,
                     double y)
```
    Event notification when the playground is dragged. Empty implementation, override to get your own notification.
    
    Overrides:
    
    playgroundDragged in class GameGrid
    
    Parameters:
    x - the x coordinate of the touch event (turtle coordinate system)
    y - the y coordinate of the touch event (turtle coordinate system)
  - turtleClicked
```
public void turtleClicked(Turtle turtle,
                 double x,
                 double y)
```
    Event notification when a turtle is clicked. Empty implementation, override to get your own notification. When turtles are overlaid, the topmost turtle fires the event.
    
    Overrides:
    
    turtleClicked in class GameGrid
    
    Parameters:
    turtle - the reference of the touched turtle
    x - the x coordinate of the touch event (turtle coordinate system)
    y - the y coordinate of the touch event (turtlec oordinate system)
  - turtleDragged
```
public void turtleDragged(Turtle turtle,
                 double x,
                 double y)
```
    Event notification when a turtle is dragged. Empty implementation, override to get your own notification. When turtles are overlaid, the topmost turtle fires the event.
    
    Overrides:
    
    turtleDragged in class GameGrid
    
    Parameters:
    turtle - the reference of the touched turtle
    x - the x coordinate of the touch event (turtle coordinate system)
    y - the y coordinate of the touch event (turtle coordinate system)
  - turtlePressed
```
public void turtlePressed(Turtle turtle,
                 double x,
                 double y)
```
    Event notification when a turtle is pressed. Empty implementation, override to get your own notification. When turtles are overlaid, the topmost turtle fires the event.
    
    Overrides:
    
    turtlePressed in class GameGrid
    
    Parameters:
    turtle - the reference of the touched turtle
    x - the x coordinate of the touch event (turtle coordinate system)
    y - the y coordinate of the touch event (turtle coordinate system)
  - turtleReleased
```
public void turtleReleased(Turtle turtle,
                  double x,
                  double y)
```
    Event notification when a turtle is released. Empty implementation, override to get your own notification. When turtles are overlaid, the topmost turtle fires the event.
    
    Overrides:
    
    turtleReleased in class GameGrid
    
    Parameters:
    turtle - the reference of the touched turtle
    x - the x coordinate of the touch event (turtle coordinate system)
    y - the y coordinate of the touch event (turtle coordinate system)
  - turtleLongPressed
```
public void turtleLongPressed(Turtle turtle,
                     double x,
                     double y)
```
    Event notification when a turtle is long pressed. Empty implementation, override to get your own notification. When turtles are overlaid, the topmost turtle fires the event.
    
    Overrides:
    
    turtleLongPressed in class GameGrid
    
    Parameters:
    turtle - the reference of the touched turtle
    x - the x coordinate of the touch event (turtle coordinate system)
    y - the y coordinate of the touch event (turtle coordinate system)
  - showToast
```
public void showToast(java.lang.String text)
```
    Displays an Android "toast" message (notification that pops up shortly) at system defined position.
    
    Parameters:
    text - the message to display
  - getTurtlesNear
```
public java.util.ArrayList<Turtle> getTurtlesNear(double xCenter,
                                         double yCenter,
                                         double radius)
```
    Returns the list of turtles that intersect with the given circle (in paint order: subsequent turtle in the list are painted on top of preceding actors. Hidden turtles are considered to be present). The global turtle is not considered.
    
    Parameters:
    xCenter - the x coordinate of the center (turtle coordinate system)
    yCenter - the y coordinate of the center (turtle coordinate system)
    radius - the radius of the circle (turtle coordinates)
    
    Returns:
    a list of all turtles (except the global turtle) whose surrounding circle intersects with the given circle; empty list, if no turtle intersects
  - getTopTurtleNear
```
public Turtle getTopTurtleNear(double xCenter,
                      double yCenter,
                      double radius)
```
    Returns the topmost turtle reference that intersect with the given circle. Hidden turtles are considered to be present. The global turtle is not considered.
    
    Parameters:
    xCenter - the x coordinate of the center (turtle coordinate system)
    yCenter - the y coordinate of the center (turtle coordinate system)
    radius - the radius of the circle (turtle coordinates)
    
    Returns:
    a reference of the topmost turtle whose surrounding circle intersects with the given circle; null, if no turtle intersects.
  - setSpeed
```
public Turtle setSpeed(int speed)
```
    Sets the global turtle's speed.
    0: stopped 1..10: speed values for the moving animation MAXSPEED (= -1) : no animation, maximal speed
    
    Parameters:
    speed - the speed of the turtle (0..10, MAXSPEED)
  - getSpeed
```
public int getSpeed()
```
    Returns the current speed (0..10, -1 for MAXSPEED) of the global turtle.
    
    Returns:
    the current speed
  - forward
```
public Turtle forward(double s)
```
    Moves the global turtle forward. s in turtle coordinates (coordinate system x = -200..200 to right, y = -200..200 upward).
    
    Parameters:
    s - the step to move forward, if s < 0 moves back
    
    Returns:
    the turtle reference to allow chaining
  - fd
```
public Turtle fd(double s)
```
    Short for forward().
  - back
```
public Turtle back(double s)
```
    Moves the global turtle back. s in turtle coordinates (coordinate system x = -200..200 to right, y = -200..200 upward).
    
    Parameters:
    s - the step to move back, if s < 0 moves forward
    
    Returns:
    the turtle reference to allow chaining
  - bk
```
public Turtle bk(double s)
```
    Short for back().
  - right
```
public Turtle right(double angle)
```
    Turns the global turtle to the right (clockwise).
    
    Parameters:
    angle - the turning angle (in degrees), if angle < 0 turns left
    
    Returns:
    the turtle reference to allow chaining
  - rt
```
public Turtle rt(double angle)
```
    Short for right().
  - left
```
public Turtle left(double angle)
```
    Turns global the turtle to the left (counter clockwise).
    
    Parameters:
    angle - the turning angle (in degrees), if angle < 0 turns right
    
    Returns:
    the turtle reference to allow chaining
  - lt
```
public Turtle lt(double angle)
```
    Short for left().
  - beep
```
public static void beep()
```
    Emits a beep (1000 Hz sine wave of 100 ms duration). (This is a static method because it affects all turtles.)
  - clean
```
public static void clean()
```
    Erases the playground by filling it with the current playground color. The turtles remain visible at their current position. (This is a static method because it affects all turtles.)
  - clean
```
public static void clean(int color)
```
    Erases the playground by filling it with the given color. The turtles remain visible at their current position. (This is a static method because it affects all turtles.)
  - clear
```
public static void clear()
```
    Clears the playground by filling it with the current playground color. All turtle images and traces are erased, but the turtles remain (hidden) at their current positions. (This is a static method because it affects all turtles.)
  - clear
```
public static void clear(int color)
```
    Clears the playground by filling it with the given color. All turtle images and traces are erased, but the turtles remain (hidden) at their current positions. (This is a static method because it affects all turtles.)
  - hideTurtle
```
public Turtle hideTurtle()
```
    Hides the global turtle. The traces are still drawn, if pen is down. If there is only one turte, the speed is set to -1, so the turtle animation is disabled. Hiding the turtle speeds up the graphics enormously.
    
    Returns:
    the turtle reference to allow chaining
  - ht
```
public Turtle ht()
```
    Short for hideTurtle().
  - isHidden
```
public boolean isHidden()
```
    Reports the current visibility of the global turtle.
    
    Returns:
    true, if the turtle is currently hidden; otherwise false
  - showTurtle
```
public Turtle showTurtle()
```
    Shows the global turtle if it was hidden before. The turtle is put on top of all other turtles. If the turtle was never shown, the current speed is set to 5, otherwise it is not modified.
    
    Returns:
    the turtle reference to allow chaining
  - st
```
public Turtle st()
```
    Short for showTurtle().
  - getColor
```
public int getColor()
```
    Returns the current global turtle color.
    
    Returns:
    the turtle color
  - setColor
```
public Turtle setColor(int color)
```
    Sets the current global turtle color.
    
    Returns:
    the turtle reference to allow chaining
  - setSize
```
public Turtle setSize(int size)
```
    Sets the current turtle size. Big turtles use a lot of memory space and may cause a memory overflow on certain systems.
    
    Parameters:
    size - one of the constants Playground.SMALLSIZE, Playground.MEDIUMSIZE, Playground.BIGSIZE
    
    Returns:
    the turtle reference to allow chaining
  - getHeading
```
public double getHeading()
```
    Returns the current heading (moving direction) of the global turtle.
    
    Returns:
    the heading in degrees, 0 to north, clockwise
  - setHeading
```
public Turtle setHeading(double heading)
```
    Sets the current heading (moving direction) of the gloabal turtle. If speed is not MAXSPEED, the turtle rotation is animated, it turns to left or right for the smaller angle.
    
    Parameters:
    heading - in degrees, 0 to north, clockwise
    
    Returns:
    the turtle reference to allow chaining
  - towards
```
public double towards(double x,
             double y)
```
    Returns the direction (heading) of the global turtle from the current position to the given position.
    
    Parameters:
    x - the x coordinate of the target position
    y - the y coordinate of the target position
    
    Returns:
    the heading in degrees, 0 to north, clockwise
  - home
```
public Turtle home()
```
    Puts the global turtle at home (center of playground, coordinates (0, 0). The movement is not animated and no trace is drawn.
    
    Returns:
    the turtle reference to allow chaining
  - isPenDown
```
public boolean isPenDown()
```
    Reports the current pen state of the global turtle.
    
    Returns:
    true, if the pen is down, so traces are drawn; otherwise no traces are drawn
  - penDown
```
public Turtle penDown()
```
    Lowers the global turtle's pen, so it draws traces when it moves.
    
    Returns:
    the turtle reference to allow chaining
  - pd
```
public Turtle pd()
```
    Short for penDown().
  - penUp
```
public Turtle penUp()
```
    Lifts the global turtle's pen, so is does not draw traces when it moves.
    
    Returns:
    the turtle reference to allow chaining
  - pu
```
public Turtle pu()
```
    Short for penUp().
  - getPenWidth
```
public int getPenWidth()
```
    Returns the current pen width of the global turtle.
    
    Returns:
    the pen width in pixels (not adjusted to current screen resolution)
  - setPenWidth
```
public Turtle setPenWidth(int width)
```
    Sets the current pen width.
    
    Parameters:
    width - the pen width in pixels (independent of current screen resolution)
    
    Returns:
    the turtle reference to allow chaining
  - getPenColor
```
public int getPenColor()
```
    Returns the current pen color of the global turtle.
    
    Returns:
    the pen color
  - setPenColor
```
public Turtle setPenColor(int color)
```
    Sets the current pen color of the global turtle.
    
    Parameters:
    color - the color of the pen
    
    Returns:
    the turtle reference to allow chaining
  - label
```
public Turtle label(java.lang.String text)
```
    Same as label(text, textColor, textSize) with textColor = Color.WHITE and textSize = 15.
  - label
```
public Turtle label(java.lang.String text,
           int textColor,
           int textSize)
```
    Paints the given text with given text color and given text height at the current global turtle position
    
    Parameters:
    text - the text to show
    textColor - the text color
    textSize - the text size in turtle coordinates
    
    Returns:
    the turtle reference to allow chaining
  - distance
```
public double distance(double x,
              double y)
```
    Returns the distance from the current position of the global turtle to the given position.
    
    Parameters:
    x - the x coordinate of the target position
    y - the y coordinate of the target position
    
    Returns:
    the distance in turtle coordinates
  - getX
```
public double getX()
```
    Returns the current x coordinate of the global turtle.
    
    Returns:
    the turtle's x coordinate
  - getY
```
public double getY()
```
    Returns the current y coordinate of the global turtle.
    
    Returns:
    the turtle's y coordinate
  - setPos
```
public Turtle setPos(double x,
            double y)
```
    Puts the global turtle to the given position. The movement is not animated and no trace is drawn.
    
    Parameters:
    x - the new turtle's x coordinate
    y - the new turtle's y coordinate
    
    Returns:
    the turtle reference to allow chaining
  - moveTo
```
public Turtle moveTo(double x,
            double y)
```
    Puts the global turtle to the given position. The movement is not animated, but of pen is down a trace from the old to the new position is drawn.
    
    Parameters:
    x - the new turtle's x coordinate
    y - the new turtle's y coordinate
    
    Returns:
    the turtle reference to allow chaining
  - setX
```
public Turtle setX(double x)
```
    Puts the global turtle to the given x coordinate. The y coordinate is maintained. The movement is not animated and no trace is drawn.
    
    Parameters:
    x - the new turtle's x coordinate
    
    Returns:
    the turtle reference to allow chaining
  - setY
```
public Turtle setY(double y)
```
    Puts the global turtle to the given y coordinate. The x coordinate is maintained. The movement is not animated and no trace is drawn.
    
    Parameters:
    y - the new turtle's y coordinate
    
    Returns:
    the turtle reference to allow chaining
  - sleep
```
public static void sleep(int time)
```
    Delays the execution for the given time. If you want to stop the current turtle's movements, set its speed to 0. (This is a static method because it affects all turtles.)
    
    Parameters:
    time - the time to wait (in ms)
  - fill
```
public Turtle fill(double x,
          double y)
```
    Fills a bounded region of the playground with the current pen color (flood fill). It is assumed that the region is colored with the current playground color. The position of the turtle is not changed.
    
    Parameters:
    x - the x coordinate of a point inside the region
    y - the y coordinate of a point inside the region
    
    Returns:
    the turtle reference to allow chaining
  - fill
```
public Turtle fill()
```
    Same as fill(x, y), but using the current turtle position. If the turtle is sitting on its trace, a neighbor pixel with the playground color is searched.
    
    Returns:
    the turtle reference to allow chaining
  - dot
```
public Turtle dot()
```
    Draws a single point (dot) at the current turtle position using the current pen color.
    
    Returns:
    the turtle reference to allow chaining
  - isOnBorder
```
public boolean isOnBorder()
```
    Returns true, if the global turtle is on any of the 4 border lines.
    
    Returns:
    true, if one of the border lines intersects any of the non-transparent pixels of the turtle image
  - isOnBoarder
```
public boolean isOnBoarder(int borderId)
```
    Returns true, if the turtle is on the selected border line.
    
    Parameters:
    borderId - 0: top border, 1: right border, 2: bottom border, 3: left border
    
    Returns:
    true, if the border line intersects any of the non-transparent pixels of the turtle image
  - isForwardValid
```
public boolean isForwardValid(double s)
```
    Checks if the forward movement using the given step moves the turtle to a position outside the visible playground. The turtle's position remains unchanged.
    
    Parameters:
    s - the step to move forward, if s < 0 moves back
    
    Returns:
    true, if the turtle remains inside the playground; otherwise false
  - isBackValid
```
public boolean isBackValid(double s)
```
    Checks if the backward movement using the given step moves the turtle to a position outside the visible playground. The turtle's position remains unchanged.
    
    Parameters:
    s - the step to move back, if s < 0 moves forward
    
    Returns:
    true, if the turtle remains inside the playground; otherwise false
  - fillToPoint
```
public Turtle fillToPoint(double x,
                 double y)
```
    Attachs a imaginary rubber band between the global turtle and the given anchor point. When the turtle now moves, the area covered by the rubber band is filled with the current pen color. Filling is on until fillOff() is called.
    
    Parameters:
    x - the x coordinate of the anchor point
    y - the y coordinate of the anchor point
    
    Returns:
    the turtle reference to allow chaining
  - fillToHorizontal
```
public Turtle fillToHorizontal(double y)
```
    Draws a imaginary horizonatal line at given y coordinate. When the global turtle now moves, the trapezoidal area covered by this line and the turtle position is filled with the current pen color. Filling is on until fillOff() is called.
    
    Parameters:
    y - the y coordinate of the horizontal line
    
    Returns:
    the turtle reference to allow chaining
  - fillToVertical
```
public Turtle fillToVertical(double x)
```
    Draws a imaginary vertical line at given x coordinate. When the global turtle now moves, the trapezoidal area covered by this line and the turtle position is filled with the current pen color. Filling is on until fillOff() is called.
    
    Parameters:
    x - the x coordinate of the vertical line
    
    Returns:
    the turtle reference to allow chaining
  - fillOff
```
public Turtle fillOff()
```
    Stops the filling started by calling fillToPoint(), fillToHorizontal() or fillToVertical().
    
    Returns:
    the turtle reference to allow chaining
  - clone
```
public Turtle clone()
```
    Creates a clone of the current global turtle by performing a deep copy of all its properties. Can be used to "stamp" a turtle e.g. to create a fixed turtle image at the current location. The new turtle is put on top of other turtles.
    
    Overrides:
    
    clone in class java.lang.Object
    
    Returns:
    a reference to the new turtle object
  - delay
```
public static void delay(long timeout)
```
    Halts the current thread for the given time.
    
    Parameters:
    timeout - the time (in ms) the current thread sleeps
  - readString
```
public java.lang.String readString(java.lang.String title,
                          java.lang.String prompt,
                          java.lang.String init)
```
  - readString
```
public java.lang.String readString(java.lang.String title,
                          java.lang.String prompt)
```
    Same as readString(title, prompt, init), but no initial value is displayed.
    
    Parameters:
    title - the title text of the dialog box
    prompt - the prompt text of the dialog box
    
    Returns:
    the trimmed text in the edit field. An empty string is valid
  - readStringWithCancel
```
public java.lang.String readStringWithCancel(java.lang.String title,
                                    java.lang.String prompt,
                                    java.lang.String init)
```
  - readInt
```
public int readInt(java.lang.String title,
          java.lang.String prompt,
          int init)
```
  - readInt
```
public int readInt(java.lang.String title,
          java.lang.String prompt)
```
    Same as readInt(title, prompt, init), but no initial value is displayed.
    
    Parameters:
    title - the title text of the dialog box
    prompt - the prompt text of the dialog box
    
    Returns:
    the validated integer
  - readDouble
```
public double readDouble(java.lang.String title,
                java.lang.String prompt,
                double init)
```
  - readDouble
```
public double readDouble(java.lang.String title,
                java.lang.String prompt)
```
    Same as readDouble(title, prompt, init), but no initial value is displayed.
    
    Parameters:
    title - the title text of the dialog box
    prompt - the prompt text of the dialog box
    
    Returns:
    the validated double
  - showValue
```
public void showValue(java.lang.String title,
             java.lang.String value)
```
    Displays a modal information dialog with an Ok button. Further execution is suspended until the Ok button is hit.
    
    Parameters:
    title - the title of the dialog box
    value - the string value to display
  - showValue
```
public void showValue(java.lang.String title,
             short value)
```
    Displays a modal information dialog with an Ok button. Further execution is suspended until the Ok button is hit.
    
    Parameters:
    title - the title of the dialog box
    value - the short value to display
  - showValue
```
public void showValue(java.lang.String title,
             int value)
```
    Displays a modal information dialog with an Ok button. Further execution is suspended until the Ok button is hit.
    
    Parameters:
    title - the title of the dialog box
    value - the int value to display
  - showValue
```
public void showValue(java.lang.String title,
             long value)
```
    Displays a modal information dialog with an Ok button. Further execution is suspended until the Ok button is hit.
    
    Parameters:
    title - the title of the dialog box
    value - the long value to display
  - showValue
```
public void showValue(java.lang.String title,
             float value)
```
    Displays a modal information dialog with an Ok button. Further execution is suspended until the Ok button is hit.
    
    Parameters:
    title - the title of the dialog box
    value - the float value to display
  - showValue
```
public void showValue(java.lang.String title,
             double value)
```
    Displays a modal information dialog with an Ok button. Further execution is suspended until the Ok button is hit.
    
    Parameters:
    title - the title of the dialog box
    value - the double value to display
  - showValue
```
public void showValue(java.lang.String title,
             boolean value)
```
    Displays a modal information dialog with an Ok button. Further execution is suspended until the Ok button is hit.
    
    Parameters:
    title - the title of the dialog box
    value - the boolean value to display

Class Playground

Field Summary

Fields inherited from class turtle.GameGrid

Fields inherited from class android.app.Activity

Fields inherited from class android.content.Context

Constructor Summary

Method Summary

Methods inherited from class turtle.GameGrid

Methods inherited from class android.app.Activity

Methods inherited from class android.view.ContextThemeWrapper

Methods inherited from class android.content.ContextWrapper

Methods inherited from class android.content.Context

Methods inherited from class java.lang.Object

Field Detail

SMALLSIZE

MEDIUMSIZE

BIGSIZE

MAXSPEED

BLACK

BLUE

CYAN

DKGRAY

GRAY

GREEN

LTGRAY

MAGENTA

RED

TRANSPARENT

WHITE

YELLOW

Constructor Detail

Playground

Playground

Method Detail

getPlaygroundColor

getZoomFactor

playgroundPressed

playgroundReleased

playgroundLongPressed

playgroundClicked

playgroundDragged

turtleClicked

turtleDragged

turtlePressed

turtleReleased

turtleLongPressed

showToast

getTurtlesNear

getTopTurtleNear

setSpeed

getSpeed

forward

fd

back

bk

right

rt

left

lt

beep

clean

clean

clear

clear

hideTurtle

ht

isHidden

showTurtle

st

getColor

setColor

setSize

getHeading

setHeading

towards

home

isPenDown

penDown

pd

penUp