Класс GraphicsConfiguration
public abstract class GraphicsConfiguration extends Object
GraphicsConfiguration описывает характеристики графического устройства, такого как принтер или монитор. Может быть много объектов GraphicsConfiguration для одного графического устройства, представляющих различные режимы или возможности рисования. Соответствующая нативная структура будет различаться в зависимости от платформы. Например, в системах окон X11 каждый визуальный элемент — это другой GraphicsConfiguration. В Microsoft Windows объекты GraphicsConfiguration представляют PixelFormats, доступные в текущем разрешении и цветовой глубине. В виртуальной многоэкранной среде, где область рабочего стола может охватывать несколько физических экранов, границы объектов 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());
}
}
- См. также:
Краткое описание конструкторов
| Модификатор | Конструктор | Описание |
|---|---|---|
protected |
Этот абстрактный класс нельзя создать напрямую. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
BufferedImage |
createCompatibleImage |
Возвращает BufferedImage с расположением данных и цветовой моделью, совместимыми с этим GraphicsConfiguration. |
BufferedImage |
createCompatibleImage |
Возвращает BufferedImage, поддерживающий указанную прозрачность и имеющий расположение данных и цветовую модель, совместимые с этим GraphicsConfiguration. |
VolatileImage |
createCompatibleVolatileImage |
Возвращает VolatileImage с расположением данных и цветовой моделью, совместимыми с этим GraphicsConfiguration. |
VolatileImage |
createCompatibleVolatileImage |
Возвращает VolatileImage с расположением данных и цветовой моделью, совместимыми с этим GraphicsConfiguration. |
VolatileImage |
createCompatibleVolatileImage |
Возвращает VolatileImage с расположением данных и цветовой моделью, совместимыми с этим GraphicsConfiguration, используя указанные возможности изображения. |
VolatileImage |
createCompatibleVolatileImage |
Возвращает VolatileImage с расположением данных и цветовой моделью, совместимыми с этим GraphicsConfiguration, используя указанные возможности изображения и значение прозрачности. |
abstract Rectangle |
getBounds() |
Возвращает границы GraphicsConfiguration в координатах устройства. |
BufferCapabilities |
getBufferCapabilities() |
Возвращает возможности буферизации этого GraphicsConfiguration. |
abstract ColorModel |
getColorModel() |
Возвращает ColorModel, связанный с этим GraphicsConfiguration. |
abstract ColorModel |
getColorModel |
Возвращает 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. |
Подробное описание конструкторов
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)
VolatileImage с расположением данных и цветовой моделью, совместимыми с этим GraphicsConfiguration . Возвращаемый VolatileImage может иметь данные, оптимально хранящиеся для базового графического устройства, и поэтому может извлечь выгоду из специфичных для платформы функций ускорения рендеринга.- Параметры:
-
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. В большинстве случаев для обычных экранов это преобразование тождества. Преобразование по умолчанию отображает координаты на устройство таким образом, что 72 единицы координат пространства пользователя примерно соответствуют 1 дюйму в пространстве устройства. Для более точного отображения можно использовать нормализующее преобразование. Координаты в пространстве координат, определяемом преобразованием по умолчанию для устройств экрана и принтера, имеют начало в верхнем левом углу целевого региона устройства, значения X увеличиваются вправо, а значения Y увеличиваются вниз. Для буферов изображений, не связанных с устройством (например, для тех, что не были созданы createCompatibleImage), это преобразование — преобразование тождества.- Возвращает:
- преобразование по умолчанию для этого
GraphicsConfiguration.
getNormalizingTransform
public abstract AffineTransform getNormalizingTransform()
AffineTransform объекта GraphicsConfiguration, чтобы 72 единицы в пространстве пользователя соответствовали 1 дюйму в пространстве устройства. Для конкретного объекта Graphics2D, g, можно сбросить преобразование для создания такого отображения, используя следующий псевдокод:
GraphicsConfiguration gc = g.getDeviceConfiguration();
g.setTransform(gc.getDefaultTransform());
g.transform(gc.getNormalizingTransform());
Обратите внимание, что иногда это преобразование является тождественным, например, для принтеров или вывода метафайлов, и что это преобразование точно соответствует только той информации, которая предоставляется базовой системой. Для буферов изображений, не связанных с устройством (например, для тех, что не были созданы createCompatibleImage), это преобразование — преобразование тождества, поскольку нет действительного измерения расстояния.- Возвращает:
- преобразование для конкатенации с преобразованием по умолчанию
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.- Возвращает:
- поддерживает ли данная конфигурация графического устройства эффекты полупрозрачности.
- С:
- 1.7
- См. также:
© 1993, 2023, 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.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/java/awt/GraphicsConfiguration.html