Spec-Zone.ru › OpenJDK 21

Класс GraphicsConfiguration

java.lang.Object
java.awt.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());
          }
      } 
См. также:
  • Window
  • Frame
  • GraphicsEnvironment
  • GraphicsDevice

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

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.

Методы, унаследованные от класса java.lang.Object

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

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

GraphicsConfiguration

protected GraphicsConfiguration()
Это абстрактный класс, который нельзя создать напрямую. Экземпляры должны быть получены из соответствующего фабричного метода или метода запроса.
См. также:
  • GraphicsDevice.getConfigurations()
  • GraphicsDevice.getDefaultConfiguration()
  • GraphicsDevice.getBestConfiguration(java.awt.GraphicsConfigTemplate)
  • Graphics2D.getDeviceConfiguration()

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

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 - если режим прозрачности не является допустимым значением
См. также:
  • Transparency.OPAQUE
  • Transparency.BITMASK
  • Transparency.TRANSLUCENT

createCompatibleVolatileImage

public VolatileImage createCompatibleVolatileImage(int width, int height)
Возвращает VolatileImage с расположением данных и цветовой моделью, совместимыми с этим GraphicsConfiguration . Возвращаемый VolatileImage может иметь данные, оптимально хранящиеся для базового графического устройства, и поэтому может извлечь выгоду из специфичных для платформы функций ускорения рендеринга.
Параметры:
width - ширина возвращаемого VolatileImage
height - высота возвращаемого VolatileImage
Возвращает:
VolatileImage с расположением данных и цветовой моделью, совместимыми с этим GraphicsConfiguration.
С:
1.4
См. также:
  • Component.createVolatileImage(int, int)

createCompatibleVolatileImage

public VolatileImage createCompatibleVolatileImage(int width, int height, int transparency)
Возвращает VolatileImage с расположением данных и цветовой моделью, совместимыми с этим GraphicsConfiguration . Возвращаемый VolatileImage может иметь данные, оптимально хранящиеся для базового графического устройства, и поэтому может извлечь выгоду из специфичных для платформы функций ускорения рендеринга.
Параметры:
width - ширина возвращаемого VolatileImage
height - высота возвращаемого VolatileImage
transparency - заданный режим прозрачности
Возвращает:
VolatileImage с расположением данных и цветовой моделью, совместимыми с этим GraphicsConfiguration.
Исключения:
IllegalArgumentException - если режим прозрачности не является допустимым значением
С:
1.5
См. также:
  • Transparency.OPAQUE
  • Transparency.BITMASK
  • Transparency.TRANSLUCENT
  • Component.createVolatileImage(int, int)

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
См. также:
  • Transparency.OPAQUE
  • Transparency.BITMASK
  • Transparency.TRANSLUCENT
  • Component.createVolatileImage(int, int)

getColorModel

public abstract ColorModel getColorModel()
Возвращает ColorModel, связанную с этим GraphicsConfiguration.
Возвращает:
объект ColorModel , связанный с этим GraphicsConfiguration.

getColorModel

public abstract ColorModel getColorModel(int transparency)
Возвращает ColorModel , связанную с этим GraphicsConfiguration и поддерживающую указанный режим прозрачности.
Параметры:
transparency - заданный режим прозрачности
Возвращает:
объект ColorModel , связанный с этим GraphicsConfiguration и поддерживающий указанную прозрачность или null, если режим прозрачности не является допустимым значением.
См. также:
  • Transparency.OPAQUE
  • Transparency.BITMASK
  • Transparency.TRANSLUCENT

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
См. также:
  • Window.setBackground(Color)

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API