[Top] [Prev] [Next]

15.7 Extracting 8-Bit Raster Images and Palettes from HDF Files: hdftor8

15.7.1 General Description

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

15.7.2 Command-Line Syntax

hdftor8 input-HDF-filename [-i] [-v] [-r raster-image-filename] [-p palette-filename]

-i Interactive Mode

 Program is executed in interactive mode.

-v Verbose Mode

 Program is executed in verbose mode. Diagnostic messages are displayed during the session.

-r Raster Image File Name

 The raster image file name immediately follows this flag.

-p Palette File Name

 The palette file name immediately follows this flag.

The names given as the HDF format file, raster image file, and palette file 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 defined as in the preceding paragraph. The default name for a palette file, if no name is specifically given in the command, is "pal.#".

15.7.3 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".


[Top] [Prev] [Next]

hdfhelp@ncsa.uiuc.edu
HDF User's Guide - 07/21/98, NCSA HDF Development Group.