spark.filtersGradientBevelFilter La classe GradientBevelFilter permet d’appliquer un effet de biseau en dégradé à des objets d’affichage.The <s:GradientBevelFilter> tag inherits all of the tag attributes of its superclass and adds no tag attributes:

  <s:GradientBevelFilter/>
  
]]>
mx.filters:IBitmapFilterspark.filters:GradientFilter La classe GradientBevelFilter permet d’appliquer un effet de biseau en dégradé à des objets d’affichage. Un biseau en dégradé est une bordure biseautée, enrichie par des couleurs dégradées à l’extérieur, à l’intérieur ou au-dessus d’un objet. Les bordures biseautées donnent un aspect tridimensionnel aux objets. Vous pouvez appliquer le filtre à tout objet d’affichage (autrement dit, aux objets héritant des propriétés de la classe DisplayObject), tels que MovieClip, SimpleButton, TextField et Video, ainsi qu’aux objets BitmapData.

L’utilisation de filtres dépend de l’objet auquel vous appliquez le filtre.

  • Pour appliquer des filtres aux objets d’affichage, utilisez la propriété filters. Lorsque vous définissez la propriété filters d’un objet, celui-ci n’est pas modifié. En outre, vous pouvez supprimer la propriété filters pour enlever le filtre.
  • Pour appliquer des filtres aux objets BitmapData, utilisez la méthode BitmapData.applyFilter(). L’appel de applyFilter() pour un objet BitmapData génère une image filtrée à partir de l’objet BitmapData source et de l’objet filtre.

Si vous appliquez un filtre à un objet d’affichage, la propriété cacheAsBitmap de cet objet est réglée sur true. Si vous supprimez tous les filtres, la valeur d’origine de cacheAsBitmap est restaurée.

Ce filtre prend en charge le redimensionnement de la scène. Toutefois, le redimensionnement général, la rotation et l’inclinaison ne sont pas pris en charge. Si l’objet est lui-même redimensionné (si les propriétés scaleX et scaleY ne sont pas réglées sur 1,0), l’effet de filtre n’est pas redimensionné. Le redimensionnement est effectué uniquement en cas de zoom avant sur la scène.

Aucun filtre n’est appliqué si l’image obtenue dépasse les dimensions maximales. Dans AIR 1.5 et Flash Player 10, la taille maximale est de 8 191 pixels en largeur ou en hauteur, et le nombre total de pixels ne peut pas excéder 16 777 215 pixels (ainsi, si la largeur d’une image est de 8 191 pixels, sa hauteur maximale doit être de 2 048 pixels). Par exemple, lorsque vous effectuez un zoom avant sur un clip de grande taille auquel un filtre est appliqué, le filtre sera désactivé si l’image obtenue dépasse les dimensions maximales.

spark.filters.BevelFilterflash.filters.GradientBevelFilterGradientBevelFilter.ratiosflash.display.BitmapData.applyFilter()flash.display.DisplayObject.filtersflash.display.DisplayObject.cacheAsBitmapGradientBevelFilter Constructeur.distance4.0La distance de décalage. Les valeurs valides sont comprises entre 0 et 8. angle45Angle, exprimé en degrés. Les valeurs valides sont comprises entre 0 et 360. colorsnullTableau de valeurs hexadécimales de couleur RVB à utiliser pour le dégradé. Par exemple, rouge correspond à 0xFF0000, bleu à 0x0000FF, etc. alphasnullTableau de valeurs de transparence alpha pour les couleurs correspondantes du tableau colors. Les valeurs valides pour chaque élément du tableau sont comprises entre 0 et 1. Par exemple, 0,25 définit une valeur de transparence de 25 %. ratiosnullTableau de taux de distribution des couleurs ; les valeurs possibles sont comprises entre 0 et 255. blurX4.0Quantité de flou horizontal. Les valeurs valides sont comprises entre 0 et 255. Un flou d’une valeur inférieure ou égale à 1 signifie que l’image d’origine n’est pas modifiée avant d’être copiée. La valeur par défaut est 4. Les valeurs correspondant à une puissance de 2 (telles que 2, 4, 8, 16 et 32) sont optimisées pour obtenir un rendu plus rapide qu’avec les autres valeurs. blurY4.0Quantité de flou vertical. Les valeurs valides sont comprises entre 0 et 255. Un flou d’une valeur inférieure ou égale à 1 signifie que l’image d’origine n’est pas modifiée avant d’être copiée. Les valeurs correspondant à une puissance de 2 (telles que 2, 4, 8, 16 et 32) sont optimisées pour obtenir un rendu plus rapide qu’avec les autres valeurs. strength1Intensité de l’empreinte ou recouvrement. Plus la valeur est élevée, plus le recouvrement est intense et plus le contraste est important entre le biseau et l’arrière-plan. Les valeurs valides sont comprises entre 0 et 255. La valeur 0 signifie que le filtre n’est pas appliqué. quality1La qualité du filtre. Utilisez les constantes BitmapFilterQuality :
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

Pour plus d’informations, voir la description de la propriété quality.

typeinnerPositionnement de l’effet biseau. Les valeurs possibles sont les constantes BitmapFilterType :
  • BitmapFilterType.OUTER, biseau sur le bord extérieur de l’objet.
  • BitmapFilterType.INNER, biseau sur le bord intérieur de l’objet.
  • BitmapFilterType.FULL, biseau sur le dessus de l’objet.
knockoutfalseSpécifie si un effet de masquage est appliqué. La valeur true applique un effet de masquage qui rend le remplissage de l’objet transparent et révèle la couleur d’arrière-plan du document.
Constructeur.
clone Renvoie une copie de cet objet filtre.Nouvelle occurrence de GradientBevelFilter dont toutes les propriétés sont identiques à celles de l’occurrence de GradientBevelFilter d’origine. Renvoie une copie de cet objet filtre.
DropShadowFilter La classe DropShadowFilter permet d’ajouter un effet d’ombre portée aux objets d’affichage.The <s:DropShadowFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:DropShadowFilter 
    Properties
    alpha="1"
    angle="45"
    color="0xFF0000"
    distance="4"
    hideObject="false"
    inner="false"
  />
  
]]>
mx.filters:IBitmapFiltermx.filters:BaseDimensionFilter La classe DropShadowFilter permet d’ajouter un effet d’ombre portée aux objets d’affichage. L’algorithme d’ombre est dérivé du même filtre que celui utilisé par le filtre de flou. Vous disposez de plusieurs options pour définir le style de l’ombre portée, notamment l’ombre intérieure ou extérieure et le mode de masquage. Vous pouvez appliquer le filtre à tout objet d’affichage (autrement dit, aux objets héritant des propriétés de la classe DisplayObject), tels que MovieClip, SimpleButton, TextField et Video, ainsi qu’aux objets BitmapData.

L’utilisation de filtres dépend de l’objet auquel vous appliquez le filtre.

  • Pour appliquer des filtres aux objets d’affichage, utilisez la propriété filters (héritée de DisplayObject). Lorsque vous définissez la propriété filters d’un objet, celui-ci n’est pas modifié. En outre, vous pouvez supprimer la propriété filters pour enlever le filtre.
  • Pour appliquer des filtres aux objets BitmapData, utilisez la méthode BitmapData.applyFilter(). L’appel de applyFilter() pour un objet BitmapData génère une image filtrée à partir de l’objet BitmapData source et de l’objet filtre.

Si vous appliquez un filtre à un objet d’affichage, la valeur de la propriété cacheAsBitmap de cet objet est définie sur true. Si vous supprimez tous les filtres, la valeur d’origine de cacheAsBitmap est restaurée.

Ce filtre prend en charge le redimensionnement de la scène. Cependant, il ne prend pas en charge le redimensionnement général, la rotation ni l’inclinaison. Si l’objet est redimensionné (si les propriétés scaleX et scaleY ne sont pas réglées sur 1,0), le filtre ne l’est pas. Le redimensionnement est effectué uniquement en cas de zoom avant sur la scène.

Aucun filtre n’est appliqué si l’image obtenue dépasse les dimensions maximales. Dans AIR 1.5 et Flash Player 10, la taille maximale est de 8 191 pixels en largeur ou en hauteur, et le nombre total de pixels ne peut pas excéder 16 777 215 pixels (ainsi, si la largeur d’une image est de 8 191 pixels, sa hauteur maximale doit être de 2 048 pixels). Par exemple, si vous effectuez un zoom avant sur un clip de grande taille auquel un filtre est appliqué, le filtre sera désactivé si l’image obtenue dépasse les dimensions maximales.

flash.filters.DropShadowFilterDropShadowFilter Constructeur.distance4.0Distance de décalage de l’ombre, en pixels. angle45Angle de l’ombre, de 0 à 360° (virgule flottante). color0Couleur de l’ombre, au format hexadécimal 0xRRGGBB. La valeur par défaut est 0x000000. alpha1.0Valeur de transparence alpha de la couleur d’ombre. Les valeurs valides sont comprises entre 0.0 et 1.0. Par exemple, 0,25 définit une valeur de transparence de 25 %. blurX4.0Quantité de flou horizontal. Les valeurs possibles sont comprises entre 0 et 255.0 (virgule flottante). blurY4.0Quantité de flou vertical. Les valeurs possibles sont comprises entre 0 et 255.0 (virgule flottante). strength1.0Intensité de l’empreinte ou recouvrement. Plus la valeur est élevée, plus le recouvrement est intense et plus le contraste est important entre l’ombre et l’arrière-plan. Les valeurs possibles sont comprises entre 0 et 255.0. quality1Nombre d’applications du filtre. Utilisez les constantes BitmapFilterQuality :
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

Pour plus d’informations sur ces valeurs, voir la description de la propriété quality.

innerfalseIndique si l’ombre est intérieure ou non. La valeur true spécifie une ombre intérieure. La valeur false renvoie une ombre extérieure au niveau des bords extérieurs de l’objet. knockoutfalseApplique un effet de masquage (true) qui, en réalité, rend le remplissage de l’objet transparent et révèle la couleur d’arrière-plan du document. hideObjectfalseIndique si l’objet est caché ou non. La valeur true indique que l’objet lui-même n’est pas tracé et que seule l’ombre est visible.
Constructeur.
flash.filters.BitmapFilterQuality
clone Renvoie une copie de cet objet filtre.Nouvelle occurrence de DropShadowFilter dont les propriétés sont toutes identiques à celles de l’occurrence de DropShadowFilter d’origine. Renvoie une copie de cet objet filtre. alpha Valeur de transparence alpha de la couleur.1 Valeur de transparence alpha de la couleur. Les valeurs possibles sont comprises entre 0 et 1. Par exemple, 0,25 définit une valeur de transparence de 25 %. angle Angle du biseau.45 Angle du biseau. Les valeurs possibles sont comprises entre 0 et 360°. La valeur d’angle représente l’angle de la source lumineuse théorique éclairant l’objet et détermine l’emplacement de l’effet par rapport à ce dernier. Si la valeur de la propriété distance est définie sur 0, il n’y a pas d’effet de décalage par rapport à l’objet. La propriété angle n’a donc aucun effet. color Couleur du rayonnement.0xFF0000 Couleur du rayonnement. Les valeurs disponibles sont au format hexadécimal 0xRRGGBB. distance La distance de décalage du biseau.4 La distance de décalage du biseau. Les valeurs possibles sont en pixels (virgule flottante). hideObject Indique si l’objet est caché ou non.false Indique si l’objet est caché ou non. Une valeur true indique que l’objet lui-même n’est pas tracé et que seule l’ombre est visible. La valeur par défaut est false, soit montrer l’objet. inner Spécifie si le rayonnement est interne.false Spécifie si le rayonnement est interne. La valeur true indique un rayonnement interne. La valeur par défaut est false, créant un rayonnement externe (au niveau des bords extérieurs de l’objet).
ConvolutionFilter La classe ConvolutionFilter applique un effet de filtre de convolution de matrice.The <s:ConvolutionFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

 <s:ConvolutionFilter 
   Properties
   alpha="1"
   clamp="true"
   color="0xFF0000"
   divisor="1.0"
   matrix="[]"
   matrixX="0"
   matrixY="0"
   preserveAlpha="true"
 />
 
]]>
mx.filters:IBitmapFiltermx.filters:BaseFilter La classe ConvolutionFilter applique un effet de filtre de convolution de matrice. Une convolution associe les pixels de l’image d’entrée aux pixels environnants pour produire une image. Les convolutions permettent de produire de nombreux effets d’image, notamment le flou, la détection de contour, l’accentuation, l’estampage et le biseautage. Vous pouvez appliquer le filtre à tout objet d’affichage (autrement dit, aux objets héritant des propriétés de la classe DisplayObject), tels que MovieClip, SimpleButton, TextField et Video, ainsi qu’aux objets BitmapData.

Pour créer un filtre de convolution, utilisez la syntaxe new ConvolutionFilter(). L’utilisation de filtres dépend de l’objet auquel vous appliquez le filtre.

  • Pour appliquer des filtres aux clips, champs de texte, boutons et vidéo, utilisez la propriété filters (héritée de DisplayObject). Lorsque vous définissez la propriété filters d’un objet, celui-ci n’est pas modifié. En outre, vous pouvez supprimer la propriété filters pour enlever le filtre.
  • Pour appliquer des filtres aux objets BitmapData, utilisez la méthode BitmapData.applyFilter(). L’appel de applyFilter() pour un objet BitmapData génère une image filtrée à partir de l’objet BitmapData source et de l’objet filtre.

Si vous appliquez un filtre à un objet d’affichage, la valeur de la propriété cacheAsBitmap de cet objet est définie sur true. Si vous supprimez tous les filtres, la valeur d’origine de cacheAsBitmap est restaurée.

Aucun filtre n’est appliqué si l’image obtenue dépasse les dimensions maximales. Dans AIR 1.5 et Flash Player 10, la taille maximale est de 8 191 pixels en largeur ou en hauteur, et le nombre total de pixels ne peut pas excéder 16 777 215 pixels (ainsi, si la largeur d’une image est de 8 191 pixels, sa hauteur maximale doit être de 2 048 pixels). Par exemple, lorsque vous effectuez un zoom avant sur un clip de grande taille auquel un filtre est appliqué, le filtre sera désactivé si l’image obtenue dépasse les dimensions maximales.

ConvolutionFilter Constructeur.matrixX0Dimension x de la matrice (nombre de colonnes de la matrice). La valeur par défaut est 0. matrixY0Dimension y de la matrice (nombre de lignes de la matrice). La valeur par défaut est 0. matrixnullTableau des valeurs utilisées pour la transformation de matrice. Le nombre d’éléments dans le tableau doit être égal à matrixX ~~ matrixY. divisor1.0Diviseur utilisé pendant la transformation de matrice. La valeur par défaut est 1. Un diviseur correspondant à la somme de toutes les valeurs de matrice atténue l’intensité de couleurs globale du résultat. La valeur 0 est ignorée ; elle est remplacée par la valeur par défaut. bias0.0Ecart à ajouter au résultat de la transformation de matrice. La valeur par défaut est 0. preserveAlphatrueLa valeur false indique que la valeur alpha n’est pas conservée et que la convolution s’applique à tous les canaux, y compris le canal alpha. La valeur true indique que la convolution s’applique uniquement aux canaux de couleur. La valeur par défaut est true. clamptruePour les pixels provenant de l’image source, la valeur true indique que l’image d’entrée est agrandie autant que nécessaire au niveau de ses bordures en dupliquant les valeurs de couleur sur le bord donné. La valeur false indique qu’il faut utiliser une autre couleur, comme spécifié dans les propriétés color et alpha. La valeur par défaut est true. color0Couleur hexadécimale à substituer aux pixels provenant de l’image source. alpha0.0Alpha de la couleur de substitution. Constructeur. clone Renvoie une copie de cet objet filtre.BitmapFilter Nouvelle occurrence de ConvolutionFilter dont les propriétés sont toutes identiques à celles de l’occurrence de ConvolutionMatrixFilter d’origine. Renvoie une copie de cet objet filtre. alpha Valeur de transparence alpha de la couleur.1 Valeur de transparence alpha de la couleur. Les valeurs possibles sont comprises entre 0 et 1. Par exemple, 0,25 définit une valeur de transparence de 25 %. bias Ecart à ajouter au résultat de la transformation de matrice.0 Ecart à ajouter au résultat de la transformation de matrice. L’écart augmente la valeur de couleur de chaque canal de telle sorte que les couleurs sombres paraissent plus vives. clamp Indique si l’image doit être corrigée.true Indique si l’image doit être corrigée. Pour les pixels provenant de l’image source, la valeur true indique que l’image d’entrée est agrandie autant que nécessaire au niveau de ses bordures en dupliquant les valeurs de couleur de chacun de ses bords respectifs. La valeur false indique qu’il faut utiliser une autre couleur, comme spécifié dans les propriétés color et alpha. color Couleur du rayonnement.0xFF0000 Couleur du rayonnement. Les valeurs disponibles sont au format hexadécimal 0xRRGGBB. divisor Diviseur utilisé pendant la transformation de matrice.1.0 Diviseur utilisé pendant la transformation de matrice. La valeur par défaut est 1. Un diviseur correspondant à la somme de toutes les valeurs de matrice atténue l’intensité globale des couleurs du résultat. La valeur 0 est ignorée ; elle est remplacée par la valeur par défaut. matrixX Dimension x de la matrice (le nombre de lignes de la matrice).0 Dimension x de la matrice (le nombre de lignes de la matrice). matrixY Dimension y de la matrice (nombre de colonnes de la matrice).0 Dimension y de la matrice (nombre de colonnes de la matrice). matrix Quantité de flou horizontal.[] Quantité de flou horizontal. Les valeurs valides sont comprises entre 0 et 255. Un flou d’une valeur inférieure ou égale à 1 signifie que l’image d’origine n’est pas modifiée avant d’être copiée. La valeur par défaut est 4. Les valeurs correspondant à une puissance de 2 (telles que 2, 4, 8, 16 et 32) sont optimisées pour obtenir un rendu plus rapide qu’avec les autres valeurs. preserveAlpha Indique si le canal alpha est conservé ou si le filtre de convolution s’applique aussi bien à lui qu’aux canaux de couleur.true Indique si le canal alpha est conservé ou si le filtre de convolution s’applique aussi bien à lui qu’aux canaux de couleur. La valeur false indique que la convolution s’applique à tous les canaux, y compris le canal alpha. La valeur true indique que la convolution s’applique uniquement aux canaux de couleur.
BlurFilter La classe BlurFilter permet d’appliquer un effet visuel de flou aux objets d’affichage.The <s:BlurFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:BlurFilter
    Properties
    blurX="4.0"
    blurY="4.0"
    quality="low"
  />
  
]]>
mx.filters:IBitmapFiltermx.filters:BaseFilter La classe BlurFilter permet d’appliquer un effet visuel de flou aux objets d’affichage. Un effet de flou adoucit les détails d’une image. Vous pouvez produire différents flous, d’un aspect doux et sans contours précis, à un flou gaussien dont l’aspect voilé produit le même effet que celui d’une image regardée à travers un verre semi-opaque. Quand la propriété quality de ce filtre est réglée sur faible, vous obtenez un aspect doux sans contours précis. Quand la propriété quality est élevée, l’effet se rapproche d’un filtre de flou gaussien. Vous pouvez appliquer le filtre à tout objet d’affichage (autrement dit, aux objets héritant des propriétés de la classe DisplayObject), tels que MovieClip, SimpleButton, TextField et Video, ainsi qu’aux objets BitmapData.

Pour créer un nouveau filtre, utilisez le constructeur new BlurFilter(). L’utilisation de filtres dépend de l’objet auquel vous appliquez le filtre.

  • Pour appliquer des filtres aux clips, champs de texte, boutons et vidéo, utilisez la propriété filters (héritée de DisplayObject). Lorsque vous définissez la propriété filters d’un objet, celui-ci n’est pas modifié. En outre, vous pouvez supprimer la propriété filters pour enlever le filtre.
  • Pour appliquer des filtres aux objets BitmapData, utilisez la méthode BitmapData.applyFilter(). L’appel de applyFilter() pour un objet BitmapData génère une image filtrée à partir de l’objet BitmapData source et de l’objet filtre.

Si vous appliquez un filtre à un objet d’affichage, la propriété cacheAsBitmap de cet objet est réglée sur true. Si vous supprimez tous les filtres, la valeur d’origine de cacheAsBitmap est restaurée.

Ce filtre prend en charge le redimensionnement de la scène. Cependant, il ne prend pas en charge le redimensionnement général, la rotation ni l’inclinaison. Si l’objet lui-même est redimensionné (les propriétés scaleX et scaleY ne sont pas réglées sur 100 %), l’effet de filtre n’est pas redimensionné. Le redimensionnement est effectué uniquement en cas de zoom avant sur la scène.

Aucun filtre n’est appliqué si l’image obtenue dépasse les dimensions maximales. Dans AIR 1.5 et Flash Player 10, la taille maximale est de 8 191 pixels en largeur ou en hauteur, et le nombre total de pixels ne peut pas excéder 16 777 215 pixels (ainsi, si la largeur d’une image est de 8 191 pixels, sa hauteur maximale doit être de 2 048 pixels). Par exemple, si vous effectuez un zoom avant sur un clip de grande taille auquel un filtre est appliqué, le filtre sera désactivé si l’image obtenue dépasse les dimensions maximales.

flash.filters.BlurFilterflash.display.DisplayObject.filtersflash.display.DisplayObject.cacheAsBitmapflash.display.BitmapData.applyFilter()BlurFilter Constructeur.blurX4.0Quantité de flou à appliquer horizontalement. Les valeurs possibles sont comprises entre 0 et 255,0 (valeur en virgule flottante). blurY4.0Quantité de flou à appliquer verticalement. Les valeurs possibles sont comprises entre 0 et 255,0 (valeur en virgule flottante). quality1Nombre d’applications du filtre. Vous pouvez définir la qualité à l’aide des constantes flash.filters.BitmapFilterQuality :
  • flash.filters.BitmapFilterQuality.LOW
  • flash.filters.BitmapFilterQuality.MEDIUM
  • flash.filters.BitmapFilterQuality.HIGH

La qualité supérieure se rapproche d’un flou gaussien. Dans la plupart des cas, ces trois valeurs sont suffisantes. Il est possible d’utiliser des valeurs numériques allant jusqu’à 15 pour obtenir différents effets, mais le rendu des valeurs les plus élevées est moins rapide.

Initialise le filtre.
Constructeur. Les valeurs par défaut créent une image floue sans contours précis.
clone Renvoie une copie de cet objet filtre.Nouvelle occurrence de BlurFilter dont toutes les propriétés sont identiques à celles de l’occurrence BlurFilter d’origine. Renvoie une copie de cet objet filtre. blurX Quantité de flou horizontal.4.0 Quantité de flou horizontal. Les valeurs valides sont comprises entre 0 et 255. Un flou d’une valeur inférieure ou égale à 1 signifie que l’image d’origine n’est pas modifiée avant d’être copiée. La valeur par défaut est 4. Les valeurs correspondant à une puissance de 2 (telles que 2, 4, 8, 16 et 32) sont optimisées pour obtenir un rendu plus rapide qu’avec les autres valeurs. blurY Quantité de flou vertical.4.0 Quantité de flou vertical. Les valeurs valides sont comprises entre 0 et 255. Un flou d’une valeur inférieure ou égale à 1 signifie que l’image d’origine n’est pas modifiée avant d’être copiée. La valeur par défaut est 4. Les valeurs correspondant à une puissance de 2 (telles que 2, 4, 8, 16 et 32) sont optimisées pour obtenir un rendu plus rapide qu’avec les autres valeurs. quality Nombre d’applications du filtre."low" Nombre d’applications du filtre. La valeur par défaut est BitmapFilterQuality.LOW, ce qui revient à appliquer le filtre une seule fois. La valeur BitmapFilterQuality.MEDIUM applique le filtre deux fois. La valeur BitmapFilterQuality.HIGH l’applique trois fois. Les rendus des filtres de valeurs faibles sont obtenus plus rapidement.

Pour la plupart des applications, une valeur de qualité faible, moyenne ou élevée est suffisante. Il est possible d’utiliser des valeurs numériques allant jusqu’à 15 pour obtenir différents effets, mais le rendu des valeurs les plus élevées est moins rapide. Sans augmenter la valeur de quality, vous pouvez généralement obtenir un effet similaire, avec un rendu plus rapide, en augmentant simplement les valeurs des propriétés blurX et blurY.

ColorMatrixFilter La classe ColorMatrixFilter vous permet d’appliquer une transformation de matrice 4 x 5 aux valeurs de couleur RVBA et alpha de chaque pixel de l’image d’entrée afin d’obtenir un résultat intégrant un nouvel ensemble de valeurs de couleur RVBA et alpha. The <s:ColorMatrixFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:ColorMatrixFilter
    Properties
    matrix="[1,0,0,0,0,0,1,0,0,0,0,0,1,0,0,0,0,0,1,0]"
  />
  
]]>
mx.filters:IBitmapFiltermx.filters:BaseFilter La classe ColorMatrixFilter vous permet d’appliquer une transformation de matrice 4 x 5 aux valeurs de couleur RVBA et alpha de chaque pixel de l’image d’entrée afin d’obtenir un résultat intégrant un nouvel ensemble de valeurs de couleur RVBA et alpha. Cette classe permet d’effectuer des modifications de saturation et des rotations de teinte, de définir la luminance de l’alpha et de produire d’autres effets. Vous pouvez appliquer le filtre à tout objet d’affichage (autrement dit, aux objets héritant des propriétés de la classe DisplayObject), tels que MovieClip, SimpleButton, TextField et Video, ainsi qu’aux objets BitmapData. flash.filters.ColorMatrixFilterColorMatrixFilter Constructeur.matrixnullTableau de 20 éléments organisés en matrice de 4 x 5. Initialise une nouvelle occurrence ColorMatrixFilter. Constructeur. clone Renvoie une copie de cet objet filtre.Nouvelle occurrence de ColorMatrixFilter dont les propriétés sont toutes identiques à celles de l’occurrence d’origine. Renvoie une copie de cet objet filtre. matrix Liste séparée par des virgules de 20 doubles qui constitue une matrice 4x5 appliquée à l’élément rendu. [1,0,0,0,0,0,1,0,0,0,0,0,1,0,0,0,0,0,1,0] Liste séparée par des virgules de 20 doubles qui constitue une matrice 4x5 appliquée à l’élément rendu. La matrice se trouve dans l’ordre de ligne « major » -- en d’autres termes, les cinq premiers éléments sont multipliés par le vecteur [srcR,srcG,srcB,srcA,1] pour déterminer la valeur red de sortie, les cinq seconds éléments déterminent la valeur green de sortie, etc.

La valeur doit être un tableau ou une chaîne délimitée par des virgules de 20 nombres.

GradientFilter La classe de base pour les filtres qui fournissent des effets visuels dégradés. The <s:GradientFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:GradientFilter
    Properties
    angle="45"
    distance="4.0"
    entries="[]"
    type="inner"
  />
  
]]>
mx.filters:BaseDimensionFilter La classe de base pour les filtres qui fournissent des effets visuels dégradés. spark.filters.GradientGlowFilterspark.filters.GradientBevelFilterGradientFilter Constructeur.colorsnullTableau de valeurs hexadécimales de couleur RVB à utiliser pour le dégradé. Par exemple, rouge correspond à 0xFF0000, bleu à 0x0000FF, etc. alphasnullTableau de valeurs de transparence alpha pour les couleurs correspondantes du tableau colors. Les valeurs valides pour chaque élément du tableau sont comprises entre 0 et 1. Par exemple, 0,25 définit une valeur de transparence de 25 %. ratiosnullTableau de taux de distribution des couleurs ; les valeurs possibles sont comprises entre 0 et 255. Constructeur. angle Angle, exprimé en degrés.45 Angle, exprimé en degrés. Les valeurs possibles sont comprises entre 0 et 360. La valeur d’angle représente l’angle de la source lumineuse théorique éclairant l’objet et détermine l’emplacement de l’effet par rapport à ce dernier. Si la valeur de distance est 0, il n’y a pas d’effet de décalage par rapport à l’objet. La propriété angle n’a donc aucun effet. distance Distance de décalage du rayonnement.4.0 Distance de décalage du rayonnement. entries Un tableau d’objets GradientEntry définissant les motifs de remplissage en dégradé. [] Tableau d’objets GradientEntry définissant les motifs de remplissage en dégradé. type Positionnement de l’effet de filtre.BitmapFilterType.INNER Positionnement de l’effet de filtre. Les valeurs possibles sont les constantes flash.filters.BitmapFilterType :
  • BitmapFilterType.OUTER, rayonnement sur le bord extérieur de l’objet.
  • BitmapFilterType.INNER, biseau sur le bord intérieur de l’objet.
  • BitmapFilterType.FULL, rayonnement au-dessus de l’objet.
flash.filters.BitmapFilterType
BevelFilter La classe BevelFilter permet d’appliquer un effet de biseau à des objets d’affichage.The <s:BevelFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:BevelFilter 
    Properties
    angle="45"
    distance="4"
    highlightAlpha="1"
    highlightColor="0xFFFFFF"
    shadowAlpha="1"
    shadowColor="0x000000"
    type="inner"
  />
  
]]>
mx.filters:IBitmapFiltermx.filters:BaseDimensionFilter La classe BevelFilter permet d’appliquer un effet de biseau à des objets d’affichage. L’effet de biseau donne aux objets tels que des boutons un aspect tridimensionnel. Vous pouvez personnaliser l’aspect du biseau grâce à différentes couleurs d’éclairage et d’ombre, à la quantité de flou sur le biseau, à l’angle du biseau, au positionnement du biseau et à un effet de masquage. Vous pouvez appliquer le filtre à tout objet d’affichage (autrement dit, aux objets héritant des propriétés de la classe DisplayObject), tels que MovieClip, SimpleButton, TextField et Video, ainsi qu’aux objets BitmapData.

Pour créer un filtre, utilisez le constructeur new BevelFilter(). L’utilisation de filtres dépend de l’objet auquel vous appliquez le filtre.

  • Pour appliquer des filtres aux clips, champs de texte, boutons et vidéo, utilisez la propriété filters (héritée de DisplayObject). Lorsque vous définissez la propriété filters d’un objet, celui-ci n’est pas modifié. En outre, vous pouvez supprimer la propriété filters pour enlever le filtre.
  • Pour appliquer des filtres aux objets BitmapData, utilisez la méthode BitmapData.applyFilter(). L’appel de applyFilter() pour un objet BitmapData génère une image filtrée à partir de l’objet BitmapData source et de l’objet filtre.

Si vous appliquez un filtre à un objet d’affichage, la valeur de la propriété cacheAsBitmap de cet objet est définie sur true. Si vous supprimez tous les filtres, la valeur d’origine de cacheAsBitmap est restaurée.

Ce filtre prend en charge le redimensionnement de la scène. Cependant, il ne prend pas en charge le redimensionnement général, la rotation ni l’inclinaison. Si l’objet lui-même est redimensionné (si les propriétés scaleX et scaleY ne sont pas définies sur 100 %), l’effet de filtre n’est pas redimensionné. Le redimensionnement est effectué uniquement en cas de zoom avant sur la scène.

Aucun filtre n’est appliqué si l’image obtenue dépasse les dimensions maximales. Dans AIR 1.5 et Flash Player 10, la taille maximale est de 8 191 pixels en largeur ou en hauteur, et le nombre total de pixels ne peut pas excéder 16 777 215 pixels (ainsi, si la largeur d’une image est de 8 191 pixels, sa hauteur maximale doit être de 2 048 pixels). Par exemple, si vous effectuez un zoom avant sur un clip de grande taille auquel un filtre est appliqué, le filtre sera désactivé si l’image obtenue dépasse les dimensions maximales.

flash.filters.BevelFilterflash.display.DisplayObject.filtersflash.display.DisplayObject.cacheAsBitmapflash.display.BitmapData.applyFilter()BevelFilter Constructeur.distance4.0Distance de décalage du biseau, en pixels (virgule flottante). angle45Angle du biseau, de 0 à 360 degrés. highlightColor0xFFFFFFCouleur de surbrillance du biseau, 0xRRGGBB. highlightAlpha1.0Valeur de transparence alpha de la couleur d’éclairage. Les valeurs valides sont comprises entre 0.0 et 1.0. Par exemple, 0,25 définit une valeur de transparence de 25 %. shadowColor0x000000Couleur d’ombre du biseau, 0xRRGGBB. shadowAlpha1.0Valeur de transparence alpha de la couleur d’ombre. Les valeurs valides sont comprises entre 0.0 et 1.0. Par exemple, 0,25 définit une valeur de transparence de 25 %. blurX4.0Quantité de flou horizontal, en pixels. Les valeurs possibles sont comprises entre 0 et 255.0 (virgule flottante). blurY4.0Quantité de flou vertical en pixels. Les valeurs possibles sont comprises entre 0 et 255.0 (virgule flottante). strength1Intensité de l’empreinte ou recouvrement. Plus la valeur est élevée, plus le recouvrement est intense et plus le contraste est important entre le biseau et l’arrière-plan. Les valeurs possibles sont comprises entre 0 et 255.0. quality1Qualité du biseau. Les valeurs gérées sont comprises entre 0 et 15, mais pour la plupart des applications, vous pouvez utiliser les constantes flash.filters.BitmapFilterQuality :
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

Le rendu des filtres de valeur faible est plus rapide. Vous pouvez utiliser les autres valeurs numériques disponibles pour obtenir des effets différents.

typeinnerLe type de biseau. Les valeurs possbiles sont les constantes flash.filters.BitmapFilterType : BitmapFilterType.INNER, BitmapFilterType.OUTER ou BitmapFilterType.FULL. knockoutfalseApplique un effet de masquage (true) qui, en réalité, rend le remplissage de l’objet transparent et révèle la couleur d’arrière-plan du document.
Constructeur.
flash.filters.BitmapFilterQualityflash.filters.BitmapFilterType
clone Renvoie une copie de cet objet filtre.Nouvelle occurrence de BevelFilter dont toutes les propriétés sont identiques à celles de l’occurrence de BevelFilter d’origine. Renvoie une copie de cet objet filtre. angle Angle du biseau, en degrés. 45 Angle du biseau, en degrés. Les valeurs possibles sont comprises entre 0 et 360. La valeur d’angle représente l’angle de la source lumineuse théorique éclairant l’objet et détermine l’emplacement de l’effet par rapport à ce dernier. Si la valeur de la propriété distance est définie sur 0, il n’y a pas d’effet de décalage par rapport à l’objet. La propriété angle n’a donc aucun effet. distance La distance de décalage du biseau.4 La distance de décalage du biseau. Les valeurs possibles sont en pixels (virgule flottante). highlightAlpha Valeur de transparence alpha de la couleur d’éclairage.1 Valeur de transparence alpha de la couleur d’éclairage. Cette valeur est spécifiée en tant que valeur normalisée comprise entre 0 et 1. Par exemple, 0,25 définit une valeur de transparence de 25 %. highlightColor Couleur d’éclairage du biseau.0xFFFFFF Couleur d’éclairage du biseau. Les valeurs possibles sont au format hexadécimal, 0xRRGGBB. shadowAlpha Valeur de transparence alpha de la couleur d’ombre.1 Valeur de transparence alpha de la couleur d’ombre. Cette valeur est spécifiée en tant que valeur normalisée comprise entre 0 et 1. Par exemple, 0,25 définit une valeur de transparence de 25 %. shadowColor La couleur d’ombre du biseau.0x000000 La couleur d’ombre du biseau. Les valeurs possibles sont au format hexadécimal, 0xRRGGBB. type Positionnement de l’effet de filtre.BitmapFilterType.INNER Positionnement de l’effet de filtre. Les valeurs possibles sont les constantes flash.filters.BitmapFilterType :
  • BitmapFilterType.OUTER, rayonnement sur le bord extérieur de l’objet.
  • BitmapFilterType.INNER, rayonnement sur le bord intérieur de l’objet, il s’agit de la valeur par défaut.
  • BitmapFilterType.FULL, rayonnement au-dessus de l’objet.
flash.filters.BitmapFilterType
GradientGlowFilter La classe GradientGlowFilter permet d’appliquer un effet de rayonnement dégradé à des objets d’affichage.The <s:GradientGlowFilter> tag inherits all of the tag attributes of its superclass and adds no tag attributes:

  <s:GradientGlowFilter/>
  
]]>
mx.filters:IBitmapFilterspark.filters:GradientFilter La classe GradientGlowFilter permet d’appliquer un effet de rayonnement dégradé à des objets d’affichage. L’aspect d’un rayonnement dégradé est réaliste et inclut un dégradé de couleurs que vous pouvez contrôler. Vous pouvez appliquer un rayonnement dégradé autour du bord intérieur ou extérieur d’un objet, ou encore par-dessus l’objet. Vous pouvez appliquer le filtre à tout objet d’affichage (autrement dit, aux objets héritant des propriétés de la classe DisplayObject), tels que MovieClip, SimpleButton, TextField et Video, ainsi qu’aux objets BitmapData.

L’utilisation de filtres dépend de l’objet auquel vous appliquez le filtre.

  • Pour appliquer des filtres aux objets d’affichage, utilisez la propriété filters. Lorsque vous définissez la propriété filters d’un objet, celui-ci n’est pas modifié. En outre, vous pouvez supprimer la propriété filters pour enlever le filtre.
  • Pour appliquer des filtres aux objets BitmapData, utilisez la méthode BitmapData.applyFilter(). L’appel de applyFilter() pour un objet BitmapData génère une image filtrée à partir de l’objet BitmapData source et de l’objet filtre.

Si vous appliquez un filtre à un objet d’affichage, la propriété cacheAsBitmap de cet objet est réglée sur true. Si vous supprimez tous les filtres, la valeur d’origine de cacheAsBitmap est restaurée.

Ce filtre prend en charge le redimensionnement de la scène. Toutefois, le redimensionnement général, la rotation et l’inclinaison ne sont pas pris en charge. Si l’objet est lui-même redimensionné (si les propriétés scaleX et scaleY ne sont pas réglées sur 1,0), l’effet de filtre n’est pas redimensionné. Le redimensionnement est effectué uniquement en cas de zoom avant sur la scène.

Aucun filtre n’est appliqué si l’image obtenue dépasse les dimensions maximales. Dans AIR 1.5 et Flash Player 10, la taille maximale est de 8 191 pixels en largeur ou en hauteur, et le nombre total de pixels ne peut pas excéder 16 777 215 pixels (ainsi, si la largeur d’une image est de 8 191 pixels, sa hauteur maximale doit être de 2 048 pixels). Par exemple, lorsque vous effectuez un zoom avant sur un clip de grande taille auquel un filtre est appliqué, le filtre sera désactivé si l’image obtenue dépasse les dimensions maximales.

spark.filters.GlowFilterflash.filters.GradientGlowFilterflash.display.BitmapData.applyFilter()flash.display.DisplayObject.cacheAsBitmapflash.display.DisplayObject.filtersGradientGlowFilter Constructeur.distance4.0Distance de décalage du rayonnement. angle45Angle, exprimé en degrés. Les valeurs valides sont comprises entre 0 et 360. colorsnullTableau de couleurs définissant un dégradé. Par exemple, rouge correspond à 0xFF0000, bleu à 0x0000FF, etc. alphasnullTableau de valeurs de transparence alpha pour les couleurs correspondantes du tableau colors. Les valeurs valides pour chaque élément du tableau sont comprises entre 0 et 1. La valeur 0,25, par exemple, définit une valeur de transparence alpha de 25 %. ratiosnullTableau des taux de répartition des couleurs. Les valeurs valides sont comprises entre 0 et 255. Cette valeur définit le pourcentage de la largeur où la couleur est échantillonnée sur 100 %. blurX4.0Quantité de flou horizontal. Les valeurs valides sont comprises entre 0 et 255. Un flou d’une valeur inférieure ou égale à 1 signifie que l’image d’origine n’est pas modifiée avant d’être copiée. Les valeurs correspondant à une puissance de 2 (telles que 2, 4, 8, 16 et 32) sont optimisées pour obtenir un rendu plus rapide qu’avec les autres valeurs. blurY4.0Quantité de flou vertical. Les valeurs valides sont comprises entre 0 et 255. Un flou d’une valeur inférieure ou égale à 1 signifie que l’image d’origine n’est pas modifiée avant d’être copiée. Les valeurs correspondant à une puissance de 2 (telles que 2, 4, 8, 16 et 32) sont optimisées pour obtenir un rendu plus rapide qu’avec les autres valeurs. strength1Intensité de l’empreinte ou recouvrement. Plus la valeur est élevée, plus le recouvrement est intense et plus le contraste entre le rayonnement et l’arrière-plan est important. Les valeurs valides sont comprises entre 0 et 255. Plus la valeur est élevée, plus l’empreinte est marquée. La valeur 0 signifie que le filtre n’est pas appliqué. quality1Nombre d’applications du filtre. Utilisez les constantes flash.filters.BitmapFilterQuality :
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

Pour plus d’informations, voir la description de la propriété quality.

typeouterPositionnement de l’effet de filtre. Les valeurs possibles sont les constantes flash.filters.BitmapFilterType :
  • BitmapFilterType.OUTER, rayonnement sur le bord extérieur de l’objet ;; la valeur par défaut.
  • BitmapFilterType.INNER, biseau sur le bord intérieur de l’objet.
  • BitmapFilterType.FULL, rayonnement au-dessus de l’objet.
knockoutfalseSpécifie si l’objet a un effet de masquage. Un effet de masquage rend le remplissage de l’objet transparent et révèle la couleur d’arrière-plan du document. La valeur true spécifie un effet de masquage ; la valeur par défaut est false (pas d’effet de masquage).
Constructeur.
clone Renvoie une copie de cet objet filtre.Nouvelle occurrence de GradientGlowFilter dont toutes les propriétés sont identiques à celles de l’occurrence de GradientGlowFilter d’origine. Renvoie une copie de cet objet filtre.
DisplacementMapFilter La classe DisplacementMapFilter utilise les valeurs de pixels de l’objet BitmapData spécifié (appelé image de mappage du déplacement) pour déplacer un objet.The <s:DisplacementMapFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

 <s:DisplacementMapFilter 
   Properties
   alpha="0"
   color="0x000000"
   componentX="0"
   componentY="0"
   mapBitmap="null"
   mapPoint="null"
   mode="wrap"
   scaleX="0"
   scaleY="0"
 />
 
]]>
mx.filters:IBitmapFiltermx.filters:BaseFilter La classe DisplacementMapFilter utilise les valeurs de pixels de l’objet BitmapData spécifié (appelé displacement map image) pour déplacer un objet. Vous pouvez utiliser ce filtre pour appliquer un effet voilé ou tacheté à tout objet héritant des propriétés de la classe DisplayObject, tels que MovieClip, SimpleButton, TextField et Video, ainsi qu’aux objets BitmapData.

L’utilisation de filtres dépend de l’objet auquel vous appliquez le filtre.

  • Pour appliquer des filtres à un objet d’affichage, utilisez la propriété filters de cet objet. Lorsque vous définissez la propriété filters d’un objet, celui-ci n’est pas modifié. En outre, vous pouvez supprimer la propriété filters pour enlever le filtre.
  • Pour appliquer des filtres aux objets BitmapData, utilisez la méthode BitmapData.applyFilter(). L’appel de applyFilter() pour un objet BitmapData génère une image filtrée à partir de l’objet BitmapData source et de l’objet filtre.

Si vous appliquez un filtre à un objet d’affichage, la valeur de la propriété cacheAsBitmap de cet objet est définie sur true. Si vous supprimez tous les filtres, la valeur d’origine de cacheAsBitmap est restaurée.

Le filtre utilise la formule suivante :

dstPixel[x, y] = srcPixel[x + ((componentX(x, y) - 128) ~~ scaleX) / 256, y + ((componentY(x, y) - 128) ~~scaleY) / 256)

componentX(x, y) extrait la valeur de couleur de la propriété componentX de la propriété mapBitmap, à (x - mapPoint.x ,y - mapPoint.y).

L’image de mappage utilisée par le filtre est redimensionnée en fonction de l’échelle de la scène. Elle n’est en aucun cas redimensionnée lorsque l’objet l’est.

Ce filtre prend en charge le redimensionnement de la scène. Mais le redimensionnement général, la rotation et l’inclinaison ne sont pas gérés. Si l’objet lui-même est redimensionné (si les propriétés scaleX et scaleY ne correspondent pas à 1,0), l’effet du filtre n’est pas redimensionné. Le redimensionnement est effectué uniquement en cas de zoom avant sur la scène.

flash.display.BitmapData.applyFilter()flash.display.DisplayObject.filtersflash.display.DisplayObject.cacheAsBitmapDisplacementMapFilter Constructeur.mapBitmapnullObjet BitmapData contenant les données de mappage du déplacement. mapPointnullValeur contenant le décalage du coin supérieur gauche de l’objet d’affichage cible par rapport au coin supérieur gauche de l’image de mappage. componentX0Décrit le canal de couleur à utiliser dans l’image de mappage pour déplacer le résultat x. Les valeurs possibles sont les constantes BitmapDataChannel. componentY0Décrit le canal de couleur à utiliser dans l’image de mappage pour déplacer le résultat y. Les valeurs possibles sont les constantes BitmapDataChannel. scaleX0.0Multiplicateur à utiliser pour redimensionner le résultat du déplacement x à partir du calcul de mappage. scaleY0.0Multiplicateur à utiliser pour redimensionner le résultat du déplacement y à partir du calcul de mappage. modewrapMode du filtre. Les valeurs possibles sont les constantes DisplacementMapFilterMode. color0Spécifie la couleur à utiliser pour les déplacements en dehors des limites. La plage valide est comprise entre 0.0 et 1.0. Utilisez ce paramètre si la propriété mode est réglée sur DisplacementMapFilterMode.COLOR. alpha0.0Spécifie la valeur alpha à utiliser pour les déplacements en dehors des limites. Elle est spécifiée en tant que valeur normalisée comprise entre 0,0 et 1,0. Par exemple, 0,25 définit une valeur de transparence de 25 %. Utilisez ce paramètre si la propriété mode est réglée sur DisplacementMapFilterMode.COLOR. Constructeur. flash.display.BitmapDataChannelflash.filters.DisplacementMapFilterModeclone Renvoie une copie de cet objet filtre.Nouvelle occurrence de DisplacementMapFilter dont les propriétés sont toutes identiques à celles de l’occurrence d’origine. Renvoie une copie de cet objet filtre. alpha Spécifie la transparence alpha à utiliser pour les déplacements en dehors des limites.0 Spécifie la transparence alpha à utiliser pour les déplacements en dehors des limites. Elle est spécifiée en tant que valeur normalisée comprise entre 0,0 et 1,0. Par exemple, 0,25 définit une valeur de transparence de 25 %. La valeur par défaut est 0. Utilisez cette propriété si la propriété mode est réglée sur DisplacementMapFilterMode.COLOR. color Spécifie la couleur à utiliser pour les déplacements en dehors des limites.0x000000 Spécifie la couleur à utiliser pour les déplacements en dehors des limites. La plage valide est comprise entre 0.0 et 1.0. Les valeurs sont au format hexadécimal. La valeur par défaut pour color est 0. Utilisez cette propriété si la propriété mode est réglée sur DisplacementMapFilterMode.COLOR. componentX Décrit le canal de couleur à utiliser dans l’image de mappage pour déplacer le résultat x.0, meaning no channel. Décrit le canal de couleur à utiliser dans l’image de mappage pour déplacer le résultat x. Les valeurs possibles sont les constantes BitmapDataChannel :
  • BitmapDataChannel.ALPHA
  • BitmapDataChannel.BLUE
  • BitmapDataChannel.GREEN
  • BitmapDataChannel.RED
flash.display.BitmapDataChannel
componentY Décrit le canal de couleur à utiliser dans l’image de mappage pour déplacer le résultat y.0, meaning no channel. Décrit le canal de couleur à utiliser dans l’image de mappage pour déplacer le résultat y. Les valeurs possibles sont les constantes BitmapDataChannel :
  • BitmapDataChannel.ALPHA
  • BitmapDataChannel.BLUE
  • BitmapDataChannel.GREEN
  • BitmapDataChannel.RED
mapBitmap Objet BitmapData contenant les données de mappage du déplacement.null Objet BitmapData contenant les données de mappage du déplacement. mapPoint Valeur contenant le décalage du coin supérieur gauche de l’objet d’affichage cible par rapport au coin supérieur gauche de l’image de mappage.null Valeur contenant le décalage du coin supérieur gauche de l’objet d’affichage cible par rapport au coin supérieur gauche de l’image de mappage. mode Mode du filtre. DisplacementMapFilterMode.WRAP Mode du filtre. Les valeurs possibles sont les constantes DisplacementMapFilterMode :
  • DisplacementMapFilterMode.WRAP — Ramène la valeur de déplacement à l’autre côté de l’image source.
  • DisplacementMapFilterMode.CLAMP — Corrige la valeur de déplacement en fonction du bord de l’image source.
  • DisplacementMapFilterMode.IGNORE — Si la valeur de déplacement est hors limites, ignore le déplacement et utilise le pixel source.
  • DisplacementMapFilterMode.COLOR — Si la valeur de déplacement est en dehors de l’image, remplace les valeurs des propriétés color et alpha.
scaleX Multiplicateur à utiliser pour redimensionner le résultat du déplacement x à partir du calcul de mappage.0 Multiplicateur à utiliser pour redimensionner le résultat du déplacement x à partir du calcul de mappage. scaleY Multiplicateur à utiliser pour redimensionner le résultat du déplacement y à partir du calcul de mappage.0 Multiplicateur à utiliser pour redimensionner le résultat du déplacement y à partir du calcul de mappage.
ShaderFilter La classe ShaderFilter Flex élimine de nombreux détails de l’utilisation des classes ShaderFilter, Shader et ShaderData Flash de pour appliquer un mélangeur de pixel comme filtre.The <s:ShaderFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:ShaderFilter
    Properties
    bottomExtension="0"
    leftExtension="0"
    precisionHint="full"
    rightExtension="0"
    shader="[]"
    topExtension="0"
  />
  
]]>
mx.filters:IBitmapFilterflash.events:IEventDispatcherflash.utils:Proxy La classe ShaderFilter Flex élimine de nombreux détails de l’utilisation des classes ShaderFilter, Shader et ShaderData Flash de pour appliquer un mélangeur de pixel comme filtre.

La classe ShaderFilter doit être initialisée avec une occurrence d’un objet Shader ou d’une classe représentative d’un objet Shader (par exemple, d’un objet incorporé). La classe ShaderFilter sert alors de proxy au shader sous-jacent et offre un mécanisme pratique pour accéder aux paramètres d’entrée shader scalaire et multi-dimensionnel directement comme propriétés nommées simples.

Pour définir un paramètre d’entrée shader scalaire simple (par exemple, de type FLOAT ou INT), vous pouvez simplement vous référer directement à la propriété (par exemple, myFilter.radius).

Pour définir ou animer un composant individuel d’un paramètre d’entrée shader multidimensionnel (par exemple, FLOAT2), vous pouvez utiliser une convention de suffixe de propriété pour traiter directement la valeur individuelle. Le code suivant illustre deux façons de définir le premier et le deuxième composants de la propriété FLOAT2 center:

     // 'center' is an input parameter of type FLOAT2.
     shader.center = [10,20];
 
     // Use property suffix convention to access the first and second component of 'center'. 
     shader.center_x = 10;
     shader.center_y = 20;
 

Le jeu complet de suffixes de propriété pris en charge que vous pouvez utiliser est le suivant :

  • Pour les paramètres d’entrée shader de type BOOL2, BOOL3, BOOL4, FLOAT2, FLOAT3, FLOAT4, INT2, INT3 ou INT4, « r g b a », « x y z w » ou « s t p q » peuvent être utilisés comme suffixes pratiques pour accéder respectivement au 1er, 2ème, 3ème et 4ème composant.
  • Pour les paramètres d’entrée shader de type MATRIX2x2, MATRIX3x3 ou MATRIX4x4, « a b c d e f g h i j k l m n o p » peuvent être utilisés comme suffixes de propriété pour accéder du 1er au 16ème composant d’une matrice donnée.

Au fur et à mesure que ses propriétés changent (par exemple, lors d’une animation), la classe ShaderFilter se réapplique automatiquement elle-même au tableau de filtres du composant visuel auquel elle est appliquée.

Exemple de classe ShaderFilter simple : <?xml version="1.0"?> <s:Application xmlns:s="library://ns.adobe.com/flex/spark" xmlns:fx="http://ns.adobe.com/mxml/2009"> <!-- The hypothetical 'spherize' shader applied below has two input parameters, 'center' and 'radius' with the following attributes: parameter 'center' ==< type: float2 minValue: float2(-200,-200) maxValue: float2(800,500) defaultValue: float2(400,250) description: "displacement center" parameter 'radius' ==< type: float minValue: float(.1) maxValue: float(400) defaultValue: float(200) description: "radius" --> <s:Label text="ABCDEF"> <s:filters> <s:ShaderFilter shader="@Embed(source='shaders/spherize.pbj')" radius="25" center_x="50" center_y="15" /> </s:filters> </s:Label> </s:Application>
spark.effects.AnimateFilterShaderFilter Constructeur.shadernullOccurrence flash.display.Shader entièrement réalisée ou classe représentant un shader (par exemple, depuis un objet Embed). Constructeur. bottomExtension 0 leftExtension 0 precisionHint Précision des opérations mathématiques effectuées par le shader sous-jacent.ShaderPrecision.FULL Précision des opérations mathématiques effectuées par le shader sous-jacent. L’ensemble des valeurs possibles de la propriété precisionHint est défini par les constantes de la classe ShaderPrecision. flash.display.Shaderflash.display.ShaderPrecisionrightExtension 0 shader Une occurrence flash.display.Shader. Une occurrence flash.display.Shader. flash.display.ShadertopExtension 0
GlowFilter La classe GlowFilter permet d’appliquer un effet de rayonnement aux objets d’affichage.The <s:GlowFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:GlowFilter
    Properties
    alpha="1"
    color="0xFF0000"
    inner="false"
  />
  
]]>
mx.filters:IBitmapFiltermx.filters:BaseDimensionFilter La classe GlowFilter permet d’appliquer un effet de rayonnement aux objets d’affichage. Vous disposez de plusieurs options pour définir le style de rayonnement, notamment le rayonnement interne ou externe et le mode de masquage. Le filtre de rayonnement est similaire au filtre d’ombre portée dont les propriétés distance et angle sont définies sur zéro. Vous pouvez appliquer le filtre à tout objet d’affichage (autrement dit, aux objets héritant des propriétés de la classe DisplayObject), tels que MovieClip, SimpleButton, TextField et Video, ainsi qu’aux objets BitmapData.

L’utilisation de filtres dépend de l’objet auquel vous appliquez le filtre.

  • Pour appliquer des filtres aux objets d’affichage, utilisez la propriété filters (héritée de DisplayObject). Lorsque vous définissez la propriété filters d’un objet, celui-ci n’est pas modifié. En outre, vous pouvez supprimer la propriété filters pour enlever le filtre.
  • Pour appliquer des filtres aux objets BitmapData, utilisez la méthode BitmapData.applyFilter(). L’appel de applyFilter() pour un objet BitmapData génère une image filtrée à partir de l’objet BitmapData source et de l’objet filtre.

Si vous appliquez un filtre à un objet d’affichage, la propriété cacheAsBitmap de cet objet est réglée sur true. Si vous supprimez tous les filtres, la valeur d’origine de cacheAsBitmap est restaurée.

Ce filtre prend en charge le redimensionnement de la scène. Cependant, il ne prend pas en charge le redimensionnement général, la rotation ni l’inclinaison. Si l’objet est redimensionné (si les propriétés scaleX et scaleY ne sont pas réglées sur 1,0), le filtre ne l’est pas. Le redimensionnement est effectué uniquement en cas de zoom avant sur la scène.

Aucun filtre n’est appliqué si l’image obtenue dépasse les dimensions maximales. Dans AIR 1.5 et Flash Player 10, la taille maximale est de 8 191 pixels en largeur ou en hauteur, et le nombre total de pixels ne peut pas excéder 16 777 215 pixels (ainsi, si la largeur d’une image est de 8 191 pixels, sa hauteur maximale doit être de 2 048 pixels). Par exemple, lorsque vous effectuez un zoom avant sur un clip de grande taille auquel un filtre est appliqué, le filtre sera désactivé si l’image obtenue dépasse les dimensions maximales.

flash.filters.GlowFilterflash.display.BitmapData.applyFilter()flash.display.DisplayObject.filtersflash.display.DisplayObject.cacheAsBitmapflash.display.DisplayObject.scaleXflash.display.DisplayObject.scaleYflash.filters.DropShadowFilter.distanceflash.filters.DropShadowFilter.angleGlowFilter Constructeur.color0xFF0000Couleur du rayonnement, au format hexadécimal 0xRRGGBB. La valeur par défaut est 0xFF0000. alpha1.0Valeur de transparence alpha de la couleur. Les valeurs possibles sont comprises entre 0 et 1. Par exemple, 0,25 définit une valeur de transparence de 25 %. blurX4.0Quantité de flou horizontal. Les valeurs possibles sont comprises entre 0 et 255 (virgule flottante). Les valeurs correspondant à une puissance de 2 (telles que 2, 4, 8, 16 et 32) sont optimisées pour obtenir un rendu plus rapide qu’avec les autres valeurs. blurY4.0Quantité de flou vertical. Les valeurs possibles sont comprises entre 0 et 255 (virgule flottante). Les valeurs correspondant à une puissance de 2 (telles que 2, 4, 8, 16 et 32) sont optimisées pour obtenir un rendu plus rapide qu’avec les autres valeurs. strength1Intensité de l’empreinte ou recouvrement. Plus la valeur est élevée, plus le recouvrement est intense et plus le contraste entre le rayonnement et l’arrière-plan est important. Les valeurs possibles sont comprises entre 0 et 255. quality1Nombre d’applications du filtre. Utilisez les constantes BitmapFilterQuality :
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

Pour plus d’informations, voir la description de la propriété quality.

innerfalseSpécifie si le rayonnement est interne. La valeur true indique un rayonnement interne. La valeur false renvoie un rayonnement externe (au niveau des bords extérieurs de l’objet). knockoutfalseSpécifie si l’objet a un effet de masquage. La valeur true applique un effet de masquage qui rend le remplissage de l’objet transparent et révèle la couleur d’arrière-plan du document.
Constructeur.
BitmapFilterQuality
clone Renvoie une copie de cet objet filtre.Nouvelle occurrence de GlowFilter dont toutes les propriétés sont identiques à celles de l’occurrence de GlowFilter d’origine. Renvoie une copie de cet objet filtre. alpha Valeur de transparence alpha de la couleur.1 Valeur de transparence alpha de la couleur. Les valeurs possibles sont comprises entre 0 et 1. Par exemple, 0,25 définit une valeur de transparence de 25 %. color Couleur du rayonnement.0xFF0000 Couleur du rayonnement. Les valeurs disponibles sont au format hexadécimal 0xRRGGBB. inner Spécifie si le rayonnement est interne.false Spécifie si le rayonnement est interne. La valeur true indique un rayonnement interne. La valeur par défaut est false, renvoyant un rayonnement externe (au niveau des bords extérieurs de l’objet).