Packageorg.openzoom.flash.viewport
Classpublic final class ViewportTransform
ImplementsIViewportTransform, IViewportTransformContainer

The ViewportTransform stores the position and bounds of a viewport.



Public Properties
 PropertyDefined by
  bottom : Number
[read-only]
ViewportTransform
  bottomRight : Point
[read-only]
ViewportTransform
  center : Point
[read-only] Returns the center of the transform.
ViewportTransform
  height : Number
ViewportTransform
  left : Number
[read-only]
ViewportTransform
  right : Number
[read-only]
ViewportTransform
  scale : Number
Scale of the scene.
ViewportTransform
  sceneHeight : Number
[read-only] Indicates the height of the scene, in pixels.
ViewportTransform
  sceneWidth : Number
[read-only] Indicates the width of the scene, in pixels.
ViewportTransform
  top : Number
[read-only] Coordinate of the upper boundary of the viewport transform.
ViewportTransform
  topLeft : Point
[read-only]
ViewportTransform
  viewportHeight : Number
[read-only]
ViewportTransform
  viewportWidth : Number
[read-only]
ViewportTransform
  width : Number
ViewportTransform
  x : Number
ViewportTransform
  y : Number
ViewportTransform
  zoom : Number
Zoom level of the viewport.
ViewportTransform
Public Methods
 MethodDefined by
  
ViewportTransform(x:Number, y:Number, width:Number, height:Number, zoom:Number, viewportWidth:Number, viewportHeight:Number, sceneWidth:Number, sceneHeight:Number)
Constructor.
ViewportTransform
  
Returns a new IViewportTransform object with the same values for the x, y, width, height and zoom properties as the original IViewportTransform object.
ViewportTransform
  
contains(x:Number, y:Number):Boolean
Determines whether the specified point is contained within this Viewport object.
ViewportTransform
  
Copy values from other to this instance of IViewportTransform.
ViewportTransform
  
dispose():void
ViewportTransform
  
equals(other:IViewportTransform):Boolean
Determines whether the object specified in the other parameter is equal to this Rectangle object.
ViewportTransform
  
fitToBounds(bounds:Rectangle, scale:Number = 1.0):void
Show an area of the scene inside the viewport.
ViewportTransform
  
fromValues(x:Number, y:Number, width:Number, height:Number, zoom:Number, viewportWidth:Number, viewportHeight:Number, sceneWidth:Number, sceneHeight:Number):ViewportTransform
[static] Constructs and initializes a ViewportTransform object from the given parameter values.
ViewportTransform
  
getBounds():Rectangle
Returns a Rectangle object with the bounds of the viewport.
ViewportTransform
  
intersection(toIntersect:Rectangle):Rectangle
If the Rectangle object specified in the toIntersect parameter intersects with this Viewport object, returns the area of intersection as a Rectangle object.
ViewportTransform
  
intersects(toIntersect:Rectangle):Boolean
Determines whether the object specified in the toIntersect parameter intersects with this Viewport object.
ViewportTransform
  
panBy(dx:Number, dy:Number):void
Move the viewport.
ViewportTransform
  
panCenterTo(x:Number, y:Number):void
Move the viewport center.
ViewportTransform
  
panTo(x:Number, y:Number):void
Move the viewport.
ViewportTransform
  
setSize(width:Number, height:Number):void
Sets viewportWidth and viewportHeight.
ViewportTransform
  
showAll():void
Fit entire scene into the viewport.
ViewportTransform
  
toString():String
ViewportTransform
  
zoomBy(factor:Number, transformX:Number = 0.5, transformY:Number = 0.5):void
Zoom the viewport by a factor.
ViewportTransform
  
zoomTo(zoom:Number, transformX:Number = 0.5, transformY:Number = 0.5):void
Zoom the viewport to the given zoom level.
ViewportTransform
Property detail
bottomproperty
bottom:Number  [read-only]

Implementation
    public function get bottom():Number
bottomRightproperty 
bottomRight:Point  [read-only]

Implementation
    public function get bottomRight():Point
centerproperty 
center:Point  [read-only]

Returns the center of the transform.

Implementation
    public function get center():Point
heightproperty 
height:Number  [read-write]

Implementation
    public function get height():Number
    public function set height(value:Number):void
leftproperty 
left:Number  [read-only]

Implementation
    public function get left():Number
rightproperty 
right:Number  [read-only]

Implementation
    public function get right():Number
scaleproperty 
scale:Number  [read-write]

Scale of the scene.

Implementation
    public function get scale():Number
    public function set scale(value:Number):void
sceneHeightproperty 
sceneHeight:Number  [read-only]

Indicates the height of the scene, in pixels.

Implementation
    public function get sceneHeight():Number
sceneWidthproperty 
sceneWidth:Number  [read-only]

Indicates the width of the scene, in pixels.

Implementation
    public function get sceneWidth():Number
topproperty 
top:Number  [read-only]

Coordinate of the upper boundary of the viewport transform.

Implementation
    public function get top():Number
topLeftproperty 
topLeft:Point  [read-only]

Implementation
    public function get topLeft():Point
viewportHeightproperty 
viewportHeight:Number  [read-only]

Implementation
    public function get viewportHeight():Number
viewportWidthproperty 
viewportWidth:Number  [read-only]

Implementation
    public function get viewportWidth():Number
widthproperty 
width:Number  [read-write]

Implementation
    public function get width():Number
    public function set width(value:Number):void
xproperty 
x:Number  [read-write]

Implementation
    public function get x():Number
    public function set x(value:Number):void
yproperty 
y:Number  [read-write]

Implementation
    public function get y():Number
    public function set y(value:Number):void
zoomproperty 
zoom:Number  [read-write]

Zoom level of the viewport. Scene fits exactly into viewport at value 1.

Implementation
    public function get zoom():Number
    public function set zoom(value:Number):void
Constructor detail
ViewportTransform()constructor
public function ViewportTransform(x:Number, y:Number, width:Number, height:Number, zoom:Number, viewportWidth:Number, viewportHeight:Number, sceneWidth:Number, sceneHeight:Number)

Constructor.

Parameters
x:Number
 
y:Number
 
width:Number
 
height:Number
 
zoom:Number
 
viewportWidth:Number
 
viewportHeight:Number
 
sceneWidth:Number
 
sceneHeight:Number
Method detail
clone()method
public function clone():IViewportTransform

Returns a new IViewportTransform object with the same values for the x, y, width, height and zoom properties as the original IViewportTransform object.

Returns
IViewportTransform
contains()method 
public function contains(x:Number, y:Number):Boolean

Determines whether the specified point is contained within this Viewport object.

Parameters
x:Number — The x coordinate (horizontal position) of the point.
 
y:Number — The y coordinate (vertical position) of the point.

Returns
Boolean — true if this Viewport object contains the specified point; otherwise false.
copy()method 
public function copy(other:IViewportTransform):void

Copy values from other to this instance of IViewportTransform.

Parameters
other:IViewportTransform
dispose()method 
public function dispose():void
equals()method 
public function equals(other:IViewportTransform):Boolean

Determines whether the object specified in the other parameter is equal to this Rectangle object.

Parameters
other:IViewportTransform

Returns
Boolean
fitToBounds()method 
public function fitToBounds(bounds:Rectangle, scale:Number = 1.0):void

Show an area of the scene inside the viewport.

Parameters
bounds:Rectangle — Rectangular area to be shown in the viewport.
 
scale:Number (default = 1.0) — Scale at which the area is beeing displayed.
fromValues()method 
public static function fromValues(x:Number, y:Number, width:Number, height:Number, zoom:Number, viewportWidth:Number, viewportHeight:Number, sceneWidth:Number, sceneHeight:Number):ViewportTransform

Constructs and initializes a ViewportTransform object from the given parameter values.

Parameters
x:Number
 
y:Number
 
width:Number
 
height:Number
 
zoom:Number
 
viewportWidth:Number
 
viewportHeight:Number
 
sceneWidth:Number
 
sceneHeight:Number

Returns
ViewportTransform
getBounds()method 
public function getBounds():Rectangle

Returns a Rectangle object with the bounds of the viewport.

Returns
Rectangle
intersection()method 
public function intersection(toIntersect:Rectangle):Rectangle

If the Rectangle object specified in the toIntersect parameter intersects with this Viewport object, returns the area of intersection as a Rectangle object. If the objects do not intersect, this method returns an empty Rectangle object with its properties set to 0.

Parameters
toIntersect:Rectangle — The Rectangle object to compare against to see if it intersects with this Viewport object.

Returns
Rectangle — A Rectangle object that equals the area of intersection. If the rectangles do not intersect, this method returns an empty Rectangle object; that is, a rectangle with its x, y, width, and height properties set to 0.
intersects()method 
public function intersects(toIntersect:Rectangle):Boolean

Determines whether the object specified in the toIntersect parameter intersects with this Viewport object. This method checks the x, y, width, and height properties of the specified Rectangle object to see if it intersects with this Viewport object.

Parameters
toIntersect:Rectangle — The Rectangle object to compare against this Viewport object.

Returns
Boolean — true if the specified object intersects with this Viewport object; otherwise false.
panBy()method 
public function panBy(dx:Number, dy:Number):void

Move the viewport.

Parameters
dx:Number — Horizontal translation delta
 
dy:Number — Vertical translation delta
panCenterTo()method 
public function panCenterTo(x:Number, y:Number):void

Move the viewport center.

Parameters
x:Number — Horizontal coordinate
 
y:Number — Vertical coordinate
panTo()method 
public function panTo(x:Number, y:Number):void

Move the viewport.

Parameters
x:Number — Horizontal coordinate
 
y:Number — Vertical coordinate
setSize()method 
public function setSize(width:Number, height:Number):void

Sets viewportWidth and viewportHeight. Dispatches ViewportEvent.RESIZE

Parameters
width:Number
 
height:Number
showAll()method 
public function showAll():void

Fit entire scene into the viewport.

toString()method 
public function toString():String

Returns
String
zoomBy()method 
public function zoomBy(factor:Number, transformX:Number = 0.5, transformY:Number = 0.5):void

Zoom the viewport by a factor.

Parameters
factor:Number — Scale factor for the zoom.
 
transformX:Number (default = 0.5) — Horizontal coordinate of the zooming center
 
transformY:Number (default = 0.5) — Vertical coordinate of the zooming center
zoomTo()method 
public function zoomTo(zoom:Number, transformX:Number = 0.5, transformY:Number = 0.5):void

Zoom the viewport to the given zoom level.

Parameters
zoom:Number — Zoom level
 
transformX:Number (default = 0.5) — Horizontal coordinate of the zooming center
 
transformY:Number (default = 0.5) — Vertical coordinate of the zooming center