Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Verwenden von Bitmaps
Kollisionserkennung auf Pixelebene
Flash Player 9 und höher, Adobe AIR 1.0 und höher
Mit der BitmapData.hitTest()-Methode wird eine Kollisionserkennung auf Pixelebene zwischen den Bitmapdaten
und einem anderen Objekt oder Punkt durchgeführt.
Bei der BitmapData.hitTest()-Methode können die folgenden fünf Parameter angegeben werden:
firstPoint (Point): Dieser Parameter verweist auf die Pixelposition der linken oberen Ecke des ersten
BitmapData-Objekts, anhand dessen die Kollisionserkennung durchgeführt wird.
firstAlphaThreshold (uint): Mit diesem Parameter wird der höchste Alphakanalwert angegeben, der bei der
Kollisionserkennung als undurchsichtig ausgewertet wird.
secondObject (Object): Dieser Parameter stellt den Kollisionsbereich dar. Beim secondObject-Objekt kann es
sich um ein Rectangle-, Point-, Bitmap- oder BitmapData-Objekt handeln. Mit diesem Objekt wird der
Kollisionsbereich angegeben, für den die Kollisionserkennung durchgeführt wird.
secondBitmapDataPoint (Point): Mit diesem optionalen Parameter wird die Position eines Pixels im zweiten
BitmapData-Objekt angegeben. Dieser Parameter wird nur verwendet, wenn der Wert des secondObject-Objekts
ein BitmapData-Objekt ist. Der Standardwert ist null.
secondAlphaThreshold (uint): Mit diesem optionalen Parameter wird der höchste Alphakanalwert angegeben,
der im zweiten BitmapData-Objekt als undurchsichtig ausgewertet wird. Der Standardwert ist 1. Dieser Parameter
wird nur verwendet, wenn der Wert von secondObject ein BitmapData-Objekt ist und beide BitmapData-Objekte
Transparenzinformationen enthalten.
Denken Sie beim Durchführen der Kollisionserkennung für undurchsichtige Bilder daran, dass das Bild in
ActionScript so verarbeitet wird, als handle es sich um vollständig undurchsichtige Rechtecke (oder
Begrenzungsfelder). Beim Durchführen der Kollisionserkennung auf Pixelebene bei Bildern mit Transparenz müssen
dagegen beide Bilder Transparenzinformationen enthalten. Darüber hinaus wird in ActionScript mithilfe der
Parameter für den Alphaschwellenwert ermittelt, an welchem Punkt Pixel von transparent in undurchsichtig
übergehen.
Im folgenden Beispiel werden drei Bitmapbilder erstellt. Anschließend wird eine Kollisionserkennung mit zwei
verschiedenen Kollisionspunkten durchgeführt (ein Kollisionspunkt gibt „false“ zurück, der andere „true“):
Letzte Aktualisierung 27.6.2012
263