IIIC

Description

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

Parameters

Name	Type	Caption	Length	Value range
FILI *	String	Input file name	1 - 192
FILO	String	Output file name	0 - 192
DBIC *	Integer	Input raster channel(s)	1 -
DBOC *	Integer	Output raster channel(s)	1 -
DBIW	Integer	Raster input window	0 - 4	Xoffset, Yoffset, Xsize, Ysize
DBOW	Integer	Raster output window	0 - 4	Xoffset, Yoffset, Xsize, Ysize
MONITOR	String	Monitor mode	0 - 3	ON, OFF Default: ON

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

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.

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.

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

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

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.

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

EASI>RUN IIIC			! transfers the channel

EASI>dbic	=	2	! re-selects input channel
EASI>dbow	=	256,0,256,256	! upper-right quadrant of output image

EASI>RUN IIIC			! transfers the channel

EASI>dbic	=	3	! re-selects input channel
EASI>dbow	=	0,256,256,256	! lower-left quadrant of output image

EASI>RUN IIIC			! transfers the channel

EASI>dbic	=	4	! re-selects input channel
EASI>dbow	=	256,256,256,256	! lower-right quadrant of output image
			
EASI>RUN IIIC			! transfers the channel