Dans PDFium Component, lire une annotation via TPdf.Annotation[] et réaffecter le record n'écrit rien de nouveau quand rien n'a changé : le getter ne rapporte qu'une apparence qu'il a réellement lue, donc une annotation qui ne porte que /N repart avec seulement /N. Le détail vaut d'être compris, car un côté lecture qui sure rapporte les apparences ajoute des entrées /R et /D vides au dictionnaire d'apparences /AP, les validateurs PDF/A rejettent ce dictionnaire, et le déclencheur habituel est une correction censée rendre un fichier plus conforme, pas moins
Qu'est-ce qui tourne mal quand on réécrit une annotation inchangée ?
La réponse courte : si le côté lecture sure rapporte, l'annotation gagne des flux d'apparence qu'elle n'avait jamais eus, et un fichier qui passait la validation PDF/A avant votre édition l'échoue après. Le scénario type se déroule ainsi. Une archive client arrive avec des annotations carré et texte sans le drapeau Print, PDF/A exige que chaque annotation s'imprime, donc vous bouclez sur les pages, ajoutez afPrint, et réaffectez chaque record. Rien dans ce code ne touche aux apparences. Le record de TPdf.Annotation[] est un TPdfAnnotation, et SetAnnotationData écrit chaque champ dont la sentinelle Has* est levée, exactement comme les paires HasContents / ContentsText sont censées fonctionner. Le piège, c'est un getter qui met HasAppearanceRollover et HasAppearanceDown à True avec des chaînes vides pour des modes qui n'existent pas ; le setter écrit alors docilement deux flux vides. Le getter de PDFium Component ne rapporte que ce qu'il a lu, donc la boucle ci-dessous ne réécrit que les apparences que la source avait :
procedure MarkAnnotationsPrintable(const FileName: string);
var
Pdf: TPdf;
PageNo, I: Integer;
A: TPdfAnnotation;
begin
Pdf := TPdf.Create(nil);
try
Pdf.FileName := FileName;
Pdf.Active := True;
for PageNo := 1 to Pdf.PageCount do
begin
Pdf.PageNumber := PageNo;
for I := 0 to Pdf.AnnotationCount - 1 do
begin
A := Pdf.Annotation[I];
if not (afPrint in A.Flags) then
begin
A.Flags := A.Flags + [afPrint] - [afHidden, afInvisible, afNoView];
// Le getter ne rapporte que les apparences qu'il a lues, donc une source
// avec seulement /AP/N est réécrite avec seulement /AP/N
Pdf.Annotation[I] := A;
end;
end;
end;
Pdf.SaveAs(ChangeFileExt(FileName, '.printable.pdf'));
finally
Pdf.Free;
end;
end;
ISO 32000-1 §12.5.5 définit le dictionnaire d'apparences avec trois entrées : /N pour l'apparence normale, /R pour le survol (rollover) et /D pour l'appui (down). /R et /D sont optionnels, et quand ils sont absents une visionneuse retombe sur /N. Un flux /R vide n'est pas absent, pourtant. C'est un flux valide qui ne peint rien, donc une visionneuse qui honore les apparences de survol montre un rectangle blanc dès que le pointeur passe sur l'annotation. PDF/A est plus strict encore : ISO 19005-1 (avec son erratum 2) et ISO 19005-2 / 19005-3 ne permettent que /N dans un dictionnaire d'apparences d'annotation. veraPDF signale un tel fichier sous la règle 6.5.3-4 pour PDF/A-1 et la règle 6.3.3-2 pour PDF/A-2 et PDF/A-3, et le TPdf.ValidatePdfA intégré le liste comme pvaiAnnotationApDictViolation. Une édition qui ajoute le drapeau Print pour satisfaire une clause de la norme peut en casser une autre
Pourquoi FPDFAnnot_GetAP renvoie-t-il 2 pour une apparence manquante ?
PDFium ne retourne jamais zéro depuis FPDFAnnot_GetAP, même quand le flux d'apparence demandé n'existe pas. La fonction suit le schéma PDFium habituel à deux appels : passer un tampon nil pour obtenir la taille requise en octets, allouer, puis rappeler pour copier le texte UTF-16LE. La taille inclut toujours le terminateur UTF-16, donc un flux manquant rapporte 2 octets, une chaîne vide plus son terminateur. Le garde évident, ByteLength >= SizeOf(FPDF_WCHAR), est un test que chaque appel passe, donc un getter construit dessus rapporte les trois drapeaux HasAppearance* à True pour toute annotation dotée d'une apparence quelconque. Un aller-retour par le record demande alors à FPDFAnnot_SetAP de stocker une chaîne vide pour chaque mode, et PDFium crée le flux pour la contenir. Aucune exception, aucun avertissement, et la page visible reste identique, voilà pourquoi cette erreur surgit dans un validateur PDF/A plutôt que dans une visionneuse
Comment PDFium Component décide qu'une apparence existe
ReadAppearance, le helper interne à GetPageAnnotation qui remplit AppearanceNormal, AppearanceRollover et AppearanceDown, ne traite un résultat comme du contenu que s'il porte au moins un caractère au-delà du terminateur. Le premier appel doit retourner plus de SizeOf(FPDF_WCHAR) octets et un compte d'octets pair, car une longueur impaire ne peut pas être de l'UTF-16. Le second appel, qui copie réellement le texte, est validé à nouveau : une longueur retournée de 2 ou moins, ou supérieure au tampon alloué, remet HasValue à False et laisse la chaîne vide. Côté écriture, SetAnnotationData n'appelle FPDFAnnot_SetAP que pour les modes dont le drapeau HasAppearance* est True, donc un record lu depuis une annotation qui n'a que /N ne réécrit que /N
Flux manquants et flux vides se ressemblent, donc le getter reste conservateur
L'API native ne sait pas distinguer un flux d'apparence manquant d'un flux existant mais vide, et PDFium Component ne prétend pas le contraire. Les deux cas retournent les mêmes 2 octets depuis FPDFAnnot_GetAP, donc les deux se relisent comme HasAppearanceRollover = False avec un AppearanceRollover vide. Cela a deux conséquences à concevoir dans votre design. D'abord, une sentinelle False signifie « aucun contenu lu, donc une réécriture laissera ce mode tranquille », pas « la clé /R est absente du dictionnaire ». Ensuite, le record ne peut pas détecter un flux vide déjà présent dans le fichier : un document qui porte déjà un flux vide, quel qu'en soit l'auteur, se relit proprement, et réaffecter le record ne le répare ni ne l'aggrave. Pour trouver ces fichiers, il faut un contrôle au niveau octet, et c'est le rôle de TPdf.ValidatePdfA et du flux de préflight et validation PDF/A avec PDFium Component
Comment effacer une apparence exprès ?
Vous levez la sentinelle explicitement et passez une chaîne vide ; le setter l'écrit. Interdire les chaînes vides dans SetAnnotationData serait une manière brutale d'éviter les flux égarés, mais cela casserait aussi les appelants qui effacent une apparence délibérément, le même contrat que suivent HasContents et HasAuthor pour le texte. Donc le getter porte la prudence, et le setter honore ce que l'appelant demande :
// Remplacez l'apparence de survol, puis effacez-la à nouveau
A := Pdf.Annotation[0];
A.HasAppearanceRollover := True;
A.AppearanceRollover := 'q Q';
Pdf.Annotation[0] := A;
A := Pdf.Annotation[0];
// A.HasAppearanceRollover est True et le texte fait l'aller-retour en 'q Q'
A.HasAppearanceRollover := True; // réaffirmez l'intention explicitement
A.AppearanceRollover := ''; // écrivez un flux vide exprès
Pdf.Annotation[0] := A;
A := Pdf.Annotation[0];
// Se relit comme HasAppearanceRollover = False avec une chaîne vide :
// un flux vide et un flux manquant sont indiscernables ici
Gardez en tête qu'un /R ou /D explicitement vidé compte toujours comme une clé en trop sous les règles PDF/A citées plus haut. Si la cible est un profil d'archivage, écrire un /N non vide et laisser les deux autres modes intacts est la seule forme qui valide. Tout flux de travail qui déplace des annotations entre documents, comme l'export et l'import XFDF avec PDFium Component, devrait suivre la même règle : copiez les modes que la source portait réellement et laissez les autres sentinelles à False
Un schéma lire-modifier-écrire qui reste compatible PDF/A
Laissez les sentinelles d'apparence exactement telles que le getter les a retournées, et validez le fichier sauvegardé avant de le livrer. Comme un flux vide périmé se relit comme absent, l'étape de vérification doit regarder le document sérialisé plutôt que le record, et elle est assez bon marché pour tourner après chaque lot :
uses
PDFium, FPdfPdfa; // FPdfPdfa déclare TPdfAValidationIssue
function AnnotationAppearancesAreClean(Pdf: TPdf): Boolean;
var
Report: TPdfAValidationResult;
begin
// Valide le document actuellement chargé dans Pdf, y compris les éditions
// faites via Pdf.Annotation[] depuis son ouverture
Report := Pdf.ValidatePdfA;
Result := not (pvaiAnnotationApDictViolation in Report.Issues);
end;
La même discipline vaut pour tout panneau qui recolore ou annote des pages pour revue, un flux de travail couvert dans construire un flux de revue d'annotations Delphi avec PDFium Component : l'enregistrement est un instantané de ce que le moteur a pu lire, et une sentinelle que vous n'avez pas levée vous-même doit voyager en retour inchangée. L'API d'annotation complète, le précontrôle PDF/A et le moteur PDFium natif voyagent ensemble dans PDFium Component pour Delphi, C++Builder et Lazarus