Класс 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 в локальной 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.

Эксклюзивный режим подразумевает:

• Окна не могут перекрывать полноэкранное окно. Все остальные окна приложения всегда будут отображаться под полноэкранным окном в порядке наложения.
• В любой момент времени на устройстве может быть только одно полноэкранное окно, поэтому вызов этого метода, когда существует существующее полноэкранное окно, приведет к возврату существующего полноэкранного окна в оконный режим.
• Окна ввода-вывода отключены. Рекомендуется вызвать 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)

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