Class GraphicsConfiguration

java.lang.Object

vaadinx.awt.GraphicsConfiguration

public final class GraphicsConfiguration
extends Object

Import-swap target for GraphicsConfiguration — the browser viewport's single display configuration (D_graphics_environment). Reached the JDK way, through the environment and its default device:

GraphicsConfiguration gc = GraphicsEnvironment.getLocalGraphicsEnvironment()
        .getDefaultScreenDevice().getDefaultConfiguration();
Rectangle screen = gc.getBounds();   // (0, 0, viewportWidth, viewportHeight)

Like Toolkit this does not extend the abstract JDK class — it is the import-swap surface, not a platform configuration — so getDevice() returns the vaadinx device rather than the JDK's (R_no_vaadin_in_api limb 1). There is exactly one instance, GraphicsDevice.getDefaultConfiguration(): a browser has one viewport.

Bounds track the live viewport through BrowserToolkitInfo, so a value read before a browser resize goes stale — re-read rather than caching.

The image-creation and capability bodies are the JDK's own, which are pure raster maths and run correctly headless. Only the VolatileImage family is dropped: it needs a real accelerated surface, which a server JVM has not got.

Method Summary

Modifier and Type	Method	Description
BufferedImage	createCompatibleImage(int width, int height)
BufferedImage	createCompatibleImage(int width, int height, int transparency)
VolatileImage	createCompatibleVolatileImage(int width, int height)
VolatileImage	createCompatibleVolatileImage(int width, int height, int transparency)
VolatileImage	createCompatibleVolatileImage(int width, int height, ImageCapabilities caps)
VolatileImage	createCompatibleVolatileImage(int width, int height, ImageCapabilities caps, int transparency)
Rectangle	getBounds()	The viewport rectangle, always origin-anchored — a browser has no multi-monitor offset.
BufferCapabilities	getBufferCapabilities()
ColorModel	getColorModel()
ColorModel	getColorModel(int transparency)
AffineTransform	getDefaultTransform()
GraphicsDevice	getDevice()
ImageCapabilities	getImageCapabilities()
AffineTransform	getNormalizingTransform()	The user-space-to-72dpi transform, scaled by the browser's reported resolution — so on a HiDPI client this is a devicePixelRatio scale, not the identity.
boolean	isTranslucencyCapable()

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

getDevice

public GraphicsDevice getDevice()

getBounds

public Rectangle getBounds()

The viewport rectangle, always origin-anchored — a browser has no multi-monitor offset.

getColorModel

public ColorModel getColorModel()

getColorModel

public ColorModel getColorModel(int transparency)

Returns:

the model for transparency, or null if it is not one of Transparency's three constants — the contract createCompatibleImage(int, int, int) turns into an IllegalArgumentException

getDefaultTransform

public AffineTransform getDefaultTransform()

getNormalizingTransform

public AffineTransform getNormalizingTransform()

The user-space-to-72dpi transform, scaled by the browser's reported resolution — so on a HiDPI client this is a devicePixelRatio scale, not the identity.

createCompatibleImage

public BufferedImage createCompatibleImage(int width,
 int height)

createCompatibleImage

public BufferedImage createCompatibleImage(int width,
 int height,
 int transparency)

Throws:

IllegalArgumentException - if transparency is not a Transparency constant

createCompatibleVolatileImage

public VolatileImage createCompatibleVolatileImage(int width,
 int height)

Returns:

always null — a server JVM has no accelerated surface to back one.

createCompatibleVolatileImage

public VolatileImage createCompatibleVolatileImage(int width,
 int height,
 int transparency)

Returns:

always null — see createCompatibleVolatileImage(int, int).

createCompatibleVolatileImage

public VolatileImage createCompatibleVolatileImage(int width,
 int height,
 ImageCapabilities caps)

Returns:

always null — see createCompatibleVolatileImage(int, int).

createCompatibleVolatileImage

public VolatileImage createCompatibleVolatileImage(int width,
 int height,
 ImageCapabilities caps,
 int transparency)

Returns:

always null — see createCompatibleVolatileImage(int, int).

getImageCapabilities

public ImageCapabilities getImageCapabilities()

getBufferCapabilities

public BufferCapabilities getBufferCapabilities()

isTranslucencyCapable

public boolean isTranslucencyCapable()