IMAGELN

Description

Creates a PCIDSK file header that allows indirect access to imagery in a non-PCIDSK file, given that the file's structure is known. This allows most programs to operate on imagery stored in non-PCIDSK files.

Parameters

Name	Type	Length	Value range
Non-PCIDSK File Name *	String	1 -
Output: Output linked channel(s)	Raster port	0 -
Pixels per Line *	Integer	1 - 1024
Number of Lines *	Integer	1 - 1024
Number of Bands	Integer	0 - 1024
Interleaving Mode	Text	0 - 1	0 | 1 | 2 Default: 0
Bytes of Header	Integer	0 - 1024
Datatype	String	2 - 1	8U | 16S | 16U | 32R Default: 8U
Byte Swap	String	0 - 1	YES | NO Default: NO

* Required parameter

Parameter descriptions

Non-PCIDSK File Name

Specifies the name of the input non-PCIDSK file.

Output: Output linked channel(s)

Specifies output linked channel(s).

Pixels per Line

Specifies the structure of the input non-PCIDSK file, specifically the number of pixels (width) per line of imagery. The default value is 512.

Number of Lines

Specifies the structure of the input non-PCIDSK file, specifically the number of lines (height) in the imagery. The default value is 512.

Number of Bands

Specifies the number of bands (channels) of imagery in the input file. The default value is 1.

Interleaving Mode

Specifies the interleaving mode for the input file.

Bytes of Header

Specifies the number of bytes of header information to skip before the first byte of imagery data. The default value is 0.

Datatype

Specifies the data type for the output image channel.

Byte Swap

Specifies whether 16-bit and 32-bit image data should be byte-swapped when read from the input file.

For 32-bit real data, the first and last bytes are swapped, as well as the second and third bytes. For 16-bit integer data (signed or unsigned) the first and second bytes are swapped.

Details

IMAGELN creates a PCIDSK image file header allowing indirect access to imagery on a non-PCIDSK file, given that the input file's structure is known.

Compressed files cannot be linked. This function allows other application to operate on imagery stored in non-PCIDSK files.

When IMAGELN is run, a PCIDSK file is created and links point to the input image file.

The PCIDSK file created by IMAGELN is FILE interleaved, similarly to PCIDSK files created by CIM (with DBLAYOUT="FILE") and LINK. This means that the actual image data is stored in a separate file (FILI). No additional copies of the imagery are created. The FILE-interleaved PCIDSK file created by IMAGELN contains a description of the data stored in the non-PCIDSK file, similar to the procedure used when running PCIADD2.

Only raw data files organized as band sequential, band interleaved by line, or band interleaved by pixel may be linked. Compressed imagery, or image data that are not 8-bit, 16-bit unsigned, 16-bit signed or 32-bit real cannot be linked.

The SWAPFL (Byte Swap) parameter specifies whether 16-bit and 32-bit image data should be byte-swapped when data is read from the file. For 32-bit real data, the first and last bytes are swapped, and the second and third bytes are swapped. For 16-bit integer data (signed or unsigned), the first and second bytes are swapped.

IMAGELN prints information regarding the imagery size and number of channels.