| Package | flash.filters |
| Classe | public final class BlurFilter |
| Héritage | BlurFilter BitmapFilter Object |
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | 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.
Un filtre n’est pas appliqué si l'image obtenue dépasse 2 880 pixels en largeur ou en hauteur. Par exemple, si vous faites un zoom avant sur un grand clip auquel un filtre est appliqué, le filtre est désactivé si l'image résultante dépasse la limite de 2 880 pixels.
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
[static]
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 |
| Version du lecteur : | 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 |
| Version du lecteur : | 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 |
| Version du lecteur : | 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.LOWBitmapFilterQuality.MEDIUMBitmapFilterQuality.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 |
| Version du lecteur : | 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 |
public override function clone():BitmapFilter
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | 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();
}
}
}
M'envoyer un message électronique lorsque des commentaires sont ajoutés à cette page | Rapport de commentaire
Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/flash/filters/BlurFilter.html