com.tensegrity.graphics.device
Class AWTDevice

java.lang.Object
  extended bycom.tensegrity.graphics.device.AbstractDevice
      extended bycom.tensegrity.graphics.device.AWTDevice
All Implemented Interfaces:
Device
Direct Known Subclasses:
SWTDevice

public class AWTDevice
extends AbstractDevice
implements Device

All drawing performed by an AWTDevice are implemented by the drawing methods of classes java.awt.Graphics and java.awt.Graphics2D. This Device is used in an AWT / Swing environment. It is the most mature Device implementation in the framework.

Important: This class is not intended to be extended and is only temporarily set to non-final (for internal reasons).

Version:
$Id: AWTDevice.java,v 1.64 2006/04/28 09:43:06 BurkhardWick Exp $
Author:
M. Kegel

Field Summary
static java.util.HashMap fontCache
          Font cache hashmap.
protected  java.awt.Graphics gfx
          Instance variable to hold the Graphicsobject.
protected  java.awt.Graphics2D gfx2D
          Instance variable to hold the Graphics2Dobject.
static boolean USE_FONT_CACHING
          Disable or enable font-caching.
static boolean USE_TEXTURE_BITMAP_CACHING
          Disable or enable textures to be drawn from cached bitmaps.
 
Fields inherited from class com.tensegrity.graphics.device.AbstractDevice
fontFormat, fontFormatData, paintFormat, paintFormatData, strokeFormat, strokeFormatData, visibleFont, visiblePaint, visibleStroke
 
Fields inherited from interface com.tensegrity.graphics.device.Device
DRAW_FILL, DRAW_OUTLINE
 
Constructor Summary
protected AWTDevice()
          Constructor temporarily set to protected for internal reasons.
 
Method Summary
 void clearClip()
          Clears the currently used clip rectangle.
 void clearRect(int x, int y, int width, int height)
          Clears the specified rectangle by filling it with the background color of the current drawing surface.
 void clipRect(int x, int y, int width, int height)
          Intersects the current clip with the specified rectangle.
static java.awt.Paint createAWTPaint(AWTDevice device, int style, int colorback, int colorfore, int gradientType, int patternType, Texture texture, int transparency, boolean transparent)
          Returns a java.awt.Paint instance.
static java.awt.Paint createAWTPaint(AWTDevice device, PaintFormat paintformat)
          Returns a java.awt.Paint instance.
static java.awt.Stroke createAWTStroke(int strokeWeight, double[] pattern)
          Returns a java.awt.Stroke instance.
static java.awt.Stroke createAWTStroke(int strokeWeight, double[] pattern, int strokeCap)
          Returns a java.awt.Stroke instance.
static java.awt.Stroke createAWTStroke(StrokeFormat strokeformat)
          Returns a java.awt.Stroke instance.
 void dispose()
          Disposes this AWTDevice.
 void drawArc(int flags, int x, int y, int width, int height, int startAngle, int arcAngle)
          Draws a circular or elliptical arc covering the specified rectangle.
 void drawLine(int x1, int y1, int x2, int y2)
          This method draws a line from the starting coordinate given by x1 and y1 to the ending coordinate given by x2 and y2.
 void drawOval(int flags, int x, int y, int width, int height)
          Draws an oval.
 void drawPolygon(int flags, int[] ptX, int[] ptY, int ptCount)
          This method draws a closed polygon.
 void drawPolyline(int[] ptX, int[] ptY, int ptCount)
          This method draws a polyline.
 void drawRect(int flags, int x, int y, int width, int height)
          This methods draws the rectangle defined by the given parameters.
 void drawRoundRect(int flags, int x, int y, int width, int height, int arcWidth, int arcHeight)
          Draws a round-cornered rectangle using this graphic contexts currently set Stroke- and PaintFormat.
 void drawString(java.lang.String str, int x, int y)
          Draws the text given by the specified string, using this graphics context's current font and color.
 Boundary getClipBounds()
          Returns the bounding rectangle of the current clipping area.
 Boundary getClipBounds(Boundary boundary)
          Returns the bounding rectangle of the current clipping area.
static AWTDevice getDevice(java.awt.Graphics gfx)
          This is a static factory alike method that lazily instantiates the awt device and returns a reference to it.
 DeviceStatistics getDeviceStatistics()
          Returns the device statistics or null if statistics are disabled.
 java.awt.Graphics getGraphics()
          Returns the currently active Graphics object of this device.
 Transform2D getTransform()
          Returns a copy of the current AffineTransform in the Device.
 boolean hitClip(int x, int y, int width, int height)
          Returns true if the specified rectangular area intersects the bounding rectangle of the current clipping area.
 void initiate()
          Initializes this Device.
 boolean isAntialiasing()
          Returns true if antialising is enabled for this Device, otherwise false is returned.
 boolean isInhibitLT2RBFlip()
           
 boolean isInhibitYFlip()
           
 boolean isPrinting()
           
static java.awt.Font lookupAWTFont(FontFormat fontformat)
          Font creation/lookup method.
static java.awt.Font lookupAWTFont(int size, int weight, java.lang.String family, boolean italic)
          Font creation/lookup method.
 void setAntialiasing(boolean antialiasing)
          Enables or disables antialiasing for this Device
 void setClip(int x, int y, int width, int height)
          Sets the current clip to the rectangle specified by the given coordinates.
 void setClipBounds(Boundary boundary)
          Sets the current clip to the rectangle specified by the given coordinates.
 void setFontFormat(FontFormat fontFormat)
          Sets the FontFormat that will be used for all subsequent text drawing operations.
 void setFontFormatData(java.lang.Object[] fontFormatData)
          Because all formats get pooled, illustrators and users need an easy way to change them.
 void setInhibitLT2RBFlip(boolean inhibitLT2RBFlip)
           
 void setInhibitYFlip(boolean inhibitYFlip)
           
 void setIsPrinting(boolean isPrinting)
           
 void setPaintFormat(PaintFormat paintFormat)
          Sets the PaintFormat the Device should use for filling areas.
 void setPaintFormatData(java.lang.Object[] paintFormatData)
          Sets the PaintFormat rendering data the Device should use for filling areas.
 void setPaintMode()
          Sets the paint mode of this graphics context to overwrite the destination with this graphics context's current color.
 void setStrokeFormat(StrokeFormat strokeFormat)
          Sets the StrokeFormat the Device should use for drawing lines or borders around rectangles and polygons.
 void setStrokeFormatData(java.lang.Object[] strokeFormatData)
          Sets the StrokeFormat rendering data the Device should use for drawing lines or borders around rectangles and polygons.
 void setTransform(Transform2D xform)
          Sets the Transform2D in the Device.
 void setXORMode(int xorAlternationColor)
          Sets the paint mode of this graphics context to alternate between this graphics context's current color and the new specified color.
 void translate(int x, int y)
          This method translates the origin of this devise to the point given by x and y in the actual coordinate of this device.
 
Methods inherited from class com.tensegrity.graphics.device.AbstractDevice
getFontFormat, getPaintFormat, getStrokeFormat
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface com.tensegrity.graphics.device.Device
getFontFormat, getPaintFormat, getStrokeFormat
 

Field Detail

USE_FONT_CACHING

public static boolean USE_FONT_CACHING
Disable or enable font-caching. Recommend to be enabled.


USE_TEXTURE_BITMAP_CACHING

public static boolean USE_TEXTURE_BITMAP_CACHING
Disable or enable textures to be drawn from cached bitmaps.


gfx

protected java.awt.Graphics gfx
Instance variable to hold the Graphicsobject.

Important : This variable is only temporarily set to protected for internal reasons. It will be set to private in a foreseeable futur.


gfx2D

protected java.awt.Graphics2D gfx2D
Instance variable to hold the Graphics2Dobject.

Important : This variable is only temporarily set to protected for internal reasons. It will be set to private in a foreseeable futur.


fontCache

public static final java.util.HashMap fontCache
Font cache hashmap.

Constructor Detail

AWTDevice

protected AWTDevice()
Constructor temporarily set to protected for internal reasons. This constructor is intended to be private and will be so in a foreseeable futur. Use #getDevice() instead.

Method Detail

getDevice

public static AWTDevice getDevice(java.awt.Graphics gfx)
This is a static factory alike method that lazily instantiates the awt device and returns a reference to it.

Parameters:
gfx - the graphics this AWTDevice should use, this object must be of type Graphics2D.
Returns:
an AWTDevice for the given Graphics object.

initiate

public final void initiate()
Description copied from interface: Device
Initializes this Device.
NOTICE:This method must be called before any drawing can be performed.

Specified by:
initiate in interface Device

dispose

public void dispose()
Description copied from interface: Device
Disposes this AWTDevice. After disposing the instance may not longer be used.
NOTICE:This method must be called. Otherwise the Device is no longer in a valid state.

Specified by:
dispose in interface Device

isAntialiasing

public boolean isAntialiasing()
Description copied from interface: Device
Returns true if antialising is enabled for this Device, otherwise false is returned.

Specified by:
isAntialiasing in interface Device
Returns:
true if antialising is enabled for this Device, otherwise false is returned.

setAntialiasing

public void setAntialiasing(boolean antialiasing)
Description copied from interface: Device
Enables or disables antialiasing for this Device

Specified by:
setAntialiasing in interface Device
Parameters:
antialiasing - true indicates that anti-aliasing should be enabled, false disables it.

setStrokeFormat

public final void setStrokeFormat(StrokeFormat strokeFormat)
Description copied from interface: Device
Sets the StrokeFormat the Device should use for drawing lines or borders around rectangles and polygons. When invoking this method the StrokeFormat is used instead of the color value the Device currently uses. If the Device should use the current color value, this method has to be called with a null parameter.

Specified by:
setStrokeFormat in interface Device
Overrides:
setStrokeFormat in class AbstractDevice

setStrokeFormatData

public final void setStrokeFormatData(java.lang.Object[] strokeFormatData)
Description copied from interface: Device
Sets the StrokeFormat rendering data the Device should use for drawing lines or borders around rectangles and polygons. When invoking this method the StrokeFormat is used instead of the color value the Device currently uses. If the Device should use the current color value, this method has to be called with a null parameter. The given array has to consist of three Integer objects. The meaning of the value is defined by its position in the array. The following list specifies the valid index positions:

Specified by:
setStrokeFormatData in interface Device
Overrides:
setStrokeFormatData in class AbstractDevice
See Also:
Device.setStrokeFormatData(java.lang.Object[])

setPaintFormat

public final void setPaintFormat(PaintFormat paintFormat)
Description copied from interface: Device
Sets the PaintFormat the Device should use for filling areas. If the current color should be used, this method has to be called with a null parameter.

Specified by:
setPaintFormat in interface Device
Overrides:
setPaintFormat in class AbstractDevice

setPaintFormatData

public final void setPaintFormatData(java.lang.Object[] paintFormatData)
Description copied from interface: Device
Sets the PaintFormat rendering data the Device should use for filling areas. When invoking this method the PaintFormat is used instead of the color value the Device> currently uses. If the Device should use the current color value, this method has to be called with a null parameter. Overall eight values of the given array are estimated. REVIEWJAVADOC: Device.java : what do you mean by "estimated"??? The meaning of each value is defined by its position in the array. The following table specifies the valid index positions and object types:
IndexType
RenderingData.VALUEINDEX_PAINT_STYLE Integer
RenderingData.VALUEINDEX_PAINT_COLORBACK Integer
RenderingData.VALUEINDEX_PAINT_COLORFORE Integer
RenderingData.VALUEINDEX_PAINT_GRADIENTTYPE Integer
RenderingData.VALUEINDEX_PAINT_PATTERNTYPE Integer
RenderingData.VALUEINDEX_PAINT_TEXTURE Texture
RenderingData.VALUEINDEX_PAINT_TRANSPARENCY Integer
RenderingData.VALUEINDEX_PAINT_TRANSPARENT Boolean

Specified by:
setPaintFormatData in interface Device
Overrides:
setPaintFormatData in class AbstractDevice

setFontFormat

public final void setFontFormat(FontFormat fontFormat)
Description copied from interface: Device
Sets the FontFormat that will be used for all subsequent text drawing operations. When the default color and font of the Device should be used, the method has to be called with a null parameter.

Specified by:
setFontFormat in interface Device
Overrides:
setFontFormat in class AbstractDevice

setFontFormatData

public final void setFontFormatData(java.lang.Object[] fontFormatData)
Description copied from interface: Device
Because all formats get pooled, illustrators and users need an easy way to change them. This method sets the FontFormat rendering data that will be used for all subsequent text drawing operations. When the Device should use the current color value and the default font of the device, however, this method has to be called with a null parameter. At this time, four values of the given array are estimated. REVIEWJAVADOC: There is that word "estimated" again!!! The meaning of each value is defined by its position in the array. The following list specifies the valid index positions and object types:
IndexType
RenderingData.VALUEINDEX_FONT_SIZE Integer
RenderingData.VALUEINDEX_FONT_WEIGHT Integer
RenderingData.VALUEINDEX_FONT_FAMILY String
RenderingData.VALUEINDEX_FONT_ITALIC Boolean

Specified by:
setFontFormatData in interface Device
Overrides:
setFontFormatData in class AbstractDevice

translate

public final void translate(int x,
                            int y)
Description copied from interface: Device
This method translates the origin of this devise to the point given by x and y in the actual coordinate of this device. All coordinates in subsequent calls to drawing methods are assumed to be relative to the new origin.

Specified by:
translate in interface Device
Parameters:
x - the x coordinate of the new origin
y - the y coordinate of the new origin

getTransform

public final Transform2D getTransform()
Description copied from interface: Device
Returns a copy of the current AffineTransform in the Device.

Specified by:
getTransform in interface Device
Returns:
the current AffineTransform in the Device.

setTransform

public final void setTransform(Transform2D xform)
Description copied from interface: Device
Sets the Transform2D in the Device.

Specified by:
setTransform in interface Device
Parameters:
xform - the Transform2D object to be used in the rendering process

setPaintMode

public final void setPaintMode()
Description copied from interface: Device
Sets the paint mode of this graphics context to overwrite the destination with this graphics context's current color. This sets the logical pixel operation function to the paint or overwrite mode. All subsequent rendering operations will overwrite the destination with the current color.

Specified by:
setPaintMode in interface Device

setXORMode

public final void setXORMode(int xorAlternationColor)
Description copied from interface: Device
Sets the paint mode of this graphics context to alternate between this graphics context's current color and the new specified color. This specifies that logical pixel operations are performed in the XOR mode, which alternates pixels between the current color and a specified XOR color. When drawing operations are performed, pixels which are the current color are changed to the specified color, and vice versa. Pixels that are of colors other than those two colors are changed in an unpredictable but reversible manner; if the same figure is drawn twice, then all pixels are restored to their original values.

Specified by:
setXORMode in interface Device
Parameters:
xorAlternationColor - the XOR alternation color

setClip

public final void setClip(int x,
                          int y,
                          int width,
                          int height)
Description copied from interface: Device
Sets the current clip to the rectangle specified by the given coordinates. Rendering operations have no effect outside of the clipping area.

Specified by:
setClip in interface Device
Parameters:
x - the left coordinate of the new clip rectangle
y - the top coordinate of the new clip rectangle
width - the extent of the new clip rectangle in x direction
height - the extent of the new clip rectangle in y direction

clipRect

public final void clipRect(int x,
                           int y,
                           int width,
                           int height)
Description copied from interface: Device
Intersects the current clip with the specified rectangle. The resulting clipping area is the intersection of the current clipping area and the specified rectangle. If there is no current clipping area, either because the clip has never been set, or the clip has been cleared using setClip(Integer.MIN_VALUE, Integer.MIN_VALUE, Integer.MAX_VALUE, Integer.MAX_VALUE), the specified rectangle becomes the new clip. This method sets the user clip, which is independent of the clipping associated with device bounds and window visibility. This method can only be used to make the current clip smaller. To set the current clip larger, use any of the setClip methods. Rendering operations have no effect outside of the clipping area.

Specified by:
clipRect in interface Device
Parameters:
x - the x coordinate of the rectangle to intersect the clip with
y - the y coordinate of the rectangle to intersect the clip with
width - the width of the rectangle to intersect the clip with
height - the height of the rectangle to intersect the clip with

hitClip

public final boolean hitClip(int x,
                             int y,
                             int width,
                             int height)
Description copied from interface: Device
Returns true if the specified rectangular area intersects the bounding rectangle of the current clipping area. The coordinates in the rectangle are relative to the coordinate system origin of this graphics context.

Specified by:
hitClip in interface Device
Parameters:
x - the x coordinate of the rectangle to test against the clip
y - the y coordinate of the rectangle to test against the clip
width - the width of the rectangle to test against the clip
height - the height of the rectangle to test against the clip
Returns:
true if the specified rectangular area intersects the bounding rectangle of the current clipping area.

getClipBounds

public final Boundary getClipBounds()
Description copied from interface: Device
Returns the bounding rectangle of the current clipping area. This method refers to the user clip, which is independent of the clipping associated with device bounds and window visibility. If no clip has previously been set, or if the clip has been cleared using setClip(null), this method returns null. The coordinates in the rectangle are relative to the coordinate system origin of this graphics context.

Specified by:
getClipBounds in interface Device
Returns:
the bounding rectangle of the current clipping area, or null if no clip is set.

getClipBounds

public final Boundary getClipBounds(Boundary boundary)
Description copied from interface: Device
Returns the bounding rectangle of the current clipping area. The coordinates in the rectangle are relative to the coordinate system origin of this graphics context. This method differs from Device.getClipBounds() in that an existing Boundary is used instead of allocating a new one. This method refers to the user clip, which is independent of the clipping associated with device bounds and window visibility. If no clip has previously been set, or if the clip has been cleared using setClip(null), this method returns the specified Boundary.

Specified by:
getClipBounds in interface Device
Parameters:
boundary - the rectangular boundary where the current clipping area is copied to. Any current values in this rectangle are overwritten.
Returns:
the bounding rectangle of the current clipping area.

setClipBounds

public final void setClipBounds(Boundary boundary)
Description copied from interface: Device
Sets the current clip to the rectangle specified by the given coordinates. Rendering operations have no effect outside of the clipping area.

Specified by:
setClipBounds in interface Device
Parameters:
boundary - the new bounding rectangle to clip against

clearClip

public final void clearClip()
Description copied from interface: Device
Clears the currently used clip rectangle.

Specified by:
clearClip in interface Device

drawLine

public final void drawLine(int x1,
                           int y1,
                           int x2,
                           int y2)
Description copied from interface: Device
This method draws a line from the starting coordinate given by x1 and y1 to the ending coordinate given by x2 and y2.

Specified by:
drawLine in interface Device
Parameters:
x1 - the starting coordinate x value
y1 - the starting coordinate y value
x2 - the ending coordinate x value
y2 - the ending coordinate y value

drawRect

public final void drawRect(int flags,
                           int x,
                           int y,
                           int width,
                           int height)
Description copied from interface: Device
This methods draws the rectangle defined by the given parameters. The rectangle starts at x and y. The right coordinates are calculated by x + width and the bottom coordinates are calculated by y + height.

Specified by:
drawRect in interface Device
Parameters:
flags - bitwise combined flags that determine what to draw.
x - the left coordinate of the rectangle.
y - the top coordinate of the rectangle.
width - the extent in x direction.
height - the extent in y direction.

clearRect

public void clearRect(int x,
                      int y,
                      int width,
                      int height)
Description copied from interface: Device
Clears the specified rectangle by filling it with the background color of the current drawing surface.

Specified by:
clearRect in interface Device
Parameters:
x - the x coordinate of the rectangle to be clear
y - the y coordinate of the rectangle to be clear
width - the width of the rectangle to be clear
height - the height of the rectangle to be clear

drawRoundRect

public final void drawRoundRect(int flags,
                                int x,
                                int y,
                                int width,
                                int height,
                                int arcWidth,
                                int arcHeight)
Description copied from interface: Device
Draws a round-cornered rectangle using this graphic contexts currently set Stroke- and PaintFormat. The left and right edges of the rectangle are at x and x + width, respectively. The top and bottom edges of the rectangle are at y and y + height.

Specified by:
drawRoundRect in interface Device
Parameters:
flags - bitwise combined flags that determine what to draw
x - the x coordinate of the rectangle to be drawn
y - the y coordinate of the rectangle to be drawn
width - the width of the rectangle to be drawn
height - the height of the rectangle to be drawn
arcWidth - the horizontal diameter of the arc at the four corners
arcHeight - the vertical diameter of the arc at the four corners

drawOval

public final void drawOval(int flags,
                           int x,
                           int y,
                           int width,
                           int height)
Description copied from interface: Device
Draws an oval. The result is a circle or ellipse that fits within the rectangle specified by the x, y, width, and height arguments. The oval covers an area that is width + 1 pixels wide and height + 1 pixels tall.

Specified by:
drawOval in interface Device
Parameters:
flags - bitwise combined flags that determine what to draw
x - the x coordinate of the upper left corner of the oval to be drawn
y - the y coordinate of the upper left corner of the oval to be drawn
width - the width of the oval to be drawn
height - the height of the oval to be drawn

drawArc

public final void drawArc(int flags,
                          int x,
                          int y,
                          int width,
                          int height,
                          int startAngle,
                          int arcAngle)
Description copied from interface: Device
Draws a circular or elliptical arc covering the specified rectangle. The resulting arc starts at startAngle and extends for arcAngle degrees, using the current color of the Device. Angles are interpreted in such a manner that a degree of 0 belongs to 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. 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.

Specified by:
drawArc in interface Device
Parameters:
flags - bitwise combined flags that determine what to draw
x - the x coordinate of the upper-left corner of the arc to be drawn
y - the y coordinate of the upper-left corner of the arc to be drawn
width - the width of the arc to be drawn
height - the height of the arc to be drawn
startAngle - the beginning angle
arcAngle - the angular extent of the arc, relative to the start angle

drawPolyline

public final void drawPolyline(int[] ptX,
                               int[] ptY,
                               int ptCount)
Description copied from interface: Device
This method draws a polyline. The polyline is defined by the two given arrays of x and y coordinates. Each point of the polyline is defined by a pair. The points are taken from the arrays starting at index 0 up to index ptCount-1.

Specified by:
drawPolyline in interface Device
Parameters:
ptX - the x coordinates of the points
ptY - the y coordinates of the points
ptCount - the amount of points the polygon consist of

drawPolygon

public final void drawPolygon(int flags,
                              int[] ptX,
                              int[] ptY,
                              int ptCount)
Description copied from interface: Device
This method draws a closed polygon. The polygon is defined by the two given arrays of x and y coordinates. Each point of the polygon is defined by a pair. The points are taken from the arrays starting at index 0 up to index ptCount-1. If the point at index 0 and the point at index ptCount-1 are different the polygon is automatically closed.

Specified by:
drawPolygon in interface Device
Parameters:
flags - bitwise combined flags that determine what to draw
ptX - the x coordinates of the points
ptY - the y coordinates of the points
ptCount - the amount of points the polygon consist of

drawString

public final void drawString(java.lang.String str,
                             int x,
                             int y)
Description copied from interface: Device
Draws the text given by the specified string, using this graphics context's current font and color. The baseline of the leftmost character is at position (x, y) in this graphic contexts coordinate system.

Specified by:
drawString in interface Device
Parameters:
str - the string to be drawn
x - the x coordinate
y - the y coordinate

setIsPrinting

public void setIsPrinting(boolean isPrinting)
Specified by:
setIsPrinting in interface Device

isPrinting

public boolean isPrinting()
Specified by:
isPrinting in interface Device

setInhibitLT2RBFlip

public void setInhibitLT2RBFlip(boolean inhibitLT2RBFlip)
Specified by:
setInhibitLT2RBFlip in interface Device

isInhibitLT2RBFlip

public boolean isInhibitLT2RBFlip()
Specified by:
isInhibitLT2RBFlip in interface Device

setInhibitYFlip

public void setInhibitYFlip(boolean inhibitYFlip)
Specified by:
setInhibitYFlip in interface Device

isInhibitYFlip

public boolean isInhibitYFlip()
Specified by:
isInhibitYFlip in interface Device

createAWTStroke

public static final java.awt.Stroke createAWTStroke(StrokeFormat strokeformat)
Returns a java.awt.Stroke instance.

Parameters:
strokeformat - The stroke format
Returns:
Stroke java.awt.Stroke representation of a StrokeFormat.

createAWTStroke

public static final java.awt.Stroke createAWTStroke(int strokeWeight,
                                                    double[] pattern)
Returns a java.awt.Stroke instance.

Parameters:
strokeWeight - The weight of the stroke
pattern - The pattern for the stroke, may be null for continuous lines
Returns:
Stroke java.awt.Stroke representation of a StrokeFormat.

createAWTStroke

public static final java.awt.Stroke createAWTStroke(int strokeWeight,
                                                    double[] pattern,
                                                    int strokeCap)
Returns a java.awt.Stroke instance.

Parameters:
strokeWeight - The weight of the stroke
pattern - The pattern for the stroke, may be null for continuous lines
strokeCap - The stroke cap
Returns:
Stroke java.awt.Stroke representation of a StrokeFormat.

createAWTPaint

public static final java.awt.Paint createAWTPaint(AWTDevice device,
                                                  PaintFormat paintformat)
Returns a java.awt.Paint instance.

Returns:
Paint java.awt.Paint representation of a PaintFormat.

createAWTPaint

public static final java.awt.Paint createAWTPaint(AWTDevice device,
                                                  int style,
                                                  int colorback,
                                                  int colorfore,
                                                  int gradientType,
                                                  int patternType,
                                                  Texture texture,
                                                  int transparency,
                                                  boolean transparent)
Returns a java.awt.Paint instance.

Returns:
Paint java.awt.Paint representation of a PaintFormat.

getGraphics

public java.awt.Graphics getGraphics()
Returns the currently active Graphics object of this device. Caution: this object may be disposed or invalid for other reason.

Returns:
the currently active Graphics object of this device.

getDeviceStatistics

public final DeviceStatistics getDeviceStatistics()
Returns the device statistics or null if statistics are disabled.

Returns:
statistics object or null.

lookupAWTFont

public static final java.awt.Font lookupAWTFont(FontFormat fontformat)
Font creation/lookup method. Use this method instead of createAWTFont.

Parameters:
fontformat - the fontformat to lookup or create.
Returns:
the associated Font.

lookupAWTFont

public static final java.awt.Font lookupAWTFont(int size,
                                                int weight,
                                                java.lang.String family,
                                                boolean italic)
Font creation/lookup method. Use this method instead of createAWTFont.

Parameters:
size - size of the font to lookup.
weight - weight of the font to lookup.
family - the font family.
Returns:
the associated Font.


Copyright © 2005 Tensegrity Software GmbH. All Rights Reserved. Date of creation: 09.06.2006.