pdfCreateIndexedColorSpace

int32_t __stdcall pdfCreateIndexedColorSpace(PPDF IPDF, int32_t Base, int32_t Handle, void* ColorTable, uint32_t NumColors);

function pdfCreateIndexedColorSpace(const IPDF: PPDF; Base, Handle: Integer; ColorTable: Pointer; NumColors: Cardinal): Integer; stdcall;

Purpose. Register a new Indexed color space over a palette of NumColors base-space colors.

Description. Base must be a device ordinal 0..2 (RGB/CMYK/Gray); anything else, including a registered non-device handle, fails — an Indexed space's base cannot itself be an ICC/CIE/DeviceN/Separation space through this entry point. Computes the expected per-color component count from Base (1 for Gray, 4 for CMYK, 3 otherwise) purely to size the byte copy; ColorTable must be non-null and NumColors > 0. CreateIndexedColorSpace copies NumColors * BaseComps bytes verbatim from ColorTable into the registered entry's Table field — there is no check that the caller's buffer is actually that large; a ColorTable shorter than NumColors * BaseComps bytes causes an out-of-bounds read during the Move. The Handle parameter is accepted but never read — same dropped- parameter pattern as pdfCreateDeviceNColorSpace; a fresh handle is always auto-allocated.

Parameters.

Return value. The new color-space handle on success; -1 if Base is invalid, ColorTable is null, NumColors is 0, or NumColors - 1 falls outside 0..255.

Remarks. Because the byte count isn't validated against the actual buffer size, callers must compute NumColors * BaseComps themselves exactly as this function does internally (Gray=1, CMYK=4, RGB=3 bytes/entry) to avoid reading past the end of ColorTable.

See also. pdfCreateICCBasedColorSpace.

C# (P/Invoke)

public static extern int pdfCreateIndexedColorSpace(IntPtr IPDF, int @Base, int Handle, IntPtr ColorTable, uint NumColors);