Interface Paint

All Superinterfaces:
Transparency
All Known Implementing Classes:
Color,ColorUIResource,GradientPaint,LinearGradientPaint,MultipleGradientPaint,RadialGradientPaint,SystemColor,TexturePaint
public interfacePaintextendsTransparency
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 implementingPaint 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.

See Also:

  • Method Details

    • 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:
      thePaintContext for generating color patterns.
      See Also: