Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Verwenden von Bitmaps
Laden externer Bilder als Bitmap-Daten
Flash Player 9 und höher, Adobe AIR 1.0 und höher
Die erste Teilaufgabe in diesem Beispiel ist das Laden einer externen Bilddatei, die in diesem Fall ein Foto der
Mondoberfläche ist. Der Ladevorgang wird mit zwei Methoden der MoonSphere-Klasse durchgeführt: dem
MoonSphere()-Konstruktor, mit dem der Ladevorgang eingeleitet wird, und der imageLoadComplete()-Methode,
die aufgerufen wird, wenn das externe Bild vollständig geladen wurde.
Das Laden externer Bilder entspricht dem Laden externer SWF-Dateien. In beiden Fällen wird zum Durchführen des
Ladevorgangs eine Instanz der flash.display.Loader-Klasse verwendet. Der Code in der MoonSphere()-Methode, mit
dem das Laden des Bilds gestartet wird, lautet wie folgt:
var imageLoader:Loader = new Loader();
imageLoader.contentLoaderInfo.addEventListener(Event.COMPLETE, imageLoadComplete);
imageLoader.load(new URLRequest("moonMap.png"));
In der ersten Zeile wird die Loader-Instanz mit dem Namen imageLoader deklariert. In der dritten Zeile wird dann
der Ladevorgang tatsächlich gestartet, indem die load()-Methode des Loader-Objekts aufgerufen und eine
URLRequest-Instanz übergeben wird, die die URL des zu ladenden Bilds enthält. In der zweiten Zeile wird der
Ereignis-Listener festgelegt, der ausgelöst wird, wenn das Bild vollständig geladen wurde. Beachten Sie, dass die
addEventListener()-Methode nicht für die Loader-Instanz selbst aufgerufen wird, sondern für die
contentLoaderInfo-Eigenschaft des Loader-Objekts. Die Loader-Instanz selbst löst keine Ereignisse aus, die sich auf
die zu ladenden Inhalte beziehen. Die contentLoaderInfo-Eigenschaft der Instanz enthält jedoch einen Verweis auf
das LoaderInfo-Objekt, das den in das Loader-Objekt zu ladenden Inhalten zugeordnet ist (in diesem Fall das externe
Bild). Dieses LoaderInfo-Objekt enthält mehrere Ereignisse mit Bezug auf den Fortschritt und den Abschluss des
Ladevorgangs externer Inhalte, u. a. das complete-Ereignis (Event.COMPLETE), das einen Aufruf der
imageLoadComplete()-Methode auslöst, wenn das Bild vollständig geladen wurde.
Während das Starten des Ladens externer Bilder einen wichtigen Teil des Gesamtvorgangs darstellt, ist es genau so
wichtig, sich über die folgenden Schritte im Klaren zu sein, nachdem das Laden abgeschlossen ist. Wie im zuvor
abgebildeten Code dargestellt, wird die imageLoadComplete()-Funktion aufgerufen, wenn das Bild vollständig
geladen ist. In dieser Funktion erfolgen verschiedene Manipulationen der geladenen Bilddaten, die in den folgenden
Abschnitten beschrieben werden. Zum Verwenden der Bilddaten muss jedoch zunächst auf sie zugegriffen werden.
Beim Verwenden eines Loader-Objekts zum Laden eines externen Bilds wird das geladene Bild zu einer Bitmap-
Instanz, die dem Loader-Objekt als untergeordnetes Anzeigeobjekt zugeordnet wird. In diesem Fall steht die Loader-
Instanz in der Ereignis-Listener-Methode als Teil des Ereignisobjekts zur Verfügung, das der Methode als Parameter
übergeben wird. Es folgen die ersten Zeilen der imageLoadComplete()-Methode:
private function imageLoadComplete(event:Event):void
{
textureMap = event.target.content.bitmapData;
...
}
Beachten Sie, dass der Ereignisobjektparameter die Bezeichnung event trägt und eine Instanz der Event-Klasse ist.
Jede Instanz der Event-Klasse hat eine target-Eigenschaft, die auf das Objekt verweist, das das Ereignis ausgelöst hat
(in diesem Fall die LoaderInfo-Instanz, für die wie zuvor beschrieben die addEventListener()-Methode aufgerufen
wurde). Das LoaderInfo-Objekt hat wiederum eine content-Eigenschaft, die (nach Abschluss des Ladevorgangs) die
Bitmap-Instanz mit dem geladenen Bitmapbild enthält. Wenn Sie das Bild direkt auf dem Bildschirm anzeigen
möchten, können Sie diese Bitmap-Instanz (event.target.content) einem Anzeigeobjektcontainer zuweisen. (Sie
können auch das Loader-Objekt einem Anzeigeobjektcontainer zuweisen). In diesem Beispiel werden die geladenen
Letzte Aktualisierung 27.6.2012
271