SetRenderBanding

Rendering

Description

Sets the band height for banded rendering so high-DPI and large-format pages render one horizontal band at a time, bounding peak memory instead of allocating one giant bitmap

When a positive band height is set and the page exceeds it, each page is rendered in vertical strips, composited into a full-size accumulator bitmap, and handed back as the output; anti-aliased edges that straddle a band boundary may differ by a level from a single-bitmap render

Syntax

Delphi

Function TPDFlib.SetRenderBanding(BandHeight: Integer): Integer;

DLL

int DLSetRenderBanding(int InstanceID, int BandHeight);

ActiveX

Function PDFlib::SetRenderBanding(BandHeight As Long) As Long

Parameters

BandHeight	The band height in device pixels; pass 0 to disable banding and use the single-bitmap path

Return values

1	The band height was applied

Remarks

Banding is off by default; the existing single-bitmap render path is unchanged until you opt in

Read the active setting with GetRenderBandHeight