Guida di riferimento di ActionScript® 3.0 per la piattaforma Adobe® Flash®
Home  |  Nascondi elenco pacchetti e classi |  Pacchetti  |  Classi  |  Novità  |  Indice  |  Appendici  |  Perché in inglese?
Filtri: Recupero dati dal server...
Recupero dati dal server...
flash.display 

GraphicsGradientFill  - AS3

Pacchettoflash.display
Classepublic final class GraphicsGradientFill
EreditarietàGraphicsGradientFill Inheritance Object
Implementa IGraphicsFill, IGraphicsData

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Definisce un riempimento con gradiente.

Utilizzate un oggetto GraphicsGradientFill con il metodo Graphics.drawGraphicsData(). Il disegno di un oggetto GraphicsGradientFill equivale a una chiamata al metodo Graphics.beginGradientFill().

Elementi API correlati



Proprietà pubbliche
 ProprietàDefinito da
  alphas : Array
Un array di valori alfa per i colori corrispondenti nell'array dei colori.
GraphicsGradientFill
  colors : Array
Un array di valori di colore esadecimali RGB da utilizzare nel gradiente.
GraphicsGradientFill
 Inheritedconstructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
  focalPointRatio : Number
Un numero che controlla la posizione del punto focale del gradiente.
GraphicsGradientFill
  interpolationMethod : String
Un valore della classe InterpolationMethod che specifica il valore da utilizzare.
GraphicsGradientFill
  matrix : Matrix
Una matrice di trasformazione definita dalla classe Matrix.
GraphicsGradientFill
  ratios : Array
Un array di rapporti di distribuzione del colore.
GraphicsGradientFill
  spreadMethod : String
Un valore della classe SpreadMethod che specifica il metodo spread da utilizzare.
GraphicsGradientFill
  type : String
Un valore della classe GradientType che specifica il tipo di gradiente da utilizzare.
GraphicsGradientFill
Metodi pubblici
 MetodoDefinito da
  
GraphicsGradientFill(type:String = "linear", colors:Array = null, alphas:Array = null, ratios:Array = null, matrix:* = null, spreadMethod:* = pad, interpolationMethod:String = "rgb", focalPointRatio:Number = 0.0)
Crea un nuovo oggetto GraphicsGradientFill.
GraphicsGradientFill
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.
Object
 Inherited
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
Object
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Descrizione delle proprietà

alphas

proprietà
public var alphas:Array

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Un array di valori alfa per i colori corrispondenti nell'array dei colori. I valori validi sono compresi tra 0 e 1. Se il valore è minore di 0, viene utilizzato 0. Se il valore è maggiore di 1, viene utilizzato 1.

colors

proprietà 
public var colors:Array

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Un array di valori di colore esadecimali RGB da utilizzare nel gradiente. Ad esempio il rosso è 0xFF0000, il blu è 0x0000FF e così via. È possibile specificare fino a 15 colori. Per ciascun colore, specificate un valore corrispondente nelle proprietà alphas e ratios.

focalPointRatio

proprietà 
public var focalPointRatio:Number

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Un numero che controlla la posizione del punto focale del gradiente. Un valore 0 imposta il punto focale al centro. Un valore 1 significa che il punto focale si trova su un bordo del cerchio del gradiente. Un valore -1 imposta il punto focale sull'altro bordo del cerchio del gradiente. Un valore inferiore a -1 o maggiore di 1 viene arrotondato rispettivamente a -1 o 1. Quando riportato di seguito mostra, ad esempio, focalPointRatio impostato su 0,75:

gradiente radiale con focalPointRatio impostato su 0,75

interpolationMethod

proprietà 
interpolationMethod:String

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Un valore della classe InterpolationMethod che specifica il valore da utilizzare. I valori validi sono: InterpolationMethod.LINEAR_RGB o InterpolationMethod.RGB

Quanto riportato di seguito mostra, ad esempio, un gradiente lineare semplice tra due colori (con il parametro spreadMethod impostato su SpreadMethod.REFLECT). I diversi metodi di interpolazione modificano l'aspetto come illustrato di seguito:

gradiente lineare con InterpolationMethod.LINEAR_RGB gradiente lineare con InterpolationMethod.RGB
InterpolationMethod.LINEAR_RGBInterpolationMethod.RGB



Implementazione
    public function get interpolationMethod():String
    public function set interpolationMethod(value:String):void

Elementi API correlati

matrix

proprietà 
public var matrix:Matrix

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Una matrice di trasformazione definita dalla classe Matrix. La classe flash.geom.Matrix include un metodo createGradientBox(), che consente di impostare la matrice affinché possa essere utilizzata con il metodo beginGradientFill().

Elementi API correlati

ratios

proprietà 
public var ratios:Array

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Un array di rapporti di distribuzione del colore. I valori validi sono compresi tra 0 e 255. Questo valore definisce la percentuale della larghezza in cui il colore viene campionato al 100%. Il valore 0 rappresenta la posizione di sinistra nel riquadro del gradiente, mentre il valore 255 rappresenta la posizione di destra.

Nota: questo valore rappresenta le posizioni all'interno del riquadro del gradiente, non nello spazio di coordinate del gradiente finale, che può essere più largo o più stretto del riquadro del gradiente. Specificate un valore corrispondente a ciascun valore nella proprietà colors.

Ad esempio, per un gradiente lineare che include due colori (blu e verde), nell'esempio seguente è illustrata la posizione dei colori nel gradiente in base ai diversi valori dell'array ratios:

ratiosGradiente
[0, 127]gradiente lineare blu-verde con rapporti 0 e 127
[0, 255]gradiente lineare blu-verde con rapporti 0 e 255
[127, 255]gradiente lineare blu-verde con rapporti 127 e 255

I valori nell'array devono aumentare in maniera sequenziale; ad esempio, [0, 63, 127, 190, 255].

spreadMethod

proprietà 
spreadMethod:String

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Un valore della classe SpreadMethod che specifica il metodo spread da utilizzare. I valori validi sono: SpreadMethod.PAD, SpreadMethod.REFLECT o SpreadMethod.REPEAT.

Quanto riportato di seguito mostra, ad esempio, un semplice gradiente lineare tra due colori:

     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);
     

Nell'esempio viene utilizzato SpreadMethod.PAD per il metodo spread e il riempimento del gradiente ha il seguente aspetto:

gradiente lineare con SpreadMethod.PAD

Se utilizzate SpreadMethod.REFLECT per il metodo spread, il riempimento del gradiente ha il seguente aspetto:

gradiente lineare con SpreadMethod.REFLECT

Se si utilizza SpreadMethod.REPEAT per il metodo spread, il riempimento del gradiente ha il seguente aspetto:

gradiente lineare con SpreadMethod.REPEAT



Implementazione
    public function get spreadMethod():String
    public function set spreadMethod(value:String):void

Elementi API correlati

type

proprietà 
type:String

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Un valore della classe GradientType che specifica il tipo di gradiente da utilizzare. I valori sono GradientType.LINEAR o GradientType.RADIAL.



Implementazione
    public function get type():String
    public function set type(value:String):void

Elementi API correlati

Descrizione della funzione di costruzione

GraphicsGradientFill

()Funzione di costruzione
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)

Versione linguaggio: ActionScript 3.0
Versioni runtime: Flash Player 10, AIR 1.5

Crea un nuovo oggetto GraphicsGradientFill.

Parametri
type:String (default = "linear") — Un valore della classe GradientType che specifica il tipo di gradiente da utilizzare: GradientType.LINEAR o GradientType.RADIAL.
 
colors:Array (default = null) — Un array di valori di colore RGB esadecimali da utilizzare nel gradiente (ad esempio, il rosso è 0xFF0000, il blu 0x0000FF e così via). È possibile specificare fino a 15 colori. Per ciascun colore, accertarsi di specificare un valore corrispondente nei parametri alphas e ratios.
 
alphas:Array (default = null) — Un array di valori alfa per i colori corrispondenti nell'array dei colori; i valori validi sono compresi tra 0 e 1. Se il valore è minore di 0, viene utilizzato 0. Se il valore è maggiore di 1, viene utilizzato 1.
 
ratios:Array (default = null) — Un array di rapporti di distribuzione del colore; i valori validi sono compresi tra 0 e 255. Questo valore definisce la percentuale della larghezza in corrispondenza della quale il campionamento del colore viene eseguito al 100%. Il valore 0 rappresenta la posizione di sinistra nel riquadro del gradiente, mentre 255 rappresenta la posizione di destra.
 
matrix:* (default = null) — Una matrice di trasformazione definita dalla classe flash.geom.Matrix. La classe flash.geom.Matrix include un metodo createGradientBox(), che consente di impostare con facilità la matrice affinché possa essere utilizzata con il metodo beginGradientFill().
 
spreadMethod:* (default = pad) — Un valore della classe SpreadMethod che specifica il metodo spread da utilizzare: SpreadMethod.PAD, SpreadMethod.REFLECT o SpreadMethod.REPEAT.
 
interpolationMethod:String (default = "rgb") — Un valore della classe InterpolationMethod che specifica il valore da utilizzare: InterpolationMethod.LINEAR_RGB o InterpolationMethod.RGB
 
focalPointRatio:Number (default = 0.0) — Un numero che controlla la posizione del punto focale del gradiente. Un valore 0 imposta il punto focale al centro. Un valore 1 imposta il punto focale su un bordo del cerchio del gradiente. Un valore -1 imposta il punto focale sull'altro bordo del cerchio del gradiente. Un valore inferiore a -1 o maggiore di 1 viene arrotondato rispettivamente a -1 o 1.

Elementi API correlati





[ X ]Perché in inglese?
Il contenuto della Guida di riferimento di ActionScript 3.0 appare in inglese

Non tutte le parti della Guida di riferimento di ActionScript 3.0 sono tradotte in tutte le lingue. Quando un elemento del linguaggio non è tradotto, viene riportato in inglese. Ad esempio, la classe ga.controls.HelpBox non è tradotta in nessuna lingua. Pertanto, nella versione italiana della guida di riferimento, la descrizione della classe ga.controls.HelpBox è riportata in inglese.