API referenceRendering & Viewer

pdfSetRenderDCOffset

Nominally: choose which internal renderer implementation

C
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);
Delphi
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.

ParameterDescription
IPDFDocument handle.
RendererIDStored but never consumed — there is only one real renderer selection (IRAS-present vs. fallback, decided per-call inside pdfRenderPage), not a settable mode.
NewErasePageStored but never consumed.
NewOffsetX, NewOffsetYStored 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)

wrappers/dotnet/LumasPdf.cs
public static extern int pdfSetRenderDCOffset(IntPtr IPDF, int NewOffsetX, int NewOffsetY);
Area
Rendering & Viewer
Category

Setters

Exported names

pdfSetRenderDCOffset

String variants

The …A form takes UTF-8, …W takes UTF-16; a bare name aliases the ANSI form.

See working code

Worked examples — complete programs in ten languages.