java.lang.Object
java.awt.TexturePaint
- All Implemented Interfaces:
Paint
,Transparency
public class TexturePaint extends Object implements Paint
The
TexturePaint
class provides a way to fill a
Shape
with a texture that is specified as
a BufferedImage
. The size of the BufferedImage
object should be small because the BufferedImage
data
is copied by the TexturePaint
object.
At construction time, the texture is anchored to the upper
left corner of a Rectangle2D
that is
specified in user space. Texture is computed for
locations in the device space by conceptually replicating the
specified Rectangle2D
infinitely in all directions
in user space and mapping the BufferedImage
to each
replicated Rectangle2D
.- See Also:
Paint
,Graphics2D.setPaint(java.awt.Paint)
-
Field Summary
Fields declared in interface java.awt.Transparency
BITMASK, OPAQUE, TRANSLUCENT
-
Constructor Summary
Constructors Constructor Description TexturePaint(BufferedImage txtr, Rectangle2D anchor)
Constructs aTexturePaint
object. -
Method Summary
Modifier and Type Method Description PaintContext
createContext(ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform xform, RenderingHints hints)
Creates and returns aPaintContext
used to generate a tiled image pattern.Rectangle2D
getAnchorRect()
Returns a copy of the anchor rectangle which positions and sizes the textured image.BufferedImage
getImage()
Returns theBufferedImage
texture used to fill the shapes.int
getTransparency()
Returns the transparency mode for thisTexturePaint
.
-
Constructor Details
-
TexturePaint
Constructs aTexturePaint
object.- Parameters:
txtr
- theBufferedImage
object with the texture used for paintinganchor
- theRectangle2D
in user space used to anchor and replicate the texture
-
-
Method Details
-
getImage
Returns theBufferedImage
texture used to fill the shapes.- Returns:
- a
BufferedImage
.
-
getAnchorRect
Returns a copy of the anchor rectangle which positions and sizes the textured image.- Returns:
- the
Rectangle2D
used to anchor and size thisTexturePaint
.
-
createContext
public PaintContext createContext(ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform xform, RenderingHints hints)Creates and returns aPaintContext
used to generate a tiled image pattern. See thespecification
of the method in thePaint
interface for information on null parameter handling.- Specified by:
createContext
in interfacePaint
- Parameters:
cm
- the preferredColorModel
which represents the most convenient format for the caller to receive the pixel data, ornull
if there is no preference.deviceBounds
- the device space bounding box of the graphics primitive being rendered.userBounds
- the user space bounding box of the graphics primitive being rendered.xform
- theAffineTransform
from user space into device space.hints
- the set of hints that the context object can use to choose between rendering alternatives.- Returns:
- the
PaintContext
for generating color patterns. - See Also:
Paint
,PaintContext
,ColorModel
,Rectangle
,Rectangle2D
,AffineTransform
,RenderingHints
-
getTransparency
public int getTransparency()Returns the transparency mode for thisTexturePaint
.- Specified by:
getTransparency
in interfaceTransparency
- Returns:
- the transparency mode for this
TexturePaint
as an integer value. - See Also:
Transparency
-