SmartArt: ECMA-376 пресет-геометрия вместо калиброванных коэффициентов #33

Merged
pjandro merged 1 commits from smartart-preset-geometry into main 2026-10-24 00:28:05 +03:00
6 changed files with 21562 additions and 247 deletions
Showing only changes of commit 037474cf5b - Show all commits
+7 -6
View File
@@ -28,7 +28,7 @@
### Chart-движок (`internal/chart`, package-private кроме `DrawingPreRenderer.run`) ### Chart-движок (`internal/chart`, package-private кроме `DrawingPreRenderer.run`)
Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр × `DPI/72`, размеры — в пунктах, EMU→pt `cx/12700.0`). `ChartSpec.parse` (`enum Type`: PIE/PIE3D/DOUGHNUT/BAR/BAR_HORIZONTAL/LINE/AREA/SURFACE3D/UNSUPPORTED; пустой `c:title` + `autoTitleDeleted="0"` → у **круговых** имя первого ряда, у прочих — `AUTO_TITLE = "Название диаграммы"` (русская замена англ. плейсхолдеру Word); палитра `accent1..6` темы, легенда по умолчанию снизу, позиция `t` поддержана, `overlay` → место не резервируется) → `ChartRenderer` (осевые «круглые» шаги `niceUnit` 1/2/5·10ⁿ как Word) → пейнтеры `CartesianPainter`/`PiePainter` (`DEPTH_RATIO=0.22`, `TILT_CORRECTION=0.95`, `FIT_MARGIN=0.865`)/`Surface3dPainter` (калибровка по эталону Word 300 dpi: `CAMERA_DISTANCE=2.36`, `DEPTH_RATIO=0.705`, `HEIGHT_RATIO=0.664`, `GUTTER_LEFT/RIGHT=0.1485`, `GUTTER_TOP=0.116`, `GUTTER_BOTTOM=0.146`, свет `LIGHT_X/Y/Z=0.83/0.48/0.28`); `SmartArtRenderer` рисует кэш разложенной схемы (relationship `…/office/2007/relationships/diagramDrawing`, фактически `word/diagrams/drawing1.xml`; fit-scale ×0.80); палитра темы — `DrawMlColor` (instance; без ThemePart — дефолтная Office-палитра `accent1=4472C4`…); текст — `DrawMlText`; утилиты `RgbHsl`, `PrstGeomShapes`. Калибровочные константы менять только вместе с `Surface3dPainterTest`/`PiePainterTest`. Обход `pkg.getParts()` — только по **снимку** списка (`createImagePart` мутирует реестр → CME); rels частей — `part.getRelationshipsPart()`, НЕ `getOwningRelationshipPart()` (это rels ссылающегося); обход XML обязан раскрывать `JAXBElement`. Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр × `DPI/72`, размеры — в пунктах, EMU→pt `cx/12700.0`). `ChartSpec.parse` (`enum Type`: PIE/PIE3D/DOUGHNUT/BAR/BAR_HORIZONTAL/LINE/AREA/SURFACE3D/UNSUPPORTED; пустой `c:title` + `autoTitleDeleted="0"` → у **круговых** имя первого ряда, у прочих — `AUTO_TITLE = "Название диаграммы"` (русская замена англ. плейсхолдеру Word); палитра `accent1..6` темы, легенда по умолчанию снизу, позиция `t` поддержана, `overlay` → место не резервируется) → `ChartRenderer` (осевые «круглые» шаги `niceUnit` 1/2/5·10ⁿ как Word) → пейнтеры `CartesianPainter`/`PiePainter` (`DEPTH_RATIO=0.22`, `TILT_CORRECTION=0.95`, `FIT_MARGIN=0.865`)/`Surface3dPainter` (калибровка по эталону Word 300 dpi: `CAMERA_DISTANCE=2.36`, `DEPTH_RATIO=0.705`, `HEIGHT_RATIO=0.664`, `GUTTER_LEFT/RIGHT=0.1485`, `GUTTER_TOP=0.116`, `GUTTER_BOTTOM=0.146`, свет `LIGHT_X/Y/Z=0.83/0.48/0.28`); `SmartArtRenderer` рисует кэш разложенной схемы (relationship `…/office/2007/relationships/diagramDrawing`, фактически `word/diagrams/drawing1.xml`; fit-scale ×0.80), формы строит `PresetGeometry` — ECMA-пресет-геометрия `a:prstGeom`: avLst/gdLst/pathLst семи пресетов (rect, roundRect, ellipse, gear6, gear9, circularArrow, leftCircularArrow) дословно из `presetShapeDefinitions.xml`, вычислитель префиксных формул; оператор `?:` = «if x > 0 then y else z» (ISO/IEC 29500-1, НЕ x != 0), углы в Arc2D передавать со знаком минус (математическая конвенция y вверх), неизвестный пресет → прямоугольник ячейки (синхрон таблицы со стандартом пинит `PresetGeometryTest#tableMatchesEcmaXml`); палитра темы — `DrawMlColor` (instance; без ThemePart — дефолтная Office-палитра `accent1=4472C4`…); текст — `DrawMlText`; утилиты `RgbHsl`. Калибровочные константы менять только вместе с `Surface3dPainterTest`/`PiePainterTest`. Обход `pkg.getParts()` — только по **снимку** списка (`createImagePart` мутирует реестр → CME); rels частей — `part.getRelationshipsPart()`, НЕ `getOwningRelationshipPart()` (это rels ссылающегося); обход XML обязан раскрывать `JAXBElement`.
### Критические инварианты (нарушение = битый вывод) ### Критические инварианты (нарушение = битый вывод)
@@ -37,7 +37,7 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр
- FOP — форк `org.docx4j:docx4j-fo-renderer*` 2.11-docx4j.6 (транзитив от `docx4j-export-fo` 17.3.2, в pom не пинится; пакеты `org.apache.fop.*`). `Fop.Renderers.getRenderer()` возвращает **список** (рендер выбирается по mime `application/pdf`). `docx2fo.xslt` в репозитории нет — он в jar `docx4j-export-fo`. - FOP — форк `org.docx4j:docx4j-fo-renderer*` 2.11-docx4j.6 (транзитив от `docx4j-export-fo` 17.3.2, в pom не пинится; пакеты `org.apache.fop.*`). `Fop.Renderers.getRenderer()` возвращает **список** (рендер выбирается по mime `application/pdf`). `docx2fo.xslt` в репозитории нет — он в jar `docx4j-export-fo`.
- Страницы в валидаторе = `max(кэш docProps/app.xml, явные разрывы, lastRenderedPageBreak+1)`; explicit = межсекционные `sectPr` в body + `w:br type="page"` + `pageBreakBefore` (включая таблицы и `w:sdt`). Единственный путь — lightweight (StAX по zip, secure-ридер без DTD/external entities; JAXB-обход удалён — `WordPdfValidator` не зависит от docx4j): атрибуты — по локальному имени (`attrLocal`, не по transitional-URI: иначе в strict-документе `w:br type="page"` не засчитываются); `sectPr` внутри `pPr` не считает, последнюю body-direct секцию не считает, `continuous`-секции не считает, в колонтитулах — только `w:br type="page"`, `pageBreakBefore` — только внутри `pPr` вне `sectPr` (truthy-значения `val`: `null|true|1|on`); на не-zip молчит — подпись проверяет вызывающий. Все отказы — `ValidationException`. - Страницы в валидаторе = `max(кэш docProps/app.xml, явные разрывы, lastRenderedPageBreak+1)`; explicit = межсекционные `sectPr` в body + `w:br type="page"` + `pageBreakBefore` (включая таблицы и `w:sdt`). Единственный путь — lightweight (StAX по zip, secure-ридер без DTD/external entities; JAXB-обход удалён — `WordPdfValidator` не зависит от docx4j): атрибуты — по локальному имени (`attrLocal`, не по transitional-URI: иначе в strict-документе `w:br type="page"` не засчитываются); `sectPr` внутри `pPr` не считает, последнюю body-direct секцию не считает, `continuous`-секции не считает, в колонтитулах — только `w:br type="page"`, `pageBreakBefore` — только внутри `pPr` вне `sectPr` (truthy-значения `val`: `null|true|1|on`); на не-zip молчит — подпись проверяет вызывающий. Все отказы — `ValidationException`.
- Известный остаток эталона: U+2188/U+218A — глифов нет в OFL-шрифтах бандла, остаются `.notdef` (GNU FreeSerif GPL — не добавляем намеренно). - Известный остаток эталона: U+2188/U+218A — глифов нет в OFL-шрифтах бандла, остаются `.notdef` (GNU FreeSerif GPL — не добавляем намеренно).
- Внимательно: комментарии в `WordPdfConverter`/`DocxOnOffNormalizer` говорят «docx4j 11.x» — устаревшее число, фактически 17.3.2 (описанное поведение верно); javadoc `PrstGeomShapes` gear «×0.92» vs код `×0.82`. - Внимательно: комментарии в `WordPdfConverter`/`DocxOnOffNormalizer` говорят «docx4j 11.x» — устаревшее число, фактически 17.3.2 (описанное поведение верно).
### Шрифты (30 TTF + 3 лицензии, SIL OFL, `wordpdf-core/src/main/resources/fonts/`) ### Шрифты (30 TTF + 3 лицензии, SIL OFL, `wordpdf-core/src/main/resources/fonts/`)
@@ -52,7 +52,8 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр
|`…/wordpdf/internal/`|6 байтовых нормализатора + `FopFallbackFonts` (классы `public` — вызываются из родительского пакета; публичные члены только `normalize`/`declare`; `OleObjectNormalizer` — многочастный, публичный `normalize(byte[], boolean)`, бросает `DrawingFoundException(OLE)`)| |`…/wordpdf/internal/`|6 байтовых нормализатора + `FopFallbackFonts` (классы `public` — вызываются из родительского пакета; публичные члены только `normalize`/`declare`; `OleObjectNormalizer` — многочастный, публичный `normalize(byte[], boolean)`, бросает `DrawingFoundException(OLE)`)|
|`…/wordpdf/internal/chart/`|11 классов Java2D-рендера диаграмм/SmartArt в PNG (public только `DrawingPreRenderer`)| |`…/wordpdf/internal/chart/`|11 классов Java2D-рендера диаграмм/SmartArt в PNG (public только `DrawingPreRenderer`)|
|`wordpdf-core/src/main/resources/fonts/`|30 TTF + 3 лицензии — бинарные фикстуры, часть jar| |`wordpdf-core/src/main/resources/fonts/`|30 TTF + 3 лицензии — бинарные фикстуры, часть jar|
|`wordpdf-core/src/test/resources/samples/`|12 закоммиченных `.docx`-фикстур (единственные фикстуры)| |`wordpdf-core/src/test/resources/samples/`|12 закоммиченных `.docx`-фикстур (единственные .docx-фикстуры)|
|`wordpdf-core/src/test/resources/geom/`|`presetShapeDefinitions.xml` — копия приложения ECMA-376, синхрон таблицы `PresetGeometry` (только в тестах, в jar не попадает)|
|`wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/`|REST API (10 классов): `WordPdfApplication` (единственный public), `ConvertController`, `ConversionService` (очередь), `ApiExceptionHandler`, `ApiKeyFilter`, `OpenApiConfig` (`@SecurityScheme` X-API-Key для springdoc) + 5 класса исключений| |`wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/`|REST API (10 классов): `WordPdfApplication` (единственный public), `ConvertController`, `ConversionService` (очередь), `ApiExceptionHandler`, `ApiKeyFilter`, `OpenApiConfig` (`@SecurityScheme` X-API-Key для springdoc) + 5 класса исключений|
|`wordpdf-web/src/`|SPA (React 19 + TS + Vite + Tailwind): `api.ts` (вся сеть), `components/` (App, ApiKeyGate, PdfPreview, StatusMessage, DropZone, Logo)| |`wordpdf-web/src/`|SPA (React 19 + TS + Vite + Tailwind): `api.ts` (вся сеть), `components/` (App, ApiKeyGate, PdfPreview, StatusMessage, DropZone, Logo)|
|корневые `Containerfile`, `compose.yml`, `compose.dev.yml`, `gateway/nginx.conf`|образ бэкенда (multi-stage maven:3.9-temurin-21 → temurin-**21-jre-alpine** (musl) — chart-движку нужен только модуль java.desktop (Graphics2D, он внутри JRE); fontconfig и системные шрифты рантайму не нужны — текст рисуется глифами fontbox, см. `fonts/GlyphFont` (проверено на musl-стенде без libfontconfig/`/etc/fonts`); HEALTHCHECK busybox `wget` (curl/apt не ставим), non-root uid 10001); compose app+web+gateway: web-образ со своим HEALTHCHECK (`wget /`), в обоих compose `depends_on web: condition: service_healthy`; прод-compose не в репо — его рендерит job `deploy` (лимиты запекаются из Variables); podman-специфика обоих compose: `x-podman.name_separator_compat` (docker-style имена), явные `healthcheck` app/web (дубли Containerfile-HEALTHCHECK — OCI-выгрузка его теряет; app-хелсчеки — `wget`, как в Containerfile), зафиксированная подсеть `10.113.0.0/24` gw `10.113.0.1` под резолвер aardvark-dns; два repo-стенда одновременно не поднять (общая подсеть)| |корневые `Containerfile`, `compose.yml`, `compose.dev.yml`, `gateway/nginx.conf`|образ бэкенда (multi-stage maven:3.9-temurin-21 → temurin-**21-jre-alpine** (musl) — chart-движку нужен только модуль java.desktop (Graphics2D, он внутри JRE); fontconfig и системные шрифты рантайму не нужны — текст рисуется глифами fontbox, см. `fonts/GlyphFont` (проверено на musl-стенде без libfontconfig/`/etc/fonts`); HEALTHCHECK busybox `wget` (curl/apt не ставим), non-root uid 10001); compose app+web+gateway: web-образ со своим HEALTHCHECK (`wget /`), в обоих compose `depends_on web: condition: service_healthy`; прод-compose не в репо — его рендерит job `deploy` (лимиты запекаются из Variables); podman-специфика обоих compose: `x-podman.name_separator_compat` (docker-style имена), явные `healthcheck` app/web (дубли Containerfile-HEALTHCHECK — OCI-выгрузка его теряет; app-хелсчеки — `wget`, как в Containerfile), зафиксированная подсеть `10.113.0.0/24` gw `10.113.0.1` под резолвер aardvark-dns; два repo-стенда одновременно не поднять (общая подсеть)|
@@ -153,13 +154,13 @@ SSH-пользователи/логины, ни хосты, ни директо
## Testing & QA ## Testing & QA
- Гейт `maven-pmd-plugin` 3.28.0 (PMD 7.17) на `verify` для обоих модулей, ruleset `pmd-ruleset.xml` (codestyle без opinionated-правил + unused-правила + XPath `LiteralFirstInEquals` — строковый литерал слева в `equals`/`equalsIgnoreCase`; `junit5TestPattern` разрешает underscore-имена регрессий; `includeTests=true` — тесты сканируются; `failurePriority` не задан — дефолт 2, т.е. нарушения priority ≤ 2 валят build, priority 3 — только WARNING в отчёт). Литералы в условиях `if` — только именованными константами (`AvoidLiteralsInIfCondition`), `null` вместо пустой коллекции запрещён (`ReturnEmptyCollectionRatherThanNull` — `GlyphCoverageNormalizer.split` возвращает пустой список). - Гейт `maven-pmd-plugin` 3.28.0 (PMD 7.17) на `verify` для обоих модулей, ruleset `pmd-ruleset.xml` (codestyle без opinionated-правил + unused-правила + XPath `LiteralFirstInEquals` — строковый литерал слева в `equals`/`equalsIgnoreCase`; `junit5TestPattern` разрешает underscore-имена регрессий; `includeTests=true` — тесты сканируются; `failurePriority` не задан — на практике `verify` валят нарушения любой приоритетности, проверено на priority 3–4: строки `[WARNING] PMD Failure` = BUILD FAILURE). Литералы в условиях `if` — только именованными константами (`AvoidLiteralsInIfCondition`; `else if`-ветки правило не проверяет, обычный вложенный `if` — проверяет; пустые `while` тоже валятся — `EmptyControlStatement`), `null` вместо пустой коллекции запрещён (`ReturnEmptyCollectionRatherThanNull` — `GlyphCoverageNormalizer.split` возвращает пустой список).
- 17 тестовых классов / 162 `@Test` (core 14/132, app 3/30). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true` в argLine; только `Assertions` (Mockito/AssertJ не использовать, несмотря на test-classpath Boot; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`); тестовые классы package-private, зеркалят main-пакеты; только `@Test` (+ единственный `@BeforeAll` — warm-up шрифтов в `GlyphCoverageNormalizerTest`). - 18 тестовых классов / 173 `@Test` (core 15/143, app 3/30). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true` в argLine; только `Assertions` (Mockito/AssertJ не использовать, несмотря на test-classpath Boot; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`); тестовые классы package-private, зеркалят main-пакеты; только `@Test` (+ единственный `@BeforeAll` — warm-up шрифтов в `GlyphCoverageNormalizerTest`).
- **PDF сравнивается текстом, не растеризацией**: PDFBox 3 (`Loader.loadPDF`) — `PDFTextStripper` для текста (пер-странично `setStartPage/setEndPage`), override `processTextPosition` для шрифта конкретного символа (`fontNameOf`), обход ресурсов страниц для встроенных шрифтов (`EAAAAA+Carlito-Bold`) и счётчика картинок (`imageCount`). Негативные маркеры — регрессии: `assertFalse(text.contains("#"))` (.notdef), `assertFalse(font.startsWith("Helvetica"))`. Текст нормализуется по пробелам (`norm`); в `tableImage_tableAndImage` — полное удаление пробелов (docx4j переносит слова в auto-fit таблицах). - **PDF сравнивается текстом, не растеризацией**: PDFBox 3 (`Loader.loadPDF`) — `PDFTextStripper` для текста (пер-странично `setStartPage/setEndPage`), override `processTextPosition` для шрифта конкретного символа (`fontNameOf`), обход ресурсов страниц для встроенных шрифтов (`EAAAAA+Carlito-Bold`) и счётчика картинок (`imageCount`). Негативные маркеры — регрессии: `assertFalse(text.contains("#"))` (.notdef), `assertFalse(font.startsWith("Helvetica"))`. Текст нормализуется по пробелам (`norm`); в `tableImage_tableAndImage` — полное удаление пробелов (docx4j переносит слова в auto-fit таблицах).
- Пиксели (BufferedImage) — только в unit-тестах chart-пейнтеров: безразмерные отношения к эталону Word, допуски `assertRatio` <0.06 (`PiePainterTest` аспект h/w=0.585) / <0.10 (`Surface3dPainterTest`, + `assertRange` ±6 pt для центров силуэта); пороги залитых px и перцентильные коридоры яркости. Эталонные замеры — по Word-экспорту 300 dpi (`develop/`, вне git). - Пиксели (BufferedImage) — только в unit-тестах chart-пейнтеров: безразмерные отношения к эталону Word, допуски `assertRatio` <0.06 (`PiePainterTest` аспект h/w=0.585) / <0.10 (`Surface3dPainterTest`, + `assertRange` ±6 pt для центров силуэта); пороги залитых px и перцентильные коридоры яркости. Эталонные замеры — по Word-экспорту 300 dpi (`develop/`, вне git).
- `GlyphFont` (fontbox): метрики пиксельно-метрически эквивалентны AWT (ascent/descent/leading/advance совпадают до 4-го знака, кернинг-дрейф 0.0000 — DejaVu Sans, Carlito). Приёмочный стенд без-fontconfig: контейнер без `libfontconfig.so.1*` и `/etc/fonts`, `mvn verify` + `java -jar` (до перехода на GlyphFont там падали `GlyphCoverageNormalizerTest` 12 / `CartesianPainterTest` 3 / `PiePainterTest` 2 / chart-тесты `WordPdfConverterTest` 4, chart-рендер молча деградировал). `GlyphFontTest` написан без единого `java.awt.Font` — обязан проходить на хосте без fontconfig. - `GlyphFont` (fontbox): метрики пиксельно-метрически эквивалентны AWT (ascent/descent/leading/advance совпадают до 4-го знака, кернинг-дрейф 0.0000 — DejaVu Sans, Carlito). Приёмочный стенд без-fontconfig: контейнер без `libfontconfig.so.1*` и `/etc/fonts`, `mvn verify` + `java -jar` (до перехода на GlyphFont там падали `GlyphCoverageNormalizerTest` 12 / `CartesianPainterTest` 3 / `PiePainterTest` 2 / chart-тесты `WordPdfConverterTest` 4, chart-рендер молча деградировал). `GlyphFontTest` написан без единого `java.awt.Font` — обязан проходить на хосте без fontconfig.
- Фикстуры — закоммиченные `samples/*.docx` (12; в тестах не генерировать): core грузит classpath-ресурсом → `byte[]`, PDF для PDFBox — временный файл; app читает `/samples/…` из **test-jar core** (classifier `tests`) → `mvn -pl wordpdf-app` без `-am` не соберётся. In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]`. Ключевые: `too-many-pages` (150 явных разрывов → 151), `stale-cache` (кэш `<Pages>1</Pages>` + 110 `lastRenderedPageBreak`), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject), `ole-embedded` (осиротевший bin с ложным `Default bin→footer+xml` + настоящий `w:object` с честным `Override → oleObject`; ручная, генератором не перезаписывать). - Фикстуры — закоммиченные `samples/*.docx` (12; в тестах не генерировать): core грузит classpath-ресурсом → `byte[]`, PDF для PDFBox — временный файл; app читает `/samples/…` из **test-jar core** (classifier `tests`) → `mvn -pl wordpdf-app` без `-am` не соберётся. In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]`. Ключевые: `too-many-pages` (150 явных разрывов → 151), `stale-cache` (кэш `<Pages>1</Pages>` + 110 `lastRenderedPageBreak`), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject), `ole-embedded` (осиротевший bin с ложным `Default bin→footer+xml` + настоящий `w:object` с честным `Override → oleObject`; ручная, генератором не перезаписывать).
- Юниты нормализаторов работают строками (`rewrite`) + zip'ами из `ZipOutputStream`; обязательные контракты: «нечего менять → тот же массив» (`assertSame` покрыт тестами только у zip-нормализаторов `DocxOnOff`/`SymbolFont`/`StrictOoxml` и у `OleObject` — `printerSettings`-bin/нет `.bin`; у `Field`/`GlyphCoverage` — `rewrite`→`null`) и неприкосновенность частей вне `word/*.xml` (`[Content_Types].xml`). Тесты бьют и в package-private API (`GlyphCoverageNormalizer.split(text, family)`, `ChartSpec.readTitle`). Исключение — `OleObjectNormalizerTest`: многочастный нормализатор без `rewrite`-хука, тесты только через `normalize` на in-memory zip. - Юниты нормализаторов работают строками (`rewrite`) + zip'ами из `ZipOutputStream`; обязательные контракты: «нечего менять → тот же массив» (`assertSame` покрыт тестами только у zip-нормализаторов `DocxOnOff`/`SymbolFont`/`StrictOoxml` и у `OleObject` — `printerSettings`-bin/нет `.bin`; у `Field`/`GlyphCoverage` — `rewrite`→`null`) и неприкосновенность частей вне `word/*.xml` (`[Content_Types].xml`). Тесты бьют и в package-private API (`GlyphCoverageNormalizer.split(text, family)`, `ChartSpec.readTitle`). Исключение — `OleObjectNormalizerTest`: многочастный нормализатор без `rewrite`-хука, тесты только через `normalize` на in-memory zip.
- App-тесты: `@SpringBootTest` + `@AutoConfigureMockMvc` (Boot 4: `org.springframework.boot.webmvc.test.autoconfigure`); три контекста — `ConvertControllerTest` (пустой ключ), `ApiKeyFilterTest` (`properties = "wordpdf.api-key=…"`), `ConvertLimitsTest` (`@TestPropertySource` с лимитами — отдельный класс, не `@Nested`). - App-тесты: `@SpringBootTest` + `@AutoConfigureMockMvc` (Boot 4: `org.springframework.boot.webmvc.test.autoconfigure`); три контекста — `ConvertControllerTest` (пустой ключ), `ApiKeyFilterTest` (`properties = "wordpdf.api-key=…"`), `ConvertLimitsTest` (`@TestPropertySource` с лимитами — отдельный класс, не `@Nested`).
- Регрессивные пары (фикс = нормализатор/pre-renderer + юнит + конвертер-тест с фикстурой): `StrictOoxmlNormalizerTest`↔`strictOoxml_convertsNotRejected` (+`pageCount_strictBreaksCountedLightweight` — lightweight против strict), `DocxOnOffNormalizerTest`↔`ruPlain_regularRunsUseRegularFont`, `SymbolFontNormalizerTest`↔`symbolFonts_bulletsAreNotHash`, `FieldNormalizerTest`↔`pageNumbers_recomputedNotCached`, `GlyphCoverageNormalizerTest`↔`exoticGlyphs_drawnNotHash`, `OleObjectNormalizerTest`↔`oleObjects_removedAndConverted`/`drawingErrors_errorFlagRejectsOle` (+app `errorFlagOle_rejected`/`oleObjects_removedByDefault`), `WordPdfValidatorTest`↔`staleCachePageCountRejectedBeforeRender` (+`checkPageCount_limitBoundary` 99/100/101, `pageCount_breaksInsideTablesAreCounted`, `pageCount_continuousSectionsNotCountedLightweight`, `validate_notAZip`↔`inputNotAZip_rejectedBeforeRender`, `validate_plainZipRejected`/`validate_xlsxRenamedRejected`/`validate_zipBombRejected`/`validate_tooManyEntriesRejected`↔`plainZipNotDocx_rejected`/`inputNotDocx_rejectedBeforeRender` — контейнер и zip-бомба), `BundledFontsTest`↔`ruPlain_emDashEmbeddedNotHelvetica`, `ChartSpecTest`↔автозаголовки, chart-пейнтеры↔`chartsSmartArt_drawingsBecomeImages` (+`drawingErrors_*`↔app `errorFlagCharts_rejected`/`errorFlagSmartArt_rejected`); `noLoggingWarningInPdf` — регрессия `slf4j-simple`, `pdfTitle_comesFromParameter` — регрессия PDF-title (юнит-партнёра нет). App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed` (гонка реестра `PhysicalFonts`), `corruptNotAZip_rejected`, `plainZipNotDocx_rejected` (голый zip без манифеста → 400), `junkInsideValidZip_conversionError` (500 на валидном .docx-контейнере с мусором), `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `drawingsAlwaysRendered`, `cyrillicAndPathInFilename_sanitizedResponseName` (RFC 5987 + path-traversal), `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey` (открытая документация + матч фильтра без forwarded-contextPath). - Регрессивные пары (фикс = нормализатор/pre-renderer + юнит + конвертер-тест с фикстурой): `StrictOoxmlNormalizerTest`↔`strictOoxml_convertsNotRejected` (+`pageCount_strictBreaksCountedLightweight` — lightweight против strict), `DocxOnOffNormalizerTest`↔`ruPlain_regularRunsUseRegularFont`, `SymbolFontNormalizerTest`↔`symbolFonts_bulletsAreNotHash`, `FieldNormalizerTest`↔`pageNumbers_recomputedNotCached`, `GlyphCoverageNormalizerTest`↔`exoticGlyphs_drawnNotHash`, `OleObjectNormalizerTest`↔`oleObjects_removedAndConverted`/`drawingErrors_errorFlagRejectsOle` (+app `errorFlagOle_rejected`/`oleObjects_removedByDefault`), `WordPdfValidatorTest`↔`staleCachePageCountRejectedBeforeRender` (+`checkPageCount_limitBoundary` 99/100/101, `pageCount_breaksInsideTablesAreCounted`, `pageCount_continuousSectionsNotCountedLightweight`, `validate_notAZip`↔`inputNotAZip_rejectedBeforeRender`, `validate_plainZipRejected`/`validate_xlsxRenamedRejected`/`validate_zipBombRejected`/`validate_tooManyEntriesRejected`↔`plainZipNotDocx_rejected`/`inputNotDocx_rejectedBeforeRender` — контейнер и zip-бомба), `BundledFontsTest`↔`ruPlain_emDashEmbeddedNotHelvetica`, `ChartSpecTest`↔автозаголовки, `PresetGeometryTest`↔`chartsSmartArt_drawingsBecomeImages` (`tableMatchesEcmaXml` — синхрон таблицы пресетов с ECMA XML; кольцевые стрелки — семантика `?:` и знаки дуг Arc2D), chart-пейнтеры↔`chartsSmartArt_drawingsBecomeImages` (+`drawingErrors_*`↔app `errorFlagCharts_rejected`/`errorFlagSmartArt_rejected`); `noLoggingWarningInPdf` — регрессия `slf4j-simple`, `pdfTitle_comesFromParameter` — регрессия PDF-title (юнит-партнёра нет). App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed` (гонка реестра `PhysicalFonts`), `corruptNotAZip_rejected`, `plainZipNotDocx_rejected` (голый zip без манифеста → 400), `junkInsideValidZip_conversionError` (500 на валидном .docx-контейнере с мусором), `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `drawingsAlwaysRendered`, `cyrillicAndPathInFilename_sanitizedResponseName` (RFC 5987 + path-traversal), `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey` (открытая документация + матч фильтра без forwarded-contextPath).
- UI-тестов нет; гейт SPA — `npm run build` (tsc -b) + `npm run lint` (oxlint, `.oxlintrc.json`: rules-of-hooks error, only-export-components warn). Прод-автотесты (pytest 9 + requests, 21 проверка, env-конфиг, `mise exec -- python -m pytest -q .` из `prod-autotests/`) гоняются CI после deploy против живого прода; `WORDPDF_API_KEY` пуст → честный SKIP `@needs_key`-проверок. - UI-тестов нет; гейт SPA — `npm run build` (tsc -b) + `npm run lint` (oxlint, `.oxlintrc.json`: rules-of-hooks error, only-export-components warn). Прод-автотесты (pytest 9 + requests, 21 проверка, env-конфиг, `mise exec -- python -m pytest -q .` из `prod-autotests/`) гоняются CI после deploy против живого прода; `WORDPDF_API_KEY` пуст → честный SKIP `@needs_key`-проверок.
File diff suppressed because it is too large Load Diff
@@ -1,183 +0,0 @@
package ru.pjandro.wordpdf.internal.chart;
import java.awt.geom.Area;
import java.awt.geom.Ellipse2D;
import java.awt.geom.Path2D;
import java.awt.geom.Rectangle2D;
import java.awt.geom.RoundRectangle2D;
/**
* Пресеты геометрии DrawingML (a:prstGeom) в объёме, который нужен
* SmartArt-схемам: прямоугольники, эллипсы, шестерни и круговые стрелки.
*
* Неизвестный пресет -> прямоугольник (вызывающий логирует подмену):
* для подписанной схемы это заметнее, чем пустое место.
*/
final class PrstGeomShapes {
/** Минимальный заметный дуге размах, градусы. */
private static final double MIN_ARC_SPAN_DEG = 1;
private PrstGeomShapes() {
}
/** Форма с необязательным отверстием (у шестерней — центральная втулка). */
record Shape(Area area, Area hole) {
Area filled() {
if (hole == null) {
return area;
}
Area a = new Area(area);
a.subtract(hole);
return a;
}
}
/**
* @param prst имя пресета из a:prstGeom/@prst
* @param adj целочисленные adjs из a:avLst (в стотысячных долях/градусах*60000)
*/
static Shape build(String prst, int[] adj, double x, double y, double w, double h) {
String p = prst == null ? "rect" : prst;
switch (p) {
case "rect" -> {
return new Shape(new Area(new Rectangle2D.Double(x, y, w, h)), null);
}
case "roundRect" -> {
double arc = Math.min(w, h) * 0.12;
return new Shape(new Area(new RoundRectangle2D.Double(x, y, w, h, arc, arc)), null);
}
case "ellipse", "oval" -> {
return new Shape(new Area(new Ellipse2D.Double(x, y, w, h)), null);
}
case "gear6", "gear9" -> {
int teeth = "gear6".equals(p) ? 6 : 9;
return gear(x, y, w, h, teeth);
}
case "circularArrow", "leftCircularArrow", "rightCircularArrow",
"curvedRightArrow", "curvedLeftArrow" -> {
return circularArrow(x, y, w, h, adj,
"leftCircularArrow".equals(p) || "curvedLeftArrow".equals(p));
}
default -> {
return new Shape(new Area(new Rectangle2D.Double(x, y, w, h)), null);
}
}
}
/**
* Шестерня: зубчатый венец + (опционально) центральное отверстие.
* Внешний радиус немного меньше w/2 (× 0.92), чтобы соседние
* шестерни в drawing1.xml не слипались там, где их ext-ы близко
* (Word использует тот же приём — эффективный радиус ≈ 0.97·ext/2).
* Зуб узкий и короткий, впадины — глубокие.
*/
private static Shape gear(double x, double y, double w, double h, int teeth) {
double cx = x + w / 2.0;
double cy = y + h / 2.0;
double r = Math.min(w, h) / 2.0 * 0.82;
double toothH = r * 0.18;
double body = r - toothH;
Path2D path = new Path2D.Double();
double step = 2 * Math.PI / teeth;
// зуб: основание -> подъём -> вершина (плоская) -> спуск
double toothWidth = step * 0.30;
for (int i = 0; i < teeth; i++) {
double a = i * step;
double a0 = a - toothWidth;
double a1 = a + toothWidth;
double gap1 = a + step - toothWidth;
if (i == 0) {
path.moveTo(cx + body * Math.cos(a0), cy + body * Math.sin(a0));
} else {
path.lineTo(cx + body * Math.cos(a0), cy + body * Math.sin(a0));
}
path.lineTo(cx + r * Math.cos(a0 + toothWidth * 0.5),
cy + r * Math.sin(a0 + toothWidth * 0.5));
path.lineTo(cx + r * Math.cos(a1 - toothWidth * 0.5),
cy + r * Math.sin(a1 - toothWidth * 0.5));
path.lineTo(cx + body * Math.cos(a1), cy + body * Math.sin(a1));
// впадина: плоская дуга по body между зубьями
path.lineTo(cx + body * Math.cos(gap1), cy + body * Math.sin(gap1));
}
path.closePath();
return new Shape(new Area(path), null);
}
/**
* Круговая стрелка: сектор кольца + треугольный наконечник.
* adj2/adj3 — углы начала/конца в 1/60000 градуса (0 = на 3 часа,
* по часовой, т.к. y на экране растёт вниз).
*/
private static Shape circularArrow(double x, double y, double w, double h,
int[] adj, boolean arrowAtStart) {
double cx = x + w / 2.0;
double cy = y + h / 2.0;
double rOuter = Math.min(w, h) / 2.0 * 0.92;
// adj1 у реальных схем даёт невидимую полоску — держим минимум.
double thickness = Math.max(rOuter * pct(adj, 0, 40000), rOuter * 0.07);
double rInner = Math.max(1, rOuter - thickness);
double startDeg = deg(adj, 1, 2700000);
double endDeg = deg(adj, 2, 3600000);
if (Math.abs(endDeg - startDeg) < MIN_ARC_SPAN_DEG) {
endDeg = startDeg + 270;
}
double a0 = Math.toRadians(startDeg);
double a1 = Math.toRadians(endDeg);
if (a1 < a0) {
a1 += 2 * Math.PI;
}
Path2D path = new Path2D.Double();
arcSegment(path, cx, cy, rOuter, a0, a1);
arcSegment(path, cx, cy, rInner, a1, a0);
path.closePath();
Area area = new Area(path);
// Наконечник: размеры берём от толщины кольца — adjs у реальных
// схем (adj4/adj5) дают либо абсурдный угол, либо невидимый «усик».
// headOut ограничен, чтобы он не вылезал сильно за rOuter (иначе
// кольцо цепляется с шестерёнкой, центр которой совпадает со стрелкой).
double rMid = (rOuter + rInner) / 2.0;
double headOut = Math.min(thickness * 1.15, thickness * 2.0);
double tipAngle = arrowAtStart ? a0 - thickness * 1.7 / rMid : a1 + thickness * 1.7 / rMid;
double baseAngle = thickness * 0.9 / rMid;
double base = arrowAtStart ? a0 : a1;
Path2D head = new Path2D.Double();
head.moveTo(cx + (rOuter + headOut * 0.2) * Math.cos(base - Math.copySign(baseAngle, base - tipAngle)),
cy + (rOuter + headOut * 0.2) * Math.sin(base - Math.copySign(baseAngle, base - tipAngle)));
head.lineTo(cx + rMid * Math.cos(tipAngle), cy + rMid * Math.sin(tipAngle));
head.lineTo(cx + Math.max(1, rInner - headOut) * Math.cos(base - Math.copySign(baseAngle, base - tipAngle)),
cy + Math.max(1, rInner - headOut) * Math.sin(base - Math.copySign(baseAngle, base - tipAngle)));
head.closePath();
area.add(new Area(head));
return new Shape(area, null);
}
private static void arcSegment(Path2D path, double cx, double cy, double r,
double a0, double a1) {
int steps = Math.max(2, (int) (Math.abs(a1 - a0) / Math.toRadians(4)));
for (int i = 0; i <= steps; i++) {
double t = a0 + (a1 - a0) * i / steps;
double px = cx + r * Math.cos(t);
double py = cy + r * Math.sin(t);
if (i == 0 && (path.getCurrentPoint() == null
|| Math.abs(path.getCurrentPoint().getX() - px) > 1e-9
|| Math.abs(path.getCurrentPoint().getY() - py) > 1e-9)) {
path.moveTo(px, py);
} else {
path.lineTo(px, py);
}
}
}
private static double pct(int[] adj, int idx, int def) {
int v = adj != null && idx < adj.length ? adj[idx] : def;
return v / 100000.0;
}
private static double deg(int[] adj, int idx, int def) {
int v = adj != null && idx < adj.length ? adj[idx] : def;
return v / 60000.0;
}
}
@@ -1,6 +1,5 @@
package ru.pjandro.wordpdf.internal.chart; package ru.pjandro.wordpdf.internal.chart;
import org.docx4j.dml.CTGeomGuide;
import org.docx4j.dml.CTGradientFillProperties; import org.docx4j.dml.CTGradientFillProperties;
import org.docx4j.dml.CTGradientStop; import org.docx4j.dml.CTGradientStop;
import org.docx4j.dml.CTPoint2D; import org.docx4j.dml.CTPoint2D;
@@ -8,8 +7,11 @@ import org.docx4j.dml.CTPositiveSize2D;
import org.docx4j.dml.CTPresetGeometry2D; import org.docx4j.dml.CTPresetGeometry2D;
import org.docx4j.dml.CTShapeProperties; import org.docx4j.dml.CTShapeProperties;
import org.docx4j.dml.CTShapeStyle; import org.docx4j.dml.CTShapeStyle;
import org.docx4j.dml.CTTextBodyProperties;
import org.docx4j.dml.CTTextNormalAutofit;
import org.docx4j.dml.CTTransform2D; import org.docx4j.dml.CTTransform2D;
import org.docx4j.dml.diagram.CTCxn; import org.docx4j.dml.diagram.CTCxn;
import org.docx4j.dml.STTextAnchoringType;
import org.docx4j.dml.diagram.CTDataModel; import org.docx4j.dml.diagram.CTDataModel;
import org.docx4j.dml.diagram.STCxnType; import org.docx4j.dml.diagram.STCxnType;
import org.docx4j.dml.diagram.CTPt; import org.docx4j.dml.diagram.CTPt;
@@ -21,7 +23,6 @@ import java.awt.Color;
import java.awt.Graphics2D; import java.awt.Graphics2D;
import java.awt.RenderingHints; import java.awt.RenderingHints;
import java.awt.geom.AffineTransform; import java.awt.geom.AffineTransform;
import java.awt.geom.Area;
import java.awt.geom.Rectangle2D; import java.awt.geom.Rectangle2D;
import java.awt.image.BufferedImage; import java.awt.image.BufferedImage;
import java.util.ArrayList; import java.util.ArrayList;
@@ -45,6 +46,26 @@ final class SmartArtRenderer {
/** Порог «фигура повёрнута», градусы: меньше — поворот незначим. */ /** Порог «фигура повёрнута», градусы: меньше — поворот незначим. */
private static final double ROTATION_EPSILON_DEG = 0.01; private static final double ROTATION_EPSILON_DEG = 0.01;
/** Дефолтные insets bodyPr (ECMA-376 CT_TextBodyProperties), pt. */
private static final double DEFAULT_LR_INS_PT = 7.2;
private static final double DEFAULT_TB_INS_PT = 3.6;
/** EMU в пунктах (insets заданы в EMU). */
private static final double EMU_PER_PT = 12700.0;
/** fontScale/lnSpcReduction: 100000 = «атрибут не задан / 100%». */
private static final int NORM_AUTOFIT_FULL = 100000;
/** Значения выравнивания bodyPr/@anchor, отличные от дефолта. */
private static final String VALIGN_CTR = "ctr";
private static final String VALIGN_BOTTOM = "b";
private static final String ALIGN_LEFT = "l";
private static final String VALIGN_TOP = "t";
/** Минимальный ещё печатаемый размер текстового прямоугольника/кегля, pt. */
private static final double MIN_TEXT_BOX_PT = 0.5;
private static final double MIN_FONT_PT = 4.0;
/** Попыток подбора кегля в autosize. */
private static final int SHRINK_ATTEMPTS = 4;
private SmartArtRenderer() { private SmartArtRenderer() {
} }
@@ -99,10 +120,12 @@ final class SmartArtRenderer {
} }
double mw = Math.max(1e-6, maxX - minX); double mw = Math.max(1e-6, maxX - minX);
double mh = Math.max(1e-6, maxY - minY); double mh = Math.max(1e-6, maxY - minY);
// 0.80: drawing1.xml хранит ext-ы вплотную (gear6+gear6, // dsp-кэш: координаты EMU в проектном пространстве схемы; фрейм
// gear6+circularArrow с почти одним центром), при scale=0.96 // wp:extent — EMU. По MS-ODRAWXML «Diagram Layout» трансформа в
// они слипаются. 0.80 даёт зазор ~10% от ext — как в эталоне. // схеме нет; когда кэш свежий, он совпадает с фреймом 1:1. Для
double scale = Math.min(widthPt / mw, heightPt / mh) * 0.80; // устаревшего кэша (фрейм ресайзили после раскладки) — равномерный
// fit с центрированием, без коэффициентов.
double scale = Math.min(widthPt / mw, heightPt / mh);
double offX = (widthPt - mw * scale) / 2.0 - minX * scale; double offX = (widthPt - mw * scale) / 2.0 - minX * scale;
double offY = (heightPt - mh * scale) / 2.0 - minY * scale; double offY = (heightPt - mh * scale) / 2.0 - minY * scale;
@@ -180,16 +203,9 @@ final class SmartArtRenderer {
if (spPr != null && spPr.getPrstGeom() != null) { if (spPr != null && spPr.getPrstGeom() != null) {
CTPresetGeometry2D pg = spPr.getPrstGeom(); CTPresetGeometry2D pg = spPr.getPrstGeom();
prst = pg.getPrst() == null ? null : pg.getPrst().value(); prst = pg.getPrst() == null ? null : pg.getPrst().value();
if (pg.getAvLst() != null) { adj = PresetGeometry.adjustValues(pg);
List<CTGeomGuide> gd = pg.getAvLst().getGd();
adj = new int[gd.size()];
for (int i = 0; i < gd.size(); i++) {
adj[i] = parseGuide(gd.get(i).getFmla());
}
}
} }
PrstGeomShapes.Shape shape = PrstGeomShapes.build(prst, adj, x, y, sw, sh); java.awt.Shape area = PresetGeometry.build(prst, adj, x, y, sw, sh);
Area area = shape.filled();
Color fill = resolveFill(spPr, colors); Color fill = resolveFill(spPr, colors);
if (fill != null) { if (fill != null) {
@@ -233,6 +249,20 @@ final class SmartArtRenderer {
tw = txXfrm.getExt().getCx() / 12700.0 * scale; tw = txXfrm.getExt().getCx() / 12700.0 * scale;
th = txXfrm.getExt().getCy() / 12700.0 * scale; th = txXfrm.getExt().getCy() / 12700.0 * scale;
} }
CTTextBodyProperties bodyPr = sp.getTxBody() == null ? null : sp.getTxBody().getBodyPr();
if (bodyPr != null) {
double insL = inset(bodyPr.getLIns(), DEFAULT_LR_INS_PT) * scale;
double insR = inset(bodyPr.getRIns(), DEFAULT_LR_INS_PT) * scale;
double insT = inset(bodyPr.getTIns(), DEFAULT_TB_INS_PT) * scale;
double insB = inset(bodyPr.getBIns(), DEFAULT_TB_INS_PT) * scale;
tx += insL;
ty += insT;
tw -= insL + insR;
th -= insT + insB;
if (tw <= MIN_TEXT_BOX_PT || th <= MIN_TEXT_BOX_PT) {
return;
}
}
Color textColor = textColor(sp, colors); Color textColor = textColor(sp, colors);
List<DrawMlText.Paragraph> paragraphs = new ArrayList<>(); List<DrawMlText.Paragraph> paragraphs = new ArrayList<>();
@@ -251,38 +281,68 @@ final class SmartArtRenderer {
if (paragraphs.isEmpty()) { if (paragraphs.isEmpty()) {
return; return;
} }
// Шрифт из XML (sz=2600 → 26pt) слишком крупный для маленьких // autofit по CT_TextBodyProperties: noAutofit — текст по заявленным
// шестерёнок SmartArt: "123" лезет поверх зубьев. Ограничиваем // размерам (переполнение не ужимается, как в Word); normAutofit —
// начальный кегль ~25% меньшей стороны текстового прямоугольника. // fontScale/lnSpcReduction из XML, затем подбор кегля под прямоугольник.
double capPt = Math.max(4.0, Math.min(tw, th) * 0.25); double lineFactor = 1.0;
if (p0(paragraphs) > capPt) { boolean noAutofit = bodyPr != null && bodyPr.getNoAutofit() != null;
List<DrawMlText.Paragraph> shrunk = new ArrayList<>(); CTTextNormalAutofit na = bodyPr == null ? null : bodyPr.getNormAutofit();
for (DrawMlText.Paragraph p : paragraphs) { if (na != null) {
shrunk.add(new DrawMlText.Paragraph(p.text(), if (na.getFontScale() > 0 && na.getFontScale() != NORM_AUTOFIT_FULL) {
p.style().derive(capPt, null, null, null, null), p.align())); double k = na.getFontScale() / (double) NORM_AUTOFIT_FULL;
List<DrawMlText.Paragraph> scaled = new ArrayList<>();
for (DrawMlText.Paragraph p : paragraphs) {
scaled.add(new DrawMlText.Paragraph(p.text(),
p.style().derive(p.style().sizePt() * k,
null, null, null, null), p.align()));
}
paragraphs = scaled;
}
if (na.getLnSpcReduction() > 0) {
lineFactor = 1.0 - na.getLnSpcReduction() / (double) NORM_AUTOFIT_FULL;
} }
paragraphs = shrunk;
} }
// autosize: уменьшаем кегль, пока текст не влезет в прямоугольник if (!noAutofit) {
for (int attempt = 0; attempt < 4; attempt++) { // autosize: уменьшаем кегль, пока текст не влезет в прямоугольник
double needed = 0; for (int attempt = 0; attempt < SHRINK_ATTEMPTS; attempt++) {
for (DrawMlText.Paragraph p : paragraphs) { double needed = 0;
needed += DrawMlText.textHeight(p.style()); for (DrawMlText.Paragraph p : paragraphs) {
needed += DrawMlText.textHeight(p.style());
}
if (needed <= th || p0(paragraphs) <= MIN_FONT_PT) {
break;
}
double factor = th / needed;
List<DrawMlText.Paragraph> shrunk = new ArrayList<>();
for (DrawMlText.Paragraph p : paragraphs) {
shrunk.add(new DrawMlText.Paragraph(p.text(),
p.style().derive(p.style().sizePt() * factor,
null, null, null, null), p.align()));
}
paragraphs = shrunk;
} }
if (needed <= th || p0(paragraphs) <= 4) {
break;
}
double factor = th / needed;
List<DrawMlText.Paragraph> shrunk = new ArrayList<>();
for (DrawMlText.Paragraph p : paragraphs) {
shrunk.add(new DrawMlText.Paragraph(p.text(),
p.style().derive(p.style().sizePt() * factor,
null, null, null, null), p.align()));
}
paragraphs = shrunk;
} }
DrawMlText.paint(g, paragraphs, new Rectangle2D.Double(tx, ty, tw, th), DrawMlText.paint(g, paragraphs, new Rectangle2D.Double(tx, ty, tw, th),
"ctr", "ctr", 1.0); ALIGN_LEFT, vAlignOf(bodyPr), lineFactor);
}
/** Insets bodyPr: значение из XML (EMU) или дефолт ECMA (pt) -> pt. */
private static double inset(Integer emu, double defaultPt) {
return emu == null ? defaultPt : emu / EMU_PER_PT;
}
/** bodyPr/@anchor -> vAlign DrawMlText; дефолт ECMA — верх. */
private static String vAlignOf(CTTextBodyProperties bodyPr) {
if (bodyPr == null || bodyPr.getAnchor() == null) {
return VALIGN_TOP;
}
if (bodyPr.getAnchor() == STTextAnchoringType.CTR) {
return VALIGN_CTR;
}
if (bodyPr.getAnchor() == STTextAnchoringType.B) {
return VALIGN_BOTTOM;
}
return VALIGN_TOP;
} }
private static double p0(List<DrawMlText.Paragraph> ps) { private static double p0(List<DrawMlText.Paragraph> ps) {
@@ -318,20 +378,4 @@ final class SmartArtRenderer {
} }
return new Color(0x59, 0x59, 0x59); return new Color(0x59, 0x59, 0x59);
} }
/** a:gd/@fmla = "val 4687" -> 4687. */
private static int parseGuide(String fmla) {
if (fmla == null) {
return 0;
}
String s = fmla.trim();
if (s.startsWith("val")) {
s = s.substring(3).trim();
}
try {
return Integer.parseInt(s);
} catch (NumberFormatException e) {
return 0;
}
}
} }
@@ -0,0 +1,275 @@
package ru.pjandro.wordpdf.internal.chart;
import org.docx4j.dml.CTGeomGuide;
import org.docx4j.dml.CTGeomGuideList;
import org.docx4j.dml.CTPresetGeometry2D;
import org.junit.jupiter.api.Test;
import javax.xml.stream.XMLInputFactory;
import javax.xml.stream.XMLStreamConstants;
import javax.xml.stream.XMLStreamReader;
import java.awt.Shape;
import java.awt.geom.PathIterator;
import java.awt.geom.Rectangle2D;
import java.io.InputStream;
import java.util.ArrayList;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import static org.junit.jupiter.api.Assertions.assertArrayEquals;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertFalse;
import static org.junit.jupiter.api.Assertions.assertNotEquals;
import static org.junit.jupiter.api.Assertions.assertTrue;
/**
* Таблица пресетов {@link PresetGeometry} обязана быть дословной копией
* блоков ECMA {@code presetShapeDefinitions.xml} (копия стандарта —
* тестовый ресурс {@code geom/presetShapeDefinitions.xml}); синхрон
* проверяет {@link #tableMatchesEcmaXml()}.
*
* Геометрические зонды — регрессии разборов, на которых движок уже
* спотыкался: оператор {@code ?:} («if x > 0, then y else z», а не
* «x != 0») и знаковая конвенция дуг Arc2D. Ошибка в любом из них
* превращает кольцевую стрелку в залитый «пакман» без отверстия.
*/
class PresetGeometryTest {
private static final double EPS = 1e-6;
private static final String[] SUPPORTED = {
"rect", "roundRect", "ellipse", "gear6", "gear9",
"circularArrow", "leftCircularArrow",
};
/** Глубина блока пресета и его секций в дереве StAX (корень — 1). */
private static final int DEPTH_BLOCK = 2;
private static final int DEPTH_SECTION = 3;
@Test
void tableMatchesEcmaXml() throws Exception {
Map<String, PresetGeometry.Preset> fromXml = parseEcmaXml();
for (String name : SUPPORTED) {
PresetGeometry.Preset expected = fromXml.get(name);
PresetGeometry.Preset actual = PresetGeometry.preset(name);
assertTrue(expected != null && actual != null, name + " отсутствует");
assertArrayEquals(expected.avLst(), actual.avLst(), name + ": avLst");
assertArrayEquals(expected.gdLst(), actual.gdLst(), name + ": gdLst");
assertArrayEquals(expected.pathLst(), actual.pathLst(), name + ": pathLst");
}
}
/** circularArrow: кольцевая полоса сверху (180°→343,76°), отверстие пусто, низ — пасть. */
@Test
void circularArrowIsRingBandNotDisc() {
Shape s = PresetGeometry.build("circularArrow", new int[0], 0, 0, 100, 100);
for (double deg : new double[] {200, 270, 340}) {
assertTrue(onRing(s, deg, 37.5), "полоса на " + deg + "°");
assertFalse(onRing(s, deg, 20), "отверстие на " + deg + "°");
}
assertFalse(onRing(s, 90, 37.5), "низ — пасть, не полоса");
}
/** leftCircularArrow — зеркало: полоса снизу, пасть сверху. */
@Test
void leftCircularArrowMirrorsBand() {
Shape s = PresetGeometry.build("leftCircularArrow", new int[0], 0, 0, 100, 100);
for (double deg : new double[] {20, 90, 160}) {
assertTrue(onRing(s, deg, 37.5), "полоса на " + deg + "°");
assertFalse(onRing(s, deg, 20), "отверстие на " + deg + "°");
}
assertFalse(onRing(s, 270, 37.5), "верх — пасть, не полоса");
}
@Test
void gearsCoverCenterAndFillCell() {
for (String gear : new String[] {"gear6", "gear9"}) {
Shape s = PresetGeometry.build(gear, new int[0], 0, 0, 100, 100);
assertTrue(s.contains(50, 50), gear + ": центр залит");
Rectangle2D b = s.getBounds2D();
assertTrue(b.getWidth() > 85 && b.getHeight() > 90, gear + ": " + b);
}
}
/** avLst-override доходит до движка: толстая шестерня (adj1=20000) отличается от дефолта. */
@Test
void adjustOverrideChangesGear() {
Shape def = PresetGeometry.build("gear6", new int[0], 0, 0, 100, 100);
Shape thick = PresetGeometry.build("gear6", new int[] {20000, 3526}, 0, 0, 100, 100);
assertNotEquals(def.getBounds2D(), thick.getBounds2D());
assertTrue(thick.contains(50, 50));
}
@Test
void roundRectRoundsCorners() {
Shape s = PresetGeometry.build("roundRect", new int[0], 0, 0, 100, 100);
assertFalse(s.contains(1, 1), "угол срезан");
assertTrue(s.contains(1, 50), "середина стороны на месте");
}
@Test
void ellipseFitsCell() {
Shape s = PresetGeometry.build("ellipse", new int[0], 0, 0, 100, 100);
assertTrue(s.contains(50, 50));
assertFalse(s.contains(1, 1), "угол вне эллипса");
}
/** Смещение ячейки (a:xfrm/@off) транслирует построенную форму. */
@Test
void offsetTranslatesBuiltShape() {
Shape s = PresetGeometry.build("ellipse", new int[0], 10, 20, 100, 100);
Rectangle2D b = s.getBounds2D();
assertEquals(10, b.getMinX(), 1e-3);
assertEquals(20, b.getMinY(), 1e-3);
assertEquals(100, b.getWidth(), 1e-3);
assertEquals(100, b.getHeight(), 1e-3);
}
@Test
void unknownPresetFallsBackToCellRect() {
Shape s = PresetGeometry.build("bogusShape", new int[0], 5, 6, 70, 80);
Rectangle2D b = s.getBounds2D();
assertEquals(5, b.getX(), EPS);
assertEquals(6, b.getY(), EPS);
assertEquals(70, b.getWidth(), EPS);
assertEquals(80, b.getHeight(), EPS);
assertTrue(s.contains(5, 6));
}
@Test
void adjustValuesReadsValGuidesByPosition() {
CTPresetGeometry2D pg = new CTPresetGeometry2D();
CTGeomGuideList av = new CTGeomGuideList();
av.getGd().add(guide("adj1", "val 15000"));
av.getGd().add(guide("adj2", "ss 5"));
pg.setAvLst(av);
assertArrayEquals(new int[] {15000, 0}, PresetGeometry.adjustValues(pg));
assertEquals(0, PresetGeometry.adjustValues(new CTPresetGeometry2D()).length);
}
private static CTGeomGuide guide(String name, String fmla) {
CTGeomGuide g = new CTGeomGuide();
g.setName(name);
g.setFmla(fmla);
return g;
}
/** Точка на эллипсе (50±r) под углом deg (единичная конвенция ECMA: y вниз). */
private static boolean onRing(Shape s, double deg, double r) {
double t = Math.toRadians(deg);
return s.contains(50 + r * Math.cos(t), 50 + r * Math.sin(t));
}
/**
* Разбор блоков стандарта: для каждого поддерживаемого пресета —
* строки avLst/gdLst («name fmla») и команды pathLst в формате
* движка («moveTo x y», «arcTo wR hR stAng swAng», «close»).
*/
private static Map<String, PresetGeometry.Preset> parseEcmaXml() throws Exception {
XMLInputFactory f = XMLInputFactory.newFactory();
f.setProperty(XMLInputFactory.SUPPORT_DTD, false);
f.setProperty(XMLInputFactory.IS_SUPPORTING_EXTERNAL_ENTITIES, false);
Map<String, PresetGeometry.Preset> out = new LinkedHashMap<>();
try (InputStream in = PresetGeometryTest.class.getResourceAsStream(
"/geom/presetShapeDefinitions.xml")) {
assertTrue(in != null, "ресурс geom/presetShapeDefinitions.xml не найден");
XMLStreamReader r = f.createXMLStreamReader(in);
int depth = 0;
String block = null;
String section = null;
List<String> av = new ArrayList<>();
List<String> gd = new ArrayList<>();
List<String> path = new ArrayList<>();
while (r.hasNext()) {
int ev = r.next();
if (ev == XMLStreamConstants.START_ELEMENT) {
depth++;
String ln = r.getLocalName();
if (depth == DEPTH_BLOCK && List.of(SUPPORTED).contains(ln)) {
block = ln;
av = new ArrayList<>();
gd = new ArrayList<>();
path = new ArrayList<>();
} else if (block != null && depth == DEPTH_SECTION) {
section = switch (ln) {
case "avLst", "gdLst", "pathLst" -> ln;
default -> null;
};
} else if (block != null && "gd".equals(ln) && section != null) {
String entry = r.getAttributeValue(null, "name") + " "
+ r.getAttributeValue(null, "fmla");
switch (section) {
case "avLst" -> av.add(entry);
default -> gd.add(entry);
}
} else if (block != null && "pathLst".equals(section)) {
switch (ln) {
case "moveTo", "lnTo" -> {
String[] pt = readPt(r);
path.add(ln + " " + pt[0] + " " + pt[1]);
}
case "arcTo" -> path.add("arcTo " + r.getAttributeValue(null, "wR")
+ " " + r.getAttributeValue(null, "hR")
+ " " + r.getAttributeValue(null, "stAng")
+ " " + r.getAttributeValue(null, "swAng"));
case "close" -> path.add("close");
default -> {
}
}
}
} else if (ev == XMLStreamConstants.END_ELEMENT) {
String ln = r.getLocalName();
if (depth == DEPTH_SECTION) {
section = null;
}
if (depth == DEPTH_BLOCK && ln.equals(block)) {
out.put(block, new PresetGeometry.Preset(
av.toArray(String[]::new),
gd.toArray(String[]::new),
path.toArray(String[]::new)));
block = null;
}
depth--;
}
}
}
return out;
}
/** Атрибуты x/y единственного <pt> внутри moveTo/lnTo; <pt/> закрывается здесь. */
private static String[] readPt(XMLStreamReader r) throws Exception {
while (r.hasNext()) {
if (r.next() == XMLStreamConstants.START_ELEMENT
&& "pt".equals(r.getLocalName())) {
String[] attrs = {
r.getAttributeValue(null, "x"),
r.getAttributeValue(null, "y"),
};
boolean closed = false;
while (!closed) {
closed = r.next() == XMLStreamConstants.END_ELEMENT
&& "pt".equals(r.getLocalName());
}
return attrs;
}
}
throw new IllegalStateException("у команды нет <pt>");
}
/** Формат движка: путь rect'а — ровно контур ячейки. */
@Test
void rectPathIsCellContour() {
PathIterator pi = PresetGeometry.build("rect", new int[0], 0, 0, 100, 100)
.getPathIterator(null);
double[] p = new double[6];
int segments = 0;
while (!pi.isDone()) {
if (pi.currentSegment(p) != PathIterator.SEG_CLOSE) {
segments++;
}
pi.next();
}
assertEquals(4, segments);
}
}
File diff suppressed because it is too large Load Diff