IIB

Description

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

Parameters

iib(fili, filo, dbib, dbob, dbiw, dbow)

Name	Type	Caption	Length	Value range
FILI *	str	Input file name	1 -
FILO	str	Output file name	0 -
DBIB *	List[int]	Input bitmap segment	1 -
DBOB	List[int]	Output bitmap segment	0 -
DBIW	List[int]	Input data window	0 - 4	Xoffset, Yoffset, Xsize, Ysize
DBOW	List[int]	Output data window	0 - 4	Xoffset, Yoffset, Xsize, Ysize

* 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.

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.

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.

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.

from pci.iib import iib

fili = "input"
filo = "output"
dbib = [1]
dbob = []
dbiw = []
dbow = [0,0,256,256] # initialize dbow and set to upper-left quadrant

iib( fili, filo, dbib, dbob, dbiw, dbow )