MovieClip.beginGradientFill()

Disponibilidad

Flash Player 6.

Sintaxis

my_mc.beginGradientFill(fillType, colors, alphas, ratios, matrix)

Parámetro

fillType La cadena "linear" o la cadena "radial".

colors Matriz de valores de color hexadecimales RGB que debe utilizarse en el degradado (por ejemplo, rojo es 0xFF0000, azul es 0x0000FF, etc.).

alphas Matriz de valores alfa para los colores correspondientes de la matriz colors; los valores válidos son de 0 a 100. Si el valor es inferior a 0, Flash utiliza 0; si el valor es superior a 100, Flash utiliza 100.

ratios Matriz de relaciones de distribución de colores; los valores válidos son de 0 a 255. Este valor define el porcentaje de la anchura a la que el color se muestrea al cien por cien.

matrix Matriz de transformación que es un objeto con uno de los dos siguientes conjuntos de propiedades.

Si existe una propiedad matrixType, debe ser igual a "box" y todos los demás parámetros son obligatorios. La función falla si no se cumple alguna de estas condiciones.

Valor devuelto

Ninguno.

Descripción

Método; indica el comienzo de un nuevo trazado de dibujo. Si el primer parámetro tiene el valor undefined o si no se pasa ningún parámetro, el trazado no tiene relleno. Si hay un trazado abierto (es decir, si la posición actual del dibujo no es la misma que la posición anterior especificada en un método moveTo()) y éste tiene un relleno asociado, el trazado se cierra con una línea y, a continuación, se rellena. Este comportamiento es parecido al que se produce al llamar a endFill().

Este método falla si se produce alguna de las condiciones siguientes:

Ejemplo

El código siguiente utiliza ambos métodos para dibujar dos rectángulos apilados con un relleno en degradado rojo-azul y un trazo verde sólido de 5 puntos.

_root.createEmptyMovieClip("goober",1);
with ( _root.goober )
{
  colors = [ 0xFF0000, 0x0000FF ];
  alphas = [ 100, 100 ];
  ratios = [ 0, 0xFF ];
  lineStyle( 5, 0x00ff00 );
  matrix = { a:500,b:0,c:0,d:0,e:200,f:0,g:350,h:200,i:1};
  beginGradientFill( "linear", colors, alphas, ratios, matrix );
  moveto(100.100);
  lineto(100.300);
  lineto(600.300);
  lineto(600.100);
  lineto(100.100);
  endFill();
  matrix = { matrixType:"box", x:100, y:310, w:500, h:200, r:(0/180)*Math.PI }; 
  beginGradientFill( "linear", colors, alphas, ratios, matrix );
  moveto(100.310);
  lineto(100.510);
  lineto(600.510);
  lineto(600.310);
  lineto(100.310);
  endFill();
}

Véase también

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