Return to pikapix.1 CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / X / man

Annotation of 43BSD/contrib/X/man/pikapix.1, revision 1.1

1.1     ! root        1: .TH PIKAPIX 1 "16 September 1985" "X Version 10"
        !             2: .SH NAME
        !             3: pikapix - recolor an X window snapshot
        !             4: .SH SYNOPSIS
        !             5: .B pikapix
        !             6: [ -s ] [ host:number ]
        !             7: .SH DESCRIPTION
        !             8: .PP
        !             9: \fIPikapix\fP takes a snapshot of an existing window,
        !            10: and then lets you change colors
        !            11: in the snapshot.  This can be a convenient way to choose sets of colors for
        !            12: applications.
        !            13: .PP
        !            14: When started, \fIpikapix\fP grabs the mouse,
        !            15: and waits for you to select the window
        !            16: you want to recolor.  Clicking the right button on a window selects the entire
        !            17: top-level window.  Clicking the middle button on a window selects the first
        !            18: level subwindow under the mouse, or the top-level window if there is no
        !            19: subwindow.  Clicking the left button on a top-level window selects the lowest
        !            20: subwindow under the mouse, or the top-level window if there is no subwindow.
        !            21: After a few moments, a snapshot of the window will appear in the same place
        !            22: as the original window.  Move the snapshot with your window manager if you
        !            23: want to compare the snapshot with the original window.
        !            24: .PP
        !            25: As you move the cursor around in the snapshot, it will change color to reflect
        !            26: whatever pixel it is pointing at.
        !            27: .PP
        !            28: If you click the middle mouse button, you will get a popup text window.  The
        !            29: prompt indicates the current color value in hexadecimal notation as described
        !            30: in \fIX(1)\fP.
        !            31: To change the color, simply type in a color name (or a color value
        !            32: in hexadecimal notation), followed by carriage return.  Rubout and control-U
        !            33: can be used for editing.  To abort, simply click any mouse button in the popup,
        !            34: or type control-C or control-D.
        !            35: .PP
        !            36: If you click the left mouse button, you will restore the color to its value in
        !            37: the original snapshot.
        !            38: .PP
        !            39: If you click the right mouse button, you will get a popup mix window.  At the
        !            40: top are three squares with the red, green, and blue primaries, and at the
        !            41: bottom is the combined color and its hexadecimal notation.  Clicking the
        !            42: left button in a primary decrements its value, and clicking the right button
        !            43: increments its value.  If you press the middle button in a primary and then
        !            44: move around, the vertical position of the mouse controls the value, with zero
        !            45: intensity at the top of the window, and full intensity at the bottom of the
        !            46: window; releasing the mouse button sets the final value.  Clicking the right
        !            47: button in the combined color will exit the popup and change to the new color.
        !            48: Clicking the middle button in the combined color will restore the values to
        !            49: their current state in the snapshot.  Clicking the left button in the combined
        !            50: color will restore the values to their state in the original snapshot.
        !            51: .PP
        !            52: Typing control-C or control-D in the snapshot will terminate the program.
        !            53: .PP
        !            54: By default, once the snapshot is created, it no longer depends on the existence
        !            55: of the original window, and the color in the snapshot will dynamically track
        !            56: the color in the popup mix window.  However, a potentially large number of
        !            57: color map entries may be required for this mode.  If not enough entries are
        !            58: available, the ``-s'' can be used.  When run with the ``-s'' option,
        !            59: the snapshot
        !            60: continues to depend on colors from the original window, new colors are shared
        !            61: when possible, and the snapshot is completely repainted after every change in
        !            62: color.
        !            63: .SH ENVIRONMENT
        !            64: DISPLAY        This program gets the display to use by default from this variable.
        !            65: .SH BUGS
        !            66: Redisplay is very slow on all but small windows.
        !            67: .SH AUTHOR
        !            68: Bob Scheifler, MIT Laboratory for Computer Science.
        !            69: .br
        !            70: Copyright (c) 1985, Massachusetts Institute of Technology
        !            71: .SH "SEE ALSO"
        !            72: X(1)

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