IMAGENEG

Description

Multiplies by -1 the raster information in the input file, thereby producing an arithmetic negation of the raster data.

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)	0 -
MONITOR	String	Monitor mode	0 - 3	ON, OFF Default: ON

* Required parameter

Parameter descriptions

FILI

Specifies the name of the PCIDSK file that contains the raster channels to process.

FILO

Specifies the name of the PCIDSK image file to receive the output channel. If the output file is not specified, it is assumed to be the same as the input file (FILI). If FILO exists, its projection must be the same as FILI.

If the specified output file does not already exist, a new PCIDSK file will be created. By default, the georeferencing information from FILI will be copied to the new FILO.

DBIC

Specifies the input image channels to be processed.

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 image channels produced by the negation of the input image channels (DBIC).

If FILO is an existing file, this parameter must be specified, and the channel type must be CHN_32R.

The number of output channels must be the same as the number of input channels.

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.

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

IMAGENEG takes all the pixel values from the input channel(s) and multiplies them by -1, placing the resulting values in the specified output channel(s).

Example

This example demonstrates the use of IMAGENEG.

EASI>fili	=	"irvine.pix"	! input file
EASI>filo	=	"output.pix"	! output file (will be created)
EASI>dbic	=	1, -5	! input channels
EASI>dboc	=	1, -5

EASI>RUN IMAGENEG