pipExportInsert - spatial_geostan - 2024.00

Spatial+ Reference for Windows, UNIX/Linux, z/OS

Product type
Software
Portfolio
Locate
Product family
GeoStan Geocoding Suite
Product
GeoStan Geocoding Suite > Spatial+
Version
2024.00
Language
English
Product name
Spatial+
Title
Spatial+ Reference for Windows, UNIX/Linux, z/OS
Copyright
2024
First publish date
1994
Last updated
2024-05-07
Published on
2024-05-07T22:16:04.316305

Writes an object that was not from a GSB file to a BNA, MIF/MID, SHP, or TAB file.

Syntax

intl pipExportInsert ( pipExporter exp_h, pstr objectID, pipObjectInfoStruct *pInfo, intl *points, intl *pointsPerPoly, intl nPolys );

Arguments

exp_h

The handle returned by pipExportInitBNA, pipExportInitMIF , pipExportInitShape, or pipExportInitTab for the current export process. Input.

objectID

The unique ID of the object to be exported (NULL means use the default ID generated by the BNA mapping program. Input.

*pInfo

This is a pointer to an instance of pipObjectInfoStruct. Input.

*points

The object coordinates to put into the output file. Input.

*pointsPerPoly

Number of points per polygon. Input.

nPolys

The number of polygons in this object. Input.

Return Value

PIP_OK

PIP_ERROR

Prerequisites

pipExportInitBNA, pipExportInitMIF, pipExportInitShape, or pipExportInitTab

Alternates

None.

Notes

The pipObjectInfoStruct structure contains the following information about an object:

char name[128] Primary name.
char name2[128] Secondary name.
intl type PIP_REGION, PIP_LINE, or PIP_POINT.
intl layer Layer code.
intl xCenter, yCenter Point location or label position.
intl xMin, yMin, xMax, yMax MBR, not used for points.
intl penStyle, penWidth, penColor Line style, border style, or symbol style for points.
intl brushStyle, brushColor, brushBackgroundColor Fill style, used only for regions.

For a complete description of each of the items in the structure, please refer to pipImportInsert.

The supported structure of an ESRI BNA file is detailed in ESRI BNA Format , and the MapInfo MIF/MID format is discussed in MapInfo® MIF/MID Format.

Warning: Be sure to use the pipExporter handle and not the Spatial+ pipHandle type.

You must read points into the *points, *pointsPerPoly, and nPolys variables. There is no function provided to do this for non-GSB files.

You must call pipExportInsert for each object you want in the output file.