Package | spark.filters |
Classe | public class BevelFilter |
Héritage | BevelFilter BaseDimensionFilter BaseFilter EventDispatcher Object |
Implémente | IBitmapFilter |
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
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 deapplyFilter()
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.
Syntaxe MXMLMasquer la syntaxe MXMLThe <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" />
Eléments de l’API associés
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
flash.display.BitmapData.applyFilter()
Propriété | Défini par | ||
---|---|---|---|
angle : Number
Angle du biseau, en degrés. | BevelFilter | ||
blurX : Number
Quantité de flou horizontal. | BaseDimensionFilter | ||
blurY : Number
Quantité de flou vertical. | BaseDimensionFilter | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
distance : Number
La distance de décalage du biseau. | BevelFilter | ||
highlightAlpha : Number
Valeur de transparence alpha de la couleur d’éclairage. | BevelFilter | ||
highlightColor : uint
Couleur d’éclairage du biseau. | BevelFilter | ||
knockout : Boolean
Spécifie si l’objet a un effet de masquage. | BaseDimensionFilter | ||
quality : int
Nombre d’applications du filtre. | BaseDimensionFilter | ||
shadowAlpha : Number
Valeur de transparence alpha de la couleur d’ombre. | BevelFilter | ||
shadowColor : uint
La couleur d’ombre du biseau. | BevelFilter | ||
strength : Number
Intensité de l’empreinte ou recouvrement. | BaseDimensionFilter | ||
type : String
Positionnement de l’effet de filtre. | BevelFilter |
Méthode | Défini par | ||
---|---|---|---|
BevelFilter(distance:Number = 4.0, angle:Number = 45, highlightColor:uint = 0xFFFFFF, highlightAlpha:Number = 1.0, shadowColor:uint = 0x000000, shadowAlpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "inner", knockout:Boolean = false)
Constructeur. | BevelFilter | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | ||
Renvoie une copie de cet objet filtre. | BevelFilter | ||
Distribue un événement dans le flux d’événements. | EventDispatcher | ||
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
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 | ||
Propage un événement change lorsque le filtre a été modifié. | BaseFilter | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | ||
Renvoie la valeur primitive de l’objet spécifié. | Object | ||
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher |
angle | propriété |
angle:Number
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
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.
La valeur par défaut est 45.
Implémentation
public function get angle():Number
public function set angle(value:Number):void
distance | propriété |
distance:Number
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
La distance de décalage du biseau. Les valeurs possibles sont en pixels (virgule flottante).
La valeur par défaut est 4.
Implémentation
public function get distance():Number
public function set distance(value:Number):void
highlightAlpha | propriété |
highlightAlpha:Number
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
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 %.
La valeur par défaut est 1.
Implémentation
public function get highlightAlpha():Number
public function set highlightAlpha(value:Number):void
highlightColor | propriété |
highlightColor:uint
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Couleur d’éclairage du biseau. Les valeurs possibles sont au format hexadécimal, 0xRRGGBB.
La valeur par défaut est 0xFFFFFF.
Implémentation
public function get highlightColor():uint
public function set highlightColor(value:uint):void
shadowAlpha | propriété |
shadowAlpha:Number
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
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 %.
La valeur par défaut est 1.
Implémentation
public function get shadowAlpha():Number
public function set shadowAlpha(value:Number):void
shadowColor | propriété |
shadowColor:uint
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
La couleur d’ombre du biseau. Les valeurs possibles sont au format hexadécimal, 0xRRGGBB.
La valeur par défaut est 0x000000.
Implémentation
public function get shadowColor():uint
public function set shadowColor(value:uint):void
type | propriété |
type:String
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
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.
La valeur par défaut est BitmapFilterType.INNER.
Implémentation
public function get type():String
public function set type(value:String):void
Eléments de l’API associés
BevelFilter | () | Constructeur |
public function BevelFilter(distance:Number = 4.0, angle:Number = 45, highlightColor:uint = 0xFFFFFF, highlightAlpha:Number = 1.0, shadowColor:uint = 0x000000, shadowAlpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "inner", knockout:Boolean = false)
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Constructeur.
Paramètresdistance:Number (default = 4.0 ) — Distance de décalage du biseau, en pixels (virgule flottante).
| |
angle:Number (default = 45 ) — Angle du biseau, de 0 à 360 degrés.
| |
highlightColor:uint (default = 0xFFFFFF ) — Couleur de surbrillance du biseau, 0xRRGGBB.
| |
highlightAlpha:Number (default = 1.0 ) — Valeur 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 %.
| |
shadowColor:uint (default = 0x000000 ) — Couleur d’ombre du biseau, 0xRRGGBB.
| |
shadowAlpha:Number (default = 1.0 ) — Valeur 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 %.
| |
blurX:Number (default = 4.0 ) — Quantité de flou horizontal, en pixels. Les valeurs possibles sont comprises entre 0 et 255.0 (virgule flottante).
| |
blurY:Number (default = 4.0 ) — Quantité de flou vertical en pixels. Les valeurs possibles sont comprises entre 0 et 255.0 (virgule flottante).
| |
strength:Number (default = 1 ) — Intensité 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.
| |
quality:int (default = 1 ) — Qualité 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 :
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. | |
type:String (default = "inner ") — Le type de biseau. Les valeurs possibles sont les constantes flash.filters.BitmapFilterType : BitmapFilterType.INNER , BitmapFilterType.OUTER ou BitmapFilterType.FULL .
| |
knockout:Boolean (default = false ) — Applique 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.
|
Eléments de l’API associés
clone | () | méthode |
public function clone():BitmapFilter
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Renvoie une copie de cet objet filtre.
Valeur renvoyéeBitmapFilter — Nouvelle occurrence de BevelFilter dont toutes les propriétés sont identiques à celles de l’occurrence de BevelFilter d’origine.
|
<?xml version="1.0"?> <!-- filters/examples/BevelFilterExample.mxml --> <s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:mx="library://ns.adobe.com/flex/mx" xmlns:s="library://ns.adobe.com/flex/spark" creationComplete="createFilters()"> <fx:Script><![CDATA[ import spark.filters.*; import flash.filters.BitmapFilterQuality; import flash.filters.BitmapFilterType; private var myBevelFilter:BevelFilter; private var color:Number = 0xFF33FF; public function createFilters():void { myBevelFilter = new BevelFilter(5, 45, 0xFFFF00, .8, 0x0000FF, .8, 3, 3, 1, BitmapFilterQuality.MEDIUM, BitmapFilterType.INNER, false); b1.filters = [myBevelFilter]; } ]]></fx:Script> <s:VGroup> <!-- This button has a filter applied in ActionScript. --> <s:Button id="b1" label="Click me"/> <!-- This button has a filter applied in MXML. --> <s:Button id="b2" label="Click me"> <s:filters> <s:BevelFilter distance="5" angle="45" highlightColor="0xFFFF00" highlightAlpha=".8" shadowColor="0x0000FF" shadowAlpha=".8" blurX="3" blurY="3" strength="1" quality="{BitmapFilterQuality.MEDIUM}" type="{BitmapFilterType.INNER}" knockout="false"/> </s:filters> </s:Button> </s:VGroup> </s:Application>
Tue Jun 12 2018, 09:30 AM Z