API reference › Rendering & Viewer
pdfSelectedRenderer
Nominally: choose which internal renderer implementation
int32_t __stdcall pdfSelectRenderer(PPDF IPDF, int32_t RendererID);
int32_t __stdcall pdfSelectedRenderer(PPDF IPDF);
int32_t __stdcall pdfSetRenderDCErasePage(PPDF IPDF, int32_t NewErasePage);
int32_t __stdcall pdfSetRenderDCOffset(PPDF IPDF, int32_t NewOffsetX, int32_t NewOffsetY);
double __stdcall pdfGetRenderScale(PPDF IPDF);
function pdfSelectRenderer(const IPDF: PPDF; RendererID: Integer): Integer; stdcall;
function pdfSelectedRenderer(const IPDF: PPDF): Integer; stdcall;
function pdfSetRenderDCErasePage(const IPDF: PPDF; NewErasePage: Integer): Integer; stdcall;
function pdfSetRenderDCOffset(const IPDF: PPDF; NewOffsetX, NewOffsetY: Integer): Integer; stdcall;
function pdfGetRenderScale(const IPDF: PPDF): Double; stdcall;
Purpose. Nominally: choose which internal renderer implementation to use, toggle whether the render-to-DC path erases the page background first, offset the DC render target, and report the current render scale factor.
Description — inactive state, all five functions. Each setter writes to a plain per-document field (SelRenderer/RenderDCErase/ RenderDCOffX/RenderDCOffY), and none of these four fields is ever read anywhere else in the codebase — not by pdfRenderPage/ pdfRenderPageEx, not by pdfRenderPageToImage, not by pdfRenderPDFFile, not by the ras* rasterizer engine. They are pure storage with a getter but no consumer. pdfGetRenderScale reads RenderScale, which is initialized once to 1.0 at document construction and never written by any exported setter in this SDK's 129-function V15 surface (no pdfSetRenderScale exists) — so pdfGetRenderScale is, in practice, a disguised constant that always returns 1.0.
Parameters.
| Parameter | Description |
|---|---|
IPDF | Document handle. |
RendererID | Stored but never consumed — there is only one real renderer selection (IRAS-present vs. fallback, decided per-call inside pdfRenderPage), not a settable mode. |
NewErasePage | Stored but never consumed. |
NewOffsetX, NewOffsetY | Stored but never consumed. |
Return value. pdfSelectRenderer/pdfSetRenderDCErasePage/ pdfSetRenderDCOffset: 1 if IPDF resolves, 0 otherwise (the write itself always "succeeds" regardless of effect). pdfSelectedRenderer: the last-stored RendererID (echo only). pdfGetRenderScale: always 1.0 in practice.
C# (P/Invoke)
public static extern int pdfSelectedRenderer(IntPtr IPDF);
Core
pdfSelectedRenderer
The …A form takes UTF-8, …W
takes UTF-16; a bare name aliases the ANSI form.
Worked examples — complete programs in ten languages.