MIRROR

Description

Creates a mirror image of the input image channels, along the vertical or horizontal axis.

Parameters

Name	Type	Caption	Length	Value range
FILE *	String	Input file name	1 - 192
FILO	String	Output file name	0 - 192
DBIC *	Integer	Input raster channel(s)	1 -
DBOC	Integer	Output mirrored channel(s)	0 -
DBIW	Integer	Input window	0 - 4	Xoffset, Yoffset, Xsize, Ysize
AXIS	String	Mirror Axis	0 - 4	VERT | HORI Default: VERT
DBGC	Integer	Input GCP segment	0 - 1
FTYPE	String	Output file type	0 - 4
FOPTIONS	String	output file options	0 - 64

* Required parameter

Parameter descriptions

FILE

Specifies the name of the PCIDSK image file containing the channels to mirror.

FILO

Specifies the name of the output file to receive the mirrored image.

If FILO is not the same as FILE the FILO must not exist

A new filo will be created.

FILO can be the same as FILE.

DBIC

Specifies the input image channels to be mirrored.

At least one channel must be specified. Duplicates are not 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.

DBOC

Specifies the output raster channels to receive the mirrored image if FILO is defaulted or equal FILE.

If FILO is created then DBOC defaults or is ignored.

At least one channel must be specified. Duplicates are not allowed.

The output channel may be the same as the input channel; if so, existing data will be overwritten.

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

Optionally specifies the rectangular window (Xoffset, Yoffset, Xsize, Ysize) of image data to mirror. If this parameter is not specified, the entire image is processed 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.

AXIS

Optionally specifies the axis of rotation to use for mirroring.

DBGC

Optionally specifies the GCP2 segment to be mirrored.

If this parameter is specified, a new GCP2 segment will be created to hold the mirrored result.

FTYPE

Optionally specifies the output file format type, represented by a three- or four-letter code. The format type must be a GDB-recognized file type.

If FILO specifies an existing file, this parameter should not be set; MIRROR updates the existing file without changing its type.

The default value is PIX.

For a full list of GDB-recognized file types and their codes, see GDB file formats in the Technical Reference section of the CATALYST Professional online Help.

FOPTIONS

Optionally specifies the file creation options that are to be applied when creating the output file. These are specific to the file format; in each case, the default of no options is allowed. FOPTIONS can be used to specify the compression schemes, file format subtypes, and other information.

Different options are available for different file types (see the FTYPE parameter). For a full list of GDB-recognized file typ es and options, see GDB file formats in the Technical Reference section of the CATALYST Professional online Help.

Details

MIRROR creates a set of mirror images along the vertical or horizontal axis, given a specified window (DBIW) within a set of input channels (DBIC), and saves the mirrored result in new file FILO if specified or input file as the defined output channels (DBOC).

For rotation about the vertical axis, the gray-level values of the first and last input pixels on each line of image data are swapped, the second and second-last pixels on each line are swapped, and so on. For rotation about the horizontal axis, the gray-level values of the first and last input lines are swapped, the second and second-last lines are swapped, and so on.

MIRROR can be run on aircraft radar and MSS image data, to convert left-looking images to right-looking images, or to invert ascending radar data to descending order.

Examples

Create a mirror image along the vertical axis for 3 channels in the file 'irvine.pix'.

EASI>file	=	"irvine.pix"	! input file
EASI>filo    =       "irvine_mirror.tif"        ! create new output TIF file
EASI>dbic	=	1,2,3	! input channels
EASI>dboc	=		! new file dboc defaulted
EASI>dbiw	=	0,0,256,256	! mirror upper-left corner
EASI>axis	=	'VERT'	! mirror along vertical axis
EASI>dbgc	=
EASI>ftype   =  "TIF"        ! output to a TIFF
EASI>foptions =              ! output file options

EASI>RUN MIRROR

Create a mirror image along horizontal axis.

EASI>file	=	'irvine.pix'
EASI>filo	=	'irvine_mirror.tif'.
EASI>dbic	=       4
EASI>dboc	=
EASI>dbiw	=		! mirror entire image
EASI>axis	=	'HORI'	! mirror along horizontal axis
EASI>dbgc	=	27	! gcp segment to mirror
EASI>ftype   =       "TIF"   ! output to a TIFF
EASI>foptions =              ! output file options

EASI>RUN MIRROR