Attempts to restore the drawing surface of the image if the surface
had been lost since the last
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.
Returns:
IMAGE_OK
if the image did not need validation
IMAGE_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.
Parameters:
-
gc - a
GraphicsConfiguration
object for this
image to be validated against. A null gc implies that the
validate method should skip the compatibility test.
See Also:
GraphicsConfiguration
,
Component
,
VolatileImage.IMAGE_OK
,
VolatileImage.IMAGE_RESTORED
,
VolatileImage.IMAGE_INCOMPATIBLE
,