The new hdfrseq routine now supports displaying the image(s) in a window
on a Sun running Sunview instead of displaying them on /dev/fb (which has
the nasty property of disrupting the bitmap).

It is essentially an update of the existing NCSA utility "hdfrseq" and
when used on IRIS or displaying ICR remotely there are no differences.
When displaying locally on a Sun running Sunview, however, a frame and
canvas are drawn with the image displayed in the canvas, and a "color map
bar" above the image.  Should the image be too large to be fully displayed
in the visble canvas, the window may be resized and/or the horizontal
and vertical scrollbars may be used to scroll the image.
If hdfseq was invoked on a series of files, a button in the window allows
the "animation" to be re-run.  If invoked with the "-s" (step) option,
a button in the window allows cyclically stepping through the images.


The files required to build the new hdfrseq/hdfseq utility are:

hdfrseq_new.c
im_icon.h



This software is presented to NCSA by Paul Gerardi of Schlumberger-Doll
Research in Ridgefield, CT in appreciation for creating and supporting HDF.

This software is placed in the public domain and the author gives NCSA all
rights to this software including using and re-distributing it in any form.

We ask that the name of Paul Gerardi and Schlumberger be left in the
"maintenance field" of comments in the source program.

 -- End of original README.hdfrseq_new from Paul --


Implementation note:

If you have a version of Sun OS that precedes version 4.0, you need
to make the following changes to in hdfrseq_new.c to allow you to 
compile it successfully.

Remove the following lines at the top of the program:

#include <sys/types.h>
#include <suntool/scrollbar.h>
#include <suntool/tty.h>
#include <suntool/textsw.h>
#include <suntool/seln.h>
#include <pixrect/pixfont.h>
#include <pixrect/pixrect.h>
#include <pixrect/pr_io.h>
#include <pixrect/pixrect_hs.h>

This means the top of the code would read:

#ifdef SUN

#include <stdio.h>
#include <errno.h>
#include <suntool/sunview.h>
#include <suntool/panel.h>
#include <suntool/canvas.h>
#include <memory.h>
#include "im_icon.h"
#define NEEDPAD                 /* Needs padding to byte bioundary */
#define BYTEBOUND 4             /* byte boundary of a word on Suns */
                                /* should be multiple of  2 on Sun3 */
                                /* and 4 on Sun4 */
#endif



