# Preferences Document preferences are chunks of the preferences object (class 0x2202, one per document). The converter reads them in `src/model/prefs.rs` and writes them to `Resources/Preferences.xml` and `designmap.xml`. Values it does not read stay as observed (`idml-values.md`). **Evidence.** Each field was compared with the IDML of every corpus pair (654 pairs, 495 of them trustworthy; `docs/measurement.md`). The counts below are pairs whose IDML has the value the field gives. Where a pair disagrees, it is a stale pair unless stated. The layouts are those of InDesign 7 (CS5) to 21, the versions the pairs show; the converter reads them for little-endian files of version 7 and later only. Booleans stored as a u16 are 0 (`false`) or 1 (`true`). Several of them are chunks that only some documents have; a document without the chunk has the value given as "absent". ## Colour settings (`Document` in designmap.xml) | Chunk | Layout | IDML | |---|---|---| | 0x7C44 (12 bytes) | Three four-character codes, each stored reversed. The first is `off ` in all 654 files. The second is the RGB policy, the third the CMYK policy | `RGBPolicy`, `CMYKPolicy` | | 0x7C04 | u16 0, u32 *n*, *n* UIDs of profile objects (class 0x7D03), u32 6, then 6 UIDs: the RGB working profile, the CMYK working profile, and four more | `RGBProfile`, `CMYKProfile` | | 0x7C08 (6 bytes) | u16 at 2: rendering intent | `SolidColorIntent`, `AfterBlendingIntent`, `DefaultImageIntent` | Policy codes (as read, reversed): `off ` `ColorPolicyOff`, `pres` `PreserveEmbeddedProfiles`, `pdil` `CombinationOfPreserveAndSafeCmyk`, `conv` `ConvertToWorkingSpace`. Both policies match in 495 of 495 trustworthy pairs and 654 of 654 pairs. A profile is the in-object string at offset 1 of chunk 0x13C of its 0x7D03 object (`U.S. Web Coated (SWOP) v2`, `sRGB IEC61966-2.1`, ...). UID 0 is written `$ID/`. Matches: RGB 495 of 495 trustworthy and 653 of 654 pairs, CMYK 495 of 495 and 654 of 654. The profile names are stored in the INDD, so they describe the document, not the computer that exported it. Intent codes: 11 `UseColorSettings` (136 files), 0 `Perceptual` (1 file), 2 `RelativeColorimetric` (1 file). The 516 files without the chunk all have `UseColorSettings`. In every file the three intents are equal, so the one code is written for all three. `AccurateLABSpots` is `false` in all 654 IDML files; no field for it was looked for. The converter writes `false`. ## View (`ViewPreference`) Chunk 0x1202 (56 bytes in all 654 files): | Offset | Type | Attribute | |---|---|---| | 0 | u32 unit | `HorizontalMeasurementUnits` | | 4 | u32 unit | `VerticalMeasurementUnits` | | 8 | u32 unit | `TypographicMeasurementUnits` | | 12 | u32 unit | `TextSizeMeasurementUnits` | | 16 | u32 unit | `PrintDialogMeasurementUnits` | | 20 | u32 unit | `LineMeasurementUnits` and `StrokeMeasurementUnits` | | 24 | f64 | `HorizontalCustomPoints` | | 32 | f64 | `VerticalCustomPoints` | | 40 | f64 | `CursorKeyIncrement` | | 48 | f64 | `PointsPerInch` | Unit codes: 0x1201 `Points`, 0x1202 `Picas`, 0x1203 `Inches`, 0x1205 `Millimeters`, 0x1206 `Centimeters`, 0x120B `Pixels`, 0x5101 `Ha`, 0x510F `Q`. Every field matches 495 of 495 trustworthy pairs; the horizontal, vertical, line and stroke units match 653 of 654 pairs (one stale pair differs). ## Flags in their own chunks | Chunk | Attribute | Absent | Matches (trustworthy, all) | |---|---|---|---| | 0x593 | `ViewPreference` `ShowFrameEdges` | `true` | 490 of 495, 649 of 654 | | 0x803 | `ViewPreference` `ShowRulers` | `true` | 493 of 495, 642 of 654 | | 0x56A | `GridPreference` `BaselineGridShown` | `false` | 495 of 495, 654 of 654 | | 0x569 | `GuidePreference` `GuidesLocked` | `false` | 495 of 495, 654 of 654 | | 0x56B | `DocumentPreference` `ColumnGuideLocked` | `true` | 495 of 495, 654 of 654 | | 0xCAC7 | `TextPreference` `ShowInvisibles` | `false` | 495 of 495, 654 of 654 | Every file with the chunk matches. The mismatches are files without it whose IDML has the other value (5 and 12 files), so these two settings are stored somewhere else as well in some documents; that place is not known. ## Document setup (`DocumentPreference`) Chunk 0x533 (146 bytes) also holds the page size, facing pages, intent and page binding (`objects.md`, document preferences). Its bleed and slug offsets are rectangles in the order inside (left), top, outside (right), bottom: | Offset | Type | Attribute | |---|---|---| | 70, 78, 86, 94 | f64 | `DocumentBleedInsideOrLeftOffset`, `…TopOffset`, `…OutsideOrRightOffset`, `…BottomOffset` | | 102 | u8 | `DocumentBleedUniformSize` | | 104, 112, 120, 128 | f64 | `SlugInsideOrLeftOffset`, `SlugTopOffset`, `SlugRightOrOutsideOffset`, `SlugBottomOffset` | | 136 | u8 | `DocumentSlugUniformSize` | In the 645 files with the 146-byte chunk, 42 have bleeds that are not all equal. The inside and outside bleeds match only at 70 and 86 (645 of 645 files but one stale pair), and the slugs: inside only at 104, bottom only at 128. No sample has top and bottom bleeds that differ, or top and outside slugs that differ; the order of those pairs follows the order the other fields show. Uniform flags: 645 of 645 files (`DocumentBleedUniformSize` false in 42, `DocumentSlugUniformSize` true in 3). ## Grids (`GridPreference`) Chunk 0x55F (36 bytes in all 654 files): f64 at 2 `BaselineDivision`, f64 at 10 `BaselineStart`, f64 at 18 the view threshold as a fraction (`BaselineViewThreshold` is it times 100). 654 of 654 pairs each. Chunk 0x545 (16 files): f64 at 8 `HorizontalGridlineDivision`, u32 at 16 `HorizontalGridSubdivision`, f64 at 20 `VerticalGridlineDivision`, u32 at 28 `VerticalGridSubdivision`; 16 of 16. Of the 638 files without it, 627 have 72 and 8 for both directions, which the converter writes; 11 have other values stored elsewhere. ## Watermark (`WatermarkPreference` in designmap.xml) Chunk 0x16344 (621 files): from offset 10, the font family and the font style, each a u32 length in code units followed by text segments, then u32 point size and u32 UID of an interface colour (`objects.md`, interface colours), written as `WatermarkFontColor`. Family, style and size match 621 of 621. The 33 files without the chunk are left with the observed values only. ## Text defaults (`TextDefault`) Chunk 0x23F of the preferences object is a text attribute list in the layout of a style's list (u16 count, then records; `attributes.md`). The converter writes it as `TextDefault` with the same attribute table as styles. Over all pairs this reproduces 182,742 of 196,543 `TextDefault` values, against 159,982 from the observed values alone; no attribute reproduced before is lost. As for paragraph styles, `KerningValue` is left out: the schema does not allow it there. ## Text (`TextPreference`, `TextFramePreference`) Chunk 0x280 (174 bytes in InDesign 7, 212 in 8 to 14, 214 from 15): | Offset | Type | Attribute | |---|---|---| | 0 | f64 | `SmallCap` | | 8, 16 | f64 | `SuperscriptSize`, `SubscriptSize` | | 24, 32 | f64 | `SuperscriptPosition`, `SubscriptPosition` | | 40 | f64 | `TextFramePreference` `TextColumnGutter` | | 88 | f64 | `LeadingKeyIncrement` | | 96 | f64 | `BaselineShiftKeyIncrement` | | 104 | f64 | `KerningKeyIncrement` divided by 1000 | | 112 | u32 | `TextFramePreference` `TextColumnCount` | | 118 | u8 | `TypographersQuotes` | | 130 | u8 | `LinkTextFilesWhenImporting` | | 142 | u8 | `TextFramePreference` `FirstBaselineOffset`: 0 `LeadingOffset`, 1 `AscentOffset`, 2 `CapHeight`, 3 `EmboxHeight`, 4 `XHeight` | | 162 | u8 | `UseParagraphLeading` | | 184 | u8 | `QuoteCharactersRotatedInVertical` (212 bytes and more) | | 212 | u8 | `ShapeIndicAndLatinWithHarbuzz` (214 bytes) | Each matches all 654 pairs that have the attribute (288 for the last, 645 for the one before), and the two positions match each other's attribute too, except where the files show different values: positions differ in 2 files, which tells 24 from 32; the sizes are equal in every file, so 8 and 16 follow the order of the positions. Offsets 168 and 170 match both `UseCidMojikumi` and `UseNewVerticalScaling`, which are equal in every file; they are not written. Chunk 0x28BE (14 bytes, 16 from InDesign 18), u8 flags: 4 `SmartTextReflow`, 6 `LimitToMasterTextFrames`, 8 `DeleteEmptyPages`, 10 `PreserveFacingPageSpreads`, 12 `SmartTextReflowSync` (16 bytes). 620 of 620 files with the chunk (283 of 283 for the last). The 34 files without it have `SmartTextReflow="false"` and `LimitToMasterTextFrames="true"`. Chunk 0x3768 (4 bytes), u8 at 2: `ZOrderTextWrap`; 654 of 654. ## Margins and columns of new pages (`MarginPreference`) Chunk 0x550: f64 `Left`, `Top`, `Right`, `Bottom` at 0, 8, 16, 24 (528 of 528 files). The 126 files without it have 36 for all four. Chunk 0x555: u32 `ColumnCount` at 0, f64 `ColumnGutter` at 4 (119 of 119). Without it, `ColumnCount` is 1 (535 of 535) and `ColumnGutter` 12 (526 of 535; 9 files have another gutter stored elsewhere). ## Anchored objects (`AnchoredObjectSetting`) Chunk 0x2800, as anchors and object styles have (`objects.md`): 527 files. `VerticalAlignment` and the two groups of fields described there match 527 of 527. The 127 files without the chunk have `VerticalAlignment="TopAlign"`. ## Pasteboard (`PasteboardPreference`) Chunk 0x5D2: f64 horizontal and vertical margin at 0 and 8, written as `PasteboardMargins`; the vertical one is also `MinimumSpaceAboveAndBelow`. 130 of 130 files with the chunk; the 524 without it have `-1 72` and 72, except one stale pair. Four u32 UIDs of interface colours follow; the IDML colours (`LightGray`, `GridBlue`) are not in the table of `objects.md`, so they are not written. ## Default XML tags (`XMLPreference`) Chunk 0xBF4F: five entries, each a name (u32 length, text segments) and the u32 UID of an interface colour: the story, table, untagged (`[None]`, not in IDML), cell and image tags. `DefaultStoryTagName`, `DefaultTableTagName`, `DefaultCellTagName` and `DefaultImageTagName` match 654 of 654; the names are in the language of the InDesign that made the document (`Story`, `Article`, `Textabschnitt`, ...). The colours are written as `Default…TagColor`. ## Grids in back Chunk 0x567 (u16, 53 files): `GridPreference` `GridsInBack`; 53 of 53. The 601 files without it have `true`. ## Page item defaults (`PageItemDefault`, `FrameFittingOption`) The object of class 0x6E07 has a chunk 0x6E07: u32, u32, u32 *n*, *n* 12-byte entries, then a page item attribute list (u32 count, records; `attributes.md`), then u32, u32, u32 *m* and *m* entries of the same layout. An entry is u32 class, u32 UID, u32 UID. In every sample the first table has entries for classes 0x1F05 (colour), 0x5503 (gradient), 0x5533, 0x6E0B (`None`) and 0x6E11. The entries name the unnamed colours and gradients that IDML writes though nothing refers to them (`objects.md`, colours). The list has the attribute IDs of page items. Written with the page item attribute table, it gives `PageItemDefault` `StrokeWeight` in 628 of 628 files in which an analysis script found the list; over all pairs the converter reproduces `StrokeWeight`, `CornerRadius` and `MiterLimit` of every file, and the frame fitting attributes of the list are written to the preference `FrameFittingOption`. ## Print settings (`PrintPreference`, `PrintBookletPrintPreference`) Chunk 0xA4C holds the print settings and chunk 0xAF2 those of booklet printing, in the same layout. Its start, in order (a "string" is a flag byte, 1 for a built-in key, then an in-object string): | Field | IDML | |---|---| | u8 1 if a print record follows, u8, u32 length *n*, *n* bytes | `PrintRecord`: `$ID/` and the bytes in base64, 76 characters per line, a line feed after every full line | | 6 bytes with a print record, 2 without | | | String | `ActivePrinterPreset`: built-in `kPrSt_DefaultName` is `Default`, built-in empty `Custom`, otherwise the name (string) | | u32 | `PrintTo`; `PrintToDisk` is `true` when it is 2 | | String | `Printer`: built-in `kPrepress File` is `PostscriptFile`, otherwise the name | | String | not identified (empty in every file) | | String | `PPD`: built-in `kDevice Independent` is `DeviceIndependent`, built-in empty the string `$ID/`, otherwise the name | | String | `PPDFile` (`$ID/` and the text for a built-in string) | | u32 | `PostScriptLevel`: 2 `Level2`, 3 `Level3` | | f64 | `PrintResolution` | | 4 f64 | `PaperSizeRect`: left, top, right, bottom | | 4 f64 | `ImageablePaperSizeRect`: left, top, right, bottom | | i32, then a string | `PaperSize`: −3 the string, −2 `DefinedByDriver`, −1 `Custom` | After that string, at these offsets from its end: f64 −1 at 0 and 24 (`PaperWidth` and `PaperHeight` are `Auto` in every file), f64 pairs at 8 and 32 (`PaperWidthRange`, `PaperHeightRange`), u16 at 84 (`PrintPageOrientation`: 0 `Portrait`, 1 `Landscape`), u32 at 104 (`Copies`), u8 at 118 (`PrintBlankPages`). The rest of the chunk (marks, bleeds, screening, colour output, scaling and the paper size selector) is not decoded. Evidence: every field above matches in all 654 pairs for both chunks, except `PPD` (653, one built-in key written as a string in IDML), `Printer` of booklets (653) and `PPDFile` of booklets (652). The paper rectangles are written as IDML writes them: with the digits of the shortest form that reads back, the last rounded half to even from the exact value (583.2000122070312, not …313).