diff --git a/AGENTS.md b/AGENTS.md
index abde1af..136f35c 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -30,7 +30,7 @@
Нормативный источник любых правок/решений по диаграммам и SmartArt — ECMA-376 (`docs/standards/`: графики §21.2, diagram-разметка §21.4, пресет-геометрия Annex D + полные наборы XSD `schema/strict/`/`schema/transitional/`; соответствие фикстур схемам проверяет `docs/standards/validate-fixtures.py` — см. README; поведение Word — `ms-oi29500.md`, `ms-odrawxml.md`), а не догадки по исходникам LibreOffice/Word-эмпирике; эмпирические калибровки (камера, `PIE_DEPTH`) менять только вместе с пиксельными тестами. Формулировки из стандарта при ссылке — с номером секции (§21.2.2.132 и т.п.). Фикстуры могут быть невалидны — код под фикстуру не правится, правится фикстура (после проверки по XSD/секции).
-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/SCATTER/BUBBLE/RADAR/STOCK/OF_PIE/SURFACE/BAR3D/AREA3D/LINE3D/UNSUPPORTED; пустой `c:title` + `autoTitleDeleted="0"` → у **круговых** имя первого ряда, у прочих — `AUTO_TITLE = "Название диаграммы"` (русская замена англ. плейсхолдеру Word); палитра `accent1..6` темы, легенда по умолчанию снизу (у SURFACE — полосы высот «0-1»…), позиция `t` поддержана, `overlay` (§21.2.2.132) → рисуется поверх области построения, место не резервирует (`ChartSpec.legendOverlay`, регрессия `ChartRendererTest#overlayLegend_drawnOverPlot`)) → `ChartRenderer` (осевые «круглые» шаги `niceUnit` 1/2/5·10ⁿ как Word; санитайзер `c:majorUnit` — `MAX_TICKS = 1000`: шаг ≤ 0/NaN/слишком мелкий в `axisBounds` заменяется niceUnit, иначе циклы делений вечные; общие кумулятивные хелперы stacked `isStacked`/`stackedCumulative`/`stackedRange`) → пейнтеры `CartesianPainter` (2-D line/bar/area; lineChart `c:grouping` stacked/percentStacked §21.2.2.76 — ряд рисуется на накопленной сумме через `ChartRenderer.stackedCumulative`, регрессии `stackedLine_seriesStackCumulatively`/`percentStackedLine_topSeriesFlatAtHundred`)/`PiePainter` (`PIE_DEPTH=0.22`, `PIE_FIT=0.865`)/`Surface3dPainter` (калибровка по эталону Word 300 dpi, камера — регрессия `cameraMatchesWordReference`: `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`, `c:rAngAx=true` во всех 3D-пейнтерах имеет приоритет над `c:perspective` (MS-OI29500 §2.1.1516(b)), `c:hPercent` сжимает глубину, `c:wireframe` §21.2.2.205 — только каркас без полос высот, bandFmt-полосы сортируются по глубине)/`ScatterPainter` (scatter/bubble: обе оси числовые, две `c:valAx`, X — первая; маркеры по `c:marker`, `c:scatterStyle` §21.2.2.136; радиус пузыря sqrt при `c:sizeRepresents="area"` §21.2.2.128 и линейно при «w», масштаб `c:bubbleScale`)/`RadarPainter` (спицы от 12 часов по часовой, `c:radarStyle` §21.2.2.119 standard/marker/filled, сетка — концентрические многоугольники)/`StockPainter` (high-low-close: `c:hiLowLines`/`c:upDownBars`/`c:dropLines`; цвета — дефолты UI Word, эмпирика запинена тестом)/`OfPiePainter` (главный пирог, замкнутый «Other»-сектором — MS-OI29500 §2.1.1507(a), обращён центром к 3 часам ко вторичной, цвет — следующая ротация палитры; пара пирогов центрирована, зазор `GAP_FIT=0.25·d1` — Word-эмпирика; вторичный пирог/стек, разбиение по `c:splitType` §21.2.2.155 (splitPos — MS-OI29500 §2.1.1554a/b), вторичный пирог стартует от конца «Other»-сектора; `c:serLines` — ровно две связи от границ «Other»-сектора к ободу вторичного на 270°±wedgeSweep / левым углам столбца — MS-OI29500 §2.1.1545(a))/`Surface2dPainter` (контурная карта §21.2.2.204: полосы высот между ломаными соседних рядов §21.2.2.13, передняя стенка — полоса значения переднего края, `c:wireframe` §21.2.2.205 — сетка листа, оси общие с декартовыми)/`Cartesian3dPainter` (bar3D/line3D/area3D §21.2.2.19/.101/.122 — камера `Surface3dPainter.project`, ряды уходят в глубину; bar3D: `c:shape` box/cone/cylinder/pyramid + `*ToMax` §21.2.3.44 (per-series `c:shape` переопределяет диаграммный, горизонтальная ориентация — всегда box), `c:grouping` stacked/percentStacked §21.2.2.76 (одна полоса глубины на категорию, сегменты столбиком, percent — нормировка к 100%; area3D stacked — полосы на стене v=0, line3D grouping игнорирует), `c:gapDepth` — MS-OI29500 §2.1.1474, подписи serAx рисуются, `c:delete` осей учитывается); `SmartArtRenderer` рисует кэш разложенной схемы (relationship `…/office/2007/relationships/diagramDrawing`, фактически `word/diagrams/drawing1.xml`), формы строит `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` (шрифты — тот же бандл через `BundledFontMapper.bundledFamily`); утилиты `RgbHsl`. Калибровочные константы менять только вместе с `Surface3dPainterTest`/`PiePainterTest`. Защитные лимиты против враждебного chart-XML: `ChartSpec.MAX_POINTS` (`c:pt/@idx` §21.2.2.150/.151 и `c:ptCount` §21.2.2.152 — ST_UnsignedInt без верхней границы, отказ `IllegalArgumentException` до предвыделения списка) и `MAX_TICKS` (см. выше); бросок перехватывает catch `DrawingPreRenderer.renderChart` → штатная деградация «объект удалён + warn». Обход `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/SCATTER/BUBBLE/RADAR/STOCK/OF_PIE/SURFACE/BAR3D/AREA3D/LINE3D/UNSUPPORTED; пустой `c:title` + `autoTitleDeleted="0"` → у **круговых** имя первого ряда, у прочих — `AUTO_TITLE = "Название диаграммы"` (русская замена англ. плейсхолдеру Word); палитра `accent1..6` темы, легенда по умолчанию снизу (у SURFACE — полосы высот «0-1»…), позиция `t` поддержана, `overlay` (§21.2.2.132) → рисуется поверх области построения, место не резервирует (`ChartSpec.legendOverlay`, регрессия `ChartRendererTest#overlayLegend_drawnOverPlot`)) → `ChartRenderer` (осевые «круглые» шаги `niceUnit` 1/2/5·10ⁿ как Word; санитайзер `c:majorUnit` — `MAX_TICKS = 1000`: шаг ≤ 0/NaN/слишком мелкий в `axisBounds` заменяется niceUnit, иначе циклы делений вечные; общие кумулятивные хелперы stacked `isStacked`/`stackedCumulative`/`stackedRange`) → пейнтеры `CartesianPainter` (2-D line/bar/area; lineChart `c:grouping` stacked/percentStacked §21.2.2.76 — ряд рисуется на накопленной сумме через `ChartRenderer.stackedCumulative`, регрессии `stackedLine_seriesStackCumulatively`/`percentStackedLine_topSeriesFlatAtHundred`)/`PiePainter` (`PIE_DEPTH=0.22`, `PIE_FIT=0.865`)/`Surface3dPainter` (калибровка по эталону Word 300 dpi, камера — регрессия `cameraMatchesWordReference`: `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`, `c:rAngAx=true` во всех 3D-пейнтерах имеет приоритет над `c:perspective` (MS-OI29500 §2.1.1516(b)), `c:hPercent` сжимает глубину, `c:wireframe` §21.2.2.205 — только каркас без полос высот, bandFmt-полосы сортируются по глубине)/`ScatterPainter` (scatter/bubble: обе оси числовые, две `c:valAx`, X — первая; маркеры по `c:marker`, `c:scatterStyle` §21.2.2.136; радиус пузыря sqrt при `c:sizeRepresents="area"` §21.2.2.128 и линейно при «w», масштаб `c:bubbleScale`)/`RadarPainter` (спицы от 12 часов по часовой, `c:radarStyle` §21.2.2.119 standard/marker/filled, сетка — концентрические многоугольники)/`StockPainter` (high-low-close: `c:hiLowLines`/`c:upDownBars`/`c:dropLines`; цвета — дефолты UI Word, эмпирика запинена тестом)/`OfPiePainter` (главный пирог, замкнутый «Other»-сектором — MS-OI29500 §2.1.1507(a), обращён центром к 3 часам ко вторичной, цвет — следующая ротация палитры; пара пирогов центрирована, зазор `GAP_FIT=0.25·d1` — Word-эмпирика; вторичный пирог/стек, разбиение по `c:splitType` §21.2.2.155 (splitPos — MS-OI29500 §2.1.1554a/b), вторичный пирог стартует от конца «Other»-сектора; `c:serLines` — ровно две связи от границ «Other»-сектора к ободу вторичного на 270°±wedgeSweep / левым углам столбца — MS-OI29500 §2.1.1545(a))/`Surface2dPainter` (контурная карта §21.2.2.204: полосы высот между ломаными соседних рядов §21.2.2.13, передняя стенка — полоса значения переднего края; `c:wireframe` §21.2.2.230 — вид сверху (X=категории, Y=ряды, серия 0 внизу) без заливок: изолинии на границах полос высот `lo+k·unit` цветом нижней полосы (c:bandFmts §21.2.2.13/.14, без них — палитра), marching squares, седло — по среднему ячейки; сетка catAx/serAx, рамка plot; ось значений не рисуется)/`Cartesian3dPainter` (bar3D/line3D/area3D §21.2.2.19/.101/.122 — камера `Surface3dPainter.project`, ряды уходят в глубину; bar3D: `c:shape` box/cone/cylinder/pyramid + `*ToMax` §21.2.3.44 (per-series `c:shape` переопределяет диаграммный, горизонтальная ориентация — всегда box), `c:grouping` stacked/percentStacked §21.2.2.76 (одна полоса глубины на категорию, сегменты столбиком, percent — нормировка к 100%; area3D stacked — полосы на стене v=0, line3D grouping игнорирует), `c:gapDepth` — MS-OI29500 §2.1.1474, подписи serAx рисуются, `c:delete` осей учитывается); `SmartArtRenderer` рисует кэш разложенной схемы (relationship `…/office/2007/relationships/diagramDrawing`, фактически `word/diagrams/drawing1.xml`), формы строит `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` (шрифты — тот же бандл через `BundledFontMapper.bundledFamily`); утилиты `RgbHsl`. Калибровочные константы менять только вместе с `Surface3dPainterTest`/`PiePainterTest`. Защитные лимиты против враждебного chart-XML: `ChartSpec.MAX_POINTS` (`c:pt/@idx` §21.2.2.150/.151 и `c:ptCount` §21.2.2.152 — ST_UnsignedInt без верхней границы, отказ `IllegalArgumentException` до предвыделения списка) и `MAX_TICKS` (см. выше); бросок перехватывает catch `DrawingPreRenderer.renderChart` → штатная деградация «объект удалён + warn». Обход `pkg.getParts()` — только по **снимку** списка (`createImagePart` мутирует реестр → CME); rels частей — `part.getRelationshipsPart()`, НЕ `getOwningRelationshipPart()` (это rels ссылающегося); обход XML обязан раскрывать `JAXBElement`.
### Критические инварианты (нарушение = битый вывод)
@@ -160,7 +160,7 @@ gateway). Кеш раннеров — сервер act_runner (серверна
- **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 (экспорт 300 dpi, числа зашиты в тесты), допуски `assertRatio` <0.06 (`PiePainterTest`, `CartesianPainterTest`) / <0.10 (`Surface3dPainterTest`, + `assertRange` ±6 pt для центров силуэта); пороги залитых px, перцентильные коридоры яркости, «серый» px — разброс каналов `GRAY_MAX_SPREAD=25`. Эталонные файлы — `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.
-- Фикстуры — закоммиченные `samples/*.docx` (13; в тестах не генерировать; все ECMA-conformant по `docs/standards/validate-fixtures.py` — фикстура невалидна, правится фикстура, не код): 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` (кэш `1` + 110 `lastRenderedPageBreak`), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject), `ole-embedded` (осиротевший bin с ложным `Default bin→footer+xml` + настоящий `w:object` с честным `Override → oleObject`; ручная, генератором не перезаписывать), `chart-types` (11 графиков: 9 типов + ofPie pie-вариант (`c:ofPieType`="pie") + lineChart `c:grouping`=stacked; пересоздание — `ChartTypesDocxGenerator`).
+- Фикстуры — закоммиченные `samples/*.docx` (13; в тестах не генерировать; все ECMA-conformant по `docs/standards/validate-fixtures.py` — фикстура невалидна, правится фикстура, не код): 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` (кэш `1` + 110 `lastRenderedPageBreak`), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject), `ole-embedded` (осиротевший bin с ложным `Default bin→footer+xml` + настоящий `w:object` с честным `Override → oleObject`; ручная, генератором не перезаписывать), `chart-types` (12 графиков + wireframe-поверхность = 13: 9 типов + ofPie pie-вариант (`c:ofPieType`="pie") + lineChart `c:grouping`=stacked + `c:wireframe` val="1"; пересоздание — `ChartTypesDocxGenerator`).
- Юниты нормализаторов работают строками (`rewrite`) + zip'ами из `ZipOutputStream`; обязательные контракты: «нечего менять → тот же массив» (`assertSame` покрыт тестами только у zip-нормализаторов `DocxOnOff`/`SymbolFont`/`StrictOoxml`; у `Field`/`GlyphCoverage`/`InvisibleChar` — `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`/`ConversionTimeoutTest` (`@TestPropertySource` — отдельные классы, не `@Nested`).
- Регрессивные пары (фикс = нормализатор/pre-renderer + юнит + конвертер-тест с фикстурой): `StrictOoxmlNormalizerTest`↔`strictOoxml_convertsNotRejected` (+`pageCount_strictBreaksCountedLightweight` — lightweight против strict), `DocxOnOffNormalizerTest`↔`ruPlain_regularRunsUseRegularFont`, `SymbolFontNormalizerTest`↔`symbolFonts_bulletsAreNotHash`, `FieldNormalizerTest`↔`pageNumbers_recomputedNotCached`, `InvisibleCharNormalizerTest`↔`invisibleChars_noEmptyLines`, `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`), новые пейнтеры `ScatterPainterTest`/`RadarPainterTest`/`StockPainterTest`/`OfPiePainterTest`/`Surface2dPainterTest`/`Cartesian3dPainterTest`↔`chartTypes_allTypesRenderAsImages` (фикстура `chart-types`; ось X scatter/bubble и OF_PIE-заголовок — `ChartSpecTest`), lineChart stacked — `ChartSpecTest#lineGroupingParsed` + `ChartRendererTest#stackedCumulative_*`/`stackedRange_coversNegativeSums` + `CartesianPainterTest#stackedLine_seriesStackCumulatively`/`percentStackedLine_topSeriesFlatAtHundred`↔`chartTypes_allTypesRenderAsImages`; `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), `dotSegmentOpenPrefix_rejected` (точечные сегменты `..`/`%2e` — не открытый путь), `errorFlagNotBoolean_rejected` (битый error-флаг → 400); DoS/корректность core: `ChartSpecTest#hugePointIndex_rejectedNotOom`/`hugePtCount_rejectedNotOom`/`hugeCategoryIndex_rejectedNotOom` (`MAX_POINTS`), `Surface3dPainterTest#axisBounds_tinyMajorUnit_fallsBackToNiceUnit`/`axisBounds_zeroMajorUnit_fallsBackToNiceUnit` (`MAX_TICKS`), `GlyphCoverageNormalizerTest#multipleTextNodes_runLeftUntouched` (guard составного рана)/`nestedRunInTextBox_innerSplit` + `SymbolFontNormalizerTest#nestedRunInTextBox_innerNormalized` (вложенные раны текстбоксов), `CartesianPainterTest#areaFill_closesToBaseline` (AREA к базовой линии), `ChartRendererTest#overlayLegend_drawnOverPlot` + `ChartSpecTest#overlayLegend_keepsPositionAndFlag` (overlay-легенда).
diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainter.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainter.java
index a988f08..fa09eda 100644
--- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainter.java
+++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainter.java
@@ -5,24 +5,32 @@ import java.awt.Color;
import java.awt.Graphics2D;
import java.awt.RenderingHints;
import java.awt.geom.Line2D;
-import java.awt.geom.Path2D;
import java.awt.geom.Rectangle2D;
import java.util.ArrayList;
import java.util.List;
/**
- * Поверхностная диаграмма без объёма (c:surfaceChart, ECMA-376 §21.2.2.204):
- * «отображает взаимосвязь между категориями и осью значений» — то есть
- * рисуется в системе координат «категория × значение»: ось значений слева,
- * категории снизу. Каждый ряд — ломаная через категории; лист поверхности
- * идёт от переднего ряда к задним, и на экране виден торцом: полосы между
- * соседними ломаными красятся контурными полосами высот (c:bandFmts,
- * §21.2.2.13 — индексация от низкого к высокого; без bandFmts — палитра),
- * передняя стенка от пола до ряда 0 — полосой значения переднего края.
- * c:wireframe (§21.2.2.205) — вместо заливок сетка из ломаных рядов и
- * линий по категориям.
+ * Контурная диаграмма (c:surfaceChart, ECMA-376 §21.2.2.204), два режима.
*
- * Регрессия — Surface2dPainterTest, фикстура samples/chart-types.docx
+ *
Заливочный (c:wireframe val="0"): «отображает взаимосвязь между
+ * категориями и осью значений» — система координат «категория × значение»:
+ * ось значений слева, категории снизу. Каждый ряд — ломаная через
+ * категории; лист поверхности идёт от переднего ряда к задним, и на экране
+ * виден торцом: полосы между соседними ломаными красятся контурными
+ * полосами высот (c:bandFmts, §21.2.2.13 — индексация от низкого к
+ * высокого; без bandFmts — палитра), передняя стенка от пола до ряда 0 —
+ * полосой значения переднего края.
+ *
+ *
c:wireframe (§21.2.2.230) — вид сверху, как Word: «surface charts
+ * viewed from above… shows only the lines. The lines… connect interpolated
+ * points of equal value» (Microsoft Support). X — категории, Y — ряды
+ * (серия 0 внизу), заливок и оси значений нет: изолинии на внутренних
+ * границах полос высот lo + k·unit цветом полосы НИЖЕ уровня
+ * (c:bandFmts §21.2.2.13/.14, без них — палитра), marching squares
+ * ({@link #cellSegments}), седло — по среднему ячейки; сетка узлов
+ * catAx/serAx и рамка области построения.
+ *
+ *
Регрессия — Surface2dPainterTest, фикстура samples/chart-types.docx
* (WordPdfConverterTest#chartTypes_allTypesRenderAsImages).
*/
final class Surface2dPainter {
@@ -33,6 +41,18 @@ final class Surface2dPainter {
/** Отрезок полосы короче этого не рисуется (эпсилон float-сравнения). */
private static final double MIN_SEGMENT = 1e-9;
+ /** Страж нулевой длины ребра при интерполяции уровня (marching squares). */
+ private static final double LEVEL_EPS = 1e-12;
+
+ /** Число пересечений ребра ячейки уровнем: пара — один сегмент. */
+ private static final int HITS_PAIR = 2;
+
+ /** Число пересечений ребра ячейки уровнем: седло — два сегмента. */
+ private static final int HITS_SADDLE = 4;
+
+ /** Число пересечений ребра ячейки уровнем: два поперечных + узел — один сегмент. */
+ private static final int HITS_WITH_NODE = 3;
+
static void paint(Graphics2D g, ChartSpec spec, Rectangle2D box, List palette) {
int nSer = spec.series.size();
int nCat = 0;
@@ -65,6 +85,11 @@ final class Surface2dPainter {
int bandCount = Math.max(1, (int) Math.ceil((hi - lo) / unit - 1e-9));
List bands = spec.bandColors.isEmpty() ? palette : spec.bandColors;
+ if (spec.wireframe) {
+ paintWireframe(g, spec, z, nSer, nCat, lo, unit, bandCount, bands, box);
+ return;
+ }
+
// Поля под подписи осей — та же auto-layout-эвристика, что у
// CartesianPainter (подписи значений слева, категорий снизу).
List cats = CartesianPainter.categoriesOf(spec, nCat);
@@ -97,11 +122,7 @@ final class Surface2dPainter {
}
}
- if (spec.wireframe) {
- drawWireframe(g, z, nSer, nCat, lo, hi, plot, valAxis);
- } else {
- drawContour(g, z, nSer, nCat, lo, hi, unit, bandCount, bands, plot);
- }
+ drawContour(g, z, nSer, nCat, lo, hi, unit, bandCount, bands, plot);
// Оси поверх: линия категории и подписи.
if (catAxis.axisLineColor != null && !catAxis.deleted) {
@@ -167,31 +188,280 @@ final class Surface2dPainter {
g.setRenderingHint(RenderingHints.KEY_ANTIALIASING, oldAA);
}
- /** c:wireframe: сетка листа — ломаные рядов + линии по категориям. */
- private static void drawWireframe(Graphics2D g, double[][] z, int nSer, int nCat,
- double lo, double hi, Rectangle2D plot,
- ChartSpec.AxisSpec valAxis) {
- g.setColor(valAxis.gridColor);
- g.setStroke(new BasicStroke(0.6f));
+ /**
+ * c:wireframe (§21.2.2.230) — вид сверху, как Word: X — категории,
+ * Y — ряды (серия 0 внизу); рисуются только изолинии, сетка узлов
+ * catAx/serAx и рамка области построения — заливок и оси значений нет
+ * (значения кодируют изолинии и легенда полос). Word пишет serAx
+ * axPos="r" для поверхностей; иное положение serAx — подписи слева.
+ */
+ private static void paintWireframe(Graphics2D g, ChartSpec spec, double[][] z,
+ int nSer, int nCat, double lo, double unit,
+ int bandCount, List bands,
+ Rectangle2D box) {
+ ChartSpec.AxisSpec serAxis = spec.serAxis != null
+ ? spec.serAxis : new ChartSpec.AxisSpec();
+ ChartSpec.AxisSpec catAxis = spec.catAxis != null
+ ? spec.catAxis : new ChartSpec.AxisSpec();
+ boolean serRight = spec.serAxis != null && "r".equals(serAxis.pos);
+
+ List cats = CartesianPainter.categoriesOf(spec, nCat);
+ List serLabels = new ArrayList<>();
for (int r = 0; r < nSer; r++) {
- Path2D p = new Path2D.Double();
+ String name = spec.series.get(r).name;
+ serLabels.add(name == null || name.isEmpty() ? String.valueOf(r + 1) : name);
+ }
+
+ // Поля под подписи — та же эвристика, что у filled-ветки (ряды вместо значений).
+ double catGutter = catAxis.labelStyle != null
+ ? DrawMlText.textHeight(catAxis.labelStyle) + 6 : 6;
+ double serGutter = 8;
+ if (serAxis.labelStyle != null) {
+ for (String l : serLabels) {
+ serGutter = Math.max(serGutter,
+ DrawMlText.textWidth(l, serAxis.labelStyle) + 8);
+ }
+ }
+ Rectangle2D plot = new Rectangle2D.Double(
+ serRight ? box.getX() : box.getX() + serGutter, box.getY(),
+ Math.max(10, box.getWidth() - serGutter),
+ Math.max(10, box.getHeight() - catGutter));
+
+ // Сетка по узлам осей — под изолиниями.
+ if (catAxis.gridlines && !catAxis.deleted) {
+ g.setColor(catAxis.gridColor);
+ g.setStroke(new BasicStroke(0.6f));
for (int c = 0; c < nCat; c++) {
double x = xOf(c, plot, nCat);
- double y = yOf(z[r][c], lo, hi, plot);
- if (c == 0) {
- p.moveTo(x, y);
- } else {
- p.lineTo(x, y);
+ g.draw(new Line2D.Double(x, plot.getY(), x,
+ plot.getY() + plot.getHeight()));
+ }
+ }
+ if (spec.serAxis != null && serAxis.gridlines && !serAxis.deleted) {
+ g.setColor(serAxis.gridColor);
+ g.setStroke(new BasicStroke(0.6f));
+ for (int r = 0; r < nSer; r++) {
+ double y = serY(r, plot, nSer);
+ g.draw(new Line2D.Double(plot.getX(), y,
+ plot.getX() + plot.getWidth(), y));
+ }
+ }
+
+ // Изолинии — с антиалиасингом (в отличие от заливки filled-ветки).
+ g.setStroke(new BasicStroke(0.75f));
+ drawContourLines(g, z, nSer, nCat, lo, unit, bandCount, bands, plot);
+
+ // Рамка области построения — это рамка области, а не ось.
+ if (catAxis.axisLineColor != null) {
+ g.setColor(catAxis.axisLineColor);
+ g.setStroke(new BasicStroke((float) Math.max(0.5, catAxis.axisLineWidth)));
+ g.draw(plot);
+ }
+
+ // Подписи категорий — по ЦЕНТРАМ узлов сетки (не слотов, как в filled).
+ if (catAxis.labelStyle != null) {
+ DrawMlText.Style style = catAxis.labelStyle;
+ double h = DrawMlText.textHeight(style) + 2;
+ double slot = plot.getWidth() / Math.max(1, nCat - 1);
+ for (int i = 0; i < nCat && i < cats.size(); i++) {
+ String label = cats.get(i);
+ if (label.isEmpty()) {
+ continue;
+ }
+ double w = DrawMlText.textWidth(label, style);
+ if (w > slot * 1.15) {
+ continue;
+ }
+ DrawMlText.paint(g, List.of(new DrawMlText.Paragraph(label, style, "ctr")),
+ new Rectangle2D.Double(xOf(i, plot, nCat) - w / 2,
+ plot.getY() + plot.getHeight() + 3, w, h),
+ "ctr", "t", 1.0);
+ }
+ }
+ // Подписи рядов — по центрам узлов строк, со стороны serAx.
+ if (serAxis.labelStyle != null) {
+ DrawMlText.Style style = serAxis.labelStyle;
+ double h = DrawMlText.textHeight(style) + 2;
+ for (int r = 0; r < nSer; r++) {
+ String label = serLabels.get(r);
+ if (label.isEmpty()) {
+ continue;
+ }
+ double w = Math.max(10, DrawMlText.textWidth(label, style));
+ double y = serY(r, plot, nSer);
+ Rectangle2D rect = serRight
+ ? new Rectangle2D.Double(plot.getX() + plot.getWidth() + 6,
+ y - h / 2, w, h)
+ : new Rectangle2D.Double(plot.getX() - 6 - w, y - h / 2, w, h);
+ DrawMlText.paint(g,
+ List.of(new DrawMlText.Paragraph(label, style,
+ serRight ? "l" : "r")),
+ rect, serRight ? "l" : "r", "ctr", 1.0);
+ }
+ }
+ }
+
+ /**
+ * Изолинии: «the lines… connect interpolated points of equal value» —
+ * на каждой внутренней границе полос высот lo + k·unit (k = 1..bandCount−1)
+ * цветом полосы НИЖЕ уровня (пиксельный разбор эталона Excel: линия на
+ * границе «коричневая полоса | серая полоса» — оттенок коричневого).
+ * Геометрия — marching squares по ячейкам сетки, см. {@link #cellSegments}.
+ */
+ private static void drawContourLines(Graphics2D g, double[][] z, int nSer, int nCat,
+ double lo, double unit, int bandCount,
+ List bands, Rectangle2D plot) {
+ for (int k = 1; k < bandCount; k++) {
+ double level = lo + k * unit;
+ g.setColor(bands.get((k - 1) % bands.size()));
+ for (int r = 0; r < nSer - 1; r++) {
+ double y0 = serY(r, plot, nSer);
+ double y1 = serY(r + 1, plot, nSer);
+ for (int c = 0; c < nCat - 1; c++) {
+ double x0 = xOf(c, plot, nCat);
+ double x1 = xOf(c + 1, plot, nCat);
+ for (Line2D.Double seg : cellSegments(z[r][c], z[r][c + 1],
+ z[r + 1][c + 1], z[r + 1][c], level, x0, x1, y0, y1)) {
+ g.draw(seg);
+ }
}
}
- g.draw(p);
}
- for (int c = 0; c < nCat; c++) {
- double x = xOf(c, plot, nCat);
- double yTop = yOf(z[nSer - 1][c], lo, hi, plot);
- double yBot = yOf(z[0][c], lo, hi, plot);
- g.draw(new Line2D.Double(x, Math.min(yTop, yBot), x, Math.max(yTop, yBot)));
+ }
+
+ /**
+ * Marching squares: сегменты линии уровня в одной ячейке сетки.
+ * Узлы A=(x0,y0)↔z00, B=(x1,y0)↔z10, C=(x1,y1)↔z11, D=(x0,y1)↔z01;
+ * «внутри» — z >= level (узел точно на уровне = внутри → линия проходит
+ * через узел). Возвращает 0, 1 или 2 сегмента. Ребро, оба конца которого
+ * точно на уровне, — целый сегмент (иначе вдоль ребра дыра в изолинии;
+ * Word её рисует), а такой узел «поглощает» пересечение соседнего ребра
+ * (линия проходит через узел вдоль ребра, диагональ неверна — двучленное
+ * уровень-множество биллинейной функции в этом случае даёт именно рёбра).
+ * Совпавшие в узле пересечения соседних рёбер дедуплицируются: изолиния
+ * проходит через узел. Седло (4 пересечения) решается центром ячейки:
+ * avg >= level — сегменты огибают «внутренние» углы, иначе — «внешние».
+ *
+ * Package-private для прямых геометрических юнит-тестов (как
+ * rewrite-хук нормализаторов). Регрессия — Surface2dPainterTest#cellSegments_*.
+ */
+ static List cellSegments(double z00, double z10, double z11, double z01,
+ double level, double x0, double x1,
+ double y0, double y1) {
+ double[] z = {z00, z10, z11, z01};
+ double[] xs = {x0, x1, x1, x0};
+ double[] ys = {y0, y0, y1, y1};
+ boolean[] inside = new boolean[4];
+ boolean[] onLevel = new boolean[4];
+ for (int i = 0; i < 4; i++) {
+ inside[i] = z[i] >= level;
+ onLevel[i] = z[i] == level;
}
+ List segs = new ArrayList<>();
+ boolean[] full = new boolean[4];
+ for (int i = 0; i < 4; i++) {
+ int j = (i + 1) % 4;
+ if (onLevel[i] && onLevel[j]) {
+ full[i] = true;
+ addSegment(segs, xs[i], ys[i], xs[j], ys[j]);
+ }
+ }
+ boolean[] absorbed = new boolean[4];
+ for (int i = 0; i < 4; i++) {
+ absorbed[i] = onLevel[i] && (full[i] || full[(i + 3) % 4]);
+ }
+ double[][] hit = new double[4][];
+ for (int i = 0; i < 4; i++) {
+ int j = (i + 1) % 4;
+ if (full[i] || inside[i] == inside[j]
+ || Math.abs(z[j] - z[i]) < LEVEL_EPS
+ || absorbed[i] || absorbed[j]) {
+ continue;
+ }
+ double t = (level - z[i]) / (z[j] - z[i]);
+ hit[i] = new double[] {xs[i] + (xs[j] - xs[i]) * t, ys[i] + (ys[j] - ys[i]) * t};
+ }
+ // Совпадения пересечений в узлах (соседние рёбра бьют в один узел) —
+ // одно пересечение: без дедупликации в ячейках вида (3,6,4,2) — узел
+ // z=4 фикстуры hill, уровень 4 — было бы «3 удара» и сегмент терялся.
+ List edges = new ArrayList<>();
+ for (int i = 0; i < 4; i++) {
+ if (hit[i] != null && !coincident(hit, edges, i)) {
+ edges.add(i);
+ }
+ }
+ if (edges.size() == HITS_PAIR) {
+ double[] p = hit[edges.get(0)];
+ double[] q = hit[edges.get(1)];
+ addSegment(segs, p[0], p[1], q[0], q[1]);
+ } else if (edges.size() == HITS_WITH_NODE) {
+ // Два поперечных + одно точно в узле: узел — изолированная точка
+ // уровень-множества (ветвь уходит из ячейки по ребру соседям),
+ // рисуем сегмент между поперечными пересечениями.
+ double[] p = null;
+ double[] q = null;
+ for (int e : edges) {
+ if (isNode(hit[e], xs, ys)) {
+ continue;
+ }
+ if (p == null) {
+ p = hit[e];
+ } else {
+ q = hit[e];
+ }
+ }
+ if (p != null && q != null) {
+ addSegment(segs, p[0], p[1], q[0], q[1]);
+ }
+ } else if (edges.size() == HITS_SADDLE) {
+ double avg = (z00 + z10 + z11 + z01) / 4;
+ // Рёбра e0=A-B, e1=B-C, e2=C-D, e3=D-A. A,C внутри: avg >= level —
+ // огибаем внутренние углы парами (e3,e0)+(e1,e2), иначе зеркально;
+ // B,D внутри — наоборот.
+ int[][] pairs = inside[0] == (avg >= level)
+ ? new int[][] {{3, 0}, {1, 2}}
+ : new int[][] {{0, 1}, {2, 3}};
+ for (int[] pr : pairs) {
+ addSegment(segs, hit[pr[0]][0], hit[pr[0]][1],
+ hit[pr[1]][0], hit[pr[1]][1]);
+ }
+ }
+ return segs;
+ }
+
+ /** Совпадает ли пересечение ребра i с пересечением одного из рёбер done. */
+ private static boolean coincident(double[][] hit, List done, int i) {
+ for (int e : done) {
+ if (hit[e][0] == hit[i][0] && hit[e][1] == hit[i][1]) {
+ return true;
+ }
+ }
+ return false;
+ }
+
+ /** Точка — узел ячейки. */
+ private static boolean isNode(double[] p, double[] xs, double[] ys) {
+ for (int k = 0; k < 4; k++) {
+ if (p[0] == xs[k] && p[1] == ys[k]) {
+ return true;
+ }
+ }
+ return false;
+ }
+
+ /** Сегмент ненулевой длины (эпсилон {@link #MIN_SEGMENT}). */
+ private static void addSegment(List segs, double x1, double y1,
+ double x2, double y2) {
+ double dx = x2 - x1;
+ double dy = y2 - y1;
+ if (dx * dx + dy * dy >= MIN_SEGMENT * MIN_SEGMENT) {
+ segs.add(new Line2D.Double(x1, y1, x2, y2));
+ }
+ }
+
+ /** Узел строки в виде сверху: серия 0 — внизу. */
+ private static double serY(int r, Rectangle2D plot, int nSer) {
+ return plot.getY() + plot.getHeight() * (1 - (double) r / (nSer - 1));
}
/** Высота листа на срезе x: линейная интерполяция ломаной ряда. */
diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/ChartTypesDocxGenerator.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/ChartTypesDocxGenerator.java
index 561d04c..6c017dc 100644
--- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/ChartTypesDocxGenerator.java
+++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/ChartTypesDocxGenerator.java
@@ -11,11 +11,11 @@ import java.util.zip.ZipEntry;
import java.util.zip.ZipOutputStream;
/**
- * Генератор фикстуры {@code samples/chart-types.docx}: 12 диаграмм: 9 типов,
+ * Генератор фикстуры {@code samples/chart-types.docx}: 13 диаграмм: 9 типов,
* которых POI не пишет (scatter, bubble, radar, stock, ofPie, bar3D,
* area3D, line3D, surface2D), + ofPie pie-вариант + lineChart и линейчатая
- * (barDir=bar) с c:grouping=stacked — chart-XML
- * литералами по ECMA-376 §21.2
+ * (barDir=bar) с c:grouping=stacked + wireframe-поверхность
+ * (c:wireframe val="1") — chart-XML литералами по ECMA-376 §21.2
* (фикстура проходит docs/standards/validate-fixtures.py). Регрессия —
* WordPdfConverterTest#chartTypes_allTypesRenderAsImages.
*
@@ -38,8 +38,8 @@ public final class ChartTypesDocxGenerator {
List titles = List.of(
"Точечная", "Пузырьковая", "Лепестковая", "Биржевая",
"Кольцевая-доля", "Объёмная с столбцами", "Объёмная с областями",
- "Объёмная с линиями", "Поверхность", "График с накоплением",
- "Вторичная круговая", "Линейчатая с накоплением");
+ "Объёмная с линиями", "Поверхность", "Поверхность без заливки",
+ "График с накоплением", "Вторичная круговая", "Линейчатая с накоплением");
List charts = new ArrayList<>();
charts.add(scatter());
charts.add(bubble());
@@ -50,6 +50,7 @@ public final class ChartTypesDocxGenerator {
charts.add(area3d());
charts.add(line3d());
charts.add(surface());
+ charts.add(surfaceWireframe());
charts.add(stackedLine());
charts.add(ofPiePie());
charts.add(stackedBar());
@@ -219,6 +220,30 @@ public final class ChartTypesDocxGenerator {
+ catAx(1, 2) + valAx(2, "l", 1);
}
+ /**
+ * c:wireframe val="1" (§21.2.2.230) — wireframe-контур: рендерится видом
+ * сверху (изолинии, сетка catAx/serAx, рамка). Оси — локальными
+ * литералами с c:majorGridlines (общие хелперы сетку не пишут); serAx —
+ * axPos="r", как Word пишет для поверхностей. Порядок элементов
+ * CT_CatAx/CT_SerAx по XSD: axId, scaling, delete, axPos,
+ * majorGridlines, …, crossAx.
+ */
+ private static String surfaceWireframe() {
+ return ""
+ + ser("Строка 1", cat("К1", "К2", "К3", "К4", "К5"), num("1", "2", "3", "2", "1"))
+ + ser("Строка 2", cat("К1", "К2", "К3", "К4", "К5"), num("2", "4", "6", "4", "2"))
+ + ser("Строка 3", cat("К1", "К2", "К3", "К4", "К5"), num("3", "6", "9", "6", "3"))
+ + ser("Строка 4", cat("К1", "К2", "К3", "К4", "К5"), num("2", "4", "6", "4", "2"))
+ + ""
+ + ""
+ + ""
+ + ""
+ + valAx(2, "l", 1)
+ + ""
+ + ""
+ + "";
+ }
+
private static String stackedLine() {
return ""
+ ser("План", cat("Q1", "Q2", "Q3"), num("4", "7", "5"))
@@ -282,8 +307,12 @@ public final class ChartTypesDocxGenerator {
}
private static String serAx(int id, int cross) {
+ return serAx(id, cross, "b");
+ }
+
+ private static String serAx(int id, int cross, String pos) {
return ""
- + "";
+ + "";
}
private static void put(ZipOutputStream zos, String name, String xml) throws IOException {
diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java
index 61344aa..e598fe9 100644
--- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java
+++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java
@@ -171,9 +171,10 @@ class WordPdfConverterTest {
/**
* Фикстура chart-types.docx (создана вручную, chart-XML литералами — POI
- * эти типы не пишет): все двенадцать — точечная, пузырьковая,
+ * эти типы не пишет): все тринадцать — точечная, пузырьковая,
* лепестковая, биржевая, кольцевая-доля, три объёмных декартовых,
- * поверхность, график с накоплением и линейчатая с накоплением
+ * поверхность, wireframe-поверхность (c:wireframe val="1"),
+ * график с накоплением и линейчатая с накоплением
* (c:grouping=stacked, §21.2.2.76) и pie-вариант кольцевой-доли
* (c:ofPieType="pie") —
* рендерятся в растр, а не удаляются с warn.
@@ -185,8 +186,8 @@ class WordPdfConverterTest {
String text = norm(pdfText(pdf));
assertTrue(text.contains("Типы диаграмм"), "пропал текст: " + text);
- assertEquals(12, distinctImageCount(pdf),
- "каждый из 12 графиков должен стать PNG-вставкой");
+ assertEquals(13, distinctImageCount(pdf),
+ "каждый из 13 графиков должен стать PNG-вставкой");
}
/**
diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainterTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainterTest.java
index b4190b2..d3c2a63 100644
--- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainterTest.java
+++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainterTest.java
@@ -3,17 +3,22 @@ package ru.pjandro.wordpdf.internal.chart;
import org.junit.jupiter.api.Test;
import java.awt.Color;
+import java.awt.geom.Line2D;
import java.awt.image.BufferedImage;
+import java.util.List;
import static org.junit.jupiter.api.Assertions.*;
/**
- * Контурная поверхностная диаграмма (ECMA-376 §21.2.2.204): лист между
+ * Контурная диаграмма (ECMA-376 §21.2.2.204). Заливочный режим: лист между
* ломаными соседних рядов режется контурными полосами высот (c:bandFmts,
- * §21.2.2.13 — от низкого к высокого; без них — палитра), c:wireframe —
- * сетка из ломаных рядов и линий по категориям без заливок. Регрессия —
- * Surface2dPainterTest, фикстура samples/chart-types.docx
- * (WordPdfConverterTest#chartTypes_allTypesRenderAsImages).
+ * §21.2.2.13 — от низкого к высокого; без них — палитра). c:wireframe
+ * (§21.2.2.230) — вид сверху, как Word: X — категории, Y — ряды (серия 0
+ * внизу), без заливок и оси значений; рисуются изолинии на внутренних
+ * границах полос высот lo + k·unit цветом полосы НИЖЕ уровня (marching
+ * squares, седло — по среднему ячейки), сетка узлов catAx/serAx и рамка
+ * области построения. Регрессия — Surface2dPainterTest, фикстура
+ * samples/chart-types.docx (WordPdfConverterTest#chartTypes_allTypesRenderAsImages).
*/
class Surface2dPainterTest {
@@ -21,7 +26,18 @@ class Surface2dPainterTest {
private static final Color ACCENT2 = new Color(0xED7D31);
private static final Color ACCENT3 = new Color(0xA5A5A5);
private static final Color ACCENT4 = new Color(0xFFC000);
- private static final Color GRID = new Color(0xD9, 0xD9, 0xD9);
+
+ /** Масштаб растра: 300 dpi → pt·25/6 px. */
+ private static final double PX = 300.0 / 72.0;
+
+ /**
+ * Геометрия render(): box = (4, 4, 211.23, 141.08) pt; в wireframe без
+ * подписей осей plot = (12, 4, 203.23, 135.08) pt (serGutter 8, catGutter 6).
+ */
+ private static final double PLOT_X = 12;
+ private static final double PLOT_W = 203.23;
+ private static final double PLOT_Y = 4;
+ private static final double PLOT_H = 135.08;
/**
* Плоские ряды 0/2/4: lo=0, hi=4, unit=1 → лист от 0 до 4 делится на
@@ -41,21 +57,217 @@ class Surface2dPainterTest {
"полоса 3-4 не accent4: " + hex(px(img, 400, 87)));
}
- /** wireframe: заливок нет, есть сетка листа цветом gridlines. */
+ /**
+ * Вид сверху, z[r][c] = c: lo=0, hi=4, unit=1 → изолинии уровней 1, 2, 3 —
+ * вертикали точно в узлах xOf(1..3) цветами полос НИЖЕ уровня
+ * (accent1/2/3); между изолиниями — белый.
+ */
@Test
- void wireframe_gridOnly() {
- BufferedImage img = render(surfaceSpec(true));
- assertFalse(matches(px(img, 400, 507), ACCENT1),
- "wireframe не должен заливать полосы");
- long grid = 0;
+ void wireframeContour_verticalIsolinesAtNodeColumns() {
+ double[][] z = {
+ {0, 1, 2, 3, 4},
+ {0, 1, 2, 3, 4},
+ {0, 1, 2, 3, 4},
+ };
+ BufferedImage img = render(wireframeSpec(z));
+ int y = (int) Math.round((PLOT_Y + PLOT_H / 2) * PX);
+ assertTrue(matches(px(img, xPx(1, 5), y), ACCENT1),
+ "изолиния уровня 1 не accent1: " + hex(px(img, xPx(1, 5), y)));
+ assertTrue(matches(px(img, xPx(2, 5), y), ACCENT2),
+ "изолиния уровня 2 не accent2: " + hex(px(img, xPx(2, 5), y)));
+ assertTrue(matches(px(img, xPx(3, 5), y), ACCENT3),
+ "изолиния уровня 3 не accent3: " + hex(px(img, xPx(3, 5), y)));
+ int between = (int) Math.round((xPt(0, 5) + xPt(1, 5)) / 2 * PX);
+ assertFalse(isAccent(px(img, between, y)),
+ "между изолиниями не белый: " + hex(px(img, between, y)));
+ }
+
+ /**
+ * z[r][c] = c + 0.5: уровень 1 (lo=0, hi=5, unit=1) пересекает ребро
+ * c0→c1 в t=0.5 — изолиния на середине шага категорий, не в узле.
+ */
+ @Test
+ void wireframeContour_interpolatedCrossingPosition() {
+ double[][] z = {
+ {0.5, 1.5, 2.5, 3.5, 4.5},
+ {0.5, 1.5, 2.5, 3.5, 4.5},
+ {0.5, 1.5, 2.5, 3.5, 4.5},
+ };
+ BufferedImage img = render(wireframeSpec(z));
+ int y = (int) Math.round((PLOT_Y + PLOT_H / 2) * PX);
+ double xLevel1 = xPt(0, 5) + (xPt(1, 5) - xPt(0, 5)) * 0.5;
+ int xc = (int) Math.round(xLevel1 * PX);
+ boolean found = false;
+ for (int x = xc - 3; x <= xc + 3; x++) {
+ if (matches(px(img, x, y), ACCENT1)) {
+ found = true;
+ }
+ }
+ assertTrue(found, "изолиния уровня 1 не найдена у x=" + xc);
+ assertFalse(isAccent(px(img, xc - 25, y)),
+ "слева от изолинии не белый: " + hex(px(img, xc - 25, y)));
+ }
+
+ /**
+ * 4 ряда × 3 категории, z[r][c] = r: lo=0, hi=3, unit=1 → горизонтали
+ * уровней 1, 2 в узлах serY(1), serY(2) цветами accent1/2; серия 0 — внизу
+ * (serY(1) ниже serY(2) на экране).
+ */
+ @Test
+ void wireframeContour_horizontalIsolinesAcrossSeries() {
+ double[][] z = {
+ {0, 0, 0},
+ {1, 1, 1},
+ {2, 2, 2},
+ {3, 3, 3},
+ };
+ BufferedImage img = render(wireframeSpec(z));
+ int x = (int) Math.round((PLOT_X + PLOT_W / 2) * PX);
+ int y1 = yPx(1, 4);
+ int y2 = yPx(2, 4);
+ assertTrue(y1 > y2, "серия 0 должна быть внизу: serY(1)=" + y1 + " serY(2)=" + y2);
+ assertTrue(matches(px(img, x, y1), ACCENT1),
+ "изолиния уровня 1 не accent1: " + hex(px(img, x, y1)));
+ assertTrue(matches(px(img, x, y2), ACCENT2),
+ "изолиния уровня 2 не accent2: " + hex(px(img, x, y2)));
+ assertFalse(isAccent(px(img, x, (y1 + y2) / 2)),
+ "между изолиниями не белый: " + hex(px(img, x, (y1 + y2) / 2)));
+ }
+
+ /**
+ * «Холм» (данные 13-го графика фикстуры chart-types): wireframe рисует
+ * линии, а не заливки — акцентных пикселей меньше 2% области построения.
+ */
+ @Test
+ void wireframeContour_noFills() {
+ double[][] z = {
+ {1, 2, 3, 2, 1},
+ {2, 4, 6, 4, 2},
+ {3, 6, 9, 6, 3},
+ {2, 4, 6, 4, 2},
+ };
+ BufferedImage img = render(wireframeSpec(z));
+ long accent = 0;
for (int y = 0; y < img.getHeight(); y++) {
for (int x = 0; x < img.getWidth(); x++) {
- if (matches(img.getRGB(x, y), GRID)) {
- grid++;
+ if (isAccent(img.getRGB(x, y))) {
+ accent++;
}
}
}
- assertTrue(grid > 500, "сетки wireframe не найдено");
+ long plotPx = Math.round(PLOT_W * PX) * Math.round(PLOT_H * PX);
+ assertTrue(accent < plotPx * 2 / 100,
+ "wireframe не должен заливать полосы: акцентных px " + accent
+ + " из " + plotPx);
+ }
+
+ /**
+ * Седло z=(A,B,C,D)=(0,2,0,2), level 1: avg=1 >= level → сегменты огибают
+ * «внутренние» углы B и D: (середина A-B ↔ середина B-C) и
+ * (середина C-D ↔ середина D-A).
+ */
+ @Test
+ void cellSegments_saddleWrapsInsideCorners() {
+ List segs = Surface2dPainter.cellSegments(
+ 0, 2, 0, 2, 1, 0, 10, 0, 10);
+ assertEquals(2, segs.size(), "седло должно дать 2 сегмента");
+ assertTrue(hasSegment(segs, 5, 0, 10, 5), "нет сегмента середина(A-B)–середина(B-C)");
+ assertTrue(hasSegment(segs, 5, 10, 0, 5), "нет сегмента середина(C-D)–середина(D-A)");
+ }
+
+ /**
+ * Узлы B и C точно на уровне (z=(0,1,1,0), level 1): изолиния проходит
+ * точно по узлам — сегмент B–C, без диагоналей в ячейку.
+ */
+ @Test
+ void cellSegments_exactLevelNodesLineThroughNode() {
+ List segs = Surface2dPainter.cellSegments(
+ 0, 1, 1, 0, 1, 0, 10, 0, 10);
+ assertEquals(1, segs.size(), "ожидался один сегмент по узлам уровня");
+ assertTrue(hasSegment(segs, 10, 0, 10, 10), "сегмент должен идти B–C");
+ }
+
+ /**
+ * Оба конца ребра A-B точно на уровне (z=(1,1,0,0), level 1): всё рёбер —
+ * сегмент (иначе вдоль ребра дыра в изолинии).
+ */
+ @Test
+ void cellSegments_bothEndsOnLevel_edgeIsSegment() {
+ List segs = Surface2dPainter.cellSegments(
+ 1, 1, 0, 0, 1, 0, 10, 0, 10);
+ assertEquals(1, segs.size(), "ожидался один сегмент по ребру A-B");
+ assertTrue(hasSegment(segs, 0, 0, 10, 0), "сегмент должен идти A–B");
+ }
+
+ /**
+ * Ячейка (3,6,4,2), level 4: узел C точно на уровне, соседние рёбра бьют
+ * в него дважды — после дедупликации один сегмент от поперечного
+ * пересечения e0 до узла C (без дедупликации — «3 удара» и дыра; случай
+ * фикстуры hill: узел z=4).
+ */
+ @Test
+ void cellSegments_nodeCrossingNotDropped() {
+ List segs = Surface2dPainter.cellSegments(
+ 3, 6, 4, 2, 4, 0, 10, 0, 10);
+ assertEquals(1, segs.size(), "изолиния через узел не должна теряться");
+ assertTrue(hasSegment(segs, 10.0 / 3, 0, 10, 10),
+ "сегмент должен идти от t=1/3 на A-B до узла C");
+ }
+
+ /** Все узлы ниже уровня — сегментов нет. */
+ @Test
+ void cellSegments_allBelowLevel_empty() {
+ assertTrue(Surface2dPainter.cellSegments(0, 0, 0, 0, 1, 0, 10, 0, 10).isEmpty(),
+ "ниже уровня изолинии быть не должно");
+ }
+
+ /** Спека wireframe-поверхности без подписей осей (серии из z, категории пустые). */
+ private static ChartSpec wireframeSpec(double[][] z) {
+ ChartSpec spec = new ChartSpec();
+ spec.type = ChartSpec.Type.SURFACE;
+ spec.wireframe = true;
+ spec.legendPos = null;
+ spec.valAxis = new ChartSpec.AxisSpec();
+ for (double[] row : z) {
+ ChartSpec.Series s = new ChartSpec.Series();
+ for (double v : row) {
+ s.values.add(v);
+ }
+ spec.series.add(s);
+ }
+ return spec;
+ }
+
+ /** Пиксельная координата узла категории: xOf(c) = 12 + 203.23·c/(nCat−1). */
+ private static double xPt(double c, int nCat) {
+ return PLOT_X + PLOT_W * c / (nCat - 1);
+ }
+
+ private static int xPx(double c, int nCat) {
+ return (int) Math.round(xPt(c, nCat) * PX);
+ }
+
+ /** Пиксельная координата узла ряда: serY(r) = 4 + 135.08·(1 − r/(nSer−1)), серия 0 внизу. */
+ private static int yPx(double r, int nSer) {
+ return (int) Math.round((PLOT_Y + PLOT_H * (1 - r / (nSer - 1))) * PX);
+ }
+
+ private static boolean hasSegment(List segs,
+ double x1, double y1, double x2, double y2) {
+ for (Line2D.Double s : segs) {
+ boolean direct = close(s.getX1(), x1) && close(s.getY1(), y1)
+ && close(s.getX2(), x2) && close(s.getY2(), y2);
+ boolean reversed = close(s.getX1(), x2) && close(s.getY1(), y2)
+ && close(s.getX2(), x1) && close(s.getY2(), y1);
+ if (direct || reversed) {
+ return true;
+ }
+ }
+ return false;
+ }
+
+ private static boolean close(double a, double b) {
+ return Math.abs(a - b) < 1e-9;
}
private static ChartSpec surfaceSpec(boolean wireframe) {
@@ -89,6 +301,11 @@ class Surface2dPainterTest {
&& Math.abs((rgb & 0xFF) - c.getBlue()) <= 24;
}
+ private static boolean isAccent(int rgb) {
+ return matches(rgb, ACCENT1) || matches(rgb, ACCENT2)
+ || matches(rgb, ACCENT3) || matches(rgb, ACCENT4);
+ }
+
private static String hex(int rgb) {
return String.format("#%06X", rgb & 0xFFFFFF);
}
diff --git a/wordpdf-core/src/test/resources/samples/chart-types.docx b/wordpdf-core/src/test/resources/samples/chart-types.docx
index cceda99..f849208 100644
Binary files a/wordpdf-core/src/test/resources/samples/chart-types.docx and b/wordpdf-core/src/test/resources/samples/chart-types.docx differ