Класс GraphicsDevice

public static final int TYPE_RASTER_SCREEN

Устройство является растровым экраном.

public static final int TYPE_PRINTER

Устройство является принтером.

public static final int TYPE_IMAGE_BUFFER

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

protected GraphicsDevice()

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

public abstract int getType()

Возвращает тип этого GraphicsDevice.

public abstract String getIDstring()

Возвращает строку идентификатора, связанную с этим GraphicsDevice.

В конкретной программе может использоваться несколько объектов GraphicsDevice в GraphicsEnvironment. Этот метод возвращает String, идентифицирующую конкретный GraphicsDevice в локальной GraphicsEnvironment. Хотя общедоступного метода для установки этого String нет, программист может использовать String в целях отладки. Поставщики среды выполнения Java могут задавать формат возвращаемого значения String. Чтобы определить, как интерпретировать значение String, обратитесь к поставщику среды выполнения Java. Чтобы узнать, кто является поставщиком, вызовите в своей программе метод getProperty класса System с аргументом "java.vendor".

public abstract GraphicsConfiguration[] getConfigurations()

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

public abstract GraphicsConfiguration getDefaultConfiguration()

Возвращает конфигурацию GraphicsConfiguration по умолчанию, связанную с этим GraphicsDevice.

public GraphicsConfiguration getBestConfiguration(GraphicsConfigTemplate gct)

Возвращает наилучшую возможную конфигурацию, соответствующую критериям, заданным в GraphicsConfigTemplate.

public boolean isFullScreenSupported()

Возвращает true, если этот GraphicsDevice поддерживает монопольный полноэкранный режим.

public void setFullScreenWindow(Window w)

Переходит в полноэкранный режим или возвращается в оконный режим. Полноэкранный режим может быть как монопольным, так и эмулируемым. Монопольный режим доступен, только если isFullScreenSupported возвращает true.

Монопольный режим означает следующее:

• Окна не могут перекрывать полноэкранное окно. Все остальные окна приложений всегда будут располагаться ниже полноэкранного окна в порядке Z.
• На устройстве одновременно может быть только одно полноэкранное окно, поэтому вызов этого метода при наличии уже открытого полноэкранного окна вернёт его в оконный режим.
• Окна методов ввода отключаются. Рекомендуется вызвать Component.enableInputMethods(false), чтобы сделать компонент не принадлежащим инфраструктуре методов ввода.

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

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

При переходе в полноэкранный режим все эффекты прозрачности окна сбрасываются. Его форма устанавливается в null, значение непрозрачности — в 1.0f, а альфа-канал цвета фона — в 255 (полная непрозрачность). При возврате в оконный режим эти значения не восстанавливаются.

Поведение окон с оформлением в полноэкранном режиме не определено и зависит от платформы. Поэтому рекомендуется отключать оформление объекта Frame или Dialog с помощью метода setUndecorated.

При возврате из монопольного полноэкранного окна в оконный режим все изменения параметров отображения, внесённые вызовом setDisplayMode, автоматически отменяются.

public Window getFullScreenWindow()

Возвращает объект Window, представляющий полноэкранное окно, если устройство находится в полноэкранном режиме.

public boolean isDisplayChangeSupported()

Возвращает true, если этот GraphicsDevice поддерживает низкоуровневое изменение параметров отображения. На некоторых платформах низкоуровневое изменение параметров отображения разрешено только в монопольном полноэкранном режиме (то есть если isFullScreenSupported() возвращает true и приложение уже перешло в полноэкранный режим с помощью setFullScreenWindow(Window)).

public void setDisplayMode(DisplayMode dm)

Устанавливает режим отображения этого графического устройства. Это разрешено, только если isDisplayChangeSupported() возвращает true; может потребоваться сначала перейти в монопольный полноэкранный режим с помощью setFullScreenWindow(Window), если этот режим поддерживается (то есть isFullScreenSupported() возвращает true).

Режим отображения должен входить в список режимов, возвращаемых методом getDisplayModes(), за одним исключением: передача режима отображения с частотой обновления DisplayMode.REFRESH_RATE_UNKNOWN приведёт к выбору из доступных режимов отображения режима с совпадающими шириной, высотой и глубиной цвета. Однако передача режима отображения со значением глубины цвета DisplayMode.BIT_DEPTH_MULTI допускается, только если такой режим присутствует в списке, возвращаемом методом getDisplayModes().

Пример кода:

Frame frame;
DisplayMode newDisplayMode;
GraphicsDevice gd;
// create a Frame, select desired DisplayMode from the list of modes
// returned by gd.getDisplayModes() ...

if (gd.isFullScreenSupported()) {
    gd.setFullScreenWindow(frame);
} else {
   // proceed in non-full-screen mode
   frame.setSize(...);
   frame.setLocation(...);
   frame.setVisible(true);
}

if (gd.isDisplayChangeSupported()) {
    gd.setDisplayMode(newDisplayMode);
}

public DisplayMode getDisplayMode()

Возвращает текущий режим отображения этого GraphicsDevice. Если частота обновления не определена, возвращаемое значение может содержать частоту обновления DisplayMode.REFRESH_RATE_UNKNOWN. Аналогично, если глубина цвета не определена или поддерживается несколько значений глубины цвета, возвращаемое значение может содержать глубину цвета DisplayMode.BIT_DEPTH_MULTI.

public DisplayMode[] getDisplayModes()

Возвращает все режимы отображения, доступные для этого GraphicsDevice. Если частота обновления не определена, возвращаемые режимы отображения могут содержать частоту обновления DisplayMode.REFRESH_RATE_UNKNOWN. Аналогично, если глубина цвета не определена или поддерживается несколько значений глубины цвета, возвращаемые режимы отображения могут содержать глубину цвета DisplayMode.BIT_DEPTH_MULTI.

public int getAvailableAcceleratedMemory()

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

public boolean isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency translucencyKind)

Возвращает, поддерживается ли данным графическим устройством заданный уровень прозрачности.