Allows the user to store additional metadata in the GSB file.
Syntax
intl pipImportInitEx ( pipHandle h_pip, pstr outputFileName,
pipObjectFileInfoStruct *pInfo, intl datum, pstr source, pstr
version, pipImporter *importer_handle );
Arguments
h_pip
The handle returned by pipInitEx for the current instance of Spatial+ Input.
outputFileName
The path and filename of the Spatial+ object file to create from the imported file. Input.
*pInfo
Structure containing initialization information. Input.
datum
Datum of the user data; either DATUM_NAD27 (1) or DATUM_NAD83 (2). Input.
source
User-defined source of this data. Input.
version
User-defined version of this data. Input.
*importer_handle
The import handle returned by the function. This handle should be used by all other import functions. Output.
Return Value
PIP_OK
PIP_ERROR
Prerequisites
pipInit
Alternates
pipImportInit
Notes
This function sets up the Spatial+ library to import one or more BNA, MIF/MID, SHP, or TAB files. (See ESRI BNA Format and MapInfo® MIF/MID Format in this manual for complete descriptions of these file formats.)
The pipImportInitEx function creates and opens a GSB file, initializes the import subsystem, and allows the user to store additional meta data in the GSB file.
The *pInfo structure contains the necessary information to initialize the import of objects to an object file. The structure is as follows:
| char userData[256] | Data set by user |
| intl maxHeapSize | Size of largest object (without buffer information.) |
| intl maxPointCount | Number of points in largest object. |
| intl maxPolygonCount | Max number of polygons in any one object. |
| intl xmin, ymin, xmax, ymax | Geographic extents of the file. |
| intl coordSys | PIP_COORDS_USER or PIP_COORDS_LL |
| intl flags | PIP_IMPORT_BUFFERS, PIP_IMPORT_COMPRESS, etc. |
| intl reserved[8] | Reserved for future use. |
Coordinate type and distance must be maintained for all subsequent calls using this data.
Spatial+ has the ability to assign buffers on the fly to polygons, lines and points. However, doing so requires generating extra information when importing a file. This information makes the resulting file larger than if buffers were not used.
This function returns a pipImporter handle via a pointer. This handle should be used instead of pipHandle for all other pipImport_ functions.