Packagefl.motion
Classepublic class Motion
HéritageMotion Inheritance Object

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

La classe Motion 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 Motion possède des méthodes pour récupérer les données à des points spécifiques dans le temps et pour interpoler automatiquement les valeurs entre les images-clés.

Propriété MXML par défautkeyframesCompact

Voir aussi

Eléments XML de mouvement


Propriétés publiques
 PropriétéDéfini par
 Inheritedconstructor : 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.
Motion
  keyframes : Array
Tableau d'images-clés définissant le comportement du mouvement sur la durée.
Motion
  keyframesCompact : Array
Tableau d'images-clés compact, dans lequel chaque index est occupé par une image-clé.
Motion
 Inheritedprototype : Object
[static] Référence à l’objet prototype d’un objet de classe ou fonction.
Object
  source : Source
Objet qui stocke des informations sur le contexte de création du mouvement, tel que la fréquence d'images, les dimensions, le point de transformation et la position initiale, l'échelle, la rotation et l'inclinaison.
Motion
Méthodes publiques
 MéthodeDéfini par
  
Motion(xml:XML = null)
Constructeur pour les occurrences de Motion.
Motion
  
addKeyframe(newKeyframe:Keyframe):void
Ajoute un objet d'image-clé à l'occurrence de Motion.
Motion
  
[static] Méthode nécessaire pour créer une occurrence de Motion à partir d'une chaîne XML.
Motion
  
Récupère un objet ColorTransform interpolé au niveau d'un index de temps spécifique dans l'occurrence de Motion.
Motion
  
getCurrentKeyframe(index:int, tweenableName:String = ""):Keyframe
Extrait l'image-clé qui est actuellement active au niveau d'une image particulière dans l'occurrence de Motion.
Motion
  
Récupère un tableau interpolé de filtres au niveau d'un index de temps spécifique dans l'occurrence de Motion.
Motion
  
getNextKeyframe(index:int, tweenableName:String = ""):Keyframe
Extrait l'image-clé qui suit une image particulière dans l'occurrence de Motion.
Motion
  
getValue(index:Number, tweenableName:String):Number
Récupère la valeur d'une propriété d'animation à un point dans le temps.
Motion
 Inherited
Indique si la propriété spécifiée d'un objet est définie.
Object
  
[static] Mélange des filtres d'un objet Filter à un autre.
Motion
  
interpolateFilters(fromFilters:Array, toFilters:Array, progress:Number):Array
[static] Mélange des filtres d'un tableau d'objets Filter à un autre.
Motion
 Inherited
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
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
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.
Motion
 Inherited
Renvoie la représentation sous forme de chaîne de l'objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l'objet spécifié.
Object
Détails des propriétés
durationpropriété
duration:int  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.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
keyframespropriété 
public var keyframes:Array

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.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.

keyframesCompactpropriété 
keyframesCompact:Array  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Tableau d'images-clés compact, dans lequel chaque index est occupé par une image-clé. A l'inverse, un tableau clairsemé contient des index vides (comme dans la propriété keyframes). Dans le tableau compact, aucune valeur null n'est utilisée pour remplir les index entre les images-clés. Toutefois, l'index d'une image-clé dans le tableau keyframesCompact ne correspond probablement pas à celui du tableau keyframes.

Cette propriété est essentiellement utilisée pour assurer la compatibilité avec le compilateur Flex MXML, qui génère un tableau compact à partir du code XML de mouvement (Motion).


Implémentation
    public function get keyframesCompact():Array
    public function set keyframesCompact(value:Array):void

Voir aussi

sourcepropriété 
public var source:Source

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Objet qui stocke des informations sur le contexte de création du mouvement, tel que la fréquence d'images, les dimensions, le point de transformation et la position initiale, l'échelle, la rotation et l'inclinaison.

Détails du constructeur
Motion()Constructeur
public function Motion(xml:XML = null)

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Constructeur pour les occurrences de Motion. 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 des méthodes
addKeyframe()méthode
public function addKeyframe(newKeyframe:Keyframe):void

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

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

Paramètres

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

Voir aussi

fromXMLString()méthode 
public static function fromXMLString(xmlString:String):Motion

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Méthode nécessaire pour créer une occurrence de Motion à partir d'une chaîne XML.

Paramètres

xmlString:String — Chaîne XML de mouvement (Motion).

Valeur renvoyée
Motion — Nouvelle occurrence de Motion.
getColorTransform()méthode 
public function getColorTransform(index:int):ColorTransform

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.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
ColorTransform — Objet ColorTransform interpolé.

Voir aussi

getCurrentKeyframe()méthode 
public function getCurrentKeyframe(index:int, tweenableName:String = ""):Keyframe

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.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
Keyframe — Image-clé correspondant le mieux avant l'index d'image fourni ou correspondant à cet index.

Voir aussi

getFilters()méthode 
public function getFilters(index:Number):Array

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.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.

Voir aussi

getNextKeyframe()méthode 
public function getNextKeyframe(index:int, tweenableName:String = ""):Keyframe

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.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 peut également filtrer en utilisant le nom d'une propriété interpolable particulière. Ceci vous permet de trouver la prochaine image-clé pour x, qui peut être différente de la prochaine image-clé 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
Keyframe — Image-clé correspondant le mieux après l'index d'image fourni.

Voir aussi

getValue()méthode 
public function getValue(index:Number, tweenableName:String):Number

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.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

Voir aussi

interpolateFilter()méthode 
public static function interpolateFilter(fromFilter:BitmapFilter, toFilter:BitmapFilter, progress:Number):BitmapFilter

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Mélange des filtres d'un objet Filter à un autre.

Paramètres

fromFilter:BitmapFilter — Objet Filter de début.
 
toFilter:BitmapFilter — Objet Filter de fin.
 
progress:Number — Pourcentage de la transition exprimé sous une forme décimale, sachant que 0 est la valeur de début et 1 la valeur de fin.

Valeur renvoyée
BitmapFilter — Objet Filter interpolé.

Voir aussi

interpolateFilters()méthode 
public static function interpolateFilters(fromFilters:Array, toFilters:Array, progress:Number):Array

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Mélange des filtres d'un tableau d'objets Filter à un autre.

Paramètres

fromFilters:Array — Tableau de début d'objets Filter.
 
toFilters:Array — Tableau de fin d'objets Filter.
 
progress:Number — Pourcentage de la transition exprimé sous une forme décimale, sachant que 0 est la valeur de début et 1 la valeur de fin.

Valeur renvoyée
Array — Tableau interpolé d'objets Filter.

Voir aussi

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

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.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. Etant donné que les propriétés de transformation varient en fonction de la transformation de départ de l'objet cible, les valeurs de la première image sont toujours des valeurs par défaut qui ne devraient pas être modifiées.
 
tweenableName:String — Nom d'une propriété tweenable, tel que "x" ou "rotation".
 
value:Number — Nouvelle valeur de la propriété tweenable.

Voir aussi





 

M'envoyer un message électronique lorsque des commentaires sont ajoutés à cette page | Rapport de commentaire

Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/fl/motion/Motion.html