ch.aplu.android

Class GGPanel

java.lang.Object

ch.aplu.android.GGBackground

ch.aplu.android.GGPanel

public class GGPanel
extends GGBackground

Class derived from GGBackground with a user-definable double coordinate system. All passed coordinates in the drawing methods are user coordinates. Default coordinate system xmin = 0, xmax = 1, ymin = 0, ymax = 1. All graphics drawing methods refresh the game grid, so each action is visible. To speed-up the drawing, you may disable the automatic refresh by calling setAutoRefreshEnabled(false).

Method Summary

Methods

Modifier and Type	Method and Description
void	arc(double radius, double startAngle, double extentAngle, boolean fill) Draws an arc (without bounding lines to center) with center at current graph position, radius in user x-coordinates, start angle and angle extent.
void	arc(double centerX, double centerY, double radius, double startAngle, double extentAngle, boolean fill) Draws an arc (without bounding lines to center) with given center coordinates, radius in user x-coordinates, start angle and angle extent.
void	arc(PointD center, double radius, double startAngle, double extentAngle, boolean fill) Draws an arc (without bounding lines to center) with given center, radius in user x-coordinates, start angle and angle extent.
void	circle(double radius, boolean fill) Draws a circle with center at current graph position and given radius in user x-coordinates.
void	circle(double centerX, double centerY, double radius, boolean fill) Draws a circle with given center coordinates and given radius in user x-coordinates.
void	circle(PointD center, double radius, boolean fill) Draws a circle with given center and given radius in user x-coordinates.
void	clean() Clears the frame buffer by painting it with the current background color.
void	color(int color) Sets the current paint color.
void	draw(double x, double y) Draws a line from current graph position to the given coordinates and sets the graph position to these coordinates.
void	draw(PointD pt) Draws a line from current graph position to the given point and sets the graph position to this point.
void	erase() Same as clear(), but remains the current graph position unchanged.
double	getUserHeight() Returns the height (y-direction) in user coordinates.
double	getUserWidth() Returns the width (x-direction) in user coordinates.
double	getXmax() Returns the right value of the x-coordinate axis.
double	getXmin() Returns the left value of the x-coordinate axis.
double	getYmax() Returns the top value of the y-coordinate axis.
double	getYmin() Returns the bottom value of the y-coordinate axis.
void	line(double x1, double y1, double x2, double y2) Draws a line from (x1, y1) to (x2, y2)
void	line(PointD pt1, PointD pt2) Draws a line from the first vertext to the second vertex.
void	move(double x, double y) Sets the current graph position to the given coordinates (without drawin anything).
void	move(PointD pt) Sets the current graph position to the given point (without drawin anything).
void	point() Draws a single point at the current graph position.
void	point(double x, double y) Draws a single point at given coordinates.
void	point(PointD pt) Draws a single point at given coordinates.
void	polygon(double[] x, double[] y, boolean fill) Draws a polygon with given vertexes.
void	polygon(PointD[] vertexes, boolean fill) Draws a polygon with given vertexes.
void	rectangle(double width, double height, boolean fill) Draws a rectangle with center at the current graph position and given width and height.
void	rectangle(double x1, double y1, double x2, double y2, boolean fill) Draws/fills a rectangle with given opposite vertexes.
void	rectangle(PointD pt1, PointD pt2, boolean fill) Draws a rectangle with given opposite vertexes.
void	sector(double radius, double startAngle, double extentAngle, boolean fill) Draws a sector (arc with bounding lines to center, pie) with center at current graph position, radius in user x-coordinates, start angle and angle extent.
void	sector(double centerX, double centerY, double radius, double startAngle, double extentAngle, boolean fill) Draws a sector (arc with bounding lines to center, pie) with given center coordinates, radius in user x-coordinates, start angle and angle extent.
void	sector(PointD center, double radius, double startAngle, double extentAngle, boolean fill) Draws a sector (arc with bounding lines to center, pie) with given center, radius in user x-coordinates, start angle and angle extent.
void	setAutoRefreshEnabled(boolean enable) Enables the automatic refresh in every drawing method.
int	toPixelDx(double dx) Transforms horizontal user coordinates increment to pixel increment.
int	toPixelDy(double dy) Transforms vertical user coordinates increment to pixel increment.
android.graphics.Point	toPixelPoint(PointD pt) Transforms horizontal user coordinates to pixel coordinates.
int	toPixelX(double x) Transforms horizontal user coordinates to pixel coordinates.
int	toPixelY(double y) Transforms vertical user coordinates to pixel coordinates.
double	toUserDx(int dx) Transforms horizontal pixel coordinates increment to user increment.
double	toUserDy(int dy) Transforms vertical pixel coordinates increment to user increment.
PointD	toUserPoint(android.graphics.Point ptPix) Transforms pixel coordinates to user coordinates.
double	toUserX(int xPix) Transforms horizontal pixel coordinates to user coordinates.
double	toUserY(int yPix) Transforms vertical pixel coordinates to user coordinates.
void	triangle(double x1, double y1, double x2, double y2, double x3, double y3, boolean fill) Draws a triangle with given vertexes.
void	triangle(PointD pt1, PointD pt2, PointD pt3, boolean fill) Draws a triangle with given vertexes.
void	window(double ymin, double ymax, double xratio) Sets the user coordinate system (x from left to right, y from bottom to top).
void	window(double xmin, double xmax, double ymin, double ymax) Sets the user coordinate system (x from left to right, y from bottom to top).

Methods inherited from class ch.aplu.android.GGBackground

_drawRectangle, clear, clear, drawArc, drawCircle, drawFrame, drawGridLines, drawImage, drawLine, drawLine, drawPoint, drawPolygon, drawRectangle, drawRectangle, drawRectangle, drawSector, drawSprite, drawText, fillArc, fillCell, fillCell, fillCircle, fillPolygon, fillRectangle, fillRectangle, fillSector, floodFill, getBgAry, getBgBitmap, getBgBuffer, getBgColor, getBgImage, getCanvas, getColor, getColor, getLineWidth, getPaintColor, getShader, restore, save, setLineWidth, setPaintColor, setPaintMode, setShader, setXORMode

Methods inherited from class java.lang.Object

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

Method Detail

toPixelX

public int toPixelX(double x)

Transforms horizontal user coordinates to pixel coordinates.

Parameters:

x - the user x-coordinate

Returns:

the pixel x-coordinate

toPixelDx

public int toPixelDx(double dx)

Transforms horizontal user coordinates increment to pixel increment.

Parameters:

dx - the user x increment

Returns:

the pixel x increment

toPixelDy

public int toPixelDy(double dy)

Transforms vertical user coordinates increment to pixel increment.

Parameters:

dy - the user y increment

Returns:

the pixel y increment

toUserDx

public double toUserDx(int dx)

Transforms horizontal pixel coordinates increment to user increment.

Parameters:

dx - the pixel x increment

Returns:

the user x increment

toUserDy

public double toUserDy(int dy)

Transforms vertical pixel coordinates increment to user increment.

Parameters:

dy - the pixel y increment

Returns:

the user y increment

toPixelY

public int toPixelY(double y)

Transforms vertical user coordinates to pixel coordinates.

Parameters:

y - the user y-coordinate

Returns:

the pixel y-coordinate

toPixelPoint

public android.graphics.Point toPixelPoint(PointD pt)

Transforms horizontal user coordinates to pixel coordinates.

Parameters:

pt - the user x-y-coordinates

Returns:

the pixel x-y-coordinate

toUserX

public double toUserX(int xPix)

Transforms horizontal pixel coordinates to user coordinates.

Parameters:

xPix - the pixel x-coordinate

Returns:

the user x-coordinate

toUserY

public double toUserY(int yPix)

Transforms vertical pixel coordinates to user coordinates.

Parameters:

yPix - the pixel x-coordinate

Returns:

the user y-coordinate

toUserPoint

public PointD toUserPoint(android.graphics.Point ptPix)

Transforms pixel coordinates to user coordinates.

Parameters:

ptPix - the pixel x-y-coordinates

Returns:

the user x-y-coordinates

window

public void window(double xmin,
          double xmax,
          double ymin,
          double ymax)

Sets the user coordinate system (x from left to right, y from bottom to top).

Parameters:

xmin - x-axis value at left

xmax - x-axis value at right

ymin - y-axis value at bottom

ymax - y-axis value at top

window

public void window(double ymin,
          double ymax,
          double xratio)

Sets the user coordinate system (x from left to right, y from bottom to top). The coordinate system has same units on x and y axis.

Parameters:

ymin - y-axis value at bottom

ymax - y-axis value at top

xratio - the fractional part of window width (x direction) where the origin is placed

line

public void line(double x1,
        double y1,
        double x2,
        double y2)

Draws a line from (x1, y1) to (x2, y2)

Parameters:

x1 - the x-coordinate of the first vertex.

y1 - the y-coordinate of the first vertex.

x2 - the x-coordinate of the second vertex.

y2 - the y-coordinate of the second vertex.

line

public void line(PointD pt1,
        PointD pt2)

Draws a line from the first vertext to the second vertex.

Parameters:

pt1 - the first vertex

pt2 - the second vertex

move

public void move(double x,
        double y)

Sets the current graph position to the given coordinates (without drawin anything).

Parameters:

x - the x-coordinate of the graph position

y - the y-coordinate of the graph position

move

public void move(PointD pt)

Sets the current graph position to the given point (without drawin anything).

Parameters:

pt - the new graph position

draw

public void draw(double x,
        double y)

Draws a line from current graph position to the given coordinates and sets the graph position to these coordinates.

Parameters:

x - the x-coordinate of the end point

y - the y-coordinate of the end point

draw

public void draw(PointD pt)

Draws a line from current graph position to the given point and sets the graph position to this point.

Parameters:

pt - the end point

circle

public void circle(double centerX,
          double centerY,
          double radius,
          boolean fill)

Draws a circle with given center coordinates and given radius in user x-coordinates. The graph position is unchanged.

Parameters:

centerX - the x-coordinate of the center

centerY - the y-coordinate of the center

radius - the radius in x-coordinate units

fill - if true, the shape is filled

circle

public void circle(PointD center,
          double radius,
          boolean fill)

Draws a circle with given center and given radius in user x-coordinates. The graph position is unchanged.

Parameters:

center - the center of the circle

radius - the radius in x-coordinate units

fill - if true, the shape is filled

circle

public void circle(double radius,
          boolean fill)

Draws a circle with center at current graph position and given radius in user x-coordinates. The graph position is unchanged.

Parameters:

radius - the radius in x-coordinate units

fill - if true, the shape is filled

rectangle

public void rectangle(double x1,
             double y1,
             double x2,
             double y2,
             boolean fill)

Draws/fills a rectangle with given opposite vertexes. and given width and height. The graph position is unchanged.

Parameters:

x1 - x-coordinate of the first vertex

y1 - y-coordinate of the first vertex

x2 - x-coordinate of the opposite vertex

y2 - y-coordinate of the opposite vertex

fill - if true, the shape is filled

rectangle

public void rectangle(PointD pt1,
             PointD pt2,
             boolean fill)

Draws a rectangle with given opposite vertexes. The graph position is unchanged.

Parameters:

pt1 - the first vertex

pt2 - the opposite vertex

fill - if true, the shape is filled

rectangle

public void rectangle(double width,
             double height,
             boolean fill)

Draws a rectangle with center at the current graph position and given width and height. The graph position is unchanged.

Parameters:

width - the width of the rectangle

height - the height of the rectangle

fill - if true, the shape is filled

arc

public void arc(double centerX,
       double centerY,
       double radius,
       double startAngle,
       double extentAngle,
       boolean fill)

Draws an arc (without bounding lines to center) with given center coordinates, radius in user x-coordinates, start angle and angle extent. The graph position is unchanged.

Parameters:

centerX - the x-coordinate of the center

centerY - the y-coordinate of the center

radius - the radius in x-coordinate units

startAngle - the start angle in degrees (zero at east, positive counter-clockwise)

extentAngle - the angle extent in degrees

fill - if true, the shape is filled

arc

public void arc(PointD center,
       double radius,
       double startAngle,
       double extentAngle,
       boolean fill)

Draws an arc (without bounding lines to center) with given center, radius in user x-coordinates, start angle and angle extent. The graph position is unchanged.

Parameters:

center - the center of the arc

radius - the radius in x-coordinate units

startAngle - the start angle in degrees (zero at east, positive counter-clockwise)

extentAngle - the angle extent in degrees

fill - if true, the shape is filled

arc

public void arc(double radius,
       double startAngle,
       double extentAngle,
       boolean fill)

Draws an arc (without bounding lines to center) with center at current graph position, radius in user x-coordinates, start angle and angle extent. The graph position is unchanged.

Parameters:

radius - the radius in x-coordinate units

startAngle - the start angle in degrees (zero at east, positive counter-clockwise)

extentAngle - the angle extent in degrees

fill - if true, the shape is filled

sector

public void sector(double centerX,
          double centerY,
          double radius,
          double startAngle,
          double extentAngle,
          boolean fill)

Draws a sector (arc with bounding lines to center, pie) with given center coordinates, radius in user x-coordinates, start angle and angle extent. The graph position is unchanged.

Parameters:

centerX - the x-coordinate of the center

centerY - the y-coordinate of the center

radius - the radius in x-coordinate units

startAngle - the start angle in degrees (zero at east, positive counter-clockwise)

extentAngle - the angle extent in degrees

fill - if true, the shape is filled

sector

public void sector(PointD center,
          double radius,
          double startAngle,
          double extentAngle,
          boolean fill)

Draws a sector (arc with bounding lines to center, pie) with given center, radius in user x-coordinates, start angle and angle extent. The graph position is unchanged.

Parameters:

center - the center of the arc

radius - the radius in x-coordinate units

startAngle - the start angle in degrees (zero at east, positive counter-clockwise)

extentAngle - the angle extent in degrees

fill - if true, the shape is filled

sector

public void sector(double radius,
          double startAngle,
          double extentAngle,
          boolean fill)

Draws a sector (arc with bounding lines to center, pie) with center at current graph position, radius in user x-coordinates, start angle and angle extent. The graph position is unchanged.

Parameters:

radius - the radius in x-coordinate units

startAngle - the start angle in degrees (zero at east, positive counter-clockwise)

extentAngle - the angle extent in degrees

fill - if true, the shape is filled

polygon

public void polygon(double[] x,
           double[] y,
           boolean fill)

Draws a polygon with given vertexes. (Both arrays must be of equal size.) The graph position is unchanged.

Parameters:

x - an array of the x-coordinates of the vertexes

y - an array of the y-coordinates of the vertexes

fill - if true, the shape is filled

polygon

public void polygon(PointD[] vertexes,
           boolean fill)

Draws a polygon with given vertexes. The graph position is unchanged.

Parameters:

vertexes - an array of the vertexes

fill - if true, the shape is filled

triangle

public void triangle(double x1,
            double y1,
            double x2,
            double y2,
            double x3,
            double y3,
            boolean fill)

Draws a triangle with given vertexes. The graph position is unchanged.

Parameters:

x1 - the x-coordinate of the first vertex

y1 - the y-coordinate of the first vertex

x2 - the x-coordinate of the second vertex

y2 - the y-coordinate of the second vertex

x3 - the x-coordinate of the third vertex

y3 - the y-coordinate of the third vertex

fill - if true, the shape is filled

triangle

public void triangle(PointD pt1,
            PointD pt2,
            PointD pt3,
            boolean fill)

Draws a triangle with given vertexes. The graph position is unchanged.

Parameters:

pt1 - the first vertex

pt2 - the second vertex

pt3 - the third vertex

fill - if true, the shape is filled

point

public void point(double x,
         double y)

Draws a single point at given coordinates.

Parameters:

x - the x-coordinate of the point

y - the y-coordinate of the point

point

public void point(PointD pt)

Draws a single point at given coordinates.

Parameters:

pt - the point where to draw

point

public void point()

Draws a single point at the current graph position.

clean

public void clean()

Clears the frame buffer by painting it with the current background color. Draws an available background image and the grid lines into the frame buffer. Sets the current graph position to (0, 0). Renders the frame buffer to the screen unless setRefreshEnabled(false) was called.

erase

public void erase()

Same as clear(), but remains the current graph position unchanged.

getXmin

public double getXmin()

Returns the left value of the x-coordinate axis.

Returns:

xmin

getXmax

public double getXmax()

Returns the right value of the x-coordinate axis.

Returns:

xmax

getYmin

public double getYmin()

Returns the bottom value of the y-coordinate axis.

Returns:

xmin

getYmax

public double getYmax()

Returns the top value of the y-coordinate axis.

Returns:

xmin

color

public void color(int color)

Sets the current paint color.

Parameters:

color - the new paint color

getUserWidth

public double getUserWidth()

Returns the width (x-direction) in user coordinates.

Returns:

the width in user coordinates.

getUserHeight

public double getUserHeight()

Returns the height (y-direction) in user coordinates.

Returns:

the height in user coordinates.

setAutoRefreshEnabled

public void setAutoRefreshEnabled(boolean enable)

Enables the automatic refresh in every drawing method.

Parameters:

enable - if true, the automatic refresh is enabled; otherwise disabled