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