java.lang.Object
   |
   +--java.awt.image.PixelGrabber

Deklaration

Beschreibung

Konstruktoren
public	PixelGrabber(Image img, int x, int y, int w, int h, boolean forceRGB)
public	PixelGrabber(Image img, int x, int y, int w, int h, int[] pix, int off, int scansize)
public	PixelGrabber(ImageProducer ip, int x, int y, int w, int h, int[] pix, int off, int scansize)

Methoden
public synchronized void	abortGrabbing()
public synchronized ColorModel	getColorModel()
public synchronized int	getHeight()
public synchronized Object	getPixels()
public synchronized int	getStatus()
public synchronized int	getWidth()
public boolean	grabPixels()
public synchronized boolean	grabPixels(long ms)
public synchronized void	imageComplete(int status)
public void	setColorModel(ColorModel model)
public void	setDimensions(int width, int height)
public void	setHints(int hints)
public void	setPixels(int srcX, int srcY, int srcW, int srcH, ColorModel model, byte[] pixels, int srcOff, int srcScan)
public void	setPixels(int srcX, int srcY, int srcW, int srcH, ColorModel model, int[] pixels, int srcOff, int srcScan)
public void	setProperties(Hashtable props)
public synchronized void	startGrabbing()
public synchronized int	status()       Verworfen in Version 1.1.

Konstruktoren im Detail

public PixelGrabber(Image img, int x, int y, int w, int h, boolean forceRGB)     

Erzeugt ein neues PixelGrabber-Objekt, mit dem ein Ausschnitt der Breite w, der Höhe h und der durch x und y festgelegten oberen linken Ecke ausgeschnitten werden kann. Die Bilddaten werden hierbei aus dem Image-Objekt img bezogen. Wenn forceRGB true ist, wird das voreingestellte RGB-Farbmodell zugrunde gelegt. Andernfalls wird das Farbmodell des Bildes übernommen.

public PixelGrabber(Image img, int x, int y, int w, int h, int[] pix, int off, int scansize)

Erzeugt ein neues PixelGrabber-Objekt, mit dem ein Ausschnitt aus dem Image-Objekt img kopiert werden kann. Der Ausschnitt hat die Breite w, die Höhe h und die durch x und y festgelegte obere linke Ecke. Die Farbwerte der Pixel werden ab dem Index off in dem Array pix gespeichert, wobei die Anfänge zweier aufeinanderfolgender Zeilen scansize Array-Positionen auseinander liegen.

public PixelGrabber(ImageProducer ip, int x, int y, int w, int h, int[] pix, int off, int scansize)

Wie die vorhergehende Variante, nur daß hier die Bilddaten vom ImageProducer ip bezogen werden.

Methoden im Detail

public synchronized void abortGrabbing()     

Beendet den Kopiervorgang.

public synchronized ColorModel getColorModel()     

Liefert das Farbmodell der Pixel-Daten zurück.

public synchronized int getHeight()     

Liefert die Höhe des Bildes in Pixeln oder -1, falls die Höhe noch nicht ermittelt werden kann.

public synchronized Object getPixels()     

Liefert die kopierten Pixel in einem int-Array, falls ein RGB-Farbmodell benutzt wurde, ansonsten in einem byte-Array.

public synchronized int getStatus()     

Liefert den Aufbereitungsstatus der Kopie.

public synchronized int getWidth()     

Liefert die Breite des Bildes in Pixeln oder -1, falls die Höhe noch nicht ermittelt werden kann.

public boolean grabPixels()

Versucht, die Pixel zu kopieren, und liefert true, wenn der Versuch erfolgreich war, oder false, wenn ein Fehler aufgetreten oder wenn eine Unterbrechung durch einen anderen Thread eingetreten ist. Diese Methode blockiert so lange, bis entweder der Kopiervorgang beendet oder ein Fehler aufgetreten ist.

Exception: InterruptedException

• Falls während des Kopiervorgangs eine Unterbrechung durch einen anderen Thread eingetreten ist.

public synchronized boolean grabPixels(long ms)

Zusätzlich zur vorhergehenden Variante kann ein Timeout angegeben werden, in dem der Kopiervorgang abgeschlossen sein muß. Falls der Timeout vorher abläuft, wird auch false zurückgegeben.

Exception: InterruptedException

• Falls während des Kopiervorgangs eine Unterbrechung durch einen anderen Thread eingetreten ist.

public synchronized void imageComplete(int status)

Wird aufgerufen, um den Aufbereitungsstatus des Bildes zu melden.

public void setColorModel(ColorModel model)

Diese Methode ist leer implementiert, da sie von dieser Klasse nicht benötigt wird.

public void setDimensions(int width, int height)

Setzt die Abmessungen der Kopie auf die übergebenen Werte.

public void setHints(int hints)

Diese Methode ist leer implementiert, da sie von dieser Klasse nicht benötigt wird.

public void setPixels(int srcX, int srcY, int srcW, int srcH, ColorModel model, byte[] pixels, int srcOff, int srcScan)

Kopiert den durch srcX, srcY, srcW und srcH festgelegten Ausschnitt aus dem Bild in das Array pixels. Mit srcOff wird der Startversatz, mit srcScan der Versatz zwischen den einzelnen Pixel-Zeilen im Quell-Array angegeben. Die Kopie erhält das Farbmodell model.

public void setPixels(int srcX, int srcY, int srcW, int srcH, ColorModel model, int[] pixels, int srcOff, int srcScan)

Wie die vorhergehende Variante, nur daß hier die Bilddaten in ein int-Array kopiert werden.

public void setProperties(Hashtable props)

Diese Methode ist leer implementiert, da sie von dieser Klasse nicht benötigt wird.

public synchronized void startGrabbing()     

Startet den Kopiervorgang.

public synchronized int status()

Liefert die Aufbereitungsstatus der Kopie.