]> git.lizzy.rs Git - plan9front.git/blob - sys/man/1/lens
/sys/lib/rootstub
[plan9front.git] / sys / man / 1 / lens
1 .TH LENS 1
2 .SH NAME
3 lens \- interactive screen magnifier
4 .SH SYNOPSIS
5 .B lens
6 .SH DESCRIPTION
7 .I Lens
8 presents a magnified view in its window of an arbitrary area on the screen.
9 The default magnification is 4 (showing each pixel as a 4×4 pixel block in
10 .IR lens 's
11 window). This may be changed by typing a digit on the keyboard (with
12 .B 0
13 standing for 10), or by using the
14 .B +
15 and
16 .B -
17 keys to increase or decrease the magnification by one unit.
18 The lower limit is ×1; the upper ×16.
19 .PP
20 The interface to indicate what area to magnify is dictated by the mouse multiplexing rules of
21 .IR rio (1).
22 Start by pressing mouse button 1 in the
23 .I lens
24 window and dragging, with the button pressed, to the center of the area to magnify.
25 .I Lens
26 will update the display as the mouse moves.
27 Releasing the button freezes the
28 .I lens
29 display.
30 The magnified view is static\(ema snapshot, not a movie\(embut typing a space or
31 .B .
32 key  in the
33 .I lens
34 window will refresh the
35 display, as will changing the magnification.
36 .PP
37 To make counting pixels easier, typing a
38 .B g
39 toggles whether a checkerboard grid is imposed on the magnified area.
40 .PP
41 Button 3 brings up a menu of actions.
42 .SH SOURCE
43 .B /sys/src/cmd/lens.c
44 .SH BUGS
45 There should be an easier way to indicate what to magnify.