POLY2LINE

Description

POLY2LINE converts a polygon layer to a line layer.

Parameters

Name	Type	Caption	Length	Value range
FILI *	String	Input file name	1 - 192
DBVS *	Integer	Input polygon layer	1 - 1
FILO *	String	Output file name	1 - 192
DBSD	String	Output segment descriptor	0 - 64	Default:
FTYPE	String	Output file type	0 - 4	Default: PIX
FOPTIONS	String	Output file options	0 - 64
MONITOR	String	Monitor mode	0 - 3	ON, OFF Default: ON

* Required parameter

Parameter descriptions

FILI

Specifies the name of the file that contains the input vector segment to be processed.

DBVS

Specifies the input segment containing the polygon vectors from which the line layer will be created. The input vector layer can either be whole polygons or topological polygons.

FILO

Specifies the output file name.

DBSD

Specifies a descriptor for the output line segment. Descriptor may be up to 64 characters long. When nothing is specified a default description is generated.

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, FTYPE should not be specified since the existing file will be updated and its type won't be changed.

For a complete 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 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). The options are described in GDB file formats in the Technical Reference section of the CATALYST Professional online Help.

For PIX format, FOPTIONS defaults to BAND.

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

POLY2LINE creates a line layer from a polygon layer. All of the edges of the polygons are convereted to lines with all vertices being preserved.

Example

A line segment is built based on the polygon segment 31 in irvine.pix and is also saved to irvine.pix.

EASI>FILI     = "irvine.pix"    ! input polygon file
EASI>DBVS     = 31              ! polygon layer
EASI>FILO     = "irvine.pix"    ! output file
EASI>DBSD     =                 ! use default
EASI>FTYPE    =                 ! blank because output file exists
EASI>FOPTIONS =                 ! blank because output file exists

EASI>run poly2line