Perspective(3I)                                             InterViews Reference Manual                                            Perspective(3I)

NAME

       Perspective - visible portion of an interactor

SYNOPSIS

       #include <InterViews/perspective.h>

DESCRIPTION

       A  perspective  object  describes  which part of an interactor's total display area is visible in the interactor's canvas.  The main use of
       perspectives is for scrolling, panning, and zooming interactors.  The member variables (x0, y0) define the origin of the interactor's  dis-
       play  area;  width  and  height define the total height of the area.  The member variables (curx, cury) define the lower-left corner of the
       interactor's canvas relative to the total area; curwidth and curheight define how much of the total area is displayed in the canvas.

       The member variables sx, sy, lx, and ly specify small and large increments in each dimension.  These increments are used by a  scroller  to
       implement line and page scrolling.

PUBLIC OPERATIONS

       Perspective()
              Define a new perspective with all member variables initialized to zero.

       void Attach(Interactor*)
              Add to the list of interactors that are interested in updates to the perspective.  These interactors reflect the perspective visual-
              ly; examples include scrollers and sliders.

       void Detach(Interactor*)
              Remove an interactor from the list of those interested in updates.  This operation should be called from the  interactor's  destruc-
              tor.

       void Init(Coord x0, Coord y0, Coord width, Coord height)
              Initialize the perspective display area.

       void Update()
              Notify all the interactors interested in the perspective that it has changed.  The perspective's interactor should call Update after
              modifying its perspective.

SEE ALSO

       Adjuster(3I), Interactor(3I), Panner(3I), Scroller(3I)

InterViews                                                         15 June 1987                                                    Perspective(3I)