HDFTOR8(1)						      General Commands Manual							HDFTOR8(1)

NAME

       hdftor8 - extract 8-Bit raster images and palettes from HDF file

SYNOPSIS

       hdftor8 hdf-file [-i] [-v] [-r raster-image-file] [-p pallette-file]

DESCRIPTION

       hdftor8 extracts the raster images and/or palettes from an HDF file and stores them in one file that contains the raster image data and an-
       other that contains the palette data.

       The names given for the raster image and palette files are interpreted by hdftor8 as follows: For each raster image file, the file name	is
       given  the extension ".#.@.%", where "#" represents the raster image number from the HDF file, "@" represents the x-dimension of the raster
       image, and "%" represents the y-dimension of the raster image. For each palette file, the file name is given the extensions ".#", where "#"
       represents the palette number from the HDF format file.

       If no name is given for the raster image file, the default name "img.#.@.%" is assigned, where "#", "@", and "%" are as defined in the pre-
       ceding paragraph. The default name for a palette file is "pal.#".

OPTIONS

       -i     Execute the program in interactive mode.

       -v     Execute in verbose mode. Display diagnostic messages during the session.

       -r raster-image-file
	      Specify the name of the raster image file.

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

EXAMPLES

       A file named "denm.hdf" contains three 512 x 256 raster images and three palettes. To store these images and palettes  in  separate  raster
       image and palette files, use the following hdftor8 command:

	       hdftor8 denm.hdf

       Six files are created, named "img1.512.256", "img2.512.256", "img3.512.256", "pal.1", "pal.2", and "pal.3".

SEE ALSO

       r8tohdf(1), hdf(5)

								 November 6, 1999							HDFTOR8(1)