RenderPagesParallel - TPdf - PDFium Delphi Component

Komponentas: TPdf · Modulis: PDFium

Atvaizduoja kelis puslapių kreipinius lygiagrečiai, kai kiekvienas darbininkas valdo izoliuotą PDFium dokumentą ir puslapio rankeną

Syntax

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

Description

RenderPagesParallel dabartinį dokumentą vieną kartą užfiksuoja į TPdfRandomAccessStore, pašalina momentinės kopijos šifravimą ir šaltinį laiko nepakitusiu, kol uždaromi visi darbininkų dokumentai

Atmintyje esantis fiksavimas dalijamas tiesiogiai be antro baitų masyvo kopijavimo, perpiltas fiksavimas atveriamas per vieną tik skaitymui skirtą failo atvaizdą, o atvaizdo nepavykus, grįžtama prie FPDF_LoadCustomDocument blokų skaitymų iš tos pačios gijų saugios saugyklos

Kiekvienas darbininkas įkelia privatų aktyviosios PDFium dvejetainės kopijos laikinąjį egzempliorių kaip nepriklausomą modulį, inicializuoja tą modulį savo darbinėje gijoje ir naudoja savąjį FPDF_DOCUMENT, kol įkelia ir uždaro priskirtus puslapius

Modulio, dokumento, puslapio, prieauginio atvaizdavimo ir taškinės grafikos būsenos niekada neperžengia darbininkų ribų, taip išvengiant nesaugių lygiagrečių kreipinių į vieną PDFium modulį

PageNumbers naudoja viešąją puslapių, skaičiuojamų nuo vieneto, konvenciją, o grąžintas Results masyvas visada atitinka kreipinių tvarką, net kai darbininkai baigia ne iš eilės arba atskiras puslapias nesėkmingas

Kiekvienas sėkmingas rezultatas valdo iš viršaus į apačią orientuotą 32 bitų pikselių buferį su Stride = Width * 4, naudodamas BGRA baitų tvarką, nebent reReverseByteOrder pageidauja RGBA

Options

Field	Default	Meaning
`Dpi`	96	Pageidaujama raiška nuo didesnės už 0 iki 2400 DPI
`MaxWorkers`	0	0 pasirenka iki keturių darbininkų, kitaip 1–64, ribojama kreipinių skaičiaus
`MaxPixelsPerPage`	64 MiPixels	Atmeta puslapį prieš atskiriant per didelį rezultatų buferį
`MaxTotalOutputBytes`	512 MiB	Apriboja išsaugotų sėkmingų pikselių buferių sumą
`Rotation`	`ro0`	Taiko tą patį sukimą kiekvienam kreipiniui ir, esant 90 arba 270 laipsnių, apsuka išvesties matmenis
`RenderOptions`	`[]`	Natyvios PDFium atvaizdavimo vėliavėlės, įskaitant anotacijas, pilkus atspalvius, spausdinimą, glotninimą ir atvirkštinę baitų tvarką
`BackgroundColor`	`clWhite`	Pradinis pikselių fonas, kol PDFium piešia puslapio turinį

Results

pprsSucceeded grąžina matmenis, eigos žingsnį, pikselių formatą, pikselius ir praėjusį laiką
pprsCancelled negrąžina pikselių, kai atšaukimas pastebėtas prieš prieauginio atvaizdavimo ciklą arba jo metu
pprsFailed izoliuoja netinkamą puslapį, natyvų įkėlimo ar atvaizdavimo nesėkmę arba išteklių biudžeto atmetimą ErrorMessage
Ataskaita apibendrina darbininkų skaičių, galutinių būsenų skaičius, išsaugotus išvesties baitus TotalOutputBytes ir visapusiškai praėjusį laiką
SourceSize, SourcePeakMemoryBytes ir SourceStorageBackend atskleidžia apriboto fiksavimo kainą
SourceBackingKind yra ppsbSharedMemory, ppsbMemoryMappedFile arba ppsbRandomAccessStore po šaltinio fiksavimo

Remarks

Kreipėjui metodas sinchroninis ir grįžta, kai sustojo visi darbininkai
Proceso laikinasis katalogas turi būti rašomas ir turi leisti įkelti DLL; kiekviena privati modulio kopija iškraunama ir ištrinama, kai jos darbininkas baigia
Atšaukimo žetonas apklausiamas tarp PDFium prieauginio atvaizdavimo gabalų ir tarp puslapių paskirimų
reInvert ir reNightDuotone yra atvaizdavimo po taškinės grafikos transformacijos ir ši žaliavo buferio API jų nepriima
SaveMemoryLimit ir SaveTemporaryDirectory valdo užfiksuotąjį šaltinį, o išvesties biudžetas apima išsaugotus rezultatų buferius, ne PDFium vidines alokacijas
Palaikomas statinis puslapio turinys ir natyvus anotacijų atvaizdavimas, o interaktyvios formos perdangos ir dinaminė XFA puslapių generacija nepriklauso šio metodo sričiai
Nekaitalinkite, neiškraukite ir neįrašykite to paties TPdf egzemplioriaus lygiagrečiai, kol fiksujamas pradinis momentinis vaizdas
Atlasinkite išvesties atmintį, išvalę ataskaitą arba atskirus Pixels masyvus juos suvartojus

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 metodas