-
- All Superinterfaces:
- Transparency
- All Known Implementing Classes:
- Color, ColorUIResource, GradientPaint, LinearGradientPaint, MultipleGradientPaint, RadialGradientPaint, SystemColor, TexturePaint
public interface Paint extends Transparency
ThisPaint
interface defines how color patterns can be generated forGraphics2D
operations. A class implementing thePaint
interface is added to theGraphics2D
context in order to define the color pattern used by thedraw
andfill
methods.Instances of classes implementing
Paint
must be read-only because theGraphics2D
does not clone these objects when they are set as an attribute with thesetPaint
method or when theGraphics2D
object is itself cloned.
-
-
Field Summary
-
Fields inherited from interface java.awt.Transparency
BITMASK, OPAQUE, TRANSLUCENT
-
-
Method Summary
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 the color pattern.-
Methods inherited from interface java.awt.Transparency
getTransparency
-
-
-
-
Method Detail
-
createContext
PaintContext createContext(ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform xform, RenderingHints hints)
Creates and returns aPaintContext
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 thePaint
interface. A caller must pass non-null
values for all of the arguments except for theColorModel
argument which may benull
to indicate that no specificColorModel
type is preferred. Implementations of thePaint
interface are allowed to use or ignore any of the arguments as makes sense for their function, and are not constrained to use the specifiedColorModel
for the returnedPaintContext
, even if it is notnull
. Implementations are allowed to throwNullPointerException
for anynull
argument other than theColorModel
argument, but are not required to do so.- 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. Implementations of thePaint
interface are allowed to throwNullPointerException
for anull
deviceBounds
.userBounds
- the user space bounding box of the graphics primitive being rendered. Implementations of thePaint
interface are allowed to throwNullPointerException
for anull
userBounds
.xform
- theAffineTransform
from user space into device space. Implementations of thePaint
interface are allowed to throwNullPointerException
for anull
xform
.hints
- the set of hints that the context object can use to choose between rendering alternatives. Implementations of thePaint
interface are allowed to throwNullPointerException
for anull
hints
.- Returns:
- the
PaintContext
for generating color patterns. - See Also:
PaintContext
,ColorModel
,Rectangle
,Rectangle2D
,AffineTransform
,RenderingHints
-
-
Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-java/awt/paint.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.