Package | flash.display |
Class | public final class GraphicsStroke |
Inheritance | GraphicsStroke Object |
Implements | IGraphicsData, IGraphicsStroke |
Language version: | ActionScript 3.0 |
Runtime version: | AIR 1.5 |
Use a GraphicsStroke object with the Graphics.drawGraphicsData()
method.
Drawing a GraphicsStroke object is the equivalent of calling one of the methods of the Graphics
class that sets the line style, such as the Graphics.lineStyle()
method, the
Graphics.lineBitmapStyle()
method, or the Graphics.lineGradientStyle()
method.
See also
Property | Defined by | ||
---|---|---|---|
caps : String
Specifies the type of caps at the end
of lines.
| GraphicsStroke | ||
constructor : Object
A reference to the class object or constructor function for a given object instance.
| Object | ||
fill : IGraphicsFill
Specifies the instance containing data for filling a stroke.
| GraphicsStroke | ||
joints : String
Specifies the type of joint appearance
used at angles.
| GraphicsStroke | ||
miterLimit : Number
Indicates the limit at which a miter is cut off.
| GraphicsStroke | ||
pixelHinting : Boolean
Specifies whether to hint strokes
to full pixels.
| GraphicsStroke | ||
prototype : Object
[static]
A reference to the prototype object of a class or function object.
| Object | ||
scaleMode : String
Specifies the stroke thickness scaling.
| GraphicsStroke | ||
thickness : Number
Indicates the thickness of the line in
points; valid values are 0-255.
| GraphicsStroke |
Method | Defined by | ||
---|---|---|---|
GraphicsStroke(thickness:Number, pixelHinting:Boolean = false, scaleMode:String = "normal", caps:String = "none", joints:String = "round", miterLimit:Number = 3.0, fill:IGraphicsFill = null)
Creates a new GraphicsStroke object.
| GraphicsStroke | ||
Indicates whether an object has a specified property defined.
| Object | ||
Indicates whether an instance of the Object class is in the prototype chain of the object specified
as the parameter.
| Object | ||
Indicates whether the specified property exists and is enumerable.
| Object | ||
Sets the availability of a dynamic property for loop operations.
| Object | ||
Returns the string representation of this object, formatted according to locale-specific conventions.
| Object | ||
Returns the string representation of the specified object.
| Object | ||
Returns the primitive value of the specified object.
| Object |
caps | property |
caps:String
[read-write]
Language version: | ActionScript 3.0 |
Runtime version: | AIR 1.5 |
Specifies the type of caps at the end
of lines. Valid values are: CapsStyle.NONE
, CapsStyle.ROUND
, and CapsStyle.SQUARE
.
If a value is not indicated, Flash uses round caps.
For example, the following illustrations show the different capsStyle
settings. For each setting, the illustration shows a blue line with a thickness of 30 (for
which the capsStyle
applies), and a superimposed black line with a thickness of 1
(for which no capsStyle
applies):
public function get caps():String
public function set caps(value:String):void
See also
fill | property |
public var fill:IGraphicsFill
Language version: | ActionScript 3.0 |
Runtime version: | AIR 1.5 |
Specifies the instance containing data for filling a stroke. An IGraphicsFill instance can represent a series of fill commands.
See also
joints | property |
joints:String
[read-write]
Language version: | ActionScript 3.0 |
Runtime version: | AIR 1.5 |
Specifies the type of joint appearance
used at angles. Valid
values are: JointStyle.BEVEL
, JointStyle.MITER
, and JointStyle.ROUND
.
If a value is not indicated, Flash uses round joints.
For example, the following illustrations show the different joints
settings. For each setting, the illustration shows an angled blue line with a thickness of
30 (for which the jointStyle
applies), and a superimposed angled black line with a
thickness of 1 (for which no jointStyle
applies):
Note: For joints
set to JointStyle.MITER
,
you can use the miterLimit
parameter to limit the length of the miter.
public function get joints():String
public function set joints(value:String):void
See also
miterLimit | property |
public var miterLimit:Number
Language version: | ActionScript 3.0 |
Runtime version: | AIR 1.5 |
Indicates the limit at which a miter is cut off.
Valid values range from 1 to 255 (and values outside that range are rounded to 1 or 255).
This value is only used if the jointStyle
is set to "miter"
. The
miterLimit
value represents the length that a miter can extend beyond the point
at which the lines meet to form a joint. The value expresses a factor of the line
thickness
. For example, with a miterLimit
factor of 2.5 and a
thickness
of 10 pixels, the miter is cut off at 25 pixels.
For example, consider the following angled lines, each drawn with a thickness
of 20, but with miterLimit
set to 1, 2, and 4. Superimposed are black reference
lines showing the meeting points of the joints:
Notice that a given miterLimit
value has a specific maximum angle
for which the miter is cut off. The following table lists some examples:
miterLimit value: | Angles smaller than this are cut off: |
---|---|
1.414 | 90 degrees |
2 | 60 degrees |
4 | 30 degrees |
8 | 15 degrees |
pixelHinting | property |
public var pixelHinting:Boolean
Language version: | ActionScript 3.0 |
Runtime version: | AIR 1.5 |
Specifies whether to hint strokes
to full pixels. This affects both the position of anchors of a curve and the line stroke size
itself. With pixelHinting
set to true
, Flash Player hints line widths
to full pixel widths. With pixelHinting
set to false
, disjoints can
appear for curves and straight lines. For example, the following illustrations show how
Flash Player renders two rounded rectangles that are identical, except that the
pixelHinting
parameter used in the lineStyle()
method is set
differently (the images are scaled by 200%, to emphasize the difference):
scaleMode | property |
scaleMode:String
[read-write]
Language version: | ActionScript 3.0 |
Runtime version: | AIR 1.5 |
Specifies the stroke thickness scaling. Valid values are:
LineScaleMode.NORMAL
—Always scale the line thickness when the object is scaled
(the default).
LineScaleMode.NONE
—Never scale the line thickness.
LineScaleMode.VERTICAL
—Do not scale the line thickness if the object is scaled vertically
only. For example, consider the following circles, drawn with a one-pixel line, and each with the
scaleMode
parameter set to LineScaleMode.VERTICAL
. The circle on the left
is scaled vertically only, and the circle on the right is scaled both vertically and horizontally:
LineScaleMode.HORIZONTAL
—Do not scale the line thickness if the object is scaled horizontally
only. For example, consider the following circles, drawn with a one-pixel line, and each with the
scaleMode
parameter set to LineScaleMode.HORIZONTAL
. The circle on the left
is scaled horizontally only, and the circle on the right is scaled both vertically and horizontally:
public function get scaleMode():String
public function set scaleMode(value:String):void
See also
thickness | property |
public var thickness:Number
Language version: | ActionScript 3.0 |
Runtime version: | AIR 1.5 |
Indicates the thickness of the line in points; valid values are 0-255. If a number is not specified, or if the parameter is undefined, a line is not drawn. If a value of less than 0 is passed, the default is 0. The value 0 indicates hairline thickness; the maximum thickness is 255. If a value greater than 255 is passed, the default is 255.
GraphicsStroke | () | constructor |
public function GraphicsStroke(thickness:Number, pixelHinting:Boolean = false, scaleMode:String = "normal", caps:String = "none", joints:String = "round", miterLimit:Number = 3.0, fill:IGraphicsFill = null)
Language version: | ActionScript 3.0 |
Runtime version: | AIR 1.5 |
Creates a new GraphicsStroke object.
Parametersthickness:Number — An integer that indicates the thickness of the line in
points; valid values are 0-255. If a number is not specified, or if the
parameter is undefined, a line is not drawn. If a value of less than 0 is passed,
the default is 0. The value 0 indicates hairline thickness; the maximum thickness
is 255. If a value greater than 255 is passed, the default is 255.
|
|||||||||||
pixelHinting:Boolean (default = false ) — A Boolean value that specifies whether to hint strokes
to full pixels. This affects both the position of anchors of a curve and the line stroke size
itself. With pixelHinting set to true , Flash Player hints line widths
to full pixel widths. With pixelHinting set to false , disjoints can
appear for curves and straight lines. For example, the following illustrations show how
Flash Player renders two rounded rectangles that are identical, except that the
pixelHinting parameter used in the lineStyle() method is set
differently (the images are scaled by 200%, to emphasize the difference):
If a value is not supplied, the line does not use pixel hinting. |
|||||||||||
scaleMode:String (default = "normal ") — A value from the LineScaleMode class that
specifies which scale mode to use:
|
|||||||||||
caps:String (default = "none ") — A value from the CapsStyle class that specifies the type of caps at the end
of lines. Valid values are: CapsStyle.NONE , CapsStyle.ROUND , and CapsStyle.SQUARE .
If a value is not indicated, Flash uses round caps.
For example, the following illustrations show the different |
|||||||||||
joints:String (default = "round ") — A value from the JointStyle class that specifies the type of joint appearance
used at angles. Valid
values are: JointStyle.BEVEL , JointStyle.MITER , and JointStyle.ROUND .
If a value is not indicated, Flash uses round joints.
For example, the following illustrations show the different Note: For |
|||||||||||
miterLimit:Number (default = 3.0 ) — A number that indicates the limit at which a miter is cut off.
Valid values range from 1 to 255 (and values outside that range are rounded to 1 or 255).
This value is only used if the jointStyle
is set to "miter" . The
miterLimit value represents the length that a miter can extend beyond the point
at which the lines meet to form a joint. The value expresses a factor of the line
thickness . For example, with a miterLimit factor of 2.5 and a
thickness of 10 pixels, the miter is cut off at 25 pixels.
For example, consider the following angled lines, each drawn with a Notice that a given
|
|||||||||||
fill:IGraphicsFill (default = null ) — An IGraphicsFill instance containing data for filling a stroke. An IGraphicsFill
instance can represent a series of fill commands.
|
See also