| 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 |
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.lineBitmapStyle()
flash.display.Graphics.lineGradientStyle()
flash.display.Graphics.drawGraphicsData()
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 | ||
| 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 | ||
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | |
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
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):
Implementazione
public function get caps():String public function set caps(value:String):voidElementi API correlati
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
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):
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):voidElementi API correlati
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:
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):
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 parametroscaleModeimpostato suLineScaleMode.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 parametroscaleModeimpostato suLineScaleMode.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):voidElementi API correlati
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.
GraphicsStroke | () | 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.
Parametrithickness:Number (default = NaN) | |||||||||||
pixelHinting:Boolean (default = false)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):
Se non fornite un valore, non viene utilizzata l'approssimazione dei pixel (pixel hinting) per la linea. | |||||||||||
scaleMode:String (default = "normal")
| |||||||||||
caps:String (default = "none")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
| |||||||||||
joints:String (default = "round")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
Nota: per | |||||||||||
miterLimit:Number (default = 3.0)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
Potete notare che un determinato valore
| |||||||||||
fill:IGraphicsFill (default = null) |
Elementi API correlati
Tue Jun 12 2018, 02:44 PM Z