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.
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.