Packageorg.openzoom.flash.viewport
Classpublic final class SceneViewport
InheritanceSceneViewport Inheritance flash.events.EventDispatcher
ImplementsISceneViewport

IViewport implementation that is based on the scene coordinate system [0, scene(Width|Height)].



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

The sum of the y and height properties.

This property can be used as the source for data binding.

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.

This property can be used as the source for data binding.

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

Returns the center of the viewport.

This property can be used as the source for data binding.

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

Vertical dimension of the viewport.

This property can be used as the source for data binding.

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.

This property can be used as the source for data binding.

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

The sum of the x and width properties.

This property can be used as the source for data binding.

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

Scale of the scene.

This property can be used as the source for data binding.

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

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

This property can be used as the source for data binding.

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.

This property can be used as the source for data binding.

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.

This property can be used as the source for data binding.

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

Width of the viewport container.

This property can be used as the source for data binding.

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

Horizontal dimension of the viewport.

This property can be used as the source for data binding.

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

Horizontal coordinate of the viewport.

This property can be used as the source for data binding.

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

Vertical coordinate of the viewport.

This property can be used as the source for data binding.

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.

This property can be used as the source for data binding.

Implementation
    public function get zoom():Number
    public function set zoom(value:Number):void
Constructor detail
SceneViewport()constructor
public function SceneViewport(lock:SingletonLock, viewport:INormalizedViewport)

Constructor.

Parameters
lock:SingletonLock
 
viewport:INormalizedViewport
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.
dispose()method 
public function dispose():void
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
getCenter()method 
public function getCenter():Point

Returns
Point
getInstance()method 
public static function getInstance(viewport:INormalizedViewport):ISceneViewport

Returns an instance of SceneViewport for a given normalized viewport.

Parameters
viewport:INormalizedViewport

Returns
ISceneViewport
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)
toString()method 
public override function toString():String

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

Zoom the viewport by a factor.

Parameters
factor:Number — Multiplier for the zoom.
 
transformX:Number — Horizontal coordinate of the zooming center
 
transformY:Number — Vertical coordinate of the zooming center
 
immediately:Boolean (default = false)
zoomTo()method 
public function zoomTo(zoom:Number, transformX:Number, transformY:Number, 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 — Horizontal coordinate of the zooming center
 
transformY:Number — Vertical coordinate of the zooming center
 
immediately:Boolean (default = false)
Event detail
resizeevent 
Event object type: org.openzoom.events.ViewportEvent

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

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

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

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