GraphicsStroke

Pakket	flash.display
Klasse	public final class GraphicsStroke
Overerving	GraphicsStroke Object
Implementatie	IGraphicsStroke, IGraphicsData

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

Definieert een lijnstijl of tekenhaal.

Gebruik een GraphicsStroke-object met de methode Graphics.drawGraphicsData(). Een GraphicsStroke-object tekenen heeft hetzelfde effect als het aanroepen van een van de methoden van de Graphics-klasse waarmee de lijnstijl wordt ingesteld, zoals de methode Graphics.lineStyle(), de methode Graphics.lineBitmapStyle() of de methode Graphics.lineGradientStyle().

Verwante API-elementen

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

Openbare eigenschappen

Overerfde openbare eigenschappen verbergen

Overerfde openbare eigenschappen weergeven

	Eigenschap		Gedefinieerd door
		caps : String Geeft het type uiteinde van lijnen aan.	GraphicsStroke
		constructor : Object Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.	Object
		fill : IGraphicsFill Geeft de instantie aan met gegevens voor het vullen van een streek.	GraphicsStroke
		joints : String Geeft het type verbinding aan dat wordt gebruikt bij hoeken.	GraphicsStroke
		miterLimit : Number Geeft de limiet aan waarboven het verstek wordt afgesneden.	GraphicsStroke
		pixelHinting : Boolean Geeft aan of streken moeten worden omgezet in volledige pixels.	GraphicsStroke
		scaleMode : String Geeft de schaal aan voor de dikte van de streek.	GraphicsStroke
		thickness : Number Geeft de dikte van de lijn in punten aan; geldige waarden zijn 0 tot en met 255.	GraphicsStroke

Openbare methoden

Overerfde openbare methoden verbergen

Overerfde openbare methoden weergeven

	Methode		Gedefinieerd door
		GraphicsStroke(thickness:Number = NaN, pixelHinting:Boolean = false, scaleMode:String = "normal", caps:String = "none", joints:String = "round", miterLimit:Number = 3.0, fill:IGraphicsFill = null) Maakt een nieuw GraphicsStroke-object.	GraphicsStroke
		hasOwnProperty(name:String):Boolean Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.	Object
		isPrototypeOf(theClass:Object):Boolean Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven.	Object
		propertyIsEnumerable(name:String):Boolean Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.	Object
		toLocaleString():String Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies.	Object
		toString():String Retourneert een tekenreeksrepresentatie van het opgegeven object.	Object
		valueOf():Object Retourneert de primitieve waarde van het opgegeven object.	Object

Eigenschapdetails

caps	eigenschap

caps:String

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

Geeft het type uiteinde van lijnen aan. Geldige waarden zijn: CapsStyle.NONE, CapsStyle.ROUND en CapsStyle.SQUARE. Wanneer geen waarde wordt aangegeven, gebruikt Flash ronde uiteinden.

De volgende afbeeldingen tonen bijvoorbeeld de verschillende instellingen van capsStyle. Voor elke instelling wordt in de afbeelding een blauwe lijn met een dikte van 30 weergegeven (waarop een capsStyle is toegepast) en een overlappende zwarte lijn met een dikte van 1 (waarop geen capsStyle is toegepast):

NONE, ROUND en SQUARE

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

Verwante API-elementen

flash.display.CapsStyle

fill

eigenschap

public var fill:IGraphicsFill

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

Geeft de instantie aan met gegevens voor het vullen van een streek. Een IGraphicsFill-instantie kan een reeks vulopdrachten vertegenwoordigen.

Verwante API-elementen

flash.display.IGraphicsFill

joints

eigenschap

joints:String

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

Geeft het type verbinding aan dat wordt gebruikt bij hoeken. Geldige waarden zijn: JointStyle.BEVEL, JointStyle.MITER en JointStyle.ROUND. Wanneer geen waarde wordt aangegeven, gebruikt Flash ronde verbindingspunten.

De volgende afbeeldingen tonen bijvoorbeeld de verschillende instellingen van joints. Voor elke instelling wordt in de afbeelding een gehoekte blauwe lijn met een dikte van 30 weergegeven (waarop de jointStyle is toegepast) en een overlappende gehoekte zwarte lijn met een dikte van 1 (waarop geen jointStyle is toegepast):

VERSTEK, ROND en SCHUIN

Opmerking: wanneer joints is ingesteld op JointStyle.MITER, kunt u de parameter miterLimit gebruikt om de lengte van het verstek te beperken.

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

Verwante API-elementen

flash.display.JointStyle

miterLimit

eigenschap

public var miterLimit:Number

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

Geeft de limiet aan waarboven het verstek wordt afgesneden. Geldige waarden lopen van 1 tot en met 255 (en waarden buiten dat bereik worden afgerond naar 1 of 255). Deze waarde wordt alleen gebruikt wanneer jointStyle is ingesteld op miter. De waarde miterLimit vertegenwoordigt de lengte die een verstek kan uitsteken voorbij het punt waarop de lijnen samenkomen om een verbindingspunt te vormen. De waarde wordt uitgedrukt als een factor van de thickness van de lijn. Bij een miterLimit-factor van 2,5 en een thickness van 10 pixels wordt het verstek bij 25 pixels afgesneden.

Neem bijvoorbeeld de volgende gehoekte lijnen, elk getekend met een thickness van 20, maar waarvoor miterLimit is ingesteld op 1, 2 en 4. De overlappende zwarte referentielijnen geven de punten van samenkomst van de verbindingspunten aan:

lijnen met miterLimit ingesteld op 1, 2 en 4

Voor een bepaalde waarde van miterLimit geldt een specifieke maximumhoek waarop het verstek wordt afgesneden. De volgende tabel bevat een aantal voorbeelden:

`miterLimit`-waarde:	Kleinere hoeken worden afgesneden:
1.414	90 graden
2	60 graden
4	30 graden
8	15 graden

pixelHinting

eigenschap

public var pixelHinting:Boolean

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

Geeft aan of streken moeten worden omgezet in volledige pixels. Dit is van toepassing op zowel de positie van ankers van een curve als op de streekdikte zelf. Wanneer pixelHinting is ingesteld op true, stelt Flash Player lijndikte in op hele pixels. Wanneer pixelHinting is ingesteld op false, kunnen onderbrekingen in curven en rechte lijnen ontstaan. In de volgende afbeeldingen wordt bijvoorbeeld getoond hoe Flash Player twee afgeronde rechthoeken tekent die identiek aan elkaar zijn, behalve dat de parameter pixelHinting die in de methode lineStyle() wordt gebruikt, anders is ingesteld (de afbeeldingen zijn 200% geschaald om het verschil te benadrukken):

pixelHinting false en pixelHinting true

scaleMode

eigenschap

scaleMode:String

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

Geeft de schaal aan voor de dikte van de streek. Geldige waarden zijn:

LineScaleMode.NORMAL — De lijndikte altijd schalen wanneer het object wordt geschaald (de standaardinstelling).
LineScaleMode.NONE — De lijndikte nooit schalen.
LineScaleMode.VERTICAL — De lijndikte niet schalen wanneer het object uitsluitend verticaal wordt geschaald. Neem bijvoorbeeld de volgende cirkels, getekend met een lijn van één pixel, waarbij voor elke cirkel de parameter scaleMode is ingesteld op LineScaleMode.VERTICAL. De linkercirkel is alleen verticaal geschaald, terwijl de rechtercirkel zowel verticaal als horizontaal is geschaald.
LineScaleMode.HORIZONTAL — De lijndikte niet schalen wanneer het object uitsluitend horizontaal wordt geschaald. Neem bijvoorbeeld de volgende cirkels, getekend met een lijn van één pixel, waarbij voor elke cirkel de parameter scaleMode is ingesteld op LineScaleMode.HORIZONTAL. De linkercirkel is alleen horizontaal geschaald, terwijl de rechtercirkel zowel verticaal als horizontaal is geschaald.

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

Verwante API-elementen

flash.display.LineScaleMode

thickness

eigenschap

public var thickness:Number

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

Geeft de dikte van de lijn in punten aan; geldige waarden zijn 0 tot en met 255. Wanneer geen waarde wordt opgegeven of wanneer de parameter undefined is, wordt er geen lijn getekend. Wanneer een waarde kleiner dan 0 wordt doorgegeven, wordt standaard 0 gebruikt. De waarde 0 geeft de dikte van een haarlijn aan; de maximale dikte is 255. Wanneer een waarde groter dan 255 wordt doorgegeven, wordt standaard 255 gebruikt.

Constructordetails

()

Constructor

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)

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10, AIR 1.5

Maakt een nieuw GraphicsStroke-object.

Parameters

thickness:Number (default = NaN) — Een geheel getal dat de dikte van de lijn in punten aangeeft; geldige waarden zijn 0 tot en met 255. Wanneer geen waarde wordt opgegeven of wanneer de parameter undefined is, wordt er geen lijn getekend. Wanneer een waarde kleiner dan 0 wordt doorgegeven, wordt standaard 0 gebruikt. De waarde 0 geeft de dikte van een haarlijn aan; de maximale dikte is 255. Wanneer een waarde groter dan 255 wordt doorgegeven, wordt standaard 255 gebruikt.

pixelHinting:Boolean (default = false) — Een Booleaanse waarde die aangeeft of streken moeten worden ingesteld op hele pixels. Dit is van toepassing op zowel de positie van ankers van een curve als op de streekdikte zelf. Wanneer pixelHinting is ingesteld op true, stelt Flash Player lijndikte in op hele pixels. Wanneer pixelHinting is ingesteld op false, kunnen onderbrekingen in curven en rechte lijnen ontstaan. In de volgende afbeeldingen wordt bijvoorbeeld getoond hoe Flash Player twee afgeronde rechthoeken tekent die identiek aan elkaar zijn, behalve dat de parameter pixelHinting die in de methode lineStyle() wordt gebruikt, anders is ingesteld (de afbeeldingen zijn 200% geschaald om het verschil te benadrukken):

pixelHinting false en pixelHinting true

Wanneer geen waarde wordt opgegeven, wordt geen pixelhinting voor de lijn gebruikt.

scaleMode:String (default = "normal") — Een waarde uit de klasse LineScaleMode die opgeeft welke schaalmodus moet worden gebruikt:

LineScaleMode.NORMAL — De lijndikte altijd schalen wanneer het object wordt geschaald (de standaardinstelling).
LineScaleMode.NONE — De lijndikte nooit schalen.
LineScaleMode.VERTICAL — De lijndikte niet schalen wanneer het object uitsluitend verticaal wordt geschaald. Neem bijvoorbeeld de volgende cirkels, getekend met een lijn van één pixel, waarbij voor elke cirkel de parameter scaleMode is ingesteld op LineScaleMode.VERTICAL. De linkercirkel is alleen verticaal geschaald, terwijl de rechtercirkel zowel verticaal als horizontaal is geschaald.
LineScaleMode.HORIZONTAL — De lijndikte niet schalen wanneer het object uitsluitend horizontaal wordt geschaald. Neem bijvoorbeeld de volgende cirkels, getekend met een lijn van één pixel, waarbij voor elke cirkel de parameter scaleMode is ingesteld op LineScaleMode.HORIZONTAL. De linkercirkel is alleen horizontaal geschaald, terwijl de rechtercirkel zowel verticaal als horizontaal is geschaald.

caps:String (default = "none") — Een waarde uit de klasse CapsStyle die het type uiteinde van de lijnen aangeeft. Geldige waarden zijn: CapsStyle.NONE, CapsStyle.ROUND en CapsStyle.SQUARE. Wanneer geen waarde wordt aangegeven, gebruikt Flash ronde uiteinden.

NONE, ROUND en SQUARE

joints:String (default = "round") — Een waarde uit de klasse JointStyle die het type verbindingspunt voor hoeken aangeeft. Geldige waarden zijn: JointStyle.BEVEL, JointStyle.MITER en JointStyle.ROUND. Wanneer geen waarde wordt aangegeven, gebruikt Flash ronde verbindingspunten.

VERSTEK, ROND en SCHUIN

Opmerking: wanneer joints is ingesteld op JointStyle.MITER, kunt u de parameter miterLimit gebruikt om de lengte van het verstek te beperken.

miterLimit:Number (default = 3.0) — Een getal dat de limiet aangeeft waarboven het verstek wordt afgesneden. Geldige waarden lopen van 1 tot en met 255 (en waarden buiten dat bereik worden afgerond naar 1 of 255). Deze waarde wordt alleen gebruikt wanneer jointStyle is ingesteld op miter. De waarde miterLimit vertegenwoordigt de lengte die een verstek kan uitsteken voorbij het punt waarop de lijnen samenkomen om een verbindingspunt te vormen. De waarde wordt uitgedrukt als een factor van de thickness van de lijn. Bij een miterLimit-factor van 2,5 en een thickness van 10 pixels wordt het verstek bij 25 pixels afgesneden.

lijnen met miterLimit ingesteld op 1, 2 en 4

Voor een bepaalde waarde van miterLimit geldt een specifieke maximumhoek waarop het verstek wordt afgesneden. De volgende tabel bevat een aantal voorbeelden:

`miterLimit`-waarde:	Kleinere hoeken worden afgesneden:
1.414	90 graden
2	60 graden
4	30 graden
8	15 graden

fill:IGraphicsFill (default = null) — Een IGraphicsFill-instantie met gegevens voor het vullen van een streek. Een IGraphicsFill-instantie kan een reeks vulopdrachten vertegenwoordigen.

Verwante API-elementen

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

Juridische kennisgeving | Online privacybeleid

GraphicsStroke - AS3

Pakkettenx

Taalelementen

Bijlagen

Pakket flash.display

caps

fill

joints

miterLimit

pixelHinting

scaleMode

thickness

GraphicsStroke