Packagecom.degrafa.geometry
Classpublic class Path
InheritancePath Inheritance Geometry Inheritance DegrafaObject
ImplementsIGeometry

The Path element draws a path comprised of several available path commands using the specified path data value.

Paths represent the geometry of the outline of an object, defined in terms of moveto (set a new current point), lineto (draw a straight line), curveto (draw a curve using a cubic Bézier), arc (elliptical or circular arc) and closepath (close the current shape by drawing a line to the last moveto) elements.

Default MXML Propertysegments

See also

http://www.w3.org/TR/SVG/paths.html
http://samples.degrafa.com/Path/Path.html


Public Properties
 PropertyDefined by
 Inheritedalpha : Number
The alpha setting that applies to this object.
Geometry
 InheritedautoClearGraphicsTarget : Boolean
When using a graphicsTarget and if this property is set to true the draw phase will clear the graphics context before drawing.
Geometry
 Inheritedbottom : Number
When set, the bottom of the layout will be located offset from the bottom of it's parent.
Geometry
 Inheritedbounds : Rectangle
The tight bounds of this element as represented by a Rectangle.
Geometry
 InheritedclippingRectangle : Rectangle
A clipping rectangle to use when rendering this geometry.
Geometry
 InheritedcommandStack : CommandStack
Provides access to the command stack.
Geometry
 InheritedcurrentState : String
The current view state.
Geometry
  data : Object
Path short hand data value.
Path
 InheriteddecoratorCollection : DecoratorCollection
Access to the Decorator collection object for this Geometry object.
Geometry
 Inheriteddecorators : Array
A array of IDecorator objects to be applied on this Geometry.
Geometry
  derive : Path
[write-only] An object to derive this objects properties from.
Path
 Inheriteddocument : Object
The MXML document that created this object.
DegrafaObject
 InheritedenableEvents : Boolean
Enable events for this object.
DegrafaObject
 Inheritedfill : IGraphicsFill
Defines the fill object that will be used for rendering this geometry object.
Geometry
 Inheritedfilters : Array
An array of BitmapFilter objects applied to this Geometry.
Geometry
 InheritedgeometricLength : Number
Returns geometric length of this object.
Geometry
 Inheritedgeometry : Array
A array of IGeometryComposition objects.
Geometry
 InheritedgeometryCollection : GeometryCollection
Access to the Degrafa geometry collection object for this geometry object.
Geometry
 InheritedgraphicsTarget : Array
One or more display object's that this Geometry is to be drawn to.
Geometry
 InheritedgraphicsTargetCollection : DisplayObjectCollection
Access to the Degrafa target collection object for this geometry object.
Geometry
 InheritedhasDecorators : Boolean
Returns true if this Geometry has decorators.
Geometry
 InheritedhasEventManager : Boolean
Tests to see if a EventDispatcher instance has been created for this object.
DegrafaObject
 InheritedhasFilters : Boolean
Returns true if this Geometry has filters.
Geometry
 InheritedhasLayout : Boolean
Returns true if this Geometry has layout.
Geometry
 InheritedhasStates : Boolean
Returns true if this Geometry has states.
Geometry
 InheritedhasTriggers : Boolean
Returns true if this Geometry has triggers.
Geometry
 Inheritedheight : Number
Defines the height of the layout boundary.
Geometry
 InheritedhorizontalCenter : Number
When set, if left or right is not set, the layout will be centered horizontally offset by the numeric value of this property.
Geometry
 Inheritedid : String
The identifier used by document to refer to this object.
DegrafaObject
 InheritedIGraphicParent : IGraphic
Geometry
 InheritedinheritFill : Boolean
If set to true and no fill is defined and there is a parent object then this object will walk up through the parents to retrive a fill object.
Geometry
 InheritedinheritStroke : Boolean
If set to true and no stroke is defined and there is a parent object then this object will walk up through the parents to retrive a stroke object.
Geometry
 Inheritedinvalidated : Boolean
Specifies whether this object is to be re calculated on the next cycle.
Geometry
 InheritedisInitialized : Boolean
DegrafaObject
 InheritedisInvalidated : Boolean
Returns true if this Geometry object is invalidated
Geometry
 InheritedisRootGeometry : Boolean
Returns true if this Geometry object is a root Geometry Object.
Geometry
 InheritedlayoutConstraint : LayoutConstraint
The layout constraint that is used for positioning/sizing this geometry object.
Geometry
 Inherited_layoutMatrix : Matrix
Access to the layout matrix if this Geometry has layout.
Geometry
 InheritedlayoutRectangle : Rectangle
Returns the constraint based layout rectangle for this object or bounds if no layout constraint is specified.
Geometry
 Inheritedleft : Number
When set, the left of the layout will be located offset by the value of this property multiplied by the containing width.
Geometry
 InheritedmaintainAspectRatio : Boolean
When true, the size of the layout will always maintain an aspect ratio relative to the ratio of the current width and height properties, even if those properties are not in control of the height and width of the layout.
Geometry
 Inheritedmask : IGeometryComposition
A separate geometry object to use as a mask when rendering this geometry.
Geometry
 InheritedmaskMode : String
The mode used when this object is being masked by the geometry assigned to the mask property.
Geometry
 InheritedmaskSpace : String
The coordinate space within which the referenced mask geometry is rendered before being applied as a mask (respecting maskMode) to this object.
Geometry
 InheritedmaxHeight : Number
The maximum height that can be applied to the layout.
Geometry
 InheritedmaxWidth : Number
The maximum width that can be applied to the layout.
Geometry
 InheritedmaxX : Number
The maximum x location that can be applied to the layout.
Geometry
 InheritedmaxY : Number
The maximum y location that can be applied to the layout.
Geometry
 InheritedminHeight : Number
The minimum height that can be applied to the layout.
Geometry
 InheritedminWidth : Number
The minimum width that can be applied to the layout.
Geometry
 InheritedminX : Number
The minimum x location that can be applied to the layout.
Geometry
 InheritedminY : Number
The minimum y location that can be applied to the layout.
Geometry
 Inheritedname : String
The name that refers to this object.
DegrafaObject
 InheritedobjectBindings : Array
DegrafaObject
 Inheritedparent : IDegrafaObject
The current degrafa object parent.
DegrafaObject
 InheritedpercentHeight : Number
When set, the height of the layout will be set as the value of this property multiplied by the containing height.
Geometry
 InheritedpercentWidth : Number
When set, the width of the layout will be set as the value of this property multiplied by the containing width.
Geometry
 Inheritedright : Number
When set, the right of the layout will be located offset by the value of this property multiplied by the containing width.
Geometry
 InheritedscaleOnLayout : Boolean
When using layout this flag will determine if you want Scale to be applied to fit layout rules
Geometry
  segmentCollection : SegmentsCollection
[read-only] Access to the Degrafa segment collection object for this path.
Path
  segments : Array
A array of segments that describe this path.
Path
 Inheritedstate : String
The state at which to draw this object.
Geometry
 InheritedstateEvent : String
The state event at which to draw this object.
Geometry
 Inheritedstates : Array
An array of states defined for this Geometry.
Geometry
 Inheritedstroke : IGraphicsStroke
Defines the stroke object that will be used for rendering this geometry object.
Geometry
 InheritedstyleName : Object
The css style name associated with this Geometry.
Geometry
 InheritedsuppressEventProcessing : Boolean
Temporarily suppress event processing for this object.
DegrafaObject
 InheritedtargetCoordinateSpace : DisplayObject
The display object that defines the coordinate system to use.
Geometry
 Inheritedtop : Number
When set, the top of the layout will be located offset from the top of it's parent.
Geometry
 Inheritedtransform : ITransform
Defines the transform object that will be used for rendering this geometry object.
Geometry
 InheritedtransformBounds : Rectangle
Returns a transformed version of this objects bounds as represented by a Rectangle.
Geometry
 InheritedtransformContext : Matrix
A reference to the transformation matrix context within which local transforms will be applied.
Geometry
 Inheritedtriggers : Array
An array of ITrigger objects that this Geometry object will use.
Geometry
 InheritedverticalCenter : Number
When set, if top or bottom is not set, the layout will be centered vertically offset by the numeric value of this property.
Geometry
 Inheritedvisible : Boolean
Controls the visibility of this geometry object.
Geometry
 Inheritedwidth : Number
Defines the width of the layout.
Geometry
 Inheritedx : Number
Defines the x location (top left) of the layout.
Geometry
 Inheritedy : Number
Defines the y location (top left) of the layout.
Geometry
Protected Properties
 PropertyDefined by
 InheritedeventDispatcher : EventDispatcher
EventDispatcher instance for this object.
DegrafaObject
 Inherited_fill : IGraphicsFill
Geometry
 Inherited_stroke : IGraphicsStroke
Geometry
Public Methods
 MethodDefined by
  
Path(data:String = null)
Constructor.
Path
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = true):void
Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event.
DegrafaObject
 Inherited
angleAt(t:Number):Number
Returns the angle of a point t(0-1) on the path.
Geometry
  
calculateLayout(childBounds:Rectangle = null):void
Performs the specific layout work required by this Geometry.
Path
 Inherited
Clears all graphics targets specified in the graphicsTarget array.
Geometry
 Inherited
dispatchEvent(evt:Event):Boolean
Dispatches an event into the event flow.
DegrafaObject
 Inherited
dispatchPropertyChange(bubbles:Boolean = false, property:Object = null, oldValue:Object = null, newValue:Object = null, source:Object = null):Boolean
Dispatches an property change event into the event flow.
DegrafaObject
  
draw(graphics:Graphics, rc:Rectangle):void
Begins the draw phase for geometry objects.
Path
 Inherited
Requests a draw for each graphics target specified in the graphicsTarget array.
Geometry
 Inherited
endDraw(graphics:Graphics):void
Ends the draw phase for geometry objects.
Geometry
 Inherited
hasEventListener(type:String):Boolean
Checks whether the EventDispatcher object has any listeners registered for a specific type of event.
DegrafaObject
 Inherited
initChange(property:String, oldValue:Object, newValue:Object, source:Object):void
Helper function for dispatching property changes
DegrafaObject
 Inherited
initFill(graphics:Graphics, rc:Rectangle):void
Initialise the fill for this geometry object.
Geometry
 Inherited
initialized(document:Object, id:String):void
Called after the implementing object has been created and all component properties specified on the MXML tag have been initialized.
DegrafaObject
 Inherited
initStroke(graphics:Graphics, rc:Rectangle):void
Initialise the stroke for this geometry object.
Geometry
 Inherited
pointAt(t:Number):Point
Returns the point at t(0-1) on this object.
Geometry
  
preDraw():void
Performs any pre calculation that is required to successfully render this element.
Path
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Removes a listener from the EventDispatcher object.
DegrafaObject
 Inherited
styleChanged(styleProp:String):void
Called when the value of a style property is changed.
Geometry
 Inherited
willTrigger(type:String):Boolean
Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type.
DegrafaObject
Protected Methods
 MethodDefined by
  
propertyChangeHandler(event:PropertyChangeEvent):void
Principle event handler for any property changes to a geometry object or it's child objects.
Path
Events
 EventSummaryDefined by
 Inherited  DegrafaObject
 Inherited  DegrafaObject
Property detail
dataproperty
data:Object  [read-write]

Path short hand data value.

The line data property expects exactly 1 value that defines the path. See below link to SVG path specification of which we follow most of.

This property can be used as the source for data binding.

Implementation
    public function get data():Object
    public function set data(value:Object):void

See also

deriveproperty 
derive:Path  [write-only]

An object to derive this objects properties from. When specified this object will derive it's unspecified properties from the passed object.

This property can be used as the source for data binding.

Implementation
    public function set derive(value:Path):void
segmentCollectionproperty 
segmentCollection:SegmentsCollection  [read-only]

Access to the Degrafa segment collection object for this path.

This property can be used as the source for data binding.

Implementation
    public function get segmentCollection():SegmentsCollection
segmentsproperty 
segments:Array  [read-write]

A array of segments that describe this path.

This property can be used as the source for data binding.

Implementation
    public function get segments():Array
    public function set segments(value:Array):void
Constructor detail
Path()constructor
public function Path(data:String = null)

Constructor.

The path constructor accepts 1 optional argument that defines it's segments.

Parameters
data:String (default = null) — A string representing 1 or more segment commands with which to draw the path.
Method detail
calculateLayout()method
public override function calculateLayout(childBounds:Rectangle = null):void

Performs the specific layout work required by this Geometry.

Parameters
childBounds:Rectangle (default = null) — the bounds to be layed out. If not specified a rectangle of (0,0,1,1) is used.
draw()method 
public override function draw(graphics:Graphics, rc:Rectangle):void

Begins the draw phase for geometry objects. All geometry objects override this to do their specific rendering.

Parameters
graphics:Graphics — The current context to draw to.
 
rc:Rectangle — A Rectangle object used for fill bounds.
preDraw()method 
public override function preDraw():void

Performs any pre calculation that is required to successfully render this element. Including bounds calculations and lower level drawing command storage. Each geometry object overrides this and is responsible for it's own pre calculation cycle.

propertyChangeHandler()method 
protected override function propertyChangeHandler(event:PropertyChangeEvent):void

Principle event handler for any property changes to a geometry object or it's child objects.

Parameters
event:PropertyChangeEvent