Класс 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()

Возвращает тип этого устройства.

public abstract String getIDstring()

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

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

public abstract GraphicsConfiguration[] getConfigurations()

Возвращает все объекты конфигурации, связанные с этим устройством.

public abstract GraphicsConfiguration getDefaultConfiguration()

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

public GraphicsConfiguration getBestConfiguration(GraphicsConfigTemplate gct)

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

public boolean isFullScreenSupported()

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

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, если это устройство поддерживает низкоуровневые изменения отображения. На некоторых платформах низкоуровневые изменения отображения разрешены только в эксклюзивном полноэкранном режиме (то есть, если isFullScreenSupported() возвращает true и приложение уже вошло в полноэкранный режим с помощью setFullScreenWindow(java.awt.Window)).

public void setDisplayMode(DisplayMode dm)

Устанавливает режим отображения этого графического устройства. Это разрешено только в том случае, если isDisplayChangeSupported() возвращает true и может потребовать предварительного перехода в полноэкранный режим с использованием setFullScreenWindow(java.awt.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)

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