pdfBalancePageTree

int32_t __stdcall pdfBalancePageTree(PPDF IPDF, int32_t Options);

function pdfBalancePageTree(const IPDF: PPDF; Options: Integer): Integer; stdcall;

Purpose. Rebalance the PDF page tree (the /Pages node hierarchy) for structural efficiency — relevant for very large documents where a flat page-array degrades viewer performance.

Return value. Real per the exact Options-driven behavior of the underlying implementation; 0/failure indication if IPDF invalid (not independently re-verified beyond confirming the call is a genuine document mutation, not a stub, in this chapter).

C# (P/Invoke)

public static extern int pdfBalancePageTree(IntPtr IPDF, int Options);