Creates and opens a set of Shape files for writing; initializes the export subsystem.
Syntax
intl pipExportInitShape ( pipHandle h, pstr outputFileName,
pipExporter *exp_h, int _type );
Arguments
h
The handle returned by pipInit for the current instance of Spatial+. Input.
outputFileName
The name of one of three Shape files. This parameter may either be the complete path, filename, and extension of one of the Shape files, or the path and base filename of all the Shape files. In either case, all three Shape files will be generated. Input
*exp_h
The export handle returned by the function. This handle should be used by all other pipExport_ functions. Output.
_type
The type of object to write to the file. Only one object type may be written to a file (the enums may not be ORed together). Input.
Valid enums are:
- PIP_POINT
- PIP_LINE
- PIP_REGION
Return Value
PIP_OK
PIP_ERROR
Prerequisites
pipInit
Alternates
pipExportInitBNA, pipExportInitMIF, or pipExportInitTab
Notes
You must call pipExportInitShape before pipExportInsert or pipExportOpen.
This function creates and opens a set of three Shape files (DBF, SHP, and SHX files), which hold exported standalone objects or exported objects from GSB (Spatial+ object) files.
This function returns a pipExporter handle via a pointer. This handle should be used instead of pipHandle as input for the other pipExport_ functions (pipExportInitBNA, pipExportInitMIF, and pipExportInitTab excepted).
Example
See pipExportInitMIF