
 Tnimage Help File
 ------------------------------------------------------------------------
 This help file is is ordinary ASCII format. New comments or corrections
 can be added as needed, provided that the following format is adhered to:

 (1) Line length can not exceed 80 characters.
 (2) The first character of each line is either a digit (indicating the
     help topic) or a space.
 (3) A maximum of 40 lines per help topic.

 No copyright restrictions apply to this file. If you pass this file to
 another person, please indicate in the file that you have modified it,
 to avoid confusion!
 ------------------------------------------------------------------------
1 General Help - (F1)

  To select a region - Unless you select a region, most operations will
  be applied to the entire image. To select a region, click on one corner
  and drag to the other corner with the mouse.

  To add text - move to the desired location and begin typing.

  There are also shortcut methods for some operations:
     Selecting foreground color - click on desired color in the displayed
       palette with the left mouse button.
     Selecting background color - click on desired color in the displayed
       palette with the right mouse button.
     Drawing lines - Press F2 to toggle line drawing mode on/off.
     Clicking on the menu bar also turns off line drawing, box drawing,
       densitometry, region scanning, and several other operations.
  
  To move the image around - Click on one of the 4 arrows in the menu bar.
     The amound of movement can be changed by pressing the gray (+) or (-)
     keys. These keys also change the distance the cursor will travel when
     it is moved with the arrow keys.
  

2 Help - Pixel interaction mode
  This setting determines how 2 pixels will interact when an image is copied
  over another or loaded from disk. Thus, you can subtract 2 images, or
  offset the same image by a small amount and then subtract it (to create a
  3D effect). The operations are:
     Overwrite ( default )  - This is the normal, fast mode.
     Maximum                - Pixel is set to the larger of the 2 values.
     Minimum                - Pixel is set to the smaller of the 2 values.
     Add                    - The 2 values are added.
     Subtract               - The 2 values are subtracted.
     XOR                    - The 2 values are XOR'd.
     Average                - The 2 values are averaged.
  For the pixel values to become permanent, you must create a new image by
  selecting "Create image" from the 'Files' menu. Otherwise, they will revert
  back to their original values when the image is redrawn.

3 Help - Save image
  Save entire image - This will cause the currently-selected image to be
    saved in its entirety.
  Save selected region - Causes the selected screen region (which may contain
    parts of 1 or more images) to be saved. If multiple images are overlapping,
    the pixels from the foreground image are saved. Always check the "region
    saved" report to make sure the area saved is what you wanted.
  TIFF/PCX - Currently, TNIMAGE can save images either in TIF or PCX format.
    (Default is TIF).
  Color/gray scale vs. monochrome - Select monochrome only for black-and-white
    images. Monochrome images will be much smaller than color/gray scale
    images but contain only 1 bit per pixel. Color and gray scale images are
    treated identically. The palette and optical-density table (TIF files only)
    are also saved with the file if you select color/gray scale.
  Filename - Click on this box, and type in the desired filename, then press
    <Enter> or click the mouse when finished.
  Image number - Not normally changed. This indicates which image is currently
    selected in case you want to save the entire image.

4 Help - Print
  Resolution - Click on 300, 600, or 1200 dots/inch, depending on the
    resolution of your Laserjet-compatible printer.
  Positive/negative - Currently not implemented
  Print entire image/ print selected region - Select whether you wish to print
    the entire image, or only the screen region which you selected most
    recently (if no region was selected, it will print the entire image).
  Bits/pixel - This determines the number of gray levels which appear in the
    print-out. For example, 6 bits/pixel corresponds to 64 different possible
    levels. More bits/pixel also means the print-out becomes larger.

5 Help - Change palette
  Click on the desired palette.
  Brightness - changes the color saturation of the selected palette.
  Rotate palette - causes the color map to be shifted to lower or higher
    pixel values (depending on where you click).
  Other - Allows you to select from 20,000 possible palettes.

6 Help - Densitometry
  Pixel compensation - This only has an effect if a TIF file containing
    an optical density table has been loaded. The pixels are converted into
    numbers proportional to the O.D. originally calculated by the scanner.
    "On" is the recommended setting for all scanned images.
  Maximum signal - determines whether the image is a white-on-black (max=255)
    black-on-white (max=0) image. If 'max.signal' is 0, then a completely
    black region will have the strongest signal.
  Area selection -
    Automatic: A region will be automatically selected each time. Click in
      the center of the region to begin densitometry. The area actually
      analyzed temporarily changes color. The analyzed area will be determined
      by finding the set of all contiguous pixels whose value is between the
      specified background level and the maximum signal level specified above.
      For extremely noisy images, it may be helpful to delineate the outer
      boundary of the region to be analyzed by first drawing a black line
      around it.
    Manual: Select a rectangular region each time.
    Fixed size: Select a rectangular region. This is used as a template so
      that all subsequent measurements use the same number of pixels.

7 Help - Filter
    Filter types -
       Low pass  - Blurring filter
       High pass - Sharpening filter
       Laplace   - Edge detection
       Background subtract - Removes only very low spatial frequencies.
         Eliminates slow gradients and broad smudges from image.
       Median filter - Eliminates extraneous pixels
       Sharpen / - Sharpens image by adding shadow at 45ø angle (freeze-
         fracture effect)
       Sharpen | - Sharpens image by adding shadow at 90ø angle (freeze-
         fracture effect)
       Sharpen / - Sharpens image by adding shadow at 0ø angle (freeze-
         fracture effect)
    Kernel    - Determines the number of surrounding pixels to be
       convoluted with each pixel. In conjunction with kernel multiplier,
       this determines the size range that will be emphasized or smoothed
       out.
    Kernel multiplier - Determines the area that is covered by the
       selected kernel. A higher value results in a lower spatial frequency.
    ñRange (median)  - Determines the maximum deviation from the median
       value that is permissible. If a pixel deviates from the median by
       more than this value, the median is substitued. This allows you to
       select the amount of noise filtering.
    Amount of sharpening - (For high-pass filter) - Select how much
       sharpening is desired (10=maximum).

8 Help - Scan region
    Select coordinates - You must reselect the region to be scanned each time.
      This is done by:
        Click on one starting corner with left mouse button.
        Drag to the other starting corner and release mouse button.
        Click on one ending corner (This can be on the left, right, above, or
          below the starting corners).
        Drag to the other ending corner and release. Scanning will then start
          in the direction of 'start' to 'end'.
    Repeat scan        - The previously-selected region is re-scanned.
    Maximum (0 or 255) - Determines whether black (0) or white(255) is to be
       regarded as the largest signal.
    Pixel compensation - If checked, uses the internal OD table which was
       included in your image if it was a TIF file produced by a scanner.
       The pixels are then converted to actual optical density values before
       being added together.
    Diagonal / Snap to 90ø - If 'diagonal' is checked, scanning can be done
       on features that are oriented at any angle. If 'snap to 90ø'is checked,
       the starting and ending edges will automatically 'snap' to the closest
       value (0 or 90ø), causing diagonal areas to be scanned as a series
       of vertical or horizontal lines.
       Snapping to 90ø allows the use of a faster algorithm.
    Automatically save scan - If checked, the data will be saved in an ASCII
       file after each scan.
    Filename - Filename under which the scan will be saved. If the 1st 8
       characters are all digits, the filename will be incremented as a number
       each time, e.g., '1000.dat' will become '1001.dat'.

9 Help - Fill an area
   Fill type - Select between a solid color, or a gradient which changes
     in the vertical or horizontal direction.
   Fill color - The color to be used when filling with a solid color.
   Max border color _  The region that includes all contiguous pixels between
   Min border color    these two values will be filled.

   Maximum gradient color -  The pixel value to be used at the top (for
     vertical fills) or far left (for horizontal fills). This can be any
     integer, not just 0-255. The gradient fill will calculate the steepness
     and starting color of the gradient fill by interpolating between the
     maximum and minimum gradient colors. Thus, the 'maximum' color can be
     lower than the 'minimum' color to create a decreasing gradient.
   Minimum gradient color - The pixel value to be used at the bottom (for
     vertical fills) or far right (for horizontal fills).

   At any time, you can stop the fill process by pressing <ESC>.

10 Help - Click box

    The minimum and maximum acceptable values are shown. Click on the
    arrows on each side of the indicator bar to increase or decrease
    the value, or click and drag the vertical position indicator until
    the desired value is obtained.

11 Help - Read image

  Filename selection:

  Click on desired file with the mouse. The TAB key toggles between
  the filename list, directory list, and drive list. Clicking on the
  desired list has the same effect.
  Click on the small triangles in the upper and lower right of the list
  to scroll through the list. Or, click on and drag the indicator to
  move rapidly through the list.
  The arrow keys can also be used to scroll up and down in the
  currently-active list.
  To change drives, click on the desired drive name.

  Positive/negative: Determines whether the image should be color-inverted.
  Vertical/horizontal: Determines the screen orientation for the image.
  X-position: Left x-coordinate of the image.
  Y-position: Upper y-coordinate of the image.
  X size: Final size of the image in the x dimension, as a fraction of the
     original size (0-1). (The x or y dimension is relative to the orientation
     of the image, not the screen).
  Y size: Final size of the image in the y dimension, as a fraction of the
     original size (0-1).

12 Help - Create Palette
 
  To change Red, move the mouse cursor to the top box.
  To change Green, move the mouse cursor to the middle box.
  To change Blue, move the mouse cursor to the lower box.

  Then click and drag to create a graph of the intensity of that color
  for each color value between 0 and 255. Click on 'OK' when finished.
  
  Click on 'smooth' to make the new palette smoother.
  

13 Help - Plot
  
  Click and drag to select a range of X-values to be integrated.
  Click OK when finished.  
  BL Smoothness: Adjusts the frequency cutoff of the automatic baseline
     calculation. A higher value increases the smoothness of the calculated
     baseline.
     