flash.display.JointStyle - Adobe® Flex® 4 Language Reference (Flex 4)

Package	flash.display
Class	public final class JointStyle
Inheritance	JointStyle Object

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0 Flash Player 9

The JointStyle class is an enumeration of constant values that specify the joint style to use in drawing lines. These constants are provided for use as values in the joints parameter of the flash.display.Graphics.lineStyle() method. The method supports three types of joints: miter, round, and bevel, as the following example shows:

MITER, ROUND, and BEVEL

View the examples

See also

flash.display.Graphics.lineStyle()

Public Properties

Hide Inherited Public Properties

Show Inherited Public Properties

	Property		Defined By
		constructor : Object A reference to the class object or constructor function for a given object instance.	Object
		prototype : Object [static] A reference to the prototype object of a class or function object.	Object

Public Methods

Hide Inherited Public Methods

Show Inherited Public Methods

	Method		Defined By
		hasOwnProperty(name:String):Boolean Indicates whether an object has a specified property defined.	Object
		isPrototypeOf(theClass:Object):Boolean Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.	Object
		propertyIsEnumerable(name:String):Boolean Indicates whether the specified property exists and is enumerable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Sets the availability of a dynamic property for loop operations.	Object
		toLocaleString():String Returns the string representation of this object, formatted according to locale-specific conventions.	Object
		toString():String Returns the string representation of the specified object.	Object
		valueOf():Object Returns the primitive value of the specified object.	Object

Public Constants

	Constant		Defined By
		BEVEL : String = "bevel" [static] Specifies beveled joints in the joints parameter of the flash.display.Graphics.lineStyle() method.	JointStyle
		MITER : String = "miter" [static] Specifies mitered joints in the joints parameter of the flash.display.Graphics.lineStyle() method.	JointStyle
		ROUND : String = "round" [static] Specifies round joints in the joints parameter of the flash.display.Graphics.lineStyle() method.	JointStyle

Constant Detail

BEVEL

Constant

public static const BEVEL:String = "bevel"

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0 Flash Player 9

Specifies beveled joints in the joints parameter of the flash.display.Graphics.lineStyle() method.

MITER

Constant

public static const MITER:String = "miter"

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0 Flash Player 9

Specifies mitered joints in the joints parameter of the flash.display.Graphics.lineStyle() method.

ROUND

Constant

public static const ROUND:String = "round"

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0 Flash Player 9

Specifies round joints in the joints parameter of the flash.display.Graphics.lineStyle() method.

Examples ( How to use this example )

JointStyleExample.as

The following example uses the JointStyleExample class to show the result of three different joint styles applied to three sets of joined lines. This task is accomplished by performing the following steps:

The properties of each line are set as follows:
- The line length is set to 80 pixels.
- The border color is set to orange.
- The border size is set to 30 pixels.
- The highlight color is set to gray.
- The highlight size is set to zero pixels.
- The alpha is set to 1, making it solid.
- The pixel hinting is set to false (strokes not hinted to full pixels).
- The line scale mode is set to normal, which scales the thickness.
- The border caps and miter limit are declared but not set, so the default values are used.
The class constructor creates three sets of two connected line segments. The segments start at x = 0, y = 0 by calling the doDrawCorner() method three times using the three joint styles (miter, round, and bevel). Each of the three calls to doDrawCorner() uses the joint style and properties previously listed to draw two connected line segments and associated line highlights. This is done by first creating a new Shape object child and then using methods of the Graphics class to set the line style and draw the lines and highlights. Each instance of child is added to the display list and promptly drawn on the stage.
The connected line segments are then redrawn by using the refreshLayout() method at y = 80 pixels and starting at x = 80 pixels, with a 25-pixel separation between the line segments.

package {
    import flash.display.DisplayObject;
    import flash.display.Graphics;
    import flash.display.JointStyle;
    import flash.display.LineScaleMode;
    import flash.display.Shape;
    import flash.display.Sprite;

    public class JointStyleExample extends Sprite {
        private var size:uint                  = 80;
        private var borderColor:uint           = 0xFFCC00;
        private var borderSize:uint            = 30;
        private var highlightColor:uint        = 0x666666;
        private var highlightSize:uint         = 0;
        private var gutter:uint                = 25;
        private var borderAlpha:uint           = 1;
        private var borderPixelHinting:Boolean = false;
        private var borderScaleMode:String     = LineScaleMode.NORMAL;
        private var borderCaps:String;
        private var borderMiterLimit:uint;

        public function JointStyleExample() {
            doDrawCorner(JointStyle.MITER);
            doDrawCorner(JointStyle.ROUND);
            doDrawCorner(JointStyle.BEVEL);
            refreshLayout();
        }

        private function doDrawCorner(jointStyle:String):void {
            var halfSize:uint = Math.round(size / 2);
            var child:Shape = new Shape();
            child.graphics.lineStyle(borderSize,
                                     borderColor,
                                     borderAlpha,
                                     borderPixelHinting,
                                     borderScaleMode,
                                     borderCaps,
                                     jointStyle,
                                     borderMiterLimit);
            child.graphics.lineTo(0, 0);
            child.graphics.lineTo(size, 0);
            child.graphics.lineTo(halfSize, size);
            child.graphics.endFill();

            child.graphics.moveTo(0, 0);
            child.graphics.lineStyle(highlightSize, highlightColor);
            child.graphics.lineTo(0, 0);
            child.graphics.lineTo(size, 0);
            child.graphics.lineTo(halfSize, size);

            addChild(child);
        }

        private function refreshLayout():void {
            var ln:uint = numChildren;
            var child:DisplayObject;
            var lastChild:DisplayObject = getChildAt(0);
            lastChild.x = size;
            lastChild.y = size;
            for (var i:uint = 1; i < ln; i++) {
                child = getChildAt(i);
                child.x = gutter + lastChild.x + lastChild.width;
                child.y = size;
                lastChild = child;
            }
        }
    }
}