Matterhorn 31-013 · PDF/UA-1 UA1:7.21.4.2-2
CharSet lists glyphs the embedded Type 1 font lacks
CharSet promises glyphs the font does not contain.
The condition, as the protocol states it. “The FontDescriptor dictionary of an embedded Type 1 font contains a CharSet string, but at least one of the glyphs listed in the CharSet string is not present in the font program.”
Matterhorn Protocol 1.1, checkpoint 31, index 31-013, section UA1:7.21.4.2-2. Software can decide this one on its own.
What a screen reader actually does
Processors may mis-handle the subset.
What the condition is
A Type 1 font’s descriptor may carry /CharSet: a string of glyph names listing what the embedded subset contains. PDF/UA-1 lets a file leave it out, but if it is there it has to match the program exactly. Condition 31-012 is a list that leaves a glyph out. This one is a list that names a glyph the program does not have.
The file Taggart’s test suite uses for this page embeds a Type 1 font as CFF with three real glyphs, and promises four:
<< /Type /FontDescriptor
/FontName /JBATCH+CharSetLong
/FontFile3 9 0 R % /Subtype /Type1C — glyphs .notdef, A, B, C
/CharSet (/A/B/C/D) % there is no D in the program
>>
The page shows ABC, drawn and extracted correctly. D is a promise with nothing behind it.
Why a promise matters more than an omission
An incomplete list (31-012) undersells the font, and the worst a processor that trusts it can do is fail to reuse a glyph it could have used. An over-full list oversells it. A processor that decided from CharSet whether the embedded subset can draw some new text — rather than opening the program to find out — would conclude that it can set a D, and set one. The viewer would then look for D in the program, not find it, and draw .notdef: a blank or a box, where the text says there is a letter. That is 31-011, produced by trusting this one.
What a screen-reader user hears
In the file as it stands, nothing different. The list is not read when text is drawn or extracted, and every character on the page is set in a glyph that exists. The condition is a false statement waiting for something to act on it.
Where it comes from
A subset that shrank after its list was written. A tool that slims files by removing glyphs no text uses — or re-subsets fonts while merging documents — and copies the old descriptor across leaves a list naming glyphs that have just been taken out. The extra names are then glyphs the document used to have.
A list written from intentions rather than results. A producer that writes CharSet from the characters it meant to embed, and then embeds a font that turns out not to contain some of them, lists names the program never had.
A descriptor shared between two subsets. If two subsets of one font end up pointing at the same descriptor, at most one of them can match its list.
How to check it free
Compare the list with the program. In Acrobat Pro, following Adobe’s guide to advanced preflight inspections: select Use print production → Preflight from the All tools menu, then Options → Browse Internal PDF Structure, and read the CharSet string in the font descriptor. From the same Options menu, Create Inventory lists the glyphs each embedded font actually contains — Adobe’s page on Preflight reports describes it. A name in the string that is not in the inventory is this condition.
veraPDF checks CharSet under clause 7.21.4.2 for fonts with a subset tag. Its rule is phrased in terms of glyphs the list fails to name, which is 31-012; see the FAQ below before relying on it for this direction.
How to fix it free
Delete the entry, if the file does not also claim PDF/A-1. CharSet is optional and the condition only exists when it is present, so removing it resolves this without changing what is drawn or read. Acrobat cannot edit font descriptors — Adobe’s page says the structure browser is for looking, not editing — but the free Python library pikepdf can, in a few lines:
import pikepdf
with pikepdf.open("in.pdf") as pdf:
for obj in pdf.objects:
if isinstance(obj, pikepdf.Dictionary) and "/CharSet" in obj:
print("removing CharSet from", obj.get("/FontName"))
del obj["/CharSet"]
pdf.save("out.pdf")
If the file claims PDF/A-1, which requires CharSet on Type 1 subsets, shorten the list to the names the inventory shows instead of removing it.
If the subset itself is wrong — text was meant to use a glyph that was dropped — deleting the list only removes the warning. Re-export from the source so the subset and its description are built together from the final text.
What Taggart does
Taggart does not detect this condition. It reads font dictionaries and content streams but does not open embedded font programs, so it never learns which glyphs a program holds and has nothing to compare a CharSet with. On the test file it reports nothing about the font. It does not pass the condition either: 31-013 is on the list of conditions Taggart does not check, and the conformance claim waits until a person confirms them.
The only CharSet problem Taggart reports is a CharSet on a font with no embedded program at all, which it files under 31-012 together with 31-009. For a list that promises glyphs the program lacks, the inventory comparison above is the check to do before you confirm it.
How Taggart handles it
Software could decide this one, and Taggart does not check it yet. A clean report from Taggart says nothing about it either way. It is on the list of conditions Taggart asks you to confirm before it writes the PDF/UA claim into the file; check it by hand or with another validator, as described above.
Whatever Taggart changes, the page still looks identical. Fixes edit the PDF object model, not the content streams, and every remediation is re-rendered and compared against the original at structural similarity ≥ 0.999 before you get the file back. A tool that quietly reflows your document is worse than no tool.
Frequently asked questions
If the extra names are never used, what is the harm?
Nobody reading the document hears anything different. The harm is to software that decides what a subset can draw by reading the list instead of the program: it will believe the font has glyphs it does not, and anything it sets in them comes out as blanks — condition 31-011.
How is this different from 31-012?
It is the same list wrong in the other direction. 31-012 is a CharSet that leaves out a glyph the program contains; this is a CharSet that names a glyph the program does not contain. A list copied from an older subset often fails both ways at once.
Does veraPDF catch this direction?
veraPDF's rule for clause 7.21.4.2 is worded around glyphs present in the program that the list fails to name, and only applies to fonts with a subset tag. Its documentation does not say whether a name with no glyph behind it fails it too, so do not take a veraPDF pass as proof on this one; compare the list with the program directly.
Where this sits in the standards
| Standard | Reference |
|---|---|
| Matterhorn Protocol 1.1 | Checkpoint 31 (Fonts), index 31-013 |
| PDF/UA-1 (ISO 14289-1) | Clause 7.21.4.2-2 |
| WCAG 2.1 | 1.3.1 Info and Relationships — Level A |
| EN 301 549 / Section 508 / ADA Title II | All three point at WCAG 2.1 Level AA for non-web documents, so a Level A or AA criterion here is in scope for each of them. |
Related conditions
- 31-012 A glyph present in an embedded Type 1 font program is not listed in CharSetCharSet must accurately list the glyphs in the embedded subset.
- 31-011 The embedded font program does not contain glyphs for all referenced glyphsThe subset embedded in the file is missing glyphs the content stream asks for — very common when a document is edited after subsetting.
- 31-015 A glyph listed in CIDSet is not present in the CID font programCIDSet promises CIDs the font does not contain.
- 31-009 For a font used by text intended to be rendered the font program is not embeddedPDF/UA-1 requires every font used for visible text to be embedded, so the document renders and extracts identically everywhere. A glyph counts as rendered if the text render mode is not 3.
Other conditions in checkpoint 31
Checkpoint 31 covers fonts. These are its other failure conditions; the ones without a link are in the rule set but do not have a written page yet.
- 31-001 CIDSystemInfo Registry values are not identicalThe CMap and the descendant CID font must agree on the character collection registry.
- 31-002 CIDSystemInfo Ordering values are not identicalThe CMap and the descendant CID font must agree on the character collection ordering.
- 31-003 CIDSystemInfo Supplement of the CID font is lower than that of the CMapThe font's character collection supplement must be at least as new as the CMap's, or the CMap may reference CIDs the font does not define.
- 31-004 A Type 2 CID font contains neither a stream nor the name Identity as CIDToGIDMapCIDToGIDMap must be either the name /Identity or a stream mapping CIDs to glyph indices.
- 31-005 A Type 2 CID font does not contain a CIDToGIDMap entryThe entry is absent entirely.
- 31-006 A CMap is neither listed in ISO 32000-1 Table 118 nor embeddedA predefined CMap must be one of the standard names; anything else must be embedded in the file.
- 31-007 The WMode entry in a CMap dictionary is not identical to the WMode value in the CMap streamWriting mode (horizontal or vertical) must be declared consistently in the dictionary and the stream.
- 31-008 A CMap references another CMap which is not listed in ISO 32000-1 Table 118A UseCMap chain must terminate at a predefined CMap.
- 31-009 For a font used by text intended to be rendered the font program is not embeddedPDF/UA-1 requires every font used for visible text to be embedded, so the document renders and extracts identically everywhere. A glyph counts as rendered if the text render mode is not 3.
- 31-010 A font program is embedded that is not legally embeddable for unlimited, universal renderingThe font's embedding permission bits forbid the kind of embedding used. Machines can read the flags but the flags may not reflect the actual licence.
- 31-011 The embedded font program does not contain glyphs for all referenced glyphsThe subset embedded in the file is missing glyphs the content stream asks for — very common when a document is edited after subsetting.
- 31-012 A glyph present in an embedded Type 1 font program is not listed in CharSetCharSet must accurately list the glyphs in the embedded subset.
- 31-014 A glyph present in an embedded CID font program is not listed in CIDSetCIDSet must accurately list the CIDs in the embedded subset.
- 31-015 A glyph listed in CIDSet is not present in the CID font programCIDSet promises CIDs the font does not contain.
- 31-016 Glyph widths in the font dictionary and the font program differThe /Widths array must agree with the embedded font program.
- 31-017 A non-symbolic TrueType font has no non-symbolic cmapA font declared non-symbolic must actually carry a (3,1) or (1,0) cmap subtable.
- 31-018 A glyph cannot be looked up by any non-symbolic cmap entrySome rendered glyph is unreachable through the declared cmap tables.
- 31-019 The font dictionary for a non-symbolic TrueType font does not contain an Encoding entryNon-symbolic TrueType fonts must declare an /Encoding.
- 31-020 The Encoding dictionary for a non-symbolic TrueType font does not contain BaseEncodingIf /Encoding is a dictionary it must name a /BaseEncoding.
- 31-021 BaseEncoding is neither MacRomanEncoding nor WinAnsiEncodingOnly MacRomanEncoding and WinAnsiEncoding are permitted for non-symbolic TrueType fonts.
- 31-022 Differences contains glyph names not listed in the Adobe Glyph ListGlyph names in /Differences must be resolvable through the Adobe Glyph List so a processor can derive Unicode.
- 31-023 Differences present but the font has no (3,1) Microsoft Unicode cmapThe Differences array is resolved through the (3,1) cmap; without it the mapping is undefined.
- 31-024 The Encoding entry is present in the font dictionary for a symbolic TrueType fontSymbolic TrueType fonts must not carry an /Encoding; the font's own cmap governs.
- 31-025 The embedded font program for a symbolic TrueType font contains no cmapA symbolic TrueType font must contain at least one cmap subtable.
- 31-026 A symbolic TrueType font has multiple cmaps but none is a (3,0) Microsoft Symbol cmapWith multiple cmaps present, a (3,0) symbol cmap is required to disambiguate.
- 31-027 A font dictionary does not contain the ToUnicode entry and no exemption appliesA ToUnicode CMap is required unless the font uses MacRoman/MacExpert/WinAnsi encoding, or is a Type 1/Type 3 whose glyph names are all in the Adobe Glyph List or the Symbol set, or is a Type 0 whose descendant uses a standard Adobe character collection, or is a non-symbolic TrueType.
- 31-028 Unicode values in the ToUnicode CMap are zeroU+0000 is not a valid mapping target; it usually means the producer could not determine the character and wrote a placeholder.
- 31-029 Unicode values in the ToUnicode CMap are U+FEFF or U+FFFEByte-order marks are not characters and must not appear as mapping targets.
- 31-030 Characters used in text showing operators reference the .notdef glyphThe content stream paints glyph index 0, which is by definition "no glyph" — typically a hollow box or nothing at all.
Check your own file. Taggart does not check this condition yet, and lists it for you to confirm. Its validator is free and checks 75 of the 87 Matterhorn conditions software can decide — no watermark, no expiry, and no account needed up to 60 pages.
Taggart does not check this condition yet. A generated file that fails it is in the repository, with a test that fails the day Taggart starts catching it. Written on . The Acrobat steps follow Adobe’s documentation and were not walked through by hand. Last updated .