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 display 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 visually; 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 destructor.

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)