TexturePaint (Java SE 17 & JDK 17)
- 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:
-
Field Summary
-
Constructor Summary
Constructors
Constructs a
TexturePaintobject. -
Method Summary
Creates and returns a
PaintContextused to generate a tiled image pattern.Returns a copy of the anchor rectangle which positions and sizes the textured image.
getImage()Returns the
BufferedImagetexture used to fill the shapes.intReturns the transparency mode for this
TexturePaint.
-
Constructor Details
-
TexturePaint
Constructs a
TexturePaintobject.- Parameters:
txtr- theBufferedImageobject with the texture used for paintinganchor- theRectangle2Din user space used to anchor and replicate the texture
-
-
Method Details
-
getImage
Returns the
BufferedImagetexture 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
Rectangle2Dused to anchor and size thisTexturePaint.
-
createContext
Creates and returns a
PaintContextused to generate a tiled image pattern. See thespecificationof the method in thePaintinterface for information on null parameter handling.- Specified by:
createContextin interfacePaint- Parameters:
cm- the preferredColorModelwhich represents the most convenient format for the caller to receive the pixel data, ornullif 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- theAffineTransformfrom user space into device space.hints- the set of hints that the context object can use to choose between rendering alternatives.- Returns:
- the
PaintContextfor generating color patterns. - See Also:
-
getTransparency
public int getTransparency()
Returns the transparency mode for this
TexturePaint.- Specified by:
getTransparencyin interfaceTransparency- Returns:
- the transparency mode for this
TexturePaintas an integer value. - See Also:
-