Packageorg.openzoom.flash.viewport
Interfacepublic interface IViewport extends IDisposable, flash.events.IEventDispatcher
SubinterfacesINormalizedViewport, ISceneViewport, IViewportTransformContainer
ImplementorsCenterConstraint, CompositeConstraint, ContextMenuController, FillConstraint, KeyboardController, MapConstraint, MouseController, NullConstraint, NullTransformer, ScaleConstraint, SmoothTransformer, TweenerTransformer, TweensyZeroTransformer, ViewportTransform, VisibilityConstraint, ZoomConstraint

Interface a viewport implementation has to provide.



Public Properties
 PropertyDefined by
  bottom : Number
[read-only] The sum of the y and height properties.
IViewport
  bottomRight : Point
[read-only] The location of the IViewport object's bottom-right corner, determined by the values of the right and bottom properties.
IViewport
  center : Point
[read-only] Returns the center of the viewport.
IViewport
  height : Number
Vertical dimension of the viewport.
IViewport
  left : Number
[read-only] The x coordinate of the top-left corner of the viewport.
IViewport
  right : Number
[read-only] The sum of the x and width properties.
IViewport
  scale : Number
Scale of the scene.
IViewport
  scene : IReadonlyMultiScaleScene
[read-only] Scene this viewport belongs to.
IViewport
  top : Number
[read-only] The y coordinate of the top-left corner of the viewport.
IViewport
  topLeft : Point
[read-only] The location of the IViewport object's top-left corner, determined by the x and y coordinates of the point.
IViewport
  transform : IViewportTransform
Transformation that is currently applied to the viewport
IViewport
  transformer : IViewportTransformer
Transforms the IViewport object after its state has been changed.
IViewport
  viewportHeight : Number
[read-only] Height of the viewport container.
IViewport
  viewportWidth : Number
[read-only] Width of the viewport container.
IViewport
  width : Number
Horizontal dimension of the viewport.
IViewport
  x : Number
Horizontal coordinate of the viewport.
IViewport
  y : Number
Vertical coordinate of the viewport.
IViewport
  zoom : Number
Zoom level of the viewport.
IViewport
Public Methods
 MethodDefined by
  
Dispatch transformStart event to let all listeners know that a viewport transition has started.
IViewport
  
contains(x:Number, y:Number):Boolean
Determines whether the specified point is contained within this Viewport object.
IViewport
 Inherited
dispose():void
Releases all resources this object holds on to.
IDisposable
  
endTransform():void
Dispatch transformEnd event to let all listeners know that a viewport transition has finished.
IViewport
  
fitToBounds(bounds:Rectangle, scale:Number = 1.0, immediately:Boolean = false):void
Show a rectangular area of the scene inside the viewport.
IViewport
  
getBounds():Rectangle
Returns a Rectangle object with the bounds of the viewport.
IViewport
  
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.
IViewport
  
intersects(toIntersect:Rectangle):Boolean
Determines whether the object specified in the toIntersect parameter intersects with this Viewport object.
IViewport
  
localToScene(point:Point):Point
Converts the point object from the viewport's container (local) coordinates to scene coordinates.
IViewport
  
panBy(deltaX:Number, deltaY:Number, immediately:Boolean = false):void
Move the viewport.
IViewport
  
panCenterTo(centerX:Number, centerY:Number, immediately:Boolean = false):void
Move the viewport center.
IViewport
  
panTo(x:Number, y:Number, immediately:Boolean = false):void
Move the viewport.
IViewport
  
sceneToLocal(point:Point):Point
Converts the point object from scene coordinates to the viewport's container (local) coordinates.
IViewport
  
showAll(immediately:Boolean = false):void
Fit entire scene into the viewport.
IViewport
  
zoomBy(factor:Number, transformX:Number = 0.5, transformY:Number = 0.5, immediately:Boolean = false):void
Zoom the viewport by a factor.
IViewport
  
zoomTo(zoom:Number, transformX:Number = 0.5, transformY:Number = 0.5, immediately:Boolean = false):void
Zoom the viewport to a zoom level z.
IViewport
Events
 EventSummaryDefined by
   Dispatched when the viewport container is resized.IViewport
   Dispatched when the viewport transformation target is updated.IViewport
   Dispatched when a viewport transformation ends.IViewport
   Dispatched when a viewport transformation begins.IViewport
   Dispatched when the viewport transformation is updated.IViewport
Property detail
bottomproperty
bottom:Number  [read-only]

The sum of the y and height properties.

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

The location of the IViewport object's bottom-right corner, determined by the values of the right and bottom properties.

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

Returns the center of the viewport.

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

Vertical dimension of the viewport.

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

The x coordinate of the top-left corner of the viewport.

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

The sum of the x and width properties.

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
sceneproperty 
scene:IReadonlyMultiScaleScene  [read-only]

Scene this viewport belongs to.

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

The y coordinate of the top-left corner of the viewport.

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

The location of the IViewport object's top-left corner, determined by the x and y coordinates of the point.

Implementation
    public function get topLeft():Point
transformproperty 
transform:IViewportTransform  [read-write]

Transformation that is currently applied to the viewport

Implementation
    public function get transform():IViewportTransform
    public function set transform(value:IViewportTransform):void
transformerproperty 
transformer:IViewportTransformer  [read-write]

Transforms the IViewport object after its state has been changed.

Implementation
    public function get transformer():IViewportTransformer
    public function set transformer(value:IViewportTransformer):void
viewportHeightproperty 
viewportHeight:Number  [read-only]

Height of the viewport container.

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

Width of the viewport container.

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

Horizontal dimension of the viewport.

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

Horizontal coordinate of the viewport.

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

Vertical coordinate of the viewport.

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
Method detail
beginTransform()method
public function beginTransform():void

Dispatch transformStart event to let all listeners know that a viewport transition has started.

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.
endTransform()method 
public function endTransform():void

Dispatch transformEnd event to let all listeners know that a viewport transition has finished.

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

Show a rectangular area of the scene inside the viewport.

Parameters
bounds:Rectangle — Rectangle to be shown in the viewport.
 
scale:Number (default = 1.0) — Scale at which the rectangle is beeing displayed, e.g. useful for displaying some space around the rectangle.
 
immediately:Boolean (default = false)
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.
localToScene()method 
public function localToScene(point:Point):Point

Converts the point object from the viewport's container (local) coordinates to scene coordinates.

Parameters
point:Point

Returns
Point
panBy()method 
public function panBy(deltaX:Number, deltaY:Number, immediately:Boolean = false):void

Move the viewport.

Parameters
deltaX:Number — Horizontal translation delta
 
deltaY:Number — Vertical translation delta
 
immediately:Boolean (default = false)
panCenterTo()method 
public function panCenterTo(centerX:Number, centerY:Number, immediately:Boolean = false):void

Move the viewport center.

Parameters
centerX:Number — Horizontal coordinate of the new center
 
centerY:Number — Vertical coordinate of the new center
 
immediately:Boolean (default = false)
panTo()method 
public function panTo(x:Number, y:Number, immediately:Boolean = false):void

Move the viewport.

Parameters
x:Number — Horizontal coordinate
 
y:Number — Vertical coordinate
 
immediately:Boolean (default = false)
sceneToLocal()method 
public function sceneToLocal(point:Point):Point

Converts the point object from scene coordinates to the viewport's container (local) coordinates.

Parameters
point:Point

Returns
Point
showAll()method 
public function showAll(immediately:Boolean = false):void

Fit entire scene into the viewport.

Parameters
immediately:Boolean (default = false)
zoomBy()method 
public function zoomBy(factor:Number, transformX:Number = 0.5, transformY:Number = 0.5, immediately:Boolean = false):void

Zoom the viewport by a factor.

Parameters
factor:Number — Multiplier 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
 
immediately:Boolean (default = false)
zoomTo()method 
public function zoomTo(zoom:Number, transformX:Number = 0.5, transformY:Number = 0.5, immediately:Boolean = false):void

Zoom the viewport to a zoom level z.

Parameters
zoom:Number — Target value for the viewport's zoom property
 
transformX:Number (default = 0.5) — Horizontal coordinate of the zooming center
 
transformY:Number (default = 0.5) — Vertical coordinate of the zooming center
 
immediately:Boolean (default = false)
Event detail
resizeevent 
Event object type: org.openzoom.events.ViewportEvent

Dispatched when the viewport container is resized.

targetUpdateevent  
Event object type: org.openzoom.events.ViewportEvent

Dispatched when the viewport transformation target is updated.

transformEndevent  
Event object type: org.openzoom.events.ViewportEvent

Dispatched when a viewport transformation ends.

transformStartevent  
Event object type: org.openzoom.events.ViewportEvent

Dispatched when a viewport transformation begins.

transformUpdateevent  
Event object type: org.openzoom.events.ViewportEvent

Dispatched when the viewport transformation is updated.