- All Known Implementing Classes:
public interface CompositeThe
Compositeinterface, along with
CompositeContext, defines the methods to compose a draw primitive with the underlying graphics area. After the
Compositeis set in the
Graphics2Dcontext, it combines a shape, text, or an image being rendered with the colors that have already been rendered according to pre-defined rules. The classes implementing this interface provide the rules and a method to create the context for a particular operation.
CompositeContextis an environment used by the compositing operation, which is created by the
Graphics2Dprior to the start of the operation.
CompositeContextcontains private information and resources needed for a compositing operation. When the
CompositeContextis no longer needed, the
Graphics2Dobject disposes of it in order to reclaim resources allocated for the operation.
Instances of classes implementing
Compositemust be immutable because the
Graphics2Ddoes not clone these objects when they are set as an attribute with the
setCompositemethod or when the
Graphics2Dobject is cloned. This is to avoid undefined rendering behavior of
Graphics2D, resulting from the modification of the
Compositeobject after it has been set in the
Since this interface must expose the contents of pixels on the target device or image to potentially arbitrary code, the use of custom objects which implement this interface when rendering directly to a screen device is governed by the
AWTPermission. The permission check will occur when such a custom object is passed to the
setCompositemethod of a
Graphics2Dretrieved from a
CompositeContext createContext(ColorModel srcColorModel, ColorModel dstColorModel, RenderingHints hints)Creates a context containing state that is used to perform the compositing operation. In a multi-threaded environment, several contexts can exist simultaneously for a single
ColorModelof the source
ColorModelof the destination
hints- the hint that the context object uses to choose between rendering alternatives
CompositeContextobject used to perform the compositing operation.