Image tag: 

File: selects the new file to be loaded.  Any line starting with the
letter "c" and three filenames is a set of three FITS images that can be
combined to create a single color image. 

Bits: selects the number of bit to allocate to each pixel of the loaded
image.  This is primarily used to save memory for color images, and
shouldn't be necessary otherwise.  16 bits usually look no different than
32, but take up only half the space.  8 b it looks generally awful, and is
isn't really useful. 

Flip Interval: sets the amount of time between image flips.  The actual
time interval will very with the speed of comupter, so adjust this until
you get the timing you want. 

Set Flip Image: sets the currently loaded image to be the flip image. 
After doing this, you will need to load a new image to compare against the
saved one. 

Flip: begins flipping between the current image and the saved image. 
Pressing it a second time will stop the flipping. 

(networking stuff - fill in later)


Data tag:

Cursor Location: displays the location of the cursor when it is positioned
over the image. 

Zero Point(r): the zero point value for a single image, or for the red
component of a color image.  Can be set by the user to any floating point
value. 

Zero Point(b): the zero point value for the blue component of a color
image.  Can be set by the user to any floating point value. 

Sky: the value of the sky for a single image.  Can be set by the user to
any integer value. 

Reset Sky Samples: removes any user defined sampling regions (green
squares or circles). 

Magnitude: displays the magnitude of the surrently selected area. 

Mean: displays the mean value of the surrently selected area. 

Standard Deviation: displays the standard deviation of the surrently
selected area. 

Sample Shape: selects the shape used to sample the image.  The textfield
can be used to manually input the dimensions of the sampling shape.  Input
must be an integer. 

Angle: sets the angle of the cross section sampling shape. 

Delete Selection: removes all data from the currently selected area. 



Stars tag: 

Star Minimum: sets the amount by which a pixel must be greater than the
sky for it to be considered a star.  For example, if the sky is 500, and
the Star Minimum value is 1000, only pixels with a value of 1500 or
greater will be looked at.  Be aware that setting this value too low can
take a very long time and produce undesired results. 

Find Stars: starts looking for stars.  Pressing this button again will
stop a search in progress. 

Star data: displays data about the stars found.  For a single image, the
data will consist of the x location, the y location, and the magnitude of
each star.  For a color image, the data wil consist of the value (blue
magnitude - red magnitude), and the b lue magnitude of each star. 


Color Tag: 

Red Minimum: sets the minimum pixel value for a single image, or for the
red component of a color image. 

Red Maximum: sets the maximum pixel value for a single image, or for the
red component of a color image. 

Green Minimum: sets the minimum pixel value for the green component of a
color image. 

Green Maximum: sets the maximum pixel value for the green component of a
color image. 

Blue Minimum: sets the minimum pixel value for the blue component of a
color image. 

Blue Maximum: sets the maximum pixel value for the blue component of a
color image. 

Invert Image: inverts the currently displayed image.  Some images will
show more detail when this is done. 

Loading a single image: 

Click on the Image tab if it is not already selected.  Select the desired
number of bits you wish the image to be stored as.  Select a filename from
the File menu and the new image will begin loading.  The time this takes
will vary depending on the size o f the image. 

Sampling a single image: 

Click on the Data tab if it is not already selected.  Enter a value in the
Zero Point textfield (if desired).  A sky value will have automatically
been calculated, but you may override this if you wish by entering a
number in the Sky textfield.  You can n o move the cursor over the image
and data will be returned for that single point.  If you wish to sample
more than a single point, select a shape from the Sample Shape menu. 
Next, position the cursor over the image and press press button 1 on the
mouse.  While still holding down the button, drag the mouse downward until
you have a a shape of the desired size.  If you wish to change the
location of the sample, you can click and drag the shape to anywhere on
the image.  If you wish to change the size of th e sampling area, you can
enter the desired size into the textfield under the shape menu. 

Using the Cross Section: 

The Cross Section is a specialized type of sampling shape.  The Cross
Section can be created and moved like the other sampling shapes.  When the
Cross Section Shape is selected, a new window will open.  This is where
the data will be displayed in graph fo rm when the Cross Section is used. 
Once the data is displayed on the graph, clicking the Animate button in
the graph window will remove all of the data points, then slowly display
them one at a time.  Click the button at any time to pause the animation,
then click it once more to resume. 

Finding stars in a single image: 

Click on the Stars tab if it is not already selected.  Enter a number in
the star minimum textfield.  A good number will vary greatly from one
image to the next.  Because a low number can take a very long time, you
should start with a high number (10000 o r greater) and gradually lower it
until you get good results.  Once a number is entered, press the Find
Stars button.  A status bar will will show the amount of work completed. 
If work is proceeding too slowly, press the button again to cancel.  When
the work is complete, the Star Data textarea will display three pieces of
data for each star found: the x location, the y location, and the
magnitude. 

Adjusting the display properties of a single image: 

When a newly loaded image is first displayed, the default display dettings
will usually be adequate, and generally can't be improved upon by much. 
However, you may have an unusual image which looks bad with the default
settings, or you may want to tweak the settings to acheive some
interesting effect.  To do this, first click on the color tab if it is not
already selected.  Two scrollbars will be enabled, minimum and maximum. 
Adjust them as desired.  The maximum value should always be higher than
the minimum value. 

Loading a color set: 

Click on the Image tab if it is not already selected.  Select the desired
number of bits you wish the image to be stored as.  Color image sets will
be represented in the File menu as the letter "c" followed by three
filenames.  Select one of these and the images will begin loading.  This
will take longer than loading a single image. 

Finding the stars in a color set: 

This works exactly the same as for a single image, except the output is
different.  Output for color images consists of the value (blue magnitude
- red magnitude), and the blue magnitude of each star. 

Adjusting the display properties of a color set: 

This works the same way as for a single image, except that the minimum and
maximum values must be set for each image in the set. 

Highlighting a range of Values: 

Once an image is loaded, click on the Stars tab.  Adjust the two 
scrollbars labeled Highlight Minimum and Highlight minimum to set the
upper and lower bounds.  Any pixels in the image that have a value between
these bounds will be highlighted on the image .  Set both scrollbars to
zero to turn this highlighting off.