IIA

Description

Transfers the specified segments from the input file to new or existing segments in the output file. IIA can transfer georeferencing data (in segment 1) from the input file to the output file.

Parameters

Name	Type	Caption	Length	Value range
FILI *	String	Input file name	1 - 192
FILO	String	Output file name	0 - 192
DBSL *	Integer	Input segment(s)	1 -
DBOS	Integer	Output segment(s)	0 -
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 GDB-supported file from which the segment data is to be read.

FILO

Specifies the name of the GDB-supported file to receive the transferred segment data. The output file can be the same as the input file. The specified output file must exist before running IIA.

DBSL

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

At least one segment must be specified. Duplicate segments 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.

DBOS

Specifies the output segments to be written to the output file.

DBOS can be the same as DBSL.

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.

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

IIA transfers a specified set of segments (DBSL) from the input file (FILI) to new or existing segments (DBOS) in the output file (FILO).

IIA can transfer bitmap segments only if both the input and output files have the same image size. In general, IIB should be used to transfer bitmap segments.

All segment data are copied from the input segments to the output segments. When a new segment is created, a message appears on the terminal providing the segment number of the newly created segment. This new segment number is also the return value for the function.

Example

This example show how to transfer georeferencing segment (number 1) and five lookup table segments (numbers 2 to 6) from 'irvine.pix' to a new file, named 'luts.pix'.

EASI>fili	=	'irvine.pix'	! input file
EASI>filo	=	'luts.pix'	! output file
EASI>dbsl	=	1,-6	! input segments to transfer
EASI>dbos	=	1	! overwrite existing segment 1

EASI>RUN IIA

The pixel size in the output file is updated, based on the georeferencing segment copied to it.