Help for RAPIDMOS

PURPOSE

    RAPIDMOS mosaics multiple images into one output image. 
The operation is similar to that of FASTMOS, but with reduced 
execution time and with some functions removed.  Up to 40
images may be mosaicked at one time.  Currently only byte
images are handled.  NOTE: the non-zero portion of the image
must be convex.


EXECUTION

     rapidmos INP=(A1,A2,...,An)  OUT=B   NL=NL  NS=NS   		  OFFSETS=(LOFF1,SOFF1, LOFF2,SOFF2, ... , LOFFn,SOFFn)
	
     A1,A2,...,An       are the input images.
     B                  is an output image.
     NL			is the number of line in the output image
     NS			is the number of samples in the output image
     LOFF1,SOFF1...     line and sample in the output image where the
                        upper left corner of the input image will be
                        positioned.
OPERATION

     Mosaicking  is  performed by reading the lines  of  all 
     input images and combining them into the line of output 
     image.   If  the  input pixels overlap,  the  preceding 
     input image supersedes the successive.   Zero pixels of 
     the  input images are ignored if they lie  outside  the 
     non-zero perimeter; however, they are preserved if they 
     are  a  part  of a "zero-island"  within  the  non-zero 
     perimeter.  Pointers to the left and right edges of each
     image are kept and updated for each line.  For this reason
     concave images (which have more than two edges on a line)
     will not be mosaicked correctly.  It is the use of these
     pointers, however, that reduces the CPU time compared with
     FASTMOS.


EXAMPLE

     rapidmos INP=(A,B,C) OUT=D SIZE=(1,1,1000,1000)          	      OFF=(100,100, 100,500, -25,150)

     This example mosaics three images, positioning their left 
     upper   corners  into  pixels (100,100),  (100,500) and 
     (-25,150) of the output image respectively.


RESTRICTIONS

     1.  Only byte images are supported.
     2.  The non-zero portion of the images must be convex.
     3.  There may be up to 40 input images.
     4.  The maximum number of samples for input or output images is 50,000.

WRITTEN BY:                B. Gokhman

COGNIZANT PROGRAMMER:      K. F. Evans

REVISION:  2		April 1986

Ported to UNIX             C.R. Schenk (CRI) May 1995



PARAMETERS:


INP

Input images (up to 40)

OUT

Output image

SIZE

Size field for output picture Only NL and NS are used.

NL

Number of lines in the output

NS

Number of samples in the output

OFFSETS

Specifies positioning of inputs

See Examples:


Cognizant Programmer: