Package | flash.filters |
Classe | public final class GlowFilter |
Héritage | GlowFilter BitmapFilter Object |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
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 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. 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). 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.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
flash.display.DisplayObject.scaleX
flash.display.DisplayObject.scaleY
flash.filters.DropShadowFilter.distance
flash.filters.DropShadowFilter.angle
Propriété | Défini par | ||
---|---|---|---|
alpha : Number
Valeur de transparence alpha de la couleur. | GlowFilter | ||
blurX : Number
Quantité de flou horizontal. | GlowFilter | ||
blurY : Number
Quantité de flou vertical. | GlowFilter | ||
color : uint
Couleur du rayonnement. | GlowFilter | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
inner : Boolean
Spécifie si le rayonnement est interne. | GlowFilter | ||
knockout : Boolean
Spécifie si l’objet a un effet de masquage. | GlowFilter | ||
quality : int
Nombre d’applications du filtre. | GlowFilter | ||
strength : Number
Intensité de l’empreinte ou recouvrement. | GlowFilter |
Méthode | Défini par | ||
---|---|---|---|
GlowFilter(color:uint = 0xFF0000, alpha:Number = 1.0, blurX:Number = 6.0, blurY:Number = 6.0, strength:Number = 2, quality:int = 1, inner:Boolean = false, knockout:Boolean = false)
Initialise une nouvelle occurrence de GlowFilter avec les paramètres spécifiés. | GlowFilter | ||
[override]
Renvoie une copie de cet objet filtre. | GlowFilter | ||
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 |
alpha | propriété |
alpha:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
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 %. La valeur par défaut est 1.
Implémentation
public function get alpha():Number
public function set alpha(value:Number):void
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 (virgule flottante). La valeur par défaut est 6. 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 (virgule flottante). La valeur par défaut est 6. 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
color | propriété |
color:uint
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Couleur du rayonnement. Les valeurs valides sont au format hexadécimal 0xRRGGBB. La valeur par défaut est 0xFF0000.
Implémentation
public function get color():uint
public function set color(value:uint):void
inner | propriété |
inner:Boolean
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
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).
Implémentation
public function get inner():Boolean
public function set inner(value:Boolean):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. 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. La valeur par défaut est false
(pas 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
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 entre le rayonnement et l’arrière-plan est important. Les valeurs possibles sont comprises entre 0 et 255. La valeur par défaut est 2.
Implémentation
public function get strength():Number
public function set strength(value:Number):void
GlowFilter | () | Constructeur |
public function GlowFilter(color:uint = 0xFF0000, alpha:Number = 1.0, blurX:Number = 6.0, blurY:Number = 6.0, strength:Number = 2, quality:int = 1, inner:Boolean = false, knockout:Boolean = false)
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9 |
Initialise une nouvelle occurrence de GlowFilter avec les paramètres spécifiés.
Paramètrescolor:uint (default = 0xFF0000 ) — Couleur du rayonnement, au format hexadécimal 0xRRGGBB. La valeur par défaut est 0xFF0000.
| |
alpha:Number (default = 1.0 ) — 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 %.
| |
blurX:Number (default = 6.0 ) — Quantité 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.
| |
blurY:Number (default = 6.0 ) — Quantité 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.
| |
strength:Number (default = 2 ) — Intensité 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.
| |
quality:int (default = 1 ) — Nombre d’applications du filtre. Utilisez les constantes BitmapFilterQuality :
Pour plus d’informations, voir la description de la propriété | |
inner:Boolean (default = false ) — Spé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).
| |
knockout:Boolean (default = false ) — Spé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.
|
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 GlowFilter dont toutes les propriétés sont identiques à celles de l’occurrence de GlowFilter d’origine.
|
- Importation des classes requises.
- Déclaration des trois propriétés utilisées dans 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é orange. - Création de la fonction constructeur qui effectue les actions suivantes :
- Appelle la fonction
draw
pour créer un rectangle. - Crée un objet BitmapFilter
glowFilter
lui affecte les valeurs renvoyées de la fonctiongetBitmapFilter()
. - Attribue le tableau de valeurs provenant de l’objet
glowFilter
à la propriétéfilters
de l’objet d’affichage racine. Dans ce cas, tous les enfants de l’objet d’affichage de l’objet d’affichage racine héritent des propriétés du filtre de rayonnement. Ainsi, le rectangle créé dans la fonctiondraw()
affiche les propriétés du filtre de rayonnement.
- Appelle la fonction
package { import flash.display.Sprite; import flash.events.Event; import flash.events.MouseEvent; import flash.filters.BitmapFilter; import flash.filters.BitmapFilterQuality; import flash.filters.GlowFilter; public class GlowFilterExample extends Sprite { private var bgColor:uint = 0xFFCC00; private var size:uint = 80; private var offset:uint = 50; public function GlowFilterExample() { //draw the rectangle using the draw() function below draw(); //assign the values from getBitmapFilter function below //to a BitmapFilter object "glowFilter" var glowFilter:BitmapFilter = getBitmapFilter(); //populate the filters property of the root display object with the array of values //from the glowFilter object. filters = [ glowFilter ]; } private function getBitmapFilter():BitmapFilter { var color:Number = 0x33CCFF; var alpha:Number = 0.8; var blurX:Number = 35; var blurY:Number = 35; var strength:Number = 2; var inner:Boolean = false; var knockout:Boolean = false; var quality:Number = BitmapFilterQuality.HIGH; return new GlowFilter(color, alpha, blurX, blurY, strength, quality, inner, knockout); } private function draw():void { graphics.beginFill(bgColor); graphics.drawRect(offset, offset, size, size); graphics.endFill(); } } }
Tue Jun 12 2018, 09:30 AM Z