public class

TexturePaint

extends Object
implements Paint
java.lang.Object
   ↳ java.awt.TexturePaint

Class Overview

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.

Summary

[Expand]
Inherited Constants
From interface java.awt.Transparency
Public Constructors
TexturePaint(BufferedImage txtr, Rectangle2D anchor)
Constructs a TexturePaint object.
Public Methods
PaintContext createContext(ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform xform, RenderingHints hints)
Creates and returns a PaintContext 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 the BufferedImage texture used to fill the shapes.
int getTransparency()
Returns the transparency mode for this TexturePaint.
[Expand]
Inherited Methods
From class java.lang.Object
From interface java.awt.Paint
From interface java.awt.Transparency

Public Constructors

public TexturePaint (BufferedImage txtr, Rectangle2D anchor)

Constructs a TexturePaint object.

Parameters
txtr the BufferedImage object with the texture used for painting
anchor the Rectangle2D in user space used to anchor and replicate the texture

Public Methods

public PaintContext createContext (ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform xform, RenderingHints hints)

Creates and returns a PaintContext used to generate a tiled image pattern. See the specification of the method in the Paint interface for information on null parameter handling.

Parameters
cm the preferred ColorModel which represents the most convenient format for the caller to receive the pixel data, or null 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 the AffineTransform 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.

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 this TexturePaint.

public BufferedImage getImage ()

Returns the BufferedImage texture used to fill the shapes.

Returns
  • a BufferedImage.

public int getTransparency ()

Returns the transparency mode for this TexturePaint.

Returns
  • the transparency mode for this TexturePaint as an integer value.
See Also