BIT2PNT

Description

BIT2PNT creates a vector point layer from a bitmap segment.

Parameters

Name	Type	Caption	Length	Value range
FILI *	String	Input file name	1 - 192
DBIB *	Integer	Input bitmap segment	1 - 1
FILO *	String	Output file name	1 - 192
DBSD	String	Output segment description	0 - 64
FTYPE	String	Output file type	0 - 4	See Parameter Details. 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 GDB file that contains the bitmap segment to convert.

DBIB

Specifies the bitmap segment in the input file from which the vector point file is constructed.

FILO

Specifies the name of the GDB vector file that will contain the output points.

DBSD

Describes (in up to 64 characters) the contents or origins of the output data. If this parameter is not 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

BIT2PNT creates a vector point layer from an input bitmap segment. Bitmap locations set to 1 will be converted to a point vector.

The input bitmap (DBIB) is a segment number; the output segment description (DBSD) is used if specified; otherwise a default of "Point Layer" will be applied.

Example

Build a vector point layer based on the bitmap segment 11 in irvine.pix and save the result to oirvine.pix. The point layer's description of "Points from bitmap" is provided.

EASI>fili     = "irvine.pix"                    ! input bitmap file
EASI>dbib     = 11                              ! input bitmap layer
EASI>filo     = "oirvine.pix"                   ! output file to be created
EASI>dbsd     = "Points from bitmap"            ! output layer description
EASI>ftype    =                                 ! defaults to PIX
EASI>foptions =                                 ! output format options

EASI>RUN BIT2PNT