Класс GraphicsDevice

Класс GraphicsDevice описывает графические устройства, которые могут быть доступны в конкретной графической среде. К ним относятся устройства экрана и принтера. Обратите внимание, что в экземпляре GraphicsEnvironment может быть много экранов и много принтеров. Каждое графическое устройство связано с одним или несколькими объектами GraphicsConfiguration. Эти объекты определяют различные конфигурации, в которых можно использовать GraphicsDevice.

В многоэкранной среде объекты GraphicsConfiguration могут использоваться для рендеринга компонентов на нескольких экранах. Следующий пример кода демонстрирует, как создать объект JFrame для каждого GraphicsConfiguration на каждом устройстве экрана в GraphicsEnvironment:

GraphicsEnvironment ge = GraphicsEnvironment.
   getLocalGraphicsEnvironment();
   GraphicsDevice[] gs = ge.getScreenDevices();
   for (int j = 0; j < gs.length; j++) {
      GraphicsDevice gd = gs[j];
      GraphicsConfiguration[] gc =
      gd.getConfigurations();
      for (int i=0; i < gc.length; i++) {
         JFrame f = new
         JFrame(gs[j].getDefaultConfiguration());
         Canvas c = new Canvas(gc[i]);
         Rectangle gcBounds = gc[i].getBounds();
         int xoffs = gcBounds.x;
         int yoffs = gcBounds.y;
         f.getContentPane().add(c);
         f.setLocation((i*50)+xoffs, (i*60)+yoffs);
         f.show();
      }
   }

Дополнительную информацию об API режима эксклюзивного полноэкранного режима см. в Руководстве по API режима эксклюзивного полноэкранного режима.

Поля

TYPE_RASTER_SCREEN

public static final int TYPE_RASTER_SCREEN

Устройство — растровый экран.

См. также:

Значения постоянных полей

TYPE_PRINTER

public static final int TYPE_PRINTER

Устройство — принтер.

См. также:

Значения постоянных полей

TYPE_IMAGE_BUFFER

public static final int TYPE_IMAGE_BUFFER

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

См. также:

Значения постоянных полей

Конструкторы

GraphicsDevice

protected GraphicsDevice()

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

См. также:

GraphicsEnvironment.getScreenDevices(), GraphicsEnvironment.getDefaultScreenDevice(), GraphicsConfiguration.getDevice()

Методы

getType

public abstract int getType()

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

Возвращает:

тип этого GraphicsDevice, который может быть TYPE_RASTER_SCREEN, TYPE_PRINTER или TYPE_IMAGE_BUFFER.

См. также:

TYPE_RASTER_SCREEN, TYPE_PRINTER, TYPE_IMAGE_BUFFER

getIDstring

public abstract String getIDstring()

Возвращает:

String, являющийся идентификатором этого GraphicsDevice.

getConfigurations

public abstract GraphicsConfiguration[] getConfigurations()

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

Возвращает:

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

getDefaultConfiguration

public abstract GraphicsConfiguration getDefaultConfiguration()

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

Возвращает:

значения по умолчанию GraphicsConfiguration этого GraphicsDevice.

getBestConfiguration

public GraphicsConfiguration getBestConfiguration(GraphicsConfigTemplate gct)

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

Параметры:

gct - объект GraphicsConfigTemplate , используемый для получения допустимой GraphicsConfiguration

Возвращает:

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

См. также:

GraphicsConfigTemplate

isFullScreenSupported

public boolean isFullScreenSupported()

Возвращает true , если это GraphicsDevice поддерживает полноэкранный эксклюзивный режим. Если установлен SecurityManager, его метод checkPermission будет вызван с AWTPermission("fullScreenExclusive"). isFullScreenSupported возвращает true только в том случае, если это разрешение предоставлено.

Возвращает:

поддерживает ли этот графический адаптер полноэкранный эксклюзивный режим

С:

1.4

См. также:

AWTPermission

setFullScreenWindow

public void setFullScreenWindow(Window w)

Параметры:

w - окно, используемое в качестве полноэкранного окна; null при возвращении в оконный режим. Некоторые платформы ожидают, что полноэкранное окно будет верхним компонентом (т.е. Frame); поэтому предпочтительнее использовать Frame вместо Window.

С:

1.4

См. также:

isFullScreenSupported(), getFullScreenWindow(), setDisplayMode(java.awt.DisplayMode), Component.enableInputMethods(boolean), Component.setVisible(boolean), Frame.setUndecorated(boolean), Dialog.setUndecorated(boolean)

getFullScreenWindow

public Window getFullScreenWindow()

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

Возвращает:

полноэкранное окно или null , если устройство не находится в полноэкранном режиме.

С:

1.4

См. также:

setFullScreenWindow(Window)

isDisplayChangeSupported

public boolean isDisplayChangeSupported()

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

Возвращает:

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

С:

1.4

См. также:

isFullScreenSupported(), setDisplayMode(java.awt.DisplayMode), setFullScreenWindow(java.awt.Window)

setDisplayMode

public void setDisplayMode(DisplayMode dm)

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);
 }

Параметры:

dm - новый режим отображения этого графического устройства.

Исключения:

IllegalArgumentException - если предоставленный DisplayMode недопустим, или не доступен в массиве, возвращаемом getDisplayModes

UnsupportedOperationException - если isDisplayChangeSupported возвращает false

С:

1.4

См. также:

getDisplayMode(), getDisplayModes(), isDisplayChangeSupported()

getDisplayMode

public DisplayMode getDisplayMode()

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

Возвращает:

текущий режим отображения этого графического устройства.

С:

1.4

См. также:

setDisplayMode(DisplayMode)

getDisplayModes

public DisplayMode[] getDisplayModes()

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

Возвращает:

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

С:

1.4

getAvailableAcceleratedMemory

public int getAvailableAcceleratedMemory()

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

Возвращает:

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

С:

1.4

См. также:

Image.flush(), ImageCapabilities.isAccelerated()

isWindowTranslucencySupported

public boolean isWindowTranslucencySupported(GraphicsDevice.WindowTranslucency translucencyKind)

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

Параметры:

translucencyKind - тип поддержки полупрозрачности

Возвращает:

поддерживается ли данный тип полупрозрачности

С:

1.7