SetDeterministicDocumentID
Propriedades do documento, Otimização
Descrição
Ativa ou desativa identificadores de arquivo de trailer reprodutíveis derivados de uma semente explícita ou de conteúdo serializado normalizado
Sintaxe
Delphi
Function TPDFlib.SetDeterministicDocumentID(Enable: Integer): Integer;Parâmetros
| Enable | Passe 1 para derivar o identificador de arquivo do trailer de uma semente explícita ou do conteúdo normalizado do documento, ou 0 para restaurar o identificador padrão derivado do tempo. |
|---|
Valores de retorno
| 0 | Valor de parâmetro inválido. |
|---|---|
| 1 | Configuração aplicada com sucesso. |
Observações
Quando ativado, o próximo salvamento completo não criptografado deriva o /ID do trailer da semente fornecida com SetDocumentIDSeed. Sem uma semente explícita, o gravador passa o cabeçalho serializado e o corpo do documento por SHA-256, normaliza os identificadores de recursos gerados e os UUIDs de instância XMP, e usa os primeiros 16 bytes do digest para ambas as entradas do array /ID inicial. Dados de referências cruzadas, offsets do trailer e qualquer /ID de trailer anterior são excluídos, de modo que alterações de página, recurso, anexo e metadados afetam o identificador, enquanto offsets de layout nãoO identificador é atualizado apenas em salvamentos completos. Atualizações incrementais nunca reescrevem o identificador permanente, e documentos criptografados mantêm seu identificador existente porque a primeira entrada de
/ID participa da derivação da chave de criptografia. Datas automáticas e outros metadados voláteis do usuário permanecem conteúdo; defina-os explicitamente quando dois documentos gerados independentemente precisarem receber o mesmo identificador derivado do conteúdo
Exemplo
PDF.SetDeterministicDocumentID(1);
PDF.SetDocumentIDSeed('invoice-2026-07-0001');
PDF.DrawText(100, 100, 'Reproducible output');
PDF.SaveToFile('invoice.pdf'); // same seed, same trailer IDConsulte também
GetDeterministicDocumentID, SetDocumentIDSeed, GetDocumentFileID