IIB

Description

Copies bitmap segment data from one database file to another, or to another segment in the same database file.

Parameters

Name	Type	Caption	Length	Value range
FILI *	String	Input file name	1 - 192
FILO	String	Output file name	0 - 192
DBIB *	Integer	Input bitmap segment	1 -
DBOB	Integer	Output bitmap segment	0 -
DBIW	Integer	Input data window	0 - 4	Xoffset, Yoffset, Xsize, Ysize
DBOW	Integer	Output data window	0 - 4	Xoffset, Yoffset, Xsize, Ysize
REPORT	String	Report mode	0 - 192	Quick links
MONITOR	String	Monitor mode	0 - 3	ON, OFF Default: ON

* Required parameter

Parameter descriptions

FILI

Specifies the name of the file from which the bitmap segment data is to be read.

FILO

Specifies the name of the PCIDSK file to which the bitmap segment data is to be written. FILO can be the same as FILI. If FILO is not specified, FILI is used. The specified output file (FILO) must exist before running IIB; if it does not, run CIM to create it.

DBIB

Specifies the input bitmap segments to be read from the input file (FILI).

At least one bitmap must be specified. Duplicates are allowed.

Ranges of channels or segments can be specified with negative values. For example, {1,-4,10} is internally expanded to {1,2,3,4,10}. When you are not specifying a range in this way, only 48 numbers can be specified explicitly.

DBOB

Specifies the output bitmap segments to be written to the specified output file (FILO).

If DBOB is not specified, the segment name and description of the newly created output segment is the same as that of the corresponding input bitmap segment. If DBOB is specified, the segment name and descriptor of the existing output segment is unchanged. Use MAS to modify the segment name and descriptor of the output bitmap, if desired.

DBOB can be the same as DBIB. In this case, the user must ensure that input and output windows (DBIW and DBOW) do not overlap.

Ranges of channels or segments can be specified with negative values. For example, {1,-4,10} is internally expanded to {1,2,3,4,10}. When you are not specifying a range in this way, only 48 numbers can be specified explicitly.

DBIW

Specifies the window (Xoffset, Yoffset, Xsize, Ysize) of data to be extracted from the input bitmap segments. If DBIW is not specified, the entire layer is used by default. Xoffset, Yoffset define the upper-left starting pixel coordinates of the window. Xsize is the number of pixels that define the window width. Ysize is the number of lines that define the window height.

DBOW

Specifies the window (Xoffset, Yoffset, Xsize, Ysize) in the output bitmap segments into which the bitmap data is to be embedded.

Xoffset, Yoffset define the upper-left starting pixel coordinates of the window. Xsize is the number of pixels that define the window width. Ysize is the number of lines that define the window height.

Xsize and Ysize need not be the same for DBIW and DBOW. Scaling of bitmaps is done automatically. The origin is at the upper left corner of the bitmap.

REPORT

Specifies where to direct the generated report.

Available options are:

• TERM: generates a report on the terminal (default)
• DISK: generates a report on file "IMPRPT.LST"
• OFF: turns off report generation
• <filename>: appends a report to the specified file

MONITOR

The program progress can be monitored by printing the percentage of processing completed. A system parameter, MONITOR, controls this activity.

Available options are:

• ON: Turns the monitor ON (default)
• OFF: Turns the monitor OFF (recommended if running in batch or background mode)

Details

IIB transfers bitmap segments from any set of input bitmap segments (DBIB) on the input file (FILI) to any set of bitmap segments (DBOB) on the output file (FILO). If output bitmap segments are not specified, they are created.

Any arbitrary rectangular window on the input file (DBIW) can be transferred to any arbitrary rectangular window on the output file (DBOW). Shrinking and/or zooming of image data is performed automatically when the input window size does not match the output window size.

In case when FILI and FILO georeferencing are not identical or when either DBIW or DBOW is not specified then IIB will transfer bitmap with gereferencing taken into account and reprojection done automatically if required.

Example

Create a new 512x512 bitmap with a 256x256 bitmap in the upper-left quadrant.

EASI>FILI	=	"input"
EASI>FILO	=	"output"
EASI>DBIB	=	1
EASI>DBOB	=
EASI>DBIW	=
EASI>DBOW	=	0,0,256,256	! initialize dbow and set to upper-left quadrant

EASI>RUN IIB