RenderPageProgressive methode

Annuleerbare variant van RenderPage die de progressieve rendering-lus van PDFium aanstuurt en tussen iteraties een IPdfCancellationToken pollt zodat lange hoge-DPI-renders midden in de pagina kunnen afbreken in plaats van te blokkeren tot voltooiing

Color = clNone of Color = clDefault selecteert een transparante achtergrond en een alpha-capabele PDFium-bitmap. Niet-gedekte pixels behouden alpha nul, onafhankelijk van de native paginabackground-transparantiequery, inclusief gedeeltelijk gerenderde resultaten die na annulering worden teruggegeven; clWhite blijft de standaard ondoorzichtige achtergrond

RenderPageProgressive rendert de huidige pagina naar de aangegeven Bitmap met behulp van de FPDF_RenderPageBitmap_Start + FPDF_RenderPage_Continue-lus van PDFium. Tussen iteraties pollt de IFSDK_PAUSE-callback van PDFium AToken.IsCancelled — wanneer de toepassing heeft geannuleerd, wikkelt de lus netjes af en houdt de bitmap het tot nu toe uitgevoerde gedeeltelijke werk vast.

Hetzelfde zero-copy snelle pad geïntroduceerd in v1.21.0 is van toepassing: PDFium rendert rechtstreeks naar de DIB-buffer van de bestemmings-TBitmap in plaats van via een interne buffer te stagen. Een legacy per-scanline-fallback bestaat voor het onwaarschijnlijke geval waarin de bestemmings-DIB niet kan worden gewikkeld.

De retourwaarde identificeert hoe de render eindigde:

• prsDone — de bitmap is volledig gerenderd. Equivalent aan een succesvolle synchrone RenderPage.
• prsCancelled — de aanroeper annuleerde midden in de lus. De bitmap houdt het gedeeltelijke resultaat tot aan de iteratie waar annulering werd gedetecteerd; behandel het als best-effort preview-inhoud.
• prsFailed — PDFium rapporteerde FPDF_RENDER_FAILED. De bitmap-status is ongedefinieerd.

Geef AToken = nil door om tot voltooiing te renderen zonder ooit te pauzeren. In dat geval pompt de functie nog steeds FPDF_RenderPage_Continue tot DONE maar retourneert nooit prsCancelled. Dit is nuttig wanneer de aanroeper de tussenliggende hertekenpunten van de progressieve lus wil (een aangepaste OnPaint die de in-uitvoering-bitmap spiegelt) maar geen annulering nodig heeft.

• De bitmap moet door de aanroeper zijn toegewezen en PixelFormat = pf32bit hebben opdat het zero-copy-pad wordt geactiveerd; andere pixelformaten worden vóór de render opgewaardeerd naar pf32bit.
• Width / Height zijn in pixels (de dimensies van de bestemmingsbitmap). De pagina wordt geschaald om in die dimensies te passen voordat de progressieve lus begint.
• RenderPageProgressive zelf is synchroon vanuit het perspectief van de aanroeper — het retourneert wanneer de render voltooit of annuleert. Om de main thread vrij te maken, drijft u RenderPageProgressive aan vanuit een worker-thread. TPdf serialiseert render-aanroepen per instantie; aanroepers moeten nog steeds vermijden het document te muteren of te ontladen terwijl een render in uitvoering is.
• Een EPdfError wordt opgegooid wanneer Bitmap nil is — het contract vereist een door aanroeper toegewezen bitmap omdat het zero-copy-pad een bekende DIB-lay-out nodig heeft.

RenderPage, RenderTile