From c7af4185cc5af336c7e0d17b24f14fb0fe828dd3 Mon Sep 17 00:00:00 2001 From: Pjandro Date: Sun, 25 Oct 2026 15:20:57 +0000 Subject: [PATCH] =?UTF-8?q?chart:=20lineChart=20c:grouping=20stacked/perce?= =?UTF-8?q?ntStacked=20(=C2=A721.2.2.76)=20=E2=80=94=20=D1=80=D1=8F=D0=B4?= =?UTF-8?q?=20=D0=BD=D0=B0=20=D0=BD=D0=B0=D0=BA=D0=BE=D0=BF=D0=BB=D0=B5?= =?UTF-8?q?=D0=BD=D0=BD=D0=BE=D0=B9=20=D1=81=D1=83=D0=BC=D0=BC=D0=B5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - ChartSpec: чтение c:grouping у CTLineChart (line3D осознанно игнорирует) - CartesianPainter (LINE): кумулятивный диапазон оси и ломаные по stackedCumulative; percentStacked — нормировка к 100 - хелперы isStacked/stackedCumulative/stackedRange переехали из Cartesian3dPainter в ChartRenderer (общие для 2-D и 3-D) - фикстура chart-types.docx: +10-я диаграмма «График с накоплением»; тест переименован в chartTypes_allTypesRenderAsImages (чинит 14 stale-javadoc-ссылок), assertEquals(10, …) - юниты ChartSpecTest/ChartRendererTest + пиксельные CartesianPainterTest (инверсия порядка линий stacked vs standard; плоский верх 100% в percentStacked) --- AGENTS.md | 8 +- .../internal/chart/Cartesian3dPainter.java | 62 +--------- .../internal/chart/CartesianPainter.java | 30 +++-- .../wordpdf/internal/chart/ChartRenderer.java | 56 +++++++++ .../wordpdf/internal/chart/ChartSpec.java | 7 +- .../wordpdf/ChartTypesDocxGenerator.java | 16 ++- .../pjandro/wordpdf/WordPdfConverterTest.java | 15 +-- .../internal/chart/CartesianPainterTest.java | 115 ++++++++++++++++++ .../internal/chart/ChartRendererTest.java | 54 ++++++++ .../wordpdf/internal/chart/ChartSpecTest.java | 28 +++++ .../test/resources/samples/chart-types.docx | Bin 8610 -> 9400 bytes 11 files changed, 307 insertions(+), 84 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 474a0f9..5ca5986 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, иначе циклы делений вечные) → пейнтеры `CartesianPainter`/`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` (главный пирог + вторичный пирог/стек, разбиение по `c:splitType` §21.2.2.155 (splitPos — MS-OI29500 §2.1.1554a/b), связи `c:serLines`)/`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` (главный пирог + вторичный пирог/стек, разбиение по `c:splitType` §21.2.2.155 (splitPos — MS-OI29500 §2.1.1554a/b), связи `c:serLines`)/`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`. ### Критические инварианты (нарушение = битый вывод) @@ -156,12 +156,12 @@ gateway). Кеш раннеров — сервер act_runner (серверна - Гейт `maven-pmd-plugin` 3.28.0 на `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). Версия PMD-движка в pom не пинится (тянется плагином). - Гейт JaCoCo `0.8.15`: `jacoco:check` (правило BUNDLE, LINE COVEREDRATIO `0.90` — обоих модулей; в `wordpdf-core/pom.xml` execution `check` переопределён и добавляет BRANCH COVEREDRATIO `0.85` — только для core, у app бранчи ниже порога) на `verify`; агент подключается в surefire через `argLine` = `@{argLine} -Djava.awt.headless=true` (свойство `argLine` в корневом pom по умолчанию пусто и перезаписывается `prepare-agent` — `mvn test -Djacoco.skip=true` без агента работоспособно); `report` и `check` оба на `verify`, report раньше — при провале порога отчёт уже на диске; отчёты `target/site/jacoco/` (html+xml, xml нужен CI-сводке). Плотность покрытия держат тесты, а не заглушки: промахи в основном недостижимые IOException/catch-ветки (`GlyphFont`, `BundledFonts`) и защитные ветви сканеров нормализаторов/валидатора, разобранные в комментариях к тестам. -- 33 тестовых класса / 429 `@Test` (core 27/389, app 6/40: ConvertController 20 + ApiKeyFilter 8 + ConversionService 5 + ApiExceptionHandler 4 + ConvertLimits 2 + ConversionTimeout 1). 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`). +- 34 тестовых класса / 455 `@Test` (core 28/415, app 6/40: ConvertController 20 + ApiKeyFilter 8 + ConversionService 5 + ApiExceptionHandler 4 + ConvertLimits 2 + ConversionTimeout 1). 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 таблицах). - Пиксели (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` (9 новых типов диаграмм; пересоздание — `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` (10 графиков: 9 типов + lineChart `c:grouping`=stacked; пересоздание — `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`); `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-легенда). +- Регрессивные пары (фикс = нормализатор/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-легенда). - UI-тестов нет; гейт SPA — `npm run build` (tsc -b) + `npm run lint` (oxlint, `.oxlintrc.json`: rules-of-hooks error, only-export-components warn). Прод-автотесты (pytest 9.1.1 + requests 2.34.2, 21 проверка — 17 под маркером `needs_key` (SKIP без ключа), 4 открытых: health/SPA-root/swagger/spec; env-конфиг, `mise exec -- python -m pytest -q .` из `prod-autotests/`) гоняются CI после deploy против живого прода. diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Cartesian3dPainter.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Cartesian3dPainter.java index f0b3f12..fcc8cfc 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Cartesian3dPainter.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Cartesian3dPainter.java @@ -73,11 +73,11 @@ final class Cartesian3dPainter { // игнорируется (Word UI не предлагает 3-D Stacked Line), горизонтальный // bar3D остаётся кластерным. boolean stacked = (bar3d && !horizontal || spec.type == ChartSpec.Type.AREA3D) - && isStacked(spec.grouping); + && ChartRenderer.isStacked(spec.grouping); boolean percent = stacked && "percentStacked".equalsIgnoreCase(spec.grouping); // Кумулятивные значения по категориям: ряд si — полоса/сегмент cum[si]..cum[si+1]. - double[][] cum = stacked ? stackedCumulative(spec, percent) : null; - double[] range = stacked ? stackedRange(cum) : ChartRenderer.valueRange(spec); + double[][] cum = stacked ? ChartRenderer.stackedCumulative(spec, percent) : null; + double[] range = stacked ? ChartRenderer.stackedRange(cum) : ChartRenderer.valueRange(spec); double[] bounds = ChartRenderer.axisBounds(valAxis, range[0], range[1]); double lo = bounds[0]; double hi = bounds[1]; @@ -278,62 +278,6 @@ final class Cartesian3dPainter { return new Column(center, faces); } - /** c:grouping stacked/percentStacked (§21.2.2.76). */ - private static boolean isStacked(String grouping) { - return "stacked".equalsIgnoreCase(grouping) - || "percentStacked".equalsIgnoreCase(grouping); - } - - /** Кумулятивные значения stacked: cum[si][c] — сумма рядов 0..si в категории c; - * percentStacked — доля от суммы категории ×100 (сумма 0 → 0). */ - private static double[][] stackedCumulative(ChartSpec spec, boolean percent) { - int nSer = spec.series.size(); - int nCat = 0; - for (ChartSpec.Series s : spec.series) { - nCat = Math.max(nCat, s.values.size()); - } - double[] totals = new double[nCat]; - if (percent) { - for (ChartSpec.Series s : spec.series) { - for (int c = 0; c < s.values.size(); c++) { - Double v = s.values.get(c); - if (v != null) { - totals[c] += v; - } - } - } - } - double[][] cum = new double[nSer][nCat]; - for (int c = 0; c < nCat; c++) { - double running = 0; - for (int si = 0; si < nSer; si++) { - List vals = spec.series.get(si).values; - Double v = c < vals.size() ? vals.get(c) : null; - double add = v == null ? 0 : v; - if (percent) { - add = totals[c] == 0 ? 0 : add / totals[c] * 100.0; - } - running += add; - cum[si][c] = running; - } - } - return cum; - } - - /** Диапазон значений stacked: от 0 до максимума кумулятивных вершин (учитывая - * отрицательные суммы). */ - private static double[] stackedRange(double[][] cum) { - double min = 0; - double max = 0; - for (double[] row : cum) { - for (double v : row) { - min = Math.min(min, v); - max = Math.max(max, v); - } - } - return new double[]{min, max}; - } - /** Сегмент stacked bar3D: box от wBottom до wTop на полной полосе глубины * категории (центр v=0, colD от c:gapDepth). */ private static Column makeStackedColumn(Color color, int c, int nCat, diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/CartesianPainter.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/CartesianPainter.java index ef3e689..e4f20b0 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/CartesianPainter.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/CartesianPainter.java @@ -35,7 +35,12 @@ final class CartesianPainter { } List cats = categoriesOf(spec, nCat); - double[] range = ChartRenderer.valueRange(spec); + // §21.2.2.76 + §21.2.3.17: stacked — ряд на накопленной сумме предыдущих; + // percentStacked — суммы категорий нормируются к 100. Только LINE (2-D). + boolean stacked = spec.type == ChartSpec.Type.LINE && ChartRenderer.isStacked(spec.grouping); + boolean percent = stacked && "percentStacked".equalsIgnoreCase(spec.grouping); + double[][] cum = stacked ? ChartRenderer.stackedCumulative(spec, percent) : null; + double[] range = stacked ? ChartRenderer.stackedRange(cum) : ChartRenderer.valueRange(spec); double[] bounds = ChartRenderer.axisBounds(valAxis, range[0], range[1], true); double lo = bounds[0]; double hi = bounds[1]; @@ -110,7 +115,7 @@ final class CartesianPainter { // 3. Ряды switch (spec.type) { - case LINE -> drawLines(g, spec, plot, palette, lo, hi, nCat, horizontal); + case LINE -> drawLines(g, spec, plot, palette, lo, hi, nCat, horizontal, cum); case AREA -> drawAreas(g, spec, plot, palette, lo, hi, nCat, horizontal); case BAR, BAR_HORIZONTAL -> drawBars(g, spec, plot, palette, lo, hi, nCat, horizontal); default -> { @@ -226,7 +231,7 @@ final class CartesianPainter { private static void drawLines(Graphics2D g, ChartSpec spec, Rectangle2D plot, List palette, double lo, double hi, int nCat, - boolean horizontal) { + boolean horizontal, double[][] cum) { for (int si = 0; si < spec.series.size(); si++) { ChartSpec.Series s = spec.series.get(si); Color c = s.lineColor != null ? s.lineColor : s.fillAt(si, palette); @@ -236,13 +241,20 @@ final class CartesianPainter { BasicStroke.JOIN_ROUND)); List along = new ArrayList<>(); List cross = new ArrayList<>(); - for (int i = 0; i < s.values.size(); i++) { - Double v = s.values.get(i); - if (v == null) { - continue; + if (cum != null) { + for (int i = 0; i < nCat; i++) { + along.add(catPos(i, nCat, plot, horizontal)); + cross.add(valuePos(cum[si][i], lo, hi, plot, horizontal)); + } + } else { + for (int i = 0; i < s.values.size(); i++) { + Double v = s.values.get(i); + if (v == null) { + continue; + } + along.add(catPos(i, nCat, plot, horizontal)); + cross.add(valuePos(v, lo, hi, plot, horizontal)); } - along.add(catPos(i, nCat, plot, horizontal)); - cross.add(valuePos(v, lo, hi, plot, horizontal)); } if (along.size() >= MIN_POLYLINE_POINTS) { g.draw(ChartRenderer.polyline(along, cross, false)); diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartRenderer.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartRenderer.java index f2e5b3a..c7c9456 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartRenderer.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartRenderer.java @@ -310,6 +310,62 @@ final class ChartRenderer { return new double[]{min, max}; } + /** c:grouping stacked/percentStacked (§21.2.2.76). */ + static boolean isStacked(String grouping) { + return "stacked".equalsIgnoreCase(grouping) + || "percentStacked".equalsIgnoreCase(grouping); + } + + /** Кумулятивные значения stacked: cum[si][c] — сумма рядов 0..si в категории c; + * percentStacked — доля от суммы категории ×100 (сумма 0 → 0). */ + static double[][] stackedCumulative(ChartSpec spec, boolean percent) { + int nSer = spec.series.size(); + int nCat = 0; + for (ChartSpec.Series s : spec.series) { + nCat = Math.max(nCat, s.values.size()); + } + double[] totals = new double[nCat]; + if (percent) { + for (ChartSpec.Series s : spec.series) { + for (int c = 0; c < s.values.size(); c++) { + Double v = s.values.get(c); + if (v != null) { + totals[c] += v; + } + } + } + } + double[][] cum = new double[nSer][nCat]; + for (int c = 0; c < nCat; c++) { + double running = 0; + for (int si = 0; si < nSer; si++) { + List vals = spec.series.get(si).values; + Double v = c < vals.size() ? vals.get(c) : null; + double add = v == null ? 0 : v; + if (percent) { + add = totals[c] == 0 ? 0 : add / totals[c] * 100.0; + } + running += add; + cum[si][c] = running; + } + } + return cum; + } + + /** Диапазон значений stacked: от 0 до максимума кумулятивных вершин (учитывая + * отрицательные суммы). */ + static double[] stackedRange(double[][] cum) { + double min = 0; + double max = 0; + for (double[] row : cum) { + for (double v : row) { + min = Math.min(min, v); + max = Math.max(max, v); + } + } + return new double[]{min, max}; + } + /** * «Круглый» шаг делений (1/2/5 * 10^n), как подбирает Word. */ diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartSpec.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartSpec.java index 48992fc..a7fcee4 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartSpec.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartSpec.java @@ -157,8 +157,8 @@ final class ChartSpec { Double hPercent; double perspective = 30; boolean rightAngledAxes = true; - /** c:grouping 3D-групп (§21.2.2.76): standard|clustered|stacked|percentStacked; - * используют только bar3D/area3D. */ + /** c:grouping (§21.2.2.76): standard|clustered|stacked|percentStacked; + * используют lineChart (2-D) и bar3D/area3D; 2-D area/bar не читают. */ String grouping = "standard"; // Спека-параметры DrawingML, исполнение Word; дефолты — ECMA-376/Word. // firstSliceAng (§21.2.2.68) определён только для CT_PieChart/CT_DoughnutChart; @@ -358,6 +358,9 @@ final class ChartSpec { } } else if (group instanceof CTLineChart g) { spec.type = Type.LINE; + if (g.getGrouping() != null && g.getGrouping().getVal() != null) { + spec.grouping = g.getGrouping().getVal().value(); + } for (CTLineSer s : g.getSer()) { spec.series.add(readLineSer(s, colors)); } 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 7d2d8d5..9951340 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/ChartTypesDocxGenerator.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/ChartTypesDocxGenerator.java @@ -11,9 +11,10 @@ import java.util.zip.ZipEntry; import java.util.zip.ZipOutputStream; /** - * Генератор фикстуры {@code samples/chart-types.docx}: 9 диаграмм типов, + * Генератор фикстуры {@code samples/chart-types.docx}: 10 диаграмм: 9 типов, * которых POI не пишет (scatter, bubble, radar, stock, ofPie, bar3D, - * area3D, line3D, surface2D) — chart-XML литералами по ECMA-376 §21.2 + * area3D, line3D, surface2D), + lineChart с c:grouping=stacked — chart-XML + * литералами по ECMA-376 §21.2 * (фикстура проходит docs/standards/validate-fixtures.py). Регрессия — * WordPdfConverterTest#chartTypes_allTypesRenderAsImages. * @@ -36,7 +37,7 @@ public final class ChartTypesDocxGenerator { List titles = List.of( "Точечная", "Пузырьковая", "Лепестковая", "Биржевая", "Кольцевая-доля", "Объёмная с столбцами", "Объёмная с областями", - "Объёмная с линиями", "Поверхность"); + "Объёмная с линиями", "Поверхность", "График с накоплением"); List charts = new ArrayList<>(); charts.add(scatter()); charts.add(bubble()); @@ -47,6 +48,7 @@ public final class ChartTypesDocxGenerator { charts.add(area3d()); charts.add(line3d()); charts.add(surface()); + charts.add(stackedLine()); StringBuilder body = new StringBuilder(); body.append("Типы диаграмм"); @@ -204,6 +206,14 @@ public final class ChartTypesDocxGenerator { + catAx(1, 2) + valAx(2, "l", 1); } + private static String stackedLine() { + return "" + + ser("План", cat("Q1", "Q2", "Q3"), num("4", "7", "5")) + + ser("Факт", cat("Q1", "Q2", "Q3"), num("6", "5", "9")) + + "" + + catAx(1, 2) + valAx(2, "l", 1); + } + // ---- фрагменты ---- /** ser с cat (или null) и val. */ 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 7ec6778..04ed49a 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java @@ -171,19 +171,20 @@ class WordPdfConverterTest { /** * Фикстура chart-types.docx (создана вручную, chart-XML литералами — POI - * эти типы не пишет): все девять новых типов — точечная, пузырьковая, - * лепестковая, биржевая, кольцевая-доля, три объёмных декартовых и - * поверхность — рендерятся в растр, а не удаляются с warn. - * Регрессия — WordPdfConverterTest#chartTypes_allNineRendered. + * эти типы не пишет): все десять типов — точечная, пузырьковая, + * лепестковая, биржевая, кольцевая-доля, три объёмных декартовых, + * поверхность и график с накоплением (c:grouping=stacked, §21.2.2.76) — + * рендерятся в растр, а не удаляются с warn. + * Регрессия — WordPdfConverterTest#chartTypes_allTypesRenderAsImages. */ @Test - void chartTypes_allNineRendered() throws Exception { + void chartTypes_allTypesRenderAsImages() throws Exception { Path pdf = convertPdf(sampleBytes("chart-types.docx"), "chart-types"); String text = norm(pdfText(pdf)); assertTrue(text.contains("Типы диаграмм"), "пропал текст: " + text); - assertEquals(9, distinctImageCount(pdf), - "каждый из 9 графиков должен стать PNG-вставкой"); + assertEquals(10, distinctImageCount(pdf), + "каждый из 10 графиков должен стать PNG-вставкой"); } /** diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/CartesianPainterTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/CartesianPainterTest.java index 30d5661..3e7acea 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/CartesianPainterTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/CartesianPainterTest.java @@ -18,6 +18,15 @@ import static org.junit.jupiter.api.Assertions.*; */ class CartesianPainterTest { + /** Полоса AA-горизонтали ~12 px при 300 dpi; запас на толщину линии. */ + private static final int BLUE_FLAT_MAX_SPREAD_PX = 20; + /** Падение суммы 4→2 ≈ половина области построения — сотни px; консервативно. */ + private static final int STACKED_DROP_MIN_PX = 60; + /** Дельта каналов к цвету ряда, включающая AA-края. */ + private static final int COLOR_MATCH_MAX_DELTA = 80; + /** Нет пикселей цвета в yStats — линия не найдена. */ + private static final int NO_LINE = Integer.MAX_VALUE; + /** Word default gapWidth=150, один ряд: bar = slot/(1 + 1,5) = 0,4·slot. */ @Test void barWidthMatchesGapWidth() { @@ -450,4 +459,110 @@ class CartesianPainterTest { } return n; } + + /** + * lineChart c:grouping=stacked (§21.2.2.76 + §21.2.3.17): ряд рисуется на + * накопленной сумме предыдущих. Данные {{2,2,2},{1,1,1}}: в standard ряд 2 + * (значение 1) НИЖЕ ряда 1 (значение 2); в stacked ряд 2 накоплен до 3 — + * ВЫШЕ. Инверсия порядка линий — наблюдаемое отличие кумулятивной отрисовки. + * Регрессия — CartesianPainterTest#stackedLine_seriesStackCumulatively. + */ + @Test + void stackedLine_seriesStackCumulatively() { + double[][] data = {{2, 2, 2}, {1, 1, 1}}; + BufferedImage plain = ChartRenderer.render(lineSpec("standard", data), + 219.23, 149.08, new DrawMlColor(null)); + int[] red = yStats(plain, Color.RED); + int[] blue = yStats(plain, Color.BLUE); + assertTrue(red[1] < NO_LINE, "красная линия (ряд 1) не найдена"); + assertTrue(blue[1] < NO_LINE, "синяя линия (ряд 2) не найдена"); + assertTrue(red[1] < blue[1], + "standard: ряд 1 (2) должен быть выше ряда 2 (1): red=" + red[1] + + ", blue=" + blue[1]); + + BufferedImage stacked = ChartRenderer.render(lineSpec("stacked", data), + 219.23, 149.08, new DrawMlColor(null)); + int[] sRed = yStats(stacked, Color.RED); + int[] sBlue = yStats(stacked, Color.BLUE); + assertTrue(sRed[1] < NO_LINE, "красная линия в stacked не найдена"); + assertTrue(sBlue[1] < NO_LINE, "синяя линия в stacked не найдена"); + assertTrue(sBlue[1] < sRed[1], + "stacked: ряд 2 накоплен до 3 — должен быть выше ряда 1 (2): red=" + + sRed[1] + ", blue=" + sBlue[1]); + } + + /** + * percentStacked: суммы категорий (4 и 2) нормированы к 100 — верхний ряд + * плоский на 100%; в stacked те же данные дают снижение 4→2. Различие + * percentStacked/stacked закреплено spread-замером. + * Регрессия — CartesianPainterTest#percentStackedLine_topSeriesFlatAtHundred. + */ + @Test + void percentStackedLine_topSeriesFlatAtHundred() { + double[][] data = {{1, 1}, {3, 1}}; + BufferedImage percent = ChartRenderer.render(lineSpec("percentStacked", data), + 219.23, 149.08, new DrawMlColor(null)); + int[] pRed = yStats(percent, Color.RED); + int[] pBlue = yStats(percent, Color.BLUE); + assertTrue(pRed[1] < NO_LINE, "красная линия в percent не найдена"); + assertTrue(pBlue[1] < NO_LINE, "синяя линия в percent не найдена"); + assertTrue(pBlue[2] - pBlue[0] <= BLUE_FLAT_MAX_SPREAD_PX, + "percentStacked: верхний ряд всегда 100% — линия должна быть плоской, spread=" + + (pBlue[2] - pBlue[0])); + assertTrue(pBlue[1] < pRed[1], + "percentStacked: 100% выше 25%: blue=" + pBlue[1] + ", red=" + pRed[1]); + + BufferedImage stacked = ChartRenderer.render(lineSpec("stacked", data), + 219.23, 149.08, new DrawMlColor(null)); + int[] sBlue = yStats(stacked, Color.BLUE); + assertTrue(sBlue[1] < NO_LINE, "синяя линия в stacked не найдена"); + assertTrue(sBlue[2] - sBlue[0] >= STACKED_DROP_MIN_PX, + "stacked: сумма 4→2 — линия снижается, spread=" + (sBlue[2] - sBlue[0])); + } + + /** LINE-спека с заданным grouping; ряды — явные RED/BLUE без маркеров. */ + private static ChartSpec lineSpec(String grouping, double[][] data) { + ChartSpec spec = new ChartSpec(); + spec.type = ChartSpec.Type.LINE; + spec.grouping = grouping; + spec.legendPos = null; + DrawMlText.Style style = new DrawMlText.Style(9, false, false, + new Color(0x59, 0x59, 0x59), "carlito"); + spec.catAxis = new ChartSpec.AxisSpec(); + spec.catAxis.labelStyle = style; + spec.valAxis = new ChartSpec.AxisSpec(); + spec.valAxis.labelStyle = style; + Color[] colors = {Color.RED, Color.BLUE}; + for (int si = 0; si < data.length; si++) { + ChartSpec.Series s = new ChartSpec.Series(); + s.marker = false; + s.lineColor = colors[si]; + for (double v : data[si]) { + s.values.add(v); + } + spec.series.add(s); + } + return spec; + } + + /** {minY, medianY, maxY} пикселей цвета target (с AA-краями); NO_LINE — нет. */ + private static int[] yStats(BufferedImage img, Color target) { + List ys = new ArrayList<>(); + for (int y = 0; y < img.getHeight(); y++) { + for (int x = 0; x < img.getWidth(); x++) { + int rgb = img.getRGB(x, y); + int dr = Math.abs(((rgb >> 16) & 0xFF) - target.getRed()); + int dg = Math.abs(((rgb >> 8) & 0xFF) - target.getGreen()); + int db = Math.abs((rgb & 0xFF) - target.getBlue()); + if (Math.max(Math.max(dr, dg), db) < COLOR_MATCH_MAX_DELTA) { + ys.add(y); + break; + } + } + } + if (ys.isEmpty()) { + return new int[]{NO_LINE, NO_LINE, -1}; + } + return new int[]{ys.get(0), ys.get(ys.size() / 2), ys.get(ys.size() - 1)}; + } } diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartRendererTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartRendererTest.java index 3f98309..edfc36e 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartRendererTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartRendererTest.java @@ -127,6 +127,60 @@ class ChartRendererTest { "нулевой размах — расширяем до 1"); } + /** stackedCumulative: суммы рядов, null-вклад как 0, percent-нормировка. */ + @Test + void stackedCumulative_sumsAcrossSeries() { + ChartSpec spec = new ChartSpec(); + spec.series.add(seriesOf(1.0, 2.0)); + spec.series.add(seriesOf(10.0, 20.0)); + double[][] cum = ChartRenderer.stackedCumulative(spec, false); + assertArrayEquals(new double[]{1, 2}, cum[0]); + assertArrayEquals(new double[]{11, 22}, cum[1]); + } + + @Test + void stackedCumulative_nullContributesZero() { + ChartSpec spec = new ChartSpec(); + spec.series.add(seriesOf(1.0)); + spec.series.add(seriesOf(null, 5.0)); + double[][] cum = ChartRenderer.stackedCumulative(spec, false); + assertArrayEquals(new double[]{1, 0}, cum[0], + "нет значения у ряда 0 во второй категории — вклад 0"); + assertArrayEquals(new double[]{1, 5}, cum[1]); + } + + @Test + void stackedCumulative_percentNormalizes() { + ChartSpec spec = new ChartSpec(); + spec.series.add(seriesOf(1.0)); + spec.series.add(seriesOf(3.0)); + double[][] cum = ChartRenderer.stackedCumulative(spec, true); + assertArrayEquals(new double[]{25}, cum[0], 0.001); + assertArrayEquals(new double[]{100}, cum[1], 0.001); + ChartSpec zeros = new ChartSpec(); + zeros.series.add(seriesOf(0.0)); + zeros.series.add(seriesOf(0.0)); + double[][] zeroCum = ChartRenderer.stackedCumulative(zeros, true); + assertArrayEquals(new double[]{0}, zeroCum[0], 0.001, + "сумма категории 0 → 0, не NaN"); + assertArrayEquals(new double[]{0}, zeroCum[1], 0.001); + } + + /** stackedRange: от 0 до экстремумов кумулятивных вершин, включая отрицательные. */ + @Test + void stackedRange_coversNegativeSums() { + double[][] cum = {{-5, 1}, {-4, 2}}; + assertArrayEquals(new double[]{-5, 2}, ChartRenderer.stackedRange(cum), 0.001); + } + + private static ChartSpec.Series seriesOf(Double... values) { + ChartSpec.Series s = new ChartSpec.Series(); + for (Double v : values) { + s.values.add(v); + } + return s; + } + /** niceUnit/nextUnit: границы 1/2/5·10ⁿ и невалидный вход. */ @Test void niceAndNextUnitBoundaries() { diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartSpecTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartSpecTest.java index 95f892c..30e7adf 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartSpecTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartSpecTest.java @@ -1278,6 +1278,34 @@ class ChartSpecTest { assertEquals(List.of("А", "Б"), spec.series.get(0).categories); } + /** c:lineChart: c:grouping (§21.2.2.76) stacked/percentStacked/дефолт standard. */ + @Test + void lineGroupingParsed() { + CTLineChart stacked = new CTLineChart(); + CTGrouping grouping = new CTGrouping(); + grouping.setVal(STGrouping.STACKED); + stacked.setGrouping(grouping); + CTLineSer ser = new CTLineSer(); + ser.setCat(catStr("А", "Б")); + ser.setVal(numSource(numCache(1, 2))); + stacked.getSer().add(ser); + ChartSpec spec = new ChartSpec(); + ChartSpec.readGroup(stacked, spec, new DrawMlColor(null), List.of()); + assertEquals(ChartSpec.Type.LINE, spec.type); + assertEquals("stacked", spec.grouping); + + grouping.setVal(STGrouping.PERCENT_STACKED); + ChartSpec percent = new ChartSpec(); + ChartSpec.readGroup(stacked, percent, new DrawMlColor(null), List.of()); + assertEquals("percentStacked", percent.grouping); + + CTLineChart bare = new CTLineChart(); + bare.getSer().add(new CTLineSer()); + ChartSpec standard = new ChartSpec(); + ChartSpec.readGroup(bare, standard, new DrawMlColor(null), List.of()); + assertEquals("standard", standard.grouping, "нет c:grouping — дефолт модели standard"); + } + /** c:stockChart: hiLowLines/dropLines/upDownBars с цветами up/down. */ @Test void stockFlagsParsed() { diff --git a/wordpdf-core/src/test/resources/samples/chart-types.docx b/wordpdf-core/src/test/resources/samples/chart-types.docx index 701d9af7c668af691bdfe53f90c99e874df0b6bc..3f546819fe0129c10d93aa9db32057f403714f9c 100644 GIT binary patch delta 2333 zcmZ8idpwi-AAihkM0UwWTXV@Z()hXeip{mfk%*8wxfIqmRJ4ShBGv`dToNLe6cSC* zCbuS?O3D1rX_TZJl~(S#o@eXSNze1o`}2OipU>y}e7>JciDM&4$(DJj|KVF?N$&fHIJ^7(L#J@XJzB6SD7SdY~wGIUSGcDM`obIjS0}x?$nv z-hDOe7MtU79yX;=U*ZR2-}nqZdR%xwl<7AXP)SFYwxExPCdpln!co1*XeIt3WuuqG z#8$WTd736k$D)pyq1Xu-rNVf!L_H+C`StG=h3Jaj`^R;jiW z0GyWtfS>=7O_6#HfyA-BAUYw!HgZ2+4H(=3=U$7Ybb7cKv_q5HR_^_PBV=d$?QwJP zdKX&p{P1(+M+L?Hpw#x=Z3(5Mbhe4zIqlfhT!R+Y{JY#S_?dd{fR)9JQ&~xYYE-PM z13~Sr?p_`wu_oVE2ZWkb?g4atV2;B9_bjuo`L@h^YKp=3OKID*5BRdo^GmvY^3ZIHVlpZ=~ePqe5!)8hyQQtHmd7( zdyRaaxx#Iu<>0H!3fC!tOnzRmSg}I*Jago)Ia*lx548&AZE$Yj18@HYGh_w+96e8TfkNbMuFh$Q&yj>eEHoQ%Y#Vled zr}iWWLXbR_BI5qY4f{BI!v|{no6MrQ%#3wQ#g7jr2^O3_$4}QSN{g$*C3oYz8Uz6B z)qkmuJQ-648Da`+{jx*hph%DRo{K6)!<$fZfMe`b(kDHwlO>Un2J5%8y1mocEJk95 z@KfYCzvlIPczyD9SnFmZK{_}0^AWpdi`IC;^Py04QX@Ncfi_1(rp)kFN+*pi>vQqR zdtTT~lZ(|8f{aJ#0(GkpX6c7p&XXrLec8f1&ttSG(`nbejoJ$P5Kq6-M(nAAn9`D@ zZMk`e=wD=aNONIH!*Pm;=FTF)b*9DOHMozSQ?`S#nHI{BZ-xxcbEr1c@-=iSRM=Jl z`{2%uQG62WU~b6QLk6=Qvb6uciD*$;tY;op5$ECWHPTN;004L_`(GYp#G`|d6M|(xocbn6oJop1Q!BT(VaAf^=%wE!z<+z|&-)+vET9z1d zGBG(2_5VhY|1R(}KOQu@7_*9DiZ`KCDWg7Jv|cl2JXTm{}K-Gk_C zkL7wB3hV&wf)bfi)Ew=~>EOFagUPd73H+Bvg|=F)qRA;@9{(z$6{E9R^HSCLyzM)G z>?_#wu$RWf?R`2}xWSD?(~c`q`=jq>`XRR4=G9?S1$%%wedGHX)_4>6nBQBO?9;t! zv@=S*{X;hbR=p!%F<}%8^=`{0Uo`1GJn5L=Q#47wGTI=8_X{}^5hGVyDNXV3F3Cjb zxnha0kmopgGUcZYS6{Q6)5gzVZnp9>gPpZ^uKO}Xxb6L5sNR|}PNSyXoNu<|$!Y9p zH0_P_S;r2sEbYnZuY2P)67F${yMB(pU-8oQw9mfKrNdChiKiplgnYU1#-xC>eW7-T zasqYVcQb7%Cwm$LvPPRsPkR;*RBi3REDZm?C6p8W+bA!;?1iu_UW9(B?9)9gogM5s z-BHxg=_+{NAzYeb%!G~BwUA~9^xjO<`f&K8YW}nfZ~l^rM*{oDNiX^hcw@!Ti!L6N zgF%~$9@J5^6fR}#@qM#jYONE?sn9Z62(OZRb}}uwK*97rw~UOl<$By(+L?S$HMwaW zsYALt?T9(ioZM7n*)4Z2WJ4|8oixxDxbT=T*RW<@25b^NXi5bm=Kwe@=H z=ibCF(-gB6G>kOGu^twUKeGi-MgX@QYMDkL%f5&~vcojs;tr0}z(Te`B}~;frWs_Q zD#`uF4Rp4s_^Y!LWr^^An%{)cR$cbtps*918q1?rz$C)Mnv$reG_eqG zq=eypV;+HwF-pQL{p;+BtzT{o=&SCn lU$5rpYeO$fjy+E78T)Opc)H1g*#m%;;9D&X08^S`>mMY$q`d$D delta 1597 zcmdntxyYF(z?+#xgn@&DgTaGuB9EHPl+%8P4Fp{4kAB*gbw^Bt)%0!CaiNGQ{1P`O zADQSUmUHOy({o#Lnj5!lR+Sf5K6k-u`Ifcb|MpeMowHcX5$5<>XIf4Fk?Gw(v))gP z_!Om8DZF^UcvDI<+lm6Y+#oG+o+Bl^TR$k+FK{!I>|N$$C4KQ&;v1tMN&h-T*W5la zuk7W{_ktT#&&mBd*cVzf@q#r|=+eo&jFN80>h%^g<@^?FKhXVR@|rKJ*L-=s=F99g zUoyjf<%a#z(f<2x|BFW-cIw+P26(e`{5e#6R-Tc8L7I($0oj9-^BJEodGJjRWl~AL z;n;QCK!oAKYL2(oemTd>eC9L?akc8Tl~pnHt~tUKEi`GF->z5tZqHkwE|DP~%kzb6 zo^)u@9G}Onk}lz{(oeZh+Q;9|Pu#NWp1J7{mnDnlh!)hDHa8fY@jg|?`lsUevrx9l zcbGKmBX1YoRLEUcB)%nPnp2U_6r-QBtvJ#*t7HhIURbv0@zaC4iCCtZralQ-QQ^7t@Z;q|`rP+r z#1%DGUfRw&M|Sb`=P&MBR^>0=$Fb@9w&;rZ0~Hfztx2nAw-Yh&d3@qb!iD!nv3n;r zOnVmUa3CPr>R#<`n~LuY&&teCl?!!tJ$jgM;$e*Q>+>tkJd_LcS2}COD6aI?oAdo* zfJoUn6O{@2o(Hx^cb!ZVs63VCO2XK8EPt$L3r6Gh!mK#ptNEsrQ0Mcr>e_E8}FR+7`LL*B*Hwtcwdc4-o4 zX6N*0I=UZ$>`R=PD?#k9K=vli%$XqeXCQl;@TF;Svo>#ex_{y_j%((7O*a1iAi3q6 zQ>9(}xijwmv%}T=HofThRheI~%ZP8@`o-7lfsrr8&cT>*xtfECf#H%ET54FsVp!jG z$Uxx0$8gT#`^(lwy-xa~)O6idKEY$Te9r6^m9Bkz69WS#Y*;R%p7`(Q+)el5mQRd5 zvCC1L(RCWLvTCXE3cmv{cl=+~XxYE&V4${8finB;v%lKiz9b&~+FYn(GDY}8b^bof z@=eP*W0&!+EV!Iyy^w$L+Z~QSyJbHbo!8Ebub2LCFQwhB!PbOz!{f6T>Tm7JW%sn! zJuj^J{~@Pd^%gspi)Bw(|Md1>R^m2&FkdiL$wkunjF4iQ;Sn3bBspgtAw@Amm#G|q zM+Hv1bfoeGsykgVJfbC-^ws6VcKL#0c2IU`T-V(2h=GB@gB3LZB4ZggKVq$90%eK& ztje1kI3~f^lMg7dZnohrfbln9*xWPU}H2oJu<*x7&0U#$f?QWKbOxq&nSBmhO?i&Arn_4Pnx zfH$g9$k8i^&;?|vbM_8k{k_JES0JjeyHD=xPk1RDI0 z3*F$3$sd$d!Il@ApS8~bsyPmfCsfOO1;B=RD1$AJR+eG16b6g*Kt$#PMTEq_A{Ue) z7GAW9m|hArY&i$IVP__(K