ch.aplu.ev3

Class LegoContext

java.lang.Object

ch.aplu.ev3.LegoContext

public class LegoContext
extends java.lang.Object

Dummy class to make EV3JLib source compatible with LegoSim. All methods are empty.

Field Summary

Fields

Modifier and Type	Field and Description
static Obstacle	box Box obstacle.
static Obstacle	channel Channel obstacle.

Method Summary

Methods

Modifier and Type	Method and Description
static void	init() Initializes the static context.
static void	setLocation(int x, int y) Sets the location of the playground (pixel coordinates of the upper left vertex).
static void	setStartDirection(double direction) Sets the EV3 starting direction (zero to EAST).
static void	setStartPosition(int x, int y) Sets the EV3 starting position (x-y-coordinates 0..500, origin at upper left).
static void	setStatusText(java.lang.String text) Displays the given text in the status bar (if available).
static void	showStatusBar(int height) Shows a status bar with given height.
static void	useBackground(java.lang.String filename) Use the give image as background (playground size 501 x 501).
static void	useObstacle(java.awt.image.BufferedImage bi, int x, int y) Defines the given buffered image to be used as touch obstacle.
static void	useObstacle(GGBitmap bm, int x, int y) Defines the given GGBitmap to be used as touch obstacle.
static void	useObstacle(Obstacle obstacle) Defines the given obstacle to be used as touch obstacle.
static void	useObstacle(Obstacle obstacle, int x, int y) Defines the given obstacle to be used as touch obstacle.
static void	useObstacle(java.lang.String filename, int x, int y) Defines the given sprite image to be used as touch obstacle.
static Target	useTarget(java.awt.image.BufferedImage bi, java.awt.Point[] mesh, int x, int y) Creates a target for the ultrasonic sensor using the given buffered image.
static Target	useTarget(GGBitmap bm, java.awt.Point[] mesh, int x, int y) Creates a target for the ultrasonic sensor using the given GGBitmap.
static Target	useTarget(java.lang.String filename, int[][] mesh, int x, int y) Creates a target for the ultrasonic sensor using the given sprite image.
static Target	useTarget(java.lang.String filename, java.awt.Point[] mesh, int x, int y) Creates a target for the ultrasonic sensor using the given sprite image.
static Target	useTarget(Target target, int x, int y) Defines a clone of the given target to be used as target.

Methods inherited from class java.lang.Object

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

Field Detail

box

public static Obstacle box

Box obstacle.

channel

public static Obstacle channel

Channel obstacle.

Method Detail

init

public static void init()

Initializes the static context. This may be necessary in Python environment, where static contexts is not reloaded automatically. Empty method for compatibility with LegoSim.

useBackground

public static void useBackground(java.lang.String filename)

Use the give image as background (playground size 501 x 501). Empty method for compatibility with LegoSim.

Parameters:

filename - the image file to use as background.

setStartPosition

public static void setStartPosition(int x,
                    int y)

Sets the EV3 starting position (x-y-coordinates 0..500, origin at upper left). Empty method for compatibility with LegoSim.

Parameters:

x - the x-coordinate of the starting position

y - the y-coordinate of the starting position

setStartDirection

public static void setStartDirection(double direction)

Sets the EV3 starting direction (zero to EAST). Empty method for compatibility with LegoSim.

Parameters:

direction - the starting direction in degrees)

setLocation

public static void setLocation(int x,
               int y)

Sets the location of the playground (pixel coordinates of the upper left vertex). Empty method for compatibility with LegoSim.

Parameters:

x - the x-pixel-coordinate of the upper left vertex (positive to the right)

y - the y-pixel-coordinate of the upper left vertex (positive to the bottom)

useObstacle

public static void useObstacle(java.lang.String filename,
               int x,
               int y)

Defines the given sprite image to be used as touch obstacle. It will be shown at the given position. More than one obstacle may be defined. The touch is detected by a JGameGrid collision with a non-transparent pixel of the obstacle sprite image. Empty method for compatibility with LegoSim.

Parameters:

filename - the image file of the obstacle

x - the x-coordinate of the image center

y - the y-coordinate of the image center

useObstacle

public static void useObstacle(java.awt.image.BufferedImage bi,
               int x,
               int y)

Defines the given buffered image to be used as touch obstacle. It will be shown at the given position. More than one obstacle may be defined. The touch is detected by a JGameGrid collision with a non-transparent pixel of the obstacle sprite image. Empty method for compatibility with LegoSim.

Parameters:

bi - the buffered image of the obstacle

x - the x-coordinate of the image center

y - the y-coordinate of the image center

useObstacle

public static void useObstacle(Obstacle obstacle,
               int x,
               int y)

Defines the given obstacle to be used as touch obstacle. It will be shown at the given position. More than one obstacle may be defined. The touch is detected by a JGameGrid collision with a non-transparent pixel of the obstacle sprite image. Empty method for compatibility with LegoSim.

Parameters:

obstacle - the obstacle to use

x - the x-coordinate of the image center

y - the y-coordinate of the image center

useObstacle

public static void useObstacle(Obstacle obstacle)

Defines the given obstacle to be used as touch obstacle. It will be shown at the center of the simulation window. More than one obstacle may be defined. The touch is detected by a JGameGrid collision with a non-transparent pixel of the obstacle sprite image. Empty method for compatibility with LegoSim.

Parameters:

obstacle - the obstacle to use

useObstacle

public static void useObstacle(GGBitmap bm,
               int x,
               int y)

Defines the given GGBitmap to be used as touch obstacle. It will be shown at the given position. More than one obstacle may be defined. The touch is detected by a JGameGrid collision with a non-transparent pixel of the obstacle sprite image. Empty method for compatibility with LegoSim.

Parameters:

bm - the GGBitmap to be used as obstacle

x - the x-coordinate of the image center

y - the y-coordinate of the image center

useTarget

public static Target useTarget(java.lang.String filename,
               int[][] mesh,
               int x,
               int y)

Creates a target for the ultrasonic sensor using the given sprite image. The EV3Robot constructor displays all targets known at this time. Targets are scaned by the ultrasonic sensor using the mesh triangles. The mesh triangles contain the image center and two successive mesh points. The coordinate system for the mesh has its origin in the center location with pixel coordinates x to the right and y to the bottom. Empty method for compatibility with LegoSim.

Parameters:

filename - the image file of the target

mesh - the integer array of mesh points (as x-y-coordinates array) (at least 2)

x - the x-coordinate of the image center

y - the y-coordinate of the image center

Returns:

the reference of the created target

useTarget

public static Target useTarget(java.lang.String filename,
               java.awt.Point[] mesh,
               int x,
               int y)

Creates a target for the ultrasonic sensor using the given sprite image. The EV3Robot constructor displays all targets known at this time. Targets are scaned by the ultrasonic sensor using the mesh triangles. The mesh triangles contain the image center and two successive mesh points. The coordinate system for the mesh has its origin in the center location with pixel coordinates x to the right and y to the bottom. Empty method for compatibility with LegoSim.

Parameters:

filename - the image file of the target

mesh - the mesh points (at least 2)

x - the x-coordinate of the image center

y - the y-coordinate of the image center

Returns:

the reference of the created target

useTarget

public static Target useTarget(java.awt.image.BufferedImage bi,
               java.awt.Point[] mesh,
               int x,
               int y)

Creates a target for the ultrasonic sensor using the given buffered image. The EV3Robot constructor displays all targets known at this time. Targets are scaned by the ultrasonic sensor using the mesh triangles. The mesh triangles contain the image center and two successive mesh points. The coordinate system for the mesh has its origin in the center location with pixel coordinates x to the right and y to the bottom. Empty method for compatibility with LegoSim.

Parameters:

bi - the buffered image of the target

mesh - the mesh points (at least 2)

x - the x-coordinate of the image center

y - the y-coordinate of the image center

Returns:

the reference of the created target

useTarget

public static Target useTarget(GGBitmap bm,
               java.awt.Point[] mesh,
               int x,
               int y)

Creates a target for the ultrasonic sensor using the given GGBitmap. The EV3Robot constructor displays all targets known at this time. Targets are scaned by the ultrasonic sensor using the mesh triangles. The mesh triangles contain the image center and two successive mesh points. The coordinate system for the mesh has its origin in the center location with pixel coordinates x to the right and y to the bottom. Empty method for compatibility with LegoSim.

Parameters:

bm - the GGBitmap to be used as target

mesh - the mesh points (at least 2)

x - the x-coordinate of the image center

y - the y-coordinate of the image center

Returns:

the reference of the created target

useTarget

public static Target useTarget(Target target,
               int x,
               int y)

Defines a clone of the given target to be used as target. It will be shown at the given position. More than one target may be defined. The target is detected by the ultrasonic sensor using the mesh triangles. Empty method for compatibility with LegoSim.

Parameters:

target - the target to define the clone

x - the x-coordinate of the image center

y - the y-coordinate of the image center

Returns:

the reference of the target clone

showStatusBar

public static void showStatusBar(int height)

Shows a status bar with given height. System.out is redirected to the status bar. All print(), println(), printf() methods are available. Each invocation erases the old content. Empty method for compatibility with LegoSim.

Parameters:

height - the height of the status window in pixels.

setStatusText

public static void setStatusText(java.lang.String text)

Displays the given text in the status bar (if available). Empty method for compatibility with LegoSim.

Parameters:

text - the text to display.