Packageflare.vis.operator.distortion
Classpublic class BifocalDistortion
InheritanceBifocalDistortion Inheritance Distortion Inheritance Layout Inheritance Operator

Computes a bifocal distortion of space, magnifying a focus region of space and uniformly demagnifying the rest of the space. The affect is akin to passing a magnifying glass over the data.

For more details on this form of transformation, see Y. K. Leung and M. D. Apperley, "A Review and Taxonomy of Distortion-Oriented Presentation Techniques", in Transactions of Computer-Human Interaction (TOCHI), 1(2): 126-160 (1994). Available online at portal.acm.org/citation.cfm?id=180173&dl=ACM.



Public Properties
 PropertyDefined by
 InheritedanchorInBounds : Boolean = true
Flag indicating if distortion anchor points outside the layout bounds should be considered by the distortion.
Distortion
 InheriteddistortAxes : Boolean
Flag indicating if axes should be distorted.
Distortion
 InheriteddistortSize : Boolean
Flag indicating if sizes should be distorted.
Distortion
 InheriteddistortX : Boolean
Flag indicating if x-coordinates should be distorted.
Distortion
 InheriteddistortY : Boolean
Flag indicating if y-coordinates should be distorted.
Distortion
 Inheritedenabled : Boolean
Indicates if the operator is enabled or disabled.
Operator
 InheritedlayoutAnchor : Point
Distortion
 InheritedlayoutBounds : Rectangle
The layout bounds for the layout.
Layout
 InheritedlayoutRoot : DataSprite
The layout root, the root node for tree layouts.
Layout
 InheritedlayoutType : String = "null"
The type of layout and axes.
Layout
 Inheritedparameters : Object
Sets parameter values for this operator.
Operator
 InheritedresetSize : Boolean = false
Flag indicating if the size or scale values should be reset to 1 upon each invocation of the distortion.
Distortion
 InheriteduseSizeField : Boolean = false
Flag indicating if the DataSprite.size field should be distorted.
Distortion
 Inheritedvisualization : Visualization
The visualization processed by this operator.
Operator
Protected Properties
 PropertyDefined by
 Inherited_anchor : Point
Layout
 Inherited_b : Rectangle
A bounding rectangle for storing the layout bounds.
Distortion
 Inherited_setAnchor : Boolean = false
Layout
 Inherited_t : Transitioner = null
A transitioner for storing value updates.
Layout
 InheritedxyAxes : CartesianAxes
Returns the visualization's axes as a CartesianAxes instance.
Layout
Public Methods
 MethodDefined by
  
BifocalDistortion(xRange:Number = 0.1, xMagnify:Number = 3, yRange:Number = 0.1, yMagnify:Number = 3)

Create a new BifocalDistortion with the specified range and magnification along both axes.

NOTE:if the range value times the magnification value is greater than 1, the resulting distortion can exceed the display bounds.

BifocalDistortion
 Inherited
applyParameters(op:IOperator, params:Object):void
[static] Static method that applies parameter settings to an operator.
Operator
 Inherited
Strips all EdgeSprites in a visualization of any control points.
Layout
 Inherited
Hides the axes.
Layout
 Inherited
operate(t:Transitioner = null):void
Performs an operation over the contents of a visualization.
Distortion
 Inherited
setup():void
Setup method invoked whenever this operator's visualization property is set.
Operator
 Inherited
Reveals the axes.
Layout
 Inherited
[static] Updates all edges to be straight lines.
Layout
Protected Methods
 MethodDefined by
 Inherited
autoAnchor():void
Automatically-generate an anchor point.
Layout
 Inherited
Performs distortion of Cartesian axes.
Distortion
 Inherited
Distortion method for processing a DataSprite.
Distortion
 Inherited
layout():void
Calculates the spatial layout of visualized items.
Layout
 Inherited
minAngle(a1:Number, a2:Number):Number
Returns an angle value that minimizes the angular distance between a reference angle and a target angle.
Layout
  
sizeDistort(bb:Rectangle, x:Number, y:Number):Number
Compute a distorted size value.
BifocalDistortion
  
xDistort(x:Number):Number
Compute a distorted x-coordinate.
BifocalDistortion
  
yDistort(y:Number):Number
Compute a distorted y-coordinate.
BifocalDistortion
Public Constants
 ConstantDefined by
 InheritedCARTESIAN : String = "cartesian"
[static] Constant indicating Cartesian (x, y) coordinates.
Layout
 InheritedPOLAR : String = "polar"
[static] Constant indicating polar (radius, angle) coordinates.
Layout
Constructor detail
BifocalDistortion()constructor
public function BifocalDistortion(xRange:Number = 0.1, xMagnify:Number = 3, yRange:Number = 0.1, yMagnify:Number = 3)

Create a new BifocalDistortion with the specified range and magnification along both axes.

NOTE:if the range value times the magnification value is greater than 1, the resulting distortion can exceed the display bounds.

Parameters
xRange:Number (default = 0.1) — the range around the focus that should be magnified along the x direction. This specifies the horizontal size of the magnified focus region, and should be a value between 0 and 1, 0 indicating no focus region and 1 indicating the whole display.
 
xMagnify:Number (default = 3) — how much magnification along the x direction should be used in the focal area
 
yRange:Number (default = 0.1) — the range around the focus that should be magnified along the y direction. This specifies the vertical size of the magnified focus region, and should be a value between 0 and 1, 0 indicating no focus region and 1 indicating the whole display.
 
yMagnify:Number (default = 3) — how much magnification along the y direction should be used in the focal area
Method detail
sizeDistort()method
protected override function sizeDistort(bb:Rectangle, x:Number, y:Number):Number

Compute a distorted size value.

Parameters
bb:Rectangle — an object's bounding box
 
x:Number — the initial x-coordinate
 
y:Number — the initial y-coordinate

Returns
Number — the distorted size value
xDistort()method 
protected override function xDistort(x:Number):Number

Compute a distorted x-coordinate.

Parameters
x:Number — the initial x-coordinate

Returns
Number — the distorted s-coordinate
yDistort()method 
protected override function yDistort(y:Number):Number

Compute a distorted y-coordinate.

Parameters
y:Number — the initial y-coordinate

Returns
Number — the distorted y-coordinate