`pdfGetPtDataArray`

Read a /PtData (point-data, e.g. geospatial track/cloud

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);

Delphi

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)

wrappers/dotnet/LumasPdf.cs

[return: MarshalAs(UnmanagedType.Bool)]

Area

Core SDK