FPdfContentNormalize - PDFium Delphi Component

Unit: FPdfContentNormalize

Tek bir mantıksal PDF sayfa içerik dizisinin söz dizimi koruyan normalizasyonu ve sağlam satır içi görüntü sınır algılaması

Syntax

const
  PdfContentNormalizeDefaultInputLimit = Int64(256) * 1024 * 1024;
  PdfContentNormalizeDefaultOutputLimit = Int64(256) * 1024 * 1024;
  PdfContentNormalizeDefaultTokenLimit = 10000000;

function NormalizePdfContentSequence(const Streams: array of TBytes;
  const Options: TPdfContentNormalizeOptions; out Output: TBytes;
  out Report: TPdfContentNormalizeReport): Boolean;

function CollectPdfContentResourceUses(const Data: TBytes;
  out Uses: TPdfContentResourceUses;
  out ErrorText: string): Boolean;

function FindInlineImageBlock(const Data: TBytes; StartPos: Integer;
  out BiPos, IdPos, DataStart, EndImageStart: Integer): Boolean;

Description

NormalizePdfContentSequence, sağlanan içerik akışlarını dizi sırasına göre birleştirir ve sonucu tek bir mantıksal sayfa içerik dizisi olarak belirteçlere ayırır

Belirteç ayrımını kanonikleştirirken sabit dizeleri, hex dizelerini, adları, dizileri, sözlükleri, satır içi görüntü yüklerini ve bilinmeyen işleçleri korur; yorumlar kaldırılabilir ve yapısal denge zorunlu tutulabilir

CollectPdfContentResourceUses, merkezî belirteç bütçesi altında metin, XObject, grafik durumu, renk uzayı, desen, shading, işaretli içerik özelliği ve satır içi görüntü işleçlerinin tükettiği kaynak adlarını kaydeder

FindInlineImageBlock, görüntü yükü verisinin içindeki bir EI bayt dizisini sonlandırıcı saymadan eksiksiz bir BI, ID ve EI bloğu bulur

Constants

Constant	Description
`PdfContentNormalizeDefaultInputLimit`	Sayfa başına 256 MiB varsayılan mantıksal girdi limiti
`PdfContentNormalizeDefaultOutputLimit`	Sayfa başına 256 MiB varsayılan normalize edilmiş çıktı limiti
`PdfContentNormalizeDefaultTokenLimit`	Sayfa başına 10000000 belirteç varsayılan limiti

Functions

Function	Description
`TPdfContentNormalizeOptions.Default`	Yorum kaldırmayı, denge doğrulamasını, yararlı Flate sıkıştırmayı ve güvenli olmayan sayfa atlamayı etkinleştirir; imzalı yeniden yazmalara izin vermez ve üç varsayılan limiti uygular
`NormalizePdfContentSequence`	Normalize edilmiş baytları ve ayrıntılı bir raporu döndürür; hata durumunda başarısızlık statüsü ve tanı metniyle `False` döndürür
`CollectPdfContentResourceUses`	Kaynak tüketen her içerik işleci için kaynak türünü ve çözülmüş PDF adını döndürür; bozuk ya da bütçe aşımı girdi için tanı metniyle `False` döndürür
`FindInlineImageBlock`	`StartPos` konumunda ya da sonrasında bulunan sonraki eksiksiz satır içi görüntü bloğu için uzaklıkları döndürür

Types

Type	Description
`TPdfContentNormalizeStatus`	Dizi ve belge normalizasyonu için sonuç ya da hata kategorisi
`TPdfContentNormalizeOptions`	Normalizasyon ilkesi ve sayfa başına bayt ile belirteç limitleri
`TPdfContentNormalizeReport`	Durum, bayt ve sayfa toplamları, akış ve belirteç metrikleri, söz dizimi gözlemleri ve tanı metni
`TPdfContentResourceKind`	Kaynak değerleri: `pcrkFont`, `pcrkXObject`, `pcrkExtGState`, `pcrkColorSpace`, `pcrkPattern`, `pcrkShading` ve `pcrkProperties`
`TPdfContentResourceUse`	Çözülmüş bir kaynak `Name` değeri ile birlikte `Kind` türü
`TPdfContentResourceUses`	İçerik sırasına göre toplanan kaynak kullanımlarının dinamik dizisi

Status values

Value	Meaning
`pcnsNotStarted`	Rapor başlatıldı ama normalizasyon tamamlanmadı
`pcnsCompleted`	Normalizasyon başarıyla tamamlandı
`pcnsInputLimitExceeded`	Mantıksal girdi `MaxInputBytesPerPage` değerini aştı ya da yapılandırılmış bir limit pozitif değildi
`pcnsOutputLimitExceeded`	Normalize edilmiş baytlar `MaxOutputBytesPerPage` değerini aşacaktı
`pcnsTokenLimitExceeded`	İçerik dizisi `MaxTokensPerPage` değerini aştı
`pcnsMalformedToken`	Bir PDF içerik belirteci eksiksiz okunamadı
`pcnsUnresolvedInlineImage`	Eksiksiz bir satır içi görüntü yükü sınırı bulunamadı
`pcnsUnbalancedState`	Zorunlu grafik, metin, işaretli içerik, uyumluluk, dizi ya da sözlük kapsamı dengesi sağlanamadı
`pcnsUnsupportedFilter`	Belge düzeyi normalizasyon, çözemediği bir içerik akışı filtresiyle karşılaştı
`pcnsEncryptedDocument`	Belge düzeyi normalizasyon, şifreli girdiyi reddetti
`pcnsSignedDocument`	Belge düzeyi normalizasyon, yetkilendirme olmadan imzalı girdiyi reddetti
`pcnsDocumentRewriteFailed`	Kapsayan PDF nesne grafiği yeniden yazması ya da doğrulaması başarısız oldu
`pcnsResourceBudgetExceeded`	Normalizasyon tamamlanmadan süreç geneli `TPdfParserResourceBudget` son tarihine ulaşıldı

Options

Field	Description
`RemoveComments`	Gerekli belirteç sınırlarını koruyarak PDF yorumlarını çıkarır
`RequireBalancedState`	Dengeli `q`/`Q`, `BT`/`ET`, işaretli içerik, uyumluluk, dizi ve sözlük kapsamları zorunlu kılar
`CompressOutput`	Sıkıştırma boyutu küçülttüğünde belge düzeyi sarmalayıcının normalize edilmiş bir sayfa akışını Flate ile sıkıştırmasına izin verir
`SkipUnsafePages`	Belge düzeyi normalizasyonun, güvenli olmayan ya da desteklenmeyen bir sonuç sonrasında belge yeniden yazmasından vazgeçmek yerine bir sayfayı değişmeden korumasına izin verir
`AllowSignedDocument`	İmzalı girdinin tamamen yeniden yazılmasını açıkça onaylar; bu, mevcut imza bayt aralıklarını geçersiz kılar
`MaxInputBytesPerPage`	Bir sayfa için sağlanan içerik akışlarında izin verilen en yüksek toplam bayt
`MaxOutputBytesPerPage`	Normalize edilmiş içerik dizisinde izin verilen en yüksek bayt
`MaxTokensPerPage`	Bir sayfa için incelenecek en yüksek belirteç sayısı

Report fields

Field	Description
`Status`	Güncel `TPdfContentNormalizeStatus` değeri
`SourceByteCount`	Toplam kaynak içerik baytı
`OutputByteCount`	Toplam normalize edilmiş ya da yeniden yazılmış çıktı baytı
`PageCount`	Belge düzeyi normalizasyonun incelediği sayfa sayısı
`NormalizedPageCount`	Başarıyla normalize edilmiş içerikle değiştirilen sayfa sayısı
`SkippedPageCount`	Atlama ilkesi altında değişmeden korunan güvenli olmayan sayfalar
`InputStreamCount`	Mantıksal sayfa dizilerine birleştirilen kaynak içerik akışı sayısı
`OutputStreamCount`	Üretilen normalize edilmiş içerik akışı sayısı
`CoalescedArrayCount`	Tek bir normalize edilmiş akışla değiştirilen çok akışlı `/Contents` dizisi sayısı
`TokenCount`	İşlenen belirteç sayısı
`CommentCount`	Karşılaşılan yorum sayısı; korunsun ya da kaldırılsın
`InlineImageCount`	Korunan eksiksiz satır içi görüntü bloğu sayısı
`UnknownOperatorCount`	Olduğu gibi korunan tanınmayan işleç sayısı
`ErrorMessage`	İlk hata için tanı metni

Inline-image offsets

BiPos, BI anahtar sözcüğünün bayt uzaklığıdır
IdPos, ID anahtar sözcüğünün bayt uzaklığıdır
DataStart, ID sonrasındaki tek zorunlu boşluktan sonraki ilk yük baytıdır
EndImageStart, sonlandıran EI anahtar sözcüğünün bayt uzaklığıdır ve dolayısıyla yükün bir bayt ötesidir
StartPos konumunda ya da sonrasında eksiksiz bir blok bulunamazsa işlev False döndürür

FPdfContentNormalize birimi