pdfGetColorSpaceObjEx

BOOL32 __stdcall pdfGetColorSpaceObj(PPDF IPDF, uint32_t Handle, TPDFColorSpaceObj* CS);
BOOL32 __stdcall pdfGetColorSpaceObjEx(void* IColorSpace, TPDFColorSpaceObj* CS);

function pdfGetColorSpaceObj(const IPDF: PPDF; Handle: Cardinal; var CS: TPDFColorSpaceObj): LongBool; stdcall;
function pdfGetColorSpaceObjEx(const IColorSpace: Pointer; var CS: TPDFColorSpaceObj): LongBool; stdcall;

Purpose. Read a full color-space descriptor by registered handle (pdfGetColorSpaceObj) or by a previously-minted object handle (pdfGetColorSpaceObjEx).

Description. pdfGetColorSpaceObj looks up Handle via GetColorSpaceInfo (color-space type, alternate space, component count) and fills CS.ColorSpaceType, CS.Alternate, and CS.Handle. It additionally mints (GAP-7 pattern, matching the object-descriptor mechanism used elsewhere in the SDK for lazily-exposed sub-objects) two or three fresh object handles into the output struct: CS.IColorSpaceObj (this space's own descriptor, Sub=0), CS.IAlternate (its alternate/base device space, Sub=1), and — only when the color space's type is DeviceN (ct = 10, esDeviceN) — CS.IAttributes (the DeviceN process-color attributes, readable separately via pdfGetDeviceNAttributes). pdfGetColorSpaceObjEx is the read-back half: given one of those minted IColorSpaceObj/ IAlternate handles, it resolves the originating descriptor and re-fills CS — Sub=0 re-describes the space itself, Sub=1 describes its alternate. Passing an IColorSpace handle that wasn't minted by pdfGetColorSpaceObj (or one already released) fails.

Parameters.

Return value. True if the handle resolved and CS was filled; False otherwise (unknown handle, IPDF invalid, or CS is a null pointer for Obj).

Remarks. IAttributes is populated only for DeviceN spaces; for every other color-space kind it is left as 0/unset in the output struct.

See also. pdfGetColorSpaceCount.

C# (P/Invoke)

[return: MarshalAs(UnmanagedType.Bool)]