flash.display.Bitmap (ActionScript 3.0)

Package	flash.display
Classe	public class Bitmap
Héritage	Bitmap DisplayObject EventDispatcher Object

Version du langage:

ActionScript 3.0

Versions du moteur d'exécution:

AIR 1.0 Flash Player 9

La classe Bitmap représente les objets d'affichage qui représentent les images bitmap. Ces images peuvent être chargées avec la classe flash.display.Loader ou créées à l'aide du constructeur Bitmap().

Le constructeur Bitmap() vous permet de créer un objet Bitmap contenant une référence à un objet BitmapData. Après avoir créé un objet Bitmap, utilisez la méthode addChild() ou addChildAt() de l'occurrence parent de DisplayObjectContainer pour placer le bitmap dans la liste d'affichage.

Un objet Bitmap peut partager ses références BitmapData entre plusieurs objets Bitmap, indépendamment des propriétés de translation ou de rotation. Parce que vous pouvez créer plusieurs objets Bitmap qui référencent un même objet BitmapData, plusieurs objets d'affichage peuvent utiliser le même objet BitmapData complexe sans faire appel aux ressources supplémentaires de mémoire requises par un objet BitmapData pour chaque occurrence d'objet d'affichage.

Un objet BitmapData peut être dessiné à l'écran par un objet Bitmap de deux façons : avec le rendu vectoriel en tant que forme de remplissage de bitmap, ou en exécutant une routine de copie de pixels plus rapide. La routine de copie de pixels est nettement plus rapide que la fonctionnalité de rendu vectoriel, mais l'objet Bitmap doit satisfaire à certaines exigences pour y faire appel :

L'objet Bitmap ne peut pas subir d'étirement, de rotation ou d'inclinaison.
L'objet Bitmap ne peut pas subir de transformation des couleurs.
Aucun mode de fondu ne peut être appliqué à l'objet Bitmap.
Aucun découpage n'est effectué par le biais de calques de masque ou de méthodes setMask().
L'image en tant que telle ne doit pas être un masque.
Les coordonnées de destination ne doivent pas correspondre à la limite d'un pixel entier.

Si vous chargez un objet Bitmap provenant d'un autre domaine que celui de l'objet Loader utilisé pour charger l'image et qu'aucun fichier de régulation d'URL n'autorise l'accès au domaine de l'objet Loader, un script de ce domaine ne peut accéder ni à l'objet Bitmap, ni à ses propriétés et méthodes. Pour plus d'informations, consultez les références suivantes :

Le chapitre relatif à la sécurité du manuel Programmation avec ActionScript 3.0 et les derniers commentaires disponibles dans LiveDocs
La rubrique du Centre des développeurs de Flash Player : Sécurité

Remarque : la classe Bitmap n'étant pas une sous-classe de la classe InteractiveObject, elle ne peut pas distribuer d'événement de souris. Vous pouvez cependant utiliser la méthode addEventListener() du conteneur d'objet d'affichage qui contient l'objet Bitmap.

Consulter les exemples

Voir aussi

flash.display.Loader
flash.display.BitmapData
Classes d'affichage principales
Principes de base de l'utilisation des images bitmaps
Introduction à l'utilisation des images bitmaps

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		accessibilityProperties : AccessibilityProperties Options d'accessibilité actuelles de l'objet d'affichage.	DisplayObject
		alpha : Number Indique la valeur de transparence alpha de l'objet spécifié.	DisplayObject
		bitmapData : BitmapData Objet BitmapData référencé.	Bitmap
		blendMode : String Valeur de la classe BlendMode qui spécifie le mode de fondu à utiliser.	DisplayObject
		blendShader : Shader [lecture seule] Définit un shader utilisé pour le fondu de l'arrière-plan et du premier plan.	DisplayObject
		cacheAsBitmap : Boolean Si true est défini, Flash Player ou Adobe AIR place en mémoire cache une version bitmap interne de l’objet d'affichage.	DisplayObject
		constructor : Object Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.	Object
		filters : Array Tableau indexé contenant tous les objets filtre actuellement associés à l'objet d'affichage.	DisplayObject
		height : Number Indique la hauteur de l'objet d'affichage, en pixels.	DisplayObject
		loaderInfo : LoaderInfo [lecture seule] Renvoie un objet LoaderInfo qui contient des informations relatives au chargement du fichier auquel appartient cet objet d'affichage.	DisplayObject
		mask : DisplayObject L'objet d'affichage appelant est masqué par l'objet mask spécifié.	DisplayObject
		mouseX : Number [lecture seule] Indique la coordonnée x de la position de la souris, en pixels.	DisplayObject
		mouseY : Number [lecture seule] Indique la coordonnée y de la position de la souris, en pixels.	DisplayObject
		name : String Indique le nom d'occurrence de DisplayObject.	DisplayObject
		opaqueBackground : Object Indique si l'objet d'affichage est opaque avec une couleur d'arrière-plan spécifique.	DisplayObject
		parent : DisplayObjectContainer [lecture seule] Indique l'objet DisplayObjectContainer qui contient l'objet d'affichage.	DisplayObject
		pixelSnapping : String Contrôle si l'objet Bitmap est accroché ou non au pixel le plus proche.	Bitmap
		prototype : Object [statique] Référence à l'objet prototype d'un objet de classe ou fonction.	Object
		root : DisplayObject [lecture seule] Pour un objet d'affichage résidant dans un fichier SWF chargé, la propriété root correspond à l'objet d'affichage de premier niveau dans la partie de la structure arborescente de la liste d'affichage représentée par ce fichier.	DisplayObject
		rotation : Number Indique la rotation de l'occurrence de DisplayObject, en degrés, à partir de son orientation d'origine.	DisplayObject
		rotationX : Number Indique la rotation de l'axe des x de l'occurrence DisplayObject, en degrés, à partir de son orientation d'origine par rapport au conteneur 3D parent.	DisplayObject
		rotationY : Number Indique la rotation de l'axe des y de l'occurrence DisplayObject, en degrés, à partir de son orientation d'origine par rapport au conteneur 3D parent.	DisplayObject
		rotationZ : Number Indique la rotation de l'axe des z de l'occurrence DisplayObject, en degrés, à partir de son orientation d'origine par rapport au conteneur 3D parent.	DisplayObject
		scale9Grid : Rectangle Grille de mise à l'échelle en vigueur.	DisplayObject
		scaleX : Number Indique l'échelle horizontale (pourcentage) de l'objet telle qu'elle est appliquée à partir du point d'alignement.	DisplayObject
		scaleY : Number Indique le redimensionnement vertical (pourcentage) de l'objet tel qu'il est appliqué à partir du point d'alignement.	DisplayObject
		scaleZ : Number Indique l'échelle de profondeur (pourcentage) de l'objet tel qu'elle est appliquée à partir du point d'alignement.	DisplayObject
		scrollRect : Rectangle Cadre de délimitation du défilement de l'objet d'affichage.	DisplayObject
		smoothing : Boolean Contrôle si le bitmap est lissée lorsqu'elle est dimensionnée.	Bitmap
		stage : Stage [lecture seule] Scène de l'objet d'affichage.	DisplayObject
		transform : Transform Objet dont les propriétés se rapportent à la matrice, à la transformation des couleurs et aux limites des pixels d'un objet d'affichage.	DisplayObject
		visible : Boolean Indique si l'objet d'affichage est visible ou non.	DisplayObject
		width : Number Indique la largeur de l'objet d'affichage, en pixels.	DisplayObject
		x : Number Indique la coordonnée x de l'occurrence de DisplayObject par rapport aux coordonnées locales de l'objet DisplayObjectContainer parent.	DisplayObject
		y : Number Indique la coordonnée y de l'occurrence de DisplayObject par rapport aux coordonnées locales de l'objet DisplayObjectContainer parent.	DisplayObject
		z : Number Indique la position de coordonnée z le long de l'axe des z de l'occurrence DisplayObject par rapport au conteneur 3D parent.	DisplayObject

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		Bitmap(bitmapData:BitmapData = null, pixelSnapping:String = "auto", smoothing:Boolean = false) Initialise un objet Bitmap pour qu'il fasse référence à l'objet BitmapData spécifié.	Bitmap
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.	EventDispatcher
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d'événements.	EventDispatcher
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle Renvoie un rectangle qui définit la zone de l'objet d'affichage relativement au système de coordonnées de l'objet targetCoordinateSpace.	DisplayObject
		getRect(targetCoordinateSpace:DisplayObject):Rectangle Renvoie un rectangle qui définit les limites de l'objet d'affichage, en se basant sur le système de coordonnées défini par le paramètre targetCoordinateSpace, moins tout trait appliqué aux formes.	DisplayObject
		globalToLocal(point:Point):Point Convertit l'objet point des coordonnées de scène (globales) vers les coordonnées de l'objet d'affichage (locales).	DisplayObject
		globalToLocal3D(point:Point):Vector3D Convertit un point bidimensionnel à partir des coordonnées de scène (globales) vers les coordonnées d'un objet d'affichage tridimensionnel (locales).	DisplayObject
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l'objet EventDispatcher pour un type spécifique d'événement.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d'un objet est définie.	Object
		hitTestObject(obj:DisplayObject):Boolean Evalue le cadre de délimitation de l'objet d'affichage pour savoir s'il recouvre ou recoupe le cadre de délimitation de l'objet d'affichage obj.	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean Evalue l'objet d'affichage pour savoir s'il recouvre ou recoupe le point spécifié par les paramètres x et y.	DisplayObject
		isPrototypeOf(theClass:Object):Boolean Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l'objet spécifié en tant que paramètre.	Object
		local3DToGlobal(point3d:Vector3D):Point Convertit un point tridimensionnel des coordonnées de l'objet d'affichage tridimensionnel (locales) vers un point bidimensionnel dans les coordonnées de scène (globales).	DisplayObject
		localToGlobal(point:Point):Point Convertit l'objet point des coordonnées de l'objet d'affichage (locales) vers les coordonnées de la scène (globales).	DisplayObject
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l'objet EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l'objet spécifié.	Object
		valueOf():Object Renvoie la valeur primitive de l'objet spécifié.	Object
		willTrigger(type:String):Boolean Vérifie si un écouteur d'événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d'événement spécifié.	EventDispatcher

Synthèse	Défini par
activate	[Evénement de diffusion] Distribué lorsque l'application Flash Player obtient le focus du système d'exploitation et devient active.	EventDispatcher
added	Distribué lorsqu'un objet d'affichage est ajouté à la liste d'affichage.	DisplayObject
addedToStage	Envoyé lorsqu'un objet d'affichage est ajouté dans la liste d'affichage de la scène, directement ou par l'intermédiaire d'une arborescence secondaire qui contient l'objet d'affichage.	DisplayObject
deactivate	[Evénement de diffusion] Distribué lorsque l'application Flash Player ou AIR perd le focus du système d'exploitation et devient inactive.	EventDispatcher
enterFrame	[événement de diffusion] Distribué lorsque la tête de lecture est placée sur une nouvelle image.	DisplayObject
exitFrame	[événement de diffusion] Distribué lorsque la tête de lecture quitte l'image en cours.	DisplayObject
frameConstructed	[événement de diffusion] Distribué après l'exécution des constructeurs des objets d'affichage d'image, mais avant celle des scripts d'image.	DisplayObject
removed	Distribué lorsqu'un objet d'affichage est sur le point d'être supprimé de la liste d'affichage.	DisplayObject
removedFromStage	Distribué lorsqu'un objet d'affichage est sur le point d'être supprimé de la liste d'affichage de la scène, directement ou par l'intermédiaire de la suppression d'une arborescence secondaire qui contient l'objet d'affichage.	DisplayObject
render	[événement de diffusion] Distribué lorsque la liste d'affichage est sur le point d'être mise à jour et restituée.	DisplayObject

Détails de la propriété

bitmapData

propriété

bitmapData:BitmapData [lecture-écriture]

Version du langage:

ActionScript 3.0

Versions du moteur d'exécution:

AIR 1.0 Flash Player 9

Objet BitmapData référencé.

Implémentation
public function get bitmapData():BitmapData
public function set bitmapData(value:BitmapData):void

pixelSnapping

propriété

pixelSnapping:String [lecture-écriture]

Version du langage:

ActionScript 3.0

Versions du moteur d'exécution:

AIR 1.0 Flash Player 9

Contrôle si l'objet Bitmap est accroché ou non au pixel le plus proche. La classe PixelSnapping inclut les valeurs possibles :

PixelSnapping.NEVER — L'accrochage au pixel est désactivé.
PixelSnapping.ALWAYS — L'image est toujours accrochée au pixel le plus proche, quelle que soit la transformation appliquée.
PixelSnapping.AUTO — L'image bitmap est accrochée au pixel le plus proche si elle est dessinée sans rotation ni inclinaison et que son facteur de redimensionnement est compris entre 99,9 % et 100,1 %. Si ces conditions sont remplies, l'image bitmap est dessinée à l'échelle 100 % et accrochée au pixel le plus proche. En interne, cette valeur permet de dessiner l'image aussi rapidement que possible à l'aide de la fonctionnalité de rendu vectoriel.

Implémentation
public function get pixelSnapping():String
public function set pixelSnapping(value:String):void

smoothing

propriété

smoothing:Boolean [lecture-écriture]

Version du langage:

ActionScript 3.0

Versions du moteur d'exécution:

AIR 1.0 Flash Player 9

Contrôle si le bitmap est lissée lorsqu'elle est dimensionnée. Si le paramètre est défini sur true, le bitmap est lissée. S'il est défini sur false, le bitmap n'est pas lissée.

Implémentation
public function get smoothing():Boolean
public function set smoothing(value:Boolean):void

Détails du constructeur

Bitmap

()

Constructeur

public function Bitmap(bitmapData:BitmapData = null, pixelSnapping:String = "auto", smoothing:Boolean = false)

Version du langage:

ActionScript 3.0

Versions du moteur d'exécution:

AIR 1.0 Flash Player 9

Initialise un objet Bitmap pour qu'il fasse référence à l'objet BitmapData spécifié.

Paramètres

bitmapData:BitmapData (default = null) — Objet BitmapData référencé.

pixelSnapping:String (default = "auto") — Indique si l'objet Bitmap est accroché ou non au pixel le plus proche.

smoothing:Boolean (default = false) — Indique si l'image bitmap est lissée lorsqu'elle est dimensionnée. Les exemples ci-dessous illustrent la même image bitmap multipliée par trois, smoothing étant réglé sur false (gauche) et true (droite) :

Exemples Utilisation des exemples

BitmapExample.as

L'exemple suivant utilise la classe BitmapDataExample pour charger le fichier « Image.gif » dans DisplayObject à l'emplacement par défaut (x = 0, y = 0 ). Une copie d'Image.gif est ensuite placée à droite de l'original, qui applique de nouvelles couleurs aux pixels qui répondent aux critères définis par la méthode threshold(). Cette tâche s'accomplit de la façon suivante :

Une propriété url est créée pour désigner l'emplacement et le nom du fichier d'image.
Le constructeur de classe appelle la méthode configureAssets(), qui en retour appelle la méthode completeHandler().
configureAssets() crée un objet Loader, qui crée à son tour un écouteur d'événement, qui est transmis lorsque completeHandler() termine la manipulation de l'image.
Ensuite, la méthode buildChild() crée une occurrence d'objet URLRequest, request, et transmet le paramètre url de façon à identifier le nom de fichier et son emplacement.
L'objet request est ensuite transmis à la méthode loader.load(), qui charge l'image en mémoire à l'aide d'un objet d'affichage.
L'image est ensuite placée dans la liste d'affichage, qui affiche rapidement l'image aux coordonnées x = 0, y = 0.
La méthode completeHandler() effectue ensuite les opérations suivantes :

Remarques :

Vous devrez compiler le fichier SWF en réglant « Sécurité de lecture locale » sur « Accès aux fichiers locaux uniquement ».
Pour exécuter cet exemple, il est nécessaire de placer un fichier intitulé Image.txt dans le même répertoire que votre fichier SWF.
Il est recommandé d'utiliser une image qui ne dépasse pas 80 pixels de largeur.

package {
    import flash.display.Bitmap;
    import flash.display.BitmapData;
    import flash.display.Loader;
    import flash.display.Sprite;
    import flash.events.*;
    import flash.geom.Point;
    import flash.geom.Rectangle;
    import flash.net.URLRequest;

    public class BitmapExample extends Sprite {
        private var url:String = "Image.gif";
        private var size:uint = 80;

        public function BitmapExample() {
            configureAssets();
        }

        private function configureAssets():void {
            var loader:Loader = new Loader();
            loader.contentLoaderInfo.addEventListener(Event.COMPLETE, completeHandler);
            loader.contentLoaderInfo.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);

            var request:URLRequest = new URLRequest(url);
            loader.x = size * numChildren;
            loader.load(request);
            addChild(loader);
        }

        private function duplicateImage(original:Bitmap):Bitmap {
            var image:Bitmap = new Bitmap(original.bitmapData.clone());
            image.x = size * numChildren;
            addChild(image);
            return image;
        }

        private function completeHandler(event:Event):void {
            var loader:Loader = Loader(event.target.loader);
            var image:Bitmap = Bitmap(loader.content);

            var duplicate:Bitmap = duplicateImage(image);
            var bitmapData:BitmapData = duplicate.bitmapData;
            var sourceRect:Rectangle = new Rectangle(0, 0, bitmapData.width, bitmapData.height);
            var destPoint:Point = new Point();
            var operation:String = ">=";
            var threshold:uint = 0xCCCCCCCC;
            var color:uint = 0xFFFFFF00;
            var mask:uint = 0x000000FF;
            var copySource:Boolean = true;

            bitmapData.threshold(bitmapData,
                                 sourceRect,
                                 destPoint,
                                 operation,
                                 threshold,
                                 color,
                                 mask,
                                 copySource);
        }
        
        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("Unable to load image: " + url);
        }
    }
}

Guide de référence du langage et des composants ActionScript 3.0		Accueil \| Tous les packages \| Toutes les classes \| Eléments du langage \| Index \| Annexes \| Conventions \| Afficher les encadrés Masquer les encadrés
Bitmap	Propriétés \| Méthodes \| Evénements \| Exemples