RenderPagesParallel - TPdf - PDFium Delphi Component

Component: TPdf · Unit: PDFium

Izriše več zahtevkov strani sočasno, pri čemer je vsak delavec lastnik izoliranega dokumenta PDFium in handle-a strani

Syntax

function RenderPagesParallel(
  const PageNumbers : array of Integer;
  const Options : TPdfParallelRenderOptions;
  const CancellationToken: IPdfCancellationToken = nil): TPdfParallelRenderReport;

Description

RenderPagesParallel enkrat zajame trenutni dokument v TPdfRandomAccessStore, odstrani šifriranje posnetka in vir pusti nespremenljivega, dokler se ne zapre vsak delavski dokument

Zajem v pomnilniku se deli neposredno, brez druge kopije bajtnega polja, preliti zajem je izpostavljen prek ene preslikave datoteke, ki je samo za branje, ob napaki preslikave pa se pot razveje nazaj na blokovska branja FPDF_LoadCustomDocument iz iste varne-za-niti shrambe

Vsak delavec naloži zasebno začasno kopijo dejavne binarne datoteke PDFium kot neodvisen modul, ta modul inicializira na svoji delovni niti in ponovno uporablja svoj FPDF_DOCUMENT, medtem ko nalaga in zapira dodeljene strani

Stanje modula, dokumenta, strani, postopnega izrisa in bitne slike nikoli ne prečka meja delavcev, s čimer se izogiba nevarnim sočasnim klicem v en modul PDFium

PageNumbers uporablja javno konvencijo strani, številčenih od 1, vrnjeno polje Results pa se vedno ujema z vrstnim redom zahtevka, tudi ko delavci končajo v drugačnem vrstnem redu ali posamična stran spodleti

Vsak uspešen rezultat poseduje slikovni medpomnilnik 32-bit s spustom od zgoraj navzdol in Stride = Width * 4, z bajtnim vrstnim redom BGRA, razen kadar reReverseByteOrder zahteva RGBA

Options

Field	Default	Meaning
`Dpi`	96	Ciljna ločljivost od več kot 0 do 2400 DPI
`MaxWorkers`	0	0 izbere do štiri delavce, sicer 1 do 64, omejeno s številom zahtevkov
`MaxPixelsPerPage`	64 MiPixels	Zavrne stran, preden dodeli prevelik rezultatni medpomnilnik
`MaxTotalOutputBytes`	512 MiB	Omeji vsoto zadržanih uspešnih slikovnih medpomnilnikov
`Rotation`	`ro0`	Uveljavi isti zasuk na vsak zahtevek in zamenja izhodne mere pri 90 ali 270 stopinjah
`RenderOptions`	`[]`	Izvorne zastavice izrisa PDFium, vključno s pripombami, sivino, tiskanjem, glajenjem in obratnim bajtnim vrstnim redom
`BackgroundColor`	`clWhite`	Začetno ozadje pikslov, preden PDFium nariše vsebino strani

Results

pprsSucceeded vrne mere, korak, obliko pikslov, piksle in porabljen čas
pprsCancelled ne vrne pikslov, ko se preklic opazi pred ali med zanko postopnega izrisa
pprsFailed izolira neveljavno stran, izvorno napako nalaganja ali izrisa ali zavrnitev zaradi proračuna virov v ErrorMessage
Poročilo zbira število delavcev, števce končnih stanj, zadržane izhodne bajte v TotalOutputBytes in porabljeni čas od začetka do konca
SourceSize, SourcePeakMemoryBytes in SourceStorageBackend izpostavijo omejeno ceno zajema vira
SourceBackingKind je po zajemu vira ppsbSharedMemory, ppsbMemoryMappedFile ali ppsbRandomAccessStore

Remarks

Metoda je za klicatelja sinhrona in se vrne, ko so se vsi delavci ustavili
Začasna mapa procesa mora biti zapisljiva in mora dovoljevati nalaganje DLL; vsaka zasebna kopija modula se razloži in izbriše, ko njen delavec konča
Žeton za preklic se preverja med kosi postopnega izrisa PDFium in med dodeljevanji strani
reInvert in reNightDuotone sta transformaciji bitne slike po izrisu in ju ta API surovih medpomnilnikov zavrača
SaveMemoryLimit in SaveTemporaryDirectory upravljata zajet vir, izhodni proračun pa pokriva zadržane rezultatne medpomnilnike in ne notranjih dodelitev PDFium
Statična vsebina strani in izvorno izrisovanje pripomb sta podprta, medtem ko interaktivne obrazne prekrivne plasti in dinamično ustvarjanje strani XFA nista v obsegu te metode
Med zajemanjem začetnega posnetka istega primerka TPdf sočasno ne spreminjajte, ne razložite in ne shranjujte
Izhodni pomnilnik sprostite tako, da po porabi počistite poročilo ali posamična polja Pixels

Example

uses FPdfAsync;

var
  Options: TPdfParallelRenderOptions;
  Report: TPdfParallelRenderReport;
  I: Integer;
begin
  Options := TPdfParallelRenderOptions.Default;
  Options.Dpi := 150;
  Options.MaxWorkers := 4;
  Options.RenderOptions := [reAnnotations];

  Report := Pdf1.RenderPagesParallel([1, 3, 5, 7], Options, CancelToken);
  for I := 0 to High(Report.Results) do
    if Report.Results[I].Status = pprsSucceeded then
      ConsumeTopDownPixels(Report.Results[I]);
end;

RenderPagesParallel metoda