Annotation of researchv10dc/man/adm/man9/lens.9, revision 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.

unix.superglobalmegacorp.com

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