Return to lens.9 CVS log

Up to [Research Unix] / researchv10dc / man / adm / man9

Annotation of researchv10dc/man/adm/man9/lens.9, revision 1.1.1.1

1.1       root        1: .de m
                      2: .if t \{\
                      3: .nr M \w'\|\|\\$1'
                      4: .nr N \w'\s24\|\|\\$1'
                      5: \h'-\w' \(br\|\\$1'u'\(br\|\\$1\|\(br\
                      6: \\h'-\\nMu'\l'\\nMu\(rn'\\h'-\\nMu'\l'\\nMu\(ul'\
                      7: \s24\v'1m'\(br\|\\$1\|\(br\
                      8: \\h'-\\nNu'\l'\\nNu\(rn'\\h'-\\nNu'\l'\\nNu\(ul'\
                      9: \v'-1m'\s0 \}
                     10: .if n \\$1
                     11: ..
                     12: .TH LENS 9.1
                     13: .CT 1 games comm_term
                     14: .SH NAME
                     15: lens \- bitmap  magnifier
                     16: .m magnifier
                     17: .SH SYNOPSIS
                     18: .B lens
                     19: .SH DESCRIPTION
                     20: .I Lens
                     21: is an interactive screen bitmap magnifier.
                     22: When it
                     23: starts, it displays an enlarged image of a magnifying glass in
                     24: its layer, which becomes a setting sun when
                     25: .I lens
                     26: wants to confirm a command to exit.
                     27: .PP
                     28: The first item in the button 2 menu,
                     29: which rotates among
                     30: .BR go ,
                     31: .BR peek ,
                     32: and
                     33: .BR stop ,
                     34: determines the activity of the magnifier.
                     35: Clicking button 1 serves as an abbreviation for selecting
                     36: .B go
                     37: or
                     38: .BR peek .
                     39: When the magnifier is going,
                     40: a crawling-bordered rectangle is drawn
                     41: around the source, and the
                     42: .I lens
                     43: window contains the magnified image.
                     44: The mouse controls
                     45: the position of the source rectangle.
                     46: .PP
                     47: During peeking, the rectangle last selected while
                     48: going is re-examined periodically, and the contents
                     49: are magnified, whether or not the
                     50: .I lens
                     51: window is currently selected.
                     52: .PP
                     53: When stopped, the
                     54: .I lens
                     55: window is inactive.
                     56: .PP
                     57: The button 2 menu also allows changing the magnification factor.
                     58: The magnification factors are chosen from the
                     59: Fibonacci numbers, and menu items for the next size smaller and larger
                     60: are presented as, e.g.,
                     61: .L 3x
                     62: or
                     63: .LR 8x .
                     64: The current magnification factor is not displayed in the menu, only
                     65: the next factors larger and smaller.
                     66: The initial magnification factor is two.
                     67: .PP
                     68: Button 2 may also be used to select the intervals at which peeking
                     69: updates occur.
                     70: These intervals are selected, in ticks, from among the powers of two, where
                     71: a tick is one-sixtieth of a second.
                     72: These choices are presented as, e.g.,
                     73: .L "32 ticks"
                     74: or
                     75: .LR "128 ticks" .
                     76: The initial interval between peeks is 64 ticks, approximately one second.
                     77: .PP
                     78: The image window may be controlled by the button 2 menu item which
                     79: toggles between
                     80: .B inset
                     81: and
                     82: .BR "full size" .
                     83: In inset mode, the image is displayed inside the image window of the
                     84: magnified lens icon.
                     85: In full size mode, the image is displayed in the entire
                     86: .I lens
                     87: window.
                     88: .PP
                     89: The final button 2 menu entry is
                     90: .I exit.
                     91: A setting sun is displayed, and button 3 must be clicked to confirm.
                     92: .SH BUGS
                     93: While going, the display is only refreshed when the mouse is moved.
                     94: .br
                     95: While peeking, it is assumed that the
                     96: .I lens
                     97: window contains an accurate magnification of what was on the screen
                     98: at the time of the last magnification.
                     99: If
                    100: .I lens
                    101: is used to examine its own image, strange things may occur.
                    102: .br
                    103: Due to the bitmap reshaping techniques employed by the magnification
                    104: algorithms, high magnification factors will not work with large image
                    105: windows.
                    106: Precisely, if the product of the vertical magnification factor and
                    107: the width of the destination rectangle overflows a signed
                    108: short integer, predictable but undesirable results will occur.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.