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
 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
  bounds : Rectangle
[read-only] The tight bounds of this element as represented by a Rectangle object.
Path
  data : String
Path short hand data value.
Path
  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
 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
 InheritedhasEventManager : Boolean
Tests to see if a EventDispatcher instance has been created for this object.
DegrafaObject
 Inheritedid : String
The identifier used by document to refer to this object.
DegrafaObject
 Inheritedinvalidated : Boolean
Specifies whether this object is to be re calculated on the next cycle.
Geometry
 Inheritedname : String
The name that refers to this object.
DegrafaObject
  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
 Inheritedstroke : IGraphicsStroke
Defines the stroke object that will be used for rendering this geometry object.
Geometry
 InheritedsuppressEventProcessing : Boolean
Temporarily suppress event processing for this object.
DegrafaObject
Protected Properties
 PropertyDefined by
  commandStack : Array
An Array of flash rendering commands that make up this element.
Path
 InheritedeventDispatcher : EventDispatcher
EventDispatcher instance for this object.
DegrafaObject
Public Methods
 MethodDefined by
  
Path(data:String = null)
Constructor.
Path
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event.
DegrafaObject
 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
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
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
  
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
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
Events
 EventSummaryDefined by
 Inherited  DegrafaObject
 Inherited  DegrafaObject
Property detail
boundsproperty
bounds:Rectangle  [read-only]

The tight bounds of this element as represented by a Rectangle object.

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

Implementation
    public function get bounds():Rectangle
commandStackproperty 
protected var commandStack:Array

An Array of flash rendering commands that make up this element.

dataproperty 
data:String  [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():String
    public function set data(value:String):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
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.