Implements sun.awt.DisplayChangedListener.displayChanged.

Invoked when the display mode has changed. This method will invalidate and drop the internal cachedSD object.

Implements sun.awt.image.SurfaceManager.FlushableCacheData.flush.

Flush all cached resources as per the FlushableCacheData interface. 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.

Actively flushes (drops and invalidates) the cached surface so that it can be reclaimed quickly.

If the subclass is unable to validate or create a cached SurfaceData then this method will be used to get a StateTracker object that will indicate when to attempt to validate the surface again. Subclasses may return trackers which count down an ever increasing threshold to provide hysteresis on creating surfaces during low memory conditions. The default implementation just waits another "threshold" number of accesses before trying again.

Sets the valid state to false so that the next time this proxy is fetched to generate a replacement SurfaceData, the code in SurfaceData knows to replace the proxy first.

Returns true iff this SurfaceData proxy is still valid and if it has a currently cached replacement that is also valid and current.

Determine if an alternate form for the srcData is needed and appropriate from the given operational parameters.

Returns true iff this SurfaceData proxy is still the best way to control caching of the given source on the given destination.

Implements sun.awt.DisplayChangedListener.paletteChanged.

Invoked when the palette has changed.

This method attempts to replace the srcData with a cached version. It relies on the subclass to determine if the cached version will be useful given the operational parameters. This method checks any preexisting cached copy for being "up to date" and tries to update it if it is stale or non-existent and the appropriate number of accesses have occurred since it last was stale.

An outline of the process is as follows:

1. Check the operational parameters (txtype, comp, bgColor) to make sure that the operation is supported. Return the original SurfaceData if the operation cannot be accelerated.
2. Check the tracker for the source surface to see if it has remained stable since it was last cached. Update the state variables to cause both a threshold countdown and an update of the cached copy if it is not. (Setting cacheTracker to NEVER_CURRENT effectively marks it as "needing to be updated".)
3. Check the tracker for the cached copy to see if is still valid and up to date. Note that the cacheTracker may be non-current if either something happened to the cached copy (eg. surfaceLost) or if the source was out of date and the cacheTracker was set to NEVER_CURRENT to force an update. Decrement the countdown and copy the source to the cache as necessary and then update the variables to show that the cached copy is stable.

This is the default implementation for updating the cached SurfaceData from the source (primary) SurfaceData. A simple Blit is used to copy the pixels from the source to the destination SurfaceData. A subclass can override this implementation if a more complex operation is required to update its cached copies.

This is an alternate implementation for updating the cached SurfaceData from the source (primary) SurfaceData using a background color for transparent pixels. A simple BlitBg is used to copy the pixels from the source to the destination SurfaceData with the specified bgColor. A subclass can override the normal updateSurfaceData method and call this implementation instead if it wants to use color keying for bitmask images.

Construct an alternate form of the given SurfaceData. The contents of the returned SurfaceData may be undefined since the calling code will take care of updating the contents with a subsequent call to updateSurfaceData.

If the method returns null then there was a problem with allocating the accelerated surface. The getRetryTracker() method will be called to track when to attempt another revalidation.