diff --git a/AGENTS.md b/AGENTS.md index abde1af..136f35c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -30,7 +30,7 @@ Нормативный источник любых правок/решений по диаграммам и SmartArt — ECMA-376 (`docs/standards/`: графики §21.2, diagram-разметка §21.4, пресет-геометрия Annex D + полные наборы XSD `schema/strict/`/`schema/transitional/`; соответствие фикстур схемам проверяет `docs/standards/validate-fixtures.py` — см. README; поведение Word — `ms-oi29500.md`, `ms-odrawxml.md`), а не догадки по исходникам LibreOffice/Word-эмпирике; эмпирические калибровки (камера, `PIE_DEPTH`) менять только вместе с пиксельными тестами. Формулировки из стандарта при ссылке — с номером секции (§21.2.2.132 и т.п.). Фикстуры могут быть невалидны — код под фикстуру не правится, правится фикстура (после проверки по XSD/секции). -Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр × `DPI/72`, размеры — в пунктах, EMU→pt `cx/12700.0`). `ChartSpec.parse` (`enum Type`: PIE/PIE3D/DOUGHNUT/BAR/BAR_HORIZONTAL/LINE/AREA/SURFACE3D/SCATTER/BUBBLE/RADAR/STOCK/OF_PIE/SURFACE/BAR3D/AREA3D/LINE3D/UNSUPPORTED; пустой `c:title` + `autoTitleDeleted="0"` → у **круговых** имя первого ряда, у прочих — `AUTO_TITLE = "Название диаграммы"` (русская замена англ. плейсхолдеру Word); палитра `accent1..6` темы, легенда по умолчанию снизу (у SURFACE — полосы высот «0-1»…), позиция `t` поддержана, `overlay` (§21.2.2.132) → рисуется поверх области построения, место не резервирует (`ChartSpec.legendOverlay`, регрессия `ChartRendererTest#overlayLegend_drawnOverPlot`)) → `ChartRenderer` (осевые «круглые» шаги `niceUnit` 1/2/5·10ⁿ как Word; санитайзер `c:majorUnit` — `MAX_TICKS = 1000`: шаг ≤ 0/NaN/слишком мелкий в `axisBounds` заменяется niceUnit, иначе циклы делений вечные; общие кумулятивные хелперы stacked `isStacked`/`stackedCumulative`/`stackedRange`) → пейнтеры `CartesianPainter` (2-D line/bar/area; lineChart `c:grouping` stacked/percentStacked §21.2.2.76 — ряд рисуется на накопленной сумме через `ChartRenderer.stackedCumulative`, регрессии `stackedLine_seriesStackCumulatively`/`percentStackedLine_topSeriesFlatAtHundred`)/`PiePainter` (`PIE_DEPTH=0.22`, `PIE_FIT=0.865`)/`Surface3dPainter` (калибровка по эталону Word 300 dpi, камера — регрессия `cameraMatchesWordReference`: `DEPTH_RATIO=0.705`, `HEIGHT_RATIO=0.664`, `GUTTER_LEFT/RIGHT=0.1485`, `GUTTER_TOP=0.116`, `GUTTER_BOTTOM=0.146`, свет `LIGHT_X/Y/Z=0.83/0.48/0.28`, `c:rAngAx=true` во всех 3D-пейнтерах имеет приоритет над `c:perspective` (MS-OI29500 §2.1.1516(b)), `c:hPercent` сжимает глубину, `c:wireframe` §21.2.2.205 — только каркас без полос высот, bandFmt-полосы сортируются по глубине)/`ScatterPainter` (scatter/bubble: обе оси числовые, две `c:valAx`, X — первая; маркеры по `c:marker`, `c:scatterStyle` §21.2.2.136; радиус пузыря sqrt при `c:sizeRepresents="area"` §21.2.2.128 и линейно при «w», масштаб `c:bubbleScale`)/`RadarPainter` (спицы от 12 часов по часовой, `c:radarStyle` §21.2.2.119 standard/marker/filled, сетка — концентрические многоугольники)/`StockPainter` (high-low-close: `c:hiLowLines`/`c:upDownBars`/`c:dropLines`; цвета — дефолты UI Word, эмпирика запинена тестом)/`OfPiePainter` (главный пирог, замкнутый «Other»-сектором — MS-OI29500 §2.1.1507(a), обращён центром к 3 часам ко вторичной, цвет — следующая ротация палитры; пара пирогов центрирована, зазор `GAP_FIT=0.25·d1` — Word-эмпирика; вторичный пирог/стек, разбиение по `c:splitType` §21.2.2.155 (splitPos — MS-OI29500 §2.1.1554a/b), вторичный пирог стартует от конца «Other»-сектора; `c:serLines` — ровно две связи от границ «Other»-сектора к ободу вторичного на 270°±wedgeSweep / левым углам столбца — MS-OI29500 §2.1.1545(a))/`Surface2dPainter` (контурная карта §21.2.2.204: полосы высот между ломаными соседних рядов §21.2.2.13, передняя стенка — полоса значения переднего края, `c:wireframe` §21.2.2.205 — сетка листа, оси общие с декартовыми)/`Cartesian3dPainter` (bar3D/line3D/area3D §21.2.2.19/.101/.122 — камера `Surface3dPainter.project`, ряды уходят в глубину; bar3D: `c:shape` box/cone/cylinder/pyramid + `*ToMax` §21.2.3.44 (per-series `c:shape` переопределяет диаграммный, горизонтальная ориентация — всегда box), `c:grouping` stacked/percentStacked §21.2.2.76 (одна полоса глубины на категорию, сегменты столбиком, percent — нормировка к 100%; area3D stacked — полосы на стене v=0, line3D grouping игнорирует), `c:gapDepth` — MS-OI29500 §2.1.1474, подписи serAx рисуются, `c:delete` осей учитывается); `SmartArtRenderer` рисует кэш разложенной схемы (relationship `…/office/2007/relationships/diagramDrawing`, фактически `word/diagrams/drawing1.xml`), формы строит `PresetGeometry` — ECMA-пресет-геометрия `a:prstGeom`: avLst/gdLst/pathLst семи пресетов (rect, roundRect, ellipse, gear6, gear9, circularArrow, leftCircularArrow) дословно из `presetShapeDefinitions.xml`, вычислитель префиксных формул; оператор `?:` = «if x > 0 then y else z» (ISO/IEC 29500-1, НЕ x != 0), углы в Arc2D передавать со знаком минус (математическая конвенция y вверх), неизвестный пресет → прямоугольник ячейки (синхрон таблицы со стандартом пинит `PresetGeometryTest#tableMatchesEcmaXml`); палитра темы — `DrawMlColor` (instance; без ThemePart — дефолтная Office-палитра `accent1=4472C4`…); текст — `DrawMlText` (шрифты — тот же бандл через `BundledFontMapper.bundledFamily`); утилиты `RgbHsl`. Калибровочные константы менять только вместе с `Surface3dPainterTest`/`PiePainterTest`. Защитные лимиты против враждебного chart-XML: `ChartSpec.MAX_POINTS` (`c:pt/@idx` §21.2.2.150/.151 и `c:ptCount` §21.2.2.152 — ST_UnsignedInt без верхней границы, отказ `IllegalArgumentException` до предвыделения списка) и `MAX_TICKS` (см. выше); бросок перехватывает catch `DrawingPreRenderer.renderChart` → штатная деградация «объект удалён + warn». Обход `pkg.getParts()` — только по **снимку** списка (`createImagePart` мутирует реестр → CME); rels частей — `part.getRelationshipsPart()`, НЕ `getOwningRelationshipPart()` (это rels ссылающегося); обход XML обязан раскрывать `JAXBElement`. +Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр × `DPI/72`, размеры — в пунктах, EMU→pt `cx/12700.0`). `ChartSpec.parse` (`enum Type`: PIE/PIE3D/DOUGHNUT/BAR/BAR_HORIZONTAL/LINE/AREA/SURFACE3D/SCATTER/BUBBLE/RADAR/STOCK/OF_PIE/SURFACE/BAR3D/AREA3D/LINE3D/UNSUPPORTED; пустой `c:title` + `autoTitleDeleted="0"` → у **круговых** имя первого ряда, у прочих — `AUTO_TITLE = "Название диаграммы"` (русская замена англ. плейсхолдеру Word); палитра `accent1..6` темы, легенда по умолчанию снизу (у SURFACE — полосы высот «0-1»…), позиция `t` поддержана, `overlay` (§21.2.2.132) → рисуется поверх области построения, место не резервирует (`ChartSpec.legendOverlay`, регрессия `ChartRendererTest#overlayLegend_drawnOverPlot`)) → `ChartRenderer` (осевые «круглые» шаги `niceUnit` 1/2/5·10ⁿ как Word; санитайзер `c:majorUnit` — `MAX_TICKS = 1000`: шаг ≤ 0/NaN/слишком мелкий в `axisBounds` заменяется niceUnit, иначе циклы делений вечные; общие кумулятивные хелперы stacked `isStacked`/`stackedCumulative`/`stackedRange`) → пейнтеры `CartesianPainter` (2-D line/bar/area; lineChart `c:grouping` stacked/percentStacked §21.2.2.76 — ряд рисуется на накопленной сумме через `ChartRenderer.stackedCumulative`, регрессии `stackedLine_seriesStackCumulatively`/`percentStackedLine_topSeriesFlatAtHundred`)/`PiePainter` (`PIE_DEPTH=0.22`, `PIE_FIT=0.865`)/`Surface3dPainter` (калибровка по эталону Word 300 dpi, камера — регрессия `cameraMatchesWordReference`: `DEPTH_RATIO=0.705`, `HEIGHT_RATIO=0.664`, `GUTTER_LEFT/RIGHT=0.1485`, `GUTTER_TOP=0.116`, `GUTTER_BOTTOM=0.146`, свет `LIGHT_X/Y/Z=0.83/0.48/0.28`, `c:rAngAx=true` во всех 3D-пейнтерах имеет приоритет над `c:perspective` (MS-OI29500 §2.1.1516(b)), `c:hPercent` сжимает глубину, `c:wireframe` §21.2.2.205 — только каркас без полос высот, bandFmt-полосы сортируются по глубине)/`ScatterPainter` (scatter/bubble: обе оси числовые, две `c:valAx`, X — первая; маркеры по `c:marker`, `c:scatterStyle` §21.2.2.136; радиус пузыря sqrt при `c:sizeRepresents="area"` §21.2.2.128 и линейно при «w», масштаб `c:bubbleScale`)/`RadarPainter` (спицы от 12 часов по часовой, `c:radarStyle` §21.2.2.119 standard/marker/filled, сетка — концентрические многоугольники)/`StockPainter` (high-low-close: `c:hiLowLines`/`c:upDownBars`/`c:dropLines`; цвета — дефолты UI Word, эмпирика запинена тестом)/`OfPiePainter` (главный пирог, замкнутый «Other»-сектором — MS-OI29500 §2.1.1507(a), обращён центром к 3 часам ко вторичной, цвет — следующая ротация палитры; пара пирогов центрирована, зазор `GAP_FIT=0.25·d1` — Word-эмпирика; вторичный пирог/стек, разбиение по `c:splitType` §21.2.2.155 (splitPos — MS-OI29500 §2.1.1554a/b), вторичный пирог стартует от конца «Other»-сектора; `c:serLines` — ровно две связи от границ «Other»-сектора к ободу вторичного на 270°±wedgeSweep / левым углам столбца — MS-OI29500 §2.1.1545(a))/`Surface2dPainter` (контурная карта §21.2.2.204: полосы высот между ломаными соседних рядов §21.2.2.13, передняя стенка — полоса значения переднего края; `c:wireframe` §21.2.2.230 — вид сверху (X=категории, Y=ряды, серия 0 внизу) без заливок: изолинии на границах полос высот `lo+k·unit` цветом нижней полосы (c:bandFmts §21.2.2.13/.14, без них — палитра), marching squares, седло — по среднему ячейки; сетка catAx/serAx, рамка plot; ось значений не рисуется)/`Cartesian3dPainter` (bar3D/line3D/area3D §21.2.2.19/.101/.122 — камера `Surface3dPainter.project`, ряды уходят в глубину; bar3D: `c:shape` box/cone/cylinder/pyramid + `*ToMax` §21.2.3.44 (per-series `c:shape` переопределяет диаграммный, горизонтальная ориентация — всегда box), `c:grouping` stacked/percentStacked §21.2.2.76 (одна полоса глубины на категорию, сегменты столбиком, percent — нормировка к 100%; area3D stacked — полосы на стене v=0, line3D grouping игнорирует), `c:gapDepth` — MS-OI29500 §2.1.1474, подписи serAx рисуются, `c:delete` осей учитывается); `SmartArtRenderer` рисует кэш разложенной схемы (relationship `…/office/2007/relationships/diagramDrawing`, фактически `word/diagrams/drawing1.xml`), формы строит `PresetGeometry` — ECMA-пресет-геометрия `a:prstGeom`: avLst/gdLst/pathLst семи пресетов (rect, roundRect, ellipse, gear6, gear9, circularArrow, leftCircularArrow) дословно из `presetShapeDefinitions.xml`, вычислитель префиксных формул; оператор `?:` = «if x > 0 then y else z» (ISO/IEC 29500-1, НЕ x != 0), углы в Arc2D передавать со знаком минус (математическая конвенция y вверх), неизвестный пресет → прямоугольник ячейки (синхрон таблицы со стандартом пинит `PresetGeometryTest#tableMatchesEcmaXml`); палитра темы — `DrawMlColor` (instance; без ThemePart — дефолтная Office-палитра `accent1=4472C4`…); текст — `DrawMlText` (шрифты — тот же бандл через `BundledFontMapper.bundledFamily`); утилиты `RgbHsl`. Калибровочные константы менять только вместе с `Surface3dPainterTest`/`PiePainterTest`. Защитные лимиты против враждебного chart-XML: `ChartSpec.MAX_POINTS` (`c:pt/@idx` §21.2.2.150/.151 и `c:ptCount` §21.2.2.152 — ST_UnsignedInt без верхней границы, отказ `IllegalArgumentException` до предвыделения списка) и `MAX_TICKS` (см. выше); бросок перехватывает catch `DrawingPreRenderer.renderChart` → штатная деградация «объект удалён + warn». Обход `pkg.getParts()` — только по **снимку** списка (`createImagePart` мутирует реестр → CME); rels частей — `part.getRelationshipsPart()`, НЕ `getOwningRelationshipPart()` (это rels ссылающегося); обход XML обязан раскрывать `JAXBElement`. ### Критические инварианты (нарушение = битый вывод) @@ -160,7 +160,7 @@ gateway). Кеш раннеров — сервер act_runner (серверна - **PDF сравнивается текстом, не растеризацией**: PDFBox 3 (`Loader.loadPDF`) — `PDFTextStripper` для текста (пер-странично `setStartPage/setEndPage`), override `processTextPosition` для шрифта конкретного символа (`fontNameOf`), обход ресурсов страниц для встроенных шрифтов (`EAAAAA+Carlito-Bold`) и счётчик картинок (`imageCount`). Негативные маркеры — регрессии: `assertFalse(text.contains("#"))` (.notdef), `assertFalse(font.startsWith("Helvetica"))`. Текст нормализуется по пробелам (`norm`); в `tableImage_tableAndImage` — полное удаление пробелов (docx4j переносит слова в auto-fit таблицах). - Пиксели (BufferedImage) — только в unit-тестах chart-пейнтеров: безразмерные отношения к эталону Word (экспорт 300 dpi, числа зашиты в тесты), допуски `assertRatio` <0.06 (`PiePainterTest`, `CartesianPainterTest`) / <0.10 (`Surface3dPainterTest`, + `assertRange` ±6 pt для центров силуэта); пороги залитых px, перцентильные коридоры яркости, «серый» px — разброс каналов `GRAY_MAX_SPREAD=25`. Эталонные файлы — `develop/`, вне git. - `GlyphFont` (fontbox): метрики пиксельно-метрически эквивалентны AWT (ascent/descent/leading/advance совпадают до 4-го знака, кернинг-дрейф 0.0000 — DejaVu Sans, Carlito). Приёмочный стенд без-fontconfig: контейнер без `libfontconfig.so.1*` и `/etc/fonts`, `mvn verify` + `java -jar` (до перехода на GlyphFont там падали `GlyphCoverageNormalizerTest` 12 / `CartesianPainterTest` 3 / `PiePainterTest` 2 / chart-тесты `WordPdfConverterTest` 4, chart-рендер молча деградировал). `GlyphFontTest` написан без единого `java.awt.Font` — обязан проходить на хосте без fontconfig. -- Фикстуры — закоммиченные `samples/*.docx` (13; в тестах не генерировать; все ECMA-conformant по `docs/standards/validate-fixtures.py` — фикстура невалидна, правится фикстура, не код): core грузит classpath-ресурсом → `byte[]`, PDF для PDFBox — временный файл; app читает `/samples/…` из **test-jar core** (classifier `tests`) → `mvn -pl wordpdf-app` без `-am` не соберётся. In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]`. Ключевые: `too-many-pages` (150 явных разрывов → 151), `stale-cache` (кэш `1` + 110 `lastRenderedPageBreak`), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject), `ole-embedded` (осиротевший bin с ложным `Default bin→footer+xml` + настоящий `w:object` с честным `Override → oleObject`; ручная, генератором не перезаписывать), `chart-types` (11 графиков: 9 типов + ofPie pie-вариант (`c:ofPieType`="pie") + lineChart `c:grouping`=stacked; пересоздание — `ChartTypesDocxGenerator`). +- Фикстуры — закоммиченные `samples/*.docx` (13; в тестах не генерировать; все ECMA-conformant по `docs/standards/validate-fixtures.py` — фикстура невалидна, правится фикстура, не код): core грузит classpath-ресурсом → `byte[]`, PDF для PDFBox — временный файл; app читает `/samples/…` из **test-jar core** (classifier `tests`) → `mvn -pl wordpdf-app` без `-am` не соберётся. In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]`. Ключевые: `too-many-pages` (150 явных разрывов → 151), `stale-cache` (кэш `1` + 110 `lastRenderedPageBreak`), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject), `ole-embedded` (осиротевший bin с ложным `Default bin→footer+xml` + настоящий `w:object` с честным `Override → oleObject`; ручная, генератором не перезаписывать), `chart-types` (12 графиков + wireframe-поверхность = 13: 9 типов + ofPie pie-вариант (`c:ofPieType`="pie") + lineChart `c:grouping`=stacked + `c:wireframe` val="1"; пересоздание — `ChartTypesDocxGenerator`). - Юниты нормализаторов работают строками (`rewrite`) + zip'ами из `ZipOutputStream`; обязательные контракты: «нечего менять → тот же массив» (`assertSame` покрыт тестами только у zip-нормализаторов `DocxOnOff`/`SymbolFont`/`StrictOoxml`; у `Field`/`GlyphCoverage`/`InvisibleChar` — `rewrite`→`null`) и неприкосновенность частей вне `word/*.xml` (`[Content_Types].xml`). Тесты бьют и в package-private API (`GlyphCoverageNormalizer.split(text, family)`, `ChartSpec.readTitle`). Исключение — `OleObjectNormalizerTest`: многочастный нормализатор без `rewrite`-хука, тесты только через `normalize` на in-memory zip. - App-тесты: `@SpringBootTest` + `@AutoConfigureMockMvc` (Boot 4: `org.springframework.boot.webmvc.test.autoconfigure`); три контекста — `ConvertControllerTest` (пустой ключ), `ApiKeyFilterTest` (`properties = "wordpdf.api-key=…"`), `ConvertLimitsTest`/`ConversionTimeoutTest` (`@TestPropertySource` — отдельные классы, не `@Nested`). - Регрессивные пары (фикс = нормализатор/pre-renderer + юнит + конвертер-тест с фикстурой): `StrictOoxmlNormalizerTest`↔`strictOoxml_convertsNotRejected` (+`pageCount_strictBreaksCountedLightweight` — lightweight против strict), `DocxOnOffNormalizerTest`↔`ruPlain_regularRunsUseRegularFont`, `SymbolFontNormalizerTest`↔`symbolFonts_bulletsAreNotHash`, `FieldNormalizerTest`↔`pageNumbers_recomputedNotCached`, `InvisibleCharNormalizerTest`↔`invisibleChars_noEmptyLines`, `GlyphCoverageNormalizerTest`↔`exoticGlyphs_drawnNotHash`, `OleObjectNormalizerTest`↔`oleObjects_removedAndConverted`/`drawingErrors_errorFlagRejectsOle` (+app `errorFlagOle_rejected`/`oleObjects_removedByDefault`), `WordPdfValidatorTest`↔`staleCachePageCountRejectedBeforeRender` (+`checkPageCount_limitBoundary` 99/100/101, `pageCount_breaksInsideTablesAreCounted`, `pageCount_continuousSectionsNotCountedLightweight`, `validate_notAZip`↔`inputNotAZip_rejectedBeforeRender`, `validate_plainZipRejected`/`validate_xlsxRenamedRejected`/`validate_zipBombRejected`/`validate_tooManyEntriesRejected`↔`plainZipNotDocx_rejected`/`inputNotDocx_rejectedBeforeRender` — контейнер и zip-бомба), `BundledFontsTest`↔`ruPlain_emDashEmbeddedNotHelvetica`, `ChartSpecTest`↔автозаголовки, `PresetGeometryTest`↔`chartsSmartArt_drawingsBecomeImages` (`tableMatchesEcmaXml` — синхрон таблицы пресетов с ECMA XML; кольцевые стрелки — семантика `?:` и знаки дуг Arc2D), chart-пейнтеры↔`chartsSmartArt_drawingsBecomeImages` (+`drawingErrors_*`↔app `errorFlagCharts_rejected`/`errorFlagSmartArt_rejected`), новые пейнтеры `ScatterPainterTest`/`RadarPainterTest`/`StockPainterTest`/`OfPiePainterTest`/`Surface2dPainterTest`/`Cartesian3dPainterTest`↔`chartTypes_allTypesRenderAsImages` (фикстура `chart-types`; ось X scatter/bubble и OF_PIE-заголовок — `ChartSpecTest`), lineChart stacked — `ChartSpecTest#lineGroupingParsed` + `ChartRendererTest#stackedCumulative_*`/`stackedRange_coversNegativeSums` + `CartesianPainterTest#stackedLine_seriesStackCumulatively`/`percentStackedLine_topSeriesFlatAtHundred`↔`chartTypes_allTypesRenderAsImages`; `noLoggingWarningInPdf` — регрессия `slf4j-simple`, `pdfTitle_comesFromParameter` — регрессия PDF-title (юнит-партнёра нет). App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed` (гонка реестра `PhysicalFonts`), `corruptNotAZip_rejected`, `plainZipNotDocx_rejected` (голый zip без манифеста → 400), `junkInsideValidZip_conversionError` (500 на валидном .docx-контейнере с мусором), `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `drawingsAlwaysRendered`, `cyrillicAndPathInFilename_sanitizedResponseName` (RFC 5987 + path-traversal), `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey` (открытая документация + матч фильтра без forwarded-contextPath), `dotSegmentOpenPrefix_rejected` (точечные сегменты `..`/`%2e` — не открытый путь), `errorFlagNotBoolean_rejected` (битый error-флаг → 400); DoS/корректность core: `ChartSpecTest#hugePointIndex_rejectedNotOom`/`hugePtCount_rejectedNotOom`/`hugeCategoryIndex_rejectedNotOom` (`MAX_POINTS`), `Surface3dPainterTest#axisBounds_tinyMajorUnit_fallsBackToNiceUnit`/`axisBounds_zeroMajorUnit_fallsBackToNiceUnit` (`MAX_TICKS`), `GlyphCoverageNormalizerTest#multipleTextNodes_runLeftUntouched` (guard составного рана)/`nestedRunInTextBox_innerSplit` + `SymbolFontNormalizerTest#nestedRunInTextBox_innerNormalized` (вложенные раны текстбоксов), `CartesianPainterTest#areaFill_closesToBaseline` (AREA к базовой линии), `ChartRendererTest#overlayLegend_drawnOverPlot` + `ChartSpecTest#overlayLegend_keepsPositionAndFlag` (overlay-легенда). diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainter.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainter.java index a988f08..fa09eda 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainter.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainter.java @@ -5,24 +5,32 @@ import java.awt.Color; import java.awt.Graphics2D; import java.awt.RenderingHints; import java.awt.geom.Line2D; -import java.awt.geom.Path2D; import java.awt.geom.Rectangle2D; import java.util.ArrayList; import java.util.List; /** - * Поверхностная диаграмма без объёма (c:surfaceChart, ECMA-376 §21.2.2.204): - * «отображает взаимосвязь между категориями и осью значений» — то есть - * рисуется в системе координат «категория × значение»: ось значений слева, - * категории снизу. Каждый ряд — ломаная через категории; лист поверхности - * идёт от переднего ряда к задним, и на экране виден торцом: полосы между - * соседними ломаными красятся контурными полосами высот (c:bandFmts, - * §21.2.2.13 — индексация от низкого к высокого; без bandFmts — палитра), - * передняя стенка от пола до ряда 0 — полосой значения переднего края. - * c:wireframe (§21.2.2.205) — вместо заливок сетка из ломаных рядов и - * линий по категориям. + * Контурная диаграмма (c:surfaceChart, ECMA-376 §21.2.2.204), два режима. * - * Регрессия — Surface2dPainterTest, фикстура samples/chart-types.docx + *

Заливочный (c:wireframe val="0"): «отображает взаимосвязь между + * категориями и осью значений» — система координат «категория × значение»: + * ось значений слева, категории снизу. Каждый ряд — ломаная через + * категории; лист поверхности идёт от переднего ряда к задним, и на экране + * виден торцом: полосы между соседними ломаными красятся контурными + * полосами высот (c:bandFmts, §21.2.2.13 — индексация от низкого к + * высокого; без bandFmts — палитра), передняя стенка от пола до ряда 0 — + * полосой значения переднего края. + * + *

c:wireframe (§21.2.2.230) — вид сверху, как Word: «surface charts + * viewed from above… shows only the lines. The lines… connect interpolated + * points of equal value» (Microsoft Support). X — категории, Y — ряды + * (серия 0 внизу), заливок и оси значений нет: изолинии на внутренних + * границах полос высот lo + k·unit цветом полосы НИЖЕ уровня + * (c:bandFmts §21.2.2.13/.14, без них — палитра), marching squares + * ({@link #cellSegments}), седло — по среднему ячейки; сетка узлов + * catAx/serAx и рамка области построения. + * + *

Регрессия — Surface2dPainterTest, фикстура samples/chart-types.docx * (WordPdfConverterTest#chartTypes_allTypesRenderAsImages). */ final class Surface2dPainter { @@ -33,6 +41,18 @@ final class Surface2dPainter { /** Отрезок полосы короче этого не рисуется (эпсилон float-сравнения). */ private static final double MIN_SEGMENT = 1e-9; + /** Страж нулевой длины ребра при интерполяции уровня (marching squares). */ + private static final double LEVEL_EPS = 1e-12; + + /** Число пересечений ребра ячейки уровнем: пара — один сегмент. */ + private static final int HITS_PAIR = 2; + + /** Число пересечений ребра ячейки уровнем: седло — два сегмента. */ + private static final int HITS_SADDLE = 4; + + /** Число пересечений ребра ячейки уровнем: два поперечных + узел — один сегмент. */ + private static final int HITS_WITH_NODE = 3; + static void paint(Graphics2D g, ChartSpec spec, Rectangle2D box, List palette) { int nSer = spec.series.size(); int nCat = 0; @@ -65,6 +85,11 @@ final class Surface2dPainter { int bandCount = Math.max(1, (int) Math.ceil((hi - lo) / unit - 1e-9)); List bands = spec.bandColors.isEmpty() ? palette : spec.bandColors; + if (spec.wireframe) { + paintWireframe(g, spec, z, nSer, nCat, lo, unit, bandCount, bands, box); + return; + } + // Поля под подписи осей — та же auto-layout-эвристика, что у // CartesianPainter (подписи значений слева, категорий снизу). List cats = CartesianPainter.categoriesOf(spec, nCat); @@ -97,11 +122,7 @@ final class Surface2dPainter { } } - if (spec.wireframe) { - drawWireframe(g, z, nSer, nCat, lo, hi, plot, valAxis); - } else { - drawContour(g, z, nSer, nCat, lo, hi, unit, bandCount, bands, plot); - } + drawContour(g, z, nSer, nCat, lo, hi, unit, bandCount, bands, plot); // Оси поверх: линия категории и подписи. if (catAxis.axisLineColor != null && !catAxis.deleted) { @@ -167,31 +188,280 @@ final class Surface2dPainter { g.setRenderingHint(RenderingHints.KEY_ANTIALIASING, oldAA); } - /** c:wireframe: сетка листа — ломаные рядов + линии по категориям. */ - private static void drawWireframe(Graphics2D g, double[][] z, int nSer, int nCat, - double lo, double hi, Rectangle2D plot, - ChartSpec.AxisSpec valAxis) { - g.setColor(valAxis.gridColor); - g.setStroke(new BasicStroke(0.6f)); + /** + * c:wireframe (§21.2.2.230) — вид сверху, как Word: X — категории, + * Y — ряды (серия 0 внизу); рисуются только изолинии, сетка узлов + * catAx/serAx и рамка области построения — заливок и оси значений нет + * (значения кодируют изолинии и легенда полос). Word пишет serAx + * axPos="r" для поверхностей; иное положение serAx — подписи слева. + */ + private static void paintWireframe(Graphics2D g, ChartSpec spec, double[][] z, + int nSer, int nCat, double lo, double unit, + int bandCount, List bands, + Rectangle2D box) { + ChartSpec.AxisSpec serAxis = spec.serAxis != null + ? spec.serAxis : new ChartSpec.AxisSpec(); + ChartSpec.AxisSpec catAxis = spec.catAxis != null + ? spec.catAxis : new ChartSpec.AxisSpec(); + boolean serRight = spec.serAxis != null && "r".equals(serAxis.pos); + + List cats = CartesianPainter.categoriesOf(spec, nCat); + List serLabels = new ArrayList<>(); for (int r = 0; r < nSer; r++) { - Path2D p = new Path2D.Double(); + String name = spec.series.get(r).name; + serLabels.add(name == null || name.isEmpty() ? String.valueOf(r + 1) : name); + } + + // Поля под подписи — та же эвристика, что у filled-ветки (ряды вместо значений). + double catGutter = catAxis.labelStyle != null + ? DrawMlText.textHeight(catAxis.labelStyle) + 6 : 6; + double serGutter = 8; + if (serAxis.labelStyle != null) { + for (String l : serLabels) { + serGutter = Math.max(serGutter, + DrawMlText.textWidth(l, serAxis.labelStyle) + 8); + } + } + Rectangle2D plot = new Rectangle2D.Double( + serRight ? box.getX() : box.getX() + serGutter, box.getY(), + Math.max(10, box.getWidth() - serGutter), + Math.max(10, box.getHeight() - catGutter)); + + // Сетка по узлам осей — под изолиниями. + if (catAxis.gridlines && !catAxis.deleted) { + g.setColor(catAxis.gridColor); + g.setStroke(new BasicStroke(0.6f)); for (int c = 0; c < nCat; c++) { double x = xOf(c, plot, nCat); - double y = yOf(z[r][c], lo, hi, plot); - if (c == 0) { - p.moveTo(x, y); - } else { - p.lineTo(x, y); + g.draw(new Line2D.Double(x, plot.getY(), x, + plot.getY() + plot.getHeight())); + } + } + if (spec.serAxis != null && serAxis.gridlines && !serAxis.deleted) { + g.setColor(serAxis.gridColor); + g.setStroke(new BasicStroke(0.6f)); + for (int r = 0; r < nSer; r++) { + double y = serY(r, plot, nSer); + g.draw(new Line2D.Double(plot.getX(), y, + plot.getX() + plot.getWidth(), y)); + } + } + + // Изолинии — с антиалиасингом (в отличие от заливки filled-ветки). + g.setStroke(new BasicStroke(0.75f)); + drawContourLines(g, z, nSer, nCat, lo, unit, bandCount, bands, plot); + + // Рамка области построения — это рамка области, а не ось. + if (catAxis.axisLineColor != null) { + g.setColor(catAxis.axisLineColor); + g.setStroke(new BasicStroke((float) Math.max(0.5, catAxis.axisLineWidth))); + g.draw(plot); + } + + // Подписи категорий — по ЦЕНТРАМ узлов сетки (не слотов, как в filled). + if (catAxis.labelStyle != null) { + DrawMlText.Style style = catAxis.labelStyle; + double h = DrawMlText.textHeight(style) + 2; + double slot = plot.getWidth() / Math.max(1, nCat - 1); + for (int i = 0; i < nCat && i < cats.size(); i++) { + String label = cats.get(i); + if (label.isEmpty()) { + continue; + } + double w = DrawMlText.textWidth(label, style); + if (w > slot * 1.15) { + continue; + } + DrawMlText.paint(g, List.of(new DrawMlText.Paragraph(label, style, "ctr")), + new Rectangle2D.Double(xOf(i, plot, nCat) - w / 2, + plot.getY() + plot.getHeight() + 3, w, h), + "ctr", "t", 1.0); + } + } + // Подписи рядов — по центрам узлов строк, со стороны serAx. + if (serAxis.labelStyle != null) { + DrawMlText.Style style = serAxis.labelStyle; + double h = DrawMlText.textHeight(style) + 2; + for (int r = 0; r < nSer; r++) { + String label = serLabels.get(r); + if (label.isEmpty()) { + continue; + } + double w = Math.max(10, DrawMlText.textWidth(label, style)); + double y = serY(r, plot, nSer); + Rectangle2D rect = serRight + ? new Rectangle2D.Double(plot.getX() + plot.getWidth() + 6, + y - h / 2, w, h) + : new Rectangle2D.Double(plot.getX() - 6 - w, y - h / 2, w, h); + DrawMlText.paint(g, + List.of(new DrawMlText.Paragraph(label, style, + serRight ? "l" : "r")), + rect, serRight ? "l" : "r", "ctr", 1.0); + } + } + } + + /** + * Изолинии: «the lines… connect interpolated points of equal value» — + * на каждой внутренней границе полос высот lo + k·unit (k = 1..bandCount−1) + * цветом полосы НИЖЕ уровня (пиксельный разбор эталона Excel: линия на + * границе «коричневая полоса | серая полоса» — оттенок коричневого). + * Геометрия — marching squares по ячейкам сетки, см. {@link #cellSegments}. + */ + private static void drawContourLines(Graphics2D g, double[][] z, int nSer, int nCat, + double lo, double unit, int bandCount, + List bands, Rectangle2D plot) { + for (int k = 1; k < bandCount; k++) { + double level = lo + k * unit; + g.setColor(bands.get((k - 1) % bands.size())); + for (int r = 0; r < nSer - 1; r++) { + double y0 = serY(r, plot, nSer); + double y1 = serY(r + 1, plot, nSer); + for (int c = 0; c < nCat - 1; c++) { + double x0 = xOf(c, plot, nCat); + double x1 = xOf(c + 1, plot, nCat); + for (Line2D.Double seg : cellSegments(z[r][c], z[r][c + 1], + z[r + 1][c + 1], z[r + 1][c], level, x0, x1, y0, y1)) { + g.draw(seg); + } } } - g.draw(p); } - for (int c = 0; c < nCat; c++) { - double x = xOf(c, plot, nCat); - double yTop = yOf(z[nSer - 1][c], lo, hi, plot); - double yBot = yOf(z[0][c], lo, hi, plot); - g.draw(new Line2D.Double(x, Math.min(yTop, yBot), x, Math.max(yTop, yBot))); + } + + /** + * Marching squares: сегменты линии уровня в одной ячейке сетки. + * Узлы A=(x0,y0)↔z00, B=(x1,y0)↔z10, C=(x1,y1)↔z11, D=(x0,y1)↔z01; + * «внутри» — z >= level (узел точно на уровне = внутри → линия проходит + * через узел). Возвращает 0, 1 или 2 сегмента. Ребро, оба конца которого + * точно на уровне, — целый сегмент (иначе вдоль ребра дыра в изолинии; + * Word её рисует), а такой узел «поглощает» пересечение соседнего ребра + * (линия проходит через узел вдоль ребра, диагональ неверна — двучленное + * уровень-множество биллинейной функции в этом случае даёт именно рёбра). + * Совпавшие в узле пересечения соседних рёбер дедуплицируются: изолиния + * проходит через узел. Седло (4 пересечения) решается центром ячейки: + * avg >= level — сегменты огибают «внутренние» углы, иначе — «внешние». + * + *

Package-private для прямых геометрических юнит-тестов (как + * rewrite-хук нормализаторов). Регрессия — Surface2dPainterTest#cellSegments_*. + */ + static List cellSegments(double z00, double z10, double z11, double z01, + double level, double x0, double x1, + double y0, double y1) { + double[] z = {z00, z10, z11, z01}; + double[] xs = {x0, x1, x1, x0}; + double[] ys = {y0, y0, y1, y1}; + boolean[] inside = new boolean[4]; + boolean[] onLevel = new boolean[4]; + for (int i = 0; i < 4; i++) { + inside[i] = z[i] >= level; + onLevel[i] = z[i] == level; } + List segs = new ArrayList<>(); + boolean[] full = new boolean[4]; + for (int i = 0; i < 4; i++) { + int j = (i + 1) % 4; + if (onLevel[i] && onLevel[j]) { + full[i] = true; + addSegment(segs, xs[i], ys[i], xs[j], ys[j]); + } + } + boolean[] absorbed = new boolean[4]; + for (int i = 0; i < 4; i++) { + absorbed[i] = onLevel[i] && (full[i] || full[(i + 3) % 4]); + } + double[][] hit = new double[4][]; + for (int i = 0; i < 4; i++) { + int j = (i + 1) % 4; + if (full[i] || inside[i] == inside[j] + || Math.abs(z[j] - z[i]) < LEVEL_EPS + || absorbed[i] || absorbed[j]) { + continue; + } + double t = (level - z[i]) / (z[j] - z[i]); + hit[i] = new double[] {xs[i] + (xs[j] - xs[i]) * t, ys[i] + (ys[j] - ys[i]) * t}; + } + // Совпадения пересечений в узлах (соседние рёбра бьют в один узел) — + // одно пересечение: без дедупликации в ячейках вида (3,6,4,2) — узел + // z=4 фикстуры hill, уровень 4 — было бы «3 удара» и сегмент терялся. + List edges = new ArrayList<>(); + for (int i = 0; i < 4; i++) { + if (hit[i] != null && !coincident(hit, edges, i)) { + edges.add(i); + } + } + if (edges.size() == HITS_PAIR) { + double[] p = hit[edges.get(0)]; + double[] q = hit[edges.get(1)]; + addSegment(segs, p[0], p[1], q[0], q[1]); + } else if (edges.size() == HITS_WITH_NODE) { + // Два поперечных + одно точно в узле: узел — изолированная точка + // уровень-множества (ветвь уходит из ячейки по ребру соседям), + // рисуем сегмент между поперечными пересечениями. + double[] p = null; + double[] q = null; + for (int e : edges) { + if (isNode(hit[e], xs, ys)) { + continue; + } + if (p == null) { + p = hit[e]; + } else { + q = hit[e]; + } + } + if (p != null && q != null) { + addSegment(segs, p[0], p[1], q[0], q[1]); + } + } else if (edges.size() == HITS_SADDLE) { + double avg = (z00 + z10 + z11 + z01) / 4; + // Рёбра e0=A-B, e1=B-C, e2=C-D, e3=D-A. A,C внутри: avg >= level — + // огибаем внутренние углы парами (e3,e0)+(e1,e2), иначе зеркально; + // B,D внутри — наоборот. + int[][] pairs = inside[0] == (avg >= level) + ? new int[][] {{3, 0}, {1, 2}} + : new int[][] {{0, 1}, {2, 3}}; + for (int[] pr : pairs) { + addSegment(segs, hit[pr[0]][0], hit[pr[0]][1], + hit[pr[1]][0], hit[pr[1]][1]); + } + } + return segs; + } + + /** Совпадает ли пересечение ребра i с пересечением одного из рёбер done. */ + private static boolean coincident(double[][] hit, List done, int i) { + for (int e : done) { + if (hit[e][0] == hit[i][0] && hit[e][1] == hit[i][1]) { + return true; + } + } + return false; + } + + /** Точка — узел ячейки. */ + private static boolean isNode(double[] p, double[] xs, double[] ys) { + for (int k = 0; k < 4; k++) { + if (p[0] == xs[k] && p[1] == ys[k]) { + return true; + } + } + return false; + } + + /** Сегмент ненулевой длины (эпсилон {@link #MIN_SEGMENT}). */ + private static void addSegment(List segs, double x1, double y1, + double x2, double y2) { + double dx = x2 - x1; + double dy = y2 - y1; + if (dx * dx + dy * dy >= MIN_SEGMENT * MIN_SEGMENT) { + segs.add(new Line2D.Double(x1, y1, x2, y2)); + } + } + + /** Узел строки в виде сверху: серия 0 — внизу. */ + private static double serY(int r, Rectangle2D plot, int nSer) { + return plot.getY() + plot.getHeight() * (1 - (double) r / (nSer - 1)); } /** Высота листа на срезе x: линейная интерполяция ломаной ряда. */ diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/ChartTypesDocxGenerator.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/ChartTypesDocxGenerator.java index 561d04c..6c017dc 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/ChartTypesDocxGenerator.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/ChartTypesDocxGenerator.java @@ -11,11 +11,11 @@ import java.util.zip.ZipEntry; import java.util.zip.ZipOutputStream; /** - * Генератор фикстуры {@code samples/chart-types.docx}: 12 диаграмм: 9 типов, + * Генератор фикстуры {@code samples/chart-types.docx}: 13 диаграмм: 9 типов, * которых POI не пишет (scatter, bubble, radar, stock, ofPie, bar3D, * area3D, line3D, surface2D), + ofPie pie-вариант + lineChart и линейчатая - * (barDir=bar) с c:grouping=stacked — chart-XML - * литералами по ECMA-376 §21.2 + * (barDir=bar) с c:grouping=stacked + wireframe-поверхность + * (c:wireframe val="1") — chart-XML литералами по ECMA-376 §21.2 * (фикстура проходит docs/standards/validate-fixtures.py). Регрессия — * WordPdfConverterTest#chartTypes_allTypesRenderAsImages. * @@ -38,8 +38,8 @@ public final class ChartTypesDocxGenerator { List titles = List.of( "Точечная", "Пузырьковая", "Лепестковая", "Биржевая", "Кольцевая-доля", "Объёмная с столбцами", "Объёмная с областями", - "Объёмная с линиями", "Поверхность", "График с накоплением", - "Вторичная круговая", "Линейчатая с накоплением"); + "Объёмная с линиями", "Поверхность", "Поверхность без заливки", + "График с накоплением", "Вторичная круговая", "Линейчатая с накоплением"); List charts = new ArrayList<>(); charts.add(scatter()); charts.add(bubble()); @@ -50,6 +50,7 @@ public final class ChartTypesDocxGenerator { charts.add(area3d()); charts.add(line3d()); charts.add(surface()); + charts.add(surfaceWireframe()); charts.add(stackedLine()); charts.add(ofPiePie()); charts.add(stackedBar()); @@ -219,6 +220,30 @@ public final class ChartTypesDocxGenerator { + catAx(1, 2) + valAx(2, "l", 1); } + /** + * c:wireframe val="1" (§21.2.2.230) — wireframe-контур: рендерится видом + * сверху (изолинии, сетка catAx/serAx, рамка). Оси — локальными + * литералами с c:majorGridlines (общие хелперы сетку не пишут); serAx — + * axPos="r", как Word пишет для поверхностей. Порядок элементов + * CT_CatAx/CT_SerAx по XSD: axId, scaling, delete, axPos, + * majorGridlines, …, crossAx. + */ + private static String surfaceWireframe() { + return "" + + ser("Строка 1", cat("К1", "К2", "К3", "К4", "К5"), num("1", "2", "3", "2", "1")) + + ser("Строка 2", cat("К1", "К2", "К3", "К4", "К5"), num("2", "4", "6", "4", "2")) + + ser("Строка 3", cat("К1", "К2", "К3", "К4", "К5"), num("3", "6", "9", "6", "3")) + + ser("Строка 4", cat("К1", "К2", "К3", "К4", "К5"), num("2", "4", "6", "4", "2")) + + "" + + "" + + "" + + "" + + valAx(2, "l", 1) + + "" + + "" + + ""; + } + private static String stackedLine() { return "" + ser("План", cat("Q1", "Q2", "Q3"), num("4", "7", "5")) @@ -282,8 +307,12 @@ public final class ChartTypesDocxGenerator { } private static String serAx(int id, int cross) { + return serAx(id, cross, "b"); + } + + private static String serAx(int id, int cross, String pos) { return "" - + ""; + + ""; } private static void put(ZipOutputStream zos, String name, String xml) throws IOException { diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java index 61344aa..e598fe9 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java @@ -171,9 +171,10 @@ class WordPdfConverterTest { /** * Фикстура chart-types.docx (создана вручную, chart-XML литералами — POI - * эти типы не пишет): все двенадцать — точечная, пузырьковая, + * эти типы не пишет): все тринадцать — точечная, пузырьковая, * лепестковая, биржевая, кольцевая-доля, три объёмных декартовых, - * поверхность, график с накоплением и линейчатая с накоплением + * поверхность, wireframe-поверхность (c:wireframe val="1"), + * график с накоплением и линейчатая с накоплением * (c:grouping=stacked, §21.2.2.76) и pie-вариант кольцевой-доли * (c:ofPieType="pie") — * рендерятся в растр, а не удаляются с warn. @@ -185,8 +186,8 @@ class WordPdfConverterTest { String text = norm(pdfText(pdf)); assertTrue(text.contains("Типы диаграмм"), "пропал текст: " + text); - assertEquals(12, distinctImageCount(pdf), - "каждый из 12 графиков должен стать PNG-вставкой"); + assertEquals(13, distinctImageCount(pdf), + "каждый из 13 графиков должен стать PNG-вставкой"); } /** diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainterTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainterTest.java index b4190b2..d3c2a63 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainterTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainterTest.java @@ -3,17 +3,22 @@ package ru.pjandro.wordpdf.internal.chart; import org.junit.jupiter.api.Test; import java.awt.Color; +import java.awt.geom.Line2D; import java.awt.image.BufferedImage; +import java.util.List; import static org.junit.jupiter.api.Assertions.*; /** - * Контурная поверхностная диаграмма (ECMA-376 §21.2.2.204): лист между + * Контурная диаграмма (ECMA-376 §21.2.2.204). Заливочный режим: лист между * ломаными соседних рядов режется контурными полосами высот (c:bandFmts, - * §21.2.2.13 — от низкого к высокого; без них — палитра), c:wireframe — - * сетка из ломаных рядов и линий по категориям без заливок. Регрессия — - * Surface2dPainterTest, фикстура samples/chart-types.docx - * (WordPdfConverterTest#chartTypes_allTypesRenderAsImages). + * §21.2.2.13 — от низкого к высокого; без них — палитра). c:wireframe + * (§21.2.2.230) — вид сверху, как Word: X — категории, Y — ряды (серия 0 + * внизу), без заливок и оси значений; рисуются изолинии на внутренних + * границах полос высот lo + k·unit цветом полосы НИЖЕ уровня (marching + * squares, седло — по среднему ячейки), сетка узлов catAx/serAx и рамка + * области построения. Регрессия — Surface2dPainterTest, фикстура + * samples/chart-types.docx (WordPdfConverterTest#chartTypes_allTypesRenderAsImages). */ class Surface2dPainterTest { @@ -21,7 +26,18 @@ class Surface2dPainterTest { private static final Color ACCENT2 = new Color(0xED7D31); private static final Color ACCENT3 = new Color(0xA5A5A5); private static final Color ACCENT4 = new Color(0xFFC000); - private static final Color GRID = new Color(0xD9, 0xD9, 0xD9); + + /** Масштаб растра: 300 dpi → pt·25/6 px. */ + private static final double PX = 300.0 / 72.0; + + /** + * Геометрия render(): box = (4, 4, 211.23, 141.08) pt; в wireframe без + * подписей осей plot = (12, 4, 203.23, 135.08) pt (serGutter 8, catGutter 6). + */ + private static final double PLOT_X = 12; + private static final double PLOT_W = 203.23; + private static final double PLOT_Y = 4; + private static final double PLOT_H = 135.08; /** * Плоские ряды 0/2/4: lo=0, hi=4, unit=1 → лист от 0 до 4 делится на @@ -41,21 +57,217 @@ class Surface2dPainterTest { "полоса 3-4 не accent4: " + hex(px(img, 400, 87))); } - /** wireframe: заливок нет, есть сетка листа цветом gridlines. */ + /** + * Вид сверху, z[r][c] = c: lo=0, hi=4, unit=1 → изолинии уровней 1, 2, 3 — + * вертикали точно в узлах xOf(1..3) цветами полос НИЖЕ уровня + * (accent1/2/3); между изолиниями — белый. + */ @Test - void wireframe_gridOnly() { - BufferedImage img = render(surfaceSpec(true)); - assertFalse(matches(px(img, 400, 507), ACCENT1), - "wireframe не должен заливать полосы"); - long grid = 0; + void wireframeContour_verticalIsolinesAtNodeColumns() { + double[][] z = { + {0, 1, 2, 3, 4}, + {0, 1, 2, 3, 4}, + {0, 1, 2, 3, 4}, + }; + BufferedImage img = render(wireframeSpec(z)); + int y = (int) Math.round((PLOT_Y + PLOT_H / 2) * PX); + assertTrue(matches(px(img, xPx(1, 5), y), ACCENT1), + "изолиния уровня 1 не accent1: " + hex(px(img, xPx(1, 5), y))); + assertTrue(matches(px(img, xPx(2, 5), y), ACCENT2), + "изолиния уровня 2 не accent2: " + hex(px(img, xPx(2, 5), y))); + assertTrue(matches(px(img, xPx(3, 5), y), ACCENT3), + "изолиния уровня 3 не accent3: " + hex(px(img, xPx(3, 5), y))); + int between = (int) Math.round((xPt(0, 5) + xPt(1, 5)) / 2 * PX); + assertFalse(isAccent(px(img, between, y)), + "между изолиниями не белый: " + hex(px(img, between, y))); + } + + /** + * z[r][c] = c + 0.5: уровень 1 (lo=0, hi=5, unit=1) пересекает ребро + * c0→c1 в t=0.5 — изолиния на середине шага категорий, не в узле. + */ + @Test + void wireframeContour_interpolatedCrossingPosition() { + double[][] z = { + {0.5, 1.5, 2.5, 3.5, 4.5}, + {0.5, 1.5, 2.5, 3.5, 4.5}, + {0.5, 1.5, 2.5, 3.5, 4.5}, + }; + BufferedImage img = render(wireframeSpec(z)); + int y = (int) Math.round((PLOT_Y + PLOT_H / 2) * PX); + double xLevel1 = xPt(0, 5) + (xPt(1, 5) - xPt(0, 5)) * 0.5; + int xc = (int) Math.round(xLevel1 * PX); + boolean found = false; + for (int x = xc - 3; x <= xc + 3; x++) { + if (matches(px(img, x, y), ACCENT1)) { + found = true; + } + } + assertTrue(found, "изолиния уровня 1 не найдена у x=" + xc); + assertFalse(isAccent(px(img, xc - 25, y)), + "слева от изолинии не белый: " + hex(px(img, xc - 25, y))); + } + + /** + * 4 ряда × 3 категории, z[r][c] = r: lo=0, hi=3, unit=1 → горизонтали + * уровней 1, 2 в узлах serY(1), serY(2) цветами accent1/2; серия 0 — внизу + * (serY(1) ниже serY(2) на экране). + */ + @Test + void wireframeContour_horizontalIsolinesAcrossSeries() { + double[][] z = { + {0, 0, 0}, + {1, 1, 1}, + {2, 2, 2}, + {3, 3, 3}, + }; + BufferedImage img = render(wireframeSpec(z)); + int x = (int) Math.round((PLOT_X + PLOT_W / 2) * PX); + int y1 = yPx(1, 4); + int y2 = yPx(2, 4); + assertTrue(y1 > y2, "серия 0 должна быть внизу: serY(1)=" + y1 + " serY(2)=" + y2); + assertTrue(matches(px(img, x, y1), ACCENT1), + "изолиния уровня 1 не accent1: " + hex(px(img, x, y1))); + assertTrue(matches(px(img, x, y2), ACCENT2), + "изолиния уровня 2 не accent2: " + hex(px(img, x, y2))); + assertFalse(isAccent(px(img, x, (y1 + y2) / 2)), + "между изолиниями не белый: " + hex(px(img, x, (y1 + y2) / 2))); + } + + /** + * «Холм» (данные 13-го графика фикстуры chart-types): wireframe рисует + * линии, а не заливки — акцентных пикселей меньше 2% области построения. + */ + @Test + void wireframeContour_noFills() { + double[][] z = { + {1, 2, 3, 2, 1}, + {2, 4, 6, 4, 2}, + {3, 6, 9, 6, 3}, + {2, 4, 6, 4, 2}, + }; + BufferedImage img = render(wireframeSpec(z)); + long accent = 0; for (int y = 0; y < img.getHeight(); y++) { for (int x = 0; x < img.getWidth(); x++) { - if (matches(img.getRGB(x, y), GRID)) { - grid++; + if (isAccent(img.getRGB(x, y))) { + accent++; } } } - assertTrue(grid > 500, "сетки wireframe не найдено"); + long plotPx = Math.round(PLOT_W * PX) * Math.round(PLOT_H * PX); + assertTrue(accent < plotPx * 2 / 100, + "wireframe не должен заливать полосы: акцентных px " + accent + + " из " + plotPx); + } + + /** + * Седло z=(A,B,C,D)=(0,2,0,2), level 1: avg=1 >= level → сегменты огибают + * «внутренние» углы B и D: (середина A-B ↔ середина B-C) и + * (середина C-D ↔ середина D-A). + */ + @Test + void cellSegments_saddleWrapsInsideCorners() { + List segs = Surface2dPainter.cellSegments( + 0, 2, 0, 2, 1, 0, 10, 0, 10); + assertEquals(2, segs.size(), "седло должно дать 2 сегмента"); + assertTrue(hasSegment(segs, 5, 0, 10, 5), "нет сегмента середина(A-B)–середина(B-C)"); + assertTrue(hasSegment(segs, 5, 10, 0, 5), "нет сегмента середина(C-D)–середина(D-A)"); + } + + /** + * Узлы B и C точно на уровне (z=(0,1,1,0), level 1): изолиния проходит + * точно по узлам — сегмент B–C, без диагоналей в ячейку. + */ + @Test + void cellSegments_exactLevelNodesLineThroughNode() { + List segs = Surface2dPainter.cellSegments( + 0, 1, 1, 0, 1, 0, 10, 0, 10); + assertEquals(1, segs.size(), "ожидался один сегмент по узлам уровня"); + assertTrue(hasSegment(segs, 10, 0, 10, 10), "сегмент должен идти B–C"); + } + + /** + * Оба конца ребра A-B точно на уровне (z=(1,1,0,0), level 1): всё рёбер — + * сегмент (иначе вдоль ребра дыра в изолинии). + */ + @Test + void cellSegments_bothEndsOnLevel_edgeIsSegment() { + List segs = Surface2dPainter.cellSegments( + 1, 1, 0, 0, 1, 0, 10, 0, 10); + assertEquals(1, segs.size(), "ожидался один сегмент по ребру A-B"); + assertTrue(hasSegment(segs, 0, 0, 10, 0), "сегмент должен идти A–B"); + } + + /** + * Ячейка (3,6,4,2), level 4: узел C точно на уровне, соседние рёбра бьют + * в него дважды — после дедупликации один сегмент от поперечного + * пересечения e0 до узла C (без дедупликации — «3 удара» и дыра; случай + * фикстуры hill: узел z=4). + */ + @Test + void cellSegments_nodeCrossingNotDropped() { + List segs = Surface2dPainter.cellSegments( + 3, 6, 4, 2, 4, 0, 10, 0, 10); + assertEquals(1, segs.size(), "изолиния через узел не должна теряться"); + assertTrue(hasSegment(segs, 10.0 / 3, 0, 10, 10), + "сегмент должен идти от t=1/3 на A-B до узла C"); + } + + /** Все узлы ниже уровня — сегментов нет. */ + @Test + void cellSegments_allBelowLevel_empty() { + assertTrue(Surface2dPainter.cellSegments(0, 0, 0, 0, 1, 0, 10, 0, 10).isEmpty(), + "ниже уровня изолинии быть не должно"); + } + + /** Спека wireframe-поверхности без подписей осей (серии из z, категории пустые). */ + private static ChartSpec wireframeSpec(double[][] z) { + ChartSpec spec = new ChartSpec(); + spec.type = ChartSpec.Type.SURFACE; + spec.wireframe = true; + spec.legendPos = null; + spec.valAxis = new ChartSpec.AxisSpec(); + for (double[] row : z) { + ChartSpec.Series s = new ChartSpec.Series(); + for (double v : row) { + s.values.add(v); + } + spec.series.add(s); + } + return spec; + } + + /** Пиксельная координата узла категории: xOf(c) = 12 + 203.23·c/(nCat−1). */ + private static double xPt(double c, int nCat) { + return PLOT_X + PLOT_W * c / (nCat - 1); + } + + private static int xPx(double c, int nCat) { + return (int) Math.round(xPt(c, nCat) * PX); + } + + /** Пиксельная координата узла ряда: serY(r) = 4 + 135.08·(1 − r/(nSer−1)), серия 0 внизу. */ + private static int yPx(double r, int nSer) { + return (int) Math.round((PLOT_Y + PLOT_H * (1 - r / (nSer - 1))) * PX); + } + + private static boolean hasSegment(List segs, + double x1, double y1, double x2, double y2) { + for (Line2D.Double s : segs) { + boolean direct = close(s.getX1(), x1) && close(s.getY1(), y1) + && close(s.getX2(), x2) && close(s.getY2(), y2); + boolean reversed = close(s.getX1(), x2) && close(s.getY1(), y2) + && close(s.getX2(), x1) && close(s.getY2(), y1); + if (direct || reversed) { + return true; + } + } + return false; + } + + private static boolean close(double a, double b) { + return Math.abs(a - b) < 1e-9; } private static ChartSpec surfaceSpec(boolean wireframe) { @@ -89,6 +301,11 @@ class Surface2dPainterTest { && Math.abs((rgb & 0xFF) - c.getBlue()) <= 24; } + private static boolean isAccent(int rgb) { + return matches(rgb, ACCENT1) || matches(rgb, ACCENT2) + || matches(rgb, ACCENT3) || matches(rgb, ACCENT4); + } + private static String hex(int rgb) { return String.format("#%06X", rgb & 0xFFFFFF); } diff --git a/wordpdf-core/src/test/resources/samples/chart-types.docx b/wordpdf-core/src/test/resources/samples/chart-types.docx index cceda99..f849208 100644 Binary files a/wordpdf-core/src/test/resources/samples/chart-types.docx and b/wordpdf-core/src/test/resources/samples/chart-types.docx differ