Package | flash.display |
Classe | public final class GraphicsGradientFill |
Héritage | GraphicsGradientFill Object |
Implémente | IGraphicsFill, IGraphicsData |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Utilisez l’objet GraphicsGradientFill avec la méthode Graphics.drawGraphicsData()
. Dessiner un objet GraphicsGradientFill revient à appeler la méthode Graphics.beginGradientFill()
.
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
alphas : Array
Tableau de valeurs alpha pour les couleurs correspondantes du tableau de couleurs. | GraphicsGradientFill | ||
colors : Array
Tableau de valeurs hexadécimales de couleur RVB à utiliser pour le dégradé. | GraphicsGradientFill | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
focalPointRatio : Number
Nombre qui contrôle l’emplacement du point focal du dégradé. | GraphicsGradientFill | ||
interpolationMethod : String
Valeur de la classe InterpolationMethod qui spécifie la valeur à utiliser. | GraphicsGradientFill | ||
matrix : Matrix
Matrice de transformation définie par la classe Matrix. | GraphicsGradientFill | ||
ratios : Array
Tableau des taux de répartition des couleurs. | GraphicsGradientFill | ||
spreadMethod : String
Valeur de la classe SpreadMethod qui spécifie la méthode d’étalement à utiliser. | GraphicsGradientFill | ||
type : String
Valeur de la classe GradientType qui spécifie le type de dégradé à utiliser. | GraphicsGradientFill |
Méthode | Défini par | ||
---|---|---|---|
GraphicsGradientFill(type:String = "linear", colors:Array = null, alphas:Array = null, ratios:Array = null, matrix:* = null, spreadMethod:* = pad, interpolationMethod:String = "rgb", focalPointRatio:Number = 0.0)
Crée un nouvel objet GraphicsGradientFill. | GraphicsGradientFill | ||
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é |
public var alphas:Array
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Tableau de valeurs alpha pour les couleurs correspondantes du tableau de couleurs. Les valeurs disponibles sont comprises entre 0 et 1. Si la valeur est inférieure à 0, 0 est utilisé. Si la valeur est supérieure à 1, 1 est utilisé.
colors | propriété |
public var colors:Array
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Tableau de valeurs hexadécimales de couleur RVB à utiliser pour le dégradé. Par exemple, rouge correspond à 0xFF0000, bleu à 0x0000FF, etc. Vous pouvez définir jusqu’à 15 couleurs. Pour chaque couleur, définissez une valeur correspondante dans les propriétés alphas et ratios.
focalPointRatio | propriété |
public var focalPointRatio:Number
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Nombre qui contrôle l’emplacement du point focal du dégradé. Une valeur de 0 permet de définir le point focal au centre. Une valeur de 1 signifie que le point focal se trouve sur l’un des bords du cercle du dégradé. Une valeur de -1 permet de définir le point focal sur l’autre bord du cercle du dégradé. Toute valeur inférieure à -1 ou supérieure à 1 est respectivement arrondie à -1 ou 1. L’exemple suivant affiche un paramètre focalPointRatio
défini sur 0,75 :
interpolationMethod | propriété |
interpolationMethod:String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Valeur de la classe InterpolationMethod qui spécifie la valeur à utiliser. Les valeurs disponibles sont les suivantes : InterpolationMethod.LINEAR_RGB
et InterpolationMethod.RGB
L’exemple suivant montre un dégradé linéaire simple entre deux couleurs (le paramètre spreadMethod
étant défini sur SpreadMethod.REFLECT
). Les différentes méthodes d’interpolation modifient l’aspect de la façon suivante :
InterpolationMethod.LINEAR_RGB | InterpolationMethod.RGB |
Implémentation
public function get interpolationMethod():String
public function set interpolationMethod(value:String):void
Eléments de l’API associés
matrix | propriété |
public var matrix:Matrix
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Matrice de transformation définie par la classe Matrix. La classe flash.geom.Matrix inclut une méthode createGradientBox()
, qui permet de configurer la matrice en vue de l’utiliser avec la méthode beginGradientFill()
.
Eléments de l’API associés
ratios | propriété |
public var ratios:Array
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Tableau des taux de répartition des couleurs. Les valeurs disponibles sont comprises entre 0 et 255. Cette valeur définit le pourcentage de la largeur où la couleur est échantillonnée sur 100 %. La valeur 0 représente la position de gauche dans la zone de dégradés, tandis que la valeur 255 représente la position de droite.
Remarque : cette valeur représente les positions de la zone de dégradés, plutôt que l’espace de coordonnées du dégradé final, susceptible d’être plus large ou plus étroit que la zone de dégradés. Spécifiez une valeur correspondante pour chaque valeur dans la propriété colors
.
Par exemple, pour un dégradé linéaire qui comprend deux couleurs (bleu et vert), l’exemple suivant illustre l’emplacement des couleurs dans le dégradé selon les différentes valeurs du tableau ratios
:
ratios | Dégradé |
---|---|
[0, 127] | |
[0, 255] | |
[127, 255] |
Les valeurs du tableau doivent augmenter de manière séquentielle ; par exemple, [0, 63, 127, 190, 255]
.
spreadMethod | propriété |
spreadMethod:String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Valeur de la classe SpreadMethod qui spécifie la méthode d’étalement à utiliser. Les valeurs disponibles sont les suivantes : SpreadMethod.PAD
, SpreadMethod.REFLECT
et SpreadMethod.REPEAT
.
L’exemple suivant montre un dégradé linéaire simple entre deux couleurs :
import flash.geom.* import flash.display.* var fillType:String = GradientType.LINEAR; var colors:Array = [0xFF0000, 0x0000FF]; var alphas:Array = [1, 1]; var ratios:Array = [0x00, 0xFF]; var matr:Matrix = new Matrix(); matr.createGradientBox(20, 20, 0, 0, 0); var spreadMethod:String = SpreadMethod.PAD; this.graphics.beginGradientFill(fillType, colors, alphas, ratios, matr, spreadMethod); this.graphics.drawRect(0,0,100,100);
Cet exemple utilise SpreadMethod.PAD
comme méthode d’étalement, et le remplissage en dégradé prend l’aspect suivant :
Si vous utilisez SpreadMethod.REFLECT
comme méthode d’étalement, le remplissage en dégradé prend l’aspect suivant :
Si vous utilisez SpreadMethod.REPEAT
comme méthode d’étalement, le remplissage en dégradé prend l’aspect suivant :
Implémentation
public function get spreadMethod():String
public function set spreadMethod(value:String):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: | Flash Player 10, AIR 1.5 |
Valeur de la classe GradientType qui spécifie le type de dégradé à utiliser. Les valeurs disponibles sont GradientType.LINEAR
et GradientType.RADIAL
.
Implémentation
public function get type():String
public function set type(value:String):void
Eléments de l’API associés
GraphicsGradientFill | () | Constructeur |
public function GraphicsGradientFill(type:String = "linear", colors:Array = null, alphas:Array = null, ratios:Array = null, matrix:* = null, spreadMethod:* = pad, interpolationMethod:String = "rgb", focalPointRatio:Number = 0.0)
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Crée un nouvel objet GraphicsGradientFill.
Paramètrestype:String (default = "linear ") — Valeur de la classe GradientType qui spécifie le type de dégradé à utiliser : GradientType.LINEAR ou GradientType.RADIAL .
| |
colors:Array (default = null ) — Tableau de valeurs de couleurs RVB hexadécimales utilisé pour le dégradé (par exemple, rouge correspond à 0xFF0000, bleu à 0x0000FF, etc.). Vous pouvez définir jusqu’à 15 couleurs. Pour chaque couleur, définissez une valeur correspondante dans les paramètres alphas et ratios.
| |
alphas:Array (default = null ) — Tableau de valeurs alpha pour les couleurs correspondantes du tableau de couleurs ; les valeurs disponibles sont comprises entre 0 et 1. Si la valeur est inférieure à 0, 0 est utilisé. Si la valeur est supérieure à 1, 1 est utilisé.
| |
ratios:Array (default = null ) — Tableau de taux de distribution des couleurs ; les valeurs disponibles sont comprises entre 0 et 255. Cette valeur définit le pourcentage de la largeur où la couleur est échantillonnée sur 100 %. La valeur 0 représente la position de gauche dans la zone de dégradés, tandis que 255 représente la position de droite.
| |
matrix:* (default = null ) — Matrice de transformation définie par la classe flash.geom.Matrix. La classe flash.geom.Matrix inclut une méthode createGradientBox() , qui permet de configurer facilement la matrice en vue de son utilisation avec la méthode beginGradientFill() .
| |
spreadMethod:* (default = pad ) — Valeur de la classe SpreadMethod qui spécifie la méthode d’étalement à utiliser : SpreadMethod.PAD , SpreadMethod.REFLECT ou SpreadMethod.REPEAT .
| |
interpolationMethod:String (default = "rgb ") — Valeur de la classe InterpolationMethod qui spécifie la valeur à utiliser : InterpolationMethod.LINEAR_RGB ou InterpolationMethod.RGB
| |
focalPointRatio:Number (default = 0.0 ) — Nombre qui contrôle l’emplacement du point focal du dégradé. Une valeur de 0 permet de définir le point focal au centre. Une valeur de 1 permet de définir le point focal sur l’un des bords du cercle du dégradé. Une valeur de -1 permet de définir le point focal sur l’autre bord du cercle du dégradé. Toute valeur inférieure à -1 ou supérieure à 1 est respectivement arrondie à -1 ou 1.
|
Eléments de l’API associés
Tue Jun 12 2018, 09:30 AM Z