Return to showimg.1 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / new / X / showimg

Annotation of 43BSDTahoe/new/X/showimg/showimg.1, revision 1.1

1.1     ! root        1: \" -*-nroff-*-
        !             2: .TH SHOWIMG 1 "21 February 1986" "CfA Additions"
        !             3: .SH NAME
        !             4: showimg \- display CCD\-format images under X windows
        !             5: .SH SYNTAX
        !             6: .B showimg
        !             7: [ \fIoptions\fR ] \fIfilename\fR
        !             8: .SH DESCRIPTION
        !             9: A CCD file or FITS-format file containing header information and
        !            10: 16-bit image data is read into memory and presented for display
        !            11: highlighting under the X window system. Mouse and cursor manipulations
        !            12: allow the control of several interactive functions.  Besides the
        !            13: options listed below, the usual menu and window options as documented
        !            14: in the \fBX\fR and \fBXMenu\fR manual pages are available, either as
        !            15: inputs to the command line or in the \fI.Xdefaults\fR file.
        !            16: .SH OPTIONS
        !            17: .TP 6
        !            18: .B \-planes \fIn\fB
        !            19: Allocate \fIn\fR planes to the display image. This will use 2**n colors or
        !            20: gray levels.
        !            21: .TP 6
        !            22: .B \-rgb
        !            23: Default to red\-green\-blue color selection on startup instead of gray scale.
        !            24: .TP 6
        !            25: .B \-neg
        !            26: Default to inverse video on startup.
        !            27: .TP 6
        !            28: .B \-sqrt
        !            29: Default to square root mapping on startup instead of linear.
        !            30: .TP 6
        !            31: .BI \-threshold\  tnum
        !            32: Use \fItnum\fR as the threshold level for scaling the 16\-bit image
        !            33: instead of the one determined automatically.
        !            34: .TP 6
        !            35: .BI \-saturate\  snum
        !            36: Use \fIsnum\fR as the saturation level for scaling the 16\-bit image
        !            37: instead of the one determined automatically.
        !            38: .TP 6
        !            39: .B -fits
        !            40: Assume FITS format. Checks that `SIMPLE = T' and that `BITPIX = 16', 
        !            41: and reads the size from `NAXIS1' and `NAXIS2'. The image will be read with
        !            42: 2880\-byte reads and the 16\bit integers byte-swapped if on a VAX.
        !            43: .TP 6
        !            44: .B -dfits
        !            45: Assume `disk' FITS format. On a VAX this assumes the integers do not need
        !            46: to be byte-swapped; otherwise this option is identical to \fI\-fits\fR.
        !            47: Checks that `SIMPLE = T' and that `BITPIX = 16', and reads the size from
        !            48: `NAXIS1' and `NAXIS2'. The image will be read with 2880\-byte reads.
        !            49: .TP 6
        !            50: .BI \-skip\  hbytes \ \-nrows \ nr \ \-ncols \ nc
        !            51: Do not read image size information from the header (either FITS or CfA CCD);
        !            52: skip \fIhbytes\fR bytes
        !            53: of information at the beginning of the file instead. The image is \fInc\fR
        !            54: columns by \fInr\fR rows of 16-bit pixels. This option can be used to read and
        !            55: display images in `foreign' formats.
        !            56: .SH Mouse Control
        !            57: By default the picture comes up with a linear intensity gray scale. Pressing
        !            58: any mouse button, with or without mouse motion, causes the intensities 
        !            59: displayed to change. Holding down the control button while pressing a mouse
        !            60: button causes a pop\-up menu to appear, providing furthur choices. Releasing 
        !            61: the button while pointing to an active selection chooses that selection.
        !            62: .PP
        !            63: The first pop-up menu selects other functions such as reinitialization to the
        !            64: default intensity map, display in red\-green\-blue or gray scale, and inverse
        !            65: versus normal video.
        !            66: .IP 
        !            67: Motion in the horizontal direction while holding down a mouse button down
        !            68: corresponds to a 
        !            69: change in the threshold or background levels displayed. Motion in the vertical
        !            70: direction with a mouse button down changes the contrast. The center of the
        !            71: window is considered the default or null point.
        !            72: .IP
        !            73: If the \-rgb option is selected, either in the command line or via the pop\-up
        !            74: menu, the left, middle, and right mouse buttons control the red, green, and
        !            75: blue intensity, respectively.
        !            76: .PP
        !            77: The second menu selects secondary cursor\-activated options: printing,
        !            78: panning, and zoom\-in. As each of these is selected, the mouse cursor changes
        !            79: to reflect the intended operation. 
        !            80: .IP
        !            81: Clicking any mouse button with the print option selected prints the 16-bit 
        !            82: pixel value under that point, and the pixels atround it in an 11x11 grid.
        !            83: .IP
        !            84: Under the pan and zoom options, the picture is redisplayed centered around the
        !            85: point under the cursor when clicked. If the point is too close to the edge of
        !            86: the display window, the point may not actually be displayed in the center. The
        !            87: zoom options (x2 and x4) magnify the picture via pixel replication.
        !            88: .PP
        !            89: The third menu select on of two functions to map the 16-bit intensities into
        !            90: the n-bit intensities loaded into the GPX memory: linear and sqrt. The latter
        !            91: is useful to relatively de-empahsize the contrast between background and
        !            92: bright pixels. After recalculating the mapping, the entire picture will be 
        !            93: redrawn with the new pixels in the GPX.
        !            94: .SH BUGS
        !            95: .PP
        !            96: Needs a histogram display function to allow interactive setting of threshold
        !            97: and saturation values.
        !            98: Should have a true color palette instead of the rgb control to provide 
        !            99: independent colors. Needs more types of mapping.
        !           100: .SH AUTHOR
        !           101: William F. Wyatt, Smithsonian Astrophysical Observatory.

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