| Klasse java.awt.image.VolatileImage | 1.4 |
java.lang.Object
|
+--java.awt.image.VolatileImage
Deklaration
public abstract class VolatileImage
extends java.awt.Image
Beschreibung
Die flüchtige Grafik kann seinen Inhalt durch Umstände verliere, die ausserhalb des Einflussbereiches des Entwicklers liegen (z.B. durch das Betriebssystem). Aufgrund von Hardware-Beschleunigung kann diese Grafik signifikant bessere Performance bieten.
// image creation
VolatileImage vImg = createVolatileImage(w, h);
// rendering to the image
void renderOffscreen() {
do {
if (vImg.validate(getGraphicsConfiguration()) ==
VolatileImage.IMAGE_INCOMPATIBLE)
{
// old vImg doesn't work with new GraphicsConfig; re-create it
vImg = createVolatileImage(w, h);
}
Graphics2D g = vImg.createGraphics();
//
// miscellaneous rendering commands...
//
g.dispose();
} while (vImg.contentsLost());
}
// copying from the image (here, gScreen is the Graphics
// object for the onscreen window)
do {
int returnCode = vImg.validate(getGraphicsConfiguration());
if (returnCode == VolatileImage.IMAGE_RESTORED) {
// Contents need to be restored
renderOffscreen(); // restore contents
} else if (returnCode == VolatileImage.IMAGE_INCOMPATIBLE) {
// old vImg doesn't work with new GraphicsConfig; re-create it
vImg = createVolatileImage(w, h);
renderOffscreen();
}
gScreen.drawImage(vImg, 0, 0, this);
} while (vImg.contentsLost());
Datenelemente im Detail
-
public final static int IMAGE_INCOMPATIBLE
-
Konstante, die aussagt, dass die Grafik inkompatibel mit der GraphicsConfiguration ist.
-
public final static int IMAGE_OK
-
Konstante für einen positiven Befund.
Validated image is ready to use as-is.
-
public final static int IMAGE_RESTORED
-
Die Grafik wurde wieder initialisiert und ist nun einsatzbereit.
Konstruktoren im Detail
-
public VolatileImage()
-
Methoden im Detail
-
public abstract boolean contentsLost()
-
Liefert true, wenn die Daten verloren sind.
-
public abstract Graphics2D createGraphics()
-
Erzeugt ein neues Graphics2D-Exemplar.
-
public void flush()
-
Gibt die Ressourcen frei.
-
public abstract ImageCapabilities getCapabilities()
-
Liefert das ImageCapabilities-Exemplar.
-
public Graphics getGraphics()
-
Liefert das Graphics2D-Exemplar zurück.
-
public abstract int getHeight()
-
Liefert die Höhe.
-
public abstract BufferedImage getSnapshot()
-
Liefert einen statischen Snapshot des Bildes.
-
public ImageProducer getSource()
-
Liefert die Quelle.
-
public abstract int getWidth()
-
Liefert die Breite.
-
public abstract int validate(GraphicsConfiguration gc)
-
Versucht, das Bild wieder herzustellen.
Copyright © 2002 dpunkt.Verlag, Heidelberg. Alle Rechte vorbehalten.