NAME

rashead -- Show a rasterfile image header.

USAGE

rashead rasfile

DESCRIPTION

Print the header of a Sun rasterfile format image. The header stores information about the image: size, format and depth.

If the rasterfile contains a colormap, it may be read and listed.

Additional explanatory text may be written to STDOUT if desired. The verbosity parameter specifies which information is written.

This task should be fully portable. It does not depend on Sun libraries.

PARAMETERS

rasfile = "" [file]

The input file to be converted. This is assumed to be an eight-bit Sun rasterfile. It may include a colormap but does not need one.

verbosity = [integer, min=1, max=3]

The level of output written to STDOUT. The following output is produced for each possible value:

	verbosity	text
	---------	----
	    1           Image and file size,
	                depth, raster type,
	                color map type and size
	    2		Add image name
	    3		Add colormap values

EXAMPLES

1. Print the header of the rasterfile sun.ras:

pl> rashead sun.ras

which would result in the following:

640 x 440  File size:  278283
Depth:  8 bits/pixel  Gray/Mapped
Raster type:  2  Byte-Encoded
Color map:  type 1  Equal RGB, size 768

BUGS

REFERENCES

Rasterfile format is described in the rasterfile(5) Unix man page and in Chapter 6 of the Sun Pixrect Reference Manual.

SEE ALSO

rastoim