Integruj workflow PDFium VCL Component w aplikacjach Delphi i C++Builder albo workflow PDFium LCL Component w Lazarus/FPC, z komponentami źródłowymi do podglądu, renderowania, formularzy, drukowania, raportów preflight i walidacji zgodnej ze standardami.
Ten artykuł jest przeznaczony dla developers building document viewers that must feel responsive on large PDFs and high-DPI displays. Traktuje render cache and zoom performance jako produkcyjną inżynierię dokumentów, a nie pojedyncze wywołanie komponentu.
Praktyczne ryzyko polega na tym, że zooming can appear fast in a sample but stutter under large pages, thumbnails, annotations, continuous scrolling, or memory pressure. Dlatego przepływ wymaga spisanego kontraktu, obserwowalnej diagnostyki i realistycznych plików regresyjnych.
Decyzje architektoniczne
Define cache policy as viewer behavior. cache key fields such as page, zoom, rotation, DPI, color mode, and annotation state / memory budget, eviction strategy, thumbnail sharing, and prefetch distance
- cache key fields such as page, zoom, rotation, DPI, color mode, and annotation state
- memory budget, eviction strategy, thumbnail sharing, and prefetch distance
- progressive rendering behavior for fast preview versus final-quality output
- cancellation rules when users scroll, resize, search, or change zoom quickly
Przebieg implementacji
Measure the interaction path, not only render time. Poniższa kolejność zachowuje czytelność przepływu pracy dla zespołów Delphi i C++Builder.
- record render requests through one queue instead of direct control event handlers
- reuse cached bitmaps only when the key fully matches the visible state
- render low-latency placeholders before high-quality pages when appropriate
- cancel stale jobs and evict pages outside the viewport and prefetch window
- measure frame latency and memory during realistic scroll and zoom sequences
Dowody walidacji
Performance evidence users can feel. Zachowaj te pola wraz z wynikiem lub rekordem wsparcia.
- cache hit rate, render latency, queue depth, cancellation count, and memory peak
- viewport size, zoom level, DPI, page dimensions, and color-filter state
- time to first preview and time to final-quality render
- eviction and prefetch behavior during continuous scrolling
Caching is a user-experience feature
A render cache should balance page quality, memory budget, cancellation, invalidation, and perceived latency. The viewer needs to cancel stale work when the user scrolls or zooms rather than finishing irrelevant renders.
Profile ownership and versioning
A named, versioned profile is easier to review than options scattered across forms, scripts, and batch parameters. It also makes support reports readable when customers use older templates or policies.
- cache key fields such as page, zoom, rotation, DPI, color mode, and annotation state
- memory budget, eviction strategy, thumbnail sharing, and prefetch distance
- progressive rendering behavior for fast preview versus final-quality output
- cancellation rules when users scroll, resize, search, or change zoom quickly
- cache hit rate, render latency, queue depth, cancellation count, and memory peak
- viewport size, zoom level, DPI, page dimensions, and color-filter state
Notatki przeglądu inżynierskiego dla render cache and zoom performance
Użyj tych notatek przeglądu, aby upewnić się, że funkcja wyszła poza demonstrację i da się ją obronić podczas wydania, wsparcia i eskalacji klienta.
- Decyzja: cache key fields such as page, zoom, rotation, DPI, color mode, and annotation state. Punkt nacisku implementacji: reuse cached bitmaps only when the key fully matches the visible state. Dowody akceptacji: time to first preview and time to final-quality render. Wyzwalacz regresji: rendering thumbnails and pages through separate caches wastes memory
- Decyzja: memory budget, eviction strategy, thumbnail sharing, and prefetch distance. Punkt nacisku implementacji: render low-latency placeholders before high-quality pages when appropriate. Dowody akceptacji: eviction and prefetch behavior during continuous scrolling. Wyzwalacz regresji: large engineering drawings can exceed cache assumptions made for letters or invoices
- Decyzja: progressive rendering behavior for fast preview versus final-quality output. Punkt nacisku implementacji: cancel stale jobs and evict pages outside the viewport and prefetch window. Dowody akceptacji: cache hit rate, render latency, queue depth, cancellation count, and memory peak. Wyzwalacz regresji: annotation overlays invalidate cached pages when review state changes
- Decyzja: cancellation rules when users scroll, resize, search, or change zoom quickly. Punkt nacisku implementacji: measure frame latency and memory during realistic scroll and zoom sequences. Dowody akceptacji: viewport size, zoom level, DPI, page dimensions, and color-filter state. Wyzwalacz regresji: high-DPI displays multiply bitmap memory even when page count is small
- Decyzja: cache key fields such as page, zoom, rotation, DPI, color mode, and annotation state. Punkt nacisku implementacji: record render requests through one queue instead of direct control event handlers. Dowody akceptacji: time to first preview and time to final-quality render. Wyzwalacz regresji: rendering thumbnails and pages through separate caches wastes memory
- Decyzja: memory budget, eviction strategy, thumbnail sharing, and prefetch distance. Punkt nacisku implementacji: reuse cached bitmaps only when the key fully matches the visible state. Dowody akceptacji: eviction and prefetch behavior during continuous scrolling. Wyzwalacz regresji: large engineering drawings can exceed cache assumptions made for letters or invoices
- Decyzja: progressive rendering behavior for fast preview versus final-quality output. Punkt nacisku implementacji: render low-latency placeholders before high-quality pages when appropriate. Dowody akceptacji: cache hit rate, render latency, queue depth, cancellation count, and memory peak. Wyzwalacz regresji: annotation overlays invalidate cached pages when review state changes
Przypadki brzegowe
- large engineering drawings can exceed cache assumptions made for letters or invoices
- annotation overlays invalidate cached pages when review state changes
- high-DPI displays multiply bitmap memory even when page count is small
- rendering thumbnails and pages through separate caches wastes memory
Delphi / C++Builder notes
PDFium Component should sit behind a small service boundary that receives files, streams, profiles, and credentials, then returns output paths, warnings, metrics, and validation status. Important terms include render cache, zoom, DPI, progressive rendering, eviction, prefetch.
Przykład kodu Delphi
Poniższy szkic Delphi pokazuje praktyczną granicę usługi dla tego tematu. Kontrole zasad, logowanie i walidację trzymaj poza wąskim blokiem wywołań produktu, aby przepływ pozostał testowalny.
procedure TPreviewForm.RenderCachedPage(PageIndex: Integer; Zoom: Double);
var
CacheKey: string;
begin
CacheKey := Format('%d:%.2f', [PageIndex, Zoom]);
if not FRenderCache.TryGetValue(CacheKey, FPageBitmap) then
begin
FPageBitmap := PdfView.RenderPage(PageIndex, 0, Round(850 * Zoom), Round(1100 * Zoom), ro0, []);
FRenderCache.Add(CacheKey, FPageBitmap);
end;
PaintBitmap(FPageBitmap);
end;Lista produkcyjna
- Uruchom przepływ pracy na pustym pliku, zwykłym pliku klienta i pliku z najgorszego scenariusza
- Otwórz wygenerowany plik PDF w docelowej przeglądarce, walidatorze, drukarce lub aplikacji nadrzędnej
- Zaloguj wersję produktu, wersję profilu, hash wejścia, ścieżkę wyjścia, czas wykonania i liczbę ostrzeżeń
- Przechowuj hasła, certyfikaty, pliki tymczasowe i dane klienta zgodnie z jednoznacznymi zasadami retencji
- Dodaj dokument regresyjny, gdy plik klienta ujawni nowy przypadek brzegowy
Dokumentacja produktu
Dodatkowe przykłady kodu
procedure TViewerForm.RequestRender(TargetZoom: Single);
var
Status: TPdfProgressiveStatus;
begin
if FTokenSource <> nil then
FTokenSource.Cancel; // abandon the previous in-flight render
FTokenSource := TPdfCancellationTokenSource.New; // FPdfAsync unit
Status := Pdf.RenderPageProgressive(FBackBuffer, 0, 0,
FBackBuffer.Width, FBackBuffer.Height, FTokenSource.Token,
ro0, [reAnnotations]);
case Status of
prsDone: PresentBackBuffer;
prsCancelled: ; // superseded by a newer request: drop silently
prsFailed: ShowRenderFailure;
end;
end;