public interface Paint extends Transparency
Paint interface defines how color patterns
can be generated for Graphics2D operations. A class
implementing the Paint interface is added to the
Graphics2D context in order to define the color
pattern used by the draw and fill methods.
Instances of classes implementing Paint must be
read-only because the Graphics2D does not clone
these objects when they are set as an attribute with the
setPaint method or when the Graphics2D
object is itself cloned.
PaintContext,
Color,
GradientPaint,
TexturePaint,
Graphics2D.setPaint(java.awt.Paint)BITMASK, OPAQUE, TRANSLUCENT| Modifier and Type | Method and Description |
|---|---|
PaintContext |
createContext(ColorModel cm,
Rectangle deviceBounds,
Rectangle2D userBounds,
AffineTransform xform,
RenderingHints hints)
Creates and returns a
PaintContext used to
generate the color pattern. |
getTransparencyPaintContext createContext(ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform xform, RenderingHints hints)
PaintContext used to
generate the color pattern.
The arguments to this method convey additional information
about the rendering operation that may be
used or ignored on various implementations of the Paint interface.
A caller must pass non-null values for all of the arguments
except for the ColorModel argument which may be null to
indicate that no specific ColorModel type is preferred.
Implementations of the Paint interface are allowed to use or ignore
any of the arguments as makes sense for their function, and are
not constrained to use the specified ColorModel for the returned
PaintContext, even if it is not null.
Implementations are allowed to throw NullPointerException for
any null argument other than the ColorModel argument,
but are not required to do so.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.
Implementations of the Paint interface
are allowed to throw NullPointerException
for a null deviceBounds.userBounds - the user space bounding box
of the graphics primitive being rendered.
Implementations of the Paint interface
are allowed to throw NullPointerException
for a null userBounds.xform - the AffineTransform from user
space into device space.
Implementations of the Paint interface
are allowed to throw NullPointerException
for a null xform.hints - the set of hints that the context object can use to
choose between rendering alternatives.
Implementations of the Paint interface
are allowed to throw NullPointerException
for a null hints.PaintContext for
generating color patterns.PaintContext,
ColorModel,
Rectangle,
Rectangle2D,
AffineTransform,
RenderingHints 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.