API referenceRendering & Viewer

rasAppend

Append a page slot to the cache's tracked page count.

C
BOOL32 __stdcall rasAppend(IPGC CachePtr);
Delphi
function rasAppend(CachePtr: IPGC): LongBool; stdcall;

Purpose. Append a page slot to the cache's tracked page count.

Description. Minimal but genuinely real, per an inline comment ("Minimal but real: it resolves the cache and advances the appended-page counter (the tile renderer materialises page rasters lazily on demand)."): increments C.AppendedPages. There is no eager rendering or page-content creation here — the actual new page must already exist in the underlying document (e.g. via the document-level page-creation APIs); this call only updates the cache's own bookkeeping counter, which downstream tile/paint logic consults to know a new page slot exists.

Parameters.

ParameterDescription
CachePtrTarget page cache.

Return value. True if CachePtr resolves; the NotImplLogB failure path otherwise (despite the function being real once a valid cache is supplied — the failure path is purely for the invalid-handle case).

C# (P/Invoke)

wrappers/dotnet/LumasPdf.cs
[return: MarshalAs(UnmanagedType.Bool)]
Area
Rendering & Viewer
Category

Rasterizer/Rendering

Exported names

rasAppend

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.