IIIC

Description

Transfers image data between two image files or within one image file.

Parameters

iiic(fili, filo, dbic, dboc, dbiw, dbow)

Name	Type	Caption	Length	Value range
FILI *	str	Input file name	1 -
FILO	str	Output file name	0 -
DBIC *	List[int]	Input raster channel(s)	1 -
DBOC *	List[int]	Output raster channel(s)	1 -
DBIW	List[int]	Raster input window	0 - 4	Xoffset, Yoffset, Xsize, Ysize
DBOW	List[int]	Raster output window	0 - 4	Xoffset, Yoffset, Xsize, Ysize

* Required parameter

Parameter descriptions

FILI

Specifies the name of the GDB-supported image file from which image data is read.

FILO

Specifies the name of the GDB-supported file to receive image data. The output file can be the same as the input file. FILO must already exist before running IIIC. If FILO is not specified, FILI is used by default.

DBIC

Specifies input channel(s) read from the input file (FILI).

DBOC

Specifies the output channel(s) generated to the output file (FILO).

The total number of channels specified by DBOC must be equal to the total number of channels specified by DBIC.

If the corresponding input and output channels are the same, the input and output windows (DBIW and DBOW) must not overlap.

DBIW

Specifies the raster window (Xoffset, Yoffset, Xsize, Ysize) that is read from the input layers. If DBIW is not specified, the entire channel 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 raster window (Xoffset, Yoffset, Xsize, Ysize) to be output. If DBOW is not specified, the entire layer is output 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.

The Xsize and Ysize need not be the same for DBIW and DBOW. Image scaling and mapping is automatic.

If FILI equals FILO and DBIC, DBOC, DBIW, and DBOW are defined in such a way that the windows overlap, unexpected results may occur.

Details

IIIC transfers data from specified image channels (DBIC) in the input file (FILI) to image channels (DBOC) in the output file (FILO). Channel remapping is automatic.

IIIC is essentially the same as III, except that it can be used to read from and write to any GDB-supported file format.

The output image file (FILO) must already exist before running IIIC. If it does not, you must create it by running CIM. The output and input files may be the same file.

Any arbitrary rectangular window on the input file (DBIW) can be transferred to an arbitrary rectangular window on the output file (DBOW). Image data shrinking or zooming, or both, is automatic when the input window size does not match the output window size.

If an input channel is 32-bit real and the output channel is 16-bit integer or 8-bit (byte), or if the input channel is 16-bit integer and the output channel is 8-bit, data values may be truncated.

Example

Create a display-sized (512x512) split-screen image from four 256x256 image channels.

from pci.iiic import iiic

fili	=	"256x256 file name"
filo	=	"512x512 file name"
dbic	=	[1]	# input channel
dboc	=	[1]	# output channel
dbiw	=	[]	# process entire image
dbow	=	[0,0,256,256]	# upper-left quadrant of output image

iiic( fili, filo, dbic, dboc, dbiw, dbow )			# transfers the channel

dbic	=	[2]	# re-selects input channel
dbow	=	[256,0,256,256]	# upper-right quadrant of output image

iiic( fili, filo, dbic, dboc, dbiw, dbow )			# transfers the channel

dbic	=	[3]	# re-selects input channel
dbow	=	[0,256,256,256]	# lower-left quadrant of output image

iiic( fili, filo, dbic, dboc, dbiw, dbow )			#  transfers the channel

dbic	=	[4]	# re-selects input channel
dbow	=	[256,256,256,256]	# lower-right quadrant of output image

iiic( fili, filo, dbic, dboc, dbiw, dbow )			#  transfers the channel