Package | spark.filters |
Classe | public class ConvolutionFilter |
Héritage | ConvolutionFilter 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 de convolution, utilisez la syntaxe new ConvolutionFilter()
. 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.
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, 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.
Syntaxe MXMLMasquer la syntaxe MXMLThe <s:ConvolutionFilter>
tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:ConvolutionFilter Properties alpha="1" clamp="true" color="0xFF0000" divisor="1.0" matrix="[]" matrixX="0" matrixY="0" preserveAlpha="true" />
Propriété | Défini par | ||
---|---|---|---|
alpha : Number
Valeur de transparence alpha de la couleur. | ConvolutionFilter | ||
bias : Number
Ecart à ajouter au résultat de la transformation de matrice. | ConvolutionFilter | ||
clamp : Boolean
Indique si l’image doit être corrigée. | ConvolutionFilter | ||
color : uint
Couleur du rayonnement. | ConvolutionFilter | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
divisor : Number
Diviseur utilisé pendant la transformation de matrice. | ConvolutionFilter | ||
matrix : Array
Quantité de flou horizontal. | ConvolutionFilter | ||
matrixX : Number
Dimension x de la matrice (le nombre de lignes de la matrice). | ConvolutionFilter | ||
matrixY : Number
Dimension y de la matrice (nombre de colonnes de la matrice). | ConvolutionFilter | ||
preserveAlpha : Boolean
Indique si le canal alpha est conservé ou si le filtre de convolution s’applique aussi bien à lui qu’aux canaux de couleur. | ConvolutionFilter |
Méthode | Défini par | ||
---|---|---|---|
ConvolutionFilter(matrixX:Number = 0, matrixY:Number = 0, matrix:Array = null, divisor:Number = 1.0, bias:Number = 0.0, preserveAlpha:Boolean = true, clamp:Boolean = true, color:uint = 0, alpha:Number = 0.0)
Constructeur. | ConvolutionFilter | ||
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. | ConvolutionFilter | ||
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 |
alpha | propriété |
alpha: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. 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
bias | propriété |
bias:Number
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Ecart à ajouter au résultat de la transformation de matrice. L’écart augmente la valeur de couleur de chaque canal de telle sorte que les couleurs sombres paraissent plus vives.
La valeur par défaut est 0.
Implémentation
public function get bias():Number
public function set bias(value:Number):void
clamp | propriété |
clamp:Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Indique si l’image doit être corrigée. Pour les pixels provenant de l’image source, la valeur true indique que l’image d’entrée est agrandie autant que nécessaire au niveau de ses bordures en dupliquant les valeurs de couleur de chacun de ses bords respectifs. La valeur false indique qu’il faut utiliser une autre couleur, comme spécifié dans les propriétés color et alpha.
La valeur par défaut est true.
Implémentation
public function get clamp():Boolean
public function set clamp(value:Boolean):void
color | propriété |
color: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 du rayonnement. Les valeurs disponibles 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
divisor | propriété |
divisor:Number
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Diviseur utilisé pendant la transformation de matrice. La valeur par défaut est 1. Un diviseur correspondant à la somme de toutes les valeurs de matrice atténue l’intensité globale des couleurs du résultat. La valeur 0 est ignorée ; elle est remplacée par la valeur par défaut.
La valeur par défaut est 1.0.
Implémentation
public function get divisor():Number
public function set divisor(value:Number):void
matrix | propriété |
matrix:Array
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
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.
La valeur par défaut est [].
Implémentation
public function get matrix():Array
public function set matrix(value:Array):void
matrixX | propriété |
matrixX:Number
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Dimension x de la matrice (le nombre de lignes de la matrice).
La valeur par défaut est 0.
Implémentation
public function get matrixX():Number
public function set matrixX(value:Number):void
matrixY | propriété |
matrixY:Number
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Dimension y de la matrice (nombre de colonnes de la matrice).
La valeur par défaut est 0.
Implémentation
public function get matrixY():Number
public function set matrixY(value:Number):void
preserveAlpha | propriété |
preserveAlpha:Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 4 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Indique si le canal alpha est conservé ou si le filtre de convolution s’applique aussi bien à lui qu’aux canaux de couleur. La valeur false indique que la convolution s’applique à tous les canaux, y compris le canal alpha. La valeur true indique que la convolution s’applique uniquement aux canaux de couleur.
La valeur par défaut est true.
Implémentation
public function get preserveAlpha():Boolean
public function set preserveAlpha(value:Boolean):void
ConvolutionFilter | () | Constructeur |
public function ConvolutionFilter(matrixX:Number = 0, matrixY:Number = 0, matrix:Array = null, divisor:Number = 1.0, bias:Number = 0.0, preserveAlpha:Boolean = true, clamp:Boolean = true, color:uint = 0, alpha:Number = 0.0)
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ètresmatrixX:Number (default = 0 ) — Dimension x de la matrice (nombre de colonnes de la matrice). La valeur par défaut est 0.
| |
matrixY:Number (default = 0 ) — Dimension y de la matrice (nombre de lignes de la matrice). La valeur par défaut est 0.
| |
matrix:Array (default = null ) — Tableau des valeurs utilisées pour la transformation de matrice. Le nombre d’éléments dans le tableau doit être égal à matrixX * matrixY .
| |
divisor:Number (default = 1.0 ) — Diviseur utilisé pendant la transformation de matrice. La valeur par défaut est 1. Un diviseur correspondant à la somme de toutes les valeurs de matrice atténue l’intensité de couleurs globale du résultat. La valeur 0 est ignorée ; elle est remplacée par la valeur par défaut.
| |
bias:Number (default = 0.0 ) — Ecart à ajouter au résultat de la transformation de matrice. La valeur par défaut est 0.
| |
preserveAlpha:Boolean (default = true ) — La valeur false indique que la valeur alpha n’est pas conservée et que la convolution s’applique à tous les canaux, y compris le canal alpha. La valeur true indique que la convolution s’applique uniquement aux canaux de couleur. La valeur par défaut est true .
| |
clamp:Boolean (default = true ) — Pour les pixels provenant de l’image source, la valeur true indique que l’image d’entrée est agrandie autant que nécessaire au niveau de ses bordures en dupliquant les valeurs de couleur sur le bord donné. La valeur false indique qu’il faut utiliser une autre couleur, comme spécifié dans les propriétés color et alpha . La valeur par défaut est true .
| |
color:uint (default = 0 ) — Couleur hexadécimale à substituer aux pixels provenant de l’image source.
| |
alpha:Number (default = 0.0 ) — Alpha de la couleur de substitution.
|
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 — BitmapFilter Nouvelle occurrence de ConvolutionFilter dont les propriétés sont toutes identiques à celles de l’occurrence de ConvolutionMatrixFilter d’origine.
|
<?xml version="1.0"?> <!-- filters/examples/ConvolutionGlowFilterExample .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 myOutlineConvolutionFilter:ConvolutionFilter; private var mySharpnessConvolutionFilter:ConvolutionFilter; private var myBrightnessConvolutionFilter:ConvolutionFilter; private var outlineMatrix:Array = [ -30, 30, 0, -30, 30, 0, -30, 30, 0 ]; private var sharpnessMatrix:Array = [0, -1, 0, -1, 20, -1, 0, -1, 0]; private var brightnessMatrix:Array = [2, 2, 2, 2, 0, 2, 2, 2, 2]; public function createFilters():void { myOutlineConvolutionFilter = new ConvolutionFilter(3, 3, outlineMatrix, 9, 0, true, true, 0x00CC99, 0); mySharpnessConvolutionFilter = new ConvolutionFilter(3, 3, sharpnessMatrix, 9, 0, true, true, 0x00CC99, 0); myBrightnessConvolutionFilter = new ConvolutionFilter(3, 3, brightnessMatrix, 3, 0, true, true, 0x00CC99, 0); outlineImage.filters = [myOutlineConvolutionFilter]; sharpnessImage.filters = [mySharpnessConvolutionFilter]; brightnessImage.filters = [myBrightnessConvolutionFilter]; } ]]></fx:Script> <s:VGroup> <s:VGroup> <s:Label text="Original Image"/> <mx:Image id="originalImage" source="@Embed(source='assets/Nokia_6630.png')"/> </s:VGroup> <s:VGroup> <s:Label text="Outline Matrix Image"/> <mx:Image id="outlineImage" source="@Embed(source='assets/Nokia_6630.png')"/> </s:VGroup> <s:VGroup> <s:Label text="Sharpness Matrix Image"/> <mx:Image id="sharpnessImage" source="@Embed(source='assets/Nokia_6630.png')"/> </s:VGroup> <s:VGroup> <s:Label text="Brightness Matrix Image"/> <mx:Image id="brightnessImage" source="@Embed(source='assets/Nokia_6630.png')"/> </s:VGroup> </s:VGroup> </s:Application>
Tue Jun 12 2018, 09:30 AM Z