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.
@param gc a GraphicsConfiguration
object for thisimage to be validated against. A null gc implies that the validate method should skip the compatibility test.
@return 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.
@see java.awt.GraphicsConfiguration
@see java.awt.Component
@see #IMAGE_OK
@see #IMAGE_RESTORED
@see #IMAGE_INCOMPATIBLE
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|