Files
indd-utils/docs/format/attributes.md
T

42 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, 0x3E65 $ID/Metrics - Roman Only (27 styles) 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, 0x2079 HL Single Optyca, 0x2010 HL Composer J, 0x2011 HL Single J (runs/styles: 47/14, 0/30, 7/15) 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 0 TabularLining (23 runs, 5 styles), 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, 1 NextColumn, 2 NextPage, 3 NextFrame, 4 NextOddPage 78/78 styles; codes below
0x1B3C Position 0 Normal, 1 Superscript, 2 Subscript, 3 OTSuperscript, 4 OTSubscript, 5 OTNumerator, 6 OTDenominator (runs/styles: 107/23, 4/7, 1/0, 3/0, 21/0 for 1, 2, 3, 4, 6) 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, 2 NextPage (115 runs) 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, 3 FullyJustified, 4 LeftJustified, 5 CenterJustified, 6 RightJustified, 8 ToBindingSide, 9 AwayFromBindingSide (runs/styles for 3, 6, 8, 9: 34/1, 3/0, 2/1, 7/14) 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, 2 SplitColumns (69 runs, 10 styles) 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, 2 NumberedList (8 runs, 20 styles) 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
0x1A417 AppliedNumberingList (Properties) numbering list UID (objects.md, numbering lists) 519/519 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.

Later samples show the other codes in pairs: 1 NextColumn (1 style), 3 NextFrame (1 run) and 4 NextOddPage (1 style), with no run or style that contradicts them.

The new codes of the table were found by aligning INDD runs with IDML ranges at the same offset over 17,914 trustworthy stories and styles by name over all 654 pairs; no run or style contradicts them, and every value converted with a new code equals the IDML. (KerningMethod 79875 is $ID/Manual in IDML for 19 runs of 3 documents; that is not decoded.)

More paragraph and character attributes

Found by aligning styles by name over all pairs and runs with IDML ranges at the same offset (17,914 trustworthy stories). On styles other than the root styles, each ID is present exactly when the IDML style has the attribute, and every value matches. "Styles" counts the styles that have both, other than the root styles in brackets.

Encodings: bool = u16, 1 true; pct = f64 fraction, written × 100; num = f64 or u32 as is; swatch = u32 swatch UID, 0 = Text Color; stroke type = 8 bytes, u32 0 (a built-in style) then the stroke style code (StrokeStyle/$ID/ and the name of the code, as for page items). A code not listed leaves the attribute out.

ID IDML Encoding Styles
0x1B14 HyphenateLadderLimit num 780 (285)
0x1B68 HyphenateLastWord bool 760 (265)
0x1B85 HyphenateAcrossColumns bool 751 (256)
0x1B22 HyphenateCapitalizedWords bool 709 (214)
0x1B34 MaximumGlyphScaling pct 709 (214)
0x1B35 MinimumGlyphScaling pct 709 (214)
0x1B20 HyphenateAfterFirst num 651 (156)
0x1B23 HyphenateWordsLongerThan num 636 (141)
0x1B39 KeepWithNext num 619 (124)
0x1B2D DesiredWordSpacing pct 587 (92)
0x1B21 HyphenateBeforeLast num 580 (85)
0x1B30 DesiredLetterSpacing pct 559 (64)
0x1B38 KeepAllLinesTogether bool 556 (61)
0x1B3E CharacterAlignment 0 AlignBaseline, 1 AlignEmCenter, 2 AlignEmBottom 551 (56)
0x1B4C RuleAboveColor (Properties) swatch 546 (51)
0x1B5C RuleAbove bool 541 (46)
0x1B83 HyphenWeight num 541 (46)
0x1B71 RuleAboveType (Properties) stroke type 520 (25)
0x1B95 UnderlineType (Properties) stroke type 541 (46)
0x1B72 RuleBelowType (Properties) stroke type 505 (10)
0x1B9D StrikeThroughType (Properties) stroke type 499 (4)
0x1A40B NumberingFormat (Properties, string) u32: 0x1A477 1, 2, 3, 4..., 0x1A479 i, ii, iii, iv..., 0x1A47A A, B, C, D..., 0x1A47B a, b, c, d..., 0x1A497 01,02,03..., 0 None 531 (36)
0x1B73 BalanceRaggedLines (Properties, enumeration) 0 NoBalancing, 1 VeeShape 528 (33)
0x1A422 NumberingAlignment 0 LeftAlign, 2 RightAlign 527 (32)
0x1A421 BulletsAlignment 0 LeftAlign, 1 CenterAlign, 2 RightAlign 505 (10)
0x1B4E RuleAboveTint num (−1 kept) 526 (31)
0x50F29 ParagraphDirection 0 LeftToRightDirection, 1 RightToLeftDirection 526 (31)
0x50F2A ParagraphJustification 0 DefaultJustification, 6 NaskhKashidaJustificationFrac 495 roots (4 with 6)
0x50F1F CharacterDirection 0 DefaultDirection, 1 LeftToRightDirection, 2 RightToLeftDirection 518 (23)
0x50F11 DigitsType 0 DefaultDigits, 2 HindiDigits 499 (4)
0x1A418 NumberingLevel num 525 (30)
0x1A424 BulletsTextAfter flagged string (as NumberingExpression) 512 (17)
0x1A41D NumberingApplyRestartPolicy bool 497 (2)
0x1BB8 StrokeAlignment 0 CenterAlignment, 2 OutsideAlignment 523 (28)
0x4297 LeadingModel 0 LeadingModelRoman, 1 LeadingModelAkiBelow, 2 LeadingModelAkiAbove, 3 LeadingModelCenter 523 (28)
0x1BC1 KeepWithPrevious bool 522 (27)
0x1B93 UnderlineTint num 519 (24)
0x1B8E UnderlineGapColor (Properties) swatch 518 (23)
0x1B77 RuleAboveGapColor (Properties) swatch 506 (11)
0x1B96 StrikeThroughColor (Properties) swatch 502 (7)
0x426C Rensuuji bool 518 (23)
0x4295 OTFProportionalMetrics bool 516 (21)
0x1B57 RuleBelowLeftIndent num 513 (18)
0x1B58 RuleBelowRightIndent num 504 (9)
0x1B59 RuleBelowWidth 1 ColumnWidth, 2 TextWidth 507 (12)
0x1B86 KeepRuleAboveInFrame bool 512 (17)
0x1B6F OTFTitling bool 508 (13)
0x1B6E OTFDiscretionaryLigature bool 501 (6)
0x1BCA OTFSwash bool 501 (6)
0x1B89 OTFStylisticSets num 501 (6)
0x1B44 OverprintFill bool 506 (11)
0x1B92 UnderlineOverprint bool 506 (11)
0x1B8F UnderlineGapOverprint bool 500 (5)
0x1B3D StrikeThru bool 505 (10)
0x1B9A StrikeThroughOffset num (−9999 kept) 501 (6)
0x1B9E StrikeThroughWeight num (−9999 kept) 499 (4)
0x1B9C StrikeThroughTint num 497 (2)
0x1B78 RuleAboveGapTint num 496 (1)
0x1B4B Skew num 500 (5)
0x1B65 LastLineIndent num 497 (2)
0x1B81 PositionalForm 0 None, 1 Calculate, 2 Initial 500 (5)
0x1B87 IgnoreEdgeAlignment bool 498 (3)
0x42AD GlyphForm 0 None, 5 MonospacedHalfWidthForm, 9 ProportionalWidthForm, 10 FullWidthForm 501 (6)
0x4222 LeadingAki num (−1 kept) 502 (7)
0x4223 TrailingAki num 504 (9)
0x4225 KinsokuType 0 KinsokuPushInFirst, 2 KinsokuPushOutOnly, 3 KinsokuPrioritizeAdjustmentAmount 502 (7)
0x4226 KinsokuHangType 0 None, 2 KinsokuHangForce 498 (3)
0x4227 BunriKinshi bool 499 (4)
0x421D Tsume num 499 (4)
0x42A6 CjkGridTracking bool 497 (2)
0x422C RubyOpenTypePro bool 505 (10)
0x422F RubyFontSize num 500 (5)
0x4248 KentenFontSize num 500 (5)
0x4232 RubyType 0 GroupRuby, 1 PerCharacterRuby 497 (2)
0x4247 KentenKind 0 None, 1 KentenSesameDot 496 (1)
0x1DF1F MergeConsecutiveParaBorders bool 347
0x1DF1A ParagraphBorderTopLineWeight num 393 (67)
0x1DF1B ParagraphBorderBottomLineWeight num 395 (69)
0x1DF1C ParagraphBorderLeftLineWeight num 387 (61)
0x1DF1D ParagraphBorderRightLineWeight num 387 (61)
0x1DF01 ParagraphBorderLeftOffset num 348 (22)
0x1DF02 ParagraphBorderRightOffset num 347 (21)
0x1BF7 ParagraphBorderTint num 336 (10)
0x1DF16 ParagraphBorderStrokeEndCap 0 ButtEndCap, 1 RoundEndCap 339 (13)
0x1DF17 ParagraphBorderWidth 0 ColumnWidth, 1 TextWidth 328 (2)
0x1DF20 ProviderHyphenationStyle 0 HyphAll, 3 HyphPreferredAesthetic 327 (1)
0x1BD9 ParagraphShadingLeftOffset num 406 (26)
0x1BDA ParagraphShadingRightOffset num 406 (26)
0x1BD5 ParagraphShadingWidth 0 ColumnWidth, 1 TextWidth 386 (6)
0x1BD7 ParagraphShadingClipToFrame bool 388 (8)

MergeConsecutiveParaBorders is in IDML from version 13.1 (in none of the 3 trustworthy pairs of version 13.0, in all 46 of 13.1); the converter writes it from 13.1.

Evidence over the converter's output (trustworthy pairs): 121,196 values of these attributes in paragraph and character styles, text defaults and text ranges; 120,409 reproduced, 3 wrong (TextDefault DesiredLetterSpacing, DesiredWordSpacing and UnderlineType in one document each), the rest in stories whose text differs.

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.