Files
indd-utils/docs/format/attributes.md
T
aiongg 09e87fadea feat: write page item values only where they differ from the object style
IDML leaves out the values of a page item that equal those of its
applied object style. The writer now compares with the style's
effective values (its own, then the styles it is based on, then [None]):

- TextFramePreference: an attribute is written when its category is off
  in the style's category list (chunk 0x1B92E, also for [None]) or its
  value differs; TextColumnMaxWidth (DOM 8), TextColumnCount (DOM 10)
  and InsetSpacing (DOM 11) are always written; footnote values from
  13.1 (objects.md, text frame preferences).
- Fill, stroke, miter and corner attributes (attributes.md).
- Transparency effects: only differing values, and an effect element
  only when it has one or its opacity stops differ (transparency.md).

New decoding: object style chunk 0x1B924 fields for balance, fixed
width, justification, first baseline offset (code 4 = XHeight, also for
frames) and auto-sizing; chunk 0x1B92C (style transparency). Object
styles get the DOM 12 text frame values from DOM 8 and
FootnotesEnableOverrides from 13.1 (idml-values.md).
2026-10-07 22:19:20 +00:00

34 KiB
Raw Blame History

Attribute lists

Formatting is stored as attribute lists (on page items: chunk 0x6E03). Decoded in src/model/attrs.rs. The IDML name and value kind of each ID are in the tables of src/idml/attrs.rs; src/idml/kind.rs converts each kind.

Layout

u32 count, then for each attribute:

Size Field
4 Attribute ID
2 Payload size n
n Payload: u16 value count, then values

Each value: u32 type, u16 length, data. The first value is the attribute's value. Every attribute in the samples has a second value of type 0x6E63 with 6 bytes, meaning unknown.

Type Length Value
0x6E68 8 f64
0x6E67 4 i32
0x6E65 2 u16 (enumeration or boolean)
0x6E69 16 two f64 (a point)
0x117 4 UID reference

All 2,730 page item chunks of this layout in the samples parse exactly.

Page item attributes

The list holds the item's local values. IDML writes an attribute only when it differs from the applied object style, so a value can be in the INDD list and absent from the IDML.

ID IDML attribute Evidence: IDML value equals INDD value
0x6E68 FillColor (swatch UID) 1,190 of 1,194
0x6E69 FillTint 10 of 10
0x6E64 StrokeColor (swatch UID) 78 of 82
0x6E65 StrokeWeight 171 of 171
0x6E6D MiterLimit 778 of 778
0x6E6F CornerOption: code 0 = None, 0x5A15 = RoundedCorner, 0x5A16 = InverseRoundedCorner (the codes of object styles, objects.md) 20 of 23 for 0x5A15; with all three codes, 1,876 of 1,995 rectangles, 504 of 520 text frames and 489 of 489 page item defaults in the trustworthy pairs
0x6E70 CornerRadius 213 of 216
0x6E70, 0x6E94, 0x6E92, 0x6E93 TopLeftCornerRadius, TopRightCornerRadius, BottomLeftCornerRadius, BottomRightCornerRadius (below) each radius ID against its own corner 4,357, 3,200, 3,276 and 3,325 matches, no mismatch
0x6E6F, 0x6E91, 0x6E8F, 0x6E90 TopLeftCornerOption, TopRightCornerOption, BottomLeftCornerOption, BottomRightCornerOption: codes as CornerOption (below) 11,211 of 11,211
0x551F GradientFillLength all non-zero (30)
0x5520 GradientFillStart (point) all non-zero (30)
0x5525 GradientStrokeLength (assumed; equal to fill in all samples) 30
0x5526 GradientStrokeStart (assumed; equal to fill in all samples) 30
0x6E6E StrokeType (built-in stroke style code, below) 51 of 51 items, 576 of 576 object styles
0x6E8C StrokeAlignment: 0 CenterAlignment, 1 InsideAlignment (below) 1 item, 576 object styles

Corners. The top-left corner uses the same IDs as CornerRadius and CornerOption. The corner option codes are 0 None, 0x5A15 RoundedCorner, 0x5A16 InverseRoundedCorner, 0x5A17 InsetCorner, 0x5A18 BevelCorner and 0x5A19 FancyCorner; all six occur. The evidence is over the items of the trustworthy pairs whose corners differ: each radius ID matches its own corner with no mismatch, and has 16 to 71 mismatches against each other corner. The same IDs hold the corners of object styles (chunk 0x1B92B) and of the page item defaults (class 0x6E07): all four radii and options of PageItemDefault match in 495 of 495 documents.

Values equal to the object style. The style's effective value is its own (chunk 0x1B92B), else that of the style it is based on, else the root [None]'s (StrokeWeight="0", FillTint="-1", FillColor and StrokeColor Swatch/None, CornerRadius="12", MiterLimit="4", CornerOption="None"; idml-values.md). Over the 489 trustworthy pairs, the converter wrote these values where the IDML has none, and every one of them equals the style's effective value:

Attribute Written though the IDML has none IDML writes it though equal
StrokeWeight 27,989 5
CornerRadius 1,608 0
FillTint 1,423 0
StrokeColor 1,336 0
FillColor 312 0
CornerOption 87 0
MiterLimit 26 0

Of the StrokeWeight values, the 26,969 on items whose IDML element has the same tag all equal the style (17,501 text frames, 7,070 rectangles, 2,074 polygons, 297 ovals, 27 lines); the others are on shapes written as another element type. The converter leaves out these attributes, and the four corner radii and options, when they equal the style's value (numbers to 6 significant digits). StrokeWeight="1" on an item with [None] and no stroke weight of its own (objects.md, page item settings) differs from [None]'s 0 and is still written.

Transparency attributes (IDs 0x108xx and 0x1EBxx) are described in transparency.md.

Strokes

Object styles (class 0x1B901) hold a full page item attribute list in chunk 0x1B92B, with the same record layout as chunk 0x6E03 but a u16 count. The converter reads them (object style lists in indd audit) and writes them with the page item table. They also add evidence: the corpus pairs have 576 object styles whose name matches an IDML ObjectStyle.

Stroke type (0x6E6E). The record has three values: a reference (type 0x117), a code (type 0x6E64, 4 bytes) and the usual 6-byte value. The reference is 0 in every sample and the code names a built-in stroke style. IDML writes StrokeType as StrokeStyle/$ID/<name>.

Code IDML stroke style Evidence
0x5A29 Solid 574 object styles in 135 files
0x5A38 Canned Dashed 3x2 2 items in 1 file
0x5A39 Canned Dotted 46 items in 13 files
0xB004 ThinThin 2 object styles in 1 file, and 2 items in the same file that have no IDML StrokeType and use one of those styles
0xB01A Triple_Stroke 1 item

No item or style has the same code with a different IDML value. The converter writes StrokeType for these codes when the reference is 0. Custom stroke styles (a non-zero reference) do not occur in the corpus; every corpus IDML lists only the 18 built-in stroke styles.

Stroke alignment (0x6E8C). All 576 object styles have 0 and StrokeAlignment="CenterAlignment". One text frame in the pairs has 1 and InsideAlignment. Its INDD list has four 0x6E attributes, and its IDML differs from its object style in four stroke attributes: 0x6E64 StrokeColor, 0x6E65 StrokeWeight and 0x6E6E StrokeType are identified above, which leaves 0x6E8C for StrokeAlignment. The code for OutsideAlignment is not known; the converter leaves out other codes.

Not identified. These attributes have one value in every object style and in every item whose IDML writes them, so the field cannot be told apart from others with the same value: StrokeTint (-1), GapColor (Swatch/None), GapTint (-1), EndCap (ButtEndCap), EndJoin (MiterEndJoin), LeftArrowHeadScale and RightArrowHeadScale (100), ArrowHeadAlignment (InsidePath). Items with another StrokeTint (20 in one pair) have no INDD object with the same UID. StrokeCornerAdjustment and StrokeDashAndGap do not occur in the corpus IDML files.

Line ends. One line in the pairs has LeftLineEnd="CurvedArrowHead" and RightLineEnd="BarArrowHead", and its INDD list has 0x6E71 = 0x5A08 and 0x6E72 = 0x5A0D (both 0 in all 576 object styles, whose line ends are None). Either attribute could be either ID, so line ends are not converted.

Text attribute lists

Text formatting uses the same record layout with a u16 count. It appears in:

  • Styles: chunk 0x23F of a style object (u16 count, records).
  • Story runs: each paragraph-style or character-style run record (chunk 0x262, see objects.md) continues after the style UID with a u16 count and records. These are the run's local overrides.

Value types are specific to each attribute (for example 0x1B05 for swatch references, 0x1B28 for point size), so the converter decodes a text value by the layout of its attribute. The attributes whose value is not a single number have their layout listed in text_layout (src/model/attrs.rs): string values (FontStyle) are a flag byte followed by an in-object string; tab lists, nested styles, bullet characters, points, ruby text and cell edge stroke types are described below. Other values are numbers, decoded by length: 8 bytes f64, 4 bytes u32, 2 bytes u16. A value that does not fit its attribute's layout is kept undecoded and not written.

Mapping and evidence

Found by aligning IDML ParagraphStyleRange and CharacterStyleRange elements with INDD runs at the same text offset (1,562 ranges), and IDML styles with INDD styles of the same name (486 styles), then checked with tools/compare.py. Counts are matches/total in the current comparison (ranges + paragraph styles + character styles where present).

ID IDML attribute Encoding Evidence
0x1B01 FillColor swatch UID 354/354 ranges, 226/226 styles
0x1B02 FontStyle flag + string 474/474 ranges, 202/202 styles
0x1B03 PointSize f64 1,090/1,090 ranges
0x1B06 HorizontalScale fraction ×100 2/2 ranges, 75/75 styles
0x1B07 KerningMethod code: 15972 Metrics, 79875 Optical 20/20 ranges, 81/81 styles
0x1B08 Ligatures 1 = true 201/201 ranges
0x1B0A StrokeWeight f64 241/241 ranges
0x1B0B Tracking thousandths of an em ×1000 49/49 ranges, 94/94 styles
0x1B0C Composer code: 0x2001 HL Single, 0x2002 HL Composer, 0x2078 HL Composer Optyca 4/4 ranges, 114/114 styles
0x1B0D DropCapCharacters u16 79/79 styles; see below
0x1B0E DropCapLines u16 79/79 styles; see below
0x1B10 BaselineShift f64 79/79 styles; see below
0x1B11 Capitalization 0 Normal, 1 SmallCaps, 2 AllCaps, 3 CapToSmallCap 77/77 styles; codes 1 and 3 below
0x1B12 StrokeColor swatch UID 75/75 styles
0x1B13 KerningValue ems ×1000; 1e8 = none 8/8 ranges; scale from a sample and its print PDF, see below
0x1B15 VerticalScale fraction ×100 79/79 styles; see below
0x1B16 LeftIndent f64 22/22 ranges
0x1B17 RightIndent f64 86/86 styles
0x1B18 FirstLineIndent f64 12/12 ranges
0x1B1A AutoLeading fraction ×100 75/75 styles
0x1B1B Leading (Properties) f64; negative = Auto 43/43 ranges, 137/137 styles
0x1B1D AppliedLanguage language UID; see below 88/88 styles
0x1B1F Hyphenation 3 = true, 0 = false 204/204 ranges
0x1B24 NoBreak 1 = true 78/78 styles
0x1B25 HyphenationZone f64 155/155 ranges
0x1B26 SpaceBefore f64 13/13 ranges
0x1B27 SpaceAfter f64 42/42 ranges
0x1B29 TabList (Properties) list; see below 110/110 styles
0x1B2A Underline 1 = true 81/81 ranges
0x1B2B AppliedFont (Properties) font family UID 1,071/1,071 ranges, 236/247 styles
0x1B2C OTFFigureStyle 1 ProportionalOldstyle, 2 ProportionalLining, 4 Default 4/4 ranges, 138/138 styles
0x1B2E MaximumWordSpacing fraction ×100 77/77 styles
0x1B2F MinimumWordSpacing fraction ×100 77/77 styles
0x1B31 MaximumLetterSpacing fraction ×100 78/78 styles; see below
0x1B32 MinimumLetterSpacing fraction ×100 78/78 styles; see below
0x1B37 StartParagraph 0 Anywhere, 2 NextPage 78/78 styles; code 2 below
0x1B3C Position 0 Normal, 5 OTNumerator 20/20 ranges, 78/78 styles
0x1B40 KeepLinesTogether 1 = true 78/78 styles; see below
0x1B42 FillTint f64 24/24 ranges
0x1B46 GradientFillAngle f64 81/81 styles
0x1B48 GradientFillLength f64 2/2 ranges, 81/81 styles
0x1B4A GradientFillStart two f64 2/2 ranges, 81/81 styles
0x1B4D RuleAboveLineWeight f64 155/155 ranges
0x1B4F RuleAboveOffset f64 78/78 styles
0x1B50 RuleAboveLeftIndent f64 91/91 styles
0x1B51 RuleAboveRightIndent f64 91/91 styles
0x1B52 RuleAboveWidth 1 ColumnWidth, 2 TextWidth 91/91 styles
0x1B53 RuleBelowColor (Properties) swatch UID, 0 = "Text Color" 6/6 ranges, 114/114 styles
0x1B54 RuleBelowLineWeight f64 155/155 ranges
0x1B55 RuleBelowTint f64 78/78 styles
0x1B56 RuleBelowOffset f64 78/78 styles
0x1B5D RuleBelow 1 = true 83/83 styles
0x1B6A ParagraphBreakType 0 Anywhere, 1 NextColumn 11/11 ranges, 78/78 styles
0x1B6B SingleWordJustification 0 LeftAlign, 3 FullyJustified 80/80 styles
0x1B75 AllNestedStyles (Properties) list; see below 14/14 styles
0x1B7E Justification 0 LeftAlign, 1 CenterAlign, 2 RightAlign, 4 LeftJustified, 5 CenterJustified 70/70 ranges
0x1B80 DropcapDetail u32 5/5 ranges, 103/103 styles
0x1B8C OTFContextualAlternate 1 = true 220/220 ranges
0x1B8D UnderlineColor (Properties) swatch UID, 0 = "Text Color" 81/81 ranges
0x1B91 UnderlineOffset f64 81/81 ranges
0x1B94 UnderlineWeight f64 81/81 ranges
0x1BB7 MiterLimit f64 161/161 ranges
0x1BB9 EndJoin 0 MiterEndJoin, 1 RoundEndJoin 86/86 styles
0x1BBD SpanColumnType 0 SingleColumn, 1 SpanColumns 41/41 ranges, 94/94 styles
0x1BBE SpanSplitColumnCount (Properties) u16; 1 = All 12/12 ranges, 78/78 styles
0x1BBF SplitColumnInsideGutter f64 155/155 ranges
0x1BC4 SpanColumnMinSpaceAfter f64 84/84 styles
0x1BD2 ParagraphShadingColor (Properties) swatch UID 25/25 ranges
0x1BD3 ParagraphShadingTint f64 79/79 styles
0x1BD6 ParagraphShadingOn 1 = true 88/88 styles
0x1BDB ParagraphShadingTopOffset f64 91/91 styles
0x1BDC ParagraphShadingBottomOffset f64 90/90 styles
0x1BF6 ParagraphBorderColor (Properties) swatch UID 72/72 styles
0x1BF9 ParagraphBorderOn 1 = true 77/77 styles
0x1DF03 ParagraphBorderTopOffset f64 83/83 styles
0x1DF04 ParagraphBorderBottomOffset f64 83/83 styles
0x1DF21 SameParaStyleSpacing (Properties) f64; −1 = SetIgnore 15/15 ranges, 100/100 styles
0x4265 GridAlignFirstLineOnly 1 = true 81/81 styles
0x4266 GridAlignment 0 None, 1 AlignBaseline 86/86 styles
0x425E Tatechuyoko 1 = true root styles; 1 from a sample typeset vertically and its print PDF, see below
0x4279 ShataiDegreeAngle degrees, written ×100 root styles; see below
0x427A ShataiAdjustTsume 1 = true root styles; see below
0x427B ShataiAdjustRotation 1 = true root styles and a sample typeset vertically; see below
0x422D RubyFlag number; written when not 0 a sample and its print PDF; see below
0x422E RubyString u32 length, text segments; written when not empty a sample and its print PDF; see below
0x1A401 BulletsAndNumberingListType 0 NoList, 1 BulletList 10/12 ranges
0x1A406 BulletChar (Properties) u32 type, u32 value; see below 1/1 ranges, 84/84 styles
0x1A413 BulletsFont (Properties) font family UID, 0 = $ID/ 1/1 ranges, 84/84 styles
0x1A414 BulletsFontStyle (Properties) flag + string; empty = Nothing 1/1 ranges, 84/84 styles
0x1A419 NumberingContinue 1 = true 2/2 ranges, 78/78 styles
0x1A41F BulletsCharacterStyle (Properties) character style UID 84/84 styles
0x1A420 NumberingCharacterStyle (Properties) character style UID 79/79 styles
0x1A423 NumberingExpression flag + string 79/79 styles
0x4221 Mojikumi (Properties) table UID; see below 936/1,019 styles
0x4224 KinsokuSet (Properties) table UID; see below 987/987 styles
0x42C0 TreatIdeographicSpaceAsSpace 1 = true 1,082/1,083 styles
0x50F18 DiacriticPosition 4 OpentypePosition, 5 OpentypePositionFromBaseline 1,007/1,010 styles

The counts of these four are paragraph and character styles of all 654 pairs whose IDML style has the attribute and the same name (the root paragraph style of every pair among them); they also reproduce the TextDefault values of the preferences (preferences.md). The kinsoku and mojikumi value is a UID: 0 is Nothing; a built-in table (kinsoku and mojikumi tables in objects.md) is written as an enumeration: kHardKinsokuName HardKinsoku (51 styles), kSoftKinsokuName SoftKinsoku (11), kKoreanKinsokuName KoreanKinsoku (12), kSimpChineseKinsokuName SimplifiedChineseKinsoku (1), kMojikumiDefaultName1 LineEndAllOneHalfEmEnum (55) and kMojikumiDefaultName16 SimpChineseDefault (1); a custom kinsoku table (class 0x4204) as the object KinsokuTable/<name> (38). Other built-in tables are not written. 81 styles name a custom mojikumi table of class 0x4203, which the converter does not write, so their Mojikumi is left out.

Paragraph style counts include the 78 root styles [No paragraph style] of the compared pairs. For many attributes above the root holds the only value that is the same in every pair (for example RightIndent="0"), so the evidence that tells the attribute apart is in the other styles:

Attribute Other styles or ranges with the attribute
BaselineShift 1 style with 0; 1 range with −16 in a story that compare.py does not align
RightIndent 8 styles in one pair, two different values
AppliedLanguage 10 styles in 2 pairs
NoBreak 1 style with 1 (true), in a pair whose IDML is from an older version
TabList 33 styles in 5 pairs, left and right stops, with and without leaders
OTFFigureStyle 60 styles in one pair (codes 1 and 2), 4 ranges in another (code 4)
Position 20 ranges in one pair
GradientFill* 3 styles in one pair (angle −90, distinct length and start), 2 ranges in another
RuleAbove*Indent, RuleAboveWidth 13 styles in one pair (left −1.13, right −2.83)
RuleBelowColor 36 styles in 2 pairs, four colours
RuleBelow 5 styles in one pair (4 true, 1 false)
ParagraphBreakType 19 ranges in one pair
SingleWordJustification 2 styles in one pair with code 0
EndJoin 8 styles in one pair
SpanColumnType 16 styles in 2 pairs, 46 ranges in one pair, both codes
SpanSplitColumnCount 13 ranges in one pair with 2
SpanColumnMinSpaceAfter 6 styles in one pair
ParagraphShading*, ParagraphBorder* 2 to 14 styles in one pair, several different offsets
SameParaStyleSpacing 30 styles and 16 ranges, each in 2 pairs
GridAlignment, GridAlignFirstLineOnly 8 and 3 styles in 3 pairs
BulletChar, BulletsFont, BulletsFontStyle, BulletsCharacterStyle 6 styles in 2 pairs, 1 range in another
NumberingExpression, NumberingCharacterStyle 1 style
NumberingContinue 2 ranges in 2 pairs
VerticalScale 1 style; see below

For codes, the root style gives the default: for example every root style has 0x1B6B = 3 and IDML SingleWordJustification="FullyJustified", and 0x1BBE = 1 with SpanSplitColumnCount All.

VerticalScale (0x1B15). The value is 1 (100%) wherever it appears, like HorizontalScale (0x1B06), so values do not tell them apart. Over all pairs, including those with an IDML from another version, 0x1B15 is present in exactly the 5 styles where IDML writes VerticalScale; 0x1B06 is identified separately by values other than 100%.

Languages (0x1B1D). The value is the UID of an object of class 0x2D07. Its chunk 0x2D0F is a flag byte, then the language name as an in-object string (English: USA), followed by other strings. IDML writes $ID/ and that name. Over all pairs, all 62 styles (root styles included) and 4 ranges with the attribute match, with 5 different languages.

Tab stops (0x1B29). u16 count, then for each stop: f64 position, u16 alignment (0 LeftAlign, 2 RightAlign; no other code occurs), u16 leader length and the leader in UTF-16 code units. IDML writes each stop as a ListItem with Alignment, AlignmentCharacter, Leader and Position. AlignmentCharacter is . in every IDML tab stop, and the INDD record has no field for it, so the converter writes .. An empty list is a count of 0. The converter leaves out a list with another alignment code.

Nested styles (0x1B75). u32 count, then for each item: u32 character style UID, u32 length, and a delimiter code of that many characters stored as text segments (see objects.md). The code gives Delimiter, Inclusive and Repetition:

Code IDML Evidence
[c] Delimiter string c, Inclusive="false" 13 items in one pair (. and :)
(c) Delimiter string c, Inclusive="true" 1 item in the same pair
^c Dropcap, Inclusive="true" 1 item in the same pair
digits after ) or ] Repetition; no digits = 1 a sample and its print PDF
(^w) AnyWord a sample and its print PDF
(^?) AnyCharacter a sample and its print PDF

The public pair has only single-character literals and repetition 1. The last three rows rest on a sample and its print PDF:

  • A sample has nested items with (^?) and with (^w) followed by a number, the latter applying a character style with Capitalization code 3 (CapToSmallCap, see below).
  • In the PDF, capitals in the first words of paragraphs in those styles are set at small-cap height (ink height measured on the rendered page), and capitals later in the same lines at full height. Small capitals reach at most one word past the number, and capitals a few words further on are at full height, so the number is the repetition. Of the counting delimiters in the IDML schema, only AnyWord gives a stretch of several words: AnyCharacter, Letters and Digits would end within the first word, and Sentence would run past sentence ends, which the PDF does not show.
  • A paragraph-level override has (^?) followed by a number n, then (^w). In the PDF the first capital after the first n characters of that paragraph is a small cap. With a word delimiter, the first n words would keep full capitals, and that capital lies within them. So ^? counts characters: AnyCharacter.

The converter leaves out a list that has any other code.

Bullet character (0x1A406). Two u32: the character type (0 UnicodeOnly, 1 UnicodeWithFont, 2 GlyphWithFont) and the character value. IDML writes an empty BulletChar element with BulletCharacterType and BulletCharacterValue attributes. In the pairs, type 0 occurs in the root styles with value 8226 (•), type 1 in one range and type 2 in 6 styles, each with its value and a BulletsFont.

KeepLinesTogether (0x1B40). In every pair the root style has 0, and IDML writes KeepLinesTogether="false", KeepAllLinesTogether="false", KeepFirstLines="2" and KeepLastLines="2". No public style sets another value. The rest of the evidence is a sample and its print PDF:

  • Some paragraph styles of the sample set 0x1B40 to 1. Apart from attributes identified above, they set nothing else.
  • In the PDF, paragraphs in those styles that break across pages always leave at least two lines on each page. A paragraph of n lines broken at a random line leaves a single line on one side with probability 2/(n − 1), so this pattern does not come from chance.
  • Such paragraphs do break across pages, so the attribute is not KeepAllLinesTogether. A boolean that keeps at least two lines together at both ends, with the defaults above, is KeepLinesTogether.

Capitalization codes 1 and 3.

  • Code 1 is SmallCaps. In one pair (InDesign 20.2, IDML from the same version), 8 of 8 paragraph styles with code 1 have Capitalization="SmallCaps". The same pair confirms code 2 (4 of 4 styles) and code 0.
  • Code 3 is CapToSmallCap. No pair has it. The evidence is a sample and its print PDF. In the PDF, words set in a style with code 3 that start with a capital letter show that capital at the height of the letter after it, about two thirds of the height of word-initial capitals in ordinary text. Heights were measured on the rendered pages. So code 3 sets capital letters as small capitals too. Of the values in the IDML schema (Normal, SmallCaps, AllCaps, CapToSmallCap, LowerCase), only CapToSmallCap does that.

The converter leaves out other codes.

Drop caps (0x1B0D, 0x1B0E). In every pair, the root style [No paragraph style] has 0 for both and IDML writes DropCapCharacters="0" and DropCapLines="0". One pair (InDesign 20.2, IDML from the same version) also has a style with 0x1B0D = 1 and 0x1B0E = 3; its IDML has DropCapCharacters="1" and DropCapLines="3". The different values tell the two attributes apart.

Letter spacing (0x1B31, 0x1B32). In every pair both are 0 in the root style, as are MaximumLetterSpacing and MinimumLetterSpacing in the IDML. That does not tell them apart from other attributes that are 0 there. The rest of the evidence is a sample and its print PDF:

  • A paragraph style of the sample sets 0x1B31 to a positive fraction and 0x1B32 to a negative one. The style sets no tracking, and its other unidentified attributes are not fractions.
  • In the PDF, justified lines in that style have a character spacing (Tc operator) that changes from line to line, both positive and negative. So the style lets letter spacing vary in both directions, which needs a negative minimum and a positive maximum.
  • The values are stored as fractions, like word spacing (0x1B2E, 0x1B2F), so they are written ×100. The positive one is the maximum.

A layout of the converted sample with these two attributes reproduces noticeably more of the PDF's line breaks than one without them.

Ruby (0x422D, 0x422E). IDML writes neither attribute on the root style, and no corpus story has them. In every pair the root style stores 0 for 0x422D and a 4-byte 0 for 0x422E. The evidence is a sample typeset vertically and its print PDF:

  • Character runs of the sample set 0x422D to 1 together with 0x422E, whose value is a u32 length in characters followed by text segments (as story text, objects.md). The text is a short reading of the run's characters.
  • In the PDF, each such text appears in small type in a narrow column right beside the run's characters and centred on them, as ruby is set beside vertical text.
  • The converter decodes the value of 0x422E by this layout, whatever its length.

The converter writes RubyString and writes RubyFlag with the stored number (1 in every such run; the schema type is an integer). The other ruby settings (RubyType, RubyAlignment, RubyPosition, font and size) are not identified.

Tatechuyoko (0x425E). Every public style that stores it has 0, and IDML writes Tatechuyoko="false" on all 240 root paragraph styles of the corpus IDML files; no public range has the attribute. The evidence for 1 is a sample typeset vertically and its print PDF:

  • Runs of a few Latin characters (letters or punctuation) set 0x425E to 1. Elsewhere in the same vertical stories, Latin text without it is drawn turned sideways: the PDF text matrix is a quarter turn, and the letters follow each other down the column.
  • The glyphs of each run with 1 are drawn upright (identity text matrix), side by side on one baseline, and the group is centred on the column's centre line to 0.01 pt. That is horizontal-in-vertical setting.

Shatai (0x4278 to 0x427B). In every public file the root paragraph style stores 0x4278 = 0, 0x4279 = 45, 0x427A = 1 and 0x427B = 0, and IDML writes ShataiMagnification="0", ShataiDegreeAngle="4500", ShataiAdjustTsume="true" and ShataiAdjustRotation="false" on all 240 root styles; no other public style or range sets them. Only 45 and 4500 are not 0 or a boolean, so 0x4279 is the angle, written ×100. The rest of the evidence is a sample typeset vertically and its print PDF:

  • Runs set 0x4278 = 20, 0x4279 = 60 and 0x427A = 0. Their glyphs have the text matrix (0.850, 0.0866, 0.0866, 0.950) × point size. That matrix scales by 1 along the direction at 60° and by 0.80 across it: a distortion of 20 % at 60°. So 0x4278 is the magnification in percent and 0x4279 the angle in degrees.
  • A character style sets 0x4278 = 10, 0x4279 = 60 and 0x427B = 1. Its glyphs have the matrix (0.9222, 0.0843, 0, 0.9759) × point size. This is the 10 % distortion at 60°, turned so that the glyph's vertical axis stays vertical (the third value is 0). The runs above, with 0x427B = 0, are not turned. So 0x427B is ShataiAdjustRotation.
  • That leaves 0x427A for ShataiAdjustTsume, which also matches the root values (1 and true; 0x427B 0 and false). With 0 the glyphs keep an advance of one em; no sample has 1 outside root styles.

The converter writes the angle and the two booleans. It leaves out ShataiMagnification: the sample stores the percentage, but the root value 0 does not show the unit IDML uses, and the angle shows that it need not be the stored number.

KerningValue (0x1B13). Every root paragraph style stores 1e8, and IDML writes no KerningValue on root styles; the converter leaves 1e8 out. In one pair, 8 ranges store 0 and IDML writes KerningValue="0" on the same 8 ranges; no other range in the pairs has the attribute. So the field is located, but 0 does not show its scale. The scale rests on a sample and its print PDF:

  • Runs of one character set 0x1B13 to −0.1, −0.06, −0.12 and 0. In the PDF, the gap between that character and the next (start of the next glyph minus the end of the first glyph's advance width) is −0.1, −0.06, −0.12 and 0 times the point size, to 0.01 pt, once the letter spacing that every other gap in the same line shows is subtracted.
  • The same letter pairs elsewhere, without the attribute, have other gaps, which come from the font's kerning. So the stored value replaces the font's kerning after that character.
  • The value is in ems. The IDML schema types KerningValue as a plain number. Tracking (0x1B0B) is also stored in ems, and IDML writes it ×1000 (thousandths of an em, from the pairs); the converter writes KerningValue the same way. No sample shows this scale directly.
  • The schema allows KerningValue on character styles and ranges, not on paragraph styles, so the converter leaves it out of paragraph styles (public samples without IDML have it there).

StartParagraph (0x1B37). In every pair the root style has 0 and IDML writes StartParagraph="Anywhere"; no pair has another value. Code 2 rests on a sample and its print PDF:

  • Every paragraph whose style has code 2 is the first text on its page in the PDF, and the page before it often ends with room for more lines. Those styles set no other attribute that is unidentified.
  • Such paragraphs start on both odd and even pages, so code 2 is not NextOddPage or NextEvenPage.
  • In the sample, NextColumn, NextFrame and NextPage would give the same layout, so the PDF does not tell them apart. The converter writes NextPage.

One public template without an IDML has a style with code 4; with no reference, the converter leaves out codes other than 0 and 2.

Root styles and text defaults

The root paragraph style [No paragraph style] and the document's text defaults (TextDefault in Resources/Preferences.xml) take their values from attribute lists like other styles, but IDML leaves some of them out. Over the 489 trustworthy pairs (measurement.md):

Value IDML
NextStyle of the root paragraph style never (0 of 489)
AllNestedStyles of the root paragraph style never (0 of 489)
AllNestedStyles of TextDefault only when the list has items: absent in 485, written in the 4 with items
Empty TabList of the root paragraph style DOM 8 on: 482 of 482; DOM 7: 0 of 7
TabList of TextDefault DOM 8 on: in 482 of 482 (459 empty); DOM 7: 0 of 7

The converter leaves out these values accordingly; it writes a non-empty TabList in any version.

Paragraph borders and shading: corners and origins

ID IDML Styles with both (other than the root)
0x1DF12 ParagraphShadingTopLeftCornerRadius 452 (126)
0x1DF14 ParagraphShadingBottomLeftCornerRadius 452 (126)

On every style other than the root the ID is present exactly when the IDML style has the attribute, and every value matches. The two are told apart by 8 styles (4.5 against 0).

Tied groups. The IDs of each group below have the same value in every style, so which ID belongs to which attribute is not known. The converter writes a group only when all its IDs are present and equal:

IDs IDML Styles
0x1DF0A–0x1DF0D the four ParagraphBorder…CornerRadius 446 (120)
0x1DF13, 0x1DF15 ParagraphShadingTopRightCornerRadius, ParagraphShadingBottomRightCornerRadius 444 (118)
0x1DF0E, 0x1DF10 ParagraphShadingTopLeftCornerOption, ParagraphShadingBottomLeftCornerOption 339 (13)
0x1DF0F, 0x1DF11 ParagraphShadingTopRightCornerOption, ParagraphShadingBottomRightCornerOption 331 (5)

The shading corner option codes are 0 None, 0x5A15 RoundedCorner and 0x5A18 BevelCorner.

Origins. The two IDs of each pair always change together; the converter writes a pair only for these combinations of codes:

IDs IDML Codes → values Styles
0x1BDD, 0x1BDE ParagraphShadingTopOrigin, ParagraphShadingBottomOrigin 0, 0 → AscentTopOrigin, DescentBottomOrigin; 3, 2 → EmBoxTopOrigin, EmBoxBottomOrigin; 1, 1 → BaselineTopOrigin, BaselineBottomOrigin 378, 14, 4
0x1DF18, 0x1DF19 ParagraphBorderTopOrigin, ParagraphBorderBottomOrigin 0, 0 → AscentTopOrigin, DescentBottomOrigin; 3, 2 → EmBoxTopOrigin, EmBoxBottomOrigin 325, 13

Attributes whose value never varies in the corpus cannot be located this way. The converter writes the root styles' values for them from IDML observation (idml-values.md); styles and ranges inherit them. These include KeepFirstLines, KeepLastLines, KeepAllLinesTogether, KeepWithNext, KeepWithPrevious, Skew, StrikeThru, LastLineIndent, RuleAbove, RuleAboveColor, the RuleBelow indents and width, and the hyphenation and word-spacing settings other than those in the table. Some attributes vary but cannot be told apart from another attribute, because both always have the same value or appear in the same styles:

  • left and right shading offsets, left and right border offsets, and the four border line weights (equal in every sample);
  • KeepRuleAboveInFrame and RuleAboveType (always set together, with other attributes, in one pair);
  • TreatIdeographicSpaceAsSpace and DiacriticPosition.

OTFFigureStyle code 3 and ParagraphBreakType code 2 occur only in a sample without IDML; the converter leaves them out.

Font family names. AppliedFont and BulletsFont name a font family (class 0x3E03), and IDML writes the family's name. See fonts.md.