Package | flash.filters |
Classe | public final class GradientBevelFilter |
Héritage | GradientBevelFilter BitmapFilter Object |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
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 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 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). Dans Flash Player 9 et les versions antérieures, ainsi que dans AIR 1.1 et les versions antérieures, la limite est de 2 880 pixels de haut sur 2 880 pixels de large. 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.
Eléments de l’API associés
flash.display.BitmapData.applyFilter()
BevelFilter
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
Propriété | Défini par | ||
---|---|---|---|
alphas : Array
Tableau de valeurs de transparence alpha pour les couleurs correspondantes du tableau colors. | GradientBevelFilter | ||
angle : Number
Angle, exprimé en degrés. | GradientBevelFilter | ||
blurX : Number
Quantité de flou horizontal. | GradientBevelFilter | ||
blurY : Number
Quantité de flou vertical. | GradientBevelFilter | ||
colors : Array
Tableau de valeurs hexadécimales de couleur RVB à utiliser pour le dégradé. | GradientBevelFilter | ||
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. | GradientBevelFilter | ||
knockout : Boolean
Spécifie si l’objet a un effet de masquage. | GradientBevelFilter | ||
quality : int
Nombre d’applications du filtre. | GradientBevelFilter | ||
ratios : Array
Tableau de taux de répartition des couleurs, pour les couleurs correspondantes du tableau colors. | GradientBevelFilter | ||
strength : Number
Intensité de l’empreinte ou recouvrement. | GradientBevelFilter | ||
type : String
Positionnement de l’effet biseau. | GradientBevelFilter |
Méthode | Défini par | ||
---|---|---|---|
GradientBevelFilter(distance:Number = 4.0, angle:Number = 45, colors:Array = null, alphas:Array = null, ratios:Array = null, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "inner", knockout:Boolean = false)
Initialise le filtre avec les paramètres spécifiés. | GradientBevelFilter | ||
[override]
Renvoie une copie de cet objet filtre. | GradientBevelFilter | ||
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 | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
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 |
alphas | propriété |
alphas:Array
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Tableau 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 %.
La propriété alphas
ne peut pas être modifiée en manipulant directement ses valeurs. Vous devez obtenir une référence à alphas
, effectuer les modifications sur la référence, puis définir la propriété alphas
sur la référence.
Les propriétés colors
, alphas
et ratios
sont liées. Le premier élément du tableau colors
correspond au premier élément du tableau alphas
, du tableau ratios
, etc.
Implémentation
public function get alphas():Array
public function set alphas(value:Array):void
Valeur émise
TypeError — La valeur du tableau est null au moment de sa définition.
|
Eléments de l’API associés
angle | propriété |
angle:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Angle, exprimé en degrés. Les valeurs possibles sont comprises entre 0 et 360. La valeur par défaut est 45.
La valeur d’angle représente l’angle de la source lumineuse théorique éclairant l’objet. La valeur détermine l’angle selon lequel les couleurs de dégradé sont appliquées à l’objet : soit où la surbrillance et l’ombre apparaissent, soit où la première couleur du tableau apparaît. Les couleurs sont ensuite appliquées selon leur ordre d’apparition dans le tableau.
Implémentation
public function get angle():Number
public function set angle(value:Number):void
Eléments de l’API associés
blurX | propriété |
blurX:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Quantité de flou horizontal. Les valeurs possibles 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.
Implémentation
public function get blurX():Number
public function set blurX(value:Number):void
blurY | propriété |
blurY:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Quantité de flou vertical. Les valeurs possibles 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.
Implémentation
public function get blurY():Number
public function set blurY(value:Number):void
colors | propriété |
colors:Array
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Tableau de valeurs hexadécimales de couleur RVB à utiliser pour le dégradé. Par exemple, rouge correspond à 0xFF0000, bleu à 0x0000FF, etc.
La propriété colors
ne peut pas être modifiée en manipulant directement ses valeurs. Vous devez obtenir une référence à colors
, effectuer les modifications sur la référence, puis définir la propriété colors
sur la référence.
Les propriétés colors
, alphas
et ratios
sont liées. Le premier élément du tableau colors
correspond au premier élément du tableau alphas
, du tableau ratios
, etc.
Implémentation
public function get colors():Array
public function set colors(value:Array):void
Valeur émise
TypeError — La valeur du tableau est null au moment de sa définition.
|
Eléments de l’API associés
distance | propriété |
distance:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
La distance de décalage. Les valeurs valides sont comprises entre 0 et 8. La valeur par défaut est 4.0.
Implémentation
public function get distance():Number
public function set distance(value:Number):void
knockout | propriété |
knockout:Boolean
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Spé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).
Implémentation
public function get knockout():Boolean
public function set knockout(value:Boolean):void
quality | propriété |
quality:int
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
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 quality
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
.
Implémentation
public function get quality():int
public function set quality(value:int):void
Eléments de l’API associés
ratios | propriété |
ratios:Array
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Tableau de taux de répartition des couleurs, pour les couleurs correspondantes du tableau colors
. Les valeurs valides pour chaque élément du tableau sont comprises entre 0 et 255.
La propriété ratios
ne peut pas être modifiée en manipulant directement ses valeurs. Vous devez obtenir une référence à ratios
, effectuer les modifications sur la référence, puis définir la propriété ratios
sur la référence.
Les propriétés colors
, alphas
et ratios
sont liées. Le premier élément du tableau colors
correspond au premier élément du tableau alphas
, du tableau ratios
, etc.
Pour comprendre comment les couleurs du biseau dégradé sont appliquées, considérez les couleurs que vous souhaitez intégrer à votre biseau dégradé. Un biseau simple possède une couleur d’éclairage et une couleur d’ombre. Un biseau dégradé possède un dégradé éclairé et un dégradé ombré. Supposons que l’éclairage apparaît dans l’angle supérieur gauche et l’ombre, dans l’angle inférieur droit. Et imaginons que l’une des utilisations possibles du filtre comporte quatre couleurs dans la zone éclairée et quatre dans l’ombre. En plus de l’éclairage et de l’ombre, le filtre utilise une couleur de remplissage de base qui apparaît à la jonction des zones éclairées et ombrées. Le nombre total de couleurs est donc neuf, et le nombre d’éléments correspondants dans le tableau des rapports, également neuf.
Si vous souhaitez obtenir un dégradé composé de bandes de différentes couleurs qui se mêlent les unes aux autres, chaque valeur de ratio définit l’emplacement de la couleur sur le rayon du dégradé, 0 représentant le point le plus éloigné et 255, le point le plus proche du centre du dégradé. En général, la valeur moyenne, 128, constitue la valeur de remplissage de base. Pour obtenir l’effet de biseau illustré ci-dessous, affectez les valeurs de ratio comme suit, en vous aidant des neuf couleurs d’exemple :
- Les quatre premières couleurs se situent dans la plage 0 à 127, chaque valeur étant supérieure ou égale à la précédente. Elles définissent le bord du biseau éclairé.
- La cinquième couleur (la couleur du milieu) correspond au remplissage de base et est définie sur 128. La valeur de pixel 128 définit le remplissage de base qui apparaît soit à l’extérieur de la forme (et au niveau des bords du biseau) si le type externe est spécifié, soit à l’intérieur de la forme en couvrant efficacement le remplissage même de l’objet, si le type spécifié est interne.
- Les quatre dernières couleurs se situent dans la plage 129 à 255, chaque valeur étant supérieure ou égale à la précédente. Elles définissent le bord du biseau ombré.
Pour obtenir une répartition équivalente des couleurs sur chaque bord, utilisez un nombre de couleurs impair, la couleur centrale constituant le remplissage de base. Distribuez les valeurs de manière homogène entre 0-127 et 129-255 pour vos couleurs, puis ajustez la valeur pour modifier la largeur de chaque bande de couleur du dégradé. Pour un biseau dégradé possédant neuf couleurs, le tableau [16, 32, 64, 96, 128, 160, 192, 224, 235] est possible. L’image suivante illustre le biseau dégradé décrit :
N’oubliez pas que la répartition des couleurs dans le dégradé varie en fonction des valeurs des propriétés blurX
, blurY
, strength
et quality
, ainsi que des valeurs de ratios
.
Implémentation
public function get ratios():Array
public function set ratios(value:Array):void
Valeur émise
TypeError — La valeur du tableau est null au moment de sa définition.
|
Eléments de l’API associés
strength | propriété |
strength:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
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. La valeur 0 signifie que le filtre n’est pas appliqué. La valeur par défaut est 1.
Implémentation
public function get strength():Number
public function set strength(value:Number):void
Eléments de l’API associés
type | propriété |
type:String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Positionnement 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.
Implémentation
public function get type():String
public function set type(value:String):void
GradientBevelFilter | () | Constructeur |
public function GradientBevelFilter(distance:Number = 4.0, angle:Number = 45, colors:Array = null, alphas:Array = null, ratios:Array = null, 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 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Initialise le filtre avec les paramètres spécifiés.
Paramètresdistance:Number (default = 4.0 ) — La distance de décalage. Les valeurs valides sont comprises entre 0 et 8.
| |
angle:Number (default = 45 ) — Angle, exprimé en degrés. Les valeurs possibles sont comprises entre 0 et 360.
| |
colors:Array (default = null ) — Tableau de valeurs hexadécimales de couleur RVB à utiliser pour le dégradé. Par exemple, rouge correspond à 0xFF0000, bleu à 0x0000FF, etc.
| |
alphas:Array (default = null ) — Tableau 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 %.
| |
ratios:Array (default = null ) — Tableau de taux de distribution des couleurs ; les valeurs possibles sont comprises entre 0 et 255.
| |
blurX:Number (default = 4.0 ) — Quantité de flou horizontal. Les valeurs possibles 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:Number (default = 4.0 ) — Quantité de flou vertical. Les valeurs possibles 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.
| |
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. La valeur 0 signifie que le filtre n’est pas appliqué.
| |
quality:int (default = 1 ) — La qualité du filtre. Utilisez les constantes BitmapFilterQuality :
Pour plus d’informations, voir la description de la propriété | |
type:String (default = "inner ") — Positionnement de l’effet biseau. Les valeurs possibles sont les constantes BitmapFilterType :
| |
knockout:Boolean (default = false ) — Spé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.
|
Eléments de l’API associés
clone | () | méthode |
override public function clone():BitmapFilter
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Renvoie une copie de cet objet filtre.
Valeur renvoyéeBitmapFilter — Nouvelle occurrence de GradientBevelFilter dont toutes les propriétés sont identiques à celles de l’occurrence de GradientBevelFilter d’origine.
|
- Importation des classes requises.
- Déclaration des variables globales pour définir le carré et le filtre.
- Création des fonctions constructeur qui effectuent les actions suivantes :
- Appel de la méthode
draw()
qui utilise des méthodes de la classe Graphics, accessibles par le biais de la propriétégraphics
de Sprite, pour dessiner un carré gris. - Création d’un objet BitmapFilter nommé
filter
auquel est attribuée la valeur renvoyée d’un appel àgetBitmapFilter()
qui crée le filtre. - Création d’un nouveau tableau nommé
myFilters
auquel est ajoutéfilter
. - Attribution de
myFilters
à la propriétéfilters
de l’objet GradientBevelFilterExample. Ceci a pour effet d’appliquer tous les filtres trouvés dansmyFilters
, en l’occurrencefilter
uniquement.
- Appel de la méthode
package { import flash.display.Sprite; import flash.filters.BitmapFilter; import flash.filters.BitmapFilterQuality; import flash.filters.BitmapFilterType; import flash.filters.GradientBevelFilter; public class GradientBevelFilterExample extends Sprite { private var bgColor:uint = 0xCCCCCC; private var size:uint = 80; private var offset:uint = 50; private var distance:Number = 5; private var angleInDegrees:Number = 225; // opposite 45 degrees private var colors:Array = [0xFFFFFF, 0xCCCCCC, 0x000000]; private var alphas:Array = [1, 0, 1]; private var ratios:Array = [0, 128, 255]; private var blurX:Number = 8; private var blurY:Number = 8; private var strength:Number = 2; private var quality:Number = BitmapFilterQuality.HIGH private var type:String = BitmapFilterType.INNER; private var knockout:Boolean = true; public function GradientBevelFilterExample() { draw(); var filter:BitmapFilter = getBitmapFilter(); var myFilters:Array = new Array(); myFilters.push(filter); filters = myFilters; } private function getBitmapFilter():BitmapFilter { return new GradientBevelFilter(distance, angleInDegrees, colors, alphas, ratios, blurX, blurY, strength, quality, type, knockout); } private function draw():void { graphics.beginFill(bgColor); graphics.drawRect(offset, offset, size, size); graphics.endFill(); } } }
Tue Jun 12 2018, 09:30 AM Z