BOOL32 __stdcall pdfGetPtDataArray(IPTD PtData, uint32_t Index, const char* DataType, float* Values, uint32_t* ValCount);
BOOL32 __stdcall pdfGetPtDataObj(IPTD PtData, const char* Subtype, uint32_t* NumArrays);
function pdfGetPtDataArray(PtData: IPTD; Index: Cardinal; DataType: PAnsiChar; Values: PSingle; var ValCount: Cardinal): LongBool; stdcall;
function pdfGetPtDataObj(PtData: IPTD; Subtype: PAnsiChar; var NumArrays: Cardinal): LongBool; stdcall;
Purpose. Read a /PtData (point-data, e.g. geospatial track/cloud point arrays attached to a viewport's /Measure) object's summary (pdfGetPtDataObj: Subtype string + column count) and individual data columns (pdfGetPtDataArray: one named column's float values by index).
Description. Both are GAP-7 object-descriptor consumers, resolved through an IPTD handle minted wherever a viewport/measure object with attached point data is exposed elsewhere in the ABI (see pdfGetViewport, Named Destinations, Page Labels, Geospatial Measure, and Viewports). DataType/Subtype are output parameters in the Pascal binding despite their const char* C declaration (same pattern as pdfGetSeparationInfo's Colorant above) — DataType receives the column's own type-name string, not a caller-supplied filter.
Parameters.
| Parameter | Description |
|---|---|
PtData | An IPTD object handle. |
Index | *(Array only)* 0-based column index. |
DataType | *(Array only, output)* The column's data-type name. |
Values, ValCount | *(Array only)* Output: the column's float values. |
Subtype | *(Obj only, output)* The /PtData subtype string (e.g. "Cloud"). |
NumArrays | *(Obj only, output)* Number of data columns (readable individually via pdfGetPtDataArray). |
Return value. True if PtData resolves (and, for Array, Index is in range); False otherwise.
See also. pdfGetViewport.
C# (P/Invoke)
[return: MarshalAs(UnmanagedType.Bool)]
Getters
pdfGetPtDataObj
The …A form takes UTF-8, …W
takes UTF-16; a bare name aliases the ANSI form.
Worked examples — complete programs in ten languages.