MotionBase

Package	fl.motion
Classe	public class MotionBase
Héritage	MotionBase Object
Sous-classes	Motion

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

La classe MotionBase stocke une séquence d’animations d’images-clés pouvant s’appliquer à un objet visuel. Les données de l’animation comprennent les éléments suivants : position, échelle, rotation, inclinaison, couleur, filtres et accélération. La classe MotionBase possède des méthodes pour récupérer les données au niveau de points d’images-clés spécifiques. Pour obtenir des valeurs interpolées entre les images-clés, utilisez la classe Motion.

Consulter les exemples

Eléments de l’API associés

Classe Motion
Eléments XML de mouvement

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
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		duration : int Contrôle la durée de l’occurrence de Motion, mesurée en images.	MotionBase
		is3D : Boolean Spécifie si le mouvement contient des modifications de propriété 3D.	MotionBase
		keyframes : Array Tableau d’images-clés définissant le comportement du mouvement sur la durée.	MotionBase

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		MotionBase(xml:XML = null) Constructeur d’occurrences de MotionBase.	MotionBase
		addFilterPropertyArray(index:int, name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void Modifie une propriété de filtre dans toutes les images-clés correspondantes d’un objet Motion.	MotionBase
		addKeyframe(newKeyframe:KeyframeBase):void Ajoute un objet d'image-clé à l'occurrence de Motion.	MotionBase
		addPropertyArray(name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void Stocke un tableau de valeurs dans des images-clés correspondantes pour une propriété déclarée de la classe Motion.	MotionBase
		getColorTransform(index:int):flash.geom:ColorTransform Récupère un objet ColorTransform interpolé au niveau d'un index de temps spécifique dans l'occurrence de Motion.	MotionBase
		getCurrentKeyframe(index:int, tweenableName:String = ""):KeyframeBase Extrait l’image-clé qui est actuellement active au niveau d’une image particulière dans l’occurrence de Motion.	MotionBase
		getFilters(index:Number):Array Récupère un tableau interpolé de filtres au niveau d’un index de temps spécifique dans l’occurrence de Motion.	MotionBase
		getMatrix(index:int):Matrix Revient à l’objet Matrix pour la position d’index spécifiée de l’image d’animation.	MotionBase
		getMatrix3D(index:int):Object Revient à l'objet Matrix3D pour la position d'index spécifiée de l'image d'animation.	MotionBase
		getNextKeyframe(index:int, tweenableName:String = ""):KeyframeBase Extrait l’image-clé qui suit une image particulière dans l’occurrence de Motion.	MotionBase
		getValue(index:Number, tweenableName:String):Number Récupère la valeur d’une propriété d’animation à un point dans le temps.	MotionBase
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		initFilters(filterClasses:Array, gradientSubarrayLengths:Array, startFrame:int = -1, endFrame:int = -1):void Initialise la liste de filtres pour l'objet cible et copie cette liste dans chaque occurrence Keyframe de l'objet Motion.	MotionBase
		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
		overrideTargetTransform(scale:Boolean = true, skew:Boolean = true, rotate:Boolean = true):void	MotionBase
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		setValue(index:int, tweenableName:String, value:Number):void Définit la valeur d’une propriété interpolable spécifique au niveau d’un index de temps donné dans l’occurrence de Motion.	MotionBase
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		useRotationConcat(index:int):Boolean Fait pivoter l’objet cible lorsque les données du mouvement sont fournies par la méthode addPropertyArray().	MotionBase
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object

Détails de la propriété

duration

propriété

duration:int

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Contrôle la durée de l’occurrence de Motion, mesurée en images. La durée ne peut pas être inférieure au temps occupé par les images-clés de l’occurrence de Motion.

La valeur par défaut est 0.

Implémentation
public function get duration():int
public function set duration(value:int):void

is3D

propriété

is3D:Boolean

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5, AIR 1.0

Spécifie si le mouvement contient des modifications de propriété 3D. Si true, le mouvement contient des modifications de propriété 3D.

La valeur par défaut est false.

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

keyframes

propriété

public var keyframes:Array

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Tableau d’images-clés définissant le comportement du mouvement sur la durée. Cette propriété est un tableau clairsemé dans lequel une image-clé est positionnée à un index qui correspond à son propre index. Un objet de mouvement avec des images-clés à 0 et 5 présentera un tableau d’images-clés d’une longueur de 6. Les index 0 et 5 du tableau contiendront chacun une image-clé, tandis que les index 1 et 4 prendront la valeur null.

Détails du constructeur

()

Constructeur

public function MotionBase(xml:XML = null)

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Constructeur d’occurrences de MotionBase. Une image-clé initiale est créée automatiquement par défaut, avec des propriétés de transformation par défaut.

Paramètres

xml:XML (default = null) — Objet XML E4X facultatif définissant une occurrence de Motion.

Détails de la méthode

addFilterPropertyArray

()

méthode

 public function addFilterPropertyArray(index:int, name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Modifie une propriété de filtre dans toutes les images-clés correspondantes d’un objet Motion. Appelez initFilters() avant d’utiliser cette méthode. L’ordre des valeurs dans le tableau détermine l’affectation de chaque valeur à la propriété de filtre pour toutes les images-clés. Pour chaque valeur non nulle du tableau de valeurs spécifié, cette méthode recherche l’image-clé correspondant à la position d’index de la valeur dans le tableau, puis stocke la paire nom/valeur de la propriété pour le filtre dans l’image-clé.

Paramètres

	`index:int` — Position d’index de base zéro dans le tableau de filtres.

	`name:String` — Nom de la propriété de filtre à stocker dans chaque image-clé.

	`values:Array` — Tableau de valeurs pour la propriété spécifiée dans le paramètre `name`. Chaque valeur non nulle est affectée au filtre dans une image-clé correspondant à l’index de la valeur dans le tableau.

	`startFrame:int` (default = `-1`)

	`endFrame:int` (default = `-1`)

Plus d’exemples

Ajout de filtres

Eléments de l’API associés

initFilters()
flash.filters

addKeyframe

()

méthode

public function addKeyframe(newKeyframe:KeyframeBase):void

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Ajoute un objet d'image-clé à l'occurrence de Motion.

Paramètres

newKeyframe:KeyframeBase — Objet Keyframe avec une propriété d’index déjà définie.

Eléments de l’API associés

fl.motion.Keyframe

addPropertyArray

()

méthode

public function addPropertyArray(name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Stocke un tableau de valeurs dans des images-clés correspondantes pour une propriété déclarée de la classe Motion. L’ordre des valeurs dans le tableau détermine l’affectation de chaque valeur à une image-clé. Pour chaque valeur non nulle du tableau de valeurs donné, cette méthode recherche l’image-clé correspondant à la position d’index de la valeur dans le tableau, ou crée une nouvelle image-clé pour cette position d’index, puis stocke la paire nom/valeur de la propriété dans l’image-clé.

Paramètres

	`name:String` — Nom de la propriété de la classe Motion à stocker dans chaque image-clé.

	`values:Array` — Tableau de valeurs pour la propriété spécifiée dans le paramètre `name`. Une image-clé correspondant à l’ordre de la valeur dans le tableau est affectée à chaque valeur non nulle.

	`startFrame:int` (default = `-1`)

	`endFrame:int` (default = `-1`)

Plus d’exemples

Description de l’animation

Eléments de l’API associés

fl.motion.Motion

getColorTransform

()

méthode

public function getColorTransform(index:int):flash.geom:ColorTransform

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Récupère un objet ColorTransform interpolé au niveau d'un index de temps spécifique dans l'occurrence de Motion.

Paramètres

index:int — Index de temps d'une image dans l'occurrence de Motion, exprimé sous forme d'entier supérieur ou égal à zéro.

Valeur renvoyée

flash.geom:ColorTransform — Objet ColorTransform interpolé.

Eléments de l’API associés

flash.geom.ColorTransform

getCurrentKeyframe

()

méthode

public function getCurrentKeyframe(index:int, tweenableName:String = ""):KeyframeBase

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Extrait l’image-clé qui est actuellement active au niveau d’une image particulière dans l’occurrence de Motion. Une image qui n’est pas image-clé tire ses valeurs de l’image-clé qui la précède.

Cette méthode peut également filtrer des valeurs sur le nom d’une propriété interpolable particulière. Vous pouvez trouver l’image-clé actuellement active pour x, qui peut être différente de l’image-clé actuellement active en général.

Paramètres

	`index:int` — Index d’une image dans l’occurrence de Motion, exprimé sous la forme d’un entier supérieur ou égal à zéro.

	`tweenableName:String` (default = "") — Nom facultatif d’une propriété tweenable, tel que `"x"` ou `"rotation"`.

Valeur renvoyée

KeyframeBase — Image-clé correspondant le mieux avant l’index d’image fourni ou correspondant à cet index.

Eléments de l’API associés

fl.motion.Tweenables

getFilters

()

méthode

public function getFilters(index:Number):Array

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Récupère un tableau interpolé de filtres au niveau d’un index de temps spécifique dans l’occurrence de Motion.

Paramètres

index:Number — Index de temps d’une image dans le mouvement, exprimé sous la forme d’un entier supérieur ou égal à zéro.

Valeur renvoyée

Array — Tableau interpolé de filtres. S’il n’existe aucun filtre applicable, renvoie un tableau vide.

Eléments de l’API associés

flash.filters

getMatrix

()

méthode

public function getMatrix(index:int):Matrix

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5, AIR 1.0

Revient à l’objet Matrix pour la position d’index spécifiée de l’image d’animation.

Paramètres

index:int — Position d’index de base zéro de l’image d’animation contenant la matrice

Valeur renvoyée

Matrix — Objet Matrix, ou valeur nulle. Cette méthode peut renvoyer une valeur nulle même si MotionBase.is3D est définie sur false, car d’autres modifications de propriété d’interpolation de mouvement peuvent être utilisées sans objet Matrix.

Eléments de l’API associés

flash.geom.Matrix

getMatrix3D

()

méthode

public function getMatrix3D(index:int):Object

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5, AIR 1.0

Revient à l'objet Matrix3D pour la position d'index spécifiée de l'image d'animation.

Paramètres

index:int — Position d’index de base zéro de l’image d’animation contenant la matrice 3D.

Valeur renvoyée

Object — Objet Matrix3D, ou valeur nulle. Cette méthode peut renvoyer une valeur nulle même si MotionBase.is3D est true car d’autres modifications de propriété d’interpolation de mouvement 3D peuvent être utilisées sans objet Matrix3D.

Eléments de l’API associés

flash.geom.Matrix3D

getNextKeyframe

()

méthode

public function getNextKeyframe(index:int, tweenableName:String = ""):KeyframeBase

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Extrait l’image-clé qui suit une image particulière dans l’occurrence de Motion. Si une image qui n’est pas une image-clé se trouve au milieu d’une interpolation, cette méthode tire ses valeurs à la fois de l’image-clé précédente et de la suivante.

Cette méthode permet également de filtrer sur la base du nom d’une propriété interpolable spécifique afin de trouver la prochaine image clé pour une propriété, qui peut ne pas correspondre à l’image-clé suivante en général.

Paramètres

	`index:int` — Index d’une image dans l’occurrence de Motion, exprimé sous la forme d’un entier supérieur ou égal à zéro.

	`tweenableName:String` (default = "") — Nom facultatif d’une propriété tweenable, tel que `"x"` ou `"rotation"`.

Valeur renvoyée

KeyframeBase — Image-clé correspondant le mieux après l’index d’image fourni.

Eléments de l’API associés

fl.motion.Tweenables

getValue

()

méthode

public function getValue(index:Number, tweenableName:String):Number

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Récupère la valeur d’une propriété d’animation à un point dans le temps.

Paramètres

	`index:Number` — Index de temps d'une image dans l'occurrence de Motion, exprimé sous forme d'entier supérieur ou égal à zéro.

	`tweenableName:String` — Nom d’une propriété tweenable, tel que `"x"` ou `"rotation"`.

Valeur renvoyée

Number — Valeur numérique de la propriété spécifiée dans le paramètre tweenableName.

Eléments de l’API associés

fl.motion.Tweenables

initFilters

()

méthode

 public function initFilters(filterClasses:Array, gradientSubarrayLengths:Array, startFrame:int = -1, endFrame:int = -1):void

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Initialise la liste de filtres pour l'objet cible et copie cette liste dans chaque occurrence Keyframe de l'objet Motion.

Paramètres

	`filterClasses:Array` — Tableau de classes de filtres. Chaque élément du tableau est le nom de classe complet (sous forme de chaîne) du type de filtre occupant cet index.

	`gradientSubarrayLengths:Array` — Tableau de nombres contenant une valeur pour chaque filtre présent dans la liste des filtres du mouvement (chaque nom de classe dans le tableau `filterClasses`). Une valeur du tableau `gradientSubarrayLengths` n’est utilisée que si l’entrée de la classe du filtre à la même position d’index dans le tableau `filterClasses` est GradientGlowFilter ou GradientBevelFilter. La valeur correspondante dans le tableau `gradientSubarrayLengths` est un nombre qui détermine la longueur des tableaux qui initialisent les paramètres `colors`, `alphas` et `ratios` pour les fonctions constructeur GradientGlowFilter et GradientBevelFilter.

	`startFrame:int` (default = `-1`)

	`endFrame:int` (default = `-1`)

Plus d’exemples

Ajout de filtres

Eléments de l’API associés

flash.filters
flash.filters.GradientGlowFilter
flash.filters.GradientBevelFilter

overrideTargetTransform

()

méthode

public function overrideTargetTransform(scale:Boolean = true, skew:Boolean = true, rotate:Boolean = true):void

Paramètres

	`scale:Boolean` (default = `true`)

	`skew:Boolean` (default = `true`)

	`rotate:Boolean` (default = `true`)

setValue

()

méthode

public function setValue(index:int, tweenableName:String, value:Number):void

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Définit la valeur d’une propriété interpolable spécifique au niveau d’un index de temps donné dans l’occurrence de Motion. Si aucune image-clé n’existe au niveau de l’index, elle est créée automatiquement.

Paramètres

	`index:int` — Index de temps d’une image dans l’occurrence de Motion, exprimé sous forme d’entier supérieur à zéro. Si la valeur de l’index est zéro, aucune modification n’est effectuée. Les propriétés de transformation sont relatives aux valeurs de transformation de départ de l’objet cible ; les valeurs de la première image (valeur d’index zéro) sont toujours les valeurs par défaut et ne doivent pas être modifiées.

	`tweenableName:String` — Nom d’une propriété tweenable sous forme de chaîne (tel que `« x »` ou `« rotation »`).

	`value:Number` — Nouvelle valeur de la propriété tweenable.

Eléments de l’API associés

fl.motion.Tweenables

useRotationConcat

()

méthode

public function useRotationConcat(index:int):Boolean

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5, AIR 1.0

Fait pivoter l’objet cible lorsque les données du mouvement sont fournies par la méthode addPropertyArray().

Paramètres

index:int — Position d’index de l’image d’une animation.

Valeur renvoyée

Boolean — Indique si l’objet cible doit pivoter à l’aide de la propriété stockée dans KeyframeBase.rotationConcat.

Eléments de l’API associés

addPropertyArray()
fl.motion.KeyframeBase.rotationConcat

Exemples Comment utiliser cet exemple

MotionBaseExample.as

L’exemple suivant montre comment animer un objet Sprite à l’aide des classes MotionBase et AnimatorFactory. Un objet MotionBase est associé à des tableaux de coordonnées x et y, puis est utilisé pour créer un objet AnimatorFactory. L’objet AnimatorFactory est ensuite lié à un objet Sprite, sous la forme d’un rectangle rempli.

package 
{
     import flash.display.MovieClip;
     import flash.display.Sprite;
     import fl.motion.AnimatorFactory;
     import fl.motion.MotionBase;
     import flash.geom.Point;
    
     public class  MotionBaseExample extends MovieClip
     {
          private var motionBase:MotionBase;
          private var animFactory:AnimatorFactory;
          private var size:uint    = 100;
          private var bgColor:uint = 0xFFCC00;

          public function MotionBaseExample():void
          {
               var boxObj:sprite = new Sprite();
               boxObj.graphics.beginFill(bgColor);
               boxObj.graphics.drawRect(0, 0, size, size);
               boxObj.graphics.endFill();
               addChild(boxObj);

               motionBase = new MotionBase();
               motionBase.duration = 20;
               motionBase.addPropertyArray("x",[0,50,95,134,169,199,225,247,265,280]);
               motionBase.addPropertyArray("y",[0,1,0,4,12,21,32,44,52,38]);
               animFactory = new AnimatorFactory(motionBase);
               animFactory.transformationPoint = new Point(2, 2);
               animFactory.addTarget(boxObj, 0);
          }
     }    
}

Informations juridiques | Politique de confidentialité en ligne

MotionBase - AS3 Flash

Packagesx

Eléments du langage

Annexes

Package fl.motion

duration

is3D

keyframes

MotionBase

addFilterPropertyArray

addKeyframe

addPropertyArray

getColorTransform

getCurrentKeyframe

getFilters

getMatrix

getMatrix3D

getNextKeyframe

getValue

initFilters

overrideTargetTransform

setValue

useRotationConcat