Graphicspublic class Graphics extends Object | Provides simple 2D geometric rendering capability.
Drawing primitives are provided for text, images, lines, rectangles,
and arcs. Rectangles and arcs may also be filled with a solid color.
Rectangles may also be specified with rounded corners.
A 24-bit color model is provided, with
8 bits for each of red, green, and
blue components of a color. Not all devices support a full
24 bits' worth
of color and thus they will map colors requested by the application into
colors available on the device. Facilities are provided in the
{@link
Display Display} class for obtaining device characteristics, such
as
whether color is available and how many distinct gray levels are
available.
Applications may also use {@link Graphics#getDisplayColor(int)
getDisplayColor()} to obtain the actual color that would be displayed
for a requested color.
This enables applications to adapt their behavior to a device without
compromising device independence.
For all rendering operations, source pixels are always combined with
destination pixels using the Source Over Destination rule
[Porter-Duff]. Other schemes for combining source pixels with destination
pixels, such as raster-ops, are not provided.
For the text, line, rectangle, and arc drawing and filling primitives,
the source pixel is a pixel representing the current color of the graphics
object being used for rendering. This pixel is always considered to be
fully opaque. With source pixel that is always fully opaque, the Source
Over Destination rule has the effect of pixel replacement, where
destination pixels are simply replaced with the source pixel from the
graphics object.
The {@link #drawImage drawImage()} and {@link #drawRegion drawRegion()}
methods use an image as the source for rendering operations instead of the
current color of the graphics object. In this context, the Source Over
Destination rule has the following properties: a fully opaque pixel in the
source must replace the destination pixel, a fully transparent pixel in the
source must leave the destination pixel unchanged, and a semitransparent
pixel in the source must be alpha blended with the destination pixel.
Alpha blending of semitransparent pixels is required. If an implementation
does not support alpha blending, it must remove all semitransparency from
image source data at the time the image is created. See Alpha Processing for further discussion.
The destinations of all graphics rendering are considered to consist
entirely of fully opaque pixels. A property of the Source Over Destination
rule is that compositing any pixel with a fully opaque destination pixel
always results in a fully opaque destination pixel. This has the effect of
confining full and partial transparency to immutable images, which may only
be used as the source for rendering operations.
Graphics may be rendered directly to the display or to an off-screen
image buffer. The destination of rendered graphics depends on the
provenance of the graphics object. A graphics object for rendering
to the display is passed to the Canvas object's
{@link Canvas#paint(Graphics) paint()}
method. This is the only means by which a graphics object may
be obtained whose destination is the display. Furthermore, applications
may draw using this graphics object only for the duration of the
paint() method.
A graphics object for rendering to an off-screen image buffer may
be obtained by calling the
{@link Image#getGraphics() getGraphics()}
method on the desired image.
A graphics object so obtained may be held indefinitely
by the application, and requests may be issued on this graphics
object at any time.
The default coordinate system's origin is at the
upper left-hand corner of the destination. The X-axis direction is
positive towards the right, and the Y-axis direction is positive
downwards. Applications may assume that horizontal and vertical
distances in the coordinate system represent equal distances on the
actual device display, that is, pixels are square. A facility is provided
for translating the origin of the coordinate system.
All coordinates are specified as integers.
The coordinate system represents locations between pixels, not the
pixels themselves. Therefore, the first pixel in the upper left corner
of the display lies in the square bounded by coordinates
(0,0) , (1,0) , (0,1) , (1,1).
Under this definition, the semantics for fill operations are clear.
Since coordinate grid lines lie between pixels, fill operations
affect pixels that lie entirely within the region bounded by the
coordinates of the operation. For example, the operation
paints exactly six pixels. (In this example, and in all subsequent
examples, the variable g is assumed to contain a
reference to a
Graphics object.)
Each character of a font contains a set of pixels that forms the shape of
the character. When a character is painted, the pixels forming the
character's shape are filled with the Graphics
object's current color, and
the pixels not part of the character's shape are left untouched.
The text drawing calls
{@link #drawChar drawChar()},
{@link #drawChars drawChars()},
{@link #drawString drawString()}, and
{@link #drawSubstring drawSubstring()}
all draw text in this manner.
Lines, arcs, rectangles, and rounded rectangles may be drawn with either a
SOLID or a DOTTED stroke style, as set by
the {@link #setStrokeStyle
setStrokeStyle()} method. The stroke style does not affect fill, text, and
image operations.
For the SOLID stroke style,
drawing operations are performed with a one-pixel wide pen that fills
the pixel immediately
below and to the right of the specified coordinate. Drawn lines
touch pixels at both endpoints. Thus, the operation
paints exactly one pixel, the first pixel in the upper left corner
of the display.
Drawing operations under the DOTTED stroke style will
touch a subset of
pixels that would have been touched under the SOLID
stroke style. The
frequency and length of dots is implementation-dependent. The endpoints of
lines and arcs are not guaranteed to be drawn, nor are the corner points of
rectangles guaranteed to be drawn. Dots are drawn by painting with the
current color; spaces between dots are left untouched.
An artifact of the coordinate system is that the area affected by a fill
operation differs slightly from the area affected by a draw operation given
the same coordinates. For example, consider the operations
g.fillRect(x, y, w, h); // 1
g.drawRect(x, y, w, h); // 2
|
Statement (1) fills a rectangle w pixels wide and
h pixels high.
Statement (2) draws a rectangle whose left and top
edges are within the area filled by statement (1). However, the
bottom and right edges lie one pixel outside the filled area.
This is counterintuitive, but it preserves the invariant that
g.drawLine(x, y, x+w, y);
g.drawLine(x+w, y, x+w, y+h);
g.drawLine(x+w, y+h, x, y+h);
g.drawLine(x, y+h, x, y);
|
has an effect identical to statement (2) above.
The exact pixels painted by drawLine() and
drawArc() are not
specified. Pixels touched by a fill operation must either
exactly overlap or directly abut pixels touched by the
corresponding draw operation. A fill operation must never leave
a gap between the filled area and the pixels touched by the
corresponding draw operation, nor may the fill operation touch
pixels outside the area bounded by the corresponding draw operation.
Clipping
The clip is the set of pixels in the destination of the
Graphics object that may be modified by graphics rendering
operations.
There is a single clip per Graphics object.
The only pixels modified by graphics operations are those that lie within the
clip. Pixels outside the clip are not modified by any graphics operations.
Operations are provided for intersecting the current clip with
a given rectangle and for setting the current clip outright.
The application may specify the clip by supplying a clip rectangle
using coordinates relative to the current coordinate system.
It is legal to specify a clip rectangle whose width or height is zero
or negative. In this case the clip is considered to be empty,
that is, no pixels are contained within it.
Therefore, if any graphics operations are issued under such a clip,
no pixels will be modified.
It is legal to specify a clip rectangle that extends beyond or resides
entirely beyond the bounds of the destination. No pixels exist outside
the bounds of the destination, and the area of the clip rectangle
that is outside the destination is ignored. Only the pixels that lie
both within the destination and within the specified clip rectangle
are considered to be part of the clip.
Operations on the coordinate system,
such as {@link Graphics#translate(int, int) translate()},
do not modify the clip.
The methods
{@link Graphics#getClipX() getClipX()},
{@link Graphics#getClipY() getClipY()},
{@link Graphics#getClipWidth() getClipWidth()} and
{@link Graphics#getClipHeight() getClipHeight()}
must return a rectangle that,
if passed to setClip without an intervening change to
the Graphics object's coordinate system, must result in
the identical set of pixels in the clip.
The rectangle returned from the getClip family of methods
may differ from the clip rectangle that was requested in
{@link Graphics#setClip(int, int, int, int) setClip()}.
This can occur if the coordinate system has been changed or if
the implementation has chosen to intersect the clip rectangle
with the bounds of the destination of the Graphics object.
If a graphics operation is affected by the clip, the pixels
touched by that operation must be the same ones that would be touched
as if the clip did not affect the operation. For example,
consider a clip represented by the rectangle (cx, cy, cw, ch)
and a point (x1, y1) that
lies outside this rectangle and a point (x2, y2)
that lies within this
rectangle. In the following code fragment,
g.setClip(0, 0, canvas.getWidth(),
canvas.getHeight());
g.drawLine(x1, y1, x2, y2); // 3
g.setClip(cx, cy, cw, ch);
g.drawLine(x1, y1, x2, y2); // 4
|
The pixels touched by statement (4) must be identical to the pixels
within (cx, cy, cw, ch) touched by statement (3).
Anchor Points
The drawing of text is based on "anchor points".
Anchor points are used to minimize the amount of
computation required when placing text.
For example, in order to center a piece of text,
an application needs to call stringWidth() or
charWidth() to get the width and then perform a
combination of subtraction and division to
compute the proper location.
The method to draw text is defined as follows:
public void drawString(String text, int x, int y, int anchor);
This method draws text in the current color,
using the current font
with its anchor point at (x,y). The definition
of the anchor point must be one of the
horizontal constants (LEFT, HCENTER, RIGHT)
combined with one of the vertical constants
(TOP, BASELINE, BOTTOM) using the bit-wise
OR operator.
Zero may also be used as the value of an anchor point.
Using zero for the anchor point value gives results
identical to using TOP | LEFT.
Vertical centering of the text is not specified since it is not considered
useful, it is hard to specify, and it is burdensome to implement. Thus,
the VCENTER value is not allowed in the anchor point
parameter of text
drawing calls.
The actual position of the bounding box
of the text relative to the (x, y) location is
determined by the anchor point. These anchor
points occur at named locations along the
outer edge of the bounding box. Thus, if f
is g's current font (as returned by
g.getFont(), the following calls will all have
identical results:
g.drawString(str, x, y, TOP|LEFT);
g.drawString(str, x + f.stringWidth(str)/2, y, TOP|HCENTER);
g.drawString(str, x + f.stringWidth(str), y, TOP|RIGHT);
g.drawString(str, x,
y + f.getBaselinePosition(), BASELINE|LEFT);
g.drawString(str, x + f.stringWidth(str)/2,
y + f.getBaselinePosition(), BASELINE|HCENTER);
g.drawString(str, x + f.stringWidth(str),
y + f.getBaselinePosition(), BASELINE|RIGHT);
drawString(str, x,
y + f.getHeight(), BOTTOM|LEFT);
drawString(str, x + f.stringWidth(str)/2,
y + f.getHeight(), BOTTOM|HCENTER);
drawString(str, x + f.stringWidth(str),
y + f.getHeight(), BOTTOM|RIGHT);
|
For text drawing, the inter-character and inter-line spacing (leading)
specified by the font designer are included as part of the values returned
in the {@link Font#stringWidth(java.lang.String) stringWidth()}
and {@link Font#getHeight() getHeight()}
calls of class {@link Font Font}.
For example, given the following code:
// (5)
g.drawString(string1+string2, x, y, TOP|LEFT);
// (6)
g.drawString(string1, x, y, TOP|LEFT);
g.drawString(string2, x + f.stringWidth(string1), y, TOP|LEFT);
|
Code fragments (5) and (6) behave similarly if not identically. This
occurs because f.stringWidth()
includes the inter-character spacing. The exact spacing of may differ
between these calls if the system supports font kerning.
Similarly, reasonable vertical spacing may be
achieved simply by adding the font height
to the Y-position of subsequent lines. For example:
g.drawString(string1, x, y, TOP|LEFT);
g.drawString(string2, x, y + f.fontHeight(), TOP|LEFT);
|
draws string1 and string2 on separate lines with
an appropriate amount of inter-line spacing.
The stringWidth() of the string and the
fontHeight() of the font in which
it is drawn define the size of the bounding box of a piece of text. As
described above, this box includes inter-line and inter-character spacing.
The implementation is required to put this space below and to right of the
pixels actually belonging to the characters drawn. Applications that wish
to position graphics closely with respect to text (for example, to paint a
rectangle around a string of text) may assume that there is space below and
to the right of a string and that there is no space above
and to the
left of the string.
Anchor points are also used for positioning of images. Similar to text
drawing, the anchor point for an image specifies the point on the bounding
rectangle of the destination that is to positioned at the
(x,y) location
given in the graphics request. Unlike text, vertical centering of images
is well-defined, and thus the VCENTER value may be
used within the anchor
point parameter of image drawing requests. Because images have no notion
of a baseline, the BASELINE value may not be used
within the anchor point
parameter of image drawing requests.
Reference
- Porter-Duff
- Porter, T., and T. Duff. "Compositing Digital Images."
Computer Graphics V18 N3 (SIGGRAPH 1984), p. 253-259.
|
| Fields Summary |
|---|
| public static final int | HCENTERConstant for centering text and images horizontally
around the anchor point
Value 1 is assigned to HCENTER. | | public static final int | VCENTERConstant for centering images vertically
around the anchor point.
Value 2 is assigned to VCENTER. | | public static final int | LEFTConstant for positioning the anchor point of text and images
to the left of the text or image.
Value 4 is assigned to LEFT. | | public static final int | RIGHTConstant for positioning the anchor point of text and images
to the right of the text or image.
Value 8 is assigned to RIGHT. | | public static final int | TOPConstant for positioning the anchor point of text and images
above the text or image.
Value 16 is assigned to TOP. | | public static final int | BOTTOMConstant for positioning the anchor point of text and images
below the text or image.
Value 32 is assigned to BOTTOM. | | public static final int | BASELINEConstant for positioning the anchor point at the baseline of text.
Value 64 is assigned to BASELINE. | | public static final int | SOLIDConstant for the SOLID stroke style.
Value 0 is assigned to SOLID. | | public static final int | DOTTEDConstant for the DOTTED stroke style.
Value 1 is assigned to DOTTED. | | private short | clipX1The clip values are in the translated
coordinate system and maintained as intersected
with 0,0,maxWidth,maxHeight | | private short | clipY1 | | private short | clipX2 | | private short | clipY2 | | private int | transXTranslated x,y coordinates | | private int | transY | | private short | systemClipX1System clip to hold any system clipping.
This saves the clip values imposed by
the system (e.g. from Theme support).
The clip values are in the translated
coordinate system. | | private short | systemClipY1 | | private short | systemClipX2 | | private short | systemClipY2 | | private int | axused by dsPaint for saving translated values | | private int | ay | | private boolean | clippedA flag indicating the clipping state | | private int | rgbColorPixel values (-1 when uninitialized) | | private int | gray | | private int | pixelpixel value (-1 when uninitialized) | | private int | styleLine stroke style | | private Font | currentFontThe current Font | | private short | maxWidthThe maximum width and height | | private short | maxHeight | | private boolean | runtimeClipEnforceA flag indicating MIDP runtime library clip state | | private int | displayIdThe display ID associated with the device Graphics.
Note: that Graphics created with an Image will have display ID set
to -1. For device Graphics it will be set in
getScreenGraphics() . | | private Image | imgIf not null, this instance represent Graphics context for that
Image. | | private Object | creatorThe creator of this Graphics instance
IMPL_NOTE: The information about Graphics object creator is
needed to JSRs (e.g. JSR239) that are given with Graphics
instance and has no further information on its creator changes,
e.g. of resizing, but at the same time should be able to paint
properly into this Graphics. |
| Constructors Summary |
|---|
Graphics()Create a Graphics object
|
| Methods Summary |
|---|
| public synchronized void | clipRect(int x, int y, int width, int height)Intersects the current clip with the specified rectangle.
The resulting clipping area is the intersection of the current
clipping area and the specified rectangle.
This method can only be used to make the current clip smaller.
To set the current clip larger, use the setClip method.
Rendering operations have no effect outside of the clipping area.
int translatedX1, translatedY1;
int translatedX2, translatedY2;
if (width <= 0 || height <= 0) {
clipX1 = clipY1 = clipX2 = clipY2 = 0;
clipped = true;
return;
}
// Translate the given coordinates
translatedX1 = x + transX;
translatedY1 = y + transY;
// Detect overflow
if (translatedX1 < 0) {
translatedX1 = (x < 0 || transX < 0) ? 0 : maxWidth;
}
if (translatedY1 < 0) {
translatedY1 = (y < 0 || transY < 0) ? 0 : maxHeight;
}
// If the passed in rect is below our current clip
if ((clipX2 < translatedX1) || (clipY2 < translatedY1)) {
// we have no intersection
clipX1 = clipY1 = clipX2 = clipY2 = 0;
clipped = true;
return;
}
if (translatedX1 > clipX1) {
clipX1 = (short) (translatedX1 & 0x7fff);
clipped = true;
}
if (translatedY1 > clipY1) {
clipY1 = (short) (translatedY1 & 0x7fff);
clipped = true;
}
// Start handling bottom right area
translatedX2 = x + transX + width;
translatedY2 = y + transY + height;
// Detect Overflow
if (translatedX2 < 0) {
translatedX2 = (x < 0 || transX < 0) ? translatedX1 : maxWidth;
}
if (translatedY2 < 0) {
translatedY2 = (y < 0 || transY < 0) ? translatedY1 : maxHeight;
}
// If the passed in rect is above our current clip
if (translatedX2 < clipX1 || translatedY2 < clipY1) {
// we have no intersection
clipX1 = clipY1 = clipX2 = clipY2 = 0;
clipped = true;
return;
}
if (translatedX2 <= clipX2) {
clipX2 = (short) translatedX2;
clipped = true;
}
if (translatedY2 <= clipY2) {
clipY2 = (short) translatedY2;
clipped = true;
}
if (clipped == true) {
if (clipX2 < clipX1)
clipX2 = clipX1;
if (clipY2 < clipY1)
clipY2 = clipY1;
}
/**
* sanity check
if (clipX1 < 0 || clipY1 < 0 ||
clipX2 > maxWidth || clipY2 > maxHeight ||
clipX1 > clipX2 || clipY1 > clipY2)
System.out.println("Graphics:clipRect error: clipX1 = "+clipX1+
" clipY1 = "+clipY1+" clipX2 = "+clipX2+" clipY2 = "+clipY2+
" maxWidth = "+maxWidth+" maxHeight = "+maxHeight);
if (runtimeClipEnforce)
System.out.println("Graphics:clipRect runtimeClipEnforce:"+
" systemClipX1 = "+systemClipX1+" systemClipY1 = "+systemClipY1+
" systemClipX2 = "+systemClipX2+" systemClipY2 = "+systemClipY2);
* end sanity check
*/
| | public synchronized void | copyArea(int x_src, int y_src, int width, int height, int x_dest, int y_dest, int anchor)Copies the contents of a rectangular area
(x_src, y_src, width, height) to a destination area,
whose anchor point identified by anchor is located at
(x_dest, y_dest). The effect must be that the
destination area
contains an exact copy of the contents of the source area
immediately prior to the invocation of this method. This result must
occur even if the source and destination areas overlap.
The points (x_src, y_src) and (x_dest,
y_dest) are both specified
relative to the coordinate system of the Graphics
object. It is
illegal for the source region to extend beyond the bounds of the
graphic object. This requires that:
x_src + tx >= 0
y_src + ty >= 0
x_src + tx + width <= width of Graphics object's destination
y_src + ty + height <= height of Graphics object's destination
|
where tx and ty represent the X and Y
coordinates of the translated origin of this graphics object, as
returned by getTranslateX() and
getTranslateY(), respectively.
However, it is legal for the destination area to extend beyond
the bounds of the Graphics object. Pixels outside
of the bounds of
the Graphics object will not be drawn.
The copyArea method is allowed on all
Graphics objects except those
whose destination is the actual display device. This restriction is
necessary because allowing a copyArea method on
the display would
adversely impact certain techniques for implementing
double-buffering.
Like other graphics operations, the copyArea
method uses the Source
Over Destination rule for combining pixels. However, since it is
defined only for mutable images, which can contain only fully opaque
pixels, this is effectively the same as pixel replacement.
if (isScreenGraphics()) {
throw new IllegalStateException();
} else {
doCopyArea(x_src, y_src, width, height,
x_dest, y_dest, anchor);
}
| | private native void | doCopyArea(int x_src, int y_src, int width, int height, int x_dest, int y_dest, int anchor)Native implementation of CopyArea method.
| | public native void | drawArc(int x, int y, int width, int height, int startAngle, int arcAngle)Draws the outline of a circular or elliptical arc
covering the specified rectangle,
using the current color and stroke style.
The resulting arc begins at startAngle and extends
for arcAngle degrees, using the current color.
Angles are interpreted such that 0 degrees
is at the 3 o'clock position.
A positive value indicates a counter-clockwise rotation
while a negative value indicates a clockwise rotation.
The center of the arc is the center of the rectangle whose origin
is (x, y) and whose size is specified by the
width and height arguments.
The resulting arc covers an area
width + 1 pixels wide
by height + 1 pixels tall.
If either width or height is less than zero,
nothing is drawn.
The angles are specified relative to the non-square extents of
the bounding rectangle such that 45 degrees always
falls on the
line from the center of the ellipse to the upper right corner of
the bounding rectangle. As a result, if the bounding rectangle is
noticeably longer in one axis than the other, the angles to the
start and end of the arc segment will be skewed farther along the
longer axis of the bounds.
| | public native void | drawChar(char character, int x, int y, int anchor)Draws the specified character using the current font and color.
| | public native void | drawChars(char[] data, int offset, int length, int x, int y, int anchor)Draws the specified characters using the current font and color.
The offset and length parameters must
specify a valid range of characters within
the character array data.
The offset parameter must be within the
range [0..(data.length)], inclusive.
The length parameter
must be a non-negative integer such that
(offset + length) <= data.length.
| | public void | drawImage(Image img, int x, int y, int anchor)Draws the specified image by using the anchor point.
The image can be drawn in different positions relative to
the anchor point by passing the appropriate position constants.
See anchor points.
If the source image contains transparent pixels, the corresponding
pixels in the destination image must be left untouched. If the source
image contains partially transparent pixels, a compositing operation
must be performed with the destination pixels, leaving all pixels of
the destination image fully opaque.
If img is the same as the destination of this Graphics
object, the result is undefined. For copying areas within an
Image, {@link #copyArea copyArea} should be used instead.
if (!img.render(this, x, y, anchor)) {
throw new IllegalArgumentException("");
}
| | public native void | drawLine(int x1, int y1, int x2, int y2)Draws a line between the coordinates (x1,y1) and
(x2,y2) using
the current color and stroke style.
| | public native void | drawRGB(int[] rgbData, int offset, int scanlength, int x, int y, int width, int height, boolean processAlpha)Renders a series of device-independent RGB+transparency values in a
specified region. The values are stored in
rgbData in a format
with 24 bits of RGB and an eight-bit alpha value
(0xAARRGGBB),
with the first value stored at the specified offset. The
scanlength
specifies the relative offset within the array between the
corresponding pixels of consecutive rows. Any value for
scanlength is acceptable (even negative values)
provided that all resulting references are within the
bounds of the rgbData array. The ARGB data is
rasterized horizontally from left to right within each row.
The ARGB values are
rendered in the region specified by x,
y, width and height, and
the operation is subject to the current clip region
and translation for this Graphics object.
Consider P(a,b) to be the value of the pixel
located at column a and row b of the
Image, where rows and columns are numbered downward from the
top starting at zero, and columns are numbered rightward from
the left starting at zero. This operation can then be defined
as:
P(a, b) = rgbData[offset + (a - x) + (b - y) * scanlength]
|
for
x <= a < x + width
y <= b < y + height
|
This capability is provided in the Graphics
class so that it can be
used to render both to the screen and to offscreen
Image objects. The
ability to retrieve ARGB values is provided by the {@link Image#getRGB}
method.
If processAlpha is true, the
high-order byte of the ARGB format
specifies opacity; that is, 0x00RRGGBB specifies a
fully transparent
pixel and 0xFFRRGGBB specifies a fully opaque
pixel. Intermediate
alpha values specify semitransparency. If the implementation does not
support alpha blending for image rendering operations, it must remove
any semitransparency from the source data prior to performing any
rendering. (See Alpha Processing for
further discussion.)
If processAlpha is false, the alpha
values are ignored and all pixels
must be treated as completely opaque.
The mapping from ARGB values to the device-dependent
pixels is platform-specific and may require significant
computation.
| | public native void | drawRect(int x, int y, int width, int height)Draws the outline of the specified rectangle using the current
color and stroke style.
The resulting rectangle will cover an area (width + 1)
pixels wide by (height + 1) pixels tall.
If either width or height is less than
zero, nothing is drawn.
| | public void | drawRegion(Image src, int x_src, int y_src, int width, int height, int transform, int x_dest, int y_dest, int anchor)Copies a region of the specified source image to a location within
the destination, possibly transforming (rotating and reflecting)
the image data using the chosen transform function.
The destination, if it is an image, must not be the same image as
the source image. If it is, an exception is thrown. This restriction
is present in order to avoid ill-defined behaviors that might occur if
overlapped, transformed copies were permitted.
The transform function used must be one of the following, as defined
in the {@link javax.microedition.lcdui.game.Sprite Sprite} class:
Sprite.TRANS_NONE - causes the specified image
region to be copied unchanged
Sprite.TRANS_ROT90 - causes the specified image
region to be rotated clockwise by 90 degrees.
Sprite.TRANS_ROT180 - causes the specified image
region to be rotated clockwise by 180 degrees.
Sprite.TRANS_ROT270 - causes the specified image
region to be rotated clockwise by 270 degrees.
Sprite.TRANS_MIRROR - causes the specified image
region to be reflected about its vertical center.
Sprite.TRANS_MIRROR_ROT90 - causes the specified image
region to be reflected about its vertical center and then rotated
clockwise by 90 degrees.
Sprite.TRANS_MIRROR_ROT180 - causes the specified image
region to be reflected about its vertical center and then rotated
clockwise by 180 degrees.
Sprite.TRANS_MIRROR_ROT270 - causes the specified image
region to be reflected about its vertical center and then rotated
clockwise by 270 degrees.
If the source region contains transparent pixels, the corresponding
pixels in the destination region must be left untouched. If the source
region contains partially transparent pixels, a compositing operation
must be performed with the destination pixels, leaving all pixels of
the destination region fully opaque.
The (x_src, y_src) coordinates are relative to
the upper left
corner of the source image. The x_src,
y_src, width, and height
parameters specify a rectangular region of the source image. It is
illegal for this region to extend beyond the bounds of the source
image. This requires that:
x_src >= 0
y_src >= 0
x_src + width <= source width
y_src + height <= source height
|
The (x_dest, y_dest) coordinates are relative to
the coordinate
system of this Graphics object. It is legal for the destination
area to extend beyond the bounds of the Graphics
object. Pixels
outside of the bounds of the Graphics object will
not be drawn.
The transform is applied to the image data from the region of the
source image, and the result is rendered with its anchor point
positioned at location (x_dest, y_dest) in the
destination.
if (!src.renderRegion(this, x_src, y_src, width, height,
transform, x_dest, y_dest, anchor)) {
throw new IllegalArgumentException("");
}
| | public native void | drawRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight)Draws the outline of the specified rounded corner rectangle
using the current color and stroke style.
The resulting rectangle will cover an area (width +
1) pixels wide
by (height + 1) pixels tall.
If either width or height is less than
zero, nothing is drawn.
| | public native void | drawString(java.lang.String str, int x, int y, int anchor)Draws the specified String using the current font and color.
The x,y position is the position of the anchor point.
See anchor points.
| | public native void | drawSubstring(java.lang.String str, int offset, int len, int x, int y, int anchor)Draws the specified String using the current font and color.
The x,y position is the position of the anchor point.
See anchor points.
The offset and len parameters must
specify a valid range of characters within
the string str.
The offset parameter must be within the
range [0..(str.length())], inclusive.
The len parameter
must be a non-negative integer such that
(offset + len) <= str.length().
| | public native void | fillArc(int x, int y, int width, int height, int startAngle, int arcAngle)Fills a circular or elliptical arc covering the specified rectangle.
The resulting arc begins at startAngle and extends
for arcAngle degrees.
Angles are interpreted such that 0 degrees
is at the 3 o'clock position.
A positive value indicates a counter-clockwise rotation
while a negative value indicates a clockwise rotation.
The center of the arc is the center of the rectangle whose origin
is (x, y) and whose size is specified by the
width and height arguments.
If either width or height is zero or less,
nothing is drawn.
The filled region consists of the "pie wedge"
region bounded
by the arc
segment as if drawn by drawArc(), the radius extending from
the center to
this arc at startAngle degrees, and radius extending
from the
center to this arc at startAngle + arcAngle degrees.
The angles are specified relative to the non-square extents of
the bounding rectangle such that 45 degrees always
falls on the
line from the center of the ellipse to the upper right corner of
the bounding rectangle. As a result, if the bounding rectangle is
noticeably longer in one axis than the other, the angles to the
start and end of the arc segment will be skewed farther along the
longer axis of the bounds.
| | public native void | fillRect(int x, int y, int width, int height)Fills the specified rectangle with the current color.
If either width or height is zero or less,
nothing is drawn.
| | public native void | fillRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight)Fills the specified rounded corner rectangle with the current color.
If either width or height is zero or less,
nothing is drawn.
| | public native void | fillTriangle(int x1, int y1, int x2, int y2, int x3, int y3)Fills the specified triangle will the current color. The lines
connecting each pair of points are included in the filled
triangle.
| | public synchronized int | getBlueComponent()Gets the blue component of the current color.
return rgbColor & 0xff;
| | void | getClip(int[] region)Internal routine to get the clip in a single call. The input
parameter must be a 4 element integer array. The values of the
array upon return will be equal to the same values as would be
returned from getClipX(), getClipY(), getClipX()+getClipWidth(),
and getClipY()+getClipHeight().
region[0] = clipX1 - transX;
region[1] = clipY1 - transY;
region[2] = clipX2 - transX;
region[3] = clipY2 - transY;
| | public synchronized int | getClipHeight()Gets the height of the current clipping area.
return clipY2 - clipY1;
| | public synchronized int | getClipWidth()Gets the width of the current clipping area.
return clipX2 - clipX1;
| | public synchronized int | getClipX()Gets the X offset of the current clipping area, relative
to the coordinate system origin of this graphics context.
Separating the getClip operation into two methods returning
integers is more performance and memory efficient than one
getClip() call returning an object.
return clipX1 - transX;
| | public synchronized int | getClipY()Gets the Y offset of the current clipping area, relative
to the coordinate system origin of this graphics context.
Separating the getClip operation into two methods returning
integers is more performance and memory efficient than one
getClip() call returning an object.
return clipY1 - transY;
| | public synchronized int | getColor()Gets the current color.
return rgbColor;
| | synchronized java.lang.Object | getCreator()Returns the creator of this Graphics object
return creator;
| | public native int | getDisplayColor(int color)Gets the color that will be displayed if the specified color
is requested. This method enables the developer to check the
manner in which RGB values are mapped to the set of distinct
colors that the device can actually display. For example,
with a monochrome device, this method will return either
0xFFFFFF (white) or 0x000000 (black)
depending on the brightness of the specified color.
| | public synchronized Font | getFont()Gets the current font.
return currentFont;
| | public synchronized int | getGrayScale()Gets the current grayscale value of the color being used for rendering
operations. If the color was set by
setGrayScale(), that value is simply
returned. If the color was set by one of the methods that allows setting
of the red, green, and blue components, the value returned is
computed from
the RGB color components (possibly in a device-specific fashion)
that best
approximates the brightness of that color.
return gray;
| | public synchronized int | getGreenComponent()Gets the green component of the current color.
return (rgbColor >> 8) & 0xff;
| | static javax.microedition.lcdui.Graphics | getImageGraphics(Image img)Retrieve the Graphics context for the given Image
if (null == img) {
throw new NullPointerException();
}
Graphics g = new Graphics();
g.img = img;
g.setDimensions(img.getWidth(), img.getHeight());
g.reset();
// construct and return a new ImageGraphics
// object that uses the Image img as the
// destination.
return g;
| | static javax.microedition.lcdui.Graphics | getImageGraphics(Image img, int width, int height)Retrieve the Graphics context for the given Image and
explicitly set the dimensions of the created context.
It is possible the Image is bigger than area the Graphics
context should provide access to, e.g. off-screen buffer
created for full screen mode, but used for both normal and
full modes with no resizing.
if (null == img) {
throw new NullPointerException();
}
int w = img.getWidth();
int h = img.getHeight();
if (w > width) { w = width; }
if (h > height) { h = height; }
Graphics g = new Graphics();
g.img = img;
g.setDimensions(w, h);
g.reset();
return g;
| | short | getMaxHeight()Returns the maximal height available for the clipping
withing this Graphics context
return maxHeight;
| | short | getMaxWidth()Returns the maximal width available for the clipping
withing this Graphics context
return maxWidth;
| | private native int | getPixel(int rgb, int gray, boolean isGray)Get a specific pixel value
| | public synchronized int | getRedComponent()Gets the red component of the current color.
return (rgbColor >> 16) & 0xff;
| | static javax.microedition.lcdui.Graphics | getScreenGraphics(int displayId, int width, int height)Retrieve the Graphics context that renders to the
device's display
Graphics g = new Graphics();
g.displayId = displayId;
g.img = null;
g.setDimensions(width, height);
g.reset();
return g;
| | public synchronized int | getStrokeStyle()Gets the stroke style used for drawing operations.
return style;
| | public synchronized int | getTranslateX()Gets the X coordinate of the translated origin of this graphics context.
return transX;
| | public synchronized int | getTranslateY()Gets the Y coordinate of the translated origin of this graphics context.
return transY;
| | private static int | grayVal(int red, int green, int blue)Get a gray value given the RGB values
/* CCIR Rec 601 luma (nonlinear rgb to nonlinear "gray") */
return (red*76 + green*150 + blue*29) >> 8;
| | boolean | isScreenGraphics()Determines if this a Graphics object used to
represent the device.
return (displayId != -1);
| | void | preserveMIDPRuntimeGC(int systemX, int systemY, int systemW, int systemH)Preserve MIDP runtime GC.
- Our internal MIDP clip to protect
it from MIDlet drawing on top of our widget.
- Translation
runtimeClipEnforce = true;
clipRect(systemX, systemY, systemW, systemH);
// this is the first time, we setup
// the systemClip values.
systemClipX1 = clipX1;
systemClipY1 = clipY1;
systemClipX2 = clipX2;
systemClipY2 = clipY2;
// Preserve the translation system
translate(systemX, systemY);
ax = getTranslateX();
ay = getTranslateY();
| | void | reset(int x1, int y1, int x2, int y2)Reset this Graphics context with the given coordinates
resetGC();
transX = transY = 0;
setClip(x1, y1, x2 - x1, y2 - y1);
| | void | reset()Reset this Graphics context to its default dimensions
(same as reset(0, 0, maxWidth, maxHeight)
reset(0, 0, maxWidth, maxHeight);
| | void | resetGC()Reset the Graphic context with all items related
to machine independent context.
There is no translation and clipping involve
since different implementations may map it
directly or not.
Only Font, Style, and Color are reset in
this function.
currentFont = Font.getDefaultFont();
style = SOLID;
rgbColor = gray = 0;
pixel = getPixel(rgbColor, gray, true);
| | void | restoreMIDPRuntimeGC()Restore the runtime GC.
- Release the internal runtime clip values by
unsetting the variable.
- Restore the original translation
runtimeClipEnforce = false;
translate(ax-getTranslateX(), ay-getTranslateY());
| | public synchronized void | setClip(int x, int y, int width, int height)Sets the current clip to the rectangle specified by the
given coordinates.
Rendering operations have no effect outside of the clipping area.
int translatedX1, translatedY1;
int translatedX2, translatedY2;
// If width or height is zero or less then zero,
// we do not preserve the current clipping and
// set all clipping values to zero.
if ((width <= 0) || (height <= 0)) {
clipX1 = clipY1 = clipX2 = clipY2 = 0;
clipped = true;
return;
}
// Translate the given coordinates
translatedX1 = x + transX;
translatedY1 = y + transY;
// Detect Overflow
if (translatedX1 < 0) {
translatedX1 = (x < 0 || transX < 0) ? 0 : maxWidth;
}
if (translatedY1 < 0) {
translatedY1 = (y < 0 || transY < 0) ? 0 : maxHeight;
}
clipX1 = (short)(translatedX1 & 0x7fff);
clipY1 = (short)(translatedY1 & 0x7fff);
if ((translatedX1 >= maxWidth)
|| (translatedY1 >= maxHeight)) {
clipX1 = clipY1 = clipX2 = clipY2 = 0;
clipped = true;
return;
}
// Check against the runtime library clip values
if (runtimeClipEnforce) {
if (clipX1 < systemClipX1)
clipX1 = systemClipX1;
if (clipY1 < systemClipY1) {
clipY1 = systemClipY1;
}
}
// Translate the given width, height to abs. coordinates
translatedX2 = x + transX + width;
translatedY2 = y + transY + height;
// Detect overflow
if (translatedX2 < 0) {
translatedX2 = (x < 0 || transX < 0) ? translatedX1 : maxWidth;
} else {
if (translatedX2 > maxWidth)
translatedX2 = maxWidth;
}
if (translatedY2 < 0) {
translatedY2 = (y < 0 || transY < 0) ? translatedY1 : maxHeight;
} else {
if (translatedY2 > maxHeight)
translatedY2 = maxHeight;
}
clipX2 = (short) (translatedX2 & 0x7FFF);
clipY2 = (short) (translatedY2 & 0x7FFF);
// Check against the runtime library clip values
if (runtimeClipEnforce) {
if (clipX2 > systemClipX2)
clipX2 = systemClipX2;
if (clipY2 > systemClipY2)
clipY2 = systemClipY2;
}
if ((clipX1 != 0) || (clipY1 != 0)
|| (clipX2 != maxWidth) || (clipY2 != maxHeight)) {
clipped = true;
}
/**
* sanity check
if (clipX1 < 0 || clipY1 < 0 ||
clipX2 > maxWidth || clipY2 > maxHeight ||
clipX1 > clipX2 || clipY1 > clipY2)
System.out.println("Graphics:setClip error: clipX1 = "+clipX1+
" clipY1 = "+clipY1+" clipX2 = "+clipX2+" clipY2 = "+clipY2+
" maxWidth = "+maxWidth+" maxHeight = "+maxHeight);
if (runtimeClipEnforce)
System.out.println("Graphics:setClip runtimeClipEnforce:"+
" systemClipX1 = "+systemClipX1+" systemClipY1 = "+systemClipY1+
" systemClipX2 = "+systemClipX2+" systemClipY2 = "+systemClipY2);
* end sanity check
*/
| | public synchronized void | setColor(int red, int green, int blue)Sets the current color to the specified RGB values. All subsequent
rendering operations will use this specified color.
if ((red < 0) || (red > 255)
|| (green < 0) || (green > 255)
|| (blue < 0) || (blue > 255)) {
throw new IllegalArgumentException("Value out of range");
}
rgbColor = (red << 16) | (green << 8) | blue;
gray = grayVal(red, green, blue);
pixel = getPixel(rgbColor, gray, false);
| | public synchronized void | setColor(int RGB)Sets the current color to the specified RGB values. All subsequent
rendering operations will use this specified color. The RGB value
passed in is interpreted with the least significant eight bits
giving the blue component, the next eight more significant bits
giving the green component, and the next eight more significant
bits giving the red component. That is to say, the color component
is specified in the form of 0x00RRGGBB. The high
order byte of
this value is ignored.
if (pixel == -1 || (RGB & 0x00ffffff) != rgbColor) {
int red = (RGB >> 16) & 0xff;
int green = (RGB >> 8) & 0xff;
int blue = (RGB) & 0xff;
rgbColor = RGB & 0x00ffffff;
gray = grayVal(red, green, blue);
pixel = getPixel(rgbColor, gray, false);
}
| | synchronized void | setCreator(java.lang.Object creator)Sets the creator of this Graphics object
// Ignore repeated attempts to set creator
if (this.creator == null) {
this.creator = creator;
}
| | void | setDimensions(int w, int h)Sets the width and height member variables of this
Graphics object to reflect the correct values e.g. for
clipping correctly
maxWidth = (short) (w & 0x7fff);
maxHeight = (short) (h & 0x7fff);
| | public synchronized void | setFont(Font font)Sets the font for all subsequent text rendering operations. If font is
null, it is equivalent to
setFont(Font.getDefaultFont()).
currentFont = (font == null) ? Font.getDefaultFont() : font;
| | public synchronized void | setGrayScale(int value)Sets the current grayscale to be used for all subsequent
rendering operations. For monochrome displays, the behavior
is clear. For color displays, this sets the color for all
subsequent drawing operations to be a gray color equivalent
to the value passed in. The value must be in the range
0-255.
if ((value < 0) || (value > 255)) {
throw new IllegalArgumentException("Gray value out of range");
}
if (pixel == -1 || gray != value) {
rgbColor = (value << 16) | (value << 8) | value;
gray = value;
pixel = getPixel(rgbColor, gray, true);
}
| | public synchronized void | setStrokeStyle(int style)Sets the stroke style used for drawing lines, arcs, rectangles, and
rounded rectangles. This does not affect fill, text, and image
operations.
if ((style != SOLID) && (style != DOTTED)) {
throw new IllegalArgumentException("Invalid line style");
}
this.style = style;
| | public synchronized void | translate(int x, int y)Translates the origin of the graphics context to the point
(x, y) in the current coordinate system. All coordinates
used in subsequent rendering operations on this graphics
context will be relative to this new origin.
The effect of calls to translate() are
cumulative. For example, calling
translate(1, 2) and then translate(3,
4) results in a translation of
(4, 6).
The application can set an absolute origin (ax,
ay) using the following
technique:
g.translate(ax - g.getTranslateX(), ay - g.getTranslateY())
transX += x;
transY += y;
|
|
