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

iia(fili, filo, dbsl, dbos)

Name	Type	Caption	Length	Value range
FILI *	str	Input file name	1 -
FILO	str	Output file name	0 -
DBSL *	List[int]	Input segment(s)	1 -
DBOS	List[int]	Output segment(s)	0 -

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

DBOS

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

DBOS can be the same as DBSL.

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

from pci.iia import iia

fili	=	'irvine.pix'	# input file
filo	=	'luts.pix'	# output file
dbsl	=	[1,-6]	# input segments to transfer
dbos	=	[1]	# overwrite existing segment 1

iia( fili, filo, dbsl, dbos )

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