![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to showimg.1 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDTahoe / new / X / showimg|
Return to showimg.1 CVS log | Up to [CSRG BSD Unix] / 43BSDTahoe / new / X / showimg |
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.