NAME

       Viewport - scrollable view

SYNOPSIS

       #include <InterViews/viewport.h>

DESCRIPTION

       Viewport  is a subclass of MonoScene that allocates its component exactly as much space as
       it wants (determined from its shape).  This space will be clipped to the  viewport's  size
       and  the  viewport  maintains a perspective to adjust the portion of the component that is
       actually displayed.  If the component is smaller than  the  viewport's  canvas,  then  the
       viewport background will be filled with a light gray pattern.

PUBLIC OPERATIONS

       Viewport(Interactor* = nil, Alignment = Center)
              Construct  a  new  viewport.   If  the interactor is not nil, it is inserted as the
              viewport's component.  The second  parameter  determines  where  the  component  is
              placed relative to the viewport.

       Insert(Interactor*)
              Set the component interactor.

       void Change(Interactor*)
              A  viewport does not propagate changes.  Thus, if the component's shape changes the
              viewport simply resizes the component according to the new shape.

       void Remove(Interactor*)
              Take out the component interactor.

       virtual void Adjust(Perspective&)
              Change the viewport's perspective to the given one.  This operation will cause  the
              desired area of the component to be drawn.

       void AdjustTo(float px, float py, float zx, float zy)
       void AdjustBy(float dpx, float dpy, float dzx, float dzy)
       void ScrollTo(float px, float py)
       void ScrollXTo(float px)
       void ScrollYTo(float py)
       void ScrollBy(float dpx, float dpy)
       void ScrollXBy(float dpx)
       void ScrollYBy(float dpy)
       void ZoomTo(float zx, float zy)
       void ZoomXTo(float zx)
       void ZoomYTo(float zy)
       void ZoomBy(float dzx, float dzy)
       void ZoomXBy(float dzx)
       void ZoomYBy(float dzy)
              Short-hand operations for explicit manipulation of the viewport's perspective.

       float XPos()
       float YPos()
       float XMag()
       float YMag()
              Short-hand for retrieving information about the current perspective.

SEE ALSO

       Perspective(3I), Scene(3I), Shape(3I)