Класс 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, программист может использовать этот метод для отладки. Поставщики Java Runtime Environment могут форматировать возвращаемое значение метода String. Чтобы определить, как интерпретировать значение String, обратитесь к поставщику вашей Java Runtime. Чтобы узнать, кто является поставщиком, в вашей программе вызовите метод 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 поддерживает полноэкранный эксклюзивный режим. Если установлен SecurityManager, его метод checkPermission будет вызван с AWTPermission("fullScreenExclusive"). 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 , если данное GraphicsDevice поддерживает низкоуровневые изменения отображения. На некоторых платформах низкоуровневые изменения отображения разрешены только в эксклюзивном полноэкранном режиме (т.е., если 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)

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