Starlab version 4.4.1
    program created on Apr 27 2005 at 23:00:25
    source file     /home/steve/starlab/src/node/dyn/hdyn/xutil/snap_to_image.C

snap_to_image:  Construct images of a series of snapshots.

Options:
          -1           combine all frames in a simgle image          [yes]
          -a           produce a series of frames for animation       [no]
          -c           compress the image file(s) using gzip          [no]
          -C colormap  specify a colormap file name                   [no]
          -d           delete frames once the animation is made       [no]
          -f filename  specify root name of image files   ["-" --> stdout]
          -F format    specify image file format
                           (0 = PNG, 1 = SUN, 2 = GIF)                 [0]
          -g           write GIF files -- same as "-F 2"              [no]
          -G           toggle forcing particles to grid (nicer single
                           frames, but jerkier movies)              [true]
          -H           toggle Herzsprung-Russel diagram or positional
                           plot                                 [position]
          -i index     specify (real) color index (0-1) for all stars
                                                      [use internal index]
          -l scale     specify width of field of view (+/- scale)      [3]
          -L loop      specify number of loops in animation           [10]
          -m           use mass to determine star color and/or size   [no]
          -n nmax      specify maximum number of images to produce   [Inf]
          -N nbody     color using a (small-N) colormap               [no]
          -o filename  same as -f (more standard name)
          -O option    specify how to choose the plot origin           [0]
                           0:  as is (don't adjust)
                           1:  initial center of mass
                           2:  modified center of mass of each frame
          -p psize     specify (maximum) star radius/scale, in pixels
                       (psize < 0 ==> lower limit on pixel size = 0,
                       otherwise, limit = 1)
                                         [0 (single image), 1 (animation)]
          -P axis      specify projection axis                         [z]
          -q           toggle suppression of diagnostic output
                                                          [don't suppress]
          -r           use stellar radius to set point size           [no]
          -R           animate in reverse                             [no]
          -s nx ny     specify image size, in pixels                 [256]
          -S nskip     specify snaps to skip between images            [0]
          -t           test the color map [don't test]
          -T           specify precedence scheme for points in the image
                           (c = color, r = radius, z = depth)          [z]
          -x           specify right (log effective temparature) edge
                           of HRD (-H only)                            [3]
          -X           specify left (log effective temparature) edge
                           of HRD (-H only)                            [5]
          -y           specify minimum (log luminosity/Lsun) limit
                           of HRD (-H only)                           [-3]
          -Y           specify maximum (log luminosity/Lsun) limit
                           of HRD (-H only)                            [3]

Notes: 1. If animations are specified, an MNG or animated GIF file will
          be created.  The individual frames will be retained unless
          the "-d" option is set.
       2. If PNG output is requested and the PNG libraries are unavailable,
          then GIF output is produced instead.
       3. The "T" option determines which attribute is favored in
          displaying a particle in the image.  The default is depth,
          but we can also raise particles based on color or radius.