public final Class X11GraphicsDevice

Add a DisplayChangeListener to be notified when the display settings are changed. Typically, only top-level containers need to be added to X11GraphicsDevice.

Implements sun.awt.DisplayChangedListener.displayChanged.

From the DisplayChangedListener interface; called from X11GraphicsEnvironment when the display mode has been changed.

Annotations

@Override

Implements abstract java.awt.GraphicsDevice.getConfigurations.

Returns all of the graphics configurations associated with this graphics device.

Returns:GraphicsConfiguration[]

Doc from java.awt.GraphicsDevice.getConfigurations.

an array of GraphicsConfiguration objects that are associated with this GraphicsDevice.

Annotations

@Override

Implements abstract java.awt.GraphicsDevice.getDefaultConfiguration.

Returns the default graphics configuration associated with this graphics device.

Returns:GraphicsConfiguration

Doc from java.awt.GraphicsDevice.getDefaultConfiguration.

the default GraphicsConfiguration of this GraphicsDevice.

Annotations

@Override

Returns the X11 Display of this device. This method is also in MDrawingSurfaceInfo but need it here to be able to allow a GraphicsConfigTemplate to get the Display.

Overrides java.awt.GraphicsDevice.getDisplayMode.

Doc from java.awt.GraphicsDevice.getDisplayMode.

Returns the current display mode of this GraphicsDevice. The returned display mode is allowed to have a refresh rate DisplayMode#REFRESH_RATE_UNKNOWN if it is indeterminate. Likewise, the returned display mode is allowed to have a bit depth DisplayMode#BIT_DEPTH_MULTI if it is indeterminate or if multiple bit depths are supported.

Returns:DisplayMode

the current display mode of this graphics device.

Annotations

@Override

Overrides java.awt.GraphicsDevice.getDisplayModes.

Doc from java.awt.GraphicsDevice.getDisplayModes.

Returns all display modes available for this GraphicsDevice. The returned display modes are allowed to have a refresh rate DisplayMode#REFRESH_RATE_UNKNOWN if it is indeterminate. Likewise, the returned display modes are allowed to have a bit depth DisplayMode#BIT_DEPTH_MULTI if it is indeterminate or if multiple bit depths are supported.

Returns:DisplayMode[]

all of the display modes available for this graphics device.

Annotations

@Override

Implements abstract java.awt.GraphicsDevice.getIDstring.

Returns the identification string associated with this graphics device.

Returns:String

Doc from java.awt.GraphicsDevice.getIDstring.

a String that is the identification of this GraphicsDevice.

Annotations

@Override

Returns the X11 screen of the device.

Implements abstract java.awt.GraphicsDevice.getType.

Returns the type of the graphics device.

Returns:int

Doc from java.awt.GraphicsDevice.getType.

the type of this GraphicsDevice, which can either be TYPE_RASTER_SCREEN, TYPE_PRINTER or TYPE_IMAGE_BUFFER.

Annotations

@Override

See Also

TYPE_RASTER_SCREEN, TYPE_PRINTER, TYPE_IMAGE_BUFFER

Overrides java.awt.GraphicsDevice.isDisplayChangeSupported.

Doc from java.awt.GraphicsDevice.isDisplayChangeSupported.

Returns true if this GraphicsDevice supports low-level display changes. On some platforms low-level display changes may only be allowed in full-screen exclusive mode (i.e., if isFullScreenSupported() returns true and the application has already entered full-screen mode using setFullScreenWindow).

Returns:boolean

whether low-level display changes are supported for this graphics device.

Annotations

@Override

Overrides java.awt.GraphicsDevice.isFullScreenSupported.

Doc from java.awt.GraphicsDevice.isFullScreenSupported.

Returns true if this GraphicsDevice supports full-screen exclusive mode. If a SecurityManager is installed, its checkPermission method will be called with AWTPermission("fullScreenExclusive"). isFullScreenSupported returns true only if that permission is granted.

Returns:boolean

whether full-screen exclusive mode is available for this graphics device

Annotations

@Override

Implements sun.awt.DisplayChangedListener.paletteChanged.

From the DisplayChangedListener interface; devices do not need to react to this event.

Annotations

@Override

Remove a DisplayChangeListener from this X11GraphicsDevice.

Overrides java.awt.GraphicsDevice.setDisplayMode.

Doc from java.awt.GraphicsDevice.setDisplayMode.

Sets the display mode of this graphics device. This is only allowed if isDisplayChangeSupported() returns true and may require first entering full-screen exclusive mode using setFullScreenWindow providing that full-screen exclusive mode is supported (i.e., isFullScreenSupported() returns true).

The display mode must be one of the display modes returned by getDisplayModes(), with one exception: passing a display mode with DisplayMode#REFRESH_RATE_UNKNOWN refresh rate will result in selecting a display mode from the list of available display modes with matching width, height and bit depth. However, passing a display mode with DisplayMode#BIT_DEPTH_MULTI for bit depth is only allowed if such mode exists in the list returned by getDisplayModes().

Example code:

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

Parameters

dm:DisplayMode

The new display mode of this graphics device.

Annotations

@SuppressWarnings:removal

@Override

Overrides java.awt.GraphicsDevice.setFullScreenWindow.

Doc from java.awt.GraphicsDevice.setFullScreenWindow.

Enter full-screen mode, or return to windowed mode. The entered full-screen mode may be either exclusive or simulated. Exclusive mode is only available if isFullScreenSupported returns true.

Exclusive mode implies:

• Windows cannot overlap the full-screen window. All other application windows will always appear beneath the full-screen window in the Z-order.
• There can be only one full-screen window on a device at any time, so calling this method while there is an existing full-screen Window will cause the existing full-screen window to return to windowed mode.
• Input method windows are disabled. It is advisable to call Component.enableInputMethods(false) to make a component a non-client of the input method framework.

The simulated full-screen mode places and resizes the window to the maximum possible visible area of the screen. However, the native windowing system may modify the requested geometry-related data, so that the Window object is placed and sized in a way that corresponds closely to the desktop settings.

When entering full-screen mode, if the window to be used as a full-screen window is not visible, this method will make it visible. It will remain visible when returning to windowed mode.

When entering full-screen mode, all the translucency effects are reset for the window. Its shape is set to null, the opacity value is set to 1.0f, and the background color alpha is set to 255 (completely opaque). These values are not restored when returning to windowed mode.

It is unspecified and platform-dependent how decorated windows operate in full-screen mode. For this reason, it is recommended to turn off the decorations in a Frame or Dialog object by using the setUndecorated method.

When returning to windowed mode from an exclusive full-screen window, any display changes made by calling setDisplayMode are automatically restored to their original state.

Parameters

w:Window

a window to use as the full-screen window; null if returning to windowed mode. Some platforms expect the fullscreen window to be a top-level component (i.e., a Frame); therefore it is preferable to use a Frame here rather than a Window.

Annotations

@Override

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object.

Returns:String

a string representation of the object