SetDeterministicDocumentID

Vlastnosti dokumentu, optimalizace

Popis

Povolí nebo zakáže reprodukovatelné identifikátory souborů v traileru odvozené z explicitního semínka nebo normalizovaného serializovaného obsahu

Syntaxe

Delphi

Function TPDFlib.SetDeterministicDocumentID(Enable: Integer): Integer;

Parametry

Enable	Předejte `1` k odvození identifikátoru souboru v traileru z explicitního semínka nebo normalizovaného obsahu dokumentu, nebo `0` k obnovení výchozího identifikátoru odvozeného z času

Návratové hodnoty

0	Neplatná hodnota parametru
1	Nastavení úspěšně uplatněno

Poznámky

Je-li povoleno, další úplné nešifrované uložení odvodí /ID traileru ze semínka dodaného přes SetDocumentIDSeed. Bez explicitního semínka propustí writer serializovanou hlavičku a tělo dokumentu přes SHA-256, normalizuje generované identifikátory prostředků a UUID instancí XMP a použije prvních 16 bajtů otisku pro obě položky počátečního pole /ID. Křížové odkazy, posuny traileru i případné předchozí /ID traileru se vylučují, takže změny stránek, prostředků, příloh a metadat identifikátor ovlivní, zatímco posuny rozložení nikoliIdentifikátor se obnovuje jen při úplných uloženích. Přírůstkové aktualizace trvalý identifikátor nikdy nepřepíší a šifrované dokumenty si ponechávají stávající identifikátor, protože první položka

/ID se účastní odvození šifrovacího klíče. Automatická data a další nestálá uživatelská metadata zůstávají součástí obsahu; nastavte je explicitně, když mají dva nezávisle generované dokumenty dostat stejný identifikátor odvozený z obsahu

Příklad

PDF.SetDeterministicDocumentID(1);
PDF.SetDocumentIDSeed('invoice-2026-07-0001');
PDF.DrawText(100, 100, 'Reproducible output');
PDF.SaveToFile('invoice.pdf'); // same seed, same trailer ID

Viz také

GetDeterministicDocumentID, SetDocumentIDSeed, GetDocumentFileID