SetDeterministicDocumentID

Właściwości dokumentów, optymalizacja

Opis

Włącza lub wyłącza odtwarzalne identyfikatory plików w trailerze, wyprowadzane z jawnego ziarna albo znormalizowanej zserializowanej treści

Składnia

Delphi

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

Parametry

Enable	Podaj `1`, aby wyprowadzać identyfikator pliku w trailerze z jawnego ziarna albo znormalizowanej treści dokumentu, albo `0`, aby przywrócić domyślny identyfikator wywodzony z czasu

Wartości zwracane

0	Nieprawidłowa wartość parametru
1	Ustawienie zostało pomyślnie zastosowane

Uwagi

Po włączeniu następny pełny zapis nieszyfrowanego dokumentu wyprowadza /ID traileru z ziarna przekazanego przez SetDocumentIDSeed. Bez jawnego ziarna zapisywca przepuszcza zserializowany nagłówek i treść dokumentu przez SHA-256, normalizuje generowane identyfikatory zasobów i identyfikatory UUID instancji XMP oraz używa pierwszych 16 bajtów skrótu dla obu wpisów początkowej tablicy /ID. Dane odwołań krzyżowych, przesunięcia trailerów i wszelkie poprzednie /ID traileru są wykluczone, więc zmiany stron, zasobów, załączników i metadanych wpływają na identyfikator, a przesunięcia układu nieIdentyfikator jest odświeżany tylko przy pełnych zapisach. Aktualizacje przyrostowe nigdy nie przepisują identyfikatora trwałego, a zaszyfrowane dokumenty zachowują swój istniejący identyfikator, ponieważ pierwszy wpis

/ID uczestniczy w wyprowadzaniu klucza szyfrowania. Automatyczne daty i inne ulotne metadane użytkownika pozostają treścią; ustaw je jawnie, gdy dwa niezależnie wygenerowane dokumenty mają otrzymać ten sam identyfikator wywodzony z treści

Przykład

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

Zobacz również

GetDeterministicDocumentID, SetDocumentIDSeed, GetDocumentFileID