pdfSetExtGStatePrepress
Configure the prepress-related fields (/TR transfer, /BG
| Category | Extended graphics state (prepress) |
|---|
Purpose — Configure the prepress-related fields (/TR transfer, /BG black-generation, /UCR undercolor-removal, /HT halftone) on an already-created ExtGState resource.
Description — resource-level configuration, not an immediate operator. Unlike pdfSetExtGState, this call does not write anything to the content stream — it mutates the stored ExtGState resource identified by Handle (must already exist via pdfCreateExtGState), which only takes effect on the page once pdfSetExtGState(Handle) is called to apply that resource. Each *Kind parameter follows the same 3-way convention: 0=unset (omit the key), 1=Identity, 2=Default. For a fully custom (not Identity/Default) transfer or black-generation function, see the separate pdfSetTransferFunction/pdfSetBlackGenFunction (install a real sampled /TR2//BG2 function — not part of this chapter).
Declarations
BOOL32 __stdcall pdfSetExtGStatePrepress(PPDF IPDF, int32_t Handle, int32_t TransferKind, int32_t BGKind, int32_t UCRKind, int32_t HTKind);
function pdfSetExtGStatePrepress(const IPDF: PPDF; Handle, TransferKind, BGKind, UCRKind, HTKind: Integer): LongBool; stdcall; external 'LumasPdf.dll';
Parameters
| Parameter | Type | Description |
|---|---|---|
IPDF | PPDF | Instance handle. |
Handle | Integer | An existing ExtGState resource handle from pdfCreateExtGState. |
TransferKind | Integer | /TR: 0=unset, 1=Identity, 2=Default. |
BGKind | Integer | /BG: same 3-way convention. |
UCRKind | Integer | /UCR: same 3-way convention. |
HTKind | Integer | /HT: same 3-way convention. |
Return value — TRUE if Handle resolves to an existing ExtGState resource; FALSE otherwise.
See also — pdfSetExtGState, pdfSetTransferFunction, pdfSetBlackGenFunction
C# (P/Invoke)
[return: MarshalAs(UnmanagedType.Bool)]
Setters
pdfSetExtGStatePrepress
The …A form takes UTF-8, …W
takes UTF-16; a bare name aliases the ANSI form.
Worked examples — complete programs in ten languages.