Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
fl.motion 

KeyframeBase  - AS3 Flash

Packagefl.motion
Classepublic class KeyframeBase
HéritageKeyframeBase Inheritance Object
Sous-classes Keyframe

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 KeyframeBase définit un état visuel à un instant t d’une interpolation de mouvement. Les principales propriétés des animations sont position, scale, rotation, skew et color. Pour utiliser la classe KeyframeBase, toutes les propriétés doivent avoir des valeurs pour chaque KeyframeBase, et une occurrence KeyframeBase doit être définie pour chaque image du mouvement. Dans une interpolation de mouvement, chaque index de time ne peut avoir qu’une seule image-clé. Une image-clé possède également d’autres propriétés comme blend mode, filters et cacheAsBitmap, qui sont toujours disponibles. Par exemple, une image-clé a toujours une propriété blend mode (mode de fusion).

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
  adjustColorObjects : Dictionary = null
Stocke les occurrences AdjustColor mappées sur leur index correspondant dans le tableau de filtres pour cette image-clé.
KeyframeBase
  blank : Boolean = false
Indique que l’objet cible ne doit pas être affiché sur cette image-clé.
KeyframeBase
  blendMode : String = "normal"
Valeur de la classe BlendMode qui indique comment Flash Player combine les couleurs de l'objet d'affichage et les graphiques de niveau inférieur.
KeyframeBase
  cacheAsBitmap : Boolean = false
Si true est défini, Flash Player place en mémoire cache une version bitmap interne de l’objet d’affichage.
KeyframeBase
  color : Color
Objet Color qui ajuste la transformation de couleur dans l'objet cible.
KeyframeBase
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
  filters : Array
Tableau contenant chaque objet filtre à appliquer à l’objet cible au niveau d’une image-clé particulière.
KeyframeBase
  firstFrame : String
Stocke le nom de la première image des interpolations de mouvement, qui affecte uniquement les symboles graphiques.
KeyframeBase
  index : int
Valeur time unique de l’image-clé dans l’interpolation de mouvement.
KeyframeBase
  label : String
Chaîne utilisée pour décrire l'image-clé.
KeyframeBase
  loop : String
Stocke la valeur de la case à cocher Boucle des interpolations de mouvement, qui affecte uniquement les symboles graphiques.
KeyframeBase
  matrix : Matrix = null
Stocke une propriété matrix lorsqu’il en existe une pour cette image-clé.
KeyframeBase
  matrix3D : Object = null
Stocke une propriété matrix3d lorsqu’il en existe une pour cette image-clé.
KeyframeBase
  opaqueBackground : Object = null
Vérifie si l’objet cible a un arrière-plan opaque.
KeyframeBase
  orientToPath : Boolean = false
Si elle est définie sur true, cette propriété oblige l’objet cible à pivoter automatiquement pour suivre l’angle de sa trajectoire.
KeyframeBase
  rotateDirection : String = "auto"
Contrôle la rotation de l’objet cible pendant une interpolation de mouvement, avec une valeur de la classe RotateDirection.
KeyframeBase
  rotateTimes : uint = 0
Ajoute une rotation à l’objet cible pendant une interpolation de mouvement, en plus de toute rotation existante.
KeyframeBase
  rotation : Number
Indique la rotation de l’objet cible, en degrés à partir de son orientation d’origine, telle qu’elle est appliquée à partir du point de transformation.
KeyframeBase
  rotationConcat : Number = NaN
Valeurs de rotation (axe z) de l’objet cible dans le mouvement par rapport à l’orientation précédente telle qu’appliquées à partir du point de transformation, par opposition aux valeurs de rotation absolues, et distinctes des valeurs skewY.
KeyframeBase
  rotationX : Number = NaN
Stocke la propriété rotationX pour cette image-clé.
KeyframeBase
  rotationY : Number = NaN
Stocke la propriété rotationY pour cette image-clé.
KeyframeBase
  scaleX : Number = NaN
Indique le redimensionnement horizontal (en pourcentage) de l’objet tel qu’il est appliqué à partir du point de transformation.
KeyframeBase
  scaleY : Number = NaN
Indique l’échelle verticale (en pourcentage) de l’objet telle qu’elle est appliquée à partir du point de transformation.
KeyframeBase
  skewX : Number = NaN
Indique l’angle d’inclinaison horizontale de l’objet cible, en degrés, tel qu’il est appliqué à partir du point de transformation.
KeyframeBase
  skewY : Number = NaN
Indique l’angle d’inclinaison verticale de l’objet cible, en degrés, tel qu’il est appliqué à partir du point de transformation.
KeyframeBase
  tweensLength : int
[lecture seule] Nombre d’images de l’interpolation.
KeyframeBase
  useRotationConcat : Boolean = false
Si cette propriété est définie sur true, elle fait pivoter l’objet cible lorsque les données du mouvement sont fournies par addpropertyarray.
KeyframeBase
  visible : Boolean = true
Vérifie si l’objet cible est visible.
KeyframeBase
  x : Number = NaN
Position horizontale du point de transformation de l’objet cible dans l’espace de coordonnées de son parent.
KeyframeBase
  y : Number = NaN
Position verticale du point de transformation de l’objet cible dans l’espace de coordonnées de son parent.
KeyframeBase
  z : Number = NaN
Position en profondeur (axe z) du point de transformation de l’objet cible dans l’espace de coordonnées de son parent.
KeyframeBase
Méthodes publiques
 MéthodeDéfini par
  
KeyframeBase(xml:XML = null)
Constructeur des occurrences de Keyframe.
KeyframeBase
  
affectsTweenable(tweenableName:String = ""):Boolean
Indique si l’image-clé a une influence sur une propriété d’animation spécifique.
KeyframeBase
  
getValue(tweenableName:String):Number
Extrait la valeur d’une propriété particulière pouvant être interpolée sur l’image-clé.
KeyframeBase
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 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
  
setAdjustColorProperty(filterIndex:int, propertyName:String, value:*):void
Définit l’une des quatre propriétés AdjustColor sur l’objet AdjustColor pour l’index de filtre donné.
KeyframeBase
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
  
setValue(tweenableName:String, newValue:Number):void
Change la valeur d’une propriété particulière pouvant être interpolée sur l’image-clé.
KeyframeBase
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 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 de la propriété

adjustColorObjects

propriété
public var adjustColorObjects:Dictionary = 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

Stocke les occurrences AdjustColor mappées sur leur index correspondant dans le tableau de filtres pour cette image-clé. Utilisé pour les filtres AdjustColor de l’outil de création de Flash, correspondant à ColorMatrixFilters dans Flash Player.

blank

propriété 
public var blank:Boolean = false

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

Indique que l’objet cible ne doit pas être affiché sur cette image-clé.

blendMode

propriété 
public var blendMode:String = "normal"

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

Valeur de la classe BlendMode qui indique comment Flash Player combine les couleurs de l'objet d'affichage et les graphiques de niveau inférieur.

Eléments de l’API associés

cacheAsBitmap

propriété 
public var cacheAsBitmap:Boolean = false

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

Si true est défini, Flash Player place en mémoire cache une version bitmap interne de l’objet d’affichage. Cette propriété permet souvent d’obtenir un rendu plus rapide que les vecteurs utilisés par défaut.

color

propriété 
public var color:Color

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

Objet Color qui ajuste la transformation de couleur dans l'objet cible.

filters

propriété 
public var filters: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 contenant chaque objet filtre à appliquer à l’objet cible au niveau d’une image-clé particulière.

firstFrame

propriété 
public var firstFrame:String

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 le nom de la première image des interpolations de mouvement, qui affecte uniquement les symboles graphiques. Cette propriété est utilisée dans la fonctionnalité de copie et de collage de mouvements de Flash CS4, mais n’affecte pas les interpolations de mouvement définies avec ActionScript. Elle est ajoutée ici pour des raisons de compatibilité avec le compilateur de Flex 2.

index

propriété 
index: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

Valeur time unique de l’image-clé dans l’interpolation de mouvement. La première image d’une interpolation de mouvement a un index de 0.



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

label

propriété 
public var label:String

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

Chaîne utilisée pour décrire l'image-clé.

loop

propriété 
public var loop:String

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 la valeur de la case à cocher Boucle des interpolations de mouvement, qui affecte uniquement les symboles graphiques. Cette propriété est utilisée dans la fonctionnalité de copie et de collage de mouvements de Flash CS4, mais n’affecte pas les interpolations de mouvement définies avec ActionScript. Elle est ajoutée ici pour des raisons de compatibilité avec le compilateur de Flex 2.

matrix

propriété 
public var matrix:Matrix = null

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

Stocke une propriété matrix lorsqu’il en existe une pour cette image-clé. La propriété matrix est utilisée pour les images sans interpolation ne contenant pas d’éléments 3D. Vous pouvez utiliser la propriété matrix ou les autres propriétés de position et de mise à l’échelle (x, y, scaleX, scaleY, etc.), mais ne pouvez pas les définir en même temps. Si la propriété matrix est définie sur une valeur autre que null, elle est utilisée à la place de toute autre propriété (propriétés 3D incluses).

matrix3D

propriété 
public var matrix3D:Object = null

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

Stocke une propriété matrix3d lorsqu’il en existe une pour cette image-clé. La propriété matrix3d est utilisée pour les images sans interpolation contenant de la 3D. Vous pouvez utiliser la propriété matrix3d ou les autres propriétés 3D (z, rotationX, rotationY), mais pas les définir en même temps. Si la propriété matrix3d est définie sur autre chose que null, elle est utilisée à la place de tout autre propriété (propriétés 2D incluses).

opaqueBackground

propriété 
public var opaqueBackground:Object = null

Version du langage: ActionScript 3.0
Version du produit: Flash CS5.5
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Vérifie si l’objet cible a un arrière-plan opaque. Cette valeur est un nombre décrivant la couleur sous la forme 0xrrggb, ou null si aucun arrière-plan opaque n’est défini.

orientToPath

propriété 
public var orientToPath:Boolean = false

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

Si elle est définie sur true, cette propriété oblige l’objet cible à pivoter automatiquement pour suivre l’angle de sa trajectoire.

rotateDirection

propriété 
public var rotateDirection:String = "auto"

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 rotation de l’objet cible pendant une interpolation de mouvement, avec une valeur de la classe RotateDirection.

Eléments de l’API associés

rotateTimes

propriété 
public var rotateTimes:uint = 0

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 une rotation à l’objet cible pendant une interpolation de mouvement, en plus de toute rotation existante. Cette rotation dépend de la valeur de la propriété rotateDirection, qui doit être définie sur RotateDirection.CW ou RotateDirection.CCW . La valeur de rotateTimes doit être un entier supérieur ou égal à zéro.

Par exemple, si l’objet effectue normalement une rotation de 0 à 40 degrés, définir rotateTimes sur 1 et rotateDirection sur RotateDirection.CW ajoutera un tour complet, pour une rotation totale de 400 degrés.

Si rotateDirection est défini sur RotateDirection.CCW, 360 degrés seront soustraient de la rotation normale, provoquant un tour de 320 degrés dans le sens inverse des aiguilles d’une montre.

Eléments de l’API associés

rotation

propriété 
rotation: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

Indique la rotation de l’objet cible, en degrés à partir de son orientation d’origine, telle qu’elle est appliquée à partir du point de transformation. Une valeur de NaN signifie que l’image-clé n’affecte pas cette propriété.



Implémentation
    public function get rotation():Number
    public function set rotation(value:Number):void

rotationConcat

propriété 
public var rotationConcat:Number = NaN

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

Valeurs de rotation (axe z) de l’objet cible dans le mouvement par rapport à l’orientation précédente telle qu’appliquées à partir du point de transformation, par opposition aux valeurs de rotation absolues, et distinctes des valeurs skewY.

rotationX

propriété 
public var rotationX:Number = NaN

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 la propriété rotationX pour cette image-clé. Cette propriété correspond à la rotation de l’objet cible autour de l’axe x à partir de son orientation d’origine.

rotationY

propriété 
public var rotationY:Number = NaN

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 la propriété rotationY pour cette image-clé. Cette propriété correspond à la rotation de l’objet cible autour de l’axe y à partir de son orientation d’origine.

scaleX

propriété 
public var scaleX:Number = NaN

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

Indique le redimensionnement horizontal (en pourcentage) de l’objet tel qu’il est appliqué à partir du point de transformation. La valeur 1 représente 100 % de la taille normale. Une valeur de NaN signifie que l’image-clé n’affecte pas cette propriété.

scaleY

propriété 
public var scaleY:Number = NaN

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

Indique l’échelle verticale (en pourcentage) de l’objet telle qu’elle est appliquée à partir du point de transformation. La valeur 1 représente 100 % de la taille normale. Une valeur de NaN signifie que l’image-clé n’affecte pas cette propriété.

skewX

propriété 
public var skewX:Number = NaN

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

Indique l’angle d’inclinaison horizontale de l’objet cible, en degrés, tel qu’il est appliqué à partir du point de transformation. Une valeur de NaN signifie que l’image-clé n’affecte pas cette propriété.

skewY

propriété 
public var skewY:Number = NaN

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

Indique l’angle d’inclinaison verticale de l’objet cible, en degrés, tel qu’il est appliqué à partir du point de transformation. Une valeur de NaN signifie que l’image-clé n’affecte pas cette propriété.

tweensLength

propriété 
tweensLength:int  [lecture seule]

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

Nombre d’images de l’interpolation.



Implémentation
    public function get tweensLength():int

useRotationConcat

propriété 
public var useRotationConcat:Boolean = false

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

Si cette propriété est définie sur true, elle fait pivoter l’objet cible lorsque les données du mouvement sont fournies par addpropertyarray. De même, lorsque cette propriété est true, la propriété rotationConcat est utilisée à la place de rotation. La valeur par défaut est false.

visible

propriété 
public var visible:Boolean = true

Version du langage: ActionScript 3.0
Version du produit: Flash CS5.5
Versions du moteur d’exécution: Flash Player 9.0.28.0, AIR 1.0

Vérifie si l’objet cible est visible.

x

propriété 
public var x:Number = NaN

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

Position horizontale du point de transformation de l’objet cible dans l’espace de coordonnées de son parent. Une valeur de NaN signifie que l’image-clé n’affecte pas cette propriété.

y

propriété 
public var y:Number = NaN

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

Position verticale du point de transformation de l’objet cible dans l’espace de coordonnées de son parent. Une valeur de NaN signifie que l’image-clé n’affecte pas cette propriété.

z

propriété 
public var z:Number = NaN

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

Position en profondeur (axe z) du point de transformation de l’objet cible dans l’espace de coordonnées de son parent. Dans le cas d’un plan 3D, l’axe z fait référence à la profondeur d’un objet 3D. Une valeur de NaN signifie que l’image-clé n’affecte pas cette propriété.

Détails du constructeur

KeyframeBase

()Constructeur
public function KeyframeBase(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 des occurrences de Keyframe.

Paramètres
xml:XML (default = null) — Objet XML E4X facultatif et définissant une image-clé au format XML Motion.
Détails de la méthode

affectsTweenable

()méthode
public function affectsTweenable(tweenableName:String = ""):Boolean

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

Indique si l’image-clé a une influence sur une propriété d’animation spécifique.

Paramètres

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

Valeur renvoyée
Boolean

getValue

()méthode 
public function getValue(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

Extrait la valeur d’une propriété particulière pouvant être interpolée sur l’image-clé.

Paramètres

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

Valeur renvoyée
Number — Valeur numérique de la propriété tweenable.

setAdjustColorProperty

()méthode 
public function setAdjustColorProperty(filterIndex:int, propertyName:String, value:*):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 l’une des quatre propriétés AdjustColor sur l’objet AdjustColor pour l’index de filtre donné. L’occurrence AdjustColor est créée lorsqu’elle n’existe pas encore pour cet index. Les quatre propriétés qui peuvent être définies sont :

  • adjustColorBrightness
  • adjustColorContrast
  • adjustColorSaturation
  • adjustColorHue
Pour que le filtre soit créé, les quatre propriétés AdjustColor doivent être définies. Dès que les quatre propriétés sont définies sur une occurrence AdjustColor, la fonction obtient de l’objet AdjustColor un tableau plat de 20 valeurs représentant les quatre propriétés, et crée une occurrence ColorMatrixFilter, qui a besoin du tableau plat.

Paramètres

filterIndex:int — Position d’index du filtre dans le tableau de filtres à laquelle ajouter la propriété propertyName.
 
propertyName:String — L’une des quatre valeurs de propriétés autorisées : "adjustColorBrightness", "adjustColorContrast", "adjustColorSaturation" ou "adjustColorHue".
 
value:* — Valeur à définir pour la propriété spécifiée.

Plus d’exemples

Eléments de l’API associés

setValue

()méthode 
public function setValue(tweenableName:String, newValue: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

Change la valeur d’une propriété particulière pouvant être interpolée sur l’image-clé.

Paramètres

tweenableName:String — Nom d’une propriété interpolable, tel que "x" ou "rotation".
 
newValue:Number — Valeur numérique à attribuer à la propriété interpolable.





[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.