java.awt
Class TexturePaint
- java.lang.Object
-
- java.awt.TexturePaint
-
- All Implemented Interfaces:
- Paint, Transparency
public class TexturePaint extends Object implements Paint
TheTexturePaint
class provides a way to fill aShape
with a texture that is specified as aBufferedImage
. The size of theBufferedImage
object should be small because theBufferedImage
data is copied by theTexturePaint
object. At construction time, the texture is anchored to the upper left corner of aRectangle2D
that is specified in user space. Texture is computed for locations in the device space by conceptually replicating the specifiedRectangle2D
infinitely in all directions in user space and mapping theBufferedImage
to each replicatedRectangle2D
.- Version:
- 1.48, 06/05/07
- See Also:
-
Paint
,Graphics2D.setPaint(java.awt.Paint)
-
-
Field Summary
-
Fields inherited from interface java.awt.Transparency
BITMASK, OPAQUE, TRANSLUCENT
-
-
Constructor Summary
Constructors Constructor and Description TexturePaint(BufferedImage txtr, Rectangle2D anchor)
Constructs aTexturePaint
object.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method and 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 Detail
TexturePaint
public TexturePaint(BufferedImage txtr, Rectangle2D anchor)
Constructs aTexturePaint
object.- Parameters:
-
txtr
- theBufferedImage
object with the texture used for painting -
anchor
- theRectangle2D
in user space used to anchor and replicate the texture
-
Method Detail
getImage
public BufferedImage getImage()
Returns theBufferedImage
texture used to fill the shapes.- Returns:
-
a
BufferedImage
.
getAnchorRect
public Rectangle2D 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
-
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.