mirror of
https://github.com/storytold/indd-utils.git
synced 2026-11-22 18:20:45 +01:00
Page items:
- drop shadow KnockedOut (0x1EB6F), true where neither item nor style
stores it
- text wrap: the u32 at 40 of 0x3703 is the master page flag and the
wrap side (two u16, as the big-endian pair shows)
- groups get the fill, stroke and corner values all their children have
- dashes (0x5A35: list and corner code) on items whose stroke type in
effect is Dashed
- BeforeGroupingLayerPosition (0x324) from 21.4; export SizeType
(0x1E22B); no generated alt text attributes on groups
- anchored settings on items inside anchored items
- IgnoreWrap false without the chunk, MinimumFirstBaselineOffset 0 by
the baseline category, InsetSpacing before DOM 11 by the general
category; EPS contents from 0x8C23
- custom striped and dashed stroke styles (classes 0xB016, 0x5A43) and
StrokeType code 0x5A42
Preferences: column direction (0x555, else the story orientation),
optical margin size by the text size unit, highlight flags false without
their chunk, grid and gutter defaults and print marks by the edition
code, watermark font by the assignment name, EPUB ViewDocumentAfterExport
for DOM 8 and 9, HTMLFXLExportPreference from DOM 10.1, MathML document
values from DOM 20, index header type by variant name, three more
built-in kinsoku and mojikumi tables.
Resources and text: the saving edition from the XMP black name (tints
of black, unknown users, endnote and index titles, endnote marker), TOC
style entries, PageNumberType (0x1B09), CustomGlyph (0x1B5E), alignment
codes of 0x4266, 0x1B3E and 0xB676, spot colour alias and DOM 8 section
pagination (observed values), text variable settings and result texts,
object styles' AppliedParagraphStyle without a chunk and flex spacing,
stories of frames anchored in the XML backing story.
Fixes: flattener resolutions of 0x10833 were swapped; colour group Self
follows the DOM version.
compare.py, trustworthy pairs: value coverage 98.96 % -> 99.48 %
(+150,288 values), documents >= 99 % 914 -> 1,021, story text 37,129 ->
37,147 of 37,150 (0 missing), extras 92,838 -> 92,883 (+788 from the
KnockedOut and group-corner exceptions, -744 from fixed extras). No pair
loses values against f21267f. diff_outputs.py: 5,743 of 5,765 outputs
differ, no failure or warning differs.
155 lines
7.1 KiB
Markdown
155 lines
7.1 KiB
Markdown
# Text variables
|
|
|
|
Text variable definitions are objects of class 0xCAB4. Instances placed in
|
|
text are objects of class 0xCA64, owned by a U+0018 character in the story
|
|
(`objects.md`, owned items). Implemented in `src/model/variable.rs`.
|
|
|
|
IDML writes each definition as a `TextVariable` element in
|
|
`designmap.xml`, between the preference elements and `idPkg:Tags`, as the
|
|
schema orders them. Its `Self` is `dTextVariablen` followed by the name;
|
|
it has no UID, so definitions were paired with INDD objects by name.
|
|
|
|
## Evidence
|
|
|
|
All 135 corpus pairs, including those whose IDML is from an older
|
|
version. They have 1,347 IDML `TextVariable` elements. Each has exactly
|
|
one class 0xCAB4 object with the same name, and no class 0xCAB4 object
|
|
lacks an IDML element. The layout below also holds for all 2,496 class
|
|
0xCAB4 objects in the 251 distinct little-endian files.
|
|
|
|
## Definition (chunk 0x28BD)
|
|
|
|
| Field | Contents |
|
|
|---|---|
|
|
| u32 *n*, segments | Name: *n* UTF-16 code units as text segments (`objects.md`) |
|
|
| u32 *n*, segments | Text: the date format of date variables (below) |
|
|
| u32 | Type code |
|
|
| u32 *a*, u32 *b*, u32 *c* | Settings (below) |
|
|
| u32 *n*, segments | `TextBefore` |
|
|
| u32 *n*, segments | `TextAfter` |
|
|
|
|
The "20 bytes" of the definitions of the earlier pairs are this layout
|
|
with empty texts. The running header and chapter number definitions of
|
|
the trustworthy pairs of the corpus of 2026-10 parse to the end of their
|
|
chunk with it (their settings are all reproduced, below).
|
|
|
|
**Type codes** (each code with its `VariableType` in every pair):
|
|
|
|
| Code | `VariableType` | Pairs | IDML settings element |
|
|
|---|---|---|---|
|
|
| 0xCAA1 | `OutputDateType` | 135 | `DateVariablePreference` |
|
|
| 0xCAA3 | `CustomTextType` | 2 | `CustomTextVariablePreference` |
|
|
| 0xCAA6 | `FileNameType` | 135 | `FileNameVariablePreference` |
|
|
| 0xCAA8 | `LastPageNumberType` | 135 | `PageNumberVariablePreference` |
|
|
| 0xCAA9 | `ChapterNumberType` | 135 | `ChapterNumberVariablePreference` |
|
|
| 0xCAAA | `MatchParagraphStyleType` | 135 | `MatchParagraphStylePreference` |
|
|
| 0xCAAB | `ModificationDateType` | 135 | `DateVariablePreference` |
|
|
| 0xCAAC | `CreationDateType` | 135 | `DateVariablePreference` |
|
|
| 0xCAB5 | `XrefPageNumberType` | 135 | none |
|
|
| 0xCAB6 | `XrefChapterNumberType` | 135 | none |
|
|
| 0xCAC0 | `LiveCaptionType` | 130 | `CaptionMetadataVariablePreference` |
|
|
|
|
**Name.** Equal to IDML `Name` in 1,347 of 1,347. The names of the two
|
|
cross-reference variables start with U+001B, which IDML writes as
|
|
`<?AID 001b?>` inside the attribute value (270 of 270).
|
|
|
|
**Order.** IDML lists the variables sorted by name in code point order
|
|
(135 of 135 pairs; U+001B sorts first). The UID order differs in 113.
|
|
|
|
**Date format.** For the three date types, the text field is IDML
|
|
`Format` (405 of 405, 9 different formats such as `dd.MM.yy` and
|
|
`d MMMM yyyy, H:mm`).
|
|
|
|
**Running header style.** For type 0xCAAA, the u32 at offset 4 of the
|
|
settings is a paragraph style UID. It differs between files, but in all
|
|
135 pairs it is the style that IDML writes as
|
|
`AppliedParagraphStyle="ParagraphStyle/$ID/NormalParagraphStyle"`.
|
|
|
|
## Settings
|
|
|
|
- `TextBefore` and `TextAfter` are the two texts; IDML writes U+3000 as
|
|
`^(`. With them the converter reproduces every `TextBefore` and
|
|
`TextAfter` of the running header and chapter number settings of the
|
|
trustworthy pairs (1,287 and 1,227 elements), among them chapter
|
|
numbers with text before or after the number.
|
|
- Running header (0xCAAA): *b* is the paragraph style; *c* is
|
|
`SearchStrategy`, 0 `FirstOnPage`, 1 `LastOnPage`; *a* is `ChangeCase`,
|
|
0 or 0xCAC9 `None`, 0xCAD0 `Sentencecase`. 1,287 of 1,287 values each
|
|
in the trustworthy pairs.
|
|
- Chapter number (0xCAA9): *a* is `Format`, 0 `Current`; 0x4C15
|
|
`Arabic` (one definition, in a trustworthy pair).
|
|
|
|
## Settings with one value in the corpus
|
|
|
|
The other IDML settings have the same value in every pair:
|
|
|
|
| Element | Attributes |
|
|
|---|---|
|
|
| all settings elements | `TextBefore=""`, `TextAfter=""` |
|
|
| `PageNumberVariablePreference` | `Format="Current"`, `Scope="SectionScope"` |
|
|
| `ChapterNumberVariablePreference` | `Format="Current"` |
|
|
| `FileNameVariablePreference` | `IncludePath="false"`, `IncludeExtension="false"` |
|
|
| `MatchParagraphStylePreference` | `SearchStrategy="FirstOnPage"`, `ChangeCase="None"`, `DeleteEndPunctuation="false"` |
|
|
| `CaptionMetadataVariablePreference` | `MetadataProviderName="$ID/#LinkInfoNameStr"` |
|
|
| `CustomTextVariablePreference` | an empty `Contents` string |
|
|
|
|
Their INDD fields cannot be located, because nothing varies. The INDD
|
|
side has one pattern per type in all 2,496 objects of the little-endian
|
|
files (with or without IDML):
|
|
|
|
| Types | Text field | 20 settings bytes |
|
|
|---|---|---|
|
|
| Dates | the format | u32 0 or 0xCAB3, then zeros |
|
|
| 0xCAC0 | empty | u32 0x8C64, then zeros |
|
|
| 0xCAAA | empty | u32 0, u32 style, then zeros |
|
|
| Others | empty | zeros |
|
|
|
|
The exception is custom text variables (0xCAA3): in files without IDML,
|
|
5 of 7 have a non-empty text field (for example a person's name or a
|
|
date), probably the variable's contents, and one has 0xCAB3 in the first
|
|
u32. The two in the pairs have an empty text field and an empty
|
|
`Contents`.
|
|
|
|
The converter writes the settings above only for a definition whose
|
|
fields match its type's pattern. Then the INDD data equals that of the
|
|
samples, so the IDML settings are taken to be equal too. For any other
|
|
definition it writes the date format and the running header style (the
|
|
proven fields) and leaves out the rest. A custom text variable with a
|
|
non-empty text field gets no `CustomTextVariablePreference`: that the
|
|
text is its contents is not proven.
|
|
|
|
## Instances (class 0xCA64)
|
|
|
|
| Chunk | Contents |
|
|
|---|---|
|
|
| 0x100B | u8 (1 in every sample), then the name of the variable as an in-object string |
|
|
| 0x288B | u32 UID, not used |
|
|
|
|
IDML writes an instance as a `TextVariableInstance` element in place of
|
|
the U+0018, with `Self` the instance's UID, `Name` the variable's name and
|
|
`AssociatedTextVariable` the variable's `Self`. The pairs have 8
|
|
instances, in four copies of one document; all 8 match on all three.
|
|
In the 251 little-endian files, all 25 instance names name a definition
|
|
of the same file.
|
|
|
|
**Result text.** IDML `ResultText` is the text the variable displays.
|
|
The INDD does not store it: the four pairs' modification date text
|
|
(`October 31, 2023 4:06 PM`) does not occur in the INDD files, either as
|
|
single bytes or as UTF-16. The file name instances (4 of 4) show the
|
|
INDD file name without its extension, as their settings
|
|
(`IncludePath="false"`, `IncludeExtension="false"`) say.
|
|
|
|
In the corpus of 2026-10 two more kinds of instance show their text:
|
|
|
|
- A running header on a master page shows `TextBefore`, `<`, the
|
|
variable's name, `>` and `TextAfter`.
|
|
- A chapter number in the `Current` format shows `TextBefore`, the
|
|
document's chapter number (`ChapterNumberPreference`) and
|
|
`TextAfter`.
|
|
|
|
The converter writes `ResultText` for these and for the file name
|
|
variables above, and leaves it out (it is optional in the schema) for
|
|
all others: page numbers, dates and cross-reference page numbers depend
|
|
on the layout or the export time. Over the trustworthy pairs it
|
|
reproduces 80 of the 280 `ResultText` values, with 1 different.
|