III

Description

Transfers image data between two image files or in 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
OPTIONS	String	Optional processing parameters	0 - 192
MONITOR	String	Monitor mode	0 - 3	ON, OFF Default: ON

* Required parameter

Parameter descriptions

FILI

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

FILO

Specifies the name of the PCIDSK file to receive image data. The output file can be the same as the input file. The output file must already exist before running III.

DBIC

Specifies the input channel(s) to 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.

OPTIONS

The following options are available.

• COPY_PYRAMIDS_OFF : III normally copies existing pyramids for each channel selected. This option turns off copying pyramids. Turning off copying pyramids speeds up processing.
• COPY_METADATA_OFF : III normally copies existing metadata for each channel selected. This option turns off copying metadata. Turning off copying the metadata is usefull when you want to populate the channel with metadata.
• COPY_REFERENCED_LUTS_OFF : III normally copies default associated/referenced LUT segments. This option turns off copying referenced LUT segments.
• COPY_REFERENCED_PCTS_OFF : III normally copies default associated/referenced PCT segments. This option turns off copying referenced PCT segments.

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

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

The output image file (FILO) must already exist before running III; otherwise, you must create it by running CIM. The output and input files can be the same file.

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

Use the MOSAIC function to transfer images in which resampling is desired or where the imagery must be copied based on the georeferencing relationship between the two files.

Example

Create a display-sized image (512x512) by placing a single 256x256 image in the upper-left quadrant, followed by a 256x256 image in the upper-right quadrant.

EASI>fili    =   "small.pix" ! small file used in composite
EASI>filo    =   "composit.pix"  ! larger file in which to perform composite
EASI>dbic    =   1   ! image channel 1
EASI>dboc    =   1   ! image output to channel 1 in composite
EASI>dbiw    =       ! use full image
EASI>dbow    =   0,0,256,256 ! position image at 0x0 and 256x256 for lower-right corner

EASI>RUN III         ! merge image

! note: any parameters that are not listed are already set above.

EASI>dbic    =   2   ! source channel 2
EASI>dboc    =   1   ! output channel 1 (existing data will be merged)
EASI>dbow    =   256,0,256,256   ! output to upper-right quadrant
EASI>options =   ""

EASI>RUN III         ! merge image