Интерфейс Composite

public interface Composite

Интерфейс Composite, вместе с CompositeContext, определяет методы для объединения графического примитива с базовой областью графики. После того, как Composite задан в контексте Graphics2D, он комбинирует отрисовываемую фигуру, текст или изображение с уже отрисованными цветами в соответствии с предварительно определёнными правилами. Классы, реализующие этот интерфейс, предоставляют правила и метод для создания контекста для конкретной операции. CompositeContext — это среда, используемая операцией объединения, которая создаётся Graphics2D перед началом операции. CompositeContext содержит закрытую информацию и ресурсы, необходимые для операции объединения. Когда CompositeContext больше не нужен, объект Graphics2D освобождает его, чтобы вернуть ресурсы, выделенные для операции.

Экземпляры классов, реализующих Composite, должны быть неизменяемыми, потому что Graphics2D не клонирует эти объекты, когда они задаются как атрибут с помощью метода setComposite или когда объект Graphics2D клонируется. Это позволяет избежать неопределённого поведения отрисовки Graphics2D, возникающего из-за изменения объекта Composite после его задания в контексте Graphics2D.

Поскольку этот интерфейс должен предоставлять содержимое пикселей на целевом устройстве или изображении потенциально произвольному коду, использование пользовательских объектов, реализующих этот интерфейс при непосредственной отрисовке на экране устройства, регулируется readDisplayPixels AWTPermission. Проверка разрешения выполняется при передаче такого пользовательского объекта методу setComposite объекта Graphics2D, полученного из Component.

Методы

createContext

CompositeContext createContext(ColorModel srcColorModel,
                               ColorModel dstColorModel,
                               RenderingHints hints)

Создаёт контекст, содержащий состояние, используемое для выполнения операции объединения. В многопоточной среде несколько контекстов могут существовать одновременно для одного объекта Composite.

Параметры:

srcColorModel - ColorModel источника

dstColorModel - ColorModel назначения

hints - подсказка, которую объект контекста использует для выбора между альтернативными способами отрисовки

Возвращает:

объект CompositeContext для выполнения операции объединения.