TPdfProgressiveDocument - PDFium Delphi Component

유닛: PDFium · 베이스 클래스: TPdf

스파스 바이트 가용성, 우선순위가 적용된 범위 스케줄링, 한도 있는 재시도, 취소, 문서·폼·페이지 게이트를 갖춘 네이티브 PDFium progressive 다운로드 세션입니다

Syntax

type TPdfProgressiveDocument = class(TPdf) ... end;

Methods

Method	Description
`Create`	문서 컴포넌트와 소유한 range-request 스케줄러를 만듭니다
`Destroy`	상속된 문서 리소스를 해제하기 전에 progressive 상태를 취소합니다
`BeginProgressiveLoad(AStream, AFileSize, AOwnsStream, AInitialAvailableByteCount)`	논리적 최종 크기와 현재 저장된 바이트를 분리해 둔 채 네이티브 가용성 공급자를 만듭니다
`CheckDocumentAvailability`	`pdaAvailable`, `pdaNotAvailable`, `pdaError`를 반환하고 PDFium이 요청한 병합된 바이트 범위를 돌려줍니다
`OpenProgressiveDocument`	linearized PDF는 `FPDFAvail_GetDocument`로, 완전히 수신된 non-linearized PDF는 `FPDF_LoadCustomDocument`로 엽니다
`CheckFormAvailability`	네이티브 폼 데이터를 사용할 수 있게 될 때까지 폼 채우기 초기화를 막습니다
`LoadAvailablePage`	폼 가용성이 최종 상태에 도달한 뒤 1 기반 페이지 하나를 게이트하고 로드합니다
`CancelProgressiveLoad`	페이지, 폼, 문서, 가용성 핸들, 콜백, 스트림 어댑터를 의존 순서대로 닫습니다

Properties and events

Member	Type	Description
`ProgressiveLoading`	Boolean	네이티브 가용성 세션이 살아 있는 동안 True
`LogicalFileSize`	UInt64	서버나 컨테이너가 제공하는 최종 콘텐츠 길이
`AvailableByteCount`	UInt64	스트림에서 이미 읽을 수 있는 연속 접두부의 단조 증가 길이
`Linearization`	TPdfLinearization	헤더 바이트가 충분해지면 나오는 네이티브 linearization 판정
`FirstAvailablePageNumber`	Integer	문서 핸들이 열린 뒤의 첫 1 기반 페이지
`OnDataAvailable`	TPdfDataAvailableEvent	스파스 또는 순서가 뒤섞인 범위 저장소를 위한 접두부 검사 재정의
`RangeRequests`	TPdfRangeRequestScheduler	모든 네이티브 문서, 폼, 페이지 다운로드 힌트로 채워지는 소유 스케줄러

Description

TPdfProgressiveDocument는 원격 또는 성장하는 스트림 로드 내내 PDFium이 다시 방문할 수 있는 네이티브 FPDF_AVAIL 핸들과 콜백 레코드를 소유합니다

서버 콘텐츠 길이와 초기 접두부로 시작하고, 해당 가용성 메서드를 호출하고, RangeRequests에서 작업을 꺼내고, 각 응답을 기반 랜덤 액세스 저장소에 쓰고, CompleteRequest를 호출하는 과정을 최종 가용성 상태가 반환될 때까지 반복합니다

연속 다운로드에서는 새 바이트를 쓴 뒤 AvailableByteCount를 앞당기고, 스파스 범위 캐시에서는 OnDataAvailable을 할당해 요청된 각 오프셋과 크기가 읽을 수 있는지 답합니다

스케줄러는 레거시 DownloadHints 출력으로 돌아오는 동일한 네이티브 힌트를 받아들이고, 접두부나 스파스 콜백으로 이미 알려진 범위를 제거하고, 인접한 꼬리를 승격시키지 않으면서 페이지에 중요한 바이트를 위해 겹치는 백그라운드 전송을 선점하고, 전송 작업을 MaxRequestSize에서 나눕니다

linearized PDF는 파일 전체가 도착하기 전에 문서 메타데이터와 첫 페이지를 열 수 있고, non-linearized PDF는 완전한 파일을 요구하며 자동으로 평소의 네이티브 커스텀 스트림 로더를 사용합니다

Example

var
  Hints: TPdfDownloadRanges;
  Request: TPdfRangeRequest;
  State: TPdfDataAvailability;
begin
  Progressive.BeginProgressiveLoad(CacheStream, ContentLength,
    False, InitialPrefixLength);
  repeat
    State := Progressive.CheckDocumentAvailability(Hints);
    while Progressive.RangeRequests.TryDequeue(Request) do
    begin
      FetchRangeIntoCache(Request.Offset, Request.Size);
      Progressive.RangeRequests.CompleteRequest(Request);
    end;
  until State <> pdaNotAvailable;
  if State = pdaAvailable then
    Progressive.OpenProgressiveDocument;
end;

Remarks

현재 PDFium FPDF_FILEACCESS ABI는 논리적 파일 크기를 4 GiB로 제한하며, 클래스는 더 큰 크기를 잘라내는 대신 예외를 발생시킵니다
네이티브 파싱 상태는 다운로드된 바이트가 계속 사용 가능하다고 가정하므로 AvailableByteCount는 줄어들 수 없습니다
XFA와 V8 지원이 필요할 수 있으면 BeginProgressiveLoad 전에 EnableV8Engine을 설정하세요
CancelProgressiveLoad나 소멸이 끝날 때까지 스트림과 모든 스파스 범위를 읽을 수 있게 유지하세요
CompleteRequest를 호출하기 전에 응답 바이트를 기반 저장소에 쓰세요. 완료 시 해당 범위가 PDFium에 즉시 보입니다
스케줄러는 자신의 상태를 직렬화하지만 공유되는 기반 TStream.Position을 안전하게 만들지는 않습니다. 위치 지정 I/O나 외부 스트림 락을 사용하세요
세션이 취소되거나, 더 높은 우선순위 힌트가 겹치거나, 외부 스파스 커버리지가 중복을 만들 때 활성 전송 연산을 중단하려면 RangeRequests.OnCancelRequest를 할당하세요
하나의 문서, 페이지, 폼, 가용성 핸들을 작업자 스레드끼리 공유하지 마세요

Related types

TPdfDataAvailability, TPdfDownloadRange, TPdfDownloadRanges, TPdfRangeRequest, TPdfRangeRequestPriority, TPdfRangeRequestStatistics, TPdfRangeRequestScheduler, TPdfDataAvailableEvent, TPdfLinearization, TPdfFormAvailability

TPdfProgressiveDocument 클래스