VECWRIT -- Vector Write to Text File

Writes vector information held in a PCIDSK vector segment to a text file.

NOTE: FEXPORT is recommended for writing TYDAC SPANS, ARC/INFO GENERATE, and AutoCAD DXF format vectors.

VECWRIT remains the preferred method for writing Intergraph SIF format files.

See Also: FIMPORT, FEXPORT, VECREAD, VREAD, VWRITE, GAV

PARAMETERS

VECWRIT is controlled by the following global parameters:

Name     Prompt                                  Count     Type
FILE     Database File Name                      1-64      Char
DBVS     Database Vector Segment                 1         Int
FILV     Database Vector File Name               1-64      Char
VECFORM  Format: ISIF                            1-8       Char
ARCID    ARC/INFO ID: INCR/ATTR                  0-4       Char
ACADATTR AutoCAD Attributes: NUM/CHAR            0-4       Char
REPORT   Report Mode: TERM/OFF/filename          0-64      Char

FILE

Specifies the name of the PCIDSK file on which the vector segment (type VEC:116) exists.

 EASI>FILE="filename"

DBVS

Specifies the database vector segment to output to the text file.

 EASI>DBVS=i

FILV

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

 EASI>FILV="filename"

This is NOT a PCIDSK file.
The file should not exist before running VECWRIT.
For output in Intergraph SIF format, no file extension should be given (the .SIF extension will be added).

For TYDAC SPANS, ARC/INFO, and AutoCAD DXF files, please use the FEXPORT program instead.

VECFORM

Specifies the format for the output vector data.

 EASI>VECFORM="ISIF"          | for Intergraph SIF format

For compatibility with previous versions, VECWRIT will still accept the following settings, however it is recommended that you use FEXPORT for these formats, instead:

 EASI>VECFORM="SPANS"         | for SPANS VEH/VEC format
 EASI>VECFORM="ARC"           | for ARC/INFO GENERATE format
 EASI>VECFORM="ACAD"          | for AutoCAD DXF format

ARCID

This is retained for compatibility purposes with previous versions, only. It is not used with Intergraph SIF format files.

For AutoCAD DXF files, please use FEXPORT instead.

ACADATTR

This is retained for compatibility purposes with previous versions, only. It is not used with Intergraph SIF format files.

For AutoCAD DXF files, please use FEXPORT instead.

REPORT

This is retained for compatibility purposes with previous versions, only. It is not used with Intergraph SIF format files.

The following names have special meaning:

 EASI>REPORT="TERM"     | generates reports on your terminal
 EASI>REPORT="DISK"     | generates reports on file "IMPRPT.LST"
 EASI>REPORT="OFF"      | cancels report generation

DETAILS

VECWRIT is used to write vector (line) information held in a vector segment (type VEC:116) to a text file, in Intergraph SIF format.

When running VECWRIT, the vector information held in the vector segment (DBVS) on the PCIDSK database (FILE) is written to the text file (FILV) in the specified output format (VECFORM).

VECWRIT has the following limits for the maximum number of vertices for any one line structure on the following platforms.

 Windows,         No line structure with more than 32638 vertices
 Other platforms, No line structure with more than 65406 vertices

If a line is to be processed with more than the maximum, VECWRIT will exit (E018, "Insufficient global buffer space" for the "Structre" number that exceeds the limit). If this happens, you could split the line in two with the VED program and then rerun VECWRIT with the edited vector segment.

For "ISIF" output, FILV will be the file suffix to which the file extension .SIF will be added by VECWRIT.

VECWRIT outputs mainly vector coordinate information (that is, uncleaned arcs with no topology).

EXAMPLE

The 2nd segment in PCIDSK file GEOMETRY.PIX has the following data:

            (1,1)           (9,1)             (18,1)
              +---------------+                 +
              |               |     (13,3)     /
              |       x(5,3)  |       x       /
              |               |              /
              +---------------+             +
            (1,5)           (9,5)         (16,5)

  2:vtest     Type:116 [Vectors/Polygons] Last Update:18:59 9-MAR-91
  Contents: Test data for VECWRIT Example
  Length  :      0.5 Kbytes  Units: PIXEL      Structures:        4
  Bounds  : (     1.000X,      1.000Y), (     18.000X,      5.000Y)

Structure 1 Type:Line Vertices: 5 Group: 0 Attribute: 0

    1.000X          1.000Y                  9.000X           1.000Y
    9.000X          5.000Y                  1.000X           5.000Y
    1.000X          1.000Y

Structure 2 Type:Point Group: 0 Attribute: 1

    5.000X          3.000Y

Structure 3 Type:Point Group: 0 Attribute: 0

   13.000X          3.000Y

Structure 4 Type:Line Vertices: 2 Group: 0 Attribute: 2

   18.000X          1.000Y                 16.000X           5.000Y

Example: We can write this information to a text file ISIF.SIF in Intergraph SIF format, using the following commands:

 EASI>DELETE "ISIF.SIF"
 EASI>FILE = "GEOMETRY.PIX"
 EASI>DBVS = 2
 EASI>FILV = "ISIF"
 EASI>VECFORM = "ISIF"
 EASI>ARCID =              | Unnecessary, only used if VECFORM="ARC"
 EASI>ACADATTR =           | Unnecessary, only used if VECFORM="ACAD"
 EASI>REPORT =             | Unnecessary, only used if VECFORM="ACAD"
 EASI>RUN VECWRIT

Upon completion of VECWRIT, the file ISIF.SIF would contain the following:

 DID/NA=ISIF,DA=03/09/91,MO=2,RA=1024,1024,18432,5120,DU=2147483647,
     1,1024,MU,SU                                                   
 BST/                                                               
 LST/1024,1024,9216,1024,9216,5120,1024,5120,1024,1024              
 EST/                                                               
 TLC/CO=1,JU=5                                                      
 TXT/TH=100,TW=60,OR=5120,3072,1                                    
 TLC/CO=1,JU=5                                                      
 TXT/TH=100,TW=60,OR=13312,3072,0                                   
 ASC/2                                                              
 BST/                                                               
 LST/18432,1024,16384,5120                                          
 EST/

Records and associated fields produced for Intergraph SIF format:

ASC (ASsoCiation) record

    * output if the vector has a non-zero Attribute field

BST (Begin STring) record

    * output before each vector
    * if the vector has more than 101 vertices, it is output as
      more than one set of LST records

DID (Drawing IDentification) record

    * NA (NAme) field,  FILV is output
    * DA (DAte) field,  the date is output
    * MO (graphics MOde) field,  always "MO=2" (2 dimensional)
    * RA (RAnge) fields,  output as RA=X_min,Y_min,X_max,Y_max
    * DU (Design file working Units) fields
        1. maximum number of master units,  always "2147483647"
        2. number of subunits per master unit,   always "1"
        3. number positional units per subunit,  resolution
           associated with VECUNIT
        4. master units field description,  always "MU"
        5. subunits field description,      always "SU"

EST (End STring)

    * output after each vector set
    * if the vector has more than 101 vertices, it is output as
      more than one set of LST records

LST (Line STring) record,

    * vector coordinates output as integer values

TLC (Text Line Characteristics)

    * CO (character COunt),  number of characters for the following
      TXT string for a point: always "JU=5"
    * JU (JUstification),

TXT (TeXT for an area object),

    * point coordinates are output as TXT objects
    * TH (Text Height) field,  always "TH=100"
    * TW (Text Width) field,   always "TW=60"
    * OR (ORigin) field,  point coordinates as integer values
    * text, Attribute field as a text string

About PCI Help Gateway