|
Préférences
Moteurs de recherche
|
|||||||||||||||||||||||||||||||||||||||||||||
JavaTM 2 Platform Std. Ed. v1.6.0
java.awt.image
|
Field Summary | |
---|---|
static int |
IMAGE_INCOMPATIBLE
Validated image is incompatible with supplied GraphicsConfiguration object and should be
re-created as appropriate. |
static int |
IMAGE_OK
Validated image is ready to use as-is. |
static int |
IMAGE_RESTORED
Validated image has been restored and is now ready to use. |
protected int |
transparency
The transparency value with which this image was created. |
Fields inherited from class java.awt.Image |
---|
accelerationPriority, SCALE_AREA_AVERAGING, SCALE_DEFAULT, SCALE_FAST, SCALE_REPLICATE, SCALE_SMOOTH, UndefinedProperty |
Fields inherited from interface java.awt.Transparency |
---|
BITMASK, OPAQUE, TRANSLUCENT |
Constructor Summary | |
---|---|
VolatileImage()
|
Method Summary | |
---|---|
abstract boolean |
contentsLost()
Returns true if rendering data was lost since last
validate call. |
abstract Graphics2D |
createGraphics()
Creates a Graphics2D , which can be used to draw into
this VolatileImage . |
abstract ImageCapabilities |
getCapabilities()
Returns an ImageCapabilities object which can be inquired as to the specific capabilities of this VolatileImage. |
Graphics |
getGraphics()
This method returns a Graphics2D , but is here
for backwards compatibility. |
abstract int |
getHeight()
Returns the height of the VolatileImage . |
abstract BufferedImage |
getSnapshot()
Returns a static snapshot image of this object. |
ImageProducer |
getSource()
This returns an ImageProducer for this VolatileImage. |
int |
getTransparency()
Returns the transparency. |
abstract int |
getWidth()
Returns the width of the VolatileImage . |
abstract int |
validate(GraphicsConfiguration gc)
Attempts to restore the drawing surface of the image if the surface had been lost since the last validate call. |
Methods inherited from class java.awt.Image |
---|
flush, getAccelerationPriority, getCapabilities, getHeight, getProperty, getScaledInstance, getWidth, setAccelerationPriority |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final int IMAGE_OK
public static final int IMAGE_RESTORED
public static final int IMAGE_INCOMPATIBLE
GraphicsConfiguration
object and should be
re-created as appropriate. Usage of the image as-is
after receiving this return code from validate
is undefined.
protected int transparency
Constructor Detail |
---|
public VolatileImage()
Method Detail |
---|
public abstract BufferedImage getSnapshot()
BufferedImage
returned is only current with
the VolatileImage
at the time of the request
and will not be updated with any future changes to the
VolatileImage
.
BufferedImage
representation of this
VolatileImage
BufferedImage
public abstract int getWidth()
VolatileImage
.
VolatileImage
.public abstract int getHeight()
VolatileImage
.
VolatileImage
.public ImageProducer getSource()
getSource
may not perform as fast as
operations that do not rely on reading the pixels.
Note also that the pixel values read from the image are current
with those in the image only at the time that they are
retrieved. This method takes a snapshot
of the image at the time the request is made and the
ImageProducer object returned works with
that static snapshot image, not the original VolatileImage.
Calling getSource()
is equivalent to calling getSnapshot().getSource().
ImageProducer
that can be used to produce the
pixels for a BufferedImage
representation of
this Image.ImageProducer
,
getSnapshot()
public Graphics getGraphics()
Graphics2D
, but is here
for backwards compatibility. createGraphics
is more
convenient, since it is declared to return a
Graphics2D
.
getGraphics
in class Image
Graphics2D
, which can be used to draw into
this image.Graphics
,
Component.createImage(int, int)
public abstract Graphics2D createGraphics()
Graphics2D
, which can be used to draw into
this VolatileImage
.
Graphics2D
, used for drawing into this
image.public abstract int validate(GraphicsConfiguration gc)
validate
call. Also
validates this image against the given GraphicsConfiguration
parameter to see whether operations from this image to the
GraphicsConfiguration are compatible. An example of an
incompatible combination might be a situation where a VolatileImage
object was created on one graphics device and then was used
to render to a different graphics device. Since VolatileImage
objects tend to be very device-specific, this operation might
not work as intended, so the return code from this validate
call would note that incompatibility. A null or incorrect
value for gc may cause incorrect values to be returned from
validate
and may cause later problems with rendering.
gc
- a GraphicsConfiguration
object for this
image to be validated against. A null gc implies that the
validate method should skip the compatibility test.
IMAGE_OK
if the image did not need validationIMAGE_RESTORED
if the image needed restoration.
Restoration implies that the contents of the image may have
been affected and the image may need to be re-rendered.IMAGE_INCOMPATIBLE
if the image is incompatible
with the GraphicsConfiguration
object passed
into the validate
method. Incompatibility
implies that the image may need to be recreated with a
new Component
or
GraphicsConfiguration
in order to get an image
that can be used successfully with this
GraphicsConfiguration
.
An incompatible image is not checked for whether restoration
was necessary, so the state of the image is unchanged
after a return value of IMAGE_INCOMPATIBLE
and this return value implies nothing about whether the
image needs to be restored.GraphicsConfiguration
,
Component
,
IMAGE_OK
,
IMAGE_RESTORED
,
IMAGE_INCOMPATIBLE
public abstract boolean contentsLost()
true
if rendering data was lost since last
validate
call. This method should be called by the
application at the end of any series of rendering operations to
or from the image to see whether
the image needs to be validated and the rendering redone.
true
if the drawing surface needs to be restored;
false
otherwise.public abstract ImageCapabilities getCapabilities()
ImageCapabilities
object that contains
the capabilities of this VolatileImage
.public int getTransparency()
getTransparency
in interface Transparency
VolatileImage
.Transparency.OPAQUE
,
Transparency.BITMASK
,
Transparency.TRANSLUCENT