Un PDF de fournisseur paraît parfait à l'écran, pourtant le validateur PDF/A le rejette d'une ligne : 00030 At least one font is not embedded. La visionneuse empruntait des polices à votre machine depuis le début. Ouvrez le descripteur de police dans le fichier et presque tout ce dont une police incorporée a besoin y est déjà, jusqu'à la largeur de fût et la boîte englobante ; ce qui manque, c'est une référence de flux portant le programme de police lui-même
La version par lot est familière à quiconque dirige un pipeline d'ingestion d'archives. Factures, contrats et formulaires scannés arrivent de fournisseurs et de prestataires, chaque poste du bâtiment les rend bien, et le validateur rejette fichier après fichier avec cette même ligne. Personne en amont ne régénérera quoi que ce soit. Le pipeline doit réparer ce qu'il reçoit, et c'est le travail que couvre cet article. Sa pièce compagne, l'article sur la détection des violations PDF/A et PDF/UA avec le rapport de précontrôle, dit quels fichiers sont cassés ; celui-ci traite la façon la plus fréquente dont ils cassent
Ce que l'erreur 00030 réclame réellement
L'ISO 19005-1 §6.3.4 exige que chaque police employée par un fichier conforme porte son programme de police dans ce fichier. Le raisonnement est de la pure logique d'archivage. Un document ouvert dans cinquante ans, sur une machine qui ne partage aucune police avec celle qui l'a produit, doit se rendre à l'identique, et une police non incorporée n'est qu'une instruction d'aller chercher quelque chose nommé Arial sur le système qui lit par hasard. Quels que soient les glyphes et métriques du substitut, voilà ce que le lecteur voit
L'habitude de ne pas incorporer remonte à la convention Standard 14. Le PDF des débuts promettait que chaque visionneuse livre Helvetica, Times, Courier, Symbol et ZapfDingbats, donc les générateurs ont appris à les référencer par nom sans rien incorporer. Bien des outils le font encore. Le PDF/A retire cette exemption, et losLab PDF Library for Delphi l'applique côté rédacteur : avec le mode PDF/A ou PDF/X actif, AddStandardFont renvoie 0 sans sélectionner de police, car la bibliothèque n'embarque pas les contours Standard 14 et n'écrira pas une référence qu'elle ne peut pas adosser à un programme. AddTrueTypeFont avec Embed=0 est promu en incorporation complète sous mode PDF/A, tandis que Embed=2 (sous-ensemble) passe inchangé puisqu'un sous-ensemble reste un programme incorporé
Cela couvre les fichiers que vous écrivez vous-même. Le fichier d'un fournisseur est plus dur, car ses dictionnaires de polices ont été écrits par le générateur de quelqu'un d'autre et vous n'avez aucun moyen de lui demander une seconde tentative. Pour ces fichiers, la bibliothèque fournit EmbedMissingFonts, qui répare un document chargé sur place en copiant chaque programme manquant depuis les polices installées vers le descripteur que le document porte déjà
Pourquoi une police non incorporée ne réclame-t-elle qu'une clé de plus ?
Un générateur qui écrit une police TrueType non incorporée produit quand même un FontDescriptor complet : FontName, FontBBox, Flags, Ascent, Descent, StemV, CapHeight. Ce qu'il laisse de côté, c'est le flux portant le programme de police, référencé depuis le descripteur comme /FontFile2 pour les contours TrueType ou /FontFile3 pour les polices CID à base CFF. Donc EmbedMissingFonts ajoute exactement cela. Il lit les octets du programme, les écrit comme un nouveau flux compressé Flate avec une entrée /Length1, et attache la référence au descripteur déjà en place
Nous pensons que cette approche sur place est le bon défaut pour les fichiers hérités, et la raison est le tableau Widths. Les positions du texte dans un flux de contenu PDF sont déjà fixées ; la visionneuse avance des largeurs que le générateur d'origine a notées. Reconstruire le dictionnaire de police depuis la police installée remplacerait ces largeurs par des largeurs fraîchement mesurées, et si la version installée de la fonte diffère ne serait-ce que légèrement de celle de l'auteur, vous avez changé le document que vous étiez censé préserver. Laisser le dictionnaire, l'encodage, les largeurs et chaque flux de contenu intacts signifie que les pages pointent toujours vers les mêmes noms de ressources avec les mêmes métriques
La marche couvre chaque dictionnaire Font du fichier, pas seulement ceux atteignables depuis les ressources de pages, donc les polices employées seulement dans des apparences d'annotations ou partagées entre pages sont ramassées aussi. Les polices composites Type0, le genre produit pour du texte CJK et la plupart des sorties Unicode modernes, sont traitées via leur CIDFont descendant. Toute la réparation est un appel sur un document chargé :
var
PDF: TPDFlib;
Repaired: Integer;
begin
PDF := TPDFlib.Create;
try
if PDF.LoadFromFile('supplier-invoice.pdf', '') <> 1 then
raise Exception.Create('Could not load PDF');
// Renvoie combien de polices ont gagné un programme. Les polices déjà
// incorporées restent tranquilles ; les polices sans correspondance installée
// sont sautées et simplement non comptées.
Repaired := PDF.EmbedMissingFonts;
Writeln(Format('%d font program(s) embedded', [Repaired]));
PDF.SaveToFile('supplier-invoice-repaired.pdf');
finally
PDF.Free;
end;
end;
Comment la recherche de polices installées apparie les noms
Les noms BaseFont dans les fichiers réels correspondent rarement au nom de famille que Windows connaît. EmbedMissingFonts normalise chaque nom avant la recherche :
- Un préfixe de sous-ensemble (six majuscules et un signe plus, comme dans
KQBWTE+Calibri) est ôté - Tout ce qui suit la première virgule ou le premier trait d'union est lu comme le style, donc
Arial,BoldItalicetArial-BoldMTdemandent tous deux une fonte grasse, etItalicouObliquedemande une fonte italique - Les suffixes
MTetPSterminaux sont abandonnés, doncArialMTse résout enArial - Quand la fonte vit dans une TrueType Collection (.ttc), les offsets de tables sont ajustés pour que le programme incorporé soit une fonte autonome valide
Le problème plus dur est que le mappeur de polices Windows ne dit jamais non. Demandez à GDI une famille non installée et il rend une fonte de substitution sans plainte ; demandez du gras sur une famille qui n'a qu'une fonte régulière et il épaissit les contours à l'écran. L'un ou l'autre résultat vous donnerait un programme de police parfaitement chargeable qui est la mauvaise police. La vérification confronte donc la fonte que GDI a réellement sélectionnée à la famille demandée, en ignorant espaces et casse, et confronte les bits gras et italique propres de la fonte au style demandé. Un écart sur l'un ou l'autre signifie que la police est sautée
C'est un marché délibéré. Une recherche plus permissive ferait monter le compte de réparations à chaque lot, et certaines de ces « réparations » incorporeraient Arial Regular sous une police que le document nomme Arial,Bold. L'ISO 19005-1 §6.3.6 exige que les largeurs du dictionnaire de police s'accordent avec le programme incorporé, donc un quasi-échec peut échanger l'erreur 00030 contre une erreur de cohérence des largeurs, et au pire elle passe la validation en se rendant légèrement autrement que voulu par l'auteur. Nous préférons signaler un saut qu'archiver une conjecture
La recherche lit les polices installées à travers le GDI Windows. Sur les builds Linux ou macOS le chemin système ne renvoie rien, et l'appel par fichier de la section suivante est la façon de fournir des programmes
Que se passe-t-il quand la police n'est pas installée ?
La valeur de retour vous le dit. Si EmbedMissingFonts rapporte moins de polices que vous n'en savez manquantes, la différence est des polices que la machine n'a pas, ou pas dans le bon style. Pour celles-là, EmbedFontProgramFromFile(FontName, FileName) attache un programme depuis un fichier .ttf ou .otf que vous fournissez, ce qui laisse un pipeline embarquer les fontes d'entreprise qu'il s'attend à rencontrer et y retomber exprès
Le motif qui marche le mieux en pratique est de deux passes. Lancez EmbedMissingFonts et sauvegardez, puis rechargez le résultat, énumérez ce qui reste non incorporé, et proposez chaque nom restant à votre propre dossier de polices. Le rechargement compte : le drapeau incorporé que GetFontIsEmbedded rapporte pour une police énumérée reflète le fichier tel qu'il était quand FindFonts a tourné, donc énumérer dans la même session que la réparation montrerait des réponses périmées
function FontFileFor(const BaseFont: string): string;
begin
// Votre propre aide (pas une partie de la bibliothèque) : mappe les noms
// de polices du document vers des fichiers de polices livrés avec l'application.
// Un résultat vide fait renvoyer 0 à EmbedFontProgramFromFile
// sans toucher au système de fichiers.
if Pos('CorporateSans', BaseFont) > 0 then
Result := ExtractFilePath(ParamStr(0)) + 'fonts\CorporateSans.ttf'
else
Result := '';
end;
procedure EmbedFromShippedFonts(const InFile, OutFile: string);
var
PDF: TPDFlib;
I, FontID: Integer;
Name: string;
begin
PDF := TPDFlib.Create;
try
if PDF.LoadFromFile(InFile, '') <> 1 then
Exit;
PDF.FindFonts;
for I := 1 to PDF.FontCount do
begin
FontID := PDF.GetFontID(I);
if (FontID > 0) and (PDF.SelectFont(FontID) = 1) and
(PDF.GetFontIsEmbedded = 0) then
begin
// Passez le nom exactement tel que stocké, préfixe de sous-ensemble compris
Name := PDF.FontName;
if PDF.EmbedFontProgramFromFile(Name, FontFileFor(Name)) = 0 then
Writeln('Still not embedded: ', Name);
end;
end;
PDF.SaveToFile(OutFile);
finally
PDF.Free;
end;
end;
Trois détails décident si cette boucle réussit. Les appels par nom, EmbedFontProgram pour la police installée et EmbedFontProgramFromFile pour un fichier, comparent au BaseFont exactement tel que le document le stocke et agissent sur le premier dictionnaire Font portant ce nom, voilà pourquoi la boucle passe PDF.FontName droit au lieu d'un nom de famille nettoyé. Le format du programme doit convenir au type de police : données TrueType de contours de glyphes pour une police TrueType ou CIDFontType2, un programme CFF OpenType (un qui démarre par le tag OTTO) pour une police CIDFontType0, qui est alors écrite en /FontFile3 avec le sous-type OpenType. Remettre un fichier CFF à une police TrueType et l'appel renvoie 0. Et le chemin de réparation couvre les polices TrueType et CID ; le /FontFile d'une police Type1 réclame la disposition PFB à trois segments avec des clés de longueur explicites, donc les références Type1 sont sautées et laissées au compte renvoyé pour les signaler. Les références Standard 14 sont en général écrites en Type1, donc attendez-vous à les voir dans cette liste résiduelle
Il y a aussi une question à laquelle la bibliothèque ne peut pas répondre pour vous. Les permissions d'incorporation d'une police TrueType appartiennent à sa fonderie, et un pipeline qui écrit des programmes sous licence dans des documents quittant l'organisation a besoin de quelqu'un pour confirmer que les licences le permettent. Le code incorporera n'importe quel fichier que vous lui pointez. Si vous en avez le droit est une question juridique
Boucler la boucle avec CreatePreflightReport
L'audit qui a rejeté le fichier devrait être celui qui le blanchit. CreatePreflightReport avec ComplianceTests = 1 lance les contrôles PDF/A, et le constat 00030 est rapporté une fois pour tout le fichier, donc une seule police oubliée le garde dans le rapport. Lancez-le sur la source, réparez et sauvegardez, puis relancez-le sur la sortie
function HasFontEmbeddingViolation(PDF: TPDFlib;
const FileName: string): Boolean;
var
Report: string;
begin
// ComplianceTests = 1 sélectionne les contrôles PDF/A
Report := PDF.CreatePreflightReport(FileName, '', 1, 0);
Result := Pos('00030', Report) > 0;
end;
Un résultat surprend les gens la première fois. Le contrôle de polices ignore les polices que le contenu ne dessine qu'invisiblement, en mode de rendu de texte 3, qui est la façon dont la plupart des moteurs OCR posent une couche de texte cherchable sur une image scannée. Un fichier scanné peut donc passer 00030 pendant que FindFonts liste encore une fonte non incorporée. C'est cohérent avec la façon dont le PDF/A traite le texte invisible, et cela veut dire qu'un listage par police et le verdict par fichier peuvent légitimement se contredire sur le même document
Pour des journaux de lot qui doivent nommer exactement quelle fonte de quel fichier est restée non incorporée, le listage par police est le meilleur outil : chargez la sortie, appelez FindFonts, puis SelectFont et GetFontIsEmbedded pour chaque entrée. L'article sur l'extraction de texte, d'images et de polices de PDF chargés emploie la même énumération pour alimenter l'extraction au lieu de la réparation
L'incorporation lève un constat, et votre propre sortie ne devrait jamais en avoir besoin
Incorporer des polices lève l'erreur 00030 et rien d'autre. Un fichier qui échoue aussi sur le chiffrement, des métadonnées XMP manquantes, un espace colorimétrique dépendant du périphérique sans OutputIntent, ou des polices sans tables ToUnicode échouera encore après que chaque programme est en place, donc la réparation appartient à la boucle de précontrôle et travaille à travers ce que le rapport nomme. La taille est l'autre coût. Un programme de police CJK complet peut courir sur plusieurs mégaoctets, et en incorporer quelques-uns peut faire d'une facture d'une page un multiple de sa taille d'origine ; l'article sur l'optimisation de la taille des PDF et le sous-ensemblage de polices couvre la réduction de chaque programme incorporé aux glyphes que les pages emploient réellement
Côté rédaction, SetEmbedAllFonts(1) empêche votre propre code de produire les fichiers que cet article répare. Il applique la même promotion que le mode PDF/A à un document ordinaire : tout appel AddTrueTypeFont ultérieur avec Embed=0 incorpore le programme complet. Le réglage appartient au document sélectionné et affecte les polices ajoutées après l'appel, donc réglez-le juste après NewDocument. Notre recommandation est de l'activer pour tout ce qui pourrait finir dans une archive, PDF/A ou non, car les fichiers que vous créez aujourd'hui sont les fichiers hérités de qui les lira plus tard
PDF.NewDocument;
PDF.SetEmbedAllFonts(1);
// À partir d'ici AddTrueTypeFont('Segoe UI', 0) incorpore le
// programme complet, exactement comme AddTrueTypeFont('Segoe UI', 1)
PDF.AddTrueTypeFont('Segoe UI', 0);
Le chemin chargement-réparation-sauvegarde, le repli par fichier et le garde côté rédaction voyagent tous dans losLab PDF Library pour Delphi, C# et VB.NET, avec le moteur de précontrôle employé ci-dessus pour confirmer le résultat ; la page produit documente le reste de l'API de polices, y compris l'inspection par police et le sous-ensemblage