sun.awt

Class X11GraphicsConfig [ source ]

java.lang.Object

java.awt.GraphicsConfiguration

sun.awt.X11GraphicsConfig

Direct Known Subclasses:

GLXGraphicsConfig

public class X11GraphicsConfig
extends GraphicsConfiguration

This is an implementation of a GraphicsConfiguration object for a single X11 visual.

See Also:

GraphicsEnvironment, GraphicsDevice

Field Summary

Fields

Modifier and Type	Field and Description
(package private) long	aData
protected int	bitsPerPixel
(package private) int	colormap
(package private) ColorModel	colorModel
(package private) int	depth
(package private) boolean	doubleBuffer
protected X11GraphicsDevice	screen
RenderLoops	solidloops
protected SurfaceType	surfaceType
protected int	visual

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	X11GraphicsConfig(X11GraphicsDevice device, int visualnum, int depth, int colormap, boolean doubleBuffer)

Method Summary

Methods

Modifier and Type	Method and Description
Image	createAcceleratedImage(Component target, int width, int height) Creates a new hidden-acceleration image of the given width and height that is associated with the target Component.
long	createBackBuffer(X11ComponentPeer peer, int numBuffers, BufferCapabilities caps) Attempts to create an XDBE-based backbuffer for the given peer.
VolatileImage	createBackBufferImage(Component target, long backBuffer) Creates a VolatileImage that essentially wraps the target Component's backbuffer, using the provided backbuffer handle.
BufferedImage	createCompatibleImage(int width, int height) Returns a BufferedImage with channel layout and color model compatible with this graphics configuration.
SurfaceData	createSurfaceData(X11ComponentPeer peer) Creates a new SurfaceData that will be associated with the given X11ComponentPeer.
void	destroyBackBuffer(long backBuffer) Destroys the backbuffer object represented by the given handle value.
void	flip(X11ComponentPeer peer, Component target, VolatileImage xBackBuffer, int x1, int y1, int x2, int y2, BufferCapabilities.FlipContents flipAction) Performs the native XDBE flip operation for the given target Component.
long	getAData()
int	getBitsPerPixel() Returns a number of bits allocated per pixel (might be different from depth)
Rectangle	getBounds() Returns the bounds of the GraphicsConfiguration in the device coordinates.
BufferCapabilities	getBufferCapabilities() Returns the buffering capabilities of this GraphicsConfiguration.
int	getColormap() Returns the colormap associated with this configuration.
ColorModel	getColorModel() Returns the color model associated with this configuration.
ColorModel	getColorModel(int transparency) Returns the color model associated with this configuration that supports the specified transparency.
static X11GraphicsConfig	getConfig(X11GraphicsDevice device, int visualnum, int depth, int colormap, boolean doubleBuffer)
static X11GraphicsConfig	getConfig(X11GraphicsDevice device, int visualnum, int depth, int colormap, int type)
AffineTransform	getDefaultTransform() Returns the default Transform for this configuration.
int	getDepth() Returns the depth associated with this configuration.
GraphicsDevice	getDevice() Return the graphics device associated with this configuration.
ImageCapabilities	getImageCapabilities() Returns the image capabilities of this GraphicsConfiguration.
AffineTransform	getNormalizingTransform() Returns a Transform that can be composed with the default Transform of a Graphics2D so that 72 units in user space will equal 1 inch in device space.
RenderLoops	getSolidLoops(SurfaceType stype) Return the RenderLoops this type of destination uses for solid fills and strokes.
SurfaceType	getSurfaceType()
int	getVisual() Returns the visual id associated with this configuration.
boolean	isDoubleBuffered()
Rectangle	pGetBounds(int screenNum)
String	toString() Returns a string representation of the object.

Methods inherited from class java.awt.GraphicsConfiguration

createCompatibleImage, createCompatibleVolatileImage, createCompatibleVolatileImage, createCompatibleVolatileImage, createCompatibleVolatileImage

Methods inherited from class java.lang.Object

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

Field Detail

screen

protected X11GraphicsDevice screen

visual

protected int visual

depth

int depth

colormap

int colormap

colorModel

ColorModel colorModel

aData

long aData

doubleBuffer

boolean doubleBuffer

bitsPerPixel

protected int bitsPerPixel

surfaceType

protected SurfaceType surfaceType

solidloops

public RenderLoops solidloops

Constructor Detail

X11GraphicsConfig

protected X11GraphicsConfig(X11GraphicsDevice device,
                 int visualnum,
                 int depth,
                 int colormap,
                 boolean doubleBuffer)

Method Detail

getConfig

public static X11GraphicsConfig getConfig(X11GraphicsDevice device,
                          int visualnum,
                          int depth,
                          int colormap,
                          boolean doubleBuffer)

getConfig

public static X11GraphicsConfig getConfig(X11GraphicsDevice device,
                          int visualnum,
                          int depth,
                          int colormap,
                          int type)

getDevice

public GraphicsDevice getDevice()

Return the graphics device associated with this configuration.

Specified by:

getDevice in class GraphicsConfiguration

Returns:

a GraphicsDevice object that is associated with this GraphicsConfiguration.

getVisual

public int getVisual()

Returns the visual id associated with this configuration.

getDepth

public int getDepth()

Returns the depth associated with this configuration.

getColormap

public int getColormap()

Returns the colormap associated with this configuration.

getBitsPerPixel

public int getBitsPerPixel()

Returns a number of bits allocated per pixel (might be different from depth)

getSurfaceType

public SurfaceType getSurfaceType()

getSolidLoops

public RenderLoops getSolidLoops(SurfaceType stype)

Return the RenderLoops this type of destination uses for solid fills and strokes.

createCompatibleImage

public BufferedImage createCompatibleImage(int width,
                                  int height)

Returns a BufferedImage with channel layout and color model compatible with this graphics configuration. This method has nothing to do with memory-mapping a device. This BufferedImage has a layout and color model that is closest to this native device configuration and thus can be optimally blitted to this device.

Specified by:

createCompatibleImage in class GraphicsConfiguration

Parameters:

width - the width of the returned BufferedImage

height - the height of the returned BufferedImage

Returns:

a BufferedImage whose data layout and color model is compatible with this GraphicsConfiguration.

getColorModel

public ColorModel getColorModel()

Returns the color model associated with this configuration.

Specified by:

getColorModel in class GraphicsConfiguration

Returns:

a ColorModel object that is associated with this GraphicsConfiguration.

getColorModel

public ColorModel getColorModel(int transparency)

Returns the color model associated with this configuration that supports the specified transparency.

Specified by:

getColorModel in class GraphicsConfiguration

Parameters:

transparency - the specified transparency mode

Returns:

a ColorModel object that is associated with this GraphicsConfiguration and supports the specified transparency or null if the transparency is not a valid value.

See Also:

Transparency.OPAQUE, Transparency.BITMASK, Transparency.TRANSLUCENT

getDefaultTransform

public AffineTransform getDefaultTransform()

Returns the default Transform for this configuration. This Transform is typically the Identity transform for most normal screens. Device coordinates for screen and printer devices will have the origin in the upper left-hand corner of the target region of the device, with X coordinates increasing to the right and Y coordinates increasing downwards. For image buffers, this Transform will be the Identity transform.

Specified by:

getDefaultTransform in class GraphicsConfiguration

Returns:

the default AffineTransform for this GraphicsConfiguration.

getNormalizingTransform

public AffineTransform getNormalizingTransform()

Returns a Transform that can be composed with the default Transform of a Graphics2D so that 72 units in user space will equal 1 inch in device space. Given a Graphics2D, g, one can reset the transformation to create such a mapping by using the following pseudocode:

      GraphicsConfiguration gc = g.getGraphicsConfiguration();

      g.setTransform(gc.getDefaultTransform());
      g.transform(gc.getNormalizingTransform());
 

Note that sometimes this Transform will be identity (e.g. for printers or metafile output) and that this Transform is only as accurate as the information supplied by the underlying system. For image buffers, this Transform will be the Identity transform, since there is no valid distance measurement.

Specified by:

getNormalizingTransform in class GraphicsConfiguration

Returns:

an AffineTransform to concatenate to the default AffineTransform so that 72 units in user space is mapped to 1 inch in device space.

getAData

public long getAData()

toString

public String toString()

Description copied from class: Object

Returns a string representation of the object. In general, the toString method returns a string that "textually represents" this object. The result should be a concise but informative representation that is easy for a person to read. It is recommended that all subclasses override this method.

The toString method for class Object returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@', and the unsigned hexadecimal representation of the hash code of the object. In other words, this method returns a string equal to the value of:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

Overrides:

toString in class Object

Returns:

a string representation of the object.

getBounds

public Rectangle getBounds()

Description copied from class: GraphicsConfiguration

Returns the bounds of the GraphicsConfiguration in the device coordinates. In a multi-screen environment with a virtual device, the bounds can have negative X or Y origins.

Specified by:

getBounds in class GraphicsConfiguration

Returns:

the bounds of the area covered by this GraphicsConfiguration.

pGetBounds

public Rectangle pGetBounds(int screenNum)

getBufferCapabilities

public BufferCapabilities getBufferCapabilities()

Description copied from class: GraphicsConfiguration

Returns the buffering capabilities of this GraphicsConfiguration.

Overrides:

getBufferCapabilities in class GraphicsConfiguration

Returns:

the buffering capabilities of this graphics configuration object

getImageCapabilities

public ImageCapabilities getImageCapabilities()

Description copied from class: GraphicsConfiguration

Returns the image capabilities of this GraphicsConfiguration.

Overrides:

getImageCapabilities in class GraphicsConfiguration

Returns:

the image capabilities of this graphics configuration object

isDoubleBuffered

public boolean isDoubleBuffered()

createSurfaceData

public SurfaceData createSurfaceData(X11ComponentPeer peer)

Creates a new SurfaceData that will be associated with the given X11ComponentPeer.

createAcceleratedImage

public Image createAcceleratedImage(Component target,
                           int width,
                           int height)

Creates a new hidden-acceleration image of the given width and height that is associated with the target Component.

createBackBuffer

public long createBackBuffer(X11ComponentPeer peer,
                    int numBuffers,
                    BufferCapabilities caps)
                      throws AWTException

Attempts to create an XDBE-based backbuffer for the given peer. If the requested configuration is not natively supported, an AWTException is thrown. Otherwise, if the backbuffer creation is successful, a handle to the native backbuffer is returned.

Throws:

AWTException

destroyBackBuffer

public void destroyBackBuffer(long backBuffer)

Destroys the backbuffer object represented by the given handle value.

createBackBufferImage

public VolatileImage createBackBufferImage(Component target,
                                  long backBuffer)

Creates a VolatileImage that essentially wraps the target Component's backbuffer, using the provided backbuffer handle.

flip

public void flip(X11ComponentPeer peer,
        Component target,
        VolatileImage xBackBuffer,
        int x1,
        int y1,
        int x2,
        int y2,
        BufferCapabilities.FlipContents flipAction)

Performs the native XDBE flip operation for the given target Component.