| Package | flash.filters |
| Classe | public final class BlurFilter |
| Héritage | BlurFilter BitmapFilter Object |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
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.
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.
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 192 pixels en largeur ou en hauteur, et le nombre total de pixels ne peut pas excéder 16 777 216 pixels. (Ainsi, si la largeur d'une image est de 8 192 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, 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.
Voir aussi
| Propriété | Défini par | ||
|---|---|---|---|
| blurX : Number Quantité de flou horizontal. | BlurFilter | ||
| blurY : Number Quantité de flou vertical. | BlurFilter | ||
![]() | constructor : Object Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet. | Object | |
![]() | prototype : Object [statique] Référence à l'objet prototype d'un objet de classe ou fonction. | Object | |
| quality : int Nombre d'applications du flou. | BlurFilter | ||
| Méthode | Défini par | ||
|---|---|---|---|
Initialise le filtre avec les paramètres spécifiés. | BlurFilter | ||
Renvoie une copie de cet objet filtre. | BlurFilter | ||
![]() | 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 sous forme de chaîne de l'objet spécifié. | Object | |
![]() | Renvoie la valeur primitive de l'objet spécifié. | Object | |
| blurX | propriété |
blurX:Number [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Quantité de flou horizontal. Les valeurs valides sont comprises entre 0 et 255 (virgule flottante). 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.
public function get blurX():Number public function set blurX(value:Number):void| blurY | propriété |
blurY:Number [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Quantité de flou vertical. Les valeurs valides sont comprises entre 0 et 255 (virgule flottante). 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.
public function get blurY():Number public function set blurY(value:Number):void| quality | propriété |
quality:int [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Nombre d'applications du flou. 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 et se rapproche d'un flou gaussien. 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 augmenter le nombre d'applications du flou, 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.
Vous pouvez utiliser les constantes BitmapFilterQuality suivantes pour spécifier les valeurs de la propriété quality :
BitmapFilterQuality.LOW
BitmapFilterQuality.MEDIUM
BitmapFilterQuality.HIGH
public function get quality():int public function set quality(value:int):void| BlurFilter | () | Constructeur |
public function BlurFilter(blurX:Number = 4.0, blurY:Number = 4.0, quality:int = 1)| 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. Les valeurs par défaut créent une image floue sans contours précis.
ParamètresblurX:Number (default = 4.0) — Quantité de flou à appliquer horizontalement. Les valeurs valides sont comprises entre 0 et 255,0 (valeur en virgule flottante). | |
blurY:Number (default = 4.0) — Quantité de flou à appliquer verticalement. Les valeurs valides sont comprises entre 0 et 255,0 (valeur en virgule flottante). | |
quality:int (default = 1) —
Nombre d'applications du filtre. Vous pouvez définir la qualité à l'aide des constantes BitmapFilterQuality :
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. |
| 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 BlurFilter dont toutes les propriétés sont identiques à celles de l'occurrence BlurFilter d'origine. |
draw() qui dessine l'objet auquel le filtre de flou est appliqué.
BlurFilterExample() qui effectue les actions suivantes :
draw() qui est déclarée ultérieurement.
filter comme objet BitmapFilter et attribution de celui-ci à la valeur renvoyée d'un appel à getBitmapFilter().
myFilters, ajout de filter au tableau, puis attribution de myFilters à la propriété filters de l'objet BlurFilterExample. Ceci a pour effet d'appliquer tous les filtres trouvés dans myFilters, en l'occurrence filter uniquement.
getBitmapFilter() afin de créer et de définir des propriétés pour le filtre.
draw(). Cette fonction utilise des méthodes de la classe Graphics, accessibles par le biais de la propriété graphics de la classe Sprite, pour dessiner le carré.
package {
import flash.display.Sprite;
import flash.filters.BitmapFilter;
import flash.filters.BitmapFilterQuality;
import flash.filters.BlurFilter;
public class BlurFilterExample extends Sprite {
private var bgColor:uint = 0xFFCC00;
private var size:uint = 80;
private var offset:uint = 50;
public function BlurFilterExample() {
draw();
var filter:BitmapFilter = getBitmapFilter();
var myFilters:Array = new Array();
myFilters.push(filter);
filters = myFilters;
}
private function getBitmapFilter():BitmapFilter {
var blurX:Number = 30;
var blurY:Number = 30;
return new BlurFilter(blurX, blurY, BitmapFilterQuality.HIGH);
}
private function draw():void {
graphics.beginFill(bgColor);
graphics.drawRect(offset, offset, size, size);
graphics.endFill();
}
}
}