java.awt
Interface Paint
-
- All Superinterfaces:
- Transparency
- All Known Implementing Classes:
- Color, ColorUIResource, GradientPaint, LinearGradientPaint, MultipleGradientPaint, RadialGradientPaint, SystemColor, TexturePaint
public interface Paint extends Transparency
ThisPaintinterface defines how color patterns can be generated forGraphics2Doperations. A class implementing thePaintinterface is added to theGraphics2Dcontext in order to define the color pattern used by thedrawandfillmethods.Instances of classes implementing
Paintmust be read-only because theGraphics2Ddoes not clone these objects when they are set as an attribute with thesetPaintmethod or when theGraphics2Dobject is itself cloned.- Version:
- 1.36, 06/05/07
- See Also:
-
PaintContext,Color,GradientPaint,TexturePaint,Graphics2D.setPaint(java.awt.Paint)
-
-
Field Summary
-
Fields inherited from interface java.awt.Transparency
BITMASK, OPAQUE, TRANSLUCENT
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method and Description PaintContextcreateContext(ColorModel cm, Rectangle deviceBounds, Rectangle2D userBounds, AffineTransform xform, RenderingHints hints)Creates and returns aPaintContextused 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 aPaintContextused 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 thePaintinterface. A caller must pass non-nullvalues for all of the arguments except for theColorModelargument which may benullto indicate that no specificColorModeltype is preferred. Implementations of thePaintinterface are allowed to use or ignore any of the arguments as makes sense for their function, and are not constrained to use the specifiedColorModelfor the returnedPaintContext, even if it is notnull. Implementations are allowed to throwNullPointerExceptionfor anynullargument other than theColorModelargument, but are not required to do so.- 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. Implementations of thePaintinterface are allowed to throwNullPointerExceptionfor anulldeviceBounds. -
userBounds- the user space bounding box of the graphics primitive being rendered. Implementations of thePaintinterface are allowed to throwNullPointerExceptionfor anulluserBounds. -
xform- theAffineTransformfrom user space into device space. Implementations of thePaintinterface are allowed to throwNullPointerExceptionfor anullxform. -
hints- the set of hints that the context object can use to choose between rendering alternatives. Implementations of thePaintinterface are allowed to throwNullPointerExceptionfor anullhints. - Returns:
-
the
PaintContextfor generating color patterns. - See Also:
-
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.
