GraphicsStroke

Pacchetto	flash.display
Classe	public final class GraphicsStroke
Ereditarietà	GraphicsStroke Object
Implementa	IGraphicsStroke, IGraphicsData

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Definisce lo stile o il tratto di una linea.

Utilizzate un oggetto GraphicsStroke con il metodo Graphics.drawGraphicsData(). Il disegno di un oggetto GraphicsStroke equivale a una chiamata a uno dei metodi della classe Graphics che imposta lo stile della linea, ad esempio il metodo Graphics.lineStyle(), Graphics.lineBitmapStyle() o Graphics.lineGradientStyle().

Elementi API correlati

flash.display.Graphics.lineStyle()
flash.display.Graphics.lineBitmapStyle()
flash.display.Graphics.lineGradientStyle()
flash.display.Graphics.drawGraphicsData()

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		caps : String Specifica il tipo di estremità alla fine delle linee.	GraphicsStroke
		constructor : Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object
		fill : IGraphicsFill Specifica l'istanza contenente i dati per il riempimento di un tratto.	GraphicsStroke
		joints : String Specifica il tipo di aspetto dello spigolo utilizzato per gli angoli.	GraphicsStroke
		miterLimit : Number Indica il limite in corrispondenza del quale lo spigolo viene troncato.	GraphicsStroke
		pixelHinting : Boolean Specifica se approssimare i tratti ai pixel pieni.	GraphicsStroke
		scaleMode : String Specifica la modifica in scala dello spessore del tratto.	GraphicsStroke
		thickness : Number Indica lo spessore della linea, espresso in punti; i valori validi sono compresi tra 0 e 255.	GraphicsStroke

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		GraphicsStroke(thickness:Number = NaN, pixelHinting:Boolean = false, scaleMode:String = "normal", caps:String = "none", joints:String = "round", miterLimit:Number = 3.0, fill:IGraphicsFill = null) Crea un nuovo oggetto GraphicsStroke.	GraphicsStroke
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object

Descrizione delle proprietà

caps

proprietà

caps:String

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Specifica il tipo di estremità alla fine delle linee. I valori validi sono CapsStyle.NONE, CapsStyle.ROUND e CapsStyle.SQUARE. Se non viene indicato un valore, Flash utilizza estremità arrotondate.

Nelle illustrazioni seguenti, ad esempio, vengono visualizzate le diverse impostazioni di capsStyle. Per ciascuna impostazione, nell'illustrazione viene visualizzata una linea blu con uno spessore 30 (per la quale si applica capsStyle), e una linea nera sovrapposta con spessore 1 (per la quale non si applica capsStyle):

NONE, ROUND e SQUARE

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

Elementi API correlati

flash.display.CapsStyle

fill

proprietà

public var fill:IGraphicsFill

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Specifica l'istanza contenente i dati per il riempimento di un tratto. Un'istanza IGraphicsFill può rappresentare una serie di comandi di riempimento.

Elementi API correlati

flash.display.IGraphicsFill

joints

proprietà

joints:String

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Specifica il tipo di aspetto dello spigolo utilizzato per gli angoli. I valori validi sono JointStyle.BEVEL, JointStyle.MITER e JointStyle.ROUND. Se non viene indicato un valore, Flash utilizza spigoli arrotondati.

Nelle illustrazioni seguenti, ad esempio, vengono visualizzate le diverse impostazioni di joints. Per ciascuna impostazione, nell'illustrazione viene visualizzata una linea blu ad angolo con uno spessore 30 (per la quale si applica jointStyle), e una linea nera ad angolo sovrapposta con spessore 1 (per la quale non si applica jointStyle):

MITER, ROUND e BEVEL

Nota: per joints impostato su JointStyle.MITER, potete limitare la lunghezza della giunzione ad angolo utilizzando il parametro miterLimit.

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

Elementi API correlati

flash.display.JointStyle

miterLimit

proprietà

public var miterLimit:Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Indica il limite in corrispondenza del quale lo spigolo viene troncato. L'intervallo di valori validi è compreso tra 1 e 255, e i valori non compresi in questo intervallo vengono approssimati a 1 o 255. Il valore viene utilizzato solo se jointStyle è impostato su "miter". Il valore miterLimit rappresenta la lunghezza per la quale una giunzione ad angolo può estendersi oltre il punto in cui le linee si incontrano per costituire uno spigolo. Il valore esprime un fattore del valore thickness della linea. Ad esempio, con un fattore miterLimit 2,5 ed un valore di 10 pixel per thickness, lo spigolo viene troncato a 25 pixel.

Considerate ad esempio le seguenti linee angolari, ciascuna tracciata con thickness pari a 20, ma con miterLimit impostato su 1, 2 e 4. Sono sovrapposte le linee di riferimento di colore nero che mostrano i punti di incontro degli spigoli:

linee con miterLimit impostato su 1, 2 e 4

Potete notare che un determinato valore miterLimit ha un angolo massimo specifico per il quale lo spigolo viene troncato. Nella tabella seguente sono riportati alcuni esempi:

Valore `miterLimit`:	Gli angoli di dimensioni inferiori a questo vengono troncati:
1.414	90 gradi
2	60 gradi
4	30 gradi
8	15 gradi

pixelHinting

proprietà

public var pixelHinting:Boolean

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Specifica se approssimare i tratti ai pixel pieni. Incide sia sulla posizione degli ancoraggi di una curva, sia sulle dimensioni stesse del tratto della linea. Con pixelHinting impostato su true, Flash Player approssima la larghezza delle linee alla larghezza dei pixel interi. Con pixelHinting impostato su false, possono apparire delle discontinuità nelle curve e nelle linee rette. Ad esempio, le illustrazioni seguenti mostrano come Flash Player esegue il rendering di due rettangoli arrotondati che sono identici tranne che per l'impostazione del parametro pixelHinting utilizzato nel metodo lineStyle() (le immagini sono ingrandite al 200% per evidenziare la differenza):

pixelHinting false e pixelHinting true

scaleMode

proprietà

scaleMode:String

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Specifica la modifica in scala dello spessore del tratto. I valori validi sono:

LineScaleMode.NORMAL: lo spessore delle linee viene sempre modificato in scala quando l'oggetto è modificato in scala (impostazione predefinita).
LineScaleMode.NONE: lo spessore delle linee non viene mai modificato in scala.
LineScaleMode.VERTICAL: lo spessore delle linee non viene modificato in scala se l'oggetto è modificato in scala solo verticalmente. Osservate, ad esempio, i seguenti cerchi, tracciati con una linea da un pixel e con il parametro scaleMode impostato su LineScaleMode.VERTICAL. Il cerchio di sinistra è modificato in scala solo verticalmente, mentre quello di destra sia in senso verticale che orizzontale:
LineScaleMode.HORIZONTAL: lo spessore delle linee non viene modificato in scala se l'oggetto è modificato in scala solo orizzontalmente. Osservate, ad esempio, i seguenti cerchi, tracciati con una linea da un pixel e con il parametro scaleMode impostato su LineScaleMode.HORIZONTAL. Il cerchio di sinistra è modificato in scala solo orizzontalmente, mentre quello di destra sia in senso orizzontale che verticale:

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

Elementi API correlati

flash.display.LineScaleMode

thickness

proprietà

public var thickness:Number

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Indica lo spessore della linea, espresso in punti; i valori validi sono compresi tra 0 e 255. Se questo valore non viene specificato o se il parametro non è definito, non viene disegnata alcuna linea. Se viene passato un valore minore di 0, il valore predefinito è 0. Il valore 0 indica uno spessore sottilissimo; lo spessore massimo è 255. Se è maggiore di 255, il valore predefinito è 255.

Descrizione della funzione di costruzione

()

Funzione di costruzione

public function GraphicsStroke(thickness:Number = NaN, pixelHinting:Boolean = false, scaleMode:String = "normal", caps:String = "none", joints:String = "round", miterLimit:Number = 3.0, fill:IGraphicsFill = null)

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

Flash Player 10, AIR 1.5

Crea un nuovo oggetto GraphicsStroke.

Parametri

thickness:Number (default = NaN) — Un numero intero che indica lo spessore della linea, espresso in punti; i valori validi sono compresi tra 0 e 255. Se questo valore non viene specificato o se il parametro non è definito, non viene disegnata alcuna linea. Se viene passato un valore minore di 0, il valore predefinito è 0. Il valore 0 indica uno spessore sottilissimo; lo spessore massimo è 255. Se è maggiore di 255, il valore predefinito è 255.

pixelHinting:Boolean (default = false) — Un valore booleano che specifica se approssimare i tratti ai pixel pieni. Incide sia sulla posizione degli ancoraggi di una curva, sia sulle dimensioni stesse del tratto della linea. Con pixelHinting impostato su true, Flash Player approssima la larghezza delle linee alla larghezza dei pixel interi. Con pixelHinting impostato su false, possono apparire delle discontinuità nelle curve e nelle linee rette. Ad esempio, le illustrazioni seguenti mostrano come Flash Player esegue il rendering di due rettangoli arrotondati che sono identici tranne che per l'impostazione del parametro pixelHinting utilizzato nel metodo lineStyle() (le immagini sono ingrandite al 200% per evidenziare la differenza):

pixelHinting false e pixelHinting true

Se non fornite un valore, non viene utilizzata l'approssimazione dei pixel (pixel hinting) per la linea.

scaleMode:String (default = "normal") — Un valore della classe LineScaleMode che specifica la modalità scala da utilizzare:

LineScaleMode.NORMAL: lo spessore delle linee viene sempre modificato in scala quando l'oggetto è modificato in scala (impostazione predefinita).
LineScaleMode.NONE: lo spessore delle linee non viene mai modificato in scala.
LineScaleMode.VERTICAL: lo spessore delle linee non viene modificato in scala se l'oggetto è modificato in scala solo verticalmente. Osservate, ad esempio, i seguenti cerchi, tracciati con una linea da un pixel e con il parametro scaleMode impostato su LineScaleMode.VERTICAL. Il cerchio di sinistra è modificato in scala solo verticalmente, mentre quello di destra sia in senso verticale che orizzontale:
LineScaleMode.HORIZONTAL: lo spessore delle linee non viene modificato in scala se l'oggetto è modificato in scala solo orizzontalmente. Osservate, ad esempio, i seguenti cerchi, tracciati con una linea da un pixel e con il parametro scaleMode impostato su LineScaleMode.HORIZONTAL. Il cerchio di sinistra è modificato in scala solo orizzontalmente, mentre quello di destra sia in senso orizzontale che verticale:

caps:String (default = "none") — Un valore della classe CapsStyle che specifica il tipo di estremità alla fine delle linee. I valori validi sono CapsStyle.NONE, CapsStyle.ROUND e CapsStyle.SQUARE. Se non viene indicato un valore, Flash utilizza estremità arrotondate.

NONE, ROUND e SQUARE

joints:String (default = "round") — Un valore della classe JointStyle che specifica il tipo di aspetto dello spigolo utilizzato per gli angoli. I valori validi sono JointStyle.BEVEL, JointStyle.MITER e JointStyle.ROUND. Se non viene indicato un valore, Flash utilizza spigoli arrotondati.

MITER, ROUND e BEVEL

Nota: per joints impostato su JointStyle.MITER, potete limitare la lunghezza della giunzione ad angolo utilizzando il parametro miterLimit.

miterLimit:Number (default = 3.0) — Un numero che indica il limite in corrispondenza del quale lo spigolo viene troncato. L'intervallo di valori validi è compreso tra 1 e 255, e i valori non compresi in questo intervallo vengono approssimati a 1 o 255. Il valore viene utilizzato solo se jointStyle è impostato su "miter". Il valore miterLimit rappresenta la lunghezza per la quale una giunzione ad angolo può estendersi oltre il punto in cui le linee si incontrano per costituire uno spigolo. Il valore esprime un fattore del valore thickness della linea. Ad esempio, con un fattore miterLimit 2,5 ed un valore di 10 pixel per thickness, lo spigolo viene troncato a 25 pixel.

linee con miterLimit impostato su 1, 2 e 4

Potete notare che un determinato valore miterLimit ha un angolo massimo specifico per il quale lo spigolo viene troncato. Nella tabella seguente sono riportati alcuni esempi:

Valore `miterLimit`:	Gli angoli di dimensioni inferiori a questo vengono troncati:
1.414	90 gradi
2	60 gradi
4	30 gradi
8	15 gradi

fill:IGraphicsFill (default = null) — Un'istanza IGraphicsFill contenente i dati per il riempimento di un tratto. Un'istanza IGraphicsFill può rappresentare una serie di comandi di riempimento.

Elementi API correlati

flash.display.LineScaleMode
flash.display.CapsStyle
flash.display.JointStyle
flash.display.IGraphicsFill

Note legali | Informativa sulla privacy online

GraphicsStroke - AS3

Pacchettix

Elementi del linguaggio

Appendici

Pacchetto flash.display

caps

fill

joints

miterLimit

pixelHinting

scaleMode

thickness

GraphicsStroke