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

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.