From 7ffafefd27436b5b9e64b3e6720e834d7708aeff Mon Sep 17 00:00:00 2001 From: Pjandro Date: Mon, 26 Oct 2026 20:47:31 +0000 Subject: [PATCH] =?UTF-8?q?chart:=20=D0=BA=D0=BE=D0=BD=D1=82=D1=83=D1=80?= =?UTF-8?q?=D0=BD=D0=B0=D1=8F=20=D0=B4=D0=B8=D0=B0=D0=B3=D1=80=D0=B0=D0=BC?= =?UTF-8?q?=D0=BC=D0=B0=20=E2=80=94=20=D0=BE=D0=B1=D0=B0=20=D1=80=D0=B5?= =?UTF-8?q?=D0=B6=D0=B8=D0=BC=D0=B0=20=D0=B2=D0=B8=D0=B4=20=D1=81=D0=B2?= =?UTF-8?q?=D0=B5=D1=80=D1=85=D1=83,=20=D0=BF=D0=BE=D0=BB=D1=8B=D0=B5=20?= =?UTF-8?q?=D0=BC=D0=B0=D1=80=D0=BA=D0=B5=D1=80=D1=8B=20=D0=BB=D0=B5=D0=B3?= =?UTF-8?q?=D0=B5=D0=BD=D0=B4=D1=8B=20wireframe?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit surfaceChart (ECMA-376 §21.2.2.204) — «viewed from above, similar to 2-D topographic maps»: заливочный режим вместо «торца» рисует топографическую карту с залитыми полосами высот (fillBands — marching squares по ячейкам, по одному пути на полосу — нет AA-шва на общих рёбрах), без изолиний и оси значений; wireframe (§21.2.2.230) — без изменений геометрии. Маркеры легенды полос следуют заливке: залитые при wireframe=false, полые при wireframe=true (полосы не залиты нигде). Удалены drawContour/interp/yOf/ drawValueLabels/drawCategoryLabels и тест снятого вида торцом. Регрессии — Surface2dPainterTest#filledContour_*, ChartRendererTest#wireframeSurfaceLegend_hollowMarkers, фикстура samples/chart-types.docx. --- AGENTS.md | 6 +- .../wordpdf/internal/chart/ChartRenderer.java | 21 +- .../internal/chart/Surface2dPainter.java | 386 +++++++++--------- .../internal/chart/ChartRendererTest.java | 111 +++++ .../internal/chart/Surface2dPainterTest.java | 165 +++++--- 5 files changed, 440 insertions(+), 249 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 932bd6d..b6e608c 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, иначе циклы делений вечные; `axisBounds` также перебирает шаг при неконечном диапазоне и отбрасывает нечитаемый `majorUnit` при ±∞-осях scaling; общие кумулятивные хелперы 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, эмпирика запинена тестом; upDownBars обводятся контуром — `c:spPr/a:ln` solidFill/noFill/@w, дефолт чёрный 0.75pt: белая up-заливка невидима на белом фоне, регрессия `StockPainterTest#upDownBars_whiteFillBlackOutline`)/`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`…, битый `a:srgbClr/@val` — дефолт вместо падения); текст — `DrawMlText` (шрифты — тот же бандл через `BundledFontMapper.bundledFamily`, **фолбэк-семейство темы тоже алиасится** — иначе «Calibri» не находится в `GlyphFont` и текст молча уезжает в более широкий DejaVu, из-за чего переносы вылезали за фигуру, регрессия `DrawMlTextTest#fallbackFamilyAliasedToBundle`; `fitCut` гарантирует прогресс реза на 1 символе — иначе `wrapLines` вечный цикл; высота строки — из `a:lnSpc` spcPct/spcPts §21.1.2.4, регрессия `DrawMlTextTest#lineSpacingPct_compactsLines`); autofit фигур — только `normAutofit` (§21.1.2.1.2/.3: отсутствие autofit-элемента имплицирует noAutofit — заявленный кегль не ужимается, переполнение уходит за фигуру, как Word; запечённый Word-ом `fontScale` применяется, без него — подбор кегля под высоту надетого текста `DrawMlText.totalHeight` с низом `MIN_FONT_PT=4pt`; регрессии `SmartArtRendererTest#normAutofitShrinksToFit`/`#missingAutofitKeepsDeclaredSize`); заполнитель `dgm:prSet/@phldrT` («[Текст]», §21.4.3.4) не рисуется — элемент UI, в PDF Word его не показывает (`SmartArtRendererTest#emptyTxBody_noPlaceholderInk`, `render` без `CTDataModel`); утилиты `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` (см. выше) и `ChartSpec.MAX_EXTENT_EMU` (`a:ext`/`a:chExt` §21.2.2.62 — ST_PositiveSizeType без верхней границы, extent > 2^31 EMU заменяется размером якоря, иначе `BufferedImage` OOM); бросок перехватывает catch `DrawingPreRenderer.renderChart` → штатная деградация «объект удалён + warn» (`DrawingPreRenderer` log; подмена `graphic` на `pic:pic` — структурный обход `swapForPicture`, не toString-замена). Обход `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, иначе циклы делений вечные; `axisBounds` также перебирает шаг при неконечном диапазоне и отбрасывает нечитаемый `majorUnit` при ±∞-осях scaling; общие кумулятивные хелперы 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, эмпирика запинена тестом; upDownBars обводятся контуром — `c:spPr/a:ln` solidFill/noFill/@w, дефолт чёрный 0.75pt: белая up-заливка невидима на белом фоне, регрессия `StockPainterTest#upDownBars_whiteFillBlackOutline`)/`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 — оба режима вид сверху: X=категории по узлам сетки, Y=ряды, серия 0 внизу, ось значений не рисуется; заливочный — области полос высот залиты их цветами без изолиний (marching squares по ячейкам, по одному пути на полосу — нет AA-шва на общих рёбрах ячеек), `c:wireframe` §21.2.2.230 — изолинии на границах полос высот `lo+k·unit` цветом нижней полосы (c:bandFmts §21.2.2.13/.14, без них — палитра), marching squares, седло — по среднему ячейки, без заливок; сетка catAx/serAx, рамка plot; маркеры легенды следуют заливке полос: залитые при wireframe=false, полые при wireframe=true)/`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`…, битый `a:srgbClr/@val` — дефолт вместо падения); текст — `DrawMlText` (шрифты — тот же бандл через `BundledFontMapper.bundledFamily`, **фолбэк-семейство темы тоже алиасится** — иначе «Calibri» не находится в `GlyphFont` и текст молча уезжает в более широкий DejaVu, из-за чего переносы вылезали за фигуру, регрессия `DrawMlTextTest#fallbackFamilyAliasedToBundle`; `fitCut` гарантирует прогресс реза на 1 символе — иначе `wrapLines` вечный цикл; высота строки — из `a:lnSpc` spcPct/spcPts §21.1.2.4, регрессия `DrawMlTextTest#lineSpacingPct_compactsLines`); autofit фигур — только `normAutofit` (§21.1.2.1.2/.3: отсутствие autofit-элемента имплицирует noAutofit — заявленный кегль не ужимается, переполнение уходит за фигуру, как Word; запечённый Word-ом `fontScale` применяется, без него — подбор кегля под высоту надетого текста `DrawMlText.totalHeight` с низом `MIN_FONT_PT=4pt`; регрессии `SmartArtRendererTest#normAutofitShrinksToFit`/`#missingAutofitKeepsDeclaredSize`); заполнитель `dgm:prSet/@phldrT` («[Текст]», §21.4.3.4) не рисуется — элемент UI, в PDF Word его не показывает (`SmartArtRendererTest#emptyTxBody_noPlaceholderInk`, `render` без `CTDataModel`); утилиты `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` (см. выше) и `ChartSpec.MAX_EXTENT_EMU` (`a:ext`/`a:chExt` §21.2.2.62 — ST_PositiveSizeType без верхней границы, extent > 2^31 EMU заменяется размером якоря, иначе `BufferedImage` OOM); бросок перехватывает catch `DrawingPreRenderer.renderChart` → штатная деградация «объект удалён + warn» (`DrawingPreRenderer` log; подмена `graphic` на `pic:pic` — структурный обход `swapForPicture`, не toString-замена). Обход `pkg.getParts()` — только по **снимку** списка (`createImagePart` мутирует реестр → CME); rels частей — `part.getRelationshipsPart()`, НЕ `getOwningRelationshipPart()` (это rels ссылающегося); обход XML обязан раскрывать `JAXBElement`. `Combo` (Word «Комбинированная», §21.2.2.145): несколько групп в одном `c:plotArea` (`c:barChart` + `c:lineChart`/`c:areaChart`), каждая со своими `c:axId` (§21.2.2.9) — `parse` привязывает группы по id осей: `Series.renderAs` (семейство отрисовки ряда), `Series.grouping` (накопление своей группы), `Series.valAxis` + `ChartSpec.secondaryValAxis` (ось значений группы, обычно `c:axPos="r"`); `spec.valAxis`/`catAxis` — first-wins (не last-wins), `type` combo = первая группа (без `axId` в XML — поведение как у одноосных, привязка пропускается). `CartesianPainter` рисует семейства в порядке BAR→AREA→LINE (столбцы позади, линия поверх), каждая серия масштабируется по своей оси, вторичная ось — линия по правому краю + подписи справа (gridlines только если заявлена), `stacked` накапливает только внутри семейства, у stacked-серии на вторичной оси (враждебный XML) — сырые значения; легенда `lineLike` по `renderAs` ряда. Регрессии — `ChartSpecTest#combo_barAndLine_renderAsAndAxes`/`combo_sameAxis_noSecondary`, `CartesianPainterTest#combo_barsAndLineOnSecondary_bothDrawn`, фикстура `chart-types` (chart14 «Комбинация»). @@ -160,13 +160,13 @@ 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`) и защитные ветви сканеров нормализаторов/валидатора, разобранные в комментариях к тестам. -- 35 тестовых класса / 528 `@Test` (core 29/486, app 6/42: ConvertController 22 + 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` и `BundledFonts.init()` в `BundledFontsTest`). +- 35 тестовых класса / 531 `@Test` (core 29/489, app 6/42: ConvertController 22 + 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` и `BundledFonts.init()` в `BundledFontsTest`). - **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`; исключение — структурная проверка чернил в `GlyphFontTest` (без сравнения с эталоном). Эталонные файлы — `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` и VML-плейсхолдером `media/fallback.png` — 1×1 RGBA; исходный рукописный PNG был бит (IDAT length 13 при 16 байтах данных + мусор перед IEND, FOP падал `chunkType is null` в `PNGImageDecoder`) — заменён in-place на валидный, XML-части не тронуты; ручная, генератором не перезаписывать), `chart-types` (13 графиков + wireframe-поверхность + combo = 14: 9 типов + ofPie pie-вариант (`c:ofPieType`="pie") + lineChart `c:grouping`=stacked + `c:wireframe` val="1" + combo barChart+lineChart на вторичной `c:valAx` pos="r"; пересоздание — `ChartTypesDocxGenerator`). - Юниты нормализаторов работают строками (`rewrite`) + zip'ами из `ZipOutputStream`; обязательные контракты: «нечего менять → тот же массив» (`assertSame` покрыт тестами у zip-нормализаторов `DocxOnOff`/`SymbolFont`/`StrictOoxml`/`InvisibleChar` и многочастного `OleObject`; у `Field`/`GlyphCoverage` — `rewrite`→`null`) и неприкосновенность частей вне `word/*.xml` (`[Content_Types].xml`). Тесты бьют и в package-private API (`GlyphCoverageNormalizer.split(text, family)`, `ChartSpec.readTitle`). Исключение — `OleObjectNormalizerTest`: многочастный нормализатор без `rewrite`-хука, тесты только через `normalize` на in-memory zip. - App-тесты: `@SpringBootTest` + `@AutoConfigureMockMvc` (Boot 4: `org.springframework.boot.webmvc.test.autoconfigure`); три контекста — `ConvertControllerTest` (пустой ключ), `ApiKeyFilterTest` (`properties = "wordpdf.api-key=…"`), `ConvertLimitsTest`/`ConversionTimeoutTest` (`@TestPropertySource` — отдельные классы, не `@Nested`). -- Регрессивные пары (фикс = нормализатор/pre-renderer + юнит + конвертер-тест с фикстурой): `StrictOoxmlNormalizerTest`↔`strictOoxml_convertsNotRejected` (+`pageCount_strictBreaksCountedLightweight` — lightweight против strict; `indCoexistForms_convertsNotRejected` + юниты `indCoexistLeftStartUntouched`/`indStartOnlyRenamedTransitional`/`tcMarCoexistKept`/`tcMarStartOnlyRenamedTransitional`/`tcBordersElementsKeptTransitional`/`jcStartKeptTransitional`/`tabStartRenamedTransitional`/`transitionalCoexistReturnsOriginalArray` — guard сосуществования форм + strict-gating), `DocxOnOffNormalizerTest`↔`ruPlain_regularRunsUseRegularFont` (+`onOffInTextNotTouched` — `w:val` правится только внутри тега), `SymbolFontNormalizerTest`↔`symbolFonts_bulletsAreNotHash`, `FieldNormalizerTest`↔`pageNumbers_recomputedNotCached`, `InvisibleCharNormalizerTest`↔`invisibleChars_noEmptyLines`, `GlyphCoverageNormalizerTest`↔`exoticGlyphs_drawnNotHash`, `OleObjectNormalizerTest`↔`oleObjects_removedAndConverted`/`drawingErrors_errorFlagRejectsOle` (+app `errorFlagOle_rejected`/`oleObjects_removedByDefault`; сохранение плейсхолдера — юниты `objectWithImagedata_placeholderKept`/`objectWithoutImage_removed`/`objectWithDrawing_reusedVerbatim`/`controlBlockRemoved`/`sizeFromDxaOrig`/`styleUnits_allConvertToEmu`/`objectWithoutBin_stillRewritten`/`externalOleLinkRelRemoved`/`errorFlagObjectWithoutBin_rejects`, в `oleObjects_removedAndConverted` — `distinctImageCount==1`, RGBA FOP режет на картинку+SMask), `WordPdfValidatorTest`↔`staleCachePageCountRejectedBeforeRender` (+`checkPageCount_limitBoundary` 99/100/101, `cachedPagesUnreadableFallsBackToZero` — нечитаемый `` → 0, `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), `methodNotSupportedReturns405`/`badContentTypeReturns415` (405/415 вместо catch-all 500); DoS/корректность core: `ChartSpecTest#hugePointIndex_rejectedNotOom`/`hugePtCount_rejectedNotOom`/`hugeCategoryIndex_rejectedNotOom` (`MAX_POINTS`), `Surface3dPainterTest#axisBounds_tinyMajorUnit_fallsBackToNiceUnit`/`axisBounds_zeroMajorUnit_fallsBackToNiceUnit` (`MAX_TICKS`), `ChartRendererTest#axisBounds_explicitHugeRange_reunitsToMaxTicks`/`axisBounds_infiniteSpan_fallsBackToData` (шаг при враждебном/неконечном диапазоне), `ChartSpecTest#nonFiniteScalingBounds_dropped` (±∞ scaling), `WordPdfConverterTest#hostileChartAxis_convertsNotHangs`/`hugeExtentChart_removedNotOom`/`chartWithoutExtent_errorFlagRejects` (`MAX_EXTENT_EMU`), `DrawMlTextTest#hugeWord_wrapsLinearly` (fitCut — прогресс реза), `DrawMlColorTest#invalidSrgbHexFallsBackToOfficeDefault` (битый hex темы — деградация), `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; `indCoexistForms_convertsNotRejected` + юниты `indCoexistLeftStartUntouched`/`indStartOnlyRenamedTransitional`/`tcMarCoexistKept`/`tcMarStartOnlyRenamedTransitional`/`tcBordersElementsKeptTransitional`/`jcStartKeptTransitional`/`tabStartRenamedTransitional`/`transitionalCoexistReturnsOriginalArray` — guard сосуществования форм + strict-gating), `DocxOnOffNormalizerTest`↔`ruPlain_regularRunsUseRegularFont` (+`onOffInTextNotTouched` — `w:val` правится только внутри тега), `SymbolFontNormalizerTest`↔`symbolFonts_bulletsAreNotHash`, `FieldNormalizerTest`↔`pageNumbers_recomputedNotCached`, `InvisibleCharNormalizerTest`↔`invisibleChars_noEmptyLines`, `GlyphCoverageNormalizerTest`↔`exoticGlyphs_drawnNotHash`, `OleObjectNormalizerTest`↔`oleObjects_removedAndConverted`/`drawingErrors_errorFlagRejectsOle` (+app `errorFlagOle_rejected`/`oleObjects_removedByDefault`; сохранение плейсхолдера — юниты `objectWithImagedata_placeholderKept`/`objectWithoutImage_removed`/`objectWithDrawing_reusedVerbatim`/`controlBlockRemoved`/`sizeFromDxaOrig`/`styleUnits_allConvertToEmu`/`objectWithoutBin_stillRewritten`/`externalOleLinkRelRemoved`/`errorFlagObjectWithoutBin_rejects`, в `oleObjects_removedAndConverted` — `distinctImageCount==1`, RGBA FOP режет на картинку+SMask), `WordPdfValidatorTest`↔`staleCachePageCountRejectedBeforeRender` (+`checkPageCount_limitBoundary` 99/100/101, `cachedPagesUnreadableFallsBackToZero` — нечитаемый `` → 0, `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`), вид сверху контурной — `Surface2dPainterTest#filledContour_*` + `ChartRendererTest#wireframeSurfaceLegend_hollowMarkers`↔`chartTypes_allTypesRenderAsImages` (заливка полос `fillBands` одним путём на полосу без AA-шва; полые маркеры легенды при `c:wireframe` §21.2.2.230), 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), `methodNotSupportedReturns405`/`badContentTypeReturns415` (405/415 вместо catch-all 500); DoS/корректность core: `ChartSpecTest#hugePointIndex_rejectedNotOom`/`hugePtCount_rejectedNotOom`/`hugeCategoryIndex_rejectedNotOom` (`MAX_POINTS`), `Surface3dPainterTest#axisBounds_tinyMajorUnit_fallsBackToNiceUnit`/`axisBounds_zeroMajorUnit_fallsBackToNiceUnit` (`MAX_TICKS`), `ChartRendererTest#axisBounds_explicitHugeRange_reunitsToMaxTicks`/`axisBounds_infiniteSpan_fallsBackToData` (шаг при враждебном/неконечном диапазоне), `ChartSpecTest#nonFiniteScalingBounds_dropped` (±∞ scaling), `WordPdfConverterTest#hostileChartAxis_convertsNotHangs`/`hugeExtentChart_removedNotOom`/`chartWithoutExtent_errorFlagRejects` (`MAX_EXTENT_EMU`), `DrawMlTextTest#hugeWord_wrapsLinearly` (fitCut — прогресс реза), `DrawMlColorTest#invalidSrgbHexFallsBackToOfficeDefault` (битый hex темы — деградация), `GlyphCoverageNormalizerTest#multipleTextNodes_runLeftUntouched` (guard составного рана)/`nestedRunInTextBox_innerSplit` + `SymbolFontNormalizerTest#nestedRunInTextBox_innerNormalized` (вложенные раны текстбоксов), `CartesianPainterTest#areaFill_closesToBaseline` (AREA к базовой линии), `ChartRendererTest#overlayLegend_drawnOverPlot` + `ChartSpecTest#overlayLegend_keepsPositionAndFlag` (overlay-легенда). - SmartArt-текст: `SmartArtRendererTest#normAutofitShrinksToFit`/`#missingAutofitKeepsDeclaredSize`/`#emptyTxBody_noPlaceholderInk` + `DrawMlTextTest#fallbackFamilyAliasedToBundle`/`#lineSpacingPct_compactsLines` ↔ `chartsSmartArt_drawingsBecomeImages` (autofit только `normAutofit` §21.1.2.1.2/.3 с подбором кегля под перенесённый текст, высота строки из `a:lnSpc`, фолбэк-семейство темы алиасится в бандл, `phldrT` не рисуется). - 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/ChartRenderer.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartRenderer.java index c82bfd1..ed6a11b 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 @@ -164,10 +164,17 @@ final class ChartRenderer { static final class Legend { /** lineWidth > 0 — маркер-отрезок (линейный ряд), иначе — квадратик. * В Word у линейных рядов в легенде короткая линия той же толщины, - * что и сама линия; у круговых — маленький квадратик. */ - record Entry(String label, Color color, double lineWidth) { + * что и сама линия; у круговых — маленький квадратик. + * outline — полый квадратик (цветной контур, белый интерьер): у + * wireframe-поверхностей (§21.2.2.230 «no color on the surface») + * полосы не залиты нигде, включая легенду. */ + record Entry(String label, Color color, double lineWidth, boolean outline) { Entry(String label, Color color) { - this(label, color, -1); + this(label, color, -1, false); + } + + Entry(String label, Color color, double lineWidth) { + this(label, color, lineWidth, false); } } @@ -188,6 +195,11 @@ final class ChartRenderer { BasicStroke.CAP_BUTT, BasicStroke.JOIN_MITER)); g.draw(new Line2D.Double(startX, midY, startX + lineLen, midY)); startX += lineLen + 3; + } else if (e.outline()) { + g.setStroke(new BasicStroke(1.0f)); + g.draw(new Rectangle2D.Double(startX, midY - square / 2.0, + square, square)); + startX += square + 3; } else { g.fill(new Rectangle2D.Double(startX, midY - square / 2.0, square, square)); startX += square + 3; @@ -243,7 +255,8 @@ final class ChartRenderer { ? palette.get(idx % palette.size()) : spec.bandColors.get(idx % spec.bandColors.size()); legend.entries.add(new Legend.Entry( - formatValue(b, "General") + "-" + formatValue(b + unit, "General"), c)); + formatValue(b, "General") + "-" + formatValue(b + unit, "General"), + c, -1, spec.wireframe)); idx++; } } 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 fa09eda..db5bbe4 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 @@ -3,32 +3,30 @@ package ru.pjandro.wordpdf.internal.chart; import java.awt.BasicStroke; import java.awt.Color; import java.awt.Graphics2D; -import java.awt.RenderingHints; +import java.awt.Shape; 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:surfaceChart, ECMA-376 §21.2.2.204) — оба режима + * «surface charts viewed from above, similar to 2-D topographic maps» + * (Microsoft Support): X — категории по узлам сетки, Y — ряды (серия 0 + * внизу, подписи со стороны serAx); оси значений нет — высоты кодируют + * полосы высот lo + k·unit (c:bandFmts §21.2.2.13/.14, без них — палитра). * - *

Заливочный (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 и рамка области построения. + *

Заливочный (c:wireframe val="0") — «color bands represent specific + * ranges of values»: области полос залиты их цветами без изолиний + * ({@link #fillBands}). c:wireframe (§21.2.2.230) — «shows only the lines. + * The lines… connect interpolated points of equal value»: изолинии на + * внутренних границах полос цветом полосы НИЖЕ уровня, без заливок + * ({@link #drawContourLines}, marching squares {@link #cellSegments}). + * В обоих режимах — сетка узлов catAx/serAx и рамка области построения; + * маркеры легенды следуют заливке полос: залитые при wireframe=false, + * полые при wireframe=true (§21.2.2.230 «no color on the surface» + * распространяется и на легенду). * *

Регрессия — Surface2dPainterTest, фикстура samples/chart-types.docx * (WordPdfConverterTest#chartTypes_allTypesRenderAsImages). @@ -53,6 +51,9 @@ final class Surface2dPainter { /** Число пересечений ребра ячейки уровнем: два поперечных + узел — один сегмент. */ private static final int HITS_WITH_NODE = 3; + /** Полигон подобласти полосы: меньше трёх различных вершин — нулевая площадь. */ + private static final int MIN_POLYGON_POINTS = 3; + static void paint(Graphics2D g, ChartSpec spec, Rectangle2D box, List palette) { int nSer = spec.series.size(); int nCat = 0; @@ -76,129 +77,30 @@ final class Surface2dPainter { } ChartSpec.AxisSpec valAxis = spec.valAxis != null ? spec.valAxis : new ChartSpec.AxisSpec(); - ChartSpec.AxisSpec catAxis = spec.catAxis != null - ? spec.catAxis : new ChartSpec.AxisSpec(); double[] bounds = ChartRenderer.axisBounds(valAxis, min, max); double lo = bounds[0]; double hi = bounds[1]; double unit = bounds[2]; 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); - DrawMlText.Style valStyle = valAxis.labelStyle; - DrawMlText.Style catStyle = catAxis.labelStyle; - List valLabels = new ArrayList<>(); - for (double v = lo; v <= hi + unit / 2; v += unit) { - valLabels.add(ChartRenderer.formatValue(v, valAxis.numFmt)); - } - double catGutter = catStyle != null ? DrawMlText.textHeight(catStyle) + 6 : 6; - double valGutter = 8; - if (valStyle != null) { - for (String l : valLabels) { - valGutter = Math.max(valGutter, DrawMlText.textWidth(l, valStyle) + 8); - } - } - Rectangle2D plot = new Rectangle2D.Double( - box.getX() + valGutter, box.getY(), - Math.max(10, box.getWidth() - valGutter), - Math.max(10, box.getHeight() - catGutter)); - - // Сетка по делениям оси значений — под поверхностью. - if (valAxis.gridlines && !valAxis.deleted) { - g.setColor(valAxis.gridColor); - g.setStroke(new BasicStroke(0.6f)); - for (double v = lo; v <= hi + unit / 2; v += unit) { - double y = yOf(v, lo, hi, plot); - g.draw(new Line2D.Double(plot.getX(), y, - plot.getX() + plot.getWidth(), y)); - } - } - - drawContour(g, z, nSer, nCat, lo, hi, unit, bandCount, bands, plot); - - // Оси поверх: линия категории и подписи. - if (catAxis.axisLineColor != null && !catAxis.deleted) { - g.setColor(catAxis.axisLineColor); - g.setStroke(new BasicStroke((float) Math.max(0.5, catAxis.axisLineWidth))); - double y = plot.getY() + plot.getHeight(); - g.draw(new Line2D.Double(plot.getX(), y, - plot.getX() + plot.getWidth(), y)); - } - drawCategoryLabels(g, cats, plot, catStyle); - drawValueLabels(g, valLabels, plot, valStyle, lo, hi); + // Оба режима — вид сверху (§21.2.2.204 «viewed from above»); valAxis + // задаёт lo/unit/bandCount полос высот и больше нигде не рисуется. + paintTopView(g, spec, z, nSer, nCat, lo, unit, bandCount, bands, box, + !spec.wireframe); } - /** - * Контурная заливка: по вертикальным срезам листа. На срезе x лист - * занимает вертикальные промежутки между соседними ломаными (ряд r и - * r+1) плюс переднюю стенку [пол, ряд 0]; промежуток режется по - * границам полос высот, каждая часть красится своей полосой. - */ - private static void drawContour(Graphics2D g, double[][] z, int nSer, int nCat, - double lo, double hi, double unit, int bandCount, - List bands, Rectangle2D plot) { - double step = Math.max(0.4, plot.getWidth() / 400.0); - // Без сглаживания: соседние колонки-заливки иначе дают полупрозрачные - // стыки-«полоски» (границы полос меняются от колонки к колонке). - Object oldAA = g.getRenderingHint(RenderingHints.KEY_ANTIALIASING); - g.setRenderingHint(RenderingHints.KEY_ANTIALIASING, - RenderingHints.VALUE_ANTIALIAS_OFF); - for (double x = plot.getX(); x < plot.getX() + plot.getWidth(); x += step) { - double w = Math.min(step + 0.6, plot.getX() + plot.getWidth() - x + 0.6); - double[] h = new double[nSer]; - for (int r = 0; r < nSer; r++) { - h[r] = interp(z[r], x, plot, nCat); - } - // Задние полосы — первыми, передняя стенка перекрывает всё снизу. - for (int r = nSer - 2; r >= 0; r--) { - double v0 = Math.min(h[r], h[r + 1]); - double v1 = Math.max(h[r], h[r + 1]); - int k0 = Math.max(0, Math.min(bandCount - 1, (int) Math.floor((v0 - lo) / unit))); - int k1 = Math.max(0, Math.min(bandCount - 1, (int) Math.floor((v1 - lo) / unit))); - for (int k = k0; k <= k1; k++) { - double segLo = Math.max(v0, lo + k * unit); - double segHi = Math.min(v1, lo + (k + 1) * unit); - if (segHi - segLo <= MIN_SEGMENT) { - continue; - } - g.setColor(bands.get(k % bands.size())); - double yTop = yOf(segHi, lo, hi, plot); - g.fill(new Rectangle2D.Double(x, yTop, w, - yOf(segLo, lo, hi, plot) - yTop)); - } - } - double front = h[0]; - if (front > lo) { - int k = Math.max(0, Math.min(bandCount - 1, - (int) Math.floor((front - lo) / unit))); - g.setColor(bands.get(k % bands.size())); - double yTop = yOf(front, lo, hi, plot); - g.fill(new Rectangle2D.Double(x, yTop, w, - plot.getY() + plot.getHeight() - yTop)); - } - } - g.setRenderingHint(RenderingHints.KEY_ANTIALIASING, oldAA); - } /** - * c:wireframe (§21.2.2.230) — вид сверху, как Word: X — категории, - * Y — ряды (серия 0 внизу); рисуются только изолинии, сетка узлов - * catAx/serAx и рамка области построения — заливок и оси значений нет - * (значения кодируют изолинии и легенда полос). Word пишет serAx - * axPos="r" для поверхностей; иное положение serAx — подписи слева. + * Вид сверху (§21.2.2.204 «viewed from above»): X — категории по узлам, + * Y — ряды (серия 0 внизу); filled — заливка полос высот, иначе — + * изолинии без заливок (c:wireframe, §21.2.2.230). Оси значений нет; + * 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) { + private static void paintTopView(Graphics2D g, ChartSpec spec, double[][] z, + int nSer, int nCat, double lo, double unit, + int bandCount, List bands, + Rectangle2D box, boolean filled) { ChartSpec.AxisSpec serAxis = spec.serAxis != null ? spec.serAxis : new ChartSpec.AxisSpec(); ChartSpec.AxisSpec catAxis = spec.catAxis != null @@ -212,7 +114,7 @@ final class Surface2dPainter { 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; @@ -227,7 +129,7 @@ final class Surface2dPainter { 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)); @@ -247,9 +149,15 @@ final class Surface2dPainter { } } - // Изолинии — с антиалиасингом (в отличие от заливки filled-ветки). - g.setStroke(new BasicStroke(0.75f)); - drawContourLines(g, z, nSer, nCat, lo, unit, bandCount, bands, plot); + // Контент: заливка полос (filled) или изолинии (wireframe) — обе с + // антиалиасингом; полигоны соседних ячеек стыкуются по общим вершинам, + // швы субпиксельные на 300 dpi. + if (filled) { + fillBands(g, z, nSer, nCat, lo, unit, bandCount, bands, plot); + } else { + g.setStroke(new BasicStroke(0.75f)); + drawContourLines(g, z, nSer, nCat, lo, unit, bandCount, bands, plot); + } // Рамка области построения — это рамка области, а не ось. if (catAxis.axisLineColor != null) { @@ -258,7 +166,7 @@ final class Surface2dPainter { g.draw(plot); } - // Подписи категорий — по ЦЕНТРАМ узлов сетки (не слотов, как в filled). + // Подписи категорий — по ЦЕНТРАМ узлов сетки. if (catAxis.labelStyle != null) { DrawMlText.Style style = catAxis.labelStyle; double h = DrawMlText.textHeight(style) + 2; @@ -301,6 +209,152 @@ final class Surface2dPainter { } } + /** + * Заливка полос высот в виде сверху: каждая ячейка сетки режется по + * границам lo + k·unit — полигон подобласти k-й полосы строится обходом + * периметра A→B→C→D→A (конвенция {@link #cellSegments}: «узел точно на + * уровне = полоса выше», {@link #bandOf}); ячейка целиком в одной полосе + * — сплошной прямоугольник (билинейная функция достигает min/max на + * углах, так что interior тоже в этой полосе). Подобласти одной полосы + * со всех ячеек накапливаются в ОДИН путь и заливаются за проход: + * раздельные fill соседних ячеек покрывают каждый половину пограничного + * пикселя и композитятся в светлую AA-«полоску» на общем ребре + * (замер 75% цвета на узловой колонке); в едином пути общее ребро — + * interior, шва нет. + */ + private static void fillBands(Graphics2D g, double[][] z, int nSer, int nCat, + double lo, double unit, int bandCount, + List bands, Rectangle2D plot) { + Path2D.Double[] paths = new Path2D.Double[bandCount]; + 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); + double[] zv = {z[r][c], z[r][c + 1], z[r + 1][c + 1], z[r + 1][c]}; + double[] xs = {x0, x1, x1, x0}; + double[] ys = {y0, y0, y1, y1}; + int[] band = new int[4]; + int kMin = bandCount - 1; + int kMax = 0; + for (int i = 0; i < 4; i++) { + band[i] = bandOf(zv[i], lo, unit, bandCount); + kMin = Math.min(kMin, band[i]); + kMax = Math.max(kMax, band[i]); + } + if (kMin == kMax) { + appendSubpath(paths, kMin, new Rectangle2D.Double(x0, + Math.min(y0, y1), x1 - x0, Math.abs(y1 - y0))); + continue; + } + for (int k = kMin; k <= kMax; k++) { + Path2D.Double poly = bandPolygon(zv, xs, ys, band, k, lo, unit); + if (poly != null) { + appendSubpath(paths, k, poly); + } + } + } + } + for (int k = 0; k < bandCount; k++) { + if (paths[k] != null) { + g.setColor(bands.get(k % bands.size())); + g.fill(paths[k]); + } + } + } + + /** Подпуть области ячейки в путь полосы k (создаётся при первом добавлении). */ + private static void appendSubpath(Path2D.Double[] paths, int k, Shape sub) { + if (paths[k] == null) { + paths[k] = new Path2D.Double(); + } + paths[k].append(sub, false); + } + + /** + * Полигон подобласти полосы k в ячейке: обход периметра A→B→C→D→A — + * углы с bandOf == k и пересечения рёбер с уровнями lo + k·unit и + * lo + (k+1)·unit в порядке возрастания t вдоль ребра; совпанные + * вершины (пересечение точно в узле) пропускаются. null — вырожденный + * полигон: площадь нулевая (узел/ребро целиком на границе полосы). + */ + private static Path2D.Double bandPolygon(double[] z, double[] xs, double[] ys, + int[] band, int k, double lo, + double unit) { + double lLo = lo + k * unit; + double lHi = lo + (k + 1) * unit; + List pts = new ArrayList<>(); + for (int i = 0; i < 4; i++) { + int j = (i + 1) % 4; + if (band[i] == k) { + addPoint(pts, xs[i], ys[i]); + } + double tLo = crossingT(z[i], z[j], lLo); + double tHi = crossingT(z[i], z[j], lHi); + double first = Math.min(tLo, tHi); + double second = Math.max(tLo, tHi); + if (first >= 0) { + addPoint(pts, xs[i] + (xs[j] - xs[i]) * first, + ys[i] + (ys[j] - ys[i]) * first); + } + if (second >= 0) { + addPoint(pts, xs[i] + (xs[j] - xs[i]) * second, + ys[i] + (ys[j] - ys[i]) * second); + } + } + while (pts.size() > 1) { + double[] first = pts.get(0); + double[] last = pts.get(pts.size() - 1); + if (first[0] != last[0] || first[1] != last[1]) { + break; + } + pts.remove(pts.size() - 1); + } + if (pts.size() < MIN_POLYGON_POINTS) { + return null; + } + Path2D.Double poly = new Path2D.Double(); + poly.moveTo(pts.get(0)[0], pts.get(0)[1]); + for (int i = 1; i < pts.size(); i++) { + poly.lineTo(pts.get(i)[0], pts.get(i)[1]); + } + poly.closePath(); + return poly; + } + + /** + * Полоса высоты значения: узел точно на уровне lo + k·unit принадлежит + * полосе ВЫШЕ (k) — конвенция «on level = внутри» из {@link #cellSegments}. + */ + private static int bandOf(double v, double lo, double unit, int bandCount) { + int k = (int) Math.floor((v - lo) / unit); + return Math.max(0, Math.min(bandCount - 1, k)); + } + + /** + * Параметр пересечения ребра zi→zj уровнем L в [0, 1] или -1: ребро + * пересекает уровень, если min(zi, zj) < L <= max(zi, zj) — конец ребра + * точно на уровне считается пересечением (полоса выше включает его). + */ + private static double crossingT(double zi, double zj, double level) { + if (Math.min(zi, zj) >= level || Math.max(zi, zj) < level) { + return -1; + } + return (level - zi) / (zj - zi); + } + + /** Вершина полигона; совпавшая с предыдущей (пересечение в узле) — пропускается. */ + private static void addPoint(List pts, double x, double y) { + if (!pts.isEmpty()) { + double[] last = pts.get(pts.size() - 1); + if (last[0] == x && last[1] == y) { + return; + } + } + pts.add(new double[] {x, y}); + } + /** * Изолинии: «the lines… connect interpolated points of equal value» — * на каждой внутренней границе полос высот lo + k·unit (k = 1..bandCount−1) @@ -464,68 +518,10 @@ final class Surface2dPainter { return plot.getY() + plot.getHeight() * (1 - (double) r / (nSer - 1)); } - /** Высота листа на срезе x: линейная интерполяция ломаной ряда. */ - private static double interp(double[] row, double x, Rectangle2D plot, int nCat) { - double t = (x - plot.getX()) / plot.getWidth() * (nCat - 1); - int c = (int) Math.floor(t); - if (c < 0) { - return row[0]; - } - if (c >= nCat - 1) { - return row[nCat - 1]; - } - double f = t - c; - return row[c] + (row[c + 1] - row[c]) * f; - } private static double xOf(int c, Rectangle2D plot, int nCat) { return plot.getX() + plot.getWidth() * c / (nCat - 1); } - private static double yOf(double v, double lo, double hi, Rectangle2D plot) { - return plot.getY() + (1 - (v - lo) / (hi - lo)) * plot.getHeight(); - } - private static void drawCategoryLabels(Graphics2D g, List cats, - Rectangle2D plot, DrawMlText.Style style) { - if (style == null || cats.isEmpty()) { - return; - } - int n = cats.size(); - double h = DrawMlText.textHeight(style) + 2; - double slot = plot.getWidth() / n; - for (int i = 0; i < n; i++) { - String label = cats.get(i); - if (label.isEmpty()) { - continue; - } - double cx = plot.getX() + plot.getWidth() * (i + 0.5) / n; - 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(cx - w / 2, plot.getY() + plot.getHeight() + 3, - w, h), - "ctr", "t", 1.0); - } - } - - private static void drawValueLabels(Graphics2D g, List labels, - Rectangle2D plot, DrawMlText.Style style, - double lo, double hi) { - if (style == null) { - return; - } - double h = DrawMlText.textHeight(style) + 2; - for (int i = 0; i < labels.size(); i++) { - double v = lo + (hi - lo) * i / Math.max(1, labels.size() - 1); - double y = yOf(v, lo, hi, plot); - DrawMlText.paint(g, - List.of(new DrawMlText.Paragraph(labels.get(i), style, "r")), - new Rectangle2D.Double(plot.getX() - 6, y - h / 2, - Math.max(10, DrawMlText.textWidth(labels.get(i), style)), h), - "r", "ctr", 1.0); - } - } } 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 84935d4..95ba113 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 @@ -15,6 +15,15 @@ import static org.junit.jupiter.api.Assertions.*; */ class ChartRendererTest { + /** + * Полый маркер: в средней колонке — верхняя и нижняя рамки контура + * 1pt ≈ 4px @300dpi + AA-ряды (замер ~5), прогон не больше порога. + */ + private static final int HOLLOW_MAX_RUN = 8; + + /** Залитый маркер: квадрат 0,55·9pt ≈ 21px @300dpi, прогон не меньше. */ + private static final int FILLED_MIN_RUN = 15; + /** * Одна и та же LINE-спека с legendOverlay=false/true: легенда видима * в обеих (нижняя полоса), но у overlay кривая опускается ниже — @@ -361,6 +370,37 @@ class ChartRendererTest { "surface с данными и полосами должен рисоваться"); } + /** + * c:wireframe (§21.2.2.230) — «no color on the surface» распространяется + * и на легенду: маркеры полос полые (цветной контур, белый интерьер) — + * в средней колонке маркера только верхняя и нижняя рамки. Контраст — + * та же спека с wireframe=false: маркер залит на всю высоту квадратика. + * Регрессия — ChartRendererTest#wireframeSurfaceLegend_hollowMarkers. + */ + @Test + void wireframeSurfaceLegend_hollowMarkers() { + ChartSpec spec = surfaceLegendSpec(true); + BufferedImage hollow = ChartRenderer.render(spec, 219.23, 149.08, + new DrawMlColor(null)); + int[] box = firstAccent1Box(hollow); + int cx = (box[0] + box[2]) / 2; + int cy = (box[1] + box[3]) / 2; + assertTrue(isWhite(hollow.getRGB(cx, cy)), + "интерьер wireframe-маркера не белый: " + Integer.toHexString(hollow.getRGB(cx, cy))); + int run = maxVerticalAccent1Run(hollow, cx); + assertTrue(run <= HOLLOW_MAX_RUN, + "wireframe-маркер легенды залит: вертикальный прогон=" + run); + + spec.wireframe = false; + BufferedImage filled = ChartRenderer.render(spec, 219.23, 149.08, + new DrawMlColor(null)); + int[] fbox = firstAccent1Box(filled); + int fcx = (fbox[0] + fbox[2]) / 2; + int filledRun = maxVerticalAccent1Run(filled, fcx); + assertTrue(filledRun >= FILLED_MIN_RUN, + "заливочный маркер легенды не залит: вертикальный прогон=" + filledRun); + } + /** BAR: легенда без имени ряда — квадратик; без рядов — легенды нет. */ @Test void barLegendDefaultSquareAndNameless() { @@ -563,4 +603,75 @@ class ChartRendererTest { && Math.abs(((rgb >> 8) & 0xFF) - 114) < 30 && Math.abs((rgb & 0xFF) - 196) < 30; } + + /** + * SURFACE 2 ряда × 2 категории, c:majorUnit=1 → полосы 0-1/1-2, легенда + * «0-1» (accent1) «1-2» (accent2); данные 1.2/1.8 — выше первой границы + * полос, поэтому область построения не рисует ни изолиний, ни accent1. + */ + private static ChartSpec surfaceLegendSpec(boolean wireframe) { + ChartSpec spec = new ChartSpec(); + spec.type = ChartSpec.Type.SURFACE; + spec.wireframe = wireframe; + spec.legendPos = "b"; + spec.valAxis = new ChartSpec.AxisSpec(); + spec.valAxis.majorUnit = 1.0; + ChartSpec.Series bottom = new ChartSpec.Series(); + bottom.values.add(1.2); + bottom.values.add(1.2); + ChartSpec.Series top = new ChartSpec.Series(); + top.values.add(1.8); + top.values.add(1.8); + spec.series.add(bottom); + spec.series.add(top); + return spec; + } + + /** Bounding box пикселей accent1 (первый маркер легенды): {minX, minY, maxX, maxY}. */ + private static int[] firstAccent1Box(BufferedImage img) { + int minX = Integer.MAX_VALUE; + int minY = Integer.MAX_VALUE; + int maxX = -1; + int maxY = -1; + for (int y = 0; y < img.getHeight(); y++) { + for (int x = 0; x < img.getWidth(); x++) { + if (isAccent1(img.getRGB(x, y))) { + minX = Math.min(minX, x); + minY = Math.min(minY, y); + maxX = Math.max(maxX, x); + maxY = Math.max(maxY, y); + } + } + } + assertTrue(maxX >= 0, "маркер легенды accent1 не найден"); + return new int[] {minX, minY, maxX, maxY}; + } + + /** Максимальный вертикальный прогон accent1 в колонке x. */ + private static int maxVerticalAccent1Run(BufferedImage img, int x) { + int best = 0; + int run = 0; + for (int y = 0; y < img.getHeight(); y++) { + if (isAccent1(img.getRGB(x, y))) { + run++; + best = Math.max(best, run); + } else { + run = 0; + } + } + return best; + } + + /** Пиксель — цвет accent1 (0x4472C4) с запасом на AA-края. */ + private static boolean isAccent1(int rgb) { + return Math.abs(((rgb >> 16) & 0xFF) - 0x44) <= 24 + && Math.abs(((rgb >> 8) & 0xFF) - 0x72) <= 24 + && Math.abs((rgb & 0xFF) - 0xC4) <= 24; + } + + /** Пиксель — белый фон. */ + private static boolean isWhite(int rgb) { + return ((rgb >> 16) & 0xFF) >= 0xF0 && ((rgb >> 8) & 0xFF) >= 0xF0 + && (rgb & 0xFF) >= 0xF0; + } } 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 d3c2a63..16a7cf4 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 @@ -10,14 +10,14 @@ import java.util.List; import static org.junit.jupiter.api.Assertions.*; /** - * Контурная диаграмма (ECMA-376 §21.2.2.204). Заливочный режим: лист между - * ломаными соседних рядов режется контурными полосами высот (c:bandFmts, - * §21.2.2.13 — от низкого к высокого; без них — палитра). c:wireframe - * (§21.2.2.230) — вид сверху, как Word: X — категории, Y — ряды (серия 0 - * внизу), без заливок и оси значений; рисуются изолинии на внутренних - * границах полос высот lo + k·unit цветом полосы НИЖЕ уровня (marching - * squares, седло — по среднему ячейки), сетка узлов catAx/serAx и рамка - * области построения. Регрессия — Surface2dPainterTest, фикстура + * Контурная диаграмма (ECMA-376 §21.2.2.204) — оба режима вид сверху + * («viewed from above», Microsoft Support): X — категории по узлам сетки, + * Y — ряды (серия 0 внизу), оси значений нет. Заливочный + * (c:wireframe val="0") — области полос высот lo + k·unit залиты их + * цветами (c:bandFmts §21.2.2.13/.14, без них — палитра), без изолиний. + * c:wireframe (§21.2.2.230) — изолинии на внутренних границах полос + * цветом полосы НИЖЕ уровня (marching squares, седло — по среднему + * ячейки), без заливок. Регрессия — Surface2dPainterTest, фикстура * samples/chart-types.docx (WordPdfConverterTest#chartTypes_allTypesRenderAsImages). */ class Surface2dPainterTest { @@ -27,36 +27,22 @@ class Surface2dPainterTest { private static final Color ACCENT3 = new Color(0xA5A5A5); private static final Color ACCENT4 = new Color(0xFFC000); + /** Порог «тёмный» пикселя по каждому каналу (текст подписей 0x595959). */ + private static final int DARK_MAX = 0x80; + /** Масштаб растра: 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). + * Геометрия render(): box = (4, 4, 211.23, 141.08) pt; без подписей + * осей 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 делится на - * четыре горизонтальные полосы высот: снизу вверх accent1 (0-1), - * accent2 (1-2), accent3 (2-3), accent4 (3-4). - */ - @Test - void contourStripes_areValueBandsBottomUp() { - BufferedImage img = render(surfaceSpec(false)); - assertTrue(matches(px(img, 400, 507), ACCENT1), - "полоса 0-1 не accent1: " + hex(px(img, 400, 507))); - assertTrue(matches(px(img, 400, 368), ACCENT2), - "полоса 1-2 не accent2: " + hex(px(img, 400, 368))); - assertTrue(matches(px(img, 400, 227), ACCENT3), - "полоса 2-3 не accent3: " + hex(px(img, 400, 227))); - assertTrue(matches(px(img, 400, 87), ACCENT4), - "полоса 3-4 не accent4: " + hex(px(img, 400, 87))); - } - /** * Вид сверху, z[r][c] = c: lo=0, hi=4, unit=1 → изолинии уровней 1, 2, 3 — * вертикали точно в узлах xOf(1..3) цветами полос НИЖЕ уровня @@ -221,11 +207,94 @@ class Surface2dPainterTest { "ниже уровня изолинии быть не должно"); } + /** + * Заливка, вид сверху: z[r][c] = r, 4 ряда × 3 категории — lo=0, hi=3, + * unit=1 → полосы 0-1/1-2/2-3 заливают межрядные ячейки + * (accent1/2/3); серия 0 внизу (центр ячейки ряда 0 ниже центра + * ячейки ряда 2 на экране). + */ + @Test + void filledContour_flatRows_bandsFillRowsTopView() { + double[][] z = { + {0, 0, 0}, + {1, 1, 1}, + {2, 2, 2}, + {3, 3, 3}, + }; + BufferedImage img = render(surfaceSpec(z, false)); + int x = (int) Math.round((xPt(0, 3) + xPt(1, 3)) / 2 * PX); + int yCell0 = (yPx(0, 4) + yPx(1, 4)) / 2; + int yCell1 = (yPx(1, 4) + yPx(2, 4)) / 2; + int yCell2 = (yPx(2, 4) + yPx(3, 4)) / 2; + assertTrue(yCell0 > yCell2, + "серия 0 должна быть внизу: yCell0=" + yCell0 + ", yCell2=" + yCell2); + assertTrue(matches(px(img, x, yCell0), ACCENT1), + "полоса 0-1 не accent1: " + hex(px(img, x, yCell0))); + assertTrue(matches(px(img, x, yCell1), ACCENT2), + "полоса 1-2 не accent2: " + hex(px(img, x, yCell1))); + assertTrue(matches(px(img, x, yCell2), ACCENT3), + "полоса 2-3 не accent3: " + hex(px(img, x, yCell2))); + } + + /** + * «Холм» 3×3 (углы z=0, середины рёбер z=2, центр z=4): lo=0, hi=4, + * unit=1 → в ячейке (0..1, 0..1) биллинейно z = 2x̂+2ŷ, точки диагонали + * от угла (0,0) к центру при t=0.15/0.35/0.65/0.85 (z=0.6/1.4/2.6/3.4) + * залиты цветами полос 0-1…3-4. + */ + @Test + void filledContour_hillCell_bandsNestedDiagonal() { + double[][] z = { + {0, 2, 0}, + {2, 4, 2}, + {0, 2, 0}, + }; + BufferedImage img = render(surfaceSpec(z, false)); + double[] ts = {0.15, 0.35, 0.65, 0.85}; + Color[] want = {ACCENT1, ACCENT2, ACCENT3, ACCENT4}; + for (int i = 0; i < ts.length; i++) { + double t = ts[i]; + double x = xPt(0, 3) + (xPt(1, 3) - xPt(0, 3)) * t; + double y = yPt(0, 3) + (yPt(1, 3) - yPt(0, 3)) * t; + int xp = (int) Math.round(x * PX); + int yp = (int) Math.round(y * PX); + assertTrue(matches(px(img, xp, yp), want[i]), + "точка диагонали t=" + t + " не " + want[i] + ": " + hex(px(img, xp, yp))); + } + } + + /** + * Оси значений в виде сверху нет: слева от plot (x < plotX−1) в + * вертикальной полосе области построения нет тёмных пикселей — ни в + * заливочном, ни в wireframe-режиме. + */ + @Test + void filledContour_noValueAxisLabels() { + double[][] z = { + {0, 0, 0}, + {1, 1, 1}, + {2, 2, 2}, + {3, 3, 3}, + }; + int xLimit = (int) Math.round((PLOT_X - 1) * PX); + int yTop = (int) Math.round(PLOT_Y * PX); + int yBottom = (int) Math.round((PLOT_Y + PLOT_H) * PX); + assertFalse(hasDarkLeftOf(render(surfaceSpec(z, false)), xLimit, yTop, yBottom), + "слева от plot подписи оси значений (заливка)"); + assertFalse(hasDarkLeftOf(render(surfaceSpec(z, true)), xLimit, yTop, yBottom), + "слева от plot подписи оси значений (wireframe)"); + } + /** Спека wireframe-поверхности без подписей осей (серии из z, категории пустые). */ private static ChartSpec wireframeSpec(double[][] z) { + return surfaceSpec(z, true); + } + + /** Спека поверхности без подписей осей (серии из z, категории пустые), режим по флагу. */ + private static ChartSpec surfaceSpec(double[][] z, boolean wireframe) { ChartSpec spec = new ChartSpec(); spec.type = ChartSpec.Type.SURFACE; - spec.wireframe = true; + spec.wireframe = wireframe; spec.legendPos = null; spec.valAxis = new ChartSpec.AxisSpec(); for (double[] row : z) { @@ -248,8 +317,12 @@ class Surface2dPainterTest { } /** Пиксельная координата узла ряда: serY(r) = 4 + 135.08·(1 − r/(nSer−1)), серия 0 внизу. */ + private static double yPt(double r, int nSer) { + return PLOT_Y + PLOT_H * (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); + return (int) Math.round(yPt(r, nSer) * PX); } private static boolean hasSegment(List segs, @@ -270,23 +343,6 @@ class Surface2dPainterTest { return Math.abs(a - b) < 1e-9; } - private static ChartSpec surfaceSpec(boolean wireframe) { - ChartSpec spec = new ChartSpec(); - spec.type = ChartSpec.Type.SURFACE; - spec.wireframe = wireframe; - spec.legendPos = null; - spec.valAxis = new ChartSpec.AxisSpec(); - double[] rows = {0, 2, 4}; - for (double row : rows) { - ChartSpec.Series s = new ChartSpec.Series(); - for (int c = 0; c < 3; c++) { - s.values.add(row); - } - spec.series.add(s); - } - return spec; - } - private static BufferedImage render(ChartSpec spec) { return ChartRenderer.render(spec, 219.23, 149.08, new DrawMlColor(null)); } @@ -306,6 +362,21 @@ class Surface2dPainterTest { || matches(rgb, ACCENT3) || matches(rgb, ACCENT4); } + /** Есть ли тёмный пиксель в полосе x < xLimit, yTop..yBottom. */ + private static boolean hasDarkLeftOf(BufferedImage img, int xLimit, + int yTop, int yBottom) { + for (int y = yTop; y <= yBottom && y < img.getHeight(); y++) { + for (int x = 0; x < xLimit; x++) { + int rgb = img.getRGB(x, y); + if (((rgb >> 16) & 0xFF) < DARK_MAX && ((rgb >> 8) & 0xFF) < DARK_MAX + && (rgb & 0xFF) < DARK_MAX) { + return true; + } + } + } + return false; + } + private static String hex(int rgb) { return String.format("#%06X", rgb & 0xFFFFFF); }