STScI Logo

dsimg stsdas.sobsolete



dsimg -- Write the image display buffer to an image.


dsimg frame image


This task reads the image display server's image buffer and writes the pixels to an image file. The output image is either an OIF format image (i.e., with an extension of .imh) or a STF format image (i.e., with an extension of .hhh), depending on the file name extension or value of the imtype environment variable.

The output image consists of short integers having the same values as the bytes in the display buffer. There is no connection with the original data used to fill the buffer. The image will be the same size as the currently configured buffer -- not the size of the displayed window. The entire buffer is written -- it is unaffected by the zoom and scroll states or the size of the display window.


frame = [integer, min = 1]
The image display buffer frame number to read. If this is not the currently displayed frame, the specified frame will be displayed.
image = "" [file]
The filename of the output image.
(maxrange = "yes") [boolean]
Rescale the data range to the dynamic range of single-byte pixels, 0:255. If maxrange = no then the output image pixels will be a straight copy of the values stored in the display with a maximum range 1:216.


1. Write display buffer frame 1 to the file frame1.imh and the colormap to cmap1.imh:

     > dsimg 1 frame1.imh



dstoim, cmtoim, rastoim

Source Code · Package Help · Search Form · STSDAS