NAME¶

Panner - two-dimensional scrolling and zooming

SYNOPSIS¶

#include <InterViews/panner.h>

DESCRIPTION¶

A panner is an interactor that manipulates the perspective of another interactor to provide two-dimensional scrolling and zooming. A panner is composed of a slider and several adjusters, including two zoomers and four movers. The slider's position and size reflect the current origin, size, and aspect ratio in the interactor's perspective. Dragging the slider around with the mouse changes the perspective's curx and cury members.

PUBLIC OPERATIONS¶

Panner(Interactor*, int size = 0)

Create a panner for the given interactor, optionally with the given width. If the size is 0, a reasonable default size is used. The panner's aspect ratio reflects that of the perspective.

Slider(Interactor*)

Slider::Handle(Event&)

Slider::Reshape(Shape&)

Slider::Update()

A slider reflects and lets the user specify the visible portion of the view. A rectangle represents the visible area, while the area surrounding it represents the total area. Clicking and holding down any mouse button on the rectangle allows you to drag it to a different position within the total area. The perspective's current origin is shifted to reflect the new position when the button is released. Holding down the shift key while dragging the rectangle constrains its motion horizontally or vertically. Clicking outside the rectangle moves it in the corresponding one of eight directions; for example, clicking to the right of the rectangle moves it to the right. If the left mouse button is used, the movement increment equals the perspective's sx or sy member variables. The middle mouse button increments by lx or ly, and the right mouse button centers the rectangle around the cursor. The Reshape call sets the width of the slider to that of the passed Shape and calls Change on the parent interactor. Update redisplays the slider to reflect a change in the interactor's perspective.

X DEFAULTS¶

The ``syncScroll'' resource specifies whether the slider should work in real-time or not. When synchronized scrolling is employed the interactor scrolls synchronously as the slider is dragged; otherwise the slider's outline follows the mouse during dragging, and the interactor is scrolled only after the user stops dragging the slider. Sliders will scroll synchronously if their syncScroll resource is set to ``on'' or ``true.''

SEE ALSO¶

Adjuster(3I), Interactor(3I), Perspective(3I)