M > MovieClip.beginGradientFill

MovieClip.beginGradientFill

Disponibilité

Flash Player 6.

Usage

monClip.beginGradientFill (typeDeRemplissage, couleurs, alphas, rapports, matrice)

Paramètre

typeDeRemplissage Soit la chaîne "linear" ou la chaîne "radial".

couleurs Un tableau des valeurs hexadécimales RVB à utiliser dans le dégradé (par exemple, le rouge est 0xFF0000, le bleu est 0x0000FF, etc.).

alphas Un tableau de valeurs alpha pour les couleurs correspondantes du tableau couleurs, les valeurs valides étant 0-100. Si la valeur est inférieure à 0, Flash utilise 0. Si la valeur est supérieure à 100, Flash utilise 100.

rapports Un tableau de rapports de distribution des couleurs, les valeurs valides étant 0-255. Cette valeur définit le pourcentage de la largeur où la couleur est échantillonnée à 100 %.

matrice Une matrice de transformation qui est un objet avec l'un des deux ensembles de propriétés suivants.

	a, b, c, d, e, f, g, h, i, qui peuvent être utilisés pour décrire une matrice 3x3 au format suivant :
	a b c d e f g h i

	L'exemple suivant utilise une méthode beginGradientFill avec un paramètre matrice, qui est un objet avec ces propriétés.
	_root.createEmptyMovieClip( "dégradé", 1 ); with ( _root.dégradé ) { couleurs = [ 0xFF0000, 0x0000FF ]; alphas = [ 100, 100 ]; rapports = [ 0, 0xFF ]; matrice = { a:200, b:0, c:0, d:0, e:200, f:0, g:200, h:200, i:1 }; beginGradientFill( "linear", couleurs, alphas, rapports, matrice ); moveto(100,100); lineto(100,300); lineto(300,300); lineto(300,100); lineto(100,100); endFill(); }

Si une propriété typeDeMatrice n'existe pas, les autres paramètres sont tous requis (la fonction échoue s'ils ne sont pas tous présents). Cette matrice redimensionne, translate, pivote et incline le gradient unitaire qui est défini à (-1,-1) et (1,1).

typeDeMatrice, x, y, l, h, r.

	Les propriétés indiquent : typeDeMatrice est la chaîne "box", x est la position horizontale relative au point d'alignement du clip parent pour le coin supérieur gauche du dégradé, y est la position verticale relative au point d'alignement du clip parent pour le coin supérieur gauche du dégradé, l est la largeur du gradient, h est la hauteur du dégradé et r est la rotation du dégradé, en radians.
	L'exemple suivant utilise une méthode beginGradientFill avec un paramètre matrice, qui est un objet avec ces propriétés.
	_root.createEmptyMovieClip( "dégradé", 1 ); with ( _root.dégradé ) { couleurs = [ 0xFF0000, 0x0000FF ]; alphas = [ 100, 100 ]; rapports = [ 0, 0xFF ]; matrice = { typeDeMatrice:"box", x:100, y:100, l:200, h:200, r:(45/180)*Math.PI }; beginGradientFill( "linear", couleurs, alphas, rapports, matrice ); moveto(100,100); lineto(100,300); lineto(300,300); lineto(300,100); lineto(100,100); endFill(); }

Si une propriété typeDeMatrice existe, elle doit être égale à "box" et les autres paramètres sont tous obligatoires. La fonction échoue si une ou plusieurs de ces conditions ne sont pas remplies.

Renvoie

Rien.

Description

Méthode ; indique le début d'un nouveau trajet de dessin. Si le premier paramètre est undefined, ou si aucun paramètre n'est transmis, le trajet n'a aucun remplissage. Si un chemin ouvert existe, c'est-à-dire si la position de dessin actuelle n'est pas égale à la position précédente spécifiée dans une méthode moveTo et qu'un remplissage y est associé, ce chemin est fermé avec un trait, puis rempli. Cela est semblable à ce qui se produit à l'appel de la méthode endFill.

Cette méthode échoue si une ou plusieurs des conditions suivantes existent :

	Le nombre d'éléments dans les paramètres couleurs, alphas et rapports n'est pas le même.
	Le paramètre typeDeRemplissage n'est ni "linear" ni "radial".
	Un ou plusieurs des champs de l'objet pour le paramètre matrice sont absents ou invalides.

Exemple

Le code suivant utilise les deux méthodes pour tracer deux rectangles empilés avec un remplissage dégradé rouge-bleu et un trait vert de 5 points.

_root.createEmptyMovieClip("goober",1);
with ( _root.goober )
{
	couleurs = [ 0xFF0000, 0x0000FF ];
	alphas = [ 100, 100 ];
	rapports = [ 0, 0xFF ];
	lineStyle( 5, 0x00ff00 );
	matrice = { a:500,b:0,c:0,d:0,e:200,f:0,g:350,h:200,i:1};
	beginGradientFill( "linear", couleurs, alphas, rapports, matrice );
	moveto(100,100);
	lineto(100,300);
	lineto(600,300);
	lineto(600,100);
	lineto(100,100);
	endFill();
	matrice = { typeDeMatrice:"box", x:100, y:310, l:500, h:200, r:(0/180)*Math.PI }; 
	beginGradientFill( "linear", couleurs, alphas, rapports, matrice );
	moveto(100,310);
	lineto(100,510);
	lineto(600,510);
	lineto(600,310);
	lineto(100,310);
	endFill();
}

Voir aussi

MovieClip.beginFill, MovieClip.endFill, MovieClip.lineStyle, MovieClip.lineTo, MovieClip.moveTo