.TH hdftoxwd 1 
.SH NAME
hdftoxwd \- convert an HDF image to an XWD image.
.SH SYNOPSIS
.B hdftoxwd
-i imagefile
[-options argument]
.SH DESCRIPTION
.I Hdftoxwd
converts an HDF image to an XWD image.  This is mostly useful for
quick display of an HDF image on an X display, or to print the HDF
image on a tek4693 color printer.  To print the image, you must also
use xwdtotek4693. 
.br
(ie. hdftoxwd -i image | xwdtotek4693 | lpr -Poliver).
.br
.SH REQUIRED ARGUMENTS
.TP 8
.B -i imagefile
The input image.  This must be present, stdin cannot be used.
.SH OPTIONS
.TP 8
.B -n imagenumber
HDF files may have more than 1 image.  This option allows you to
choose which image.
.TP
.B -p palettenumber
HDF files may have more than 1 palette.  This option allows you to
choose which palette to use.
.TP
.B -f palettefile
A palette may come from another file.  This kind of palette must come
from an HDF file.
.TP
.B -o outputfile
Specifies the output file.  If not specified, output defaults to
stdout.
.SH SEE ALSO
paltohdf(1), xwdtohdf(1), xwdtotek4693(1)
.SH BUGS
You bet.  Mail to olsen@msc2.tn.cornell.edu.
.SH REQUIREMENTS
The NCSA HDF library should be present on your system.
.SH ACKNOWLEDGMENTS
Thanks to NCSA for providing the HDF file specifications, and the Unix
C code needed to manipulate them.  Thanks to Jef Poskanzer for
inspirations and code segments for X Window Dump read/write routines
in his package PBMPLUS.
.SH AUTHOR 
Dave Olsen