VWRITE

Description

Writes vector (line and point) data from an existing PCIDSK database vector layer to a new text file.

Parameters

Name	Type	Length	Value range
Input Vector Layer:  *	Vector port	1 - 1
Vector File Name *	String	1 -
Deg/Min/Sec Format	String	0 - 1	ON | OFF Default: OFF
Field Name	String	0 - 1	Default: Attribute

* Required parameter

Parameter descriptions

Input Vector Layer:

Specifies the input vector segment (type VEC:116) to be written to the text file.

Vector File Name

Specifies the name of the text file to be created to receive the written vector information.

This is NOT a PCIDSK file. The specified output file must not exist before running VWRITE.

Deg/Min/Sec Format

Specifies whether LONG/LAT coordinates should be output using real numbers or degrees/minutes/seconds/hemisphere strings.

This parameter is ignored if vector units are not LONG/LAT.

Field Name

Specifies the field name that contains an attribute value to be written for each shape.

If this parameter is specified as ZCOORD, the actual z-coordinates of the vectors are used. Field names are not case-sensitive, and they do not need to be specified in complete form. If more than one match exists, the first name is used.

Details

VWRITE writes vector (line and/or point) information from a vector segment (type VEC:116) to a text file. The use of an intermediate file to hold vector information allows vector data from a PCIDSK file to be edited.

When running VWRITE, the vector information held in the vector segment (DBVS) of the PCIDSK file (FILE) is written to the specified text file (FILV) in the output format specified below.

 Structure Type     Attribute Value 
 X-Coordinate      Y-Coordinate
 X-Coordinate      Y-Coordinate
 ...

Fields are separated by a comma or space.

If vector units are LONG/LAT, DMSFORM specifies the format for the longitude and latitude coordinates.

Each vector may contain more than one attribute field. The FLDNME parameter is used to specify which attribute field to use.