| Package | com.degrafa.geometry.splines |
| Class | public class BasicSpline |
| Inheritance | BasicSpline  Geometry DegrafaObject |
| Implements | IGeometry, ISpline |
| Subclasses | CardinalSpline, CatmullRomSpline, NaturalCubicSpline, QuadraticHermiteSpline |
Default MXML Propertypoints
| Property | Defined by | ||
|---|---|---|---|
 | alpha : Number
The alpha setting that applies to this object.
| Geometry | |
| autoClearGraphicsTarget : Boolean
When using a graphicsTarget and if this property is set to true
the draw phase will clear the graphics context before drawing.
| Geometry | |
| bottom : Number
When set, the bottom of the layout will be located
offset from the bottom of it's parent.
| Geometry | |
| bounds : Rectangle
The tight bounds of this element as represented by a Rectangle.
| Geometry | |
| clippingRectangle : Rectangle
A clipping rectangle to use when rendering this geometry.
| Geometry | |
| commandStack : CommandStack
Provides access to the command stack.
| Geometry | |
| currentState : String
The current view state.
| Geometry | |
| data : Object
Allows a short hand property setting that is
specific to and parsed by each geometry object.
| Geometry | |
| decoratorCollection : DecoratorCollection
Access to the Decorator collection object for this Geometry object.
| Geometry | |
| decorators : Array
A array of IDecorator objects to be applied on this Geometry.
| Geometry | |
| document : Object
The MXML document that created this object.
| DegrafaObject | |
| enableEvents : Boolean
Enable events for this object.
| DegrafaObject | |
| fill : IGraphicsFill
Defines the fill object that will be used for
rendering this geometry object.
| Geometry | |
| filters : Array
An array of BitmapFilter objects applied to this Geometry.
| Geometry | |
| geometricLength : Number
Returns geometric length of this object.
| Geometry | |
| geometry : Array
A array of IGeometryComposition objects.
| Geometry | |
| geometryCollection : GeometryCollection
Access to the Degrafa geometry collection object for this geometry object.
| Geometry | |
| graphicsTarget : Array
One or more display object's that this Geometry is to be drawn to.
| Geometry | |
| graphicsTargetCollection : DisplayObjectCollection
Access to the Degrafa target collection object for this geometry object.
| Geometry | |
| hasDecorators : Boolean
Returns true if this Geometry has decorators.
| Geometry | |
| hasEventManager : Boolean
Tests to see if a EventDispatcher instance has been created for this object.
| DegrafaObject | |
| hasFilters : Boolean
Returns true if this Geometry has filters.
| Geometry | |
| hasLayout : Boolean
Returns true if this Geometry has layout.
| Geometry | |
| hasStates : Boolean
Returns true if this Geometry has states.
| Geometry | |
| hasTriggers : Boolean
Returns true if this Geometry has triggers.
| Geometry | |
| height : Number
Defines the height of the layout boundary.
| Geometry | |
| horizontalCenter : 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 | |
| id : String
The identifier used by document to refer to this object.
| DegrafaObject | |
| IGraphicParent : IGraphic | Geometry | |
| inheritFill : 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 | |
| inheritStroke : 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 | |
| invalidated : Boolean
Specifies whether this object is to be re calculated
on the next cycle.
| Geometry | |
| isInitialized : Boolean | DegrafaObject | |
| isInvalidated : Boolean
Returns true if this Geometry object is invalidated
| Geometry | |
| isRootGeometry : Boolean
Returns true if this Geometry object is a root Geometry Object.
| Geometry | |
| knotCount : int [read-only]
Access the knot count
| BasicSpline | ||
| knots : Object [write-only]
Assign the knot collection using a shorthand data value, similar to the Geometry data setter.
| BasicSpline | ||
| layoutConstraint : LayoutConstraint
The layout constraint that is used for positioning/sizing this geometry object.
| Geometry | |
| _layoutMatrix : Matrix
Access to the layout matrix if this Geometry has layout.
| Geometry | |
| layoutRectangle : Rectangle
Returns the constraint based layout rectangle for this object
or bounds if no layout constraint is specified.
| Geometry | |
| left : Number
When set, the left of the layout will be located
offset by the value of this property multiplied
by the containing width.
| Geometry | |
| maintainAspectRatio : 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 | |
| mask : IGeometryComposition
A separate geometry object to use as a mask when rendering this geometry.
| Geometry | |
| maskMode : String
The mode used when this object is being masked by the geometry assigned to the mask property.
| Geometry | |
| maskSpace : String
The coordinate space within which the referenced mask geometry is rendered before being applied as a mask (respecting maskMode)
to this object.
| Geometry | |
| maxHeight : Number
The maximum height that can be applied
to the layout.
| Geometry | |
| maxWidth : Number
The maximum width that can be applied
to the layout.
| Geometry | |
| maxX : Number
The maximum x location that can be applied
to the layout.
| Geometry | |
| maxY : Number
The maximum y location that can be applied
to the layout.
| Geometry | |
| minHeight : Number
The minimum height that can be applied
to the layout.
| Geometry | |
| minWidth : Number
The minimum width that can be applied
to the layout.
| Geometry | |
| minX : Number
The minimum x location that can be applied
to the layout.
| Geometry | |
| minY : Number
The minimum y location that can be applied
to the layout.
| Geometry | |
| name : String
The name that refers to this object.
| DegrafaObject | |
| objectBindings : Array | DegrafaObject | |
| parent : IDegrafaObject
The current degrafa object parent.
| DegrafaObject | |
| percentHeight : Number
When set, the height of the layout will be
set as the value of this property multiplied
by the containing height.
| Geometry | |
| percentWidth : Number
When set, the width of the layout will be
set as the value of this property multiplied
by the containing width.
| Geometry | |
| pointCollection : GraphicPointCollection
[read-only]
Access to the Degrafa point collection object for this spline.
| BasicSpline | ||
| points : Array
Access the array of points that describe the knot set.
| BasicSpline | ||
| quadApproximation : Array [read-only]
Access the direct sequence of quadratic Bezier data that approximates the spline, including index into starting quad at each knot.
| BasicSpline | ||
| right : Number
When set, the right of the layout will be located
offset by the value of this property multiplied
by the containing width.
| Geometry | |
| scaleOnLayout : Boolean
When using layout this flag will determine if you want
Scale to be applied to fit layout rules
| Geometry | |
| spline : IPlottableSpline
[write-only]
[set] spline Assign the reference to the IPlottableSpline providing the computational basis for this Degrafa spline. | BasicSpline | ||
| state : String
The state at which to draw this object.
| Geometry | |
| stateEvent : String
The state event at which to draw this object.
| Geometry | |
| states : Array
An array of states defined for this Geometry.
| Geometry | |
| stroke : IGraphicsStroke
Defines the stroke object that will be used for
rendering this geometry object.
| Geometry | |
| styleName : Object
The css style name associated with this Geometry.
| Geometry | |
| suppressEventProcessing : Boolean
Temporarily suppress event processing for this object.
| DegrafaObject | |
| targetCoordinateSpace : DisplayObject
The display object that defines the coordinate system to use.
| Geometry | |
| top : Number
When set, the top of the layout will be located
offset from the top of it's parent.
| Geometry | |
| transform : ITransform
Defines the transform object that will be used for
rendering this geometry object.
| Geometry | |
| transformBounds : Rectangle
Returns a transformed version of this objects bounds as
represented by a Rectangle.
| Geometry | |
| transformContext : Matrix
A reference to the transformation matrix context within which local transforms will be applied.
| Geometry | |
| triggers : Array
An array of ITrigger objects that this Geometry object will use.
| Geometry | |
| verticalCenter : 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 | |
| visible : Boolean
Controls the visibility of this geometry object.
| Geometry | |
| width : Number
Defines the width of the layout.
| Geometry | |
| x : Number
Defines the x location (top left) of the layout.
| Geometry | |
| y : Number
Defines the y location (top left) of the layout.
| Geometry | |
| Property | Defined by | ||
|---|---|---|---|
| _count : uint = 0 | BasicSpline | ||
| eventDispatcher : EventDispatcher
EventDispatcher instance for this object.
| DegrafaObject | |
| _fill : IGraphicsFill | Geometry | |
| _quads : Array | BasicSpline | ||
| _spline : IPlottableSpline | BasicSpline | ||
| _stroke : IGraphicsStroke | Geometry | |
| _toBezier : SplineToBezier | BasicSpline | ||
| Method | Defined by | ||
|---|---|---|---|
|
BasicSpline(_myPoints:Array = null)
| BasicSpline | ||
|
addControlPoint(x:Number, y:Number):void
Adds a new knot to the spline.
| BasicSpline | ||
|
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 | |
|
addItem(_x:Number, _y:Number):void
| BasicSpline | ||
|
angleAt(t:Number):Number
Returns the angle of a point t(0-1) on the path.
| Geometry | |
|
approximateInterval(val1:Number, val2:Number):Array
return an array of quad Bezier approximations to the spline over the specified interval (cartesian or parameteric) - returns null if the
values are outside the knot range for a cartesian spline or outside [0,1] for a parametric spline.
| BasicSpline | ||
|
calculateLayout(childBounds:Rectangle = null):void
Performs the specific layout work required by this Geometry.
| BasicSpline | ||
|
clearGraphicsTargets():void
Clears all graphics targets specified in the graphicsTarget array.
| Geometry | |
|
derivative(_x:Number):Number
| BasicSpline | ||
|
dispatchEvent(evt:Event):Boolean
Dispatches an event into the event flow.
| DegrafaObject | |
|
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.
| BasicSpline | ||
|
drawToTargets():void
Requests a draw for each graphics target specified in the graphicsTarget array.
| Geometry | |
|
endDraw(graphics:Graphics):void
Ends the draw phase for geometry objects.
| Geometry | |
|
eval(_x:Number):Number
| BasicSpline | ||
|
getX(_t:Number):Number
| BasicSpline | ||
|
getXPrime(_t:Number):Number
| BasicSpline | ||
|
getY(_t:Number):Number
| BasicSpline | ||
|
getYPrime(_t:Number):Number
| BasicSpline | ||
|
hasEventListener(type:String):Boolean
Checks whether the EventDispatcher object has any listeners registered for a specific type of event.
| DegrafaObject | |
|
initChange(property:String, oldValue:Object, newValue:Object, source:Object):void
Helper function for dispatching property changes
| DegrafaObject | |
|
initFill(graphics:Graphics, rc:Rectangle):void
Initialise the fill for this geometry object.
| Geometry | |
|
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 | |
|
initStroke(graphics:Graphics, rc:Rectangle):void
Initialise the stroke for this geometry object.
| Geometry | |
|
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.
| BasicSpline | ||
|
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Removes a listener from the EventDispatcher object.
| DegrafaObject | |
|
styleChanged(styleProp:String):void
Called when the value of a style property is changed.
| Geometry | |
|
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 | |
| Method | Defined by | ||
|---|---|---|---|
|
approximateCartesianInterval(val1:Number, val2:Number):Array
| BasicSpline | ||
|
initPoints():void
| BasicSpline | ||
|
initPointsCollection():void
Initialize the point collection by creating it and adding the event listener.
| BasicSpline | ||
|
propertyChangeHandler(event:PropertyChangeEvent):void
Principle event handler for any property changes to a geometry object or it's child objects.
| BasicSpline | ||
| _count | property |
Hide Inherited Public Properties
Show Inherited Public Propertiesprotected var _count:uint = 0
| knotCount | property |
knotCount:int [read-only]Access the knot count
This property can be used as the source for data binding.
Implementation public function get knotCount():int
| knots | property |
knots:Object [write-only]Assign the knot collection using a shorthand data value, similar to the Geometry data setter.
The spline data property expects a list of space seperated points. For example "10,20 30,35".
This property can be used as the source for data binding.
Implementation public function set knots(value:Object):void
See also
| pointCollection | property |
pointCollection:GraphicPointCollection [read-only]Access to the Degrafa point collection object for this spline.
This property can be used as the source for data binding.
Implementation public function get pointCollection():GraphicPointCollection
| points | property |
points:Array [read-write]Access the array of points that describe the knot set.
This property can be used as the source for data binding.
Implementation public function get points():Array
public function set points(value:Array):void
| quadApproximation | property |
quadApproximation:Array [read-only]Access the direct sequence of quadratic Bezier data that approximates the spline, including index into starting quad at each knot. First array is sequence of QuadData instances. Second array is index of QuadData instance of each knot.
This property can be used as the source for data binding.
Implementation public function get quadApproximation():Array
| _quads | property |
protected var _quads:Array
| _spline | property |
protected var _spline:IPlottableSpline
| spline | property |
spline:IPlottableSpline [write-only]
[set] spline Assign the reference to the IPlottableSpline providing the computational basis for this Degrafa spline.
This property can be used as the source for data binding.
Implementation public function set spline(value:IPlottableSpline):void
| _toBezier | property |
protected var _toBezier:SplineToBezier
| BasicSpline | () | constructor |
public function BasicSpline(_myPoints:Array = null)Parameters
_myPoints:Array (default = null) |
| addControlPoint | () | method |
public function addControlPoint(x:Number, y:Number):voidAdds a new knot to the spline.
Parametersx:Number |
|
y:Number |
| addItem | () | method |
public function addItem(_x:Number, _y:Number):voidParameters
_x:Number |
|
_y:Number |
| approximateCartesianInterval | () | method |
protected function approximateCartesianInterval(val1:Number, val2:Number):ArrayParameters
val1:Number |
|
val2:Number |
Array |
| approximateInterval | () | method |
public function approximateInterval(val1:Number, val2:Number):Arrayreturn an array of quad Bezier approximations to the spline over the specified interval (cartesian or parameteric) - returns null if the values are outside the knot range for a cartesian spline or outside [0,1] for a parametric spline. Also returns null if the quad. Bezier approximation is not yet available, which is the case until Degrafa indicates the spline is completely rendered.
Parametersval1:Number |
|
val2:Number |
Array |
| calculateLayout | () | method |
public override function calculateLayout(childBounds:Rectangle = null):voidPerforms the specific layout work required by this Geometry.
ParameterschildBounds:Rectangle (default = null) |
| derivative | () | method |
public function derivative(_x:Number):NumberParameters
_x:Number |
Number |
| draw | () | method |
public override function draw(graphics:Graphics, rc:Rectangle):voidBegins the draw phase for geometry objects. All geometry objects override this to do their specific rendering.
Parametersgraphics:Graphics — The current context to draw to.
|
|
rc:Rectangle — A Rectangle object used for fill bounds.
|
| eval | () | method |
public function eval(_x:Number):NumberParameters
_x:Number |
Number |
| getX | () | method |
public function getX(_t:Number):NumberParameters
_t:Number |
Number |
| getXPrime | () | method |
public function getXPrime(_t:Number):NumberParameters
_t:Number |
Number |
| getY | () | method |
public function getY(_t:Number):NumberParameters
_t:Number |
Number |
| getYPrime | () | method |
public function getYPrime(_t:Number):NumberParameters
_t:Number |
Number |
| initPoints | () | method |
protected function initPoints():void
| initPointsCollection | () | method |
protected function initPointsCollection():voidInitialize the point collection by creating it and adding the event listener.
| preDraw | () | method |
public override function preDraw():voidPerforms 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):voidPrinciple event handler for any property changes to a geometry object or it's child objects.
Parametersevent:PropertyChangeEvent |