Класс GraphicsConfiguration

java.lang.Object

java.awt.GraphicsConfiguration

public abstract class GraphicsConfiguration extends Object

Класс GraphicsConfiguration описывает характеристики графического устройства вывода, например принтера или монитора. С одним графическим устройством может быть связано несколько объектов GraphicsConfiguration, представляющих различные режимы рисования или возможности. Соответствующая собственная структура зависит от платформы. Например, в оконных системах X11 каждый визуальный элемент представляет собой отдельный GraphicsConfiguration. В Microsoft Windows объекты GraphicsConfiguration представляют форматы пикселей, доступные при текущем разрешении и глубине цвета.

В среде с виртуальными устройствами и несколькими экранами, где область рабочего стола может охватывать несколько физических экранных устройств, границы объектов GraphicsConfiguration задаются относительно виртуальной системы координат. При задании местоположения компонента используйте getBounds, чтобы получить границы нужного GraphicsConfiguration, и сместите местоположение на координаты GraphicsConfiguration, как показано в следующем примере кода:

     Frame f = new Frame(gc);  // where gc is a GraphicsConfiguration
     Rectangle bounds = gc.getBounds();
     f.setLocation(10 + bounds.x, 10 + bounds.y);

Чтобы определить, работает ли ваша среда с виртуальными устройствами, вызовите getBounds для всех объектов GraphicsConfiguration в системе. Если начало координат хотя бы одних возвращённых границ не равно (0, 0), ваша среда работает с виртуальными устройствами.

Также для определения границ виртуального устройства можно использовать getBounds. Для этого сначала вызовите getBounds для всех объектов GraphicsConfiguration в системе. Затем вычислите объединение всех границ, возвращённых вызовами getBounds. Это объединение и будет границами виртуального устройства. В следующем примере кода вычисляются границы виртуального устройства.

     Rectangle virtualBounds = new Rectangle();
     GraphicsEnvironment ge = GraphicsEnvironment.
             getLocalGraphicsEnvironment();
     GraphicsDevice[] gs =
             ge.getScreenDevices();
     for (int j = 0; j < gs.length; j++) {
         GraphicsDevice gd = gs[j];
         GraphicsConfiguration[] gc =
             gd.getConfigurations();
         for (int i=0; i < gc.length; i++) {
             virtualBounds =
                 virtualBounds.union(gc[i].getBounds());
         }
     }

См. также:

Краткое описание конструкторов

GraphicsConfiguration()

Модификатор	Конструктор	Описание
`protected`	Это абстрактный класс, который нельзя создать напрямую.

Краткое описание методов

Модификатор и тип	Метод	Описание
`BufferedImage`	`createCompatibleImage(int width, int height)`	Возвращает `BufferedImage` с размещением данных и цветовой моделью, совместимыми с этим `GraphicsConfiguration`.
`BufferedImage`	`createCompatibleImage(int width, int height, int transparency)`	Возвращает `BufferedImage`, поддерживающий указанную прозрачность и имеющий размещение данных и цветовую модель, совместимые с этим `GraphicsConfiguration`.
`VolatileImage`	`createCompatibleVolatileImage(int width, int height)`	Возвращает `VolatileImage` с размещением данных и цветовой моделью, совместимыми с этим `GraphicsConfiguration`.
`VolatileImage`	`createCompatibleVolatileImage(int width, int height, int transparency)`	Возвращает `VolatileImage` с размещением данных и цветовой моделью, совместимыми с этим `GraphicsConfiguration`.
`VolatileImage`	`createCompatibleVolatileImage(int width, int height, ImageCapabilities caps)`	Возвращает `VolatileImage` с размещением данных и цветовой моделью, совместимыми с этим `GraphicsConfiguration`, используя указанные возможности изображения.
`VolatileImage`	`createCompatibleVolatileImage(int width, int height, ImageCapabilities caps, int transparency)`	Возвращает `VolatileImage` с размещением данных и цветовой моделью, совместимыми с этим `GraphicsConfiguration`, используя указанные возможности изображения и значение прозрачности.
`abstract Rectangle`	`getBounds()`	Возвращает границы `GraphicsConfiguration` в координатах устройства.
`BufferCapabilities`	`getBufferCapabilities()`	Возвращает возможности буферизации этого `GraphicsConfiguration`.
`abstract ColorModel`	`getColorModel()`	Возвращает `ColorModel`, связанную с этим `GraphicsConfiguration`.
`abstract ColorModel`	`getColorModel(int transparency)`	Возвращает `ColorModel`, связанную с этим `GraphicsConfiguration` и поддерживающую указанную прозрачность.
`abstract AffineTransform`	`getDefaultTransform()`	Возвращает преобразование `AffineTransform` по умолчанию для этого `GraphicsConfiguration`.
`abstract GraphicsDevice`	`getDevice()`	Возвращает `GraphicsDevice`, связанное с этим `GraphicsConfiguration`.
`ImageCapabilities`	`getImageCapabilities()`	Возвращает возможности изображения этого `GraphicsConfiguration`.
`abstract AffineTransform`	`getNormalizingTransform()`	Возвращает `AffineTransform`, которое можно объединить с `AffineTransform` по умолчанию для `GraphicsConfiguration`, чтобы 72 единицы в пользовательском пространстве равнялись 1 дюйму в пространстве устройства.
`boolean`	`isTranslucencyCapable()`	Возвращает, поддерживает ли этот `GraphicsConfiguration` тип полупрозрачности `PERPIXEL_TRANSLUCENT`.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удалён в будущей версии. Финализация объявлена устаревшей и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения определённого промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения определённого промежутка реального времени.

Подробное описание конструкторов

GraphicsConfiguration

protected GraphicsConfiguration()

Это абстрактный класс, который нельзя создать напрямую. Экземпляры необходимо получать с помощью подходящего фабричного метода или метода запроса.

См. также:

Подробное описание методов

getDevice

public abstract GraphicsDevice getDevice()

Возвращает GraphicsDevice, связанное с этим GraphicsConfiguration.

Возвращает:: объект GraphicsDevice, связанный с этим GraphicsConfiguration.

createCompatibleImage

public BufferedImage createCompatibleImage(int width, int height)

Возвращает BufferedImage с размещением данных и цветовой моделью, совместимыми с этим GraphicsConfiguration. Этот метод не имеет отношения к отображению устройства в память. Возвращаемый объект BufferedImage имеет размещение данных и цветовую модель, максимально соответствующие этой собственной конфигурации устройства, поэтому его можно оптимально копировать на это устройство.

Параметры:: width — ширина возвращаемого объекта BufferedImage; height — высота возвращаемого объекта BufferedImage
Возвращает:: объект BufferedImage, размещение данных и цветовая модель которого совместимы с этим GraphicsConfiguration.

createCompatibleImage

public BufferedImage createCompatibleImage(int width, int height, int transparency)

Возвращает BufferedImage, поддерживающий указанную прозрачность и имеющий размещение данных и цветовую модель, совместимые с этим GraphicsConfiguration. Этот метод не имеет отношения к отображению устройства в память. Возвращаемый объект BufferedImage имеет размещение данных и цветовую модель, позволяющие оптимально копировать его на устройство с этим GraphicsConfiguration.

Параметры:

width — ширина возвращаемого объекта BufferedImage

height — высота возвращаемого объекта BufferedImage

transparency — указанный режим прозрачности

Возвращает:

объект BufferedImage, размещение данных и цветовая модель которого совместимы с этим GraphicsConfiguration и который также поддерживает указанную прозрачность.

Вызывает исключение:

IllegalArgumentException — если значение прозрачности недопустимо

См. также:

createCompatibleVolatileImage

public VolatileImage createCompatibleVolatileImage(int width, int height)

Возвращает VolatileImage с размещением данных и цветовой моделью, совместимыми с этим GraphicsConfiguration. Данные возвращаемого объекта VolatileImage могут храниться в форме, оптимальной для базового графического устройства, и поэтому могут использовать аппаратное ускорение отрисовки, специфичное для платформы.

Параметры:

width — ширина возвращаемого объекта VolatileImage

height — высота возвращаемого объекта VolatileImage

Возвращает:

объект VolatileImage, размещение данных и цветовая модель которого совместимы с этим GraphicsConfiguration.

Начиная с:

1.4

См. также:

createCompatibleVolatileImage

public VolatileImage createCompatibleVolatileImage(int width, int height, int transparency)

Параметры:

width — ширина возвращаемого объекта VolatileImage

height — высота возвращаемого объекта VolatileImage

transparency — указанный режим прозрачности

Возвращает:

объект VolatileImage, размещение данных и цветовая модель которого совместимы с этим GraphicsConfiguration.

Вызывает исключение:

IllegalArgumentException — если значение прозрачности недопустимо

Начиная с:

1.5

См. также:

createCompatibleVolatileImage

public VolatileImage createCompatibleVolatileImage(int width, int height, ImageCapabilities caps) throws AWTException

Возвращает VolatileImage с размещением данных и цветовой моделью, совместимыми с этим GraphicsConfiguration, используя указанные возможности изображения. Если параметр caps равен null, он фактически игнорируется, и этот метод создаёт VolatileImage без учёта ограничений ImageCapabilities. Возвращаемый объект VolatileImage имеет размещение данных и цветовую модель, максимально соответствующие этой собственной конфигурации устройства, поэтому его можно оптимально копировать на это устройство.

Параметры:: width — ширина возвращаемого объекта VolatileImage; height — высота возвращаемого объекта VolatileImage; caps — возможности изображения
Возвращает:: объект VolatileImage, размещение данных и цветовая модель которого совместимы с этим GraphicsConfiguration.
Вызывает исключение:: AWTException — если эта графическая конфигурация не может обеспечить указанные возможности изображения
Начиная с:: 1.4

createCompatibleVolatileImage

public VolatileImage createCompatibleVolatileImage(int width, int height, ImageCapabilities caps, int transparency) throws AWTException

Возвращает VolatileImage с размещением данных и цветовой моделью, совместимыми с этим GraphicsConfiguration, используя указанные возможности изображения и значение прозрачности. Если параметр caps равен null, он фактически игнорируется, и этот метод создаёт VolatileImage без учёта ограничений ImageCapabilities. Возвращаемый объект VolatileImage имеет размещение данных и цветовую модель, максимально соответствующие этой собственной конфигурации устройства, поэтому его можно оптимально копировать на это устройство.

Параметры:

width — ширина возвращаемого объекта VolatileImage

height — высота возвращаемого объекта VolatileImage

caps — возможности изображения

transparency — указанный режим прозрачности

Возвращает:

объект VolatileImage, размещение данных и цветовая модель которого совместимы с этим GraphicsConfiguration.

Вызывает исключение:

IllegalArgumentException — если значение прозрачности недопустимо

AWTException — если эта графическая конфигурация не может обеспечить указанные возможности изображения

Начиная с:

1.5

См. также:

getColorModel

public abstract ColorModel getColorModel()

Возвращает ColorModel, связанную с этим GraphicsConfiguration.

Возвращает:: объект ColorModel, связанный с этим GraphicsConfiguration.

getColorModel

public abstract ColorModel getColorModel(int transparency)

Возвращает ColorModel, связанную с этим GraphicsConfiguration и поддерживающую указанную прозрачность.

Параметры:

transparency — указанный режим прозрачности

Возвращает:

объект ColorModel, связанный с этим GraphicsConfiguration и поддерживающий указанную прозрачность, или null, если значение прозрачности недопустимо.

См. также:

getDefaultTransform

public abstract AffineTransform getDefaultTransform()

Возвращает преобразование AffineTransform по умолчанию для этого GraphicsConfiguration. Для большинства обычных экранов это AffineTransform, как правило, является тождественным преобразованием. Преобразование AffineTransform по умолчанию отображает координаты на устройство таким образом, что 72 единицы координат пользовательского пространства приблизительно равны 1 дюйму в пространстве устройства. Нормирующее преобразование можно использовать, чтобы сделать это соответствие более точным. В системе координат, задаваемой преобразованием AffineTransform по умолчанию для экранных и печатающих устройств, начало координат находится в верхнем левом углу целевой области устройства; координата X увеличивается вправо, а координата Y — вниз. Для буферов изображений, не связанных с устройством, например созданных не с помощью createCompatibleImage, это AffineTransform является тождественным преобразованием.

Возвращает:: преобразование AffineTransform по умолчанию для этого GraphicsConfiguration.

getNormalizingTransform

public abstract AffineTransform getNormalizingTransform()

Возвращает AffineTransform, которое можно объединить с преобразованием AffineTransform по умолчанию для GraphicsConfiguration, чтобы 72 единицы в пользовательском пространстве равнялись 1 дюйму в пространстве устройства.

Для конкретного объекта Graphics2D g преобразование можно сбросить, чтобы задать такое соответствие, используя следующий псевдокод:

     GraphicsConfiguration gc = g.getDeviceConfiguration();

     g.setTransform(gc.getDefaultTransform());
     g.transform(gc.getNormalizingTransform());

Обратите внимание, что иногда это AffineTransform является тождественным, например для принтеров или вывода в метафайл, а также что точность этого AffineTransform зависит от точности сведений, предоставляемых базовой системой. Для буферов изображений, не связанных с устройством, например созданных не с помощью createCompatibleImage, это AffineTransform является тождественным преобразованием, поскольку корректное измерение расстояния невозможно.

Возвращает:: AffineTransform для объединения с преобразованием AffineTransform по умолчанию, чтобы 72 единицы в пользовательском пространстве отображались как 1 дюйм в пространстве устройства.

getBounds

public abstract Rectangle getBounds()

Возвращает границы GraphicsConfiguration в координатах устройства. В среде с несколькими экранами и виртуальным устройством начало координат X или Y может быть отрицательным.

Возвращает:: границы области, охватываемой этим GraphicsConfiguration.
Начиная с:: 1.3

getBufferCapabilities

public BufferCapabilities getBufferCapabilities()

Возвращает возможности буферизации этого GraphicsConfiguration.

Возвращает:: возможности буферизации этого объекта графической конфигурации
Начиная с:: 1.4

getImageCapabilities

public ImageCapabilities getImageCapabilities()

Возвращает возможности изображения этого GraphicsConfiguration.

Возвращает:: возможности изображения этого объекта графической конфигурации
Начиная с:: 1.4

isTranslucencyCapable

public boolean isTranslucencyCapable()

Возвращает, поддерживает ли этот GraphicsConfiguration тип полупрозрачности PERPIXEL_TRANSLUCENT.

Возвращает:

поддерживает ли указанная GraphicsConfiguration эффекты полупрозрачности.

Начиная с:

1.7

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.