From 076975885c77bbd1fa4a590b2d49962110f52380 Mon Sep 17 00:00:00 2001 From: Pjandro Date: Mon, 5 Oct 2026 19:27:38 +0000 Subject: [PATCH] =?UTF-8?q?=D0=94=D0=B8=D0=B0=D0=B3=D1=80=D0=B0=D0=BC?= =?UTF-8?q?=D0=BC=D1=8B=20=D0=B8=20SmartArt:=20=D0=BF=D1=80=D0=B5-=D1=80?= =?UTF-8?q?=D0=B5=D0=BD=D0=B4=D0=B5=D1=80=20w:drawing=20=D0=B2=20PNG=20(pi?= =?UTF-8?q?e,=20line,=20surface3D)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit docx2fo.xslt умеет только a:graphicData/pic:pic — для c:chart и dgm:relIds там notImplemented, т.е. объект молча исчезал из PDF. Новый internal/chart рендерит их своим Java2D-движком в PNG 300 dpi и подменяет на pic:pic (шаг 3.5 в convertToStream: после setFontMapper, до FOSettings). surface3D: седловая ячейка режется диагональю с большей суммой значений (верхняя огибающая седла). При фиксированной w00–w11 второй треугольник становится невидимой щепкой, а видимая грань окрашивается не той полосой. --- .gitignore | 2 + AGENTS.md | 15 + .../ru/pjandro/wordpdf/WordPdfConverter.java | 6 + .../wordpdf/fonts/BundledFontMapper.java | 12 + .../pjandro/wordpdf/fonts/BundledFonts.java | 30 + .../internal/chart/CartesianPainter.java | 340 ++++++++++ .../wordpdf/internal/chart/ChartRenderer.java | 379 +++++++++++ .../wordpdf/internal/chart/ChartSpec.java | 594 ++++++++++++++++++ .../wordpdf/internal/chart/DrawMlColor.java | 355 +++++++++++ .../wordpdf/internal/chart/DrawMlText.java | 263 ++++++++ .../internal/chart/DrawingPreRenderer.java | 347 ++++++++++ .../wordpdf/internal/chart/PiePainter.java | 248 ++++++++ .../internal/chart/PrstGeomShapes.java | 180 ++++++ .../wordpdf/internal/chart/RgbHsl.java | 80 +++ .../internal/chart/SmartArtRenderer.java | 336 ++++++++++ .../internal/chart/Surface3dPainter.java | 537 ++++++++++++++++ .../pjandro/wordpdf/WordPdfConverterTest.java | 32 + .../wordpdf/internal/chart/ChartSpecTest.java | 57 ++ .../internal/chart/PiePainterTest.java | 107 ++++ .../internal/chart/Surface3dPainterTest.java | 440 +++++++++++++ .../resources/samples/charts-smartart.docx | Bin 0 -> 52254 bytes 21 files changed, 4360 insertions(+) create mode 100644 wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/CartesianPainter.java create mode 100644 wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartRenderer.java create mode 100644 wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartSpec.java create mode 100644 wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlColor.java create mode 100644 wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlText.java create mode 100644 wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawingPreRenderer.java create mode 100644 wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/PiePainter.java create mode 100644 wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/PrstGeomShapes.java create mode 100644 wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/RgbHsl.java create mode 100644 wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/SmartArtRenderer.java create mode 100644 wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Surface3dPainter.java create mode 100644 wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartSpecTest.java create mode 100644 wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/PiePainterTest.java create mode 100644 wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/Surface3dPainterTest.java create mode 100644 wordpdf-core/src/test/resources/samples/charts-smartart.docx diff --git a/.gitignore b/.gitignore index 9b328c1..46dd673 100644 --- a/.gitignore +++ b/.gitignore @@ -13,3 +13,5 @@ dependency-reduced-pom.xml # OS .DS_Store Thumbs.db + +# Локальные примеры и выгрузки в корне diff --git a/AGENTS.md b/AGENTS.md index 1426ad3..30db6e1 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -29,6 +29,21 @@ - Пайплайн: байты docx → `DocxOnOffNormalizer` → docx4j → XSL-FO (XSLT) → FOP → PDF. - Порядок инициализации в `WordPdfConverter.convertToStream` важен: сначала `new BundledFontMapper()`, потом `BundledFonts.init()` (бандл-шрифты регистрируются поверх системных), затем `BundledFonts.restrictToBundled()` (чистит реестр `PhysicalFonts` от системных шрифтов до `load()`; конструктор маппера каждый раз заново добавляет их, и `GlyphCheck` на Windows находит системный Calibri — em-dash остаётся на Carlito, красный `ruPlain_emDashEmbeddedNotHelvetica`). Не менять местами. - docx4j 11.x теряет атрибуты `w:val="off"/"on"` при JAXB-разборе — поэтому нужна нормализация байтов до загрузки (регрессионный тест `ruPlain_regularRunsUseRegularFont`). +- Диаграммы: `docx2fo.xslt` умеет только `a:graphicData/pic:pic`, для `c:chart` и `dgm:relIds` там `notImplemented` (объект молча исчезает). Поэтому `DrawingPreRenderer.run(pkg)` (шаг 3.5 в `convertToStream`, после `setFontMapper` и до `FOSettings`) рендерит их своим Java2D-движком в PNG 300 dpi (`internal/chart/*`) и подменяет на `pic:pic`. Тест `chartsSmartArt_drawingsBecomeImages`, фикстура `samples/charts-smartart.docx`. +- В `DrawingPreRenderer` нужны собственные rels части — `part.getRelationshipsPart()` (`Base`), а **не** `getOwningRelationshipPart()`: у `document.xml` последнее указывает на пакетный `.rels`. Обход `pkg.getParts()` — только по снимку списка: `createImagePart` докидывает части в тот же реестр. +- SmartArt рисуется из `word/diagrams/drawing1.xml` (кэш разложенной Word-ом схемы: абсолютные позиции + `prstGeom`); текст-заполнители (`[Текст]`) лежат в `data1.xml` на `dgm:pt type="node"`, а формы ссылаются на `dgm:pt type="pres"` — связь через `dgm:cxn type="presOf"`. +- `surface3D` (`Surface3dPainter`): перспективная проекция (`c:view3D/perspective`, по умолчанию 30°, и `depth`), грани — ровно ячейки сетки по 2 треугольника без передискретизации, цвет из `c:bandFmts` затемняется по нормали грани (Lambert). Грани рисуются в модельно-экранных координатах уже умноженными на `scale/off` — забыть масштаб значит нарисовать поверхность в субпиксельный ноль. +- Знак `rotY` в DrawingML обратный правому правилу вокруг вертикали: в `Surface3dPainter.paint` он берётся как `-Math.toRadians(spec.rotY)`. Иначе передняя кромка категорий идёт вверх вправо, а ось рядов — вниз вправо (зеркально Word). +- `c:view3D/perspective` — НЕ угол обзора камеры. Расстояние камеры в `Surface3dPainter` = `CAMERA_DISTANCE * (30/perspective)`, где `CAMERA_DISTANCE = 2.36` (эффективный `fov ≈ 49°`, подобран фитом по эталону Word). При наивном `fov = perspective` перспектива слишком слабая: ось рядов уходит вправо вместо почти вертикального ухода в глубину, лента выглядит плоской, а левый край схлопывается в точку. +- Пропорции «коробки» surface3D (`DEPTH_RATIO = 0.705`, `HEIGHT_RATIO = 0.664`): глубина = 0.705 ширины (от неё `c:view3D/depth`), высота значений = `0.664 * availH/availW`, вписывание в область построения — равномерным масштабом. Раздельный масштаб x/y (или куб 1×1×1) даёт вертикальную гору вместо плоской ленты. +- Поля вокруг коробки — доли области построения `GUTTER_LEFT = GUTTER_RIGHT = 0.1485`, `GUTTER_TOP = 0.116`, `GUTTER_BOTTOM = 0.146`; `offX`/`offY` обязаны включать левое и верхнее поле (без `topGutter` поверхность сидела на 22 pt выше эталона). Коробка занимает ~70% ширины: при полях «на глаз» поверхность растягивалась на 82% и лезла на подписи оси значений. +- Калибровка камеры, коробки и полей зафиксирована тестами `Surface3dPainterTest.cameraMatchesWordReference` и `surfaceSilhouetteMatchesWordPlacement`. Эталон — стр. 3 `word-export.pdf` (экспорт Word), растеризованная `pdftoppm -r 300`; цели замеряются по **связному блоку граней** (серые грани в силуэт входят, по одной лишь насыщенности силуэт недомерен на 7%), пунктиру переднего ребра пола и подписям осей: уклон передней кромки 0,1282, аспект силуэта 0,207, шаг оси значений 0,0504, вертикальный шаг оси рядов 0,1176 (все — относительно ширины силуэта); сам силуэт 314,9×65,3 pt с центром в (227,3; 82,3). Замеры по скриншотам давали вдвое завышенную ось рядов и раздували глубину. +- Нормаль грани считается в той же метрике, что и проекция: `v` умножается на `depthScale`, `w` уже умножен на `hScale`. Без масштаба в нормали поверхность кажется положе и все грани уходят в светлую часть Lambert. +- Затенение граней surface3D — Lambert `0.92 + 0,88·dot` с клампом `[0,80; 1,25]` и боковым светом `LIGHT = (0,83, 0,48, 0,28)`. Дискретные множители эталона (гистограмма цветов граней, 300 dpi) — 0,40 / 0,75 / 0,85 / 1,04 / 1,06 / 1,10; группа 0,40 — узкая полоска underside под передним краем, и разгон Lambert до неё (отрицательные dot) по всем граням ухудшает совпадение с эталоном (17,2 → 17,6 средних расхождений на пиксель), поэтому нижний кламп 0,80. Направление света перебрано по 120 направлениям — текущее лучшее. Тест `shadingMatchesWordRange`. +- Триангуляция ячейки — диагональ с **большей суммой значений** (`z[r][c] + z[r+1][c+1] >= z[r+1][c] + z[r][c+1]` → `w00–w11`, иначе `w01–w10`), то есть верхняя огибающая седла. Фиксированная диагональ невозможна: у седловой ячейки одна вершина попадает внутрь треугольника остальных трёх, и при «не той» диагонали второй треугольник становится невидимой щепкой, а видимая грань окрашивается не той полосой. Проверено по эталону (стр. 3 `word-export.pdf`, 300 dpi, сравнение полос по пикселям; ячейка Ряд 1→2 / Категория 2→3): верхняя огибающая 92,3 % совпадений полос, фиксированная `w00–w11` — 81,6 %, фиксированная `w01–w10` — 57,9 %, окраска целого квада без разрезки — 74,1 %, билинейная tessellation 3×3/6×6 — 67,8 %/66,0 %. Регрессия — `Surface3dPainterTest.saddleCellUsesHigherDiagonal` (нижняя кромка силуэта в окне 0,42…0,55 его ширины обязана быть полосы 3–4). Клиппинг полос — по треугольникам, не по кваду. +- Пустой `c:title` при `c:autoTitleDeleted val="0"` даёт автозаголовок `Chart Title` (`ChartSpec.AUTO_TITLE`); для круговых (`pie`/`pie3D`/`doughnut`) вместо него — имя ряда. Тесты `ChartSpecTest`. +- В кваде ячейки `w01` обязан быть `z[r+1][c]`, а `w10` — `z[r][c+1]` (u=категория, v=ряд). Перестановка закручивает квад в «бабочку»: дыры и самопересечения граней. +- `ChartRenderer.axisBounds` для линейной оси значений без явного `c:min` всегда поднимает нижнюю границу до 0 (как Word); от этого зависит и легенда полос surface3D (`0-1 … 4-5`, а не `1-2 … 4-5`). Юнит-тесты — `Surface3dPainterTest`. - Не убирать shade-фильтры `META-INF/*.SF|*.DSA|*.RSA` — подписанные jar-файлы зависимостей ломают fat-jar. ## Точка входа diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java index 8dffaa5..10fdd19 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java @@ -9,6 +9,7 @@ import org.docx4j.convert.out.fo.renderers.FORendererApacheFOP; import org.docx4j.openpackaging.packages.WordprocessingMLPackage; import ru.pjandro.wordpdf.fonts.BundledFontMapper; import ru.pjandro.wordpdf.fonts.BundledFonts; +import ru.pjandro.wordpdf.internal.chart.DrawingPreRenderer; import ru.pjandro.wordpdf.internal.DocxOnOffNormalizer; import ru.pjandro.wordpdf.internal.FopFallbackFonts; @@ -103,6 +104,11 @@ public final class WordPdfConverter { // с физическими TTF (учитывая и шрифты, встроенные в docx) pkg.setFontMapper(mapper); + // 3.5 Диаграммы (c:chart) и SmartArt (dgm:relIds) -> PNG. + // docx2fo.xslt умеет только pic:pic; для chart/diagram там + // notImplemented, т.е. без этого шага они просто исчезают. + DrawingPreRenderer.run(pkg); + // 4. Настройки экспорта (FOP-конфиг с embed-шрифтами) FOSettings foSettings = new FOSettings(pkg); // FOP-конфиг знает только шрифты из fontsInUse, а символы diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFontMapper.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFontMapper.java index 719101a..effae85 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFontMapper.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFontMapper.java @@ -77,6 +77,18 @@ public class BundledFontMapper extends BestMatchingMapper { ALIASES = Map.copyOf(m); } + /** + * Бандл-семейство для имени шрифта из документа (таблица алиасов) + * или финальный fallback. Используется пре-рендером диаграмм + * (internal/chart), которому нужен тот же шрифт, что и у текста PDF. + */ + public static String bundledFamily(String docFontName) { + String family = ALIASES.get(docFontName.toLowerCase(Locale.ROOT)); + return family != null && BundledFonts.regular(family) != null + ? family + : FALLBACK_FAMILY; + } + /** * Вызывается docx4j при {@code package.setFontMapper(...)}: для каждого * имени шрифта, использованного в документе, нужно определить, каким diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java index 5c0ad2a..a07fb74 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java @@ -103,6 +103,9 @@ public final class BundledFonts { /** Ключ семейства (lowercase) -> начертание -> зарегистрированный PhysicalFont. */ private static final Map> VARIANTS = new HashMap<>(); + /** Ключ family/variant -> java.awt.Font (кэш, см. {@link #awtFont}). */ + private static final Map AWT_FONTS = new HashMap<>(); + /** Каталог, куда выгружены TTF (после init()). */ private static Path extractDir; private static boolean inited = false; @@ -222,4 +225,31 @@ public final class BundledFonts { public static PhysicalFont boldItalic(String family) { return font(family, V_BOLD_ITALIC); } + + /** + * Тот же TTF, но как {@link java.awt.Font} для Java2D (пре-рендер + * диаграмм и SmartArt в растр, см. internal/chart). Шрифт читается + * из выгруженного файла один раз и кешируется. + * + * @return базовый Font размера 1 (далее {@code deriveFont(size)}), + * или null, если шрифт не найден / {@link #init()} не вызван + */ + public static synchronized java.awt.Font awtFont(String family, String variant) { + String key = family + "/" + variant; + java.awt.Font cached = AWT_FONTS.get(key); + if (cached != null) { + return cached; + } + PhysicalFont pf = font(family, variant); + if (pf == null || pf.getEmbeddedURI() == null) { + return null; + } + try (InputStream in = Files.newInputStream(Path.of(pf.getEmbeddedURI()))) { + java.awt.Font f = java.awt.Font.createFont(java.awt.Font.TRUETYPE_FONT, in); + AWT_FONTS.put(key, f); + return f; + } catch (IOException | java.awt.FontFormatException e) { + return null; + } + } } diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/CartesianPainter.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/CartesianPainter.java new file mode 100644 index 0000000..def1714 --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/CartesianPainter.java @@ -0,0 +1,340 @@ +package ru.pjandro.wordpdf.internal.chart; + +import java.awt.BasicStroke; +import java.awt.Color; +import java.awt.Graphics2D; +import java.awt.geom.Path2D; +import java.awt.geom.Rectangle2D; +import java.util.ArrayList; +import java.util.List; + +/** + * Декартовы графики Word: линии, области, столбцы (и горизонтальные + * столбцы). Остальные типы (разбросанный, пузырьковый, лепестковый) + * здесь не рисуются — вызывающий их пропускает. + */ +final class CartesianPainter { + + private CartesianPainter() { + } + + static void paint(Graphics2D g, ChartSpec spec, Rectangle2D box, List palette) { + boolean horizontal = spec.type == ChartSpec.Type.BAR_HORIZONTAL; + ChartSpec.AxisSpec valAxis = spec.valAxis != null ? spec.valAxis : new ChartSpec.AxisSpec(); + ChartSpec.AxisSpec catAxis = spec.catAxis != null ? spec.catAxis : new ChartSpec.AxisSpec(); + + int nCat = 0; + for (ChartSpec.Series s : spec.series) { + nCat = Math.max(nCat, s.values.size()); + } + if (nCat == 0) { + return; + } + List cats = categoriesOf(spec, nCat); + + double[] range = ChartRenderer.valueRange(spec); + double[] bounds = ChartRenderer.axisBounds(valAxis, range[0], range[1], true); + double lo = bounds[0]; + double hi = bounds[1]; + double unit = bounds[2]; + + DrawMlText.Style valStyle = valAxis.labelStyle; + DrawMlText.Style catStyle = catAxis.labelStyle; + + // 1. Поля под подписи осей + double catGutter = 0; + for (String c : cats) { + catGutter = Math.max(catGutter, DrawMlText.textHeight(catStyle, g.getFontRenderContext())); + } + catGutter += 6; + + // Word укрупняет шаг оси значений, если подписи не влезают: интервал + // между делениями не меньше ~2,5 высоты строки подписи. В word-export.pdf + // у line chart (область ~71 pt, подписи 9 pt) шаг вышел 2 (0…6), + // а не 1 (0…5). Явные c:majorUnit/c:max не трогаем. + if (valStyle != null && !valAxis.deleted + && valAxis.majorUnit == null && valAxis.max == null) { + double labelH = DrawMlText.textHeight(valStyle, g.getFontRenderContext()); + double axisLen = Math.max(10, + (horizontal ? box.getWidth() : box.getHeight()) - catGutter); + while (hi - lo > unit && axisLen / ((hi - lo) / unit) < 2.5 * labelH) { + unit = ChartRenderer.nextUnit(unit); + double top = range[1] + (range[1] - range[0]) / 20.0; + hi = Math.max(lo + unit, Math.ceil(top / unit - 1e-9) * unit); + } + } + + List valLabels = new ArrayList<>(); + for (double v = lo; v <= hi + unit / 2; v += unit) { + valLabels.add(ChartRenderer.formatValue(v, valAxis.numFmt)); + } + double valGutter = 0; + for (String l : valLabels) { + valGutter = Math.max(valGutter, DrawMlText.textWidth(l, valStyle, g.getFontRenderContext())); + } + valGutter += 8; + + Rectangle2D plot = horizontal + ? new Rectangle2D.Double(box.getX() + valGutter, box.getY() + catGutter, + Math.max(10, box.getWidth() - valGutter), + Math.max(10, box.getHeight() - catGutter)) + : new Rectangle2D.Double(box.getX() + valGutter, box.getY(), + Math.max(10, box.getWidth() - valGutter), + Math.max(10, box.getHeight() - catGutter)); + + // 2. Сетка по делениям оси значений + if (valAxis.gridlines && !valAxis.deleted) { + g.setColor(valAxis.gridColor); + g.setStroke(new BasicStroke(0.6f)); + int i = 0; + for (double v = lo; v <= hi + unit / 2; v += unit, i++) { + double t = (v - lo) / (hi - lo); + if (horizontal) { + double x = plot.getX() + t * plot.getWidth(); + g.draw(new java.awt.geom.Line2D.Double(x, plot.getY(), + x, plot.getY() + plot.getHeight())); + } else { + double y = plot.getY() + (1 - t) * plot.getHeight(); + g.draw(new java.awt.geom.Line2D.Double(plot.getX(), y, + plot.getX() + plot.getWidth(), y)); + } + } + } + + // 3. Ряды + switch (spec.type) { + case LINE -> drawLines(g, spec, plot, palette, lo, hi, nCat, horizontal); + case AREA -> drawAreas(g, spec, plot, palette, lo, hi, nCat, horizontal); + case BAR, BAR_HORIZONTAL -> drawBars(g, spec, plot, palette, lo, hi, nCat, horizontal); + default -> { + } + } + + // 4. Линия категории и подписи + if (catAxis.axisLineColor != null && !catAxis.deleted) { + g.setColor(catAxis.axisLineColor); + g.setStroke(new BasicStroke((float) Math.max(0.5, catAxis.axisLineWidth))); + if (horizontal) { + g.draw(new java.awt.geom.Line2D.Double(plot.getX(), plot.getY(), + plot.getX(), plot.getY() + plot.getHeight())); + } else { + double y = plot.getY() + plot.getHeight(); + g.draw(new java.awt.geom.Line2D.Double(plot.getX(), y, + plot.getX() + plot.getWidth(), y)); + } + } + drawCategoryLabels(g, cats, plot, catStyle, horizontal); + drawValueLabels(g, valLabels, plot, valStyle, lo, hi, horizontal); + } + + private static List categoriesOf(ChartSpec spec, int nCat) { + List cats = new ArrayList<>(); + for (int i = 0; i < nCat; i++) { + String label = null; + if (i < spec.categories.size()) { + label = spec.categories.get(i); + } + for (ChartSpec.Series s : spec.series) { + if (label == null && i < s.categories.size()) { + label = s.categories.get(i); + } + } + cats.add(label == null ? "" : label); + } + return cats; + } + + private static void drawCategoryLabels(Graphics2D g, List cats, Rectangle2D plot, + DrawMlText.Style style, boolean horizontal) { + if (style == null || cats.isEmpty()) { + return; + } + double n = cats.size(); + double h = DrawMlText.textHeight(style, g.getFontRenderContext()) + 2; + for (int i = 0; i < n; i++) { + String label = cats.get(i); + if (label.isEmpty()) { + continue; + } + if (horizontal) { + double cy = plot.getY() + plot.getHeight() * (i + 0.5) / n; + DrawMlText.paint(g, List.of(new DrawMlText.Paragraph(label, style, "ctr")), + new Rectangle2D.Double(plot.getX() - 60, cy - h / 2, 56, h), + "r", "ctr", 1.0); + } else { + double cx = plot.getX() + plot.getWidth() * (i + 0.5) / n; + double w = DrawMlText.textWidth(label, style, g.getFontRenderContext()); + double slot = plot.getWidth() / n; + // Word прячет подписи, которые не помещаются в слот + 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, + boolean horizontal) { + if (style == null) { + return; + } + double h = DrawMlText.textHeight(style, g.getFontRenderContext()) + 2; + double span = hi - lo; + for (int i = 0; i < labels.size(); i++) { + double t = span == 0 ? 0 : i / (double) (labels.size() - 1); + double w = DrawMlText.textWidth(labels.get(i), style, g.getFontRenderContext()); + if (horizontal) { + double x = plot.getX() + t * plot.getWidth(); + DrawMlText.paint(g, List.of(new DrawMlText.Paragraph(labels.get(i), style, "ctr")), + new Rectangle2D.Double(x - w / 2, plot.getY() - h - 3, w, h), + "ctr", "t", 1.0); + } else { + double y = plot.getY() + plot.getHeight() * (1 - t); + DrawMlText.paint(g, List.of(new DrawMlText.Paragraph(labels.get(i), style, "r")), + new Rectangle2D.Double(plot.getX() - w - 6, y - h / 2, w, h), + "r", "ctr", 1.0); + } + } + } + + private static double valuePos(double v, double lo, double hi, Rectangle2D plot, + boolean horizontal) { + double t = (v - lo) / (hi - lo); + return horizontal + ? plot.getX() + t * plot.getWidth() + : plot.getY() + (1 - t) * plot.getHeight(); + } + + private static double catPos(int i, int n, Rectangle2D plot, boolean horizontal) { + double t = (i + 0.5) / n; + return horizontal + ? plot.getY() + t * plot.getHeight() + : plot.getX() + t * plot.getWidth(); + } + + private static void drawLines(Graphics2D g, ChartSpec spec, Rectangle2D plot, + List palette, double lo, double hi, int nCat, + boolean horizontal) { + for (int si = 0; si < spec.series.size(); si++) { + ChartSpec.Series s = spec.series.get(si); + Color c = s.lineColor != null ? s.lineColor : s.fillAt(si, palette); + double width = s.lineWidth > 0 ? s.lineWidth : 2.25; + g.setColor(c); + g.setStroke(new BasicStroke((float) width, BasicStroke.CAP_ROUND, + BasicStroke.JOIN_ROUND)); + List along = new ArrayList<>(); + List cross = new ArrayList<>(); + for (int i = 0; i < s.values.size(); i++) { + Double v = s.values.get(i); + if (v == null) { + continue; + } + along.add(catPos(i, nCat, plot, horizontal)); + cross.add(valuePos(v, lo, hi, plot, horizontal)); + } + if (along.size() > 1) { + g.draw(ChartRenderer.polyline(along, cross, false)); + } + if (s.marker) { + g.setColor(c); + for (int i = 0; i < along.size(); i++) { + double a = along.get(i); + double b = cross.get(i); + double r = 2.2; + if (horizontal) { + g.fill(new Rectangle2D.Double(a - r, b - r, 2 * r, 2 * r)); + } else { + g.fill(new java.awt.geom.Ellipse2D.Double(a - r, b - r, 2 * r, 2 * r)); + } + } + } + } + } + + private static void drawAreas(Graphics2D g, ChartSpec spec, Rectangle2D plot, + List palette, double lo, double hi, int nCat, + boolean horizontal) { + double baseline = horizontal ? plot.getX() : plot.getY() + plot.getHeight(); + for (int si = 0; si < spec.series.size(); si++) { + ChartSpec.Series s = spec.series.get(si); + Color c = s.fill != null ? s.fill : s.fillAt(si, palette); + List along = new ArrayList<>(); + List cross = new ArrayList<>(); + for (int i = 0; i < s.values.size(); i++) { + Double v = s.values.get(i); + if (v == null) { + continue; + } + along.add(catPos(i, nCat, plot, horizontal)); + cross.add(valuePos(v, lo, hi, plot, horizontal)); + } + if (along.size() < 2) { + continue; + } + Path2D p = new Path2D.Double(); + p.moveTo(toX(along.get(0), cross.get(0), baseline, horizontal), + toY(along.get(0), cross.get(0), baseline, horizontal)); + for (int i = 0; i < along.size(); i++) { + p.lineTo(toX(along.get(i), cross.get(i), baseline, horizontal), + toY(along.get(i), cross.get(i), baseline, horizontal)); + } + p.lineTo(toX(along.get(along.size() - 1), cross.get(cross.size() - 1), + baseline, horizontal), + toY(along.get(along.size() - 1), cross.get(cross.size() - 1), + baseline, horizontal)); + p.lineTo(toX(along.get(0), cross.get(0), baseline, horizontal), + toY(along.get(0), cross.get(0), baseline, horizontal)); + p.closePath(); + g.setColor(DrawMlColor.withAlpha(c, 0.55)); + g.fill(p); + g.setColor(c); + g.setStroke(new BasicStroke(1.2f)); + g.draw(p); + } + } + + /** (вдоль категории, вдоль значения) -> экранные координаты. */ + private static double toX(double along, double cross, double baseline, boolean horizontal) { + return horizontal ? cross : along; + } + + private static double toY(double along, double cross, double baseline, boolean horizontal) { + return horizontal ? along : cross; + } + + private static void drawBars(Graphics2D g, ChartSpec spec, Rectangle2D plot, + List palette, double lo, double hi, int nCat, + boolean horizontal) { + int nSer = spec.series.size(); + double slot = (horizontal ? plot.getHeight() : plot.getWidth()) / nCat; + double group = slot * 0.82; + double bar = group / Math.max(1, nSer); + double zero = valuePos(0, lo, hi, plot, horizontal); + for (int si = 0; si < nSer; si++) { + ChartSpec.Series s = spec.series.get(si); + for (int i = 0; i < s.values.size(); i++) { + Double v = s.values.get(i); + if (v == null) { + continue; + } + Color c = s.fillAt(i, palette); + g.setColor(c); + double center = catPos(i, nCat, plot, horizontal); + double start = center - group / 2 + si * bar; + double end = valuePos(v, lo, hi, plot, horizontal); + if (horizontal) { + g.fill(new Rectangle2D.Double(Math.min(zero, end), start, + Math.abs(end - zero), bar * 0.92)); + } else { + g.fill(new Rectangle2D.Double(start, Math.min(zero, end), + bar * 0.92, Math.abs(end - zero))); + } + } + } + } +} 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 new file mode 100644 index 0000000..c8d8cb5 --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartRenderer.java @@ -0,0 +1,379 @@ +package ru.pjandro.wordpdf.internal.chart; + +import ru.pjandro.wordpdf.internal.chart.DrawMlText.Paragraph; +import ru.pjandro.wordpdf.internal.chart.DrawMlText.Style; + +import java.awt.BasicStroke; +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.awt.geom.RoundRectangle2D; +import java.awt.image.BufferedImage; +import java.util.ArrayList; +import java.util.List; + +/** + * Рендер графика DrawingML в растр. Кадрирование (рамка chartSpace), + * заголовок и легенда общие; область построения рисует специфичный + * художник: {@link PiePainter}, {@link CartesianPainter} или + * {@link Surface3dPainter}. + * + * Все размеры внутри — в пунктах (pt), как в Word; растр создаётся с + * множителем {@link #DPI}. + */ +final class ChartRenderer { + + /** Разрешение растра: 300 dpi, чтобы подписи не мылились при печати. */ + static final int DPI = 300; + + private static final double PADDING = 4.0; + + private ChartRenderer() { + } + + static BufferedImage render(ChartSpec spec, double widthPt, double heightPt, + DrawMlColor colors) { + int w = Math.max(16, (int) Math.round(widthPt * DPI / 72.0)); + int h = Math.max(16, (int) Math.round(heightPt * DPI / 72.0)); + BufferedImage img = new BufferedImage(w, h, BufferedImage.TYPE_INT_ARGB); + Graphics2D g = img.createGraphics(); + try { + g.setRenderingHint(RenderingHints.KEY_ANTIALIASING, + RenderingHints.VALUE_ANTIALIAS_ON); + g.setRenderingHint(RenderingHints.KEY_TEXT_ANTIALIASING, + RenderingHints.VALUE_TEXT_ANTIALIAS_ON); + g.setRenderingHint(RenderingHints.KEY_STROKE_CONTROL, + RenderingHints.VALUE_STROKE_PURE); + g.scale(DPI / 72.0, DPI / 72.0); + drawFrame(g, spec, widthPt, heightPt); + + Rectangle2D box = new Rectangle2D.Double(PADDING, PADDING, + widthPt - 2 * PADDING, heightPt - 2 * PADDING); + List palette = ChartSpec.palette(colors); + + double titleH = drawTitle(g, spec, box); + box = new Rectangle2D.Double(box.getX(), box.getY() + titleH, + box.getWidth(), box.getHeight() - titleH); + + Legend legend = measureLegend(g, spec, palette); + double legendH = legend == null ? 0 : legend.height; + if (legend != null && "b".equals(spec.legendPos)) { + legend.draw(g, box.getX(), box.getY() + box.getHeight() - legendH, + box.getWidth()); + box = new Rectangle2D.Double(box.getX(), box.getY(), + box.getWidth(), box.getHeight() - legendH); + } else if (legend != null && "t".equals(spec.legendPos)) { + legend.draw(g, box.getX(), box.getY(), box.getWidth()); + box = new Rectangle2D.Double(box.getX(), box.getY() + legendH, + box.getWidth(), box.getHeight() - legendH); + } + + switch (spec.type) { + case PIE, PIE3D, DOUGHNUT -> + PiePainter.paint(g, spec, box, palette, legend); + case LINE, AREA, BAR, BAR_HORIZONTAL -> + CartesianPainter.paint(g, spec, box, palette); + case SURFACE3D -> + Surface3dPainter.paint(g, spec, box, palette); + default -> { /* UNSUPPORTED: вызывающий не должен сюда доходить */ } + } + } finally { + g.dispose(); + } + return img; + } + + /** a:spPr chartSpace: заливка и тонкая скруглённая рамка. */ + private static void drawFrame(Graphics2D g, ChartSpec spec, double w, double h) { + if (spec.chartFill != null) { + g.setColor(spec.chartFill); + g.fill(new RoundRectangle2D.Double(0, 0, w, h, 3, 3)); + } + if (spec.chartBorder != null) { + g.setColor(spec.chartBorder); + g.setStroke(new BasicStroke((float) Math.max(0.5, spec.chartBorderWidth))); + g.draw(new RoundRectangle2D.Double(0.25, 0.25, w - 0.5, h - 0.5, 3, 3)); + } + } + + /** Заголовок сверху; возвращает занятую высоту. */ + private static double drawTitle(Graphics2D g, ChartSpec spec, Rectangle2D box) { + if (spec.title == null || spec.titleStyle == null) { + return 0; + } + double lineH = DrawMlText.textHeight(spec.titleStyle, g.getFontRenderContext()); + double width = DrawMlText.textWidth(spec.title, spec.titleStyle, g.getFontRenderContext()); + double height = lineH + 4; + if (width > box.getWidth()) { + DrawMlText.paint(g, List.of(new Paragraph(spec.title, spec.titleStyle, "ctr")), + new Rectangle2D.Double(box.getX(), box.getY(), box.getWidth(), height * 2), + "ctr", "t", 1.0); + return height * 2; + } + DrawMlText.paint(g, List.of(new Paragraph(spec.title, spec.titleStyle, "ctr")), + new Rectangle2D.Double(box.getX(), box.getY(), box.getWidth(), height), + "ctr", "ctr", 1.0); + return height; + } + + /** Легенда: метки + квадратики цветов, одна строка по центру. */ + static final class Legend { + /** lineWidth > 0 — маркер-отрезок (линейный ряд), иначе — квадратик. + * В Word у линейных рядов в легенде короткая линия той же толщины, + * что и сама линия; у круговых — маленький квадратик. */ + record Entry(String label, Color color, double lineWidth) { + Entry(String label, Color color) { + this(label, color, -1); + } + } + + final List entries = new ArrayList<>(); + Style style; + double height; + double totalWidth; + double square; + double lineLen; + + void draw(Graphics2D g, double x, double y, double boxWidth) { + double startX = x + (boxWidth - totalWidth) / 2.0; + double midY = y + height / 2.0; + for (Entry e : entries) { + g.setColor(e.color()); + if (e.lineWidth() > 0) { + g.setStroke(new BasicStroke((float) e.lineWidth(), + BasicStroke.CAP_BUTT, BasicStroke.JOIN_MITER)); + g.draw(new Line2D.Double(startX, midY, startX + lineLen, midY)); + startX += lineLen + 3; + } else { + g.fill(new Rectangle2D.Double(startX, midY - square / 2.0, square, square)); + startX += square + 3; + } + double tw = DrawMlText.textWidth(e.label(), style, g.getFontRenderContext()); + DrawMlText.paint(g, List.of(new Paragraph(e.label(), style, "l")), + new Rectangle2D.Double(startX, y, tw, height), "l", "ctr", 1.0); + startX += tw + 8; + } + } + } + + private static Legend measureLegend(Graphics2D g, ChartSpec spec, List palette) { + if (spec.legendPos == null) { + return null; + } + Style style = spec.legendStyle != null ? spec.legendStyle + : new Style(9, false, false, new Color(0x59, 0x59, 0x59), "carlito"); + Legend legend = new Legend(); + legend.style = style; + switch (spec.type) { + case PIE, PIE3D, DOUGHNUT -> { + ChartSpec.Series s = spec.series.isEmpty() ? null : spec.series.get(0); + if (s == null) { + return null; + } + for (int i = 0; i < s.values.size(); i++) { + String label = i < s.categories.size() ? s.categories.get(i) : ""; + legend.entries.add(new Legend.Entry(label, s.fillAt(i, palette))); + } + } + case SURFACE3D -> { + List vals = spec.series.isEmpty() + ? List.of() : spec.series.get(0).values; + double min = Double.MAX_VALUE; + double max = -Double.MAX_VALUE; + for (ChartSpec.Series s : spec.series) { + for (Double v : s.values) { + if (v != null) { + min = Math.min(min, v); + max = Math.max(max, v); + } + } + } + if (min > max) { + return null; + } + double[] bounds = axisBounds(spec.valAxis, min, max); + double unit = bounds[2]; + double lo = bounds[0]; + double hi = bounds[1]; + int idx = 0; + for (double b = lo; b < hi - 1e-9; b += unit) { + Color c = spec.bandColors.isEmpty() + ? 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)); + idx++; + } + } + default -> { + for (int i = 0; i < spec.series.size(); i++) { + ChartSpec.Series s = spec.series.get(i); + Color c = s.lineColor != null ? s.lineColor + : s.fillAt(0, palette); + boolean lineLike = spec.type == ChartSpec.Type.LINE; + legend.entries.add(new Legend.Entry(s.name == null ? "" : s.name, c, + lineLike ? Math.max(1.0, s.lineWidth > 0 ? s.lineWidth : 2.25) : -1)); + } + } + } + if (legend.entries.isEmpty()) { + return null; + } + // Размер маркера легенды в Word зависит от типа: у круговой диаграммы + // квадратик ~0,3 кегля (замер по word-export.pdf — 12 px при 9 pt и 300 dpi), + // у прочих ~0,55 кегля (21 px), у линейных рядов — отрезок ~2,4 кегля + // (89 px) толщиной с линию ряда. + boolean pie = spec.type == ChartSpec.Type.PIE || spec.type == ChartSpec.Type.PIE3D + || spec.type == ChartSpec.Type.DOUGHNUT; + legend.square = style.sizePt() * (pie ? 0.32 : 0.55); + legend.lineLen = style.sizePt() * 2.4; + double width = 0; + for (Legend.Entry e : legend.entries) { + double marker = e.lineWidth() > 0 ? legend.lineLen : legend.square; + width += marker + 3 + DrawMlText.textWidth(e.label(), style, g.getFontRenderContext()) + 8; + } + legend.totalWidth = width; + legend.height = Math.max(Math.max(legend.square, legend.lineLen * 0.2), + DrawMlText.textHeight(style, g.getFontRenderContext())) + 4; + return legend; + } + + // ------------------------------------------------------------------ + // Общие вычисления осей + // ------------------------------------------------------------------ + + /** Диапазон всех значений всех рядов. */ + static double[] valueRange(ChartSpec spec) { + double min = Double.MAX_VALUE; + double max = -Double.MAX_VALUE; + for (ChartSpec.Series s : spec.series) { + for (Double v : s.values) { + if (v != null) { + min = Math.min(min, v); + max = Math.max(max, v); + } + } + } + if (min > max) { + return new double[]{0, 1}; + } + if (min > 0) { + min = 0; + } + if (max < 0) { + max = 0; + } + if (min == max) { + max = min + 1; + } + return new double[]{min, max}; + } + + /** + * «Круглый» шаг делений (1/2/5 * 10^n), как подбирает Word. + */ + static double niceUnit(double raw) { + if (raw <= 0 || !Double.isFinite(raw)) { + return 1; + } + double exp = Math.floor(Math.log10(raw)); + double base = Math.pow(10, exp); + double frac = raw / base; + if (frac <= 1) { + return base; + } + if (frac <= 2) { + return 2 * base; + } + if (frac <= 5) { + return 5 * base; + } + return 10 * base; + } + + /** Следующий «круглый» шаг после unit: 1→2→5→10… (в тех же 10^n). */ + static double nextUnit(double unit) { + double exp = Math.floor(Math.log10(unit) + 1e-9); + double base = Math.pow(10, exp); + double frac = unit / base; + if (frac < 2 - 1e-9) { + return 2 * base; + } + if (frac < 5 - 1e-9) { + return 5 * base; + } + return 10 * base; + } + + /** Границы оси + шаг: min/max округляются до кратных unit. */ + static double[] axisBounds(ChartSpec.AxisSpec axis, double dataMin, double dataMax) { + return axisBounds(axis, dataMin, dataMax, false); + } + + /** + * @param padMax для декартовых осей Word поднимает верхнюю границу за + * максимум данных: «первое деление выше Ymax + (Ymax − Ymin)/20» + * (KB101939). Без этого линия упёрта в верхнюю границу области + * построения, а в Word она занимает 5/6 высоты. + * Для surface3D отступ не нужен: там ось задаётся полосами + * (c:bandFmts — ровно 5 полос до максимума данных). + */ + static double[] axisBounds(ChartSpec.AxisSpec axis, double dataMin, double dataMax, + boolean padMax) { + double unit = axis != null && axis.majorUnit != null + ? axis.majorUnit + : niceUnit((dataMax - dataMin) / 5.0); + // Линейная ось значений без явного c:min всегда начинается с нуля + // (так делает Word) — иначе surface3D теряет нижнюю полосу и легенда + // съезжает с «0-1 … 4-5» на «1-2 … 4-5». + double lo = axis != null && axis.min != null ? axis.min + : (dataMin >= 0 ? 0 : Math.floor(dataMin / unit) * unit); + double hi; + if (axis != null && axis.max != null) { + hi = axis.max; + } else { + double top = padMax ? dataMax + (dataMax - dataMin) / 20.0 : dataMax; + hi = Math.max(lo + unit, Math.ceil(top / unit - 1e-9) * unit); + } + if (hi <= lo) { + hi = lo + unit; + } + return new double[]{lo, hi, unit}; + } + + /** Формат числа для подписей оси ("General" -> без лишних нулей). */ + static String formatValue(double v, String fmt) { + if (fmt != null && !fmt.equalsIgnoreCase("General")) { + if (fmt.contains("0.00")) { + return String.format(java.util.Locale.ROOT, "%.2f", v); + } + if (fmt.contains("0.0")) { + return String.format(java.util.Locale.ROOT, "%.1f", v); + } + } + if (Math.abs(v - Math.rint(v)) < 1e-9) { + return String.valueOf((long) Math.rint(v)); + } + String s = String.format(java.util.Locale.ROOT, "%.2f", v); + return s.replaceAll("0+$", "").replaceAll("\\.$", ""); + } + + /** Контур многоугольника по точкам. */ + static Path2D polyline(List xs, List ys, boolean close) { + Path2D p = new Path2D.Double(); + for (int i = 0; i < xs.size(); i++) { + if (i == 0) { + p.moveTo(xs.get(i), ys.get(i)); + } else { + p.lineTo(xs.get(i), ys.get(i)); + } + } + if (close) { + p.closePath(); + } + return p; + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartSpec.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartSpec.java new file mode 100644 index 0000000..96dd874 --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartSpec.java @@ -0,0 +1,594 @@ +package ru.pjandro.wordpdf.internal.chart; + +import org.docx4j.dml.CTShapeProperties; +import org.docx4j.dml.CTTextBody; +import org.docx4j.dml.chart.CTAxDataSource; +import org.docx4j.dml.chart.CTAxPos; +import org.docx4j.dml.chart.CTBoolean; +import org.docx4j.dml.chart.CTBandFmt; +import org.docx4j.dml.chart.CTBandFmts; +import org.docx4j.dml.chart.CTBarChart; +import org.docx4j.dml.chart.CTBarSer; +import org.docx4j.dml.chart.CTCatAx; +import org.docx4j.dml.chart.CTChart; +import org.docx4j.dml.chart.CTChartLines; +import org.docx4j.dml.chart.CTChartSpace; +import org.docx4j.dml.chart.CTDateAx; +import org.docx4j.dml.chart.CTDPt; +import org.docx4j.dml.chart.CTDoughnutChart; +import org.docx4j.dml.chart.CTLineChart; +import org.docx4j.dml.chart.CTLineSer; +import org.docx4j.dml.chart.CTMarker; +import org.docx4j.dml.chart.STMarkerStyle; +import org.docx4j.dml.chart.CTNumDataSource; +import org.docx4j.dml.chart.CTNumVal; +import org.docx4j.dml.chart.CTPlotArea; +import org.docx4j.dml.chart.CTSerAx; +import org.docx4j.dml.chart.CTSerTx; +import org.docx4j.dml.chart.CTSurface3DChart; +import org.docx4j.dml.chart.CTSurfaceSer; +import org.docx4j.dml.chart.CTScaling; +import org.docx4j.dml.chart.CTPie3DChart; +import org.docx4j.dml.chart.CTPieChart; +import org.docx4j.dml.chart.CTPieSer; +import org.docx4j.dml.chart.CTStrVal; +import org.docx4j.dml.chart.CTTitle; +import org.docx4j.dml.chart.CTTx; +import org.docx4j.dml.chart.CTValAx; +import org.docx4j.dml.chart.CTView3D; + +import java.awt.Color; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +/** + * Модель графика DrawingML (c:chartSpace), сокращённая до того, что + * действительно нужно для растрового рендера: тип, ряды, категории, + * оси, легенда, заголовок, параметры 3D и цвета полос surface. + * + * Данные берутся из кэшей ({@code c:numCache}/{@code c:strCache}): + * внешний xlsx (c:externalData) не читается — Word всегда кладёт + * кэш значений в xml графика. + */ +final class ChartSpec { + + /** Встроенный заголовок Word для графика с пустым c:title. */ + static final String AUTO_TITLE = "Chart Title"; + + enum Type { + PIE, PIE3D, DOUGHNUT, BAR, BAR_HORIZONTAL, LINE, AREA, SURFACE3D, UNSUPPORTED + } + + /** Один ряд: значения + стили (ряд и переопределения по точкам). */ + static final class Series { + String name; + final List values = new ArrayList<>(); + final List categories = new ArrayList<>(); + Color fill; + final Map pointFills = new HashMap<>(); + Color lineColor; + double lineWidth = -1; + boolean lineNoFill; + boolean outlineNoFill; + Color outlineColor; + double outlineWidth = -1; + boolean marker = true; + String markerSymbol; + + Color fillAt(int i, List palette) { + Color c = pointFills.get(i); + if (c != null) { + return c; + } + return fill != null ? fill : palette.get(i % palette.size()); + } + } + + /** Одна ось: границы, деления, сетка, стиль подписей. */ + static final class AxisSpec { + boolean deleted; + String pos = "b"; + Double min; + Double max; + Double majorUnit; + boolean gridlines; + Color gridColor = new Color(0xD9, 0xD9, 0xD9); + Color axisLineColor = new Color(0xBF, 0xBF, 0xBF); + double axisLineWidth = 0.75; + DrawMlText.Style labelStyle; + String numFmt = "General"; + } + + Type type = Type.UNSUPPORTED; + String title; + DrawMlText.Style titleStyle; + DrawMlText.Style legendStyle; + String legendPos = "b"; + final List series = new ArrayList<>(); + final List categories = new ArrayList<>(); + AxisSpec valAxis; + AxisSpec catAxis; + AxisSpec serAxis; + double rotX = 30; + double rotY = 0; + double depthPercent = 100; + double perspective = 30; + boolean rightAngledAxes = true; + final List bandColors = new ArrayList<>(); + boolean wireframe; + Color chartFill = Color.WHITE; + Color chartBorder = new Color(0xBF, 0xBF, 0xBF); + double chartBorderWidth = 0.75; + + /** package-private: тестам нужен пустой spec без CTChartSpace. */ + ChartSpec() { + } + + /** Цвета акцента темы — базовая палитра рядов (как в Word). */ + static List palette(DrawMlColor colors) { + List p = new ArrayList<>(); + for (String name : new String[]{"accent1", "accent2", "accent3", + "accent4", "accent5", "accent6"}) { + p.add(colors.schemeColor(name)); + } + return p; + } + + /** Разбор c:chartSpace. */ + static ChartSpec parse(CTChartSpace space, DrawMlColor colors) { + ChartSpec spec = new ChartSpec(); + CTChart chart = space.getChart(); + if (chart == null) { + return spec; + } + List palette = palette(colors); + + readChartFrame(space, spec, colors); + readView3D(chart, spec); + + CTPlotArea pa = chart.getPlotArea(); + if (pa != null) { + for (Object group : pa.getAreaChartOrArea3DChartOrLineChart()) { + readGroup(group, spec, colors, palette); + } + for (Object ax : pa.getValAxOrCatAxOrDateAx()) { + AxisSpec a = readAxis(ax, colors); + if (ax instanceof CTValAx) { + spec.valAxis = a; + } else if (ax instanceof CTCatAx) { + spec.catAxis = a; + } else if (ax instanceof CTSerAx) { + spec.serAxis = a; + } else if (ax instanceof CTDateAx && spec.catAxis == null) { + spec.catAxis = a; + } + } + } + readLegend(chart, spec, colors); + readTitle(chart, spec, colors); + if (spec.categories.isEmpty() && !spec.series.isEmpty()) { + spec.categories.addAll(spec.series.get(0).categories); + } + return spec; + } + + private static void readChartFrame(CTChartSpace space, ChartSpec spec, DrawMlColor colors) { + CTShapeProperties sp = space.getSpPr(); + if (sp == null) { + return; + } + if (sp.getSolidFill() != null) { + Color c = colors.resolveFill(sp.getSolidFill()); + if (c != null) { + spec.chartFill = c; + } + } + if (sp.getLn() != null) { + if (sp.getLn().getNoFill() != null) { + spec.chartBorder = null; + } else if (sp.getLn().getSolidFill() != null) { + Color c = colors.resolveFill(sp.getLn().getSolidFill()); + if (c != null) { + spec.chartBorder = c; + } + } + if (sp.getLn().getW() != null) { + spec.chartBorderWidth = emuToPt(sp.getLn().getW()); + } + } + } + + private static void readView3D(CTChart chart, ChartSpec spec) { + CTView3D v = chart.getView3D(); + if (v == null) { + return; + } + if (v.getRotX() != null) { + spec.rotX = v.getRotX().getVal(); + } + if (v.getRotY() != null) { + int ry = v.getRotY().getVal(); + spec.rotY = ry < 0 ? ry + 360 : ry; + } + if (v.getDepthPercent() != null) { + spec.depthPercent = v.getDepthPercent().getVal(); + } + if (v.getPerspective() != null) { + spec.perspective = v.getPerspective().getVal(); + } + if (v.getRAngAx() != null) { + spec.rightAngledAxes = isTrue(v.getRAngAx()); + } + } + + private static void readGroup(Object group, ChartSpec spec, DrawMlColor colors, + List palette) { + if (group instanceof CTPie3DChart g) { + spec.type = Type.PIE3D; + for (CTPieSer s : g.getSer()) { + spec.series.add(readPieSer(s, colors, palette)); + } + } else if (group instanceof CTPieChart g) { + spec.type = Type.PIE; + for (CTPieSer s : g.getSer()) { + spec.series.add(readPieSer(s, colors, palette)); + } + } else if (group instanceof CTDoughnutChart g) { + spec.type = Type.DOUGHNUT; + for (CTPieSer s : g.getSer()) { + spec.series.add(readPieSer(s, colors, palette)); + } + } else if (group instanceof CTLineChart g) { + spec.type = Type.LINE; + for (CTLineSer s : g.getSer()) { + Series ser = new Series(); + readCommon(s.getTx(), s.getCat(), s.getVal(), s.getDPt(), ser, colors, palette); + readLineProps(s.getSpPr(), ser, colors, palette, + spec.series.size()); + CTMarker m = s.getMarker(); + if (m != null) { + ser.marker = m.getSymbol() == null + || m.getSymbol().getVal() != STMarkerStyle.NONE; + if (m.getSymbol() != null) { + ser.markerSymbol = m.getSymbol().getVal().value(); + } + } + spec.series.add(ser); + } + } else if (group instanceof CTBarChart g) { + boolean horizontal = g.getBarDir() != null + && g.getBarDir().getVal() != null + && g.getBarDir().getVal().value().equalsIgnoreCase("bar"); + spec.type = horizontal ? Type.BAR_HORIZONTAL : Type.BAR; + for (CTBarSer s : g.getSer()) { + Series ser = new Series(); + readCommon(s.getTx(), s.getCat(), s.getVal(), s.getDPt(), ser, colors, palette); + if (s.getSpPr() != null && s.getSpPr().getSolidFill() != null) { + ser.fill = colors.resolveFill(s.getSpPr().getSolidFill()); + } + spec.series.add(ser); + } + } else if (group instanceof org.docx4j.dml.chart.CTAreaChart g) { + spec.type = Type.AREA; + for (org.docx4j.dml.chart.CTAreaSer s : g.getSer()) { + Series ser = new Series(); + readCommon(s.getTx(), s.getCat(), s.getVal(), s.getDPt(), ser, colors, palette); + if (s.getSpPr() != null && s.getSpPr().getSolidFill() != null) { + ser.fill = colors.resolveFill(s.getSpPr().getSolidFill()); + } + readLineProps(s.getSpPr(), ser, colors, palette, spec.series.size()); + spec.series.add(ser); + } + } else if (group instanceof CTSurface3DChart g) { + spec.type = Type.SURFACE3D; + spec.wireframe = isTrue(g.getWireframe()); + for (CTSurfaceSer s : g.getSer()) { + Series ser = new Series(); + readCommon(s.getTx(), s.getCat(), s.getVal(), List.of(), ser, colors, palette); + if (s.getSpPr() != null && s.getSpPr().getSolidFill() != null) { + ser.fill = colors.resolveFill(s.getSpPr().getSolidFill()); + } + spec.series.add(ser); + } + CTBandFmts bf = g.getBandFmts(); + if (bf != null) { + for (CTBandFmt b : bf.getBandFmt()) { + Color c = b.getSpPr() != null && b.getSpPr().getSolidFill() != null + ? colors.resolveFill(b.getSpPr().getSolidFill()) + : null; + spec.bandColors.add(c != null ? c + : palette.get((int) (b.getIdx().getVal() % palette.size()))); + } + } + } + } + + private static Series readPieSer(CTPieSer s, DrawMlColor colors, List palette) { + Series ser = new Series(); + readCommon(s.getTx(), s.getCat(), s.getVal(), s.getDPt(), ser, colors, palette); + if (s.getSpPr() != null) { + if (s.getSpPr().getSolidFill() != null) { + ser.fill = colors.resolveFill(s.getSpPr().getSolidFill()); + } + if (s.getSpPr().getLn() != null) { + if (s.getSpPr().getLn().getNoFill() != null) { + ser.outlineNoFill = true; + } else if (s.getSpPr().getLn().getSolidFill() != null) { + ser.outlineColor = colors.resolveFill(s.getSpPr().getLn().getSolidFill()); + } + if (s.getSpPr().getLn().getW() != null) { + ser.outlineWidth = emuToPt(s.getSpPr().getLn().getW()); + } + } + } + return ser; + } + + /** Общее для всех типов: имя, категории, значения, переопределения точек. */ + private static void readCommon(CTSerTx tx, CTAxDataSource cat, CTNumDataSource val, + List dPts, Series ser, DrawMlColor colors, + List palette) { + ser.name = seriesName(tx); + ser.categories.addAll(categoryNames(cat)); + if (val != null) { + var num = val.getNumRef() != null ? val.getNumRef().getNumCache() : val.getNumLit(); + if (num != null) { + int count = num.getPtCount() != null ? (int) num.getPtCount().getVal() : -1; + for (CTNumVal v : num.getPt()) { + while (ser.values.size() < (int) v.getIdx()) { + ser.values.add(null); + } + ser.values.add(parseDouble(v.getV())); + } + if (count > ser.values.size()) { + while (ser.values.size() < count) { + ser.values.add(null); + } + } + } + } + for (CTDPt dp : dPts) { + if (dp.getSpPr() == null || dp.getSpPr().getSolidFill() == null + || dp.getIdx() == null) { + continue; + } + Color c = colors.resolveFill(dp.getSpPr().getSolidFill()); + if (c != null) { + ser.pointFills.put((int) dp.getIdx().getVal(), c); + } + } + } + + /** a:ln ряда (цвет и толщина линии графика). */ + private static void readLineProps(CTShapeProperties sp, Series ser, DrawMlColor colors, + List palette, int seriesIndex) { + if (sp == null) { + return; + } + if (sp.getLn() == null) { + return; + } + if (sp.getLn().getNoFill() != null) { + ser.lineNoFill = true; + return; + } + if (sp.getLn().getSolidFill() != null) { + ser.lineColor = colors.resolveFill(sp.getLn().getSolidFill()); + } + if (sp.getLn().getW() != null) { + ser.lineWidth = emuToPt(sp.getLn().getW()); + } + } + + private static void readLegend(CTChart chart, ChartSpec spec, DrawMlColor colors) { + if (chart.getLegend() == null) { + spec.legendPos = null; + return; + } + var legend = chart.getLegend(); + if (isTrue(legend.getOverlay())) { + // легенда поверх области построения — не резервируем место + spec.legendPos = null; + } + if (legend.getLegendPos() != null && legend.getLegendPos().getVal() != null) { + spec.legendPos = legend.getLegendPos().getVal().value(); + } + spec.legendStyle = DrawMlText.defaultStyle(legend.getTxPr(), colors, + colors.minorFontName(), 9, new Color(0x59, 0x59, 0x59)); + } + + /** + * Заголовок: явный текст (c:title/c:tx) или автозаголовок из имени + * первого ряда (Word так и делает, когда c:autoTitleDeleted = 0). + */ + static void readTitle(CTChart chart, ChartSpec spec, DrawMlColor colors) { + CTTitle t = chart.getTitle(); + if (t == null) { + return; + } + String text = null; + CTTx tx = t.getTx(); + if (tx != null) { + if (tx.getStrRef() != null && tx.getStrRef().getStrCache() != null + && !tx.getStrRef().getStrCache().getPt().isEmpty()) { + text = tx.getStrRef().getStrCache().getPt().get(0).getV(); + } + if (text == null && tx.getRich() != null) { + StringBuilder sb = new StringBuilder(); + for (DrawMlText.Paragraph p : DrawMlText.paragraphs( + tx.getRich(), colors, colors.minorFontName(), 14, Color.DARK_GRAY)) { + sb.append(p.text()); + } + text = sb.toString(); + } + } + // Пустой c:title при autoTitleDeleted=0 — это автозаголовок Word: + // для круговых диаграмм он берётся из имени ряда, для остальных + // типов рисуется встроенный плейсхолдер (в эталоне — "Chart Title", + // в XML его нет, Word подставляет строку из своего UI-языка). + boolean deleted = chart.getAutoTitleDeleted() != null + && chart.getAutoTitleDeleted().isVal(); + if ((text == null || text.isBlank()) && !deleted) { + boolean circular = spec.type == Type.PIE || spec.type == Type.PIE3D + || spec.type == Type.DOUGHNUT; + if (circular && !spec.series.isEmpty()) { + text = spec.series.get(0).name; + } else { + text = AUTO_TITLE; + } + } + if (text == null || text.isBlank()) { + return; + } + spec.title = text; + spec.titleStyle = DrawMlText.defaultStyle(t.getTxPr(), colors, + colors.minorFontName(), 14, new Color(0x59, 0x59, 0x59)); + } + + private static AxisSpec readAxis(Object ax, DrawMlColor colors) { + AxisSpec a = new AxisSpec(); + CTScaling scaling; + CTBoolean deleted; + CTAxPos pos; + CTChartLines grid; + CTTextBody txPr; + CTShapeProperties spPr; + String numFmt; + if (ax instanceof CTCatAx c) { + scaling = c.getScaling(); + deleted = c.getDelete(); + pos = c.getAxPos(); + grid = c.getMajorGridlines(); + txPr = c.getTxPr(); + spPr = c.getSpPr(); + numFmt = c.getNumFmt() != null ? c.getNumFmt().getFormatCode() : "General"; + } else if (ax instanceof CTValAx c) { + scaling = c.getScaling(); + deleted = c.getDelete(); + pos = c.getAxPos(); + grid = c.getMajorGridlines(); + txPr = c.getTxPr(); + spPr = c.getSpPr(); + numFmt = c.getNumFmt() != null ? c.getNumFmt().getFormatCode() : "General"; + if (c.getMajorUnit() != null) { + a.majorUnit = c.getMajorUnit().getVal(); + } + } else if (ax instanceof CTSerAx c) { + scaling = c.getScaling(); + deleted = c.getDelete(); + pos = c.getAxPos(); + grid = c.getMajorGridlines(); + txPr = c.getTxPr(); + spPr = c.getSpPr(); + numFmt = "General"; + } else if (ax instanceof CTDateAx c) { + scaling = c.getScaling(); + deleted = c.getDelete(); + pos = c.getAxPos(); + grid = c.getMajorGridlines(); + txPr = c.getTxPr(); + spPr = c.getSpPr(); + numFmt = c.getNumFmt() != null ? c.getNumFmt().getFormatCode() : "General"; + } else { + return a; + } + a.deleted = isTrue(deleted); + a.pos = pos != null && pos.getVal() != null ? pos.getVal().value() : a.pos; + a.numFmt = numFmt; + if (scaling != null) { + if (scaling.getMin() != null) { + a.min = scaling.getMin().getVal(); + } + if (scaling.getMax() != null) { + a.max = scaling.getMax().getVal(); + } + } + a.gridlines = grid != null; + if (grid != null && grid.getSpPr() != null && grid.getSpPr().getLn() != null + && grid.getSpPr().getLn().getSolidFill() != null) { + Color g = colors.resolveFill(grid.getSpPr().getLn().getSolidFill()); + if (g != null) { + a.gridColor = g; + } + } + if (spPr != null && spPr.getLn() != null) { + if (spPr.getLn().getNoFill() != null) { + a.axisLineColor = null; + } else if (spPr.getLn().getSolidFill() != null) { + Color c = colors.resolveFill(spPr.getLn().getSolidFill()); + if (c != null) { + a.axisLineColor = c; + } + } + if (spPr.getLn().getW() != null) { + a.axisLineWidth = emuToPt(spPr.getLn().getW()); + } + } + a.labelStyle = DrawMlText.defaultStyle(txPr, colors, + colors.minorFontName(), 9, new Color(0x59, 0x59, 0x59)); + return a; + } + + private static String seriesName(CTSerTx tx) { + if (tx == null) { + return null; + } + if (tx.getV() != null) { + return tx.getV(); + } + if (tx.getStrRef() != null && tx.getStrRef().getStrCache() != null + && !tx.getStrRef().getStrCache().getPt().isEmpty()) { + return tx.getStrRef().getStrCache().getPt().get(0).getV(); + } + return null; + } + + private static List categoryNames(CTAxDataSource cat) { + List out = new ArrayList<>(); + if (cat == null) { + return out; + } + var str = cat.getStrRef() != null ? cat.getStrRef().getStrCache() : cat.getStrLit(); + if (str != null) { + for (CTStrVal v : str.getPt()) { + while (out.size() < v.getIdx()) { + out.add(""); + } + out.add(v.getV() == null ? "" : v.getV()); + } + return out; + } + var num = cat.getNumRef() != null ? cat.getNumRef().getNumCache() : cat.getNumLit(); + if (num != null) { + for (CTNumVal v : num.getPt()) { + while (out.size() < v.getIdx()) { + out.add(""); + } + out.add(v.getV() == null ? "" : v.getV()); + } + } + return out; + } + + private static Double parseDouble(String s) { + if (s == null || s.isBlank()) { + return null; + } + try { + return Double.parseDouble(s.trim()); + } catch (NumberFormatException e) { + return null; + } + } + + static boolean isTrue(CTBoolean b) { + return b != null && b.isVal(); + } + + /** EMU -> points (1 pt = 12700 EMU). */ + static double emuToPt(long emu) { + return emu / 12700.0; + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlColor.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlColor.java new file mode 100644 index 0000000..44703ad --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlColor.java @@ -0,0 +1,355 @@ +package ru.pjandro.wordpdf.internal.chart; + +import jakarta.xml.bind.JAXBElement; +import org.docx4j.dml.BaseStyles; +import org.docx4j.dml.CTAngle; +import org.docx4j.dml.CTColor; +import org.docx4j.dml.CTColorScheme; +import org.docx4j.dml.CTFixedPercentage; +import org.docx4j.dml.CTHslColor; +import org.docx4j.dml.CTPercentage; +import org.docx4j.dml.CTPositiveFixedAngle; +import org.docx4j.dml.CTPositiveFixedPercentage; +import org.docx4j.dml.CTPositivePercentage; +import org.docx4j.dml.CTScRgbColor; +import org.docx4j.dml.CTSRgbColor; +import org.docx4j.dml.CTSchemeColor; +import org.docx4j.dml.CTSolidColorFillProperties; +import org.docx4j.dml.CTSystemColor; +import org.docx4j.dml.FontCollection; +import org.docx4j.dml.STSchemeColorVal; +import org.docx4j.dml.Theme; + +import java.awt.Color; +import java.util.HashMap; +import java.util.Locale; +import java.util.Map; + +/** + * Палитра цветов DrawingML: цвета схемы из word/theme/theme1.xml плюс + * разбор {@code a:color} (srgbClr / schemeClr / sysClr / hslClr) с + * трансформациями (lumMod, lumOff, tint, shade, satMod, hueOff, alpha...). + * + * Нужен и для графиков (c:solidFill / a:solidFill), и для SmartArt: оба + * используют одни и те же ссылки на цвета темы (accent1..6, tx1, lt1). + */ +final class DrawMlColor { + + /** Цвета темы по имени (lowercase): dk1/lt1/dk2/lt2/accent1..6/hlink/folHlink. */ + private final Map scheme = new HashMap<>(); + + /** Шрифты схемы ("+mn-lt"/"+mj-ma" в графиках разрешаются в них). */ + private final String minorFont; + private final String majorFont; + + /** Значение по умолчанию, когда у part'а нет темы. */ + private static final String[] OFFICE_DEFAULT = { + "dk1", "000000", "lt1", "FFFFFF", "dk2", "44546A", "lt2", "E7E6E6", + "accent1", "4472C4", "accent2", "ED7D31", "accent3", "A5A5A5", + "accent4", "FFC000", "accent5", "5B9BD5", "accent6", "70AD47", + "hlink", "0563C1", "folHlink", "954F72", + }; + + DrawMlColor(Theme theme) { + for (int i = 0; i < OFFICE_DEFAULT.length; i += 2) { + scheme.put(OFFICE_DEFAULT[i], decodeHex(OFFICE_DEFAULT[i + 1])); + } + String minor = "Calibri"; + String major = "Calibri Light"; + if (theme != null && theme.getThemeElements() != null) { + BaseStyles el = theme.getThemeElements(); + CTColorScheme cs = el.getClrScheme(); + if (cs != null) { + put("dk1", cs.getDk1()); + put("lt1", cs.getLt1()); + put("dk2", cs.getDk2()); + put("lt2", cs.getLt2()); + put("accent1", cs.getAccent1()); + put("accent2", cs.getAccent2()); + put("accent3", cs.getAccent3()); + put("accent4", cs.getAccent4()); + put("accent5", cs.getAccent5()); + put("accent6", cs.getAccent6()); + put("hlink", cs.getHlink()); + put("folHlink", cs.getFolHlink()); + } + BaseStyles.FontScheme fs = el.getFontScheme(); + if (fs != null) { + minor = latinOf(fs.getMinorFont(), minor); + major = latinOf(fs.getMajorFont(), major); + } + } + this.minorFont = minor; + this.majorFont = major; + } + + private void put(String name, CTColor c) { + Color resolved = c == null ? null : baseOf(c); + if (resolved != null) { + scheme.put(name, resolved); + } + } + + private static String latinOf(FontCollection fc, String def) { + if (fc == null || fc.getLatin() == null || fc.getLatin().getTypeface() == null) { + return def; + } + return fc.getLatin().getTypeface(); + } + + String minorFontName() { + return minorFont; + } + + String majorFontName() { + return majorFont; + } + + /** Цвет схемы по имени (accent1, tx1, bg1...). Нет имени -> чёрный. */ + Color schemeColor(String name) { + if (name == null) { + return Color.BLACK; + } + String n = name.toLowerCase(Locale.ROOT); + // Word: bg1/tx1 — псевдонимы lt1/dk1 + if (n.equals("bg1")) { + n = "lt1"; + } else if (n.equals("tx1")) { + n = "dk1"; + } + Color c = scheme.get(n); + return c != null ? c : Color.BLACK; + } + + /** + * Разбор {@code a:color}: базовый цвет + трансформации в порядке + * следования. null -> null (вызывающий решает значение по умолчанию). + */ + Color resolve(CTColor c) { + if (c == null) { + return null; + } + Color base = baseOf(c); + if (base == null) { + return null; + } + java.util.List> transforms = transformsOf(c); + if (transforms.isEmpty()) { + return base; + } + double[] hsl = RgbHsl.toHsl(base); + int alpha = 255; + boolean hslDirty = false; + Color rgb = base; + for (JAXBElement el : transforms) { + String kind = el.getName().getLocalPart(); + int val = percentOf(el.getValue()); + if (val == Integer.MIN_VALUE) { + continue; + } + double p = val / 100000.0; + switch (kind) { + case "lumMod" -> { + hsl = RgbHsl.toHsl(toRgb(hsl)); + hsl[2] = clamp01(hsl[2] * p); + hslDirty = true; + } + case "lumOff" -> { + hsl = RgbHsl.toHsl(toRgb(hsl)); + hsl[2] = clamp01(hsl[2] + p); + hslDirty = true; + } + case "satMod" -> { + hsl = RgbHsl.toHsl(toRgb(hsl)); + hsl[1] = clamp01(hsl[1] * p); + hslDirty = true; + } + case "satOff" -> { + hsl = RgbHsl.toHsl(toRgb(hsl)); + hsl[1] = clamp01(hsl[1] + p); + hslDirty = true; + } + case "hueMod" -> { + hsl = RgbHsl.toHsl(toRgb(hsl)); + hsl[0] = (hsl[0] * p) % 360.0; + hslDirty = true; + } + case "hueOff" -> { + hsl = RgbHsl.toHsl(toRgb(hsl)); + hsl[0] = (hsl[0] + val / 60000.0) % 360.0; + hslDirty = true; + } + case "tint" -> rgb = tint(rgb, p); + case "shade" -> rgb = scaleRgb(rgb, p); + case "alpha" -> alpha = clamp255((int) Math.round(alpha * p)); + case "alphaOff" -> alpha = clamp255((int) Math.round(clamp01((alpha / 255.0) + p) * 255)); + case "grayscl" -> { + double lum = 0.299 * rgb.getRed() + 0.587 * rgb.getGreen() + 0.114 * rgb.getBlue(); + int l = clamp255((int) Math.round(lum)); + rgb = new Color(l, l, l); + } + default -> { /* прочие трансформации не поддерживаются */ } + } + } + if (hslDirty) { + rgb = toRgb(hsl); + } + return alpha == 255 ? rgb + : new Color(rgb.getRed(), rgb.getGreen(), rgb.getBlue(), clamp255(alpha)); + } + + /** + * Разбор {@code a:solidFill} (a:ln/a:spPr): обёртка над тем же + * набором цветов, что и {@code a:color}. + */ + Color resolveFill(CTSolidColorFillProperties fill) { + if (fill == null) { + return null; + } + CTColor c = new CTColor(); + c.setScrgbClr(fill.getScrgbClr()); + c.setSrgbClr(fill.getSrgbClr()); + c.setHslClr(fill.getHslClr()); + c.setSysClr(fill.getSysClr()); + c.setSchemeClr(fill.getSchemeClr()); + c.setPrstClr(fill.getPrstClr()); + return resolve(c); + } + + /** Цвет стоп-точки градиента (a:gs) — тот же набор, что и у solidFill. */ + Color resolveStop(org.docx4j.dml.CTGradientStop gs) { + if (gs == null) { + return null; + } + CTColor c = new CTColor(); + c.setScrgbClr(gs.getScrgbClr()); + c.setSrgbClr(gs.getSrgbClr()); + c.setHslClr(gs.getHslClr()); + c.setSysClr(gs.getSysClr()); + c.setSchemeClr(gs.getSchemeClr()); + c.setPrstClr(gs.getPrstClr()); + return resolve(c); + } + + /** Цвет из a:fontRef (стилевая матрица SmartArt) — тот же набор детей. */ + Color resolveFontRef(org.docx4j.dml.CTFontReference ref) { + if (ref == null) { + return null; + } + CTColor c = new CTColor(); + c.setScrgbClr(ref.getScrgbClr()); + c.setSrgbClr(ref.getSrgbClr()); + c.setHslClr(ref.getHslClr()); + c.setSysClr(ref.getSysClr()); + c.setSchemeClr(ref.getSchemeClr()); + c.setPrstClr(ref.getPrstClr()); + return resolve(c); + } + + /** Базовый цвет без трансформаций. */ + private Color baseOf(CTColor c) { + if (c.getSrgbClr() != null) { + CTSRgbColor s = c.getSrgbClr(); + return s.getVal() == null ? null : decodeHex(s.getVal()); + } + if (c.getSchemeClr() != null) { + CTSchemeColor sc = c.getSchemeClr(); + STSchemeColorVal v = sc.getVal(); + return v == null ? null : schemeColor(v.value()); + } + if (c.getScrgbClr() != null) { + CTScRgbColor s = c.getScrgbClr(); + return new Color( + clamp255((int) Math.round(s.getR() * 255)), + clamp255((int) Math.round(s.getG() * 255)), + clamp255((int) Math.round(s.getB() * 255))); + } + if (c.getHslClr() != null) { + CTHslColor h = c.getHslClr(); + return RgbHsl.fromHsl(h.getHue() / 60000.0, h.getSat() / 100000.0, h.getLum() / 100000.0); + } + if (c.getSysClr() != null) { + CTSystemColor s = c.getSysClr(); + return "window".equalsIgnoreCase(s.getVal()) ? Color.WHITE : Color.BLACK; + } + return null; + } + + private static java.util.List> transformsOf(CTColor c) { + if (c.getSrgbClr() != null) { + return c.getSrgbClr().getEGColorTransform(); + } + if (c.getSchemeClr() != null) { + return c.getSchemeClr().getEGColorTransform(); + } + if (c.getSysClr() != null) { + return c.getSysClr().getEGColorTransform(); + } + return java.util.List.of(); + } + + /** Все классы процентных/угловых трансформаций имеют getVal() в стотысячных. */ + private static int percentOf(Object o) { + if (o instanceof CTPercentage v) { + return v.getVal(); + } + if (o instanceof CTPositivePercentage v) { + return v.getVal(); + } + if (o instanceof CTFixedPercentage v) { + return v.getVal(); + } + if (o instanceof CTPositiveFixedPercentage v) { + return v.getVal(); + } + if (o instanceof CTAngle v) { + return v.getVal(); + } + if (o instanceof CTPositiveFixedAngle v) { + return v.getVal(); + } + return Integer.MIN_VALUE; + } + + /** Осветление: c*p + white*(1-p) (a:tint в DrawingML). */ + static Color tint(Color c, double p) { + return new Color( + clamp255((int) Math.round(c.getRed() * p + 255 * (1 - p))), + clamp255((int) Math.round(c.getGreen() * p + 255 * (1 - p))), + clamp255((int) Math.round(c.getBlue() * p + 255 * (1 - p)))); + } + + /** Затемнение: c*p (a:shade). */ + static Color scaleRgb(Color c, double p) { + return new Color(clamp255((int) Math.round(c.getRed() * p)), + clamp255((int) Math.round(c.getGreen() * p)), + clamp255((int) Math.round(c.getBlue() * p))); + } + + /** Затемнение на фиксированную долю (для боковых граней 3D). */ + static Color darken(Color c, double amount) { + return scaleRgb(c, 1.0 - amount); + } + + static Color withAlpha(Color c, double alpha) { + return new Color(c.getRed(), c.getGreen(), c.getBlue(), + (int) Math.round(clamp01(alpha) * 255)); + } + + private static Color toRgb(double[] hsl) { + return RgbHsl.fromHsl(hsl[0], hsl[1], hsl[2]); + } + + private static int clamp255(int v) { + return Math.max(0, Math.min(255, v)); + } + + private static double clamp01(double v) { + return Math.max(0.0, Math.min(1.0, v)); + } + + static Color decodeHex(String hex) { + long v = Long.parseLong(hex, 16); + return new Color((int) ((v >> 16) & 0xFF), (int) ((v >> 8) & 0xFF), (int) (v & 0xFF)); + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlText.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlText.java new file mode 100644 index 0000000..73ce2f9 --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlText.java @@ -0,0 +1,263 @@ +package ru.pjandro.wordpdf.internal.chart; + +import org.docx4j.dml.CTRegularTextRun; +import org.docx4j.dml.CTTextBody; +import org.docx4j.dml.CTTextCharacterProperties; +import org.docx4j.dml.CTTextParagraph; +import org.docx4j.dml.CTTextParagraphProperties; +import org.docx4j.dml.TextFont; +import ru.pjandro.wordpdf.fonts.BundledFontMapper; +import ru.pjandro.wordpdf.fonts.BundledFonts; + +import java.awt.Color; +import java.awt.Font; +import java.awt.Graphics2D; +import java.awt.Font; +import java.awt.font.FontRenderContext; +import java.awt.font.TextLayout; +import java.awt.geom.Rectangle2D; +import java.util.ArrayList; +import java.util.List; + +/** + * Текст DrawingML (a:txPr / a:txBody) для Java2D: разбор начертания + * (a:defRPr / a:rPr: sz, b, i, solidFill, latin) и разбивка на строки. + * + * Шрифты берутся из того же бандла, что и у текста PDF + * ({@link BundledFontMapper#bundledFamily}), поэтому подпись диаграммы + * рисуется тем же Carlito/Tinos, что и абзацы документа. + */ +final class DrawMlText { + + /** Начертание одного запуска текста. */ + record Style(double sizePt, boolean bold, boolean italic, Color color, String family) { + + Style derive(Double size, Boolean bold, Boolean italic, Color clr, String fam) { + return new Style( + size != null ? size : sizePt, + bold != null ? bold : this.bold, + italic != null ? italic : this.italic, + clr != null ? clr : this.color, + fam != null ? fam : this.family); + } + } + + /** Один абзац: текст + начертание + выравнивание. */ + record Paragraph(String text, Style style, String align) { + } + + private DrawMlText() { + } + + /** + * Стиль по умолчанию из {@code a:txPr} (первый {@code a:pPr/a:defRPr}). + * + * @param txPr тело текста (может быть null) + * @param colors палитра темы (для schemeClr в solidFill) + * @param fallbackFam семейство, если latin не указан/неизвестен + * @param fallbackSize размер в pt, если sz нет + */ + static Style defaultStyle(CTTextBody txPr, DrawMlColor colors, + String fallbackFam, double fallbackSize, Color fallbackColor) { + Style base = new Style(fallbackSize, false, false, fallbackColor, fallbackFam); + if (txPr == null || txPr.getP().isEmpty()) { + return base; + } + CTTextParagraphProperties pPr = txPr.getP().get(0).getPPr(); + if (pPr == null) { + return base; + } + return applyTo(pPr.getDefRPr(), base, colors, fallbackFam); + } + + /** Начертания абзацев тела текста (a:p -> a:r/a:t) с учётом defRPr. */ + static List paragraphs(CTTextBody body, DrawMlColor colors, + String fallbackFam, double fallbackSize, + Color fallbackColor) { + List out = new ArrayList<>(); + if (body == null) { + return out; + } + Style def = defaultStyle(body, colors, fallbackFam, fallbackSize, fallbackColor); + for (CTTextParagraph p : body.getP()) { + Style paraStyle = def; + if (p.getPPr() != null) { + paraStyle = applyTo(p.getPPr().getDefRPr(), paraStyle, colors, fallbackFam); + } + StringBuilder sb = new StringBuilder(); + Style runStyle = paraStyle; + for (Object run : p.getEGTextRun()) { + if (run instanceof CTRegularTextRun r) { + if (r.getRPr() != null) { + runStyle = applyTo(r.getRPr(), paraStyle, colors, fallbackFam); + } + if (r.getT() != null) { + sb.append(r.getT()); + } + } + } + String align = p.getPPr() != null && p.getPPr().getAlgn() != null + ? p.getPPr().getAlgn().value() : null; + String text = sb.toString(); + if (!text.isBlank()) { + out.add(new Paragraph(text, runStyle, align)); + } + } + return out; + } + + /** Применяет a:defRPr / a:rPr к наследуемому стилю. */ + private static Style applyTo(CTTextCharacterProperties rPr, Style inherit, + DrawMlColor colors, String fallbackFam) { + if (rPr == null) { + return inherit; + } + Double size = rPr.getSz() != null ? rPr.getSz() / 100.0 : null; + Boolean bold = rPr.isB(); + Boolean italic = rPr.isI(); + Color color = null; + if (rPr.getNoFill() != null) { + color = new Color(0, 0, 0, 0); + } else if (rPr.getSolidFill() != null) { + color = colors.resolveFill(rPr.getSolidFill()); + } + String family = null; + TextFont latin = rPr.getLatin(); + if (latin != null && latin.getTypeface() != null) { + family = resolveFamily(latin.getTypeface(), colors, fallbackFam); + } + return inherit.derive(size, bold, italic, color, family); + } + + /** "+mn-lt"/"+mj-mt" -> шрифт темы; иначе имя как есть (через алиасы бандла). */ + private static String resolveFamily(String typeface, DrawMlColor colors, String fallbackFam) { + String name = switch (typeface) { + case "+mn-lt", "+mn-ea", "+mn-cs" -> colors.minorFontName(); + case "+mj-lt", "+mj-ea", "+mj-cs" -> colors.majorFontName(); + default -> typeface; + }; + return BundledFontMapper.bundledFamily(name != null ? name : fallbackFam); + } + + /** java.awt.Font для стиля; null -> логический SansSerif. */ + static Font fontFor(Style style) { + String variant = style.bold() && style.italic() ? BundledFonts.V_BOLD_ITALIC + : style.bold() ? BundledFonts.V_BOLD + : style.italic() ? BundledFonts.V_ITALIC + : BundledFonts.V_REGULAR; + Font base = BundledFonts.awtFont(style.family(), variant); + int flags = (style.bold() ? Font.BOLD : 0) | (style.italic() ? Font.ITALIC : 0); + if (base == null) { + return new Font(Font.SANS_SERIF, flags, 1).deriveFont((float) style.sizePt()); + } + return base.deriveFont((float) style.sizePt()); + } + + /** + * Рисует абзацы внутри прямоугольника: выравнивание по горизонтали + * (align абзаца или {@code defAlign}) и по вертикали ({@code vAlign}: + * t/ctr/b). + */ + static void paint(Graphics2D g, List paragraphs, Rectangle2D box, + String defAlign, String vAlign, double lineHeightFactor) { + if (paragraphs.isEmpty()) { + return; + } + FontRenderContext frc = g.getFontRenderContext(); + record Line(String text, Style style, String align, double width, double height, + double ascent) { + } + List lines = new ArrayList<>(); + double totalHeight = 0; + for (Paragraph p : paragraphs) { + Font f = fontFor(p.style()); + TextLayout metrics = new TextLayout("Xg", f, frc); + double lineH = (metrics.getAscent() + metrics.getDescent() + + metrics.getLeading()) * lineHeightFactor; + for (String line : wrapLines(p.text(), f, frc, box.getWidth())) { + double w = new TextLayout(line, f, frc).getAdvance(); + lines.add(new Line(line, p.style(), p.align(), w, lineH, + metrics.getAscent() * lineHeightFactor)); + totalHeight += lineH; + } + } + double y = box.getY(); + if ("ctr".equals(vAlign)) { + y += (box.getHeight() - totalHeight) / 2.0; + } else if ("b".equals(vAlign)) { + y += box.getHeight() - totalHeight; + } + y = Math.max(box.getY(), y); + for (Line line : lines) { + g.setFont(fontFor(line.style())); + g.setColor(line.style().color()); + double x = box.getX(); + String align = line.align() != null ? line.align() : defAlign; + if ("ctr".equals(align)) { + x += (box.getWidth() - line.width()) / 2.0; + } else if ("r".equals(align) || "far".equals(align)) { + x += box.getWidth() - line.width(); + } + g.drawString(line.text(), (float) x, (float) (y + line.ascent())); + y += line.height(); + } + } + + /** Жадный перенос по пробелам; длинные слова режутся по символам. */ + private static List wrapLines(String text, Font f, FontRenderContext frc, + double maxWidth) { + List out = new ArrayList<>(); + double limit = Math.max(1, maxWidth); + for (String hard : text.split("\\n")) { + if (hard.isEmpty()) { + out.add(""); + continue; + } + StringBuilder cur = new StringBuilder(); + double curWidth = 0; + for (String word : hard.split(" ")) { + if (word.isEmpty()) { + continue; + } + String candidate = cur.length() == 0 ? word : cur + " " + word; + double w = new TextLayout(candidate, f, frc).getAdvance(); + if (w <= limit || cur.length() == 0) { + cur.setLength(0); + cur.append(candidate); + curWidth = w; + continue; + } + out.add(cur.toString()); + cur.setLength(0); + cur.append(word); + curWidth = new TextLayout(word, f, frc).getAdvance(); + while (curWidth > limit && cur.length() > 1) { + int cut = cur.length() - 1; + while (cut > 1 && new TextLayout(cur.substring(0, cut), f, frc) + .getAdvance() > limit) { + cut--; + } + out.add(cur.substring(0, cut)); + cur.delete(0, cut); + curWidth = new TextLayout(cur.toString(), f, frc).getAdvance(); + } + } + if (cur.length() > 0) { + out.add(cur.toString()); + } + } + return out; + } + + /** Ширина строки в тех же единицах, что и размер шрифта. */ + static double textWidth(String text, Style style, FontRenderContext frc) { + return new java.awt.font.TextLayout(text, fontFor(style), frc).getAdvance(); + } + + /** Высота строки (ascent+descent+leading) для стиля. */ + static double textHeight(Style style, FontRenderContext frc) { + Font f = fontFor(style); + java.awt.font.TextLayout tl = new java.awt.font.TextLayout("Xpg", f, frc); + return tl.getAscent() + tl.getDescent() + tl.getLeading(); + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawingPreRenderer.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawingPreRenderer.java new file mode 100644 index 0000000..0966502 --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawingPreRenderer.java @@ -0,0 +1,347 @@ +package ru.pjandro.wordpdf.internal.chart; + +import jakarta.xml.bind.JAXBElement; +import org.docx4j.dml.CTBlip; +import org.docx4j.dml.CTBlipFillProperties; +import org.docx4j.dml.CTGeomGuideList; +import org.docx4j.dml.CTNonVisualDrawingProps; +import org.docx4j.dml.CTNonVisualPictureProperties; +import org.docx4j.dml.CTPoint2D; +import org.docx4j.dml.CTPositiveSize2D; +import org.docx4j.dml.CTPresetGeometry2D; +import org.docx4j.dml.CTRelativeRect; +import org.docx4j.dml.CTShapeProperties; +import org.docx4j.dml.CTStretchInfoProperties; +import org.docx4j.dml.CTTransform2D; +import org.docx4j.dml.Graphic; +import org.docx4j.dml.GraphicData; +import org.docx4j.dml.STShapeType; +import org.docx4j.dml.chart.CTChartSpace; +import org.docx4j.dml.chart.CTRelId; +import org.docx4j.dml.diagram.CTDataModel; +import org.docx4j.dml.diagram.CTRelIds; +import org.docx4j.dml.diagram2008.CTDrawing; +import org.docx4j.dml.picture.Pic; +import org.docx4j.dml.wordprocessingDrawing.Anchor; +import org.docx4j.dml.wordprocessingDrawing.Inline; +import org.docx4j.openpackaging.packages.WordprocessingMLPackage; +import org.docx4j.openpackaging.parts.JaxbXmlPart; +import org.docx4j.openpackaging.parts.Part; +import org.docx4j.openpackaging.parts.ThemePart; +import org.docx4j.openpackaging.parts.WordprocessingML.BinaryPartAbstractImage; +import org.docx4j.openpackaging.parts.relationships.RelationshipsPart; +import org.docx4j.wml.Drawing; +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import javax.imageio.ImageIO; +import java.awt.image.BufferedImage; +import java.io.ByteArrayOutputStream; +import java.lang.reflect.Method; +import java.util.ArrayList; +import java.util.HashSet; +import java.util.List; +import java.util.Set; + +/** + * Выключатель «диаграммы не умеют в FO»: до экспорта в XSL-FO каждая + * DrawingML-диаграмма (c:chart) и SmartArt-схема (dgm:relIds) рендерится + * в PNG и подменяется обычной картинкой pic:pic — единственный вид + * a:graphic, который docx2fo.xslt действительно умеет выкладывать. + * + * Порядок вызова важен: {@link #run} должен отработать после загрузки + * пакета и до создания FOSettings, иначе FOP увидит исходные chart/diagram + * и молча их выбросит (notImplemented в шаблоне). + */ +public final class DrawingPreRenderer { + + private static final Logger log = LoggerFactory.getLogger(DrawingPreRenderer.class); + + private static final String CHART_ELEMENT = + "{http://schemas.openxmlformats.org/drawingml/2006/chart}chart"; + private static final String DIAGRAM_ELEMENT = + "{http://schemas.openxmlformats.org/drawingml/2006/diagram}relIds"; + private static final String PICTURE_URI = + "http://schemas.openxmlformats.org/drawingml/2006/picture"; + private static final String DIAGRAM_DRAWING_REL = + "http://schemas.microsoft.com/office/2007/relationships/diagramDrawing"; + + private DrawingPreRenderer() { + } + + /** Рендерит все диаграммы пакета в PNG и подменяет их картинками. */ + public static void run(WordprocessingMLPackage pkg) { + ThemePart themePart = null; + for (Part p : new ArrayList<>(pkg.getParts().getParts().values())) { + if (p instanceof ThemePart tp) { + themePart = tp; + break; + } + } + DrawMlColor colors = new DrawMlColor(themePart == null ? null : themePart.getJaxbElement()); + + // Снимок: createImagePart докидывает части в тот же реестр, + // обход живого HashMap дал бы ConcurrentModificationException. + List parts = new ArrayList<>(pkg.getParts().getParts().values()); + Set handled = new HashSet<>(); + int[] idSeq = {1000}; + for (Part p : parts) { + if (!handled.add(p)) { + continue; + } + List content = contentOf(p); + if (content == null || content.isEmpty()) { + continue; + } + walk(p, content, pkg, colors, idSeq); + } + } + + /** Содержимое части, в котором могут лежать w:drawing. */ + private static List contentOf(Part part) { + if (!(part instanceof JaxbXmlPart jaxb)) { + return null; + } + Object root = jaxb.getJaxbElement(); + if (root == null) { + return null; + } + if (root instanceof org.docx4j.wml.Document doc) { + return doc.getBody() == null ? doc.getContent() : doc.getBody().getContent(); + } + if (root instanceof org.docx4j.wml.CTFootnotes fn) { + return cast(fn.getFootnote()); + } + if (root instanceof org.docx4j.wml.CTEndnotes en) { + return cast(en.getEndnote()); + } + return invokeList(root, "getContent"); + } + + @SuppressWarnings("unchecked") + private static void walk(Part part, List content, WordprocessingMLPackage pkg, + DrawMlColor colors, int[] idSeq) { + for (Object o : content) { + Object v = o instanceof JAXBElement ? ((JAXBElement) o).getValue() : o; + if (v instanceof Drawing drawing) { + replaceDrawing(part, drawing, pkg, colors, idSeq); + continue; + } + List nested = invokeList(v, "getContent"); + if (nested != null && !nested.isEmpty() && nested != content) { + walk(part, nested, pkg, colors, idSeq); + } + } + } + + @SuppressWarnings("unchecked") + private static List cast(List l) { + return (List) l; + } + + @SuppressWarnings("unchecked") + private static List invokeList(Object target, String getter) { + try { + Method m = target.getClass().getMethod(getter); + Object r = m.invoke(target); + return r instanceof List ? (List) r : null; + } catch (ReflectiveOperationException | RuntimeException e) { + return null; + } + } + + private static void replaceDrawing(Part part, Drawing drawing, WordprocessingMLPackage pkg, + DrawMlColor colors, int[] idSeq) { + for (Object wrapper : drawing.getAnchorOrInline()) { + Graphic graphic; + long cx; + long cy; + if (wrapper instanceof Inline inline) { + graphic = inline.getGraphic(); + cx = inline.getExtent() == null ? 0 : inline.getExtent().getCx(); + cy = inline.getExtent() == null ? 0 : inline.getExtent().getCy(); + } else if (wrapper instanceof Anchor anchor) { + graphic = anchor.getGraphic(); + cx = anchor.getExtent() == null ? 0 : anchor.getExtent().getCx(); + cy = anchor.getExtent() == null ? 0 : anchor.getExtent().getCy(); + } else { + continue; + } + if (graphic == null || graphic.getGraphicData() == null) { + continue; + } + if (cx <= 0 || cy <= 0) { + log.warn("drawing без wp:extent — оставлен как есть"); + continue; + } + GraphicData gd = graphic.getGraphicData(); + String uri = gd.getUri(); + BufferedImage img = null; + String label = null; + if (PICTURE_URI.equals(uri)) { + continue; // уже картинка + } + if (gd.getAny().isEmpty()) { + continue; + } + Object payload = gd.getAny().get(0); + if (payload instanceof JAXBElement el) { + String name = el.getName() == null ? "" : el.getName().toString(); + if (CHART_ELEMENT.equals(name)) { + img = renderChart(part, (CTRelId) el.getValue(), pkg, colors, cx, cy); + label = "график"; + } else if (DIAGRAM_ELEMENT.equals(name)) { + img = renderDiagram(part, (CTRelIds) el.getValue(), pkg, colors, cx, cy); + label = "SmartArt"; + } + } + if (img == null) { + if (label != null) { + log.warn("не удалось отрендерить {} — объект удалён из документа", label); + gd.getAny().clear(); + } + continue; + } + swapForPicture(part, gd, img, cx, cy, idSeq, pkg); + } + } + + private static BufferedImage renderChart(Part part, CTRelId ref, WordprocessingMLPackage pkg, + DrawMlColor colors, long cx, long cy) { + Part target = resolve(part, ref.getId()); + if (!(target instanceof JaxbXmlPart jp) || !(jp.getJaxbElement() instanceof CTChartSpace space)) { + log.warn("chart-часть не найдена по r:id={}", ref.getId()); + return null; + } + try { + ChartSpec spec = ChartSpec.parse(space, colors); + return ChartRenderer.render(spec, cx / 12700.0, cy / 12700.0, colors); + } catch (RuntimeException e) { + log.warn("рендер графика r:id={} упал: {}", ref.getId(), e.toString()); + return null; + } + } + + private static BufferedImage renderDiagram(Part part, CTRelIds refs, WordprocessingMLPackage pkg, + DrawMlColor colors, long cx, long cy) { + Part drawingPart = diagramDrawingPart(part); + if (!(drawingPart instanceof JaxbXmlPart jp) + || !(jp.getJaxbElement() instanceof CTDrawing drawing)) { + log.warn("dsp:drawing (SmartArt) не найден — схема пропущена"); + return null; + } + CTDataModel data = null; + if (refs.getDm() != null && resolve(part, refs.getDm()) instanceof JaxbXmlPart dp + && dp.getJaxbElement() instanceof CTDataModel dm) { + data = dm; + } + try { + return SmartArtRenderer.render(drawing, data, colors, cx / 12700.0, cy / 12700.0); + } catch (RuntimeException e) { + log.warn("рендер SmartArt упал: {}", e.toString()); + return null; + } + } + + /** + * part.getOwningRelationshipPart() — это rels того, кто ссылается на + * часть (для document.xml это пакетный .rels). Нужны собственные rels + * части, они в Base.getRelationshipsPart(). + */ + private static RelationshipsPart relsOf(Part part) { + return part.getRelationshipsPart(); + } + + private static Part diagramDrawingPart(Part dataPart) { + RelationshipsPart rels = relsOf(dataPart); + if (rels == null || rels.getRelationships() == null) { + return null; + } + var rel = rels.getRelationshipByType(DIAGRAM_DRAWING_REL); + return rel == null ? null : rels.getPart(rel); + } + + private static Part resolve(Part part, String relId) { + RelationshipsPart rels = relsOf(part); + if (rels == null || relId == null || rels.getRelationships() == null) { + return null; + } + var rel = rels.getRelationshipByID(relId); + return rel == null ? null : rels.getPart(rel); + } + + /** a:graphic -> pic:pic того же размера; PNG кладётся в ImagePart этой же части. */ + private static void swapForPicture(Part part, GraphicData gd, BufferedImage img, + long cx, long cy, int[] idSeq, + WordprocessingMLPackage pkg) { + byte[] png; + try { + ByteArrayOutputStream bos = new ByteArrayOutputStream(); + ImageIO.write(img, "png", bos); + png = bos.toByteArray(); + } catch (Exception e) { + log.warn("PNG не собран: {}", e.toString()); + return; + } + BinaryPartAbstractImage imagePart; + try { + imagePart = BinaryPartAbstractImage.createImagePart(pkg, part, png); + } catch (Exception e) { + log.warn("ImagePart не создан: {}", e.toString()); + return; + } + String relId = relIdFor(part, imagePart); + if (relId == null) { + log.warn("r:id для ImagePart {} не найден", imagePart.getPartName()); + return; + } + + Pic pic = new Pic(); + org.docx4j.dml.picture.CTPictureNonVisual nv = new org.docx4j.dml.picture.CTPictureNonVisual(); + CTNonVisualDrawingProps props = new CTNonVisualDrawingProps(); + props.setId(idSeq[0]++); + props.setName("Диаграмма " + props.getId()); + nv.setCNvPr(props); + nv.setCNvPicPr(new CTNonVisualPictureProperties()); + pic.setNvPicPr(nv); + + CTBlipFillProperties blipFill = new CTBlipFillProperties(); + CTBlip blip = new CTBlip(); + blip.setEmbed(relId); + blipFill.setBlip(blip); + CTStretchInfoProperties stretch = new CTStretchInfoProperties(); + stretch.setFillRect(new CTRelativeRect()); + blipFill.setStretch(stretch); + pic.setBlipFill(blipFill); + + CTShapeProperties spPr = new CTShapeProperties(); + CTTransform2D xfrm = new CTTransform2D(); + CTPoint2D off = new CTPoint2D(); + off.setX(0); + off.setY(0); + CTPositiveSize2D ext = new CTPositiveSize2D(); + ext.setCx(cx); + ext.setCy(cy); + xfrm.setOff(off); + xfrm.setExt(ext); + spPr.setXfrm(xfrm); + CTPresetGeometry2D geom = new CTPresetGeometry2D(); + geom.setPrst(STShapeType.RECT); + geom.setAvLst(new CTGeomGuideList()); + spPr.setPrstGeom(geom); + pic.setSpPr(spPr); + + gd.setUri(PICTURE_URI); + gd.getAny().clear(); + gd.getAny().add(pic); + } + + private static String relIdFor(Part part, Part target) { + RelationshipsPart rels = relsOf(part); + if (rels == null || rels.getRelationships() == null) { + return null; + } + var rel = rels.getRel(target.getPartName()); + return rel == null ? null : rel.getId(); + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/PiePainter.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/PiePainter.java new file mode 100644 index 0000000..6332e24 --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/PiePainter.java @@ -0,0 +1,248 @@ +package ru.pjandro.wordpdf.internal.chart; + +import java.awt.BasicStroke; +import java.awt.Color; +import java.awt.Graphics2D; +import java.awt.geom.Arc2D; +import java.awt.geom.Path2D; +import java.awt.geom.Point2D; +import java.awt.geom.Rectangle2D; +import java.util.ArrayList; +import java.util.Comparator; +import java.util.List; + +/** + * Секторная диаграмма: 2D (pie/doughnut) и 3D (pie3D) одним кодом — + * у 2D-варианта глубина экструзии равна нулю. + * + * 3D в Word — это круг, наклонённый на c:view3D/rotX вокруг горизонтальной + * оси, с экструзией вниз. Рисуется художником алгоритма: сектора от задних + * к передним, у каждого сначала боковая стенка и торцы, затем верхняя + * грань. + */ +final class PiePainter { + + /** Доля радиуса, уходящая в глубину при depthPercent=100. */ + private static final double DEPTH_RATIO = 0.22; + + /** + * Word рисует pie3D чуть более «пологим» и с запасом вокруг торта: + * замер по word-export.pdf (300 dpi, область 219,2×149,1 pt) — силуэт 540×316 px, + * ry/rx = 0,475 при rotX=30° (sin 30° = 0,5) и радиус 270 px из + * вписанного 288 px. Без этих поправок торт на 8% выше эталона. + */ + private static final double TILT_CORRECTION = 0.95; + private static final double FIT_MARGIN = 0.865; + + private PiePainter() { + } + + private record Slice(double startDeg, double sweepDeg, Color color, + Color outline, double outlineWidth) { + double midDeg() { + return startDeg + sweepDeg / 2.0; + } + } + + static void paint(Graphics2D g, ChartSpec spec, Rectangle2D box, List palette, + ChartRenderer.Legend legend) { + if (spec.series.isEmpty()) { + return; + } + ChartSpec.Series s = spec.series.get(0); + double total = 0; + for (Double v : s.values) { + if (v != null && v > 0) { + total += v; + } + } + if (total <= 0) { + return; + } + + boolean threeD = spec.type == ChartSpec.Type.PIE3D; + double tilt = threeD ? Math.sin(Math.toRadians(clampRotX(spec.rotX))) * TILT_CORRECTION : 1.0; + double depthPct = threeD ? spec.depthPercent / 100.0 : 0.0; + double depthRatio = DEPTH_RATIO * depthPct; + + // Подбираем радиус так, чтобы эллипс вместе с экструзией влез в box + double rx = Math.min(box.getWidth() / 2.0, + box.getHeight() / (2.0 * tilt + 2.0 * depthRatio)); + rx = Math.max(4, rx * FIT_MARGIN); + double ry = rx * tilt; + double depth = rx * depthRatio; + double cx = box.getCenterX(); + double cy = box.getY() + ry + (box.getHeight() - (2 * ry + depth)) / 2.0; + + List slices = new ArrayList<>(); + double angle = 0; + for (int i = 0; i < s.values.size(); i++) { + Double v = s.values.get(i); + if (v == null || v <= 0) { + continue; + } + double sweep = 360.0 * v / total; + Color fill = s.fillAt(i, palette); + Color outline = s.outlineNoFill ? null + : (s.outlineColor != null ? s.outlineColor : Color.WHITE); + double ow = s.outlineWidth > 0 ? s.outlineWidth : 1.0; + slices.add(new Slice(angle, sweep, fill, outline, ow)); + angle += sweep; + } + + // Задние сектора раньше, передние позже: дальняя сторона торта — + // это 12 часов (midDeg≈0/360, cos≈1), поэтому сортировка по cos + // должна быть убывающей, иначе дальние сектора рисуются поверх + // передних и перекрывают их торцы. + slices.sort(Comparator.comparingDouble( + (Slice sl) -> -Math.cos(Math.toRadians(sl.midDeg())))); + + for (Slice sl : slices) { + drawSlice(g, sl, cx, cy, rx, ry, depth, + spec.type == ChartSpec.Type.DOUGHNUT ? 0.5 : 0.0); + } + } + + private static double clampRotX(double rotX) { + return Math.max(0, Math.min(90, rotX)); + } + + /** + * Один сектор. Углы Word: от 12 часов по часовой. Перевод в параметрический + * угол Java: theta = 90 - wordAngle (y на экране растёт вниз). + */ + private static void drawSlice(Graphics2D g, Slice sl, double cx, double cy, + double rx, double ry, double depth, double holeRatio) { + double thetaStart = 90.0 - sl.startDeg(); + double thetaSweep = -sl.sweepDeg(); + + if (depth > 0.01) { + drawWalls(g, sl, cx, cy, rx, ry, depth); + } + Arc2D.Double top = new Arc2D.Double(cx - rx, cy - ry, 2 * rx, 2 * ry, + thetaStart, thetaSweep, Arc2D.PIE); + g.setColor(sl.color()); + g.fill(top); + if (holeRatio > 0) { + double hrx = rx * holeRatio; + double hry = ry * holeRatio; + Path2D hole = new Path2D.Double(); + hole.append(new Arc2D.Double(cx - hrx, cy - hry, 2 * hrx, 2 * hry, + thetaStart, thetaSweep, Arc2D.PIE), false); + g.setColor(Color.WHITE); + g.fill(hole); + } + if (sl.outline() != null) { + g.setColor(sl.outline()); + g.setStroke(new BasicStroke((float) sl.outlineWidth())); + g.draw(top); + } + } + + /** Боковая стенка дуги + торцы радиальных граней (видимая нижняя половина). */ + private static void drawWalls(Graphics2D g, Slice sl, double cx, double cy, + double rx, double ry, double depth) { + double thetaStart = 90.0 - sl.startDeg(); + double thetaEnd = thetaStart - sl.sweepDeg(); + // Боковая стенка цилиндра в Word освещена сбоку: слева ~0,75 от цвета + // сектора, справа ~0,40 (замер по word-export.pdf, 300 dpi: ×0,71 у x=250, + // ×0,58 у x=440, ×0,40 у x=640). Плоская заливка делает пирог + // «бумажным», поэтому стенку красят горизонтальным градиентом. + Color left = DrawMlColor.darken(sl.color(), 0.25); + Color right = DrawMlColor.darken(sl.color(), 0.60); + + // Видимая часть дуги: sin(theta) < 0 (нижняя половина эллипса) + List visible = visibleArc(thetaStart, thetaEnd); + for (double[] seg : visible) { + Path2D wall = new Path2D.Double(); + boolean first = true; + // шаг 1°: при 4° хорда между точками дуги отстаёт от дуги на + // десятки пикселей (эллипс пологий) и вдоль границы сектора + // остаётся белый клин между стенкой соседнего сектора и торцом + for (double t = seg[0]; t <= seg[1] + 1e-9; t += 1.0) { + Point2D p = point(cx, cy, rx, ry, t); + if (first) { + wall.moveTo(p.getX(), p.getY()); + first = false; + } else { + wall.lineTo(p.getX(), p.getY()); + } + } + Point2D end = point(cx, cy, rx, ry, seg[1]); + wall.lineTo(end.getX(), end.getY() + depth); + for (double t = seg[1]; t >= seg[0] - 1e-9; t -= 1.0) { + Point2D p = point(cx, cy, rx, ry, t); + wall.lineTo(p.getX(), p.getY() + depth); + } + wall.closePath(); + g.setPaint(new java.awt.GradientPaint( + new Point2D.Double(cx - rx, 0), left, + new Point2D.Double(cx + rx, 0), right)); + g.fill(wall); + if (sl.outline() != null) { + g.setColor(sl.outline()); + g.setStroke(new BasicStroke((float) sl.outlineWidth())); + g.draw(wall); + } + } + + // Торцы: радиальные грани на границах сектора. Видна только та грань, + // чья внешняя нормаль смотрит «вверх» по экрану (камера наклонена на + // rotX: грань видна, если её нормаль в плоскости круга имеет + // составляющую к наблюдателю). Для начальной границы сектора внешняя + // нормаль — это dP/dt, для конечной — обратная, отсюда разные признаки + // cos(t). Прежний признак sin(t)<0 рисовал обе грани общей границы + // соседних секторов, и торец дальнего сектора выползал наружу. + for (int e = 0; e < 2; e++) { + double t = e == 0 ? thetaStart : thetaEnd; + double outwardUp = e == 0 ? -Math.cos(Math.toRadians(t)) + : Math.cos(Math.toRadians(t)); + if (outwardUp >= 0 || Math.sin(Math.toRadians(t)) >= 0) { + continue; + } + Point2D p = point(cx, cy, rx, ry, t); + Path2D face = new Path2D.Double(); + face.moveTo(cx, cy); + face.lineTo(p.getX(), p.getY()); + face.lineTo(p.getX(), p.getY() + depth); + face.lineTo(cx, cy + depth); + face.closePath(); + g.setColor(DrawMlColor.darken(sl.color(), 0.30)); + g.fill(face); + if (sl.outline() != null) { + g.setColor(sl.outline()); + g.setStroke(new BasicStroke((float) sl.outlineWidth())); + g.draw(face); + } + } + } + + /** + * Пересечение дуги [a,b] (может идти по убыванию) с нижней полуокружностью + * sin(theta) < 0. Возвращает сегменты в порядке возрастания угла. + */ + private static List visibleArc(double a, double b) { + double lo = Math.min(a, b); + double hi = Math.max(a, b); + List out = new ArrayList<>(); + // нормализуем в [0,360) и идём по виткам + double span = hi - lo; + if (span >= 360) { + out.add(new double[]{lo, lo + 360}); + return out; + } + for (double base = Math.floor(lo / 360.0) * 360.0; base < hi + 360; base += 360.0) { + double segLo = Math.max(lo, base + 180.0); + double segHi = Math.min(hi, base + 360.0); + if (segHi > segLo + 1e-9) { + out.add(new double[]{segLo, segHi}); + } + } + return out; + } + + private static Point2D point(double cx, double cy, double rx, double ry, double thetaDeg) { + double t = Math.toRadians(thetaDeg); + return new Point2D.Double(cx + rx * Math.cos(t), cy - ry * Math.sin(t)); + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/PrstGeomShapes.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/PrstGeomShapes.java new file mode 100644 index 0000000..c0e9a71 --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/PrstGeomShapes.java @@ -0,0 +1,180 @@ +package ru.pjandro.wordpdf.internal.chart; + +import java.awt.geom.Area; +import java.awt.geom.Ellipse2D; +import java.awt.geom.Path2D; +import java.awt.geom.Rectangle2D; +import java.awt.geom.RoundRectangle2D; + +/** + * Пресеты геометрии DrawingML (a:prstGeom) в объёме, который нужен + * SmartArt-схемам: прямоугольники, эллипсы, шестерни и круговые стрелки. + * + * Неизвестный пресет -> прямоугольник (вызывающий логирует подмену): + * для подписанной схемы это заметнее, чем пустое место. + */ +final class PrstGeomShapes { + + private PrstGeomShapes() { + } + + /** Форма с необязательным отверстием (у шестерней — центральная втулка). */ + record Shape(Area area, Area hole) { + Area filled() { + if (hole == null) { + return area; + } + Area a = new Area(area); + a.subtract(hole); + return a; + } + } + + /** + * @param prst имя пресета из a:prstGeom/@prst + * @param adj целочисленные adjs из a:avLst (в стотысячных долях/градусах*60000) + */ + static Shape build(String prst, int[] adj, double x, double y, double w, double h) { + String p = prst == null ? "rect" : prst; + switch (p) { + case "rect" -> { + return new Shape(new Area(new Rectangle2D.Double(x, y, w, h)), null); + } + case "roundRect" -> { + double arc = Math.min(w, h) * 0.12; + return new Shape(new Area(new RoundRectangle2D.Double(x, y, w, h, arc, arc)), null); + } + case "ellipse", "oval" -> { + return new Shape(new Area(new Ellipse2D.Double(x, y, w, h)), null); + } + case "gear6", "gear9" -> { + int teeth = p.equals("gear6") ? 6 : 9; + return gear(x, y, w, h, teeth); + } + case "circularArrow", "leftCircularArrow", "rightCircularArrow", + "curvedRightArrow", "curvedLeftArrow" -> { + return circularArrow(x, y, w, h, adj, + p.equals("leftCircularArrow") || p.equals("curvedLeftArrow")); + } + default -> { + return new Shape(new Area(new Rectangle2D.Double(x, y, w, h)), null); + } + } + } + + /** + * Шестерня: зубчатый венец + (опционально) центральное отверстие. + * Внешний радиус немного меньше w/2 (× 0.92), чтобы соседние + * шестерни в drawing1.xml не слипались там, где их ext-ы близко + * (Word использует тот же приём — эффективный радиус ≈ 0.97·ext/2). + * Зуб узкий и короткий, впадины — глубокие. + */ + private static Shape gear(double x, double y, double w, double h, int teeth) { + double cx = x + w / 2.0; + double cy = y + h / 2.0; + double r = Math.min(w, h) / 2.0 * 0.82; + double toothH = r * 0.18; + double body = r - toothH; + Path2D path = new Path2D.Double(); + double step = 2 * Math.PI / teeth; + // зуб: основание -> подъём -> вершина (плоская) -> спуск + double toothWidth = step * 0.30; + for (int i = 0; i < teeth; i++) { + double a = i * step; + double a0 = a - toothWidth; + double a1 = a + toothWidth; + double gap1 = a + step - toothWidth; + if (i == 0) { + path.moveTo(cx + body * Math.cos(a0), cy + body * Math.sin(a0)); + } else { + path.lineTo(cx + body * Math.cos(a0), cy + body * Math.sin(a0)); + } + path.lineTo(cx + r * Math.cos(a0 + toothWidth * 0.5), + cy + r * Math.sin(a0 + toothWidth * 0.5)); + path.lineTo(cx + r * Math.cos(a1 - toothWidth * 0.5), + cy + r * Math.sin(a1 - toothWidth * 0.5)); + path.lineTo(cx + body * Math.cos(a1), cy + body * Math.sin(a1)); + // впадина: плоская дуга по body между зубьями + path.lineTo(cx + body * Math.cos(gap1), cy + body * Math.sin(gap1)); + } + path.closePath(); + return new Shape(new Area(path), null); + } + + /** + * Круговая стрелка: сектор кольца + треугольный наконечник. + * adj2/adj3 — углы начала/конца в 1/60000 градуса (0 = на 3 часа, + * по часовой, т.к. y на экране растёт вниз). + */ + private static Shape circularArrow(double x, double y, double w, double h, + int[] adj, boolean arrowAtStart) { + double cx = x + w / 2.0; + double cy = y + h / 2.0; + double rOuter = Math.min(w, h) / 2.0 * 0.92; + // adj1 у реальных схем даёт невидимую полоску — держим минимум. + double thickness = Math.max(rOuter * pct(adj, 0, 40000), rOuter * 0.07); + double rInner = Math.max(1, rOuter - thickness); + double startDeg = deg(adj, 1, 2700000); + double endDeg = deg(adj, 2, 3600000); + if (Math.abs(endDeg - startDeg) < 1) { + endDeg = startDeg + 270; + } + + double a0 = Math.toRadians(startDeg); + double a1 = Math.toRadians(endDeg); + if (a1 < a0) { + a1 += 2 * Math.PI; + } + Path2D path = new Path2D.Double(); + arcSegment(path, cx, cy, rOuter, a0, a1, true); + arcSegment(path, cx, cy, rInner, a1, a0, false); + path.closePath(); + Area area = new Area(path); + + // Наконечник: размеры берём от толщины кольца — adjs у реальных + // схем (adj4/adj5) дают либо абсурдный угол, либо невидимый «усик». + // headOut ограничен, чтобы он не вылезал сильно за rOuter (иначе + // кольцо цепляется с шестерёнкой, центр которой совпадает со стрелкой). + double rMid = (rOuter + rInner) / 2.0; + double headOut = Math.min(thickness * 1.15, thickness * 2.0); + double tipAngle = arrowAtStart ? a0 - thickness * 1.7 / rMid : a1 + thickness * 1.7 / rMid; + double baseAngle = thickness * 0.9 / rMid; + double base = arrowAtStart ? a0 : a1; + Path2D head = new Path2D.Double(); + head.moveTo(cx + (rOuter + headOut * 0.2) * Math.cos(base - Math.copySign(baseAngle, base - tipAngle)), + cy + (rOuter + headOut * 0.2) * Math.sin(base - Math.copySign(baseAngle, base - tipAngle))); + head.lineTo(cx + rMid * Math.cos(tipAngle), cy + rMid * Math.sin(tipAngle)); + head.lineTo(cx + Math.max(1, rInner - headOut) * Math.cos(base - Math.copySign(baseAngle, base - tipAngle)), + cy + Math.max(1, rInner - headOut) * Math.sin(base - Math.copySign(baseAngle, base - tipAngle))); + head.closePath(); + area.add(new Area(head)); + return new Shape(area, null); + } + + private static void arcSegment(Path2D path, double cx, double cy, double r, + double a0, double a1, boolean forward) { + int steps = Math.max(2, (int) (Math.abs(a1 - a0) / Math.toRadians(4))); + for (int i = 0; i <= steps; i++) { + double t = a0 + (a1 - a0) * i / steps; + double px = cx + r * Math.cos(t); + double py = cy + r * Math.sin(t); + if (i == 0 && (path.getCurrentPoint() == null + || Math.abs(path.getCurrentPoint().getX() - px) > 1e-9 + || Math.abs(path.getCurrentPoint().getY() - py) > 1e-9)) { + path.moveTo(px, py); + } else { + path.lineTo(px, py); + } + } + } + + private static double pct(int[] adj, int idx, int def) { + int v = adj != null && idx < adj.length ? adj[idx] : def; + return v / 100000.0; + } + + private static double deg(int[] adj, int idx, int def) { + int v = adj != null && idx < adj.length ? adj[idx] : def; + return v / 60000.0; + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/RgbHsl.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/RgbHsl.java new file mode 100644 index 0000000..746fe48 --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/RgbHsl.java @@ -0,0 +1,80 @@ +package ru.pjandro.wordpdf.internal.chart; + +import java.awt.Color; + +/** + * Конвертация RGB <-> HSL. Нужна для трансформаций цвета из DrawingML + * (lumMod/lumOff/satMod/hueOff работают в пространстве тона/насыщенность/ + * светлота, а не в RGB). + */ +final class RgbHsl { + + private RgbHsl() { + } + + /** @return {hue 0..360, saturation 0..1, luminance 0..1} */ + static double[] toHsl(Color c) { + double r = c.getRed() / 255.0; + double g = c.getGreen() / 255.0; + double b = c.getBlue() / 255.0; + double max = Math.max(r, Math.max(g, b)); + double min = Math.min(r, Math.min(g, b)); + double l = (max + min) / 2.0; + double h = 0.0; + double s = 0.0; + if (max != min) { + double d = max - min; + s = l > 0.5f ? d / (2f - max - min) : d / (max + min); + if (max == r) { + h = (g - b) / d + (g < b ? 6f : 0f); + } else if (max == g) { + h = (b - r) / d + 2f; + } else { + h = (r - g) / d + 4f; + } + h *= 60.0; + } + return new double[]{h, s, l}; + } + + static Color fromHsl(double h, double s, double l) { + double hh = (((h % 360) + 360) % 360) / 360.0; + double ss = Math.max(0, Math.min(1, s)); + double ll = Math.max(0, Math.min(1, l)); + double r, g, b; + if (ss == 0.0) { + r = g = b = ll; + } else { + double q = ll < 0.5 ? ll * (1.0 + ss) : ll + ss - ll * ss; + double p = 2.0 * ll - q; + r = hueToRgb(p, q, hh + 1.0 / 3.0); + g = hueToRgb(p, q, hh); + b = hueToRgb(p, q, hh - 1.0 / 3.0); + } + return new Color(clamp(Math.round(r * 255)), + clamp(Math.round(g * 255)), clamp(Math.round(b * 255))); + } + + private static int clamp(long v) { + return (int) Math.max(0, Math.min(255, v)); + } + + private static double hueToRgb(double p, double q, double t) { + if (t < 0.0) { + t += 1.0; + } + if (t > 1.0) { + t -= 1.0; + } + if (t < 1.0 / 6.0) { + return p + (q - p) * 6.0 * t; + } + if (t < 0.5) { + return q; + } + if (t < 2.0 / 3.0) { + return p + (q - p) * (2.0 / 3.0 - t) * 6.0; + } + return p; + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/SmartArtRenderer.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/SmartArtRenderer.java new file mode 100644 index 0000000..03c9e2d --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/SmartArtRenderer.java @@ -0,0 +1,336 @@ +package ru.pjandro.wordpdf.internal.chart; + +import org.docx4j.dml.CTGeomGuide; +import org.docx4j.dml.CTGradientFillProperties; +import org.docx4j.dml.CTGradientStop; +import org.docx4j.dml.CTPoint2D; +import org.docx4j.dml.CTPositiveSize2D; +import org.docx4j.dml.CTPresetGeometry2D; +import org.docx4j.dml.CTShapeProperties; +import org.docx4j.dml.CTShapeStyle; +import org.docx4j.dml.CTTextBody; +import org.docx4j.dml.CTTransform2D; +import org.docx4j.dml.diagram.CTCxn; +import org.docx4j.dml.diagram.CTDataModel; +import org.docx4j.dml.diagram.STCxnType; +import org.docx4j.dml.diagram.CTElemPropSet; +import org.docx4j.dml.diagram.CTPt; +import org.docx4j.dml.diagram2008.CTDrawing; +import org.docx4j.dml.diagram2008.CTShape; + +import java.awt.BasicStroke; +import java.awt.Color; +import java.awt.Graphics2D; +import java.awt.RenderingHints; +import java.awt.geom.AffineTransform; +import java.awt.geom.Area; +import java.awt.geom.Rectangle2D; +import java.awt.image.BufferedImage; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +/** + * SmartArt в растр. Рисуется {@code word/diagrams/drawing1.xml} — это + * кэш уже разложенной Word-ом схемы: у каждой фигуры есть абсолютная + * позиция, пресет геометрии, заливка, обводка и текст. Поэтому + * собственный движок раскладки SmartArt не нужен. + * + * Пустые подписи фигур Word показывает текстом-заполнителем из + * {@code data1.xml} (dgm:pt/dgm:prSet/@phldrT) — его берём оттуда же. + */ +final class SmartArtRenderer { + + static final int DPI = ChartRenderer.DPI; + + private SmartArtRenderer() { + } + + private record Item(CTShape shape, double x, double y, double w, double h, double rotDeg) { + } + + static BufferedImage render(CTDrawing drawing, CTDataModel data, DrawMlColor colors, + double widthPt, double heightPt) { + List items = new ArrayList<>(); + for (Object o : drawing.getSpTree().getSpOrGrpSp()) { + if (!(o instanceof CTShape sp)) { + continue; + } + CTTransform2D t = sp.getSpPr() == null ? null : sp.getSpPr().getXfrm(); + if (t == null || t.getExt() == null) { + continue; + } + CTPoint2D off = t.getOff(); + CTPositiveSize2D ext = t.getExt(); + double rot = t.getRot() / 60000.0; + items.add(new Item(sp, + (off == null ? 0 : off.getX()) / 12700.0, + (off == null ? 0 : off.getY()) / 12700.0, + ext.getCx() / 12700.0, + ext.getCy() / 12700.0, + rot)); + } + int w = Math.max(16, (int) Math.round(widthPt * DPI / 72.0)); + int h = Math.max(16, (int) Math.round(heightPt * DPI / 72.0)); + BufferedImage img = new BufferedImage(w, h, BufferedImage.TYPE_INT_ARGB); + Graphics2D g = img.createGraphics(); + try { + g.setRenderingHint(RenderingHints.KEY_ANTIALIASING, + RenderingHints.VALUE_ANTIALIAS_ON); + g.setRenderingHint(RenderingHints.KEY_TEXT_ANTIALIASING, + RenderingHints.VALUE_TEXT_ANTIALIAS_ON); + g.setRenderingHint(RenderingHints.KEY_STROKE_CONTROL, + RenderingHints.VALUE_STROKE_PURE); + g.scale(DPI / 72.0, DPI / 72.0); + if (items.isEmpty()) { + return img; + } + double minX = Double.MAX_VALUE; + double minY = Double.MAX_VALUE; + double maxX = -Double.MAX_VALUE; + double maxY = -Double.MAX_VALUE; + for (Item it : items) { + minX = Math.min(minX, it.x()); + minY = Math.min(minY, it.y()); + maxX = Math.max(maxX, it.x() + it.w()); + maxY = Math.max(maxY, it.y() + it.h()); + } + double mw = Math.max(1e-6, maxX - minX); + double mh = Math.max(1e-6, maxY - minY); + // 0.80: drawing1.xml хранит ext-ы вплотную (gear6+gear6, + // gear6+circularArrow с почти одним центром), при scale=0.96 + // они слипаются. 0.80 даёт зазор ~10% от ext — как в эталоне. + double scale = Math.min(widthPt / mw, heightPt / mh) * 0.80; + double offX = (widthPt - mw * scale) / 2.0 - minX * scale; + double offY = (heightPt - mh * scale) / 2.0 - minY * scale; + + Map placeholders = placeholders(data); + for (Item it : items) { + drawShape(g, it, colors, scale, offX, offY, placeholders); + } + } finally { + g.dispose(); + } + return img; + } + + /** + * Подписи-заполнители. Форма в drawing1.xml ссылается на dgm:pt + * type="pres", а phldrT лежит на dgm:pt type="node" — их связывает + * dgm:cxn type="presOf" (srcId=node, destId=pres). + */ + private static Map placeholders(CTDataModel data) { + Map out = new HashMap<>(); + if (data == null || data.getPtLst() == null) { + return out; + } + Map byId = new HashMap<>(); + for (CTPt pt : data.getPtLst().getPt()) { + if (pt.getModelId() != null) { + byId.put(pt.getModelId(), pt); + } + } + if (data.getCxnLst() != null) { + for (CTCxn cxn : data.getCxnLst().getCxn()) { + if (cxn.getType() != STCxnType.PRES_OF || cxn.getDestId() == null) { + continue; + } + String text = phldrOf(byId.get(cxn.getSrcId())); + if (text != null) { + out.put(cxn.getDestId(), text); + } + } + } + for (CTPt pt : data.getPtLst().getPt()) { + String text = phldrOf(pt); + if (text != null && pt.getModelId() != null) { + out.putIfAbsent(pt.getModelId(), text); + } + } + return out; + } + + private static String phldrOf(CTPt pt) { + if (pt == null || pt.getPrSet() == null || pt.getPrSet().getPhldrT() == null) { + return null; + } + String text = pt.getPrSet().getPhldrT(); + return text.isBlank() ? null : text; + } + + private static void drawShape(Graphics2D g, Item it, DrawMlColor colors, + double scale, double offX, double offY, + Map placeholders) { + CTShape sp = it.shape(); + CTShapeProperties spPr = sp.getSpPr(); + double x = it.x() * scale + offX; + double y = it.y() * scale + offY; + double sw = it.w() * scale; + double sh = it.h() * scale; + + AffineTransform saved = g.getTransform(); + if (Math.abs(it.rotDeg()) > 0.01) { + g.rotate(Math.toRadians(it.rotDeg()), x + sw / 2.0, y + sh / 2.0); + } + + String prst = null; + int[] adj = new int[0]; + if (spPr != null && spPr.getPrstGeom() != null) { + CTPresetGeometry2D pg = spPr.getPrstGeom(); + prst = pg.getPrst() == null ? null : pg.getPrst().value(); + if (pg.getAvLst() != null) { + List gd = pg.getAvLst().getGd(); + adj = new int[gd.size()]; + for (int i = 0; i < gd.size(); i++) { + adj[i] = parseGuide(gd.get(i).getFmla()); + } + } + } + PrstGeomShapes.Shape shape = PrstGeomShapes.build(prst, adj, x, y, sw, sh); + Area area = shape.filled(); + + Color fill = resolveFill(spPr, colors); + if (fill != null) { + g.setColor(fill); + g.fill(area); + } + Color lineColor = null; + double lineWidth = 1.0; + if (spPr != null && spPr.getLn() != null) { + if (spPr.getLn().getNoFill() == null) { + lineColor = spPr.getLn().getSolidFill() != null + ? colors.resolveFill(spPr.getLn().getSolidFill()) + : colors.schemeColor("lt1"); + } + if (spPr.getLn().getW() != null) { + lineWidth = spPr.getLn().getW() / 12700.0; + } + } else if (sp.getStyle() != null && sp.getStyle().getLnRef() != null + && sp.getStyle().getLnRef().getIdx() > 0) { + // стиль-матрица: тонкая светлая обводка + lineColor = colors.schemeColor("lt1"); + lineWidth = 1.0; + } + if (lineColor != null) { + g.setColor(lineColor); + g.setStroke(new BasicStroke((float) Math.max(0.4, lineWidth * scale))); + g.draw(area); + } + g.setTransform(saved); + + // Текст: собственный прямоугольник (dsp:txXfrm) или границы фигуры + double tx = x; + double ty = y; + double tw = sw; + double th = sh; + CTTransform2D txXfrm = sp.getTxXfrm(); + if (txXfrm != null && txXfrm.getExt() != null) { + CTPoint2D o = txXfrm.getOff(); + tx = (o == null ? 0 : o.getX()) / 12700.0 * scale + offX; + ty = (o == null ? 0 : o.getY()) / 12700.0 * scale + offY; + tw = txXfrm.getExt().getCx() / 12700.0 * scale; + th = txXfrm.getExt().getCy() / 12700.0 * scale; + } + + Color textColor = textColor(sp, colors); + List paragraphs = new ArrayList<>(); + if (sp.getTxBody() != null) { + paragraphs = DrawMlText.paragraphs(sp.getTxBody(), colors, + colors.minorFontName(), 12, textColor); + } + if (paragraphs.isEmpty() && sp.getModelId() != null) { + String ph = placeholders.get(sp.getModelId()); + if (ph != null) { + paragraphs = List.of(new DrawMlText.Paragraph(ph, + new DrawMlText.Style(9, false, false, textColor, + colors.minorFontName()), "ctr")); + } + } + if (paragraphs.isEmpty()) { + return; + } + // Шрифт из XML (sz=2600 → 26pt) слишком крупный для маленьких + // шестерёнок SmartArt: "123" лезет поверх зубьев. Ограничиваем + // начальный кегль ~25% меньшей стороны текстового прямоугольника. + double capPt = Math.max(4.0, Math.min(tw, th) * 0.25); + if (p0(paragraphs) > capPt) { + List shrunk = new ArrayList<>(); + for (DrawMlText.Paragraph p : paragraphs) { + shrunk.add(new DrawMlText.Paragraph(p.text(), + p.style().derive(capPt, null, null, null, null), p.align())); + } + paragraphs = shrunk; + } + // autosize: уменьшаем кегль, пока текст не влезет в прямоугольник + for (int attempt = 0; attempt < 4; attempt++) { + double needed = 0; + for (DrawMlText.Paragraph p : paragraphs) { + needed += DrawMlText.textHeight(p.style(), g.getFontRenderContext()); + } + if (needed <= th || p0(paragraphs) <= 4) { + break; + } + double factor = th / needed; + List shrunk = new ArrayList<>(); + for (DrawMlText.Paragraph p : paragraphs) { + shrunk.add(new DrawMlText.Paragraph(p.text(), + p.style().derive(p.style().sizePt() * factor, + null, null, null, null), p.align())); + } + paragraphs = shrunk; + } + DrawMlText.paint(g, paragraphs, new Rectangle2D.Double(tx, ty, tw, th), + "ctr", "ctr", 1.0); + } + + private static double p0(List ps) { + return ps.isEmpty() ? 0 : ps.get(0).style().sizePt(); + } + + private static Color resolveFill(CTShapeProperties spPr, DrawMlColor colors) { + if (spPr == null) { + return null; + } + if (spPr.getNoFill() != null) { + return null; + } + if (spPr.getSolidFill() != null) { + return colors.resolveFill(spPr.getSolidFill()); + } + CTGradientFillProperties grad = spPr.getGradFill(); + if (grad != null && grad.getGsLst() != null && !grad.getGsLst().getGs().isEmpty()) { + List stops = grad.getGsLst().getGs(); + Color mid = colors.resolveStop(stops.get(stops.size() / 2)); + return mid != null ? mid : colors.resolveStop(stops.get(0)); + } + return null; + } + + private static Color textColor(CTShape sp, DrawMlColor colors) { + CTShapeStyle style = sp.getStyle(); + if (style != null && style.getFontRef() != null) { + Color resolved = colors.resolveFontRef(style.getFontRef()); + if (resolved != null) { + return resolved; + } + } + return new Color(0x59, 0x59, 0x59); + } + + /** a:gd/@fmla = "val 4687" -> 4687. */ + private static int parseGuide(String fmla) { + if (fmla == null) { + return 0; + } + String s = fmla.trim(); + if (s.startsWith("val")) { + s = s.substring(3).trim(); + } + try { + return Integer.parseInt(s); + } catch (NumberFormatException e) { + return 0; + } + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Surface3dPainter.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Surface3dPainter.java new file mode 100644 index 0000000..18b27a4 --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Surface3dPainter.java @@ -0,0 +1,537 @@ +package ru.pjandro.wordpdf.internal.chart; + +import java.awt.BasicStroke; +import java.awt.Color; +import java.awt.Graphics2D; +import java.awt.geom.Path2D; +import java.awt.geom.Rectangle2D; +import java.util.ArrayList; +import java.util.Comparator; +import java.util.List; + +/** + * Объёмная поверхностная диаграмма (c:surface3D). + * + * Модель: u — категория (ширина), v — ряд (глубина), w — значение (высота), + * всё в [-0.5, 0.5]. Порядок преобразований: поворот сцены вокруг вертикали + * на c:view3D/rotY, наклон камеры на rotX, затем перспектива по + * c:view3D/perspective (по умолчанию 30°) с глубиной c:view3D/depth. + * + * Грани — ровно ячейки исходной сетки (без передискретизации): каждая + * разбивается на два треугольника, цвет берётся из полосы высот + * (c:bandFmts) и затемняется по нормали грани — именно это даёт объём, + * как в Word. Порядок отрисовки — painter's algorithm по глубине + * центроида треугольника. + */ +final class Surface3dPainter { + + /** + * Расстояние камеры сцены (в долях ширины коробки построения). + * `c:view3D/perspective` (по умолчанию 30) — это НЕ угол обзора, а + * коэффициент глубины: он масштабирует расстояние относительно + * эталонных 30. Значение откалибровано по эталону Word + * (см. Surface3dPainterTest.cameraMatchesWordReference). + */ + static final double CAMERA_DISTANCE = 2.36; + + /** + * Глубина коробки построения относительно ширины (при c:view3D/depth = 100). + * Заметно больше «наивной» четверти ширины: Word уходит в глубину почти + * на две трети, иначе лента выглядит плоской, а шаг оси рядов + * (Ряд 1 → Ряд 2) выходит на треть меньше эталона. + */ + static final double DEPTH_RATIO = 0.705; + + /** Высота значений относительно аспекта области построения. */ + static final double HEIGHT_RATIO = 0.664; + + /** + * Поля вокруг коробки построения — доли области построения (box без + * заголовка и легенды): слева/справа под подписи осей значений и рядов, + * сверху/снизу — отступы Word. Коробка занимает ~73% ширины области: + * при полях «на глаз» (30/44 pt) поверхность растягивалась на 82% + * ширины и лезла на подписи оси значений. + */ + static final double GUTTER_LEFT = 0.1485; + static final double GUTTER_RIGHT = 0.1485; + static final double GUTTER_TOP = 0.116; + static final double GUTTER_BOTTOM = 0.146; + + /** + * Направление света в экранных координатах: x вправо, y «в экран», + * z «на зрителя». Подобрано по квантилям множителей яркости граней + * эталона Word (см. Surface3dPainterTest.shadingMatchesWordReference). + */ + private static final double LIGHT_X = 0.83; + private static final double LIGHT_Y = 0.48; + private static final double LIGHT_Z = 0.28; + + private Surface3dPainter() { + } + + /** Проекция узла: экранные координаты модельного пространства + глубина. */ + record Node(double x, double y, double depth) { + } + + private record Tri(Path2D path, Color color, double depth) { + } + + /** Вписывание модельно-экранных координат в box. */ + private record Fit(double scaleX, double scaleY, double offX, double offY) { + } + + static void paint(Graphics2D g, ChartSpec spec, Rectangle2D box, List palette) { + int nSer = spec.series.size(); + int nCat = 0; + for (ChartSpec.Series s : spec.series) { + nCat = Math.max(nCat, s.values.size()); + } + if (nSer < 2 || nCat < 2) { + return; + } + double[][] z = new double[nSer][nCat]; + double min = Double.MAX_VALUE; + double max = -Double.MAX_VALUE; + for (int r = 0; r < nSer; r++) { + for (int c = 0; c < nCat; c++) { + List vals = spec.series.get(r).values; + double v = c < vals.size() && vals.get(c) != null ? vals.get(c) : 0; + z[r][c] = v; + min = Math.min(min, v); + max = Math.max(max, v); + } + } + ChartSpec.AxisSpec valAxis = spec.valAxis != null ? spec.valAxis : new ChartSpec.AxisSpec(); + double[] bounds = ChartRenderer.axisBounds(valAxis, min, max); + double lo = bounds[0]; + double hi = bounds[1]; + double unit = bounds[2]; + double span = Math.max(1e-9, hi - lo); + + double rotX = Math.toRadians(spec.rotX); + // Знак rotY в DrawingML обратный правому правилу вокруг вертикали: + // положительный поворот приближает к зрителю правый край, поэтому + // передняя кромка («Категория 1 → Категория 4») идёт вниз вправо. + double rotY = -Math.toRadians(spec.rotY); + double persp = spec.perspective; + + // Пропорции «коробки» построения, снятые с эталона Word: глубина — + // DEPTH_RATIO ширины (c:view3D/depth от неё), высота значений — + // HEIGHT_RATIO·availH/availW. Оба коэффициента откалиброваны + // Surface3dPainterTest.cameraMatchesWordReference по замерам + // стр. 3 word-export.pdf (уклон передней кромки, аспект силуэта, шаг оси + // значений и шаг оси рядов). Подменять их Math.max с множителем + // availH/availW·1.0 нельзя: это даёт +56% к высоте и превращает + // ленту в гору. + double leftGutter = GUTTER_LEFT * box.getWidth(); + double rightGutter = GUTTER_RIGHT * box.getWidth(); + double bottomGutter = GUTTER_BOTTOM * box.getHeight(); + double topGutter = GUTTER_TOP * box.getHeight(); + double availW = Math.max(10, box.getWidth() - leftGutter - rightGutter); + double availH = Math.max(10, box.getHeight() - bottomGutter - topGutter); + double depthScale = DEPTH_RATIO * Math.max(0.05, spec.depthPercent / 100.0); + double heightScale = HEIGHT_RATIO * availH / availW; + + // 1. Узлы сетки и пол — в модельно-экранные координаты + Node[][] node = new Node[nSer][nCat]; + double minX = Double.MAX_VALUE; + double maxX = -Double.MAX_VALUE; + double minY = Double.MAX_VALUE; + double maxY = -Double.MAX_VALUE; + for (int r = 0; r < nSer; r++) { + for (int c = 0; c < nCat; c++) { + node[r][c] = project(uOf(c, nCat), vOf(r, nSer), + ((z[r][c] - lo) / span - 0.5) * heightScale, rotX, rotY, depthScale, persp); + minX = Math.min(minX, node[r][c].x()); + maxX = Math.max(maxX, node[r][c].x()); + minY = Math.min(minY, node[r][c].y()); + maxY = Math.max(maxY, node[r][c].y()); + } + } + double floorW = -0.5 * heightScale; + Node[] floor = { + project(-0.5, -0.5, floorW, rotX, rotY, depthScale, persp), + project(0.5, -0.5, floorW, rotX, rotY, depthScale, persp), + project(0.5, 0.5, floorW, rotX, rotY, depthScale, persp), + project(-0.5, 0.5, floorW, rotX, rotY, depthScale, persp), + }; + // Ось значений привязана к переднему левому ребру левой стенки + // (v = -0.5), а не к дальней стенке: у дальней стенки ребро дальше + // от камеры, и подписи уезжают внутрь поверхности. + List valueAnchors = new ArrayList<>(); + for (double v = lo; v <= hi + unit / 2; v += unit) { + Node n = project(-0.5, -0.5, ((v - lo) / span - 0.5) * heightScale, + rotX, rotY, depthScale, persp); + valueAnchors.add(n); + minX = Math.min(minX, n.x()); + maxX = Math.max(maxX, n.x()); + minY = Math.min(minY, n.y()); + maxY = Math.max(maxY, n.y()); + } + for (Node n : floor) { + minX = Math.min(minX, n.x()); + maxX = Math.max(maxX, n.x()); + minY = Math.min(minY, n.y()); + maxY = Math.max(maxY, n.y()); + } + + // 2. Вписывание в box равномерным масштабом: коробка уже задана + // в пропорциях области построения, поэтому растягивать x и y + // раздельно нельзя — это ломает перспективу. + double scale = Math.min(availW / Math.max(1e-6, maxX - minX), + availH / Math.max(1e-6, maxY - minY)); + double offX = box.getX() + leftGutter + + (availW - (maxX - minX) * scale) / 2 - minX * scale; + double offY = box.getY() + topGutter + + (availH - (maxY - minY) * scale) / 2 - minY * scale; + Fit fit = new Fit(scale, scale, offX, offY); + + // 3. Пол, дальняя стенка и их сетки — под поверхностью + drawFloor(g, spec, floor, valueAnchors, nCat, nSer, lo, hi, unit, span, + rotX, rotY, depthScale, heightScale, persp, fit); + + // 4. Грани: два треугольника на ячейку, каждый разрезан по + // горизонтальным плоскостям полос (c:bandFmts) — Word красит + // полосу по высоте, а не весь треугольник по среднему значению. + List tris = new ArrayList<>(); + double spanUnit = unit / span; + int bandCount = Math.max(1, (int) Math.ceil(span / unit - 1e-9)); + for (int r = 0; r + 1 < nSer; r++) { + for (int c = 0; c + 1 < nCat; c++) { + double u0 = uOf(c, nCat); + double u1 = uOf(c + 1, nCat); + double v0 = vOf(r, nSer); + double v1 = vOf(r + 1, nSer); + // u — категория, v — ряд: (u_c, v_r) <-> z[r][c]. + // Перепутать w01/w10 значит закрутить квад в «бабочку»: + // в проекции появляются дыры и самопересечения граней. + double w00 = ((z[r][c] - lo) / span - 0.5) * heightScale; + double w01 = ((z[r + 1][c] - lo) / span - 0.5) * heightScale; + double w11 = ((z[r + 1][c + 1] - lo) / span - 0.5) * heightScale; + double w10 = ((z[r][c + 1] - lo) / span - 0.5) * heightScale; + // Диагональ — та, чьи концы выше (сумма значений больше). Седловая + // ячейка в проекции вогнутая, и фиксированная диагональ даёт то + // грань не той полосы, то треугольник внутри треугольника. Word + // всегда видит верхнюю огибающую седла: при w00+w11 < w01+w10 он + // режет квад по w01–w10 (эталон word-export.pdf, стр. 3: ячейка + // Ряд 1→2 / Категория 2→3 там полоса 3–4, а не 2–3). + boolean mainDiagonal = z[r][c] + z[r + 1][c + 1] >= z[r + 1][c] + z[r][c + 1]; + if (mainDiagonal) { + addTri(tris, spec, palette, + new double[][]{{u0, v0, w00}, {u0, v1, w01}, {u1, v1, w11}}, + spanUnit * heightScale, heightScale, bandCount, + rotX, rotY, depthScale, persp, fit); + addTri(tris, spec, palette, + new double[][]{{u0, v0, w00}, {u1, v1, w11}, {u1, v0, w10}}, + spanUnit * heightScale, heightScale, bandCount, + rotX, rotY, depthScale, persp, fit); + } else { + addTri(tris, spec, palette, + new double[][]{{u0, v0, w00}, {u0, v1, w01}, {u1, v0, w10}}, + spanUnit * heightScale, heightScale, bandCount, + rotX, rotY, depthScale, persp, fit); + addTri(tris, spec, palette, + new double[][]{{u0, v1, w01}, {u1, v1, w11}, {u1, v0, w10}}, + spanUnit * heightScale, heightScale, bandCount, + rotX, rotY, depthScale, persp, fit); + } + } + } + tris.sort(Comparator.comparingDouble(Tri::depth).reversed()); + BasicStroke seam = new BasicStroke(0.4f); + for (Tri t : tris) { + g.setColor(t.color()); + g.fill(t.path()); + g.setStroke(seam); + g.draw(t.path()); + } + if (spec.wireframe) { + g.setColor(new Color(0x80, 0x80, 0x80)); + g.setStroke(new BasicStroke(0.5f)); + for (Tri t : tris) { + g.draw(t.path()); + } + } + + // 5. Подписи осей + drawLabels(g, spec, valueAnchors, lo, hi, unit, nCat, nSer, + rotX, rotY, depthScale, heightScale, persp, fit); + } + + /** + * Один треугольник ячейки: нормаль (и, как следствие, затемнение) считается + * по исходному треугольнику, а сам он режется плоскостями полос высот — + * поэтому одна грань может быть окрашена в два цвета, как в Word. + * + * @param pts три вершины в модельных координатах {u, v, w} + * @param wUnit ширина полосы в нормализованных координатах высоты + */ + private static void addTri(List tris, ChartSpec spec, List palette, + double[][] pts, double wUnit, double hScale, int bandCount, + double rotX, double rotY, double depthScale, double persp, + Fit fit) { + // v здесь ещё не умножен на depthScale (это делает project), а w уже + // умножен на hScale. Без того же масштаба в нормали поверхность кажется + // положе, чем она есть, и все грани попадают в светлую часть Lambert. + double e1x = pts[1][0] - pts[0][0]; + double e1y = (pts[1][1] - pts[0][1]) * depthScale; + double e1z = pts[1][2] - pts[0][2]; + double e2x = pts[2][0] - pts[0][0]; + double e2y = (pts[2][1] - pts[0][1]) * depthScale; + double e2z = pts[2][2] - pts[0][2]; + double nx = e1y * e2z - e1z * e2y; + double ny = e1z * e2x - e1x * e2z; + double nz = e1x * e2y - e1y * e2x; + double len = Math.hypot(Math.hypot(nx, ny), nz); + if (len < 1e-12) { + return; + } + nx /= len; + ny /= len; + nz /= len; + if (nz < 0) { + nx = -nx; + ny = -ny; + nz = -nz; + } + // та же ориентация, что и у точек (перспектива на нормаль не влияет) + double ca = Math.cos(rotY); + double sa = Math.sin(rotY); + double nx1 = nx * ca - ny * sa; + double ny1 = nx * sa + ny * ca; + double cb = Math.cos(rotX); + double sb = Math.sin(rotX); + double ny2 = ny1 * cb - nz * sb; + double nz2 = ny1 * sb + nz * cb; + double dot = nx1 * LIGHT_X + ny2 * LIGHT_Y + nz2 * LIGHT_Z; + // Word красит грани дискретными множителями цвета полосы; в эталоне + // (word-export.pdf, 300 dpi, гистограмма цветов граней) это 0,40 / 0,75 / 0,85 / + // 1,04 / 1,06 / 1,10. Тёмная группа 0,40 — узкая полоска underside под + // передним краем ленты; разгон Lambert до неё (отрицательные dot, + // 0,69 + 1,23·dot) затемняет слишком большие площади и ухудшает + // совпадение с эталоном (17,2 → 17,6 средних расхождений на пиксель), + // поэтому нижний кламп 0,80. Направление света перебрано по 120 + // направлениям — текущее лучшее. + double brightness = Math.min(1.25, Math.max(0.80, 0.92 + 0.88 * dot)); + + List bands = spec.bandColors.isEmpty() ? palette : spec.bandColors; + double wLo = Math.min(Math.min(pts[0][2], pts[1][2]), pts[2][2]); + double wHi = Math.max(Math.max(pts[0][2], pts[1][2]), pts[2][2]); + double wBase = -0.5 * hScale; + int kLo = Math.max(0, (int) Math.floor((wLo - wBase) / wUnit)); + int kHi = Math.min(bandCount - 1, (int) Math.floor((wHi - wBase) / wUnit)); + for (int k = kLo; k <= kHi; k++) { + double a = wBase + k * wUnit; + double b = wBase + (k + 1) * wUnit; + List piece = clipW(List.of(pts[0], pts[1], pts[2]), a, b); + if (piece.size() < 3) { + continue; + } + Path2D path = new Path2D.Double(); + double depth = 0; + for (int i = 0; i < piece.size(); i++) { + double[] p = piece.get(i); + Node n = project(p[0], p[1], p[2], rotX, rotY, depthScale, persp); + if (i == 0) { + path.moveTo(n.x() * fit.scaleX() + fit.offX(), n.y() * fit.scaleY() + fit.offY()); + } else { + path.lineTo(n.x() * fit.scaleX() + fit.offX(), n.y() * fit.scaleY() + fit.offY()); + } + depth += n.depth(); + } + path.closePath(); + Color base = bands.get(k % bands.size()); + Color shaded = new Color( + Math.min(255, (int) Math.round(base.getRed() * brightness)), + Math.min(255, (int) Math.round(base.getGreen() * brightness)), + Math.min(255, (int) Math.round(base.getBlue() * brightness))); + tris.add(new Tri(path, shaded, depth / piece.size())); + } + } + + /** Отсечение многоугольника полосой w в [lo, hi] (Сазерленд-Ходжман). */ + private static List clipW(List poly, double lo, double hi) { + List out = clipHalf(poly, lo, true); + if (out.size() < 3) { + return out; + } + return clipHalf(out, hi, false); + } + + private static List clipHalf(List poly, double bound, boolean keepAbove) { + List out = new ArrayList<>(); + for (int i = 0; i < poly.size(); i++) { + double[] cur = poly.get(i); + double[] nxt = poly.get((i + 1) % poly.size()); + boolean inCur = keepAbove ? cur[2] >= bound : cur[2] <= bound; + boolean inNxt = keepAbove ? nxt[2] >= bound : nxt[2] <= bound; + if (inCur) { + out.add(cur); + } + if (inCur != inNxt && Math.abs(nxt[2] - cur[2]) > 1e-12) { + double t = (bound - cur[2]) / (nxt[2] - cur[2]); + out.add(new double[]{cur[0] + t * (nxt[0] - cur[0]), + cur[1] + t * (nxt[1] - cur[1]), bound}); + } + } + return out; + } + + /** Сетка пола и дальней стенки; рисуется до поверхности. */ + private static void drawFloor(Graphics2D g, ChartSpec spec, Node[] floor, + List valueAnchors, int nCat, int nSer, + double lo, double hi, double unit, double span, + double rotX, double rotY, double depthScale, + double heightScale, double persp, + Fit fit) { + ChartSpec.AxisSpec catAxis = spec.catAxis != null ? spec.catAxis : new ChartSpec.AxisSpec(); + ChartSpec.AxisSpec valAxis = spec.valAxis != null ? spec.valAxis : new ChartSpec.AxisSpec(); + Color grid = valAxis.gridColor != null ? valAxis.gridColor : catAxis.gridColor; + g.setColor(grid); + g.setStroke(new BasicStroke(0.5f)); + double floorW = -0.5 * heightScale; + + // контур пола + Path2D outline = new Path2D.Double(); + for (int i = 0; i < floor.length; i++) { + Node n = floor[i]; + if (i == 0) { + outline.moveTo(n.x() * fit.scaleX() + fit.offX(), n.y() * fit.scaleY() + fit.offY()); + } else { + outline.lineTo(n.x() * fit.scaleX() + fit.offX(), n.y() * fit.scaleY() + fit.offY()); + } + } + outline.closePath(); + g.draw(outline); + + // линии пола по категориям (вдоль глубины) и по рядам (вдоль ширины): + // у 3D-диаграммы пол размечен всегда, независимо от c:majorGridlines + for (int c = 0; c < nCat; c++) { + double u = uOf(c, nCat); + line(g, project(u, -0.5, floorW, rotX, rotY, depthScale, persp), + project(u, 0.5, floorW, rotX, rotY, depthScale, persp), fit); + } + for (int r = 0; r < nSer; r++) { + double v = vOf(r, nSer); + line(g, project(-0.5, v, floorW, rotX, rotY, depthScale, persp), + project(0.5, v, floorW, rotX, rotY, depthScale, persp), fit); + } + // сетка значений: левая стенка (от переднего левого ребра в глубину) + // и дальней стенка — обе рисует Word + if (valAxis.gridlines) { + for (double v = lo; v <= hi + unit / 2; v += unit) { + double w = ((v - lo) / span - 0.5) * heightScale; + line(g, project(-0.5, -0.5, w, rotX, rotY, depthScale, persp), + project(-0.5, 0.5, w, rotX, rotY, depthScale, persp), fit); + line(g, project(-0.5, 0.5, w, rotX, rotY, depthScale, persp), + project(0.5, 0.5, w, rotX, rotY, depthScale, persp), fit); + } + } + } + + private static void line(Graphics2D g, Node a, Node b, Fit fit) { + g.draw(new java.awt.geom.Line2D.Double( + a.x() * fit.scaleX() + fit.offX(), a.y() * fit.scaleY() + fit.offY(), + b.x() * fit.scaleX() + fit.offX(), b.y() * fit.scaleY() + fit.offY())); + } + + private static void drawLabels(Graphics2D g, ChartSpec spec, List valueAnchors, + double lo, double hi, double unit, int nCat, int nSer, + double rotX, double rotY, double depthScale, + double heightScale, double persp, Fit fit) { + ChartSpec.AxisSpec catAxis = spec.catAxis != null ? spec.catAxis : new ChartSpec.AxisSpec(); + ChartSpec.AxisSpec valAxis = spec.valAxis != null ? spec.valAxis : new ChartSpec.AxisSpec(); + ChartSpec.AxisSpec serAxis = spec.serAxis != null ? spec.serAxis : new ChartSpec.AxisSpec(); + double floorW = -0.5 * heightScale; + + // Ось значений: левый край дальней стенки + DrawMlText.Style vs = valAxis.labelStyle; + if (vs != null) { + double h = DrawMlText.textHeight(vs, g.getFontRenderContext()) + 2; + int i = 0; + for (double v = lo; v <= hi + unit / 2; v += unit) { + if (i >= valueAnchors.size()) { + break; + } + Node n = valueAnchors.get(i++); + double x = n.x() * fit.scaleX() + fit.offX(); + double y = n.y() * fit.scaleY() + fit.offY(); + String label = ChartRenderer.formatValue(v, valAxis.numFmt); + double w = DrawMlText.textWidth(label, vs, g.getFontRenderContext()); + DrawMlText.paint(g, List.of(new DrawMlText.Paragraph(label, vs, "r")), + new Rectangle2D.Double(x - w - 4, y - h / 2, w, h), "r", "ctr", 1.0); + } + } + + // Категории: переднее нижнее ребро пола + DrawMlText.Style cs = catAxis.labelStyle; + if (cs != null) { + double h = DrawMlText.textHeight(cs, g.getFontRenderContext()) + 2; + for (int c = 0; c < nCat; c++) { + String label = c < spec.categories.size() ? spec.categories.get(c) : ""; + if (label.isEmpty()) { + continue; + } + Node n = project(uOf(c, nCat), -0.5, floorW, rotX, rotY, depthScale, persp); + double x = n.x() * fit.scaleX() + fit.offX(); + // в Word подписи категорий опущены на 15,1 pt ниже линии пола + // (замер по эталону word-export.pdf, 300 dpi: центры подписей 669/714/ + // 764/820 px при линии пола 606/651/700/757 px) + double y = n.y() * fit.scaleY() + fit.offY() + 8; + double w = DrawMlText.textWidth(label, cs, g.getFontRenderContext()); + DrawMlText.paint(g, List.of(new DrawMlText.Paragraph(label, cs, "ctr")), + new Rectangle2D.Double(x - w / 2, y, w, h), "ctr", "t", 1.0); + } + } + + // Ряды: правое нижнее ребро пола + DrawMlText.Style ss = serAxis.labelStyle; + if (ss != null) { + double h = DrawMlText.textHeight(ss, g.getFontRenderContext()) + 2; + for (int r = 0; r < nSer; r++) { + String label = spec.series.get(r).name; + if (label == null || label.isEmpty()) { + continue; + } + Node n = project(0.5, vOf(r, nSer), floorW, rotX, rotY, depthScale, persp); + double x = n.x() * fit.scaleX() + fit.offX() + 4; + double y = n.y() * fit.scaleY() + fit.offY(); + double w = DrawMlText.textWidth(label, ss, g.getFontRenderContext()); + DrawMlText.paint(g, List.of(new DrawMlText.Paragraph(label, ss, "l")), + new Rectangle2D.Double(x, y - h / 2, w, h), "l", "ctr", 1.0); + } + } + } + + /** + * Проекция модельной точки. u — категория, v — ряд (умножается на + * c:view3D/depth), w — значение; все в [-0.5, 0.5]. Возвращает + * экранные координаты в модельном масштабе и глубину (больше = дальше). + */ + static Node project(double u, double v, double w, double rotX, double rotY, + double depthScale, double perspective) { + double vd = v * depthScale; + double ca = Math.cos(rotY); + double sa = Math.sin(rotY); + double x1 = u * ca - vd * sa; + double y1 = u * sa + vd * ca; + double cb = Math.cos(rotX); + double sb = Math.sin(rotX); + double depth = y1 * cb - w * sb; + double height = y1 * sb + w * cb; + double k = 1.0; + if (perspective > 0.01) { + double d = CAMERA_DISTANCE * (30.0 / Math.max(1.0, perspective)); + k = d / Math.max(0.05, d + depth); + } + return new Node(x1 * k, -height * k, depth); + } + + private static double uOf(int c, int nCat) { + return nCat > 1 ? (double) c / (nCat - 1) - 0.5 : 0; + } + + private static double vOf(int r, int nSer) { + return nSer > 1 ? (double) r / (nSer - 1) - 0.5 : 0; + } +} 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 aa9f123..a46968e 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java @@ -72,6 +72,38 @@ class WordPdfConverterTest { return names; } + /** Количество Image XObject на всех страницах PDF. */ + private static int imageCount(Path pdf) throws IOException { + int count = 0; + try (PDDocument doc = Loader.loadPDF(pdf.toFile())) { + for (PDPage page : doc.getPages()) { + PDResources res = page.getResources(); + for (COSName name : res.getXObjectNames()) { + if (res.isImageXObject(name)) { + count++; + } + } + } + } + return count; + } + + /** + * Диаграммы (c:chart) и SmartArt (dgm:relIds) до экспорта в FO + * рендерятся в PNG: без этого docx2fo.xslt выбрасывает весь w:drawing + * как notImplemented, и в PDF не остаётся ни одной картинки. + */ + @Test + void chartsSmartArt_drawingsBecomeImages() throws Exception { + Path in = extractSample("charts-smartart.docx"); + Path pdf = convert(in); + + String text = norm(pdfText(pdf)); + assertTrue(text.contains("Диаграммы"), "пропал текст вокруг диаграмм: " + text); + assertTrue(imageCount(pdf) >= 4, + "ожидались 4 растра (SmartArt + 3 графика), найдено: " + imageCount(pdf)); + } + @Test void ruPlain_cyrillicAndStyles() throws Exception { Path in = extractSample("ru-plain.docx"); diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartSpecTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartSpecTest.java new file mode 100644 index 0000000..3007bed --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartSpecTest.java @@ -0,0 +1,57 @@ +package ru.pjandro.wordpdf.internal.chart; + +import org.docx4j.dml.chart.CTBoolean; +import org.docx4j.dml.chart.CTChart; +import org.docx4j.dml.chart.CTTitle; +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * Пустой c:title при autoTitleDeleted=0 — это автозаголовок Word, которого + * нет в XML: для круговых диаграмм он равен имени ряда, для остальных + * типов это встроенный плейсхолдер. + */ +class ChartSpecTest { + + @Test + void emptyTitleFallsBackToAutoTitle() { + ChartSpec spec = new ChartSpec(); + spec.type = ChartSpec.Type.SURFACE3D; + ChartSpec.readTitle(emptyTitleChart(), spec, new DrawMlColor(null)); + assertEquals(ChartSpec.AUTO_TITLE, spec.title); + assertNotNull(spec.titleStyle, "у автозаголовка должно быть начертание из c:txPr"); + } + + @Test + void emptyTitleOfCircularChartUsesSeriesName() { + ChartSpec spec = new ChartSpec(); + spec.type = ChartSpec.Type.PIE3D; + ChartSpec.Series s = new ChartSpec.Series(); + s.name = "Продажи"; + spec.series.add(s); + ChartSpec.readTitle(emptyTitleChart(), spec, new DrawMlColor(null)); + assertEquals("Продажи", spec.title); + } + + @Test + void deletedAutoTitleLeavesChartWithoutTitle() { + ChartSpec spec = new ChartSpec(); + spec.type = ChartSpec.Type.LINE; + CTChart chart = emptyTitleChart(); + CTBoolean deleted = new CTBoolean(); + deleted.setVal(Boolean.TRUE); + chart.setAutoTitleDeleted(deleted); + ChartSpec.readTitle(chart, spec, new DrawMlColor(null)); + assertNull(spec.title); + } + + private static CTChart emptyTitleChart() { + CTChart chart = new CTChart(); + chart.setTitle(new CTTitle()); + CTBoolean keep = new CTBoolean(); + keep.setVal(Boolean.FALSE); + chart.setAutoTitleDeleted(keep); + return chart; + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/PiePainterTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/PiePainterTest.java new file mode 100644 index 0000000..f992ecd --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/PiePainterTest.java @@ -0,0 +1,107 @@ +package ru.pjandro.wordpdf.internal.chart; + +import org.junit.jupiter.api.Test; + +import java.awt.image.BufferedImage; +import java.util.List; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * Геометрия pie3D: наклон «торта», глубина экструзии и видимость торцов. + * Цели замерены по эталону Word — стр. 3 `word-export.pdf` (300 dpi), область + * графика 219,23×149,08 pt (wp:extent 2784231×1893277 EMU). + */ +class PiePainterTest { + + /** + * Форма торта (не масштаб — он зависит от заголовка и легенды): в эталоне + * Word силуэт 540×316 px, т.е. h/w = 0,585 при ry/rx = 0,475 и глубине + * 0,22 от радиуса. До калибровки торт был на 8% выше эталона. + */ + @Test + void pie3dSilhouetteMatchesWordReference() { + DrawMlColor colors = new DrawMlColor(null); + BufferedImage img = ChartRenderer.render(pie3dSpec(), 219.23, 149.08, colors); + + int minX = Integer.MAX_VALUE; + int maxX = -1; + int minY = Integer.MAX_VALUE; + int maxY = -1; + int painted = 0; + for (int y = 0; y < img.getHeight() * 0.82; y++) { + for (int x = 0; x < img.getWidth(); x++) { + int rgb = img.getRGB(x, y); + int r = (rgb >> 16) & 0xFF; + int g = (rgb >> 8) & 0xFF; + int b = rgb & 0xFF; + if (Math.max(Math.max(r, g), b) - Math.min(Math.min(r, g), b) <= 25) { + continue; + } + painted++; + minX = Math.min(minX, x); + maxX = Math.max(maxX, x); + minY = Math.min(minY, y); + maxY = Math.max(maxY, y); + } + } + assertTrue(painted > 60000, "слишком мало залитого торта: " + painted); + assertRatio("аспект силуэта pie3D (h/w)", (maxY - minY) / (double) (maxX - minX), 0.585); + } + + /** + * Торец общей границы двух соседних секторов должен быть один: у сектора, + * чья грань отвернута от камеры, он не рисуется, иначе торец дальнего + * сектора выползает наружу (в word-export.pdf на границе «Кв. 1»/«Кв. 2» видна + * тёмно-синяя грань, а не оранжевая). + */ + @Test + void pie3dSharedEdgeShowsOnlyCameraFacingEnd() { + DrawMlColor colors = new DrawMlColor(null); + BufferedImage img = ChartRenderer.render(pie3dSpec(), 219.23, 149.08, colors); + int blue = 0; + int orange = 0; + for (int y = 0; y < img.getHeight(); y++) { + for (int x = 0; x < img.getWidth(); x++) { + int rgb = img.getRGB(x, y); + int r = (rgb >> 16) & 0xFF; + int g = (rgb >> 8) & 0xFF; + int b = rgb & 0xFF; + // тёмно-синий торец: accent1, затемнённый до 0,55..0,85 + if (b > r + 40 && b > 90 && b < 180 && r < 90) { + blue++; + } + // тёмно-оранжевый торец: accent2, затемнённый до 0,55..0,85 + if (r > g + 40 && g > b + 20 && r > 120 && r < 210) { + orange++; + } + } + } + assertTrue(blue > orange, + "на границе секторов должен быть виден торец переднего (синего) сектора: " + + "синего " + blue + " px, оранжевого " + orange + " px"); + } + + private static ChartSpec pie3dSpec() { + ChartSpec spec = new ChartSpec(); + spec.type = ChartSpec.Type.PIE3D; + spec.title = "Продажи"; + spec.legendPos = "b"; + ChartSpec.Series s = new ChartSpec.Series(); + s.name = "Продажи"; + for (double v : new double[]{8.2, 3.2, 1.4, 1.2}) { + s.values.add(v); + } + s.categories.addAll(List.of("Кв. 1", "Кв. 2", "Кв. 3", "Кв. 4")); + spec.series.add(s); + return spec; + } + + private static void assertRatio(String what, double actual, double expected) { + double deviation = Math.abs(actual - expected) / Math.abs(expected); + assertTrue(deviation < 0.06, + what + ": получено " + String.format("%.0f", actual) + + " px, в эталоне Word " + String.format("%.0f", expected) + + " px (отклонение " + String.format("%.1f", deviation * 100) + "%)"); + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/Surface3dPainterTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/Surface3dPainterTest.java new file mode 100644 index 0000000..335eb85 --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/Surface3dPainterTest.java @@ -0,0 +1,440 @@ +package ru.pjandro.wordpdf.internal.chart; + +import org.junit.jupiter.api.Test; + +import java.awt.Color; +import java.awt.Graphics2D; +import java.awt.geom.Rectangle2D; +import java.awt.image.BufferedImage; +import java.util.ArrayList; +import java.util.Collections; +import java.util.HashSet; +import java.util.List; +import java.util.Set; + +import static org.junit.jupiter.api.Assertions.*; + +/** + * Геометрия surface3D: перспектива, нулевая база оси значений и сам факт, + * что грани заливаются (а не рисуются в субпиксельный ноль). + */ +class Surface3dPainterTest { + + @Test + void project_perspectiveMakesFrontEdgeWider() { + double rotX = Math.toRadians(15); + Surface3dPainter.Node front = Surface3dPainter.project(0.5, -0.5, 0, rotX, 0, 1.0, 30); + Surface3dPainter.Node back = Surface3dPainter.project(0.5, 0.5, 0, rotX, 0, 1.0, 30); + assertTrue(front.depth() < back.depth(), + "передний план должен быть ближе: " + front.depth() + " vs " + back.depth()); + assertTrue(Math.abs(front.x()) > Math.abs(back.x()) * 1.05, + "перспектива не расширяет передний план: " + front.x() + " vs " + back.x()); + + Surface3dPainter.Node flatFront = Surface3dPainter.project(0.5, -0.5, 0, rotX, 0, 1.0, 0); + Surface3dPainter.Node flatBack = Surface3dPainter.project(0.5, 0.5, 0, rotX, 0, 1.0, 0); + assertEquals(flatFront.x(), flatBack.x(), 1e-9, + "без перспективы масштаб не должен различаться"); + } + + @Test + void axisBounds_linearValueAxisIncludesZero() { + double[] b = ChartRenderer.axisBounds(new ChartSpec.AxisSpec(), 1.8, 5); + assertEquals(0, b[0], 1e-9, "ось значений должна начинаться с нуля (как в Word)"); + assertEquals(5, b[1], 1e-9); + assertEquals(1, b[2], 1e-9); + + double[] negative = ChartRenderer.axisBounds(new ChartSpec.AxisSpec(), -5, -1.2); + assertTrue(negative[0] < 0 && negative[1] < 0, + "отрицательные данные не должны тянуть ось к нулю: " + + negative[0] + ".." + negative[1]); + } + + @Test + void paint_drawsShadedFacets() { + ChartSpec spec = surfaceSpec(); + + DrawMlColor colors = new DrawMlColor(null); + BufferedImage img = new BufferedImage(700, 400, BufferedImage.TYPE_INT_ARGB); + Graphics2D g = img.createGraphics(); + try { + Surface3dPainter.paint(g, spec, + new Rectangle2D.Double(10, 10, 680, 380), ChartSpec.palette(colors)); + } finally { + g.dispose(); + } + + Set distinct = new HashSet<>(); + int painted = 0; + for (int y = 0; y < img.getHeight(); y++) { + for (int x = 0; x < img.getWidth(); x++) { + int argb = img.getRGB(x, y); + if (((argb >>> 24) & 0xFF) < 200) { + continue; + } + Color c = new Color(argb); + if (c.getRed() > 245 && c.getGreen() > 245 && c.getBlue() > 245) { + continue; + } + painted++; + distinct.add(c.getRGB()); + } + } + assertTrue(painted > 3000, + "грани почти не залиты (похоже, геометрия ушла за пределы холста): " + painted); + assertTrue(distinct.size() >= 6, + "ождались разные оттенки граней (затемнение по нормали), найдено цветов: " + + distinct.size()); + } + + /** + * Калибровка камеры и «коробки» по эталону Word: стр. 3 `word-export.pdf` + * (экспорт Word), растеризованная в 300 dpi. Цели — безразмерные + * отношения, замеренные по подписям осей и по силуэту поверхности + * (пиксели граней, 1897×962 px области графика 448,15×230,31 pt): + * уклон передней кромки пола 0,1282 (подписи «Категория 1…4»: + * x 311/658/1048/1489, y 669/714/764/820), аспект силуэта поверхности + * 0,207 (1312×272 px — силуэт по связным областям граней, серые грани + * входят в него), шаг оси значений 0,0504 (66 px на деление, + * подписи 5…0 по переднему левому ребру) и шаг оси рядов 0,1176 + * (154 px между «Ряд 1» и «Ряд 2»). Все четыре — относительно + * ширины силуэта, поэтому не зависят от размера области построения. + */ + @Test + void cameraMatchesWordReference() { + double rotX = Math.toRadians(15); + double rotY = -Math.toRadians(20); + double ds = Surface3dPainter.DEPTH_RATIO; + // аспект области построения эталонного графика: box за вычетом + // заголовка (~21 pt) и легенды (~14,5 pt) и полей painter'а + double boxW = 448.15385826771654 - 8; + double boxH = 230.30771653543306 - 8 - 21 - 14.5; + double availW = boxW * (1 - Surface3dPainter.GUTTER_LEFT - Surface3dPainter.GUTTER_RIGHT); + double availH = boxH * (1 - Surface3dPainter.GUTTER_TOP - Surface3dPainter.GUTTER_BOTTOM); + double hs = Surface3dPainter.HEIGHT_RATIO * availH / availW; + double[][] z = {{4.3, 2.5, 3.5, 4.5}, {2.4, 4.4, 1.8, 2.8}, {2.0, 2.0, 3.0, 5.0}}; + + double minX = Double.MAX_VALUE; + double maxX = -Double.MAX_VALUE; + double minY = Double.MAX_VALUE; + double maxY = -Double.MAX_VALUE; + for (int r = 0; r < 3; r++) { + for (int c = 0; c < 4; c++) { + Surface3dPainter.Node n = Surface3dPainter.project( + c / 3.0 - 0.5, r / 2.0 - 0.5, + (z[r][c] / 5.0 - 0.5) * hs, rotX, rotY, ds, 30); + minX = Math.min(minX, n.x()); + maxX = Math.max(maxX, n.x()); + minY = Math.min(minY, n.y()); + maxY = Math.max(maxY, n.y()); + } + } + double width = maxX - minX; + + Surface3dPainter.Node k1 = Surface3dPainter.project(-0.5, -0.5, -hs / 2, rotX, rotY, ds, 30); + Surface3dPainter.Node k4 = Surface3dPainter.project(0.5, -0.5, -hs / 2, rotX, rotY, ds, 30); + Surface3dPainter.Node v0 = Surface3dPainter.project(-0.5, -0.5, -hs / 2, rotX, rotY, ds, 30); + Surface3dPainter.Node v1 = Surface3dPainter.project(-0.5, -0.5, -hs / 2 + hs / 5, rotX, rotY, ds, 30); + Surface3dPainter.Node r0 = Surface3dPainter.project(0.5, -0.5, -hs / 2, rotX, rotY, ds, 30); + Surface3dPainter.Node r1 = Surface3dPainter.project(0.5, 0.0, -hs / 2, rotX, rotY, ds, 30); + + assertRatio("уклон передней кромки пола", (k4.y() - k1.y()) / (k4.x() - k1.x()), 0.1282); + assertRatio("аспект силуэта поверхности", (maxY - minY) / width, 0.207); + assertRatio("шаг оси значений", (v1.y() - v0.y()) / width, -0.0504); + assertRatio("шаг оси рядов", (r1.y() - r0.y()) / width, -0.1176); + } + + /** + * Размер и место самой поверхности в области графика: в эталоне Word + * (стр. 3 word-export.pdf, 300 dpi, область 448,15×230,31 pt) связный блок + * граней занимает x 291…1603 px и y 207…479 px, т.е. 314,9×65,3 pt + * с центром в (227,3; 82,3) pt. Раньше коробка вписывалась в область + * построения целиком (82% ширины) и поверхность наползала на подписи + * оси значений. + */ + @Test + void surfaceSilhouetteMatchesWordPlacement() { + ChartSpec spec = surfaceSpec(); + DrawMlColor colors = new DrawMlColor(null); + double widthPt = 448.15385826771654; + double heightPt = 230.30771653543306; + BufferedImage img = new BufferedImage( + (int) Math.round(widthPt * 300 / 72.0), + (int) Math.round(heightPt * 300 / 72.0), BufferedImage.TYPE_INT_RGB); + Graphics2D g = img.createGraphics(); + try { + g.setColor(Color.WHITE); + g.fillRect(0, 0, img.getWidth(), img.getHeight()); + g.scale(300 / 72.0, 300 / 72.0); + Surface3dPainter.paint(g, spec, + new Rectangle2D.Double(4, 25, widthPt - 8, heightPt - 8 - 21 - 14.5), + ChartSpec.palette(colors)); + } finally { + g.dispose(); + } + double minX = Double.MAX_VALUE; + double maxX = -Double.MAX_VALUE; + double minY = Double.MAX_VALUE; + double maxY = -Double.MAX_VALUE; + int painted = 0; + boolean[][] facet = facetMask(img); + for (int y = 0; y < img.getHeight(); y++) { + for (int x = 0; x < img.getWidth(); x++) { + if (!facet[y][x]) { + continue; + } + painted++; + double px = x * 72.0 / 300; + double py = y * 72.0 / 300; + minX = Math.min(minX, px); + maxX = Math.max(maxX, px); + minY = Math.min(minY, py); + maxY = Math.max(maxY, py); + } + } + assertTrue(painted > 60000, "слишком мало граней: " + painted); + // Word: силуэт 314,9×65,3 pt с центром в (227,3; 82,3) области 448×230 pt + assertRatio("ширина силуэта поверхности", maxX - minX, 314.9); + assertRatio("высота силуэта поверхности", maxY - minY, 65.3); + assertRange("центр силуэта по X", (minX + maxX) / 2, 227.3, 6); + assertRange("центр силуэта по Y", (minY + maxY) / 2, 82.3, 6); + } + + /** + * Седловая ячейка «Ряд 1 → Ряд 2, Категория 2 → Категория 3» + * (значения 2,5 и 4,4 спереди, 3,5 и 1,8 сзади) в проекции вогнутая: + * один из её углов попадает внутрь треугольника остальных трёх, и то, + * какой диагональю разрезан квад, меняют полосу видимой грани. + * В эталоне Word (стр. 3 `word-export.pdf`, 300 dpi) нижняя кромка силуэта на + * протяжении 0,40…0,59 его ширины — жёлтая, полоса 3–4 (accent4), + * а не серая 2–3: Word берёт верхнюю огибающую седла, то есть диагональ + * w01–w10. С фиксированной w00–w11 там выходит серая полоса 2–3. + */ + @Test + void saddleCellUsesHigherDiagonal() { + ChartSpec spec = surfaceSpec(); + List palette = ChartSpec.palette(new DrawMlColor(null)); + BufferedImage img = new BufferedImage(700, 400, BufferedImage.TYPE_INT_RGB); + Graphics2D g = img.createGraphics(); + try { + g.setColor(Color.WHITE); + g.fillRect(0, 0, img.getWidth(), img.getHeight()); + Surface3dPainter.paint(g, spec, + new Rectangle2D.Double(10, 10, 680, 380), palette); + } finally { + g.dispose(); + } + boolean[][] facet = facetMask(img); + int minX = img.getWidth(); + int maxX = -1; + int minY = img.getHeight(); + int maxY = -1; + for (int y = 0; y < img.getHeight(); y++) { + for (int x = 0; x < img.getWidth(); x++) { + if (!facet[y][x]) { + continue; + } + minX = Math.min(minX, x); + maxX = Math.max(maxX, x); + minY = Math.min(minY, y); + maxY = Math.max(maxY, y); + } + } + assertTrue(maxX > minX && maxY > minY, "силуэт поверхности не найден"); + double width = maxX - minX; + + int checked = 0; + int yellow = 0; + StringBuilder seen = new StringBuilder(); + for (int x = (int) Math.ceil(minX + 0.42 * width); x <= minX + 0.55 * width; x++) { + for (int y = maxY; y >= minY; y--) { + if (!facet[y][x]) { + continue; + } + checked++; + int band = bandOf(new Color(img.getRGB(x, y)), palette); + if (band == 3) { + yellow++; + } else if (seen.length() < 40) { + seen.append("x=").append(x).append(" полоса ").append(band).append("; "); + } + break; + } + } + assertTrue(checked > 40, "окно по нижней кромке силуэта почти пустое: " + checked); + assertEquals(checked, yellow, + "передняя грань седловой ячейки должна быть полосы 3–4 (Word), " + + "а не 2–3; первые расхождения: " + seen); + } + + /** + * Полоса цвета с произвольным затемнением: грань Word красит цветом + * полосы и умножает его на 0,8…1,25, поэтому искать ближайший цвет + * палитры «как есть» — значит не найти ничего (жёлтый 0,8 — уже не + * похож на accent4). + */ + private static int bandOf(Color c, List palette) { + int best = -1; + double bestDist = Double.MAX_VALUE; + for (int i = 0; i < Math.min(5, palette.size()); i++) { + Color b = palette.get(i); + for (int f = 60; f <= 135; f++) { + double k = f / 100.0; + double d = Math.pow(c.getRed() - b.getRed() * k, 2) + + Math.pow(c.getGreen() - b.getGreen() * k, 2) + + Math.pow(c.getBlue() - b.getBlue() * k, 2); + if (d < bestDist) { + bestDist = d; + best = i; + } + } + } + return bestDist < 3600 ? best : -1; + } + + /** + * Пиксели граней поверхности: не белые и не тонкие (сетка, подписи и + * рамки осей — линии толщиной в несколько пикселей, грань — пятно). + * Серые грани по цвету близки к фону, поэтому «насыщенность» их не + * ловит: нужен признак «крупное связное пятно». + */ + private static boolean[][] facetMask(BufferedImage img) { + int w = img.getWidth(); + int h = img.getHeight(); + boolean[][] nonWhite = new boolean[h][w]; + for (int y = 0; y < h; y++) { + for (int x = 0; x < w; x++) { + Color c = new Color(img.getRGB(x, y)); + nonWhite[y][x] = Math.min(c.getRed(), Math.min(c.getGreen(), c.getBlue())) < 205; + } + } + boolean[][] out = new boolean[h][w]; + for (int y = 4; y + 4 < h; y++) { + for (int x = 4; x + 4 < w; x++) { + int cnt = 0; + for (int dy = -4; dy <= 4 && cnt < 45; dy++) { + for (int dx = -4; dx <= 4; dx++) { + if (nonWhite[y + dy][x + dx]) { + cnt++; + } + } + } + out[y][x] = cnt >= 45 && nonWhite[y][x]; + } + } + return out; + } + + private static void assertRange(String what, double actual, double expected, double tolPt) { + assertTrue(Math.abs(actual - expected) <= tolPt, + what + ": получено " + String.format("%.1f", actual) + + " pt, в эталоне Word " + String.format("%.1f", expected) + " pt"); + } + + /** + * Затенение граней: множители яркости грани относительно цвета полосы + * в эталоне Word (стр. 3 `word-export.pdf`, 300 dpi, гистограмма цветов граней) + * — 0,40 / 0,75 / 0,85 / 1,04 / 1,06 / 1,10, причём 0,40 — это малая + * зона (тонкая полоска под передним краем ленты). Свободный Lambert + * с отрицательными dot даёт слишком много тёмных граней и хуже + * сходится с эталоном, поэтому нижняя граница множителя — 0,80. + */ + @Test + void shadingMatchesWordRange() { + ChartSpec spec = surfaceSpec(); + DrawMlColor colors = new DrawMlColor(null); + List palette = ChartSpec.palette(colors); + BufferedImage img = new BufferedImage(700, 400, BufferedImage.TYPE_INT_RGB); + Graphics2D g = img.createGraphics(); + try { + g.setColor(Color.WHITE); + g.fillRect(0, 0, img.getWidth(), img.getHeight()); + Surface3dPainter.paint(g, spec, + new Rectangle2D.Double(10, 10, 680, 380), palette); + } finally { + g.dispose(); + } + + List ratios = new ArrayList<>(); + for (int y = 0; y < img.getHeight(); y++) { + for (int x = 0; x < img.getWidth(); x++) { + Color c = new Color(img.getRGB(x, y)); + if (c.getRed() > 245 && c.getGreen() > 245 && c.getBlue() > 245) { + continue; + } + Color base = nearestBand(c, palette); + if (base == null) { + continue; + } + double lum = 0.299 * c.getRed() + 0.587 * c.getGreen() + 0.114 * c.getBlue(); + double baseLum = 0.299 * base.getRed() + 0.587 * base.getGreen() + + 0.114 * base.getBlue(); + ratios.add(lum / baseLum); + } + } + assertTrue(ratios.size() > 3000, "слишком мало залитых граней: " + ratios.size()); + Collections.sort(ratios); + double p5 = ratios.get((int) (ratios.size() * 0.05)); + double median = ratios.get(ratios.size() / 2); + double p95 = ratios.get((int) (ratios.size() * 0.95)); + assertTrue(p5 >= 0.74 && p5 <= 0.90, + "тёмные грани вне эталонного диапазона (0,75..0,85): p5=" + p5); + assertTrue(median >= 0.90 && median <= 1.10, + "медианная яркость граней вне эталонной (1,04): median=" + median); + assertTrue(p95 >= 1.02 && p95 <= 1.20, + "светлые грани вне эталонного диапазона (1,06..1,10): p95=" + p95); + } + + private static Color nearestBand(Color c, List palette) { + Color best = null; + double bestDist = Double.MAX_VALUE; + for (int i = 0; i < Math.min(5, palette.size()); i++) { + Color b = palette.get(i); + double d = Math.pow(c.getRed() - b.getRed(), 2) + + Math.pow(c.getGreen() - b.getGreen(), 2) + + Math.pow(c.getBlue() - b.getBlue(), 2); + if (d < bestDist) { + bestDist = d; + best = b; + } + } + return bestDist < 3600 ? best : null; + } + + private static ChartSpec surfaceSpec() { + ChartSpec spec = new ChartSpec(); + spec.type = ChartSpec.Type.SURFACE3D; + spec.rotX = 15; + spec.rotY = 20; + spec.perspective = 30; + spec.depthPercent = 100; + addSeries(spec, "Ряд 1", 4.3, 2.5, 3.5, 4.5); + addSeries(spec, "Ряд 2", 2.4, 4.4, 1.8, 2.8); + addSeries(spec, "Ряд 3", 2.0, 2.0, 3.0, 5.0); + spec.categories.addAll(List.of( + "Категория 1", "Категория 2", "Категория 3", "Категория 4")); + spec.valAxis = new ChartSpec.AxisSpec(); + spec.valAxis.gridlines = true; + spec.catAxis = new ChartSpec.AxisSpec(); + spec.catAxis.gridlines = true; + spec.serAxis = new ChartSpec.AxisSpec(); + spec.serAxis.gridlines = true; + return spec; + } + + private static void assertRatio(String what, double actual, double expected) { + double deviation = Math.abs(actual - expected) / Math.abs(expected); + assertTrue(deviation < 0.10, + what + ": получено " + String.format("%.4f", actual) + + ", в эталоне Word " + String.format("%.4f", expected) + + " (отклонение " + String.format("%.1f", deviation * 100) + "%)"); + } + + private static void addSeries(ChartSpec spec, String name, double... values) { + ChartSpec.Series s = new ChartSpec.Series(); + s.name = name; + for (double v : values) { + s.values.add(v); + } + spec.series.add(s); + } +} diff --git a/wordpdf-core/src/test/resources/samples/charts-smartart.docx b/wordpdf-core/src/test/resources/samples/charts-smartart.docx new file mode 100644 index 0000000000000000000000000000000000000000..357fc5c6db7adb620cb1f44521d08f21421824d5 GIT binary patch literal 52254 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

VCDWH5 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