MBUIMA -- DIPIX Format Tape Image Data Transfer


<HEAD><TITLE>MBUIMA -- DIPIX Format Tape Image Data Transfer</TITLE></HEAD>


<H1>MBUIMA -- DIPIX Format Tape Image Data Transfer</H1>
Transfers one Dipix imagery file (feature or theme) from a Dipix BU
format tape to PCIDSK database image channel.<p>
Progress of this program can be monitored. See MONITOR section.
<P>
<H3>PARAMETERS</H3>
MBUIMA is controlled by the following global parameters:
<P>
<pre>Name     Prompt                                  Count     Type
BUFILE   DIPIX File Name                         1-9       Char
FILE     Database Filename                       1-64      Char
MTIW     Mag Tape Input Window                   0-4       Int
DBOW     Database Output Window                  0-4       Int
DBOC     Database Output Channel List            1         Int
</pre>
<H4>BUFILE</H4>
Specifies the name of the file to be read. MBUIMA reads only one
Dipix BU image file per run. The filename should be of the form:
<P>
<PRE>
 Character:      1 2 3  4 5  6 7 8 9
 Contents:       (A A A)(X X)(C C C C)
</PRE>
Characters 1 through 3 specify an Dipix area name. Characters 4 and
5 specify the type of image file: Feature (FF) Theme (TT), or 16-bit
unsigned integer (FS). Characters 6 through 9 specify a Dipix style
channel identifier.
<P>
<PRE>
 EASI&gt;BUFILE=&quot;...string...&quot;
</PRE>
<H4>FILE</H4>
Specifies the PCIDSK file to which to write the imagery data.
<P>
<PRE>
 EASI&gt;FILE=&quot;filespec&quot;           | input file name
</PRE>
<H4>MTIW</H4>
Specifies a rectangular window on tape that will be transferred to
the database image.
<P>
<PRE>
 EASI&gt;MTIW=Xoffset,Yoffset,Xsize,Ysize
 EASI&gt;MTIW=                     | defaults to image size on tape
</PRE>
<H4>DBOW</H4>
Specifies a rectangular window on the database image to which to
transfer the tape data.
<P>
<PRE>
 EASI&gt;DBOW=Xoffset,Yoffset,Xsize,Ysize
 EASI&gt;DBOW=                     | default to size of database
                                | image channels
</PRE>
<UL>
<LI> Xsize and Ysize need not be the same for MTIW and DBOW. 
<LI> Scaling and mapping of images is done automatically. 
</UL>
<H4>DBOC</H4>
Specifies one output image channel on the database image file.
<P>
<PRE>
 EASI&gt;DBOC=i                            | integer
</PRE>
Output channels may be of any type (8, 16 or 32 bit).
<P>
<H3>DETAILS</H3>
MBUIMA transfers one Dipix imagery file (BUFILE) from a Dipix format
tape to an image channel (DBOC) on a PCIDSK image database file
(FILE).<p>
MBUIMA transfers the rectangular window specified by MTIW from the
tape into the output window, specified by DBOW, on database. Any
arbitrary file and window may be read from tape providing that the
window falls within the limits of the image on tape. If no input
window is specified, then the window is defaulted to the full size
window as determined from the BU tape file. Shrinking and zooming in
both dimensions are automatically performed.<p>
The two types of Dipix image files supported by this task are
feature files and theme files. Each byte of a feature file is
characterized by a 256-level value ascribed to its associated pixel.
Each byte of a theme file defines up to eight themes (one per bit)
which may be associated with that pixel.<p>
The Dipix BU file name is stored in the database channel descriptor
on completion of the data transfer.<p>
MBUIMA only reads ONE file in per run. So if you want to transfer
`N' channels on tape to database, then you must run MBUIMA `N'
times, setting up the appropriate parameters.<p>
The description of the Dipix tape format is given in documentation
for MBUREP program.<p>
MBUIMA can read Dipix BU image files which have a maximum of 32768
pixels per line for 8-bit unsigned imagery. (If not 8-bit unsigned
imagery, MBUIMA will handle a maximum scanline width of 8192
pixels.) (On IBM PCs, up to 16384 pixels per line of 8-bit unsigned
imagery or 4096 pixels per line of non 8-bit imagery can be
processed.)
<P>
<PRE>
 A TAPE MUST BE MOUNTED ON THE TAPE DRIVE BEFORE MBUIMA CAN BE
 RUN.  CLEANING THE TAPE HEADS IS RECOMMENDED TO MINIMIZE THE
 CHANCE OF TAPE READ ERRORS.
</PRE>
<H3>MONITOR</H3>
Program progress can be monitored by printing the percentage of
completed processing in odometer fashion. A system parameter,
MONITOR, controls this activity:
<P>
<PRE>
 EASI&gt;MONITOR=&quot;ON&quot;           | turn monitor ON  (default)
 EASI&gt;MONITOR=&quot;OFF&quot;          | turn monitor OFF (recommended if
                             | running in batch/background mode)
</PRE>
<H3>EXAMPLE</H3>
Transfer Dipix image file NOAFFBND2 from tape to channel 1 on a
PCIDSK database file:
<P>
<PRE>
 EASI&gt;BUFILE=&quot;NOAFFBND2&quot;
 EASI&gt;FILE=&quot;NOAFFBND2.PIX&quot;
 EASI&gt;MTIW=
 EASI&gt;DBOW=
 EASI&gt;DBOC=1
 EASI&gt;RUN MBUIMA
</PRE>
<hr>
<a href="http://www.pcigeomatics.com/dev_corner/pcihlp_gateway.html">About PCI Help Gateway</a>