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

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