Интерфейс 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.