[airmang]

Follow-up to #552 (#550).

Background

write_line_caches(doc) (experimental, opt-in) writes a paragraph's line layout cache only where it is exactly the one Hancom Office writes: Hancom takes a cache that is present as written, so a wrong one moves or squeezes text. Saved as .hwp, the cache is the paragraph's PARA_LINE_SEG, which some other HWP viewers need to place a picture on a paragraph of its own. #552 covered a plain picture alone in a paragraph spaced by a percentage, in a one-column section with no object text runs beside.

Change

write_line_caches now also writes the lines Hancom writes for:

• a picture alone in its paragraph (set as a character, no text)
  • with a caption: above or below it, the caption's lines and its gap join the line; beside it, the line stays as tall as the picture
  • with a soft edge or an inner shadow (they take no room)
  • in a paragraph spaced fixed, at least or between lines (spaced from the line's height, so a fixed spacing may be smaller than the picture), or setting its characters at the top, centre or bottom of the line
• several pictures and nothing else in a paragraph spaced by a percentage, none of them affecting the line spacing: as many on a line as fit the column, each picture eight characters along the line's text, each line as tall as its tallest picture
• newspaper columns of equal width: text and picture paragraphs laid out as wide as their column; where the columns change inside a section, as wide as the columns the paragraph is in (they were measured at the section's first columns' width)
• a section with an object text runs beside (square, tight or through wrapping): the pages other than the one holding that object's paragraph and the next one (the whole section was skipped). An object in a header or footer still leaves the section alone.

Left for Hancom: a picture whose glow, outer shadow or reflection takes room around it, a picture with a shadow written as a drawing's (hp:shadow), a caption whose lines are less sure, several pictures affecting the line spacing, balanced or parallel columns, and a picture paragraph holding spaces (viewers draw those without a cache). Tables set as a character and table cells keep getting caches in one column only.

Saving without calling write_line_caches is unchanged.

Tests

• Three Hancom-saved documents laid out from python-hwpx paragraphs without a cache, added to the comparison of every cache written with Hancom's:
  • line_cache_pictures_kinds.hwpx: captions on four sides, fixed / at least / between-lines spacing, top / centre / bottom alignment, a soft edge, an inner shadow, two rows of pictures; it ends with four pictures left for Hancom (long caption, glow, outer shadow, pictures affecting the spacing), which get no cache
  • line_cache_pictures_columns.hwpx: one column, then two columns from a paragraph inside the section
  • line_cache_pictures_beside.hwpx: a square-wrapped picture, picture and text paragraphs on its page and on later pages
• Unit tests for captions, spacings, several pictures, columns, balanced and parallel columns, the pages beside a wrapped object, and the effects left for Hancom.

🤖 Generated with Claude Code