Command: pan

Syntax

pan

Description

Interactively pan across the current view in a graphic window.

Parameters

None

Switches

• -d=<num>
  Pan down by <num> * window height.

• -env
  When combined with the -ow switch, copy to the destination window the graphic environment of the source window. The default behavior is to leave the graphic environment of the destination window unchanged.

• -im
  Interactively pan the window by dragging its contents with the mouse button depressed. Use of this option will suppress the -d,-j,-l,-ow,-p,-r, -sup and -u options. The window must have save-unders turned on.

• -iw=<window>
  The window to pan across. This must be a graphic window. If this switch is omitted, the current graphic window is used.

• -j=<just>
  When combined with the -p switch indicates the justification of the alignment with respect to the new point. Any combination of L (left), R (right), T (top), B (bottom) and M (middle) is permitted. This is a string value. When this switch is omitted the alignment assumed is M, i.e. that the point defined by the -p switch is the mid-point of the new view.

• -l=<num>
  Pan left by <num> * window width.

• -ow=<window>
  The window in which to display the new image. This must be a graphic window. If omitted, the input window (-iw) is used.

• -p=<point>
  Pan aligning to a new mid-point (see -j).

• -r=<num>
  Pan right by <num> * window width.

• -sup
  Suppress the immediate display of the new image.

• -u=<num>
  Pan up by <num> * window height.

Notes

Omission of -l, -r, -u, -d and -p switches will get a 3-D point via mouse interaction and use that as a mid-point to align to, i.e. equivalent to pan -p=pcur.

Examples

Pan right with output to the same window.

pan -r=1

Pan right and up and display the output in another window (defined by a rubber box).

pan -ow = new_window, -u=0.5, -r=0.5

Pan interactively. Enable save-unders first.

mywin.save_under = 1
pan -iw=mywin,-im

See Also