R8TOHDF(1)						      General Commands Manual							R8TOHDF(1)

NAME

       r8tohdf - convert 8-bit raster images to HDF format

SYNOPSIS

       r8tohdf [number-of-rows number-of-columns] output-filename [-p palette-filename] [-c] [-r] [-i] raw-raster-image-filename-1, raw-raster-
	      image-filename-2, ...

DESCRIPTION

       r8tohdf converts a set of raw raster images to the HDF RIS8 format and writes them to a file.

OPTIONS

       -p pallette-file
	      Specify the name of the palette file.

       -c     Run length coding.  Compress the output data using run-length encoding.

       -i     IMCOMP Compression.  Compress the output data using the IMCOMP method.

       -r     No Compression.  Apply no compression to the output data. (the default).

EXAMPLES

       A file named "rawras" contains a 256 x 512-byte raw raster image, and its palette is stored in a file name "mypal". To convert the informa-
       tion in these files to an RIS8 without compression and store the RIS8 in a file named "ras.hdf", enter the following r8tohdf command:

	 r8tohdf 256 512 ras.hdf -p mypal rawras

       A  800 x 1000-byte raw raster image is stored in a file named "bigpic".	This data must be converted to a RIS8 without a palette, compress-
       ing it using run-length encoding, then stored in a file named "bigpic.hdf". The following command will do this:

	 r8tohdf 800 1000 bigpic.hdf -c bigpic

       A 300 x 400 raw raster image is contained in each of the files named "pic1", "pic2", and "pic3". To convert all three files to RIS8s,  com-
       press them using the IMCOMP method, and store them in a file named "pic.hdf", enter

	 r8tohdf 300 400 pic.hdf -i pic1 pic2 pic3

       Different  types of raster image data are to be stored in a file named "ras.hdf". The image data in the file "rawras1" will be stored with-
       out a palette. The image data sets from the file named "rawras2" are to be stored with a palette extracted from a file named  "mypal".  The
       images from the "rawras1" and "rawras2" files are to be compressed using run-length encoding, and the image in the "rawras3" file is not to
       be compressed. The size of all images are 256 x 512 bytes. The following command is used to do this:

	 r8tohdf 256 512 ras.hdf -c rawras1 -p mypal rawras2 -r rawras3

SEE ALSO

       hdftor8(1), hdf(5)

								 November 6, 1999							R8TOHDF(1)