Interface Composite
-
- All Known Implementing Classes:
- AlphaComposite
public interface CompositeTheCompositeinterface, along withCompositeContext, defines the methods to compose a draw primitive with the underlying graphics area. After theCompositeis set in theGraphics2Dcontext, 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 theGraphics2Dprior to the start of the operation.CompositeContextcontains private information and resources needed for a compositing operation. When theCompositeContextis no longer needed, theGraphics2Dobject disposes of it in order to reclaim resources allocated for the operation.Instances of classes implementing
Compositemust be immutable because theGraphics2Ddoes not clone these objects when they are set as an attribute with thesetCompositemethod or when theGraphics2Dobject is cloned. This is to avoid undefined rendering behavior ofGraphics2D, resulting from the modification of theCompositeobject after it has been set in theGraphics2Dcontext.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
readDisplayPixelsAWTPermission. The permission check will occur when such a custom object is passed to thesetCompositemethod of aGraphics2Dretrieved from aComponent.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method and Description CompositeContextcreateContext(ColorModel srcColorModel, ColorModel dstColorModel, RenderingHints hints)Creates a context containing state that is used to perform the compositing operation.
-
-
-
Method Detail
createContext
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 singleCompositeobject.- Parameters:
-
srcColorModel- theColorModelof the source -
dstColorModel- theColorModelof the destination -
hints- the hint that the context object uses to choose between rendering alternatives - Returns:
-
the
CompositeContextobject used to perform the compositing operation.
-
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.
