Packageflare.vis.operator.distortion
Classpublic class FisheyeDistortion
InheritanceFisheyeDistortion Inheritance Distortion Inheritance Layout Inheritance Operator

Computes a graphical fisheye distortion of a graph view. This distortion allocates more space to items near the layout anchor and less space to items further away, magnifying space near the anchor and demagnifying distant space in a continuous fashion.

For more details on this form of transformation, see Manojit Sarkar and Marc H. Brown, "Graphical Fisheye Views of Graphs", in Proceedings of CHI'92, Human Factors in Computing Systems, p. 83-91, 1992. Available online at http://citeseer.ist.psu.edu/sarkar92graphical.html.



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
  
FisheyeDistortion(dx:Number = 4, dy:Number = 4, ds:Number = 3)
Create a new FisheyeDistortion with the given distortion factors along the x and y directions.
FisheyeDistortion
 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.
FisheyeDistortion
  
xDistort(x:Number):Number
Compute a distorted x-coordinate.
FisheyeDistortion
  
yDistort(y:Number):Number
Compute a distorted y-coordinate.
FisheyeDistortion
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
FisheyeDistortion()constructor
public function FisheyeDistortion(dx:Number = 4, dy:Number = 4, ds:Number = 3)

Create a new FisheyeDistortion with the given distortion factors along the x and y directions.

Parameters
dx:Number (default = 4) — the distortion factor along the x axis (0 for none)
 
dy:Number (default = 4) — the distortion factor along the y axis (0 for none)
 
ds:Number (default = 3) — the distortion factor to use for sizes (0 for none)
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