Help for MARK

PURPOSE:

   MARK is a VICAR applications program used to scribe rectangles
   about specified pixel locations.

EXECUTION:

        MARK  INP=(PIC,LOC) OUT=OPIC
  or
        MARK  INP=PIC  OUT=OPIC  DATA=(l1,s1,l2,s2,l3,s3,...)

  where PIC is the input image (byte or halfword),
        OPIC is the output image (same data format as PIC).

  The pixel locations to be enclosed inside rectangles are specified either
  by inputing them via a secondary input file (LOC) or via user parameters.
  See parameters INP or DATA for details.

OPERATION:

 MAXDN=n specifies the DN value of the scribed rectangle.
 The DN value of the scribed rectangle will be 0 or MAXDN, depending upon
 whether the mean value of the pixels on the perimeter are greater than or
 less than MAXDN/2, respectively.  Default MAXDN=255 for byte data and
 511 for halfword data.

 Rectangles are scribed in such a way that center locations can be
 specified to one-half pixel. The program does this by selecting
 either an even or an odd dimension for the rectiangle depending on
 where the coordinate falls with respect to the pixel mesh. This is
 done independently in the line and sample direction.
   
 The location of the inscribed rectangle boundaries depends on the
 fractional part of the location of the center and the BOXSIZE 
 parameter specified. If the center has been specified by line-sample
 coordinates (L,S) and the BOXSIZE as N.  Then the actual interior size
 and the center of the box, excluding the scribed lines will be:
   
         FRACTIONAL PART=F        SIZE=N         CENTERS
                                 ODD  EVEN    LINE    SAMPLE
        0.0 .LE. F .LT. .25      N    N-1      L        S   
        .25 .LE. F .LT. .25      N-1  N        L+1/2    S+1/2
        .75 .LE. F .LT. 1.0      N    N-1      L+1      S+1

 So if the BOXSIZE=8, the interior region would be 7 lines by
 8 samples if the fractional part of the real numbers specifing
 the line and sample coordinates are less then .25 and between
 .25 and .75, respectively. For example, BOXSIZE=8, L=35.1 and
 S=16.3 results in a box of 7 lines by 8 samples with the upper
 left corner located at line 30 and sample 11.

PROGRAM HISTORY:

Written By: Sayuri Harami, September 13, 1971
Cognizant Programmer: Gary Yagi
REVISIONS: 
    5 MAR  2001  GMY  Increased max BOXSIZE to 30.  Fixed SIZE field.
		      Added EVENONLY and ODD_ONLY keywords
		      Added MAXDN parameter.
   31 OCT  1994...A.SCOP..(CRI)..Made portable for UNIX
   29 MAR  1985...M.E.MORRILL....REAL MARK FORMAT FOR RESEAUS
   24 OCT  1984...M.E.MORRILL....CONVERSION TO VAX-VICAR*2
   27 JUNE 1975...D.A.HASS.......CONVERCION TO IBM 360/OS
   26 JULY 1973...K.R.N..........VMIO ALT BUFFERING
   15 SEPT 1971...J.E.KREZNAR....UPDATE
   13 SEPT 1971...S.X.HARAMI.....INITIAL RELEASE