public class

NullSurfaceData

extends SurfaceData

java.lang.Object
↳	sun.java2d.SurfaceData
	↳	sun.java2d.NullSurfaceData

Class Overview

This class provides an empty implementation of the SurfaceData abstract superclass. All operations on it translate into NOP or harmless operations.

Summary

[Expand]

Inherited Constants

From interface java.awt.Transparency

Fields
public static final SurfaceData	theInstance

[Expand]

Inherited Fields

From class sun.java2d.SurfaceData

Public Methods
boolean	copyArea(SunGraphics2D sg2d, int x, int y, int w, int h, int dx, int dy) Performs a copyarea within this surface.
Rectangle	getBounds() Returns the bounds of the destination surface.
Object	getDestination() Returns destination Image associated with this SurfaceData (null)
GraphicsConfiguration	getDeviceConfiguration() Return the GraphicsConfiguration object that describes this destination surface.
Raster	getRaster(int x, int y, int w, int h) Return a readable Raster which contains the pixels for the specified rectangular region of the destination surface.
SurfaceData	getReplacement() Return a new SurfaceData object that represents the current state of the destination that this SurfaceData object describes.
void	invalidate() Sets this SurfaceData object to the invalid state.
int	pixelFor(int rgb) Returns the pixel data for the specified Argb value packed into an integer for easy storage and conveyance.
int	rgbFor(int pixel) Returns the Argb representation for the specified integer value which is packed in the format of the associated ColorModel.
boolean	useTightBBoxes() Does the pixel accessibility of the destination surface suggest that rendering algorithms might want to take extra time to calculate a more accurate bounding box for the operation being performed? The typical case when this will be true is when a copy of the pixels has to be made when doing a getRaster.
void	validatePipe(SunGraphics2D sg2d)

Protected Methods
void	checkCustomComposite() Performs Security Permissions checks to see if a Custom Composite object should be allowed access to the pixels of this surface.

[Expand]

Inherited Methods

From class sun.java2d.SurfaceData

boolean	canRenderLCDText(SunGraphics2D sg2d)
void	checkCustomComposite() Performs Security Permissions checks to see if a Custom Composite object should be allowed access to the pixels of this surface.
boolean	copyArea(SunGraphics2D sg2d, int x, int y, int w, int h, int dx, int dy) Performs a copyarea within this surface.
void	flush() Synchronously releases resources associated with this surface.
abstract Rectangle	getBounds() Returns the bounds of the destination surface.
final ColorModel	getColorModel() Return the ColorModel for the destination surface.
abstract Object	getDestination() Returns destination associated with this SurfaceData.
abstract GraphicsConfiguration	getDeviceConfiguration() Return the GraphicsConfiguration object that describes this destination surface.
Object	getDisposerReferent() Returns an object which will be used as the referent in the ReferenceQueue
MaskFill	getMaskFill(SunGraphics2D sg2d) Returns a MaskFill object that can be used on this destination with the source (paint) and composite types determined by the given SunGraphics2D, or null if no such MaskFill object can be located.
long	getNativeOps()
static SurfaceData	getPrimarySurfaceData(Image img) Extracts the SurfaceManager from the given Image, and then returns the SurfaceData object that would best be suited as the destination surface in some rendering operation.
abstract Raster	getRaster(int x, int y, int w, int h) Return a readable Raster which contains the pixels for the specified rectangular region of the destination surface.
RenderLoops	getRenderLoops(SunGraphics2D sg2d) Return a RenderLoops object containing all of the basic GraphicsPrimitive objects for rendering to the destination surface with the current attributes of the given SunGraphics2D.
abstract SurfaceData	getReplacement() Certain changes in the configuration of a surface require the invalidation of existing associated SurfaceData objects and the creation of brand new ones.
SurfaceData	getSourceSurfaceData(Image img, int txtype, CompositeType comp, Color bgColor) This method is called on a destination SurfaceData to choose the best SurfaceData from a source Image for an imaging operation, with help from its SurfaceManager.
StateTrackable.State	getState() Returns the general state of the complex data held by this object.
StateTracker	getStateTracker() Returns an object which can track future changes to the complex data stored in this object.
final SurfaceType	getSurfaceType() Return the SurfaceType object that describes the destination surface.
int	getTransparency() Returns the type of this `Transparency`.
void	invalidate() Sets this SurfaceData object to the invalid state.
static boolean	isNull(SurfaceData sd) For our purposes null and NullSurfaceData are the same as they represent a disposed surface.
static boolean	isOpaqueGray(IndexColorModel icm) Fetches private field IndexColorModel.allgrayopaque which is true when all palette entries in the color model are gray and opaque.
boolean	isSurfaceLost()
final boolean	isValid() Returns a boolean indicating whether or not this SurfaceData is valid.
SurfaceDataProxy	makeProxyFor(SurfaceData srcData) This method is called on a destination SurfaceData to choose a proper SurfaceDataProxy subclass for a source SurfaceData to use to control when and with what surface to override a given image operation.
static RenderLoops	makeRenderLoops(SurfaceType src, CompositeType comp, SurfaceType dst) Construct and return a RenderLoops object containing all of the basic GraphicsPrimitive objects for rendering to the destination surface with the given source, destination, and composite types.
final void	markDirty() Marks this surface as dirty.
int	pixelFor(int rgb) Returns the pixel data for the specified Argb value packed into an integer for easy storage and conveyance.
int	pixelFor(Color c) Returns the pixel data for the specified color packed into an integer for easy storage and conveyance.
static SurfaceData	restoreContents(Image img) Restores the contents of the given Image and then returns the new SurfaceData object in use by the Image's SurfaceManager.
int	rgbFor(int pixel) Returns the Argb representation for the specified integer value which is packed in the format of the associated ColorModel.
void	setBlitProxyKey(Object key) Subclasses can set a "blit proxy key" which will be used along with the SurfaceManager.getCacheData() mechanism to store acceleration-compatible cached copies of source images.
void	setSurfaceLost(boolean lost) Sets the value of the surfaceLost variable, which indicates whether something has happened to the rendering surface such that it needs to be restored and re-rendered.
boolean	useTightBBoxes() Does the pixel accessibility of the destination surface suggest that rendering algorithms might want to take extra time to calculate a more accurate bounding box for the operation being performed? The typical case when this will be true is when a copy of the pixels has to be made when doing a getRaster.
void	validatePipe(SunGraphics2D sg2d)

From class java.lang.Object

Object	clone() Creates and returns a copy of this object.
boolean	equals(Object obj) Indicates whether some other object is "equal to" this one.
void	finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
final Class<?>	getClass() Returns the runtime class of this `Object`.
int	hashCode() Returns a hash code value for the object.
final void	notify() Wakes up a single thread that is waiting on this object's monitor.
final void	notifyAll() Wakes up all threads that are waiting on this object's monitor.
String	toString() Returns a string representation of the object.
final void	wait() Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.
final void	wait(long timeout, int nanos) Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
final void	wait(long timeout) Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.

From interface java.awt.Transparency

From interface sun.java2d.DisposerTarget

From interface sun.java2d.StateTrackable

Fields

public static final SurfaceData theInstance

Public Methods

public boolean copyArea (SunGraphics2D sg2d, int x, int y, int w, int h, int dx, int dy)

Performs a copyarea within this surface. Returns false if there is no algorithm to perform the copyarea given the current settings of the SunGraphics2D.

public Rectangle getBounds ()

Returns the bounds of the destination surface.

public Object getDestination ()

Returns destination Image associated with this SurfaceData (null)

public GraphicsConfiguration getDeviceConfiguration ()

Return the GraphicsConfiguration object that describes this destination surface.

public Raster getRaster (int x, int y, int w, int h)

Return a readable Raster which contains the pixels for the specified rectangular region of the destination surface. The coordinate origin of the returned Raster is the same as the device space origin of the destination surface. In some cases the returned Raster might also be writeable. In most cases, the returned Raster might contain more pixels than requested.

public SurfaceData getReplacement ()

Return a new SurfaceData object that represents the current state of the destination that this SurfaceData object describes. This method is typically called when the SurfaceData is invalidated.

public void invalidate ()

Sets this SurfaceData object to the invalid state. All Graphics objects must get a new SurfaceData object via the refresh method and revalidate their pipelines before continuing.

public int pixelFor (int rgb)

Returns the pixel data for the specified Argb value packed into an integer for easy storage and conveyance.

public int rgbFor (int pixel)

Returns the Argb representation for the specified integer value which is packed in the format of the associated ColorModel.

public boolean useTightBBoxes ()

Does the pixel accessibility of the destination surface suggest that rendering algorithms might want to take extra time to calculate a more accurate bounding box for the operation being performed? The typical case when this will be true is when a copy of the pixels has to be made when doing a getRaster. The fewer pixels copied, the faster the operation will go.

public void validatePipe (SunGraphics2D sg2d)

Protected Methods

protected void checkCustomComposite ()

Performs Security Permissions checks to see if a Custom Composite object should be allowed access to the pixels of this surface.

Interfaces

Classes

Enums

Exceptions

NullSurfaceData

Class Overview

Summary

Fields

public static final SurfaceData theInstance

Public Methods

public boolean copyArea (SunGraphics2D sg2d, int x, int y, int w, int h, int dx, int dy)

public Rectangle getBounds ()

public Object getDestination ()

public GraphicsConfiguration getDeviceConfiguration ()

public Raster getRaster (int x, int y, int w, int h)

See Also

public SurfaceData getReplacement ()

public void invalidate ()

public int pixelFor (int rgb)

public int rgbFor (int pixel)

public boolean useTightBBoxes ()

See Also

public void validatePipe (SunGraphics2D sg2d)

Protected Methods

protected void checkCustomComposite ()