VBUFFER

Description

Burns an input vector segment into an existing raster channel and generates a new raster channel.

Parameters

Name	Type	Caption	Length	Value range
FILI *	String	Input file name	1 - 192
DBIC *	Integer	Input raster channel	1 - 1
FILV	String	Input vector file name	0 - 192
DBVS *	Integer	Input vector segment	1 - 1
FILO	String	Output file name	0 - 192
DBOC	Integer	Output raster channel	0 - 1
BUFDIST	Float	Buffer Width (m)	0 - 1	0 - Default: 0.001
BURNVAL	Float	Buffer encoding image value	0 - 1	0 - Default: 255.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 original raster image channel.

DBIC

Specifies the input channel onto which the vector will be burned.

FILV

Specifies the name of the GDB-format file that contains the vector segment. If this parameter is not specified, it is assumed that the vector segment is located in FILI.

DBVS

Specifies the vector segment to burn to the raster channel.

FILO

Specifies the name of the PCIDSK image file to receive the modified raster channel.

If the output file is not specified, it is assumed to be the same as FILI. If FILO is specified and already exists, its projection must be the same as FILI.

If FILO is specified but does not already exist, a new PCIDSK file is created. By default, the projection information from FILI is copied to the new FILO.

DBOC

Specifies the output channel to receive the generated output.

If the output file already exists, this parameter must be specified.

BUFDIST

Specifies the width of the buffer, in meters. The default value is 0.001.

BURNVAL

Specifies the value of the buffer encoding image. The default value is 255.0

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

VBUFFER burns a vector segment onto a raster channel, using a raster value specified by the BURNVAL (Buffer Encoding Image Value) parameter and a buffer width defined in meters by the BUFDIST (Buffer Width) parameter.

If the specified output file does not exist, a new output file is created. If an existing output file is specified, that file will be updated. If the output file is not specified, the results are written to the input file.

Example

This example demonstrates the use of VBUFFER in generating a raster channel from an input raster channel and vector segment.

EASI>fili	=	"irvine.pix"	! input file
EASI>dbic	=	1	! input raster channel
EASI>filv	=		! same as input file
EASI>dbvs	=	25	! input vector segment
EASI>filo	=	"output.pix"	! output file name
EASI>dboc	=	1	! output raster channel
EASI>bufdist	=	0.005	! buffer width
EASI>burnval	=	250.0	! buffer encoding image value 

EASI>RUN VBUFFER