Nested and Inner Type Summary

Modifier and Type	Class and Description
public static interface	SurfaceManager.Factory An interface for GraphicsConfiguration objects to implement if they create their own VolatileSurfaceManager implementations.
public static interface	SurfaceManager.FlushableCacheData An interface for Objects used in the SurfaceManager cache to implement if they have data that should be flushed when the Image is flushed.
public abstract static class	SurfaceManager.ImageAccessor
pack-priv class	SurfaceManager.ImageCapabilitiesGc
public static interface	SurfaceManager.ProxiedGraphicsConfig An interface for GraphicsConfiguration objects to implement if their surfaces accelerate images using SurfaceDataProxy objects.
public static class	SurfaceManager.ProxyCache

Modifier and Type	Field and Description
private static SurfaceManager.ImageAccessor	imgaccessor
private final Map<SurfaceManager.ProxyCache, WeakReference<SurfaceDataProxy>>	weakCache This map holds references to SurfaceDataProxy per given ProxyCache.

Constructor Summary

Access	Constructor and Description
public	SurfaceManager()

Method Summary

Modifier and Type	Method and Description
public void	acceleratedSurfaceLost() Notification that any accelerated surfaces associated with this manager have been "lost", which might mean that they need to be manually restored or recreated.
public synchronized void	flush() Releases system resources in use by ancillary SurfaceData objects, such as surfaces cached in accelerated memory.
pack-priv void	flush(boolean deaccelerate)
public ImageCapabilities	getCapabilities(GraphicsConfiguration gc) Returns an ImageCapabilities object which can be inquired as to the specific capabilities of this Image.
public static double	getImageScaleX(final Image img) Returns a horizontal scale factor of the image.
public static double	getImageScaleY(final Image img) Returns a vertical scale factor of the image.
public static SurfaceManager	getManager(Image img) Returns the SurfaceManager object contained within the given Image.
public abstract SurfaceData	getPrimarySurfaceData() Returns the main SurfaceData object that "owns" the pixels for this SurfaceManager.
public abstract SurfaceData	restoreContents() Restores the primary surface being managed, and then returns the replacement surface.
public void	setAccelerationPriority(float priority) Called when image's acceleration priority is changed.
public static void	setImageAccessor(SurfaceManager.ImageAccessor ia)
public static void	setManager(Image img, SurfaceManager mgr)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

imgaccessor	back to summary
private static SurfaceManager.ImageAccessor imgaccessor

weakCache	back to summary
private final Map<SurfaceManager.ProxyCache, WeakReference<SurfaceDataProxy>> weakCache This map holds references to SurfaceDataProxy per given ProxyCache. Unlike ProxyCache, which contains SurfaceDataProxy objects per given SurfaceManager, this map does not prevent contained proxies from being garbage collected. Therefore, ProxyCache can be considered an "owning" container for the SurfaceDataProxy objects, and this map is just a weak mapping for the bookkeeping purposes.

weakCache

back to summary

private final Map<SurfaceManager.ProxyCache, WeakReference<SurfaceDataProxy>> weakCache

This map holds references to SurfaceDataProxy per given ProxyCache. Unlike ProxyCache, which contains SurfaceDataProxy objects per given SurfaceManager, this map does not prevent contained proxies from being garbage collected. Therefore, ProxyCache can be considered an "owning" container for the SurfaceDataProxy objects, and this map is just a weak mapping for the bookkeeping purposes.

Constructor Detail

SurfaceManager	back to summary
public SurfaceManager()

Method Detail

acceleratedSurfaceLost	back to summary
public void acceleratedSurfaceLost() Notification that any accelerated surfaces associated with this manager have been "lost", which might mean that they need to be manually restored or recreated. The default implementation does nothing, but platform-specific variants which have accelerated surfaces should perform any necessary actions.

flush	back to summary
public synchronized void flush() Releases system resources in use by ancillary SurfaceData objects, such as surfaces cached in accelerated memory. Subclasses should override to release any of their flushable data. The default implementation will visit all of the value objects in the cacheMap and flush them if they implement the FlushableCacheData interface.

flush

back to summary

public synchronized void flush()

Releases system resources in use by ancillary SurfaceData objects, such as surfaces cached in accelerated memory. Subclasses should override to release any of their flushable data.

The default implementation will visit all of the value objects in the cacheMap and flush them if they implement the FlushableCacheData interface.

flush	back to summary
pack-priv void flush(boolean deaccelerate)

getCapabilities back to summary

getCapabilities	back to summary
public ImageCapabilities getCapabilities(GraphicsConfiguration gc) Returns an ImageCapabilities object which can be inquired as to the specific capabilities of this Image. The capabilities object will return true for isAccelerated() if the image has a current and valid SurfaceDataProxy object cached for the specified GraphicsConfiguration parameter. This class provides a default implementation of the ImageCapabilities that will try to determine if there is an associated SurfaceDataProxy object and if it is up to date, but only works for GraphicsConfiguration objects which implement the ProxiedGraphicsConfig interface defined below. In practice, all configs which can be accelerated are currently implementing that interface. A null GraphicsConfiguration returns a value based on whether the image is currently accelerated on its default GraphicsConfiguration. Since 1.5 See Also `java.awt.Image#getCapabilities`

public ImageCapabilities getCapabilities(GraphicsConfiguration gc)

Returns an ImageCapabilities object which can be inquired as to the specific capabilities of this Image. The capabilities object will return true for isAccelerated() if the image has a current and valid SurfaceDataProxy object cached for the specified GraphicsConfiguration parameter.

This class provides a default implementation of the ImageCapabilities that will try to determine if there is an associated SurfaceDataProxy object and if it is up to date, but only works for GraphicsConfiguration objects which implement the ProxiedGraphicsConfig interface defined below. In practice, all configs which can be accelerated are currently implementing that interface.

A null GraphicsConfiguration returns a value based on whether the image is currently accelerated on its default GraphicsConfiguration.

Since: 1.5
See Also: java.awt.Image#getCapabilities

getImageScaleX back to summary

getImageScaleX	back to summary
public static double getImageScaleX(final Image img) Returns a horizontal scale factor of the image. This is utility method, which fetches information from the SurfaceData of the image. See Also `SurfaceData#getDefaultScaleX`

public static double getImageScaleX(final Image img)

Returns a horizontal scale factor of the image. This is utility method, which fetches information from the SurfaceData of the image.

See Also: SurfaceData#getDefaultScaleX

getImageScaleY back to summary

getImageScaleY	back to summary
public static double getImageScaleY(final Image img) Returns a vertical scale factor of the image. This is utility method, which fetches information from the SurfaceData of the image. See Also `SurfaceData#getDefaultScaleY`

public static double getImageScaleY(final Image img)

Returns a vertical scale factor of the image. This is utility method, which fetches information from the SurfaceData of the image.

See Also: SurfaceData#getDefaultScaleY

getManager	back to summary
public static SurfaceManager getManager(Image img) Returns the SurfaceManager object contained within the given Image.

getPrimarySurfaceData	back to summary
public abstract SurfaceData getPrimarySurfaceData() Returns the main SurfaceData object that "owns" the pixels for this SurfaceManager. This SurfaceData is used as the destination surface in a rendering operation and is the most authoritative storage for the current state of the pixels, though other versions might be cached in other locations for efficiency.

restoreContents	back to summary
public abstract SurfaceData restoreContents() Restores the primary surface being managed, and then returns the replacement surface. This is called when an accelerated surface has been "lost", in an attempt to auto-restore its contents.

setAccelerationPriority	back to summary
public void setAccelerationPriority(float priority) Called when image's acceleration priority is changed. The default implementation will visit all of the value objects in the cacheMap when the priority gets set to 0.0 and flush them if they implement the FlushableCacheData interface.

setAccelerationPriority

back to summary

public void setAccelerationPriority(float priority)

Called when image's acceleration priority is changed.

The default implementation will visit all of the value objects in the cacheMap when the priority gets set to 0.0 and flush them if they implement the FlushableCacheData interface.

setImageAccessor	back to summary
public static void setImageAccessor(SurfaceManager.ImageAccessor ia)

setManager	back to summary
public static void setManager(Image img, SurfaceManager mgr)

sun.awt.image back to summary

public Interface SurfaceManager.Factory

Known Direct Subinterfaces: sun.java2d.opengl.OGLGraphicsConfig
Known Direct Implementers: sun.awt.X11GraphicsConfig

An interface for GraphicsConfiguration objects to implement if they create their own VolatileSurfaceManager implementations.

Method Summary

Modifier and Type	Method and Description
public VolatileSurfaceManager	createVolatileManager(SunVolatileImage image, Object context) Creates a new instance of a VolatileSurfaceManager given a compatible SunVolatileImage.

Method Detail

createVolatileManager	back to summary
public VolatileSurfaceManager createVolatileManager(SunVolatileImage image, Object context) Creates a new instance of a VolatileSurfaceManager given a compatible SunVolatileImage. An optional context Object can be supplied as a way for the caller to pass pipeline-specific context data to the VolatileSurfaceManager (such as a backbuffer handle, for example).

sun.awt.image back to summary

public Interface SurfaceManager.FlushableCacheData

Known Direct Implementers: sun.java2d.SurfaceDataProxy

An interface for Objects used in the SurfaceManager cache to implement if they have data that should be flushed when the Image is flushed.

Method Summary

Modifier and Type	Method and Description
public boolean	flush(boolean deaccelerated) Flush all cached resources.

Method Detail

flush	back to summary
public boolean flush(boolean deaccelerated) Flush all cached resources. The deaccelerated parameter indicates if the flush is happening because the associated surface is no longer being accelerated (for instance the acceleration priority is set below the threshold needed for acceleration). Returns a boolean that indicates if the cached object is no longer needed and should be removed from the cache.

flush

back to summary

public boolean flush(boolean deaccelerated)

Flush all cached resources. The deaccelerated parameter indicates if the flush is happening because the associated surface is no longer being accelerated (for instance the acceleration priority is set below the threshold needed for acceleration). Returns a boolean that indicates if the cached object is no longer needed and should be removed from the cache.

sun.awt.image back to summary

public abstract Class SurfaceManager.ImageAccessor

Class Inheritance

extends Object

java.lang.Object
sun.awt.image.SurfaceManager.ImageAccessor

Constructor Summary

Access	Constructor and Description
public	ImageAccessor()

Method Summary

Modifier and Type	Method and Description
public abstract SurfaceManager	getSurfaceManager(Image img)
public abstract void	setSurfaceManager(Image img, SurfaceManager mgr)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Constructor Detail

ImageAccessor	back to summary
public ImageAccessor()

Method Detail

getSurfaceManager	back to summary
public abstract SurfaceManager getSurfaceManager(Image img)

setSurfaceManager	back to summary
public abstract void setSurfaceManager(Image img, SurfaceManager mgr)

sun.awt.image back to summary

pack-priv Class SurfaceManager.ImageCapabilitiesGc

Class Inheritance

extends ImageCapabilities

java.lang.Object
java.awt.ImageCapabilities
sun.awt.image.SurfaceManager.ImageCapabilitiesGc

Field Summary

Modifier and Type	Field and Description
pack-priv GraphicsConfiguration	gc

Constructor Summary

Access	Constructor and Description
public	ImageCapabilitiesGc(GraphicsConfiguration gc)

Method Summary

Modifier and Type	Method and Description
public boolean	isAccelerated() Overrides java.awt.ImageCapabilities.isAccelerated. Returns `true` if the object whose capabilities are encapsulated in this `ImageCapabilities` can be or is accelerated.

Inherited from java.awt.ImageCapabilities:: clone isTrueVolatile

Field Detail

gc	back to summary
pack-priv GraphicsConfiguration gc

Constructor Detail

ImageCapabilitiesGc	back to summary
public ImageCapabilitiesGc(GraphicsConfiguration gc)

Method Detail

isAccelerated back to summary

isAccelerated	back to summary
public boolean isAccelerated() Overrides java.awt.ImageCapabilities.isAccelerated. Doc from java.awt.ImageCapabilities.isAccelerated. Returns `true` if the object whose capabilities are encapsulated in this `ImageCapabilities` can be or is accelerated.

public boolean isAccelerated()

Overrides java.awt.ImageCapabilities.isAccelerated.

Doc from java.awt.ImageCapabilities.isAccelerated.

Returns true if the object whose capabilities are encapsulated in this ImageCapabilities can be or is accelerated.

sun.awt.image back to summary

public Interface SurfaceManager.ProxiedGraphicsConfig

Known Direct Subinterfaces: sun.java2d.opengl.OGLGraphicsConfig
Known Direct Implementers: sun.java2d.xr.XRGraphicsConfig, sun.awt.X11GraphicsConfig

An interface for GraphicsConfiguration objects to implement if their surfaces accelerate images using SurfaceDataProxy objects. Implementing this interface facilitates the default implementation of getImageCapabilities() above.

Method Summary

Modifier and Type	Method and Description
public SurfaceManager.ProxyCache	getSurfaceDataProxyCache() Return the cache that destination surfaces created on the given GraphicsConfiguration use to store SurfaceDataProxy objects for their cached copies.

Method Detail

getSurfaceDataProxyCache	back to summary
public SurfaceManager.ProxyCache getSurfaceDataProxyCache() Return the cache that destination surfaces created on the given GraphicsConfiguration use to store SurfaceDataProxy objects for their cached copies.

sun.awt.image back to summary

public Class SurfaceManager.ProxyCache

Class Inheritance

extends Object

java.lang.Object
sun.awt.image.SurfaceManager.ProxyCache

Field Summary

Modifier and Type	Field and Description
private final Map<SurfaceManager, SurfaceDataProxy>	map

Constructor Summary

Access	Constructor and Description
public	ProxyCache()

Method Summary

Modifier and Type	Method and Description
public SurfaceDataProxy	get(SurfaceManager manager) Return a cached SurfaceDataProxy object for a given SurfaceManager.
public void	put(SurfaceManager manager, SurfaceDataProxy proxy) Store a cached SurfaceDataProxy object for a given SurfaceManager.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

map	back to summary
private final Map<SurfaceManager, SurfaceDataProxy> map

Constructor Detail

ProxyCache	back to summary
public ProxyCache()

Method Detail

get	back to summary
public SurfaceDataProxy get(SurfaceManager manager) Return a cached SurfaceDataProxy object for a given SurfaceManager. Note that the cache is maintained as a simple Map with no attempts to keep it up to date or invalidate it so any data stored here must either not be dependent on the state of the image or it must be individually tracked to see if it is outdated or obsolete. The SurfaceData object of the primary (destination) surface has a StateTracker mechanism which can help track the validity and "currentness" of any data stored here. For convenience and expediency an object stored as cached data may implement the FlushableCacheData interface specified below so that it may be notified immediately if the flush() method is ever called.

get

back to summary

public SurfaceDataProxy get(SurfaceManager manager)

Return a cached SurfaceDataProxy object for a given SurfaceManager.

Note that the cache is maintained as a simple Map with no attempts to keep it up to date or invalidate it so any data stored here must either not be dependent on the state of the image or it must be individually tracked to see if it is outdated or obsolete.

The SurfaceData object of the primary (destination) surface has a StateTracker mechanism which can help track the validity and "currentness" of any data stored here. For convenience and expediency an object stored as cached data may implement the FlushableCacheData interface specified below so that it may be notified immediately if the flush() method is ever called.

put	back to summary
public void put(SurfaceManager manager, SurfaceDataProxy proxy) Store a cached SurfaceDataProxy object for a given SurfaceManager. See the get() method for notes on tracking the validity of data stored using this mechanism.