From de9995bba3a41de9999dbbfd70780b6d474db97d Mon Sep 17 00:00:00 2001 From: Pjandro Date: Mon, 2 Nov 2026 21:36:10 +0000 Subject: [PATCH] =?UTF-8?q?core:=20chart-PNG=20=D0=B1=D0=B5=D0=B7=20docx4j?= =?UTF-8?q?-=D0=B4=D0=B5=D0=BA=D0=BE=D0=B4=D0=B0=20=D0=B8=20=D0=B1=D0=B5?= =?UTF-8?q?=D0=B7=20=D0=BF=D0=B5=D1=80=D0=B5=D1=81=D0=B6=D0=B0=D1=82=D0=B8?= =?UTF-8?q?=D1=8F=20CR-029=20(=E2=88=9223%=20alloc=20chart-=D0=B4=D0=BE?= =?UTF-8?q?=D0=BA=D1=83=D0=BC=D0=B5=D0=BD=D1=82=D0=BE=D0=B2)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit DrawingPreRenderer.swapForPicture вставляет media-часть вручную (newPartForContentType → setBinaryData → rels.addPart, имена /word/media/chart-*): createImagePart писал temp-файл и декодировал PNG обратно ради mime/размеров, которые нам и так известны. ChartImageHandler (foSettings.setImageHandler) возвращает null из compressedVariant для chart-* — «Compress Pictures» не ресемплит и не декодирует наши 300-dpi растры; медиа документов остаются в штатном docx4j-режиме. Замер (25 фикстур × 6 прогонов): chart-types.docx 657→507 МБ alloc (тёплый), суммарно 11640→10604 МБ, прочие 23 файла ±0%; ретеншн не изменился (144 MiB после GC), temp-файлов 0. Регрессии: chartMedia_notDownsampled, DrawingPreRendererTest, ChartImageHandlerTest. --- AGENTS.md | 2 + docs/agent/chart.md | 4 +- .../ru/pjandro/wordpdf/WordPdfConverter.java | 8 ++ .../internal/chart/ChartImageHandler.java | 46 ++++++++ .../internal/chart/DrawingPreRenderer.java | 85 +++++++++++--- .../pjandro/wordpdf/WordPdfConverterTest.java | 39 +++++++ .../internal/chart/ChartImageHandlerTest.java | 52 +++++++++ .../chart/DrawingPreRendererTest.java | 109 ++++++++++++++++++ 8 files changed, 328 insertions(+), 17 deletions(-) create mode 100644 wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartImageHandler.java create mode 100644 wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartImageHandlerTest.java create mode 100644 wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawingPreRendererTest.java diff --git a/AGENTS.md b/AGENTS.md index a5e0b77..989dfc2 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -93,6 +93,8 @@ Java2D → PNG: `ChartRenderer.DPI = 300`, потолок растра `MAX_PIXELS = 16_777_216` (`fitDpi` понижает эффективный dpi). Защитные лимиты: `ChartSpec.MAX_POINTS = 100_000`, `ChartRenderer.MAX_TICKS = 1000`, `DrawingPreRenderer.MAX_EXTENT_EMU = 22_000_000` — деградация «объект остаётся как есть / удалён + warn», не OOM. +chart-PNG вставляются media-частями вручную (`DrawingPreRenderer.addChartMedia`, имена `/word/media/chart-*`, без docx4j-decode'а `createImagePart`); `ChartImageHandler` отключает docx4j «Compress Pictures» (CR-029) только для них — медиа документов остаются в штатном docx4j-режиме. + Пейнтеры со всеми калибровками, `autoTitleDeleted`/автозаголовки, Combo-семантика, защитные обходы JAXB — `docs/agent/chart.md`. ### Критические инварианты (нарушение = битый вывод, не исключение) diff --git a/docs/agent/chart.md b/docs/agent/chart.md index 140ad00..a9cdfb7 100644 --- a/docs/agent/chart.md +++ b/docs/agent/chart.md @@ -6,6 +6,8 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр Пейнтеры: `CartesianPainter` (2-D line/bar/area; `c:grouping` stacked/percentStacked §21.2.2.76 — ряд рисуется накопленной суммой через `ChartRenderer.stackedCumulative`), `PiePainter` (`PIE_DEPTH = 0.22`, `PIE_FIT = 0.865`), `Surface3dPainter` (камера — регрессия `cameraMatchesWordReference`: `DEPTH_RATIO = 0.705`, `HEIGHT_RATIO = 0.664`, `GUTTER_LEFT/RIGHT = 0.1485`, `GUTTER_TOP = 0.116`, `GUTTER_BOTTOM = 0.146`, свет `LIGHT_X/Y/Z = 0.83/0.48/0.28`; `c:rAngAx=true` приоритетнее `c:perspective` (MS-OI29500 §2.1.1516(b)); `c:wireframe` §21.2.2.205 — только каркас), `ScatterPainter` (радиус пузыря sqrt при `c:sizeRepresents="area"` §21.2.2.128), `RadarPainter` (спицы от 12 часов), `StockPainter` (upDownBars обводятся контуром, дефолт чёрный 0.75pt), `OfPiePainter` (MS-OI29500 §2.1.1507(a), §2.1.1545(a)), `Surface2dPainter` (контурная карта §21.2.2.204, marching squares, изолинии по `c:bandFmts` §21.2.2.13/.14), `Cartesian3dPainter` (bar3D/line3D/area3D §21.2.2.19/.101/.122, `c:shape` §21.2.3.44), `SmartArtRenderer` (кэш `word/diagrams/drawing1.xml` через relationship `…/office/2007/relationships/diagramDrawing`; формы — `PresetGeometry` из `a:prstGeom`, семь пресетов дословно из `presetShapeDefinitions.xml`; оператор `?:` = «if x > 0 then y else z» (ISO/IEC 29500-1, **не** x != 0); углы в Arc2D — со знаком минус; текст — `DrawMlText`, шрифты через `BundledFontMapper.bundledFamily`; autofit только `normAutofit` §21.1.2.1.2/.3; `dgm:prSet/@phldrT` не рисуется). -Защитные лимиты против враждебного chart-XML: `ChartSpec.MAX_POINTS = 100_000` (`c:pt/@idx` §21.2.2.150/.151, `c:ptCount` §21.2.2.152 — ST_UnsignedInt без верхней границы; отказ `IllegalArgumentException` **до** предвыделения списка), `ChartRenderer.MAX_TICKS = 1000` (шаг ≤ 0/NaN/слишком мелкий в `axisBounds` заменяется `niceUnit` 1/2/5·10ⁿ), `DrawingPreRenderer.MAX_EXTENT_EMU = 22_000_000` (≈24″; при `cx/cy` вне капа объект **оставляется как есть** + warn, картинка не рендерится — регрессия `hugeExtentChart_removedNotOom`). Бросок перехватывает catch в `DrawingPreRenderer.renderChart` → штатная деградация «объект удалён + warn». Обход `pkg.getParts()` — только по **снимку** списка (`createImagePart` мутирует реестр → CME); rels частей — `part.getRelationshipsPart()`, **не** `getOwningRelationshipPart()`; обход XML обязан раскрывать `JAXBElement`. +Защитные лимиты против враждебного chart-XML: `ChartSpec.MAX_POINTS = 100_000` (`c:pt/@idx` §21.2.2.150/.151, `c:ptCount` §21.2.2.152 — ST_UnsignedInt без верхней границы; отказ `IllegalArgumentException` **до** предвыделения списка), `ChartRenderer.MAX_TICKS = 1000` (шаг ≤ 0/NaN/слишком мелкий в `axisBounds` заменяется `niceUnit` 1/2/5·10ⁿ), `DrawingPreRenderer.MAX_EXTENT_EMU = 22_000_000` (≈24″; при `cx/cy` вне капа объект **оставляется как есть** + warn, картинка не рендерится — регрессия `hugeExtentChart_removedNotOom`). Бросок перехватывает catch в `DrawingPreRenderer.renderChart` → штатная деградация «объект удалён + warn». Обход `pkg.getParts()` — только по **снимку** списка (вставка media-частей `addChartMedia→addPart→loadPart` мутирует реестр → CME); rels частей — `part.getRelationshipsPart()`, **не** `getOwningRelationshipPart()`; обход XML обязан раскрывать `JAXBElement`. **Combo** (Word «Комбинированная», §21.2.2.145): несколько групп в одном `c:plotArea` (`c:barChart` + `c:lineChart`/`c:areaChart`), каждая со своими `c:axId` (§21.2.2.9). `parse` привязывает группы по id осей: `Series.renderAs` (семейство отрисовки), `Series.grouping`, `Series.valAxis` + `ChartSpec.secondaryValAxis` (обычно `c:axPos="r"`); `spec.valAxis`/`catAxis` — first-wins. `CartesianPainter` рисует семейства в порядке BAR→AREA→LINE, каждая серия масштабируется по своей оси, вторичная ось — линия справа + подписи справа. + +**chart-PNG media-части вставляются вручную** (`DrawingPreRenderer.addChartMedia`: `newPartForContentType` → `setBinaryData` → `rels.addPart`), БЕЗ `BinaryPartAbstractImage.createImagePart`: тот пишет PNG во временный файл и декодирует его обратно (ImageInfo) ради mime и размеров, которые нам и так известны — mime заведомо `image/png`, размер задаёт `wp:extent`; PNG-decode в exported-пути — верхняя строка потребления памяти (JFR-замер 25 фикстур). Имена `/word/media/chart-N.png` (`DrawingPreRenderer.CHART_MEDIA_URI_PREFIX`): уникальность — счётчик с проверкой реестра пакета (`PartName.generateUniqueName` уникальность НЕ даёт — конкатенация), `RENAME_IF_NAME_EXISTS` — при коллизии с media враждебного документа наша часть переименовывается, а не затирает чужую. `ChartImageHandler` (вешается `foSettings.setImageHandler` в `WordPdfConverter`) возвращает `null` из `compressedVariant` для `chart-*` — docx4j «Compress Pictures» (CR-029) для них не ресемплит растры и даже не декодирует их при экспорте (`PictureCompression.compress` декодирует ВСЕГДА); режим `word` (порог 300 ppi) наши 300-dpi растры и не трогал по размеру, экономия — именно пропуск decode/resample. Медиа документов (фото/скрины) остаются в штатном docx4j-режиме CR-029. Регрессии: `chartMedia_notDownsampled`, `DrawingPreRendererTest`, `ChartImageHandlerTest`. 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 c98acad..7ca1e25 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java @@ -11,6 +11,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.ChartImageHandler; import ru.pjandro.wordpdf.internal.chart.DrawingPreRenderer; import ru.pjandro.wordpdf.internal.DependencyGuard; import ru.pjandro.wordpdf.internal.DocxNormalizer; @@ -185,6 +186,13 @@ public final class WordPdfConverter { // 4. Настройки экспорта (FOP-конфиг с embed-шрифтами) FOSettings foSettings = new FOSettings(pkg); + // Наши chart-PNG (/word/media/chart-*) идут в PDF как есть: + // для них отключён docx4j «Compress Pictures» (CR-029) — иначе + // каждый 300-dpi chart декодируется, ресэмплится к ~220 ppi и + // перекодируется (~15–25 МБ alloc на chart, мыльный текст). + // Медиа документов — штатный docx4j-режим, вывод не меняется. + foSettings.setImageHandler(new ChartImageHandler()); + // FOP-конфиг знает только шрифты из fontsInUse, а символы // U+2000–U+2EFF (em-dash и т.п.) в FO маппятся на fallback // семейство — декларируем его, чтобы FOP встроил подмножество diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartImageHandler.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartImageHandler.java new file mode 100644 index 0000000..8c7870b --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartImageHandler.java @@ -0,0 +1,46 @@ +package ru.pjandro.wordpdf.internal.chart; + +import org.docx4j.convert.out.fo.FOConversionImageHandler; +import org.docx4j.model.images.AbstractWordXmlPicture; +import org.docx4j.openpackaging.exceptions.Docx4JException; +import org.docx4j.openpackaging.parts.WordprocessingML.BinaryPart; +import org.docx4j.relationships.Relationship; + +/** + * Image-обработчик FO-экспорта, отключающий docx4j «Compress Pictures» + * (CR-029) для наших chart-PNG. + * + * Штатный {@link FOConversionImageHandler} каждую внутреннюю картинку + * FO-вывода пропускает через {@code PictureCompression.compress}, который + * ВСЕГДА декодирует полный растр (ImageIO). В дефолтном режиме {@code word} + * (ресэмпл выше 300 ppi, WORD_PDF_THRESHOLD) наши растры ровно 300 ppi — + * не меняются, но декод уже стоит памяти на каждой конвертации (JFR-замер: + * PNG-decode — верхняя строка потребления). А при + * {@code docx4j.convert.out.fo.images.resolution} ниже 300 (например + * «Print» 220 ppi) 1500×900 chart уезжает в 1100×660 — текст подписей и + * шифтов мылится. + * + * Chart-растр собран ChartRenderer именно 300 dpi под финальный extent — + * пересжатие ему не нужно ни в каком режиме: для частей + * {@code /word/media/chart-*} возвращаем null (нет варианта), картинка + * уходит в PDF как есть. + * + * Медиа документов (фото/скрины) — не наши части, им остаётся штатный + * docx4j-режим CR-029. + * + * Регрессия — WordPdfConverterTest#chartMedia_notDownsampled. + */ +public final class ChartImageHandler extends FOConversionImageHandler { + + @Override + protected String compressedVariant(AbstractWordXmlPicture picture, + Relationship relationship, BinaryPart part) + throws Docx4JException { + if (part != null && part.getPartName() != null + && part.getPartName().getName() + .startsWith(DrawingPreRenderer.CHART_MEDIA_URI_PREFIX)) { + return null; + } + return super.compressedVariant(picture, relationship, part); + } +} 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 index 2461ec7..c160709 100644 --- 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 @@ -22,9 +22,13 @@ 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.contenttype.ContentTypes; +import org.docx4j.openpackaging.exceptions.Docx4JException; +import org.docx4j.openpackaging.exceptions.InvalidFormatException; import org.docx4j.openpackaging.packages.WordprocessingMLPackage; import org.docx4j.openpackaging.parts.JaxbXmlPart; import org.docx4j.openpackaging.parts.Part; +import org.docx4j.openpackaging.parts.PartName; import org.docx4j.openpackaging.parts.ThemePart; import org.docx4j.openpackaging.parts.WordprocessingML.BinaryPartAbstractImage; import org.docx4j.openpackaging.parts.relationships.RelationshipsPart; @@ -36,6 +40,7 @@ import ru.pjandro.wordpdf.DrawingFoundException; import javax.imageio.ImageIO; import java.awt.image.BufferedImage; +import java.io.ByteArrayInputStream; import java.io.ByteArrayOutputStream; import java.lang.reflect.Method; import java.util.ArrayList; @@ -80,6 +85,14 @@ public final class DrawingPreRenderer { */ private static final long MAX_EXTENT_EMU = 22_000_000L; + /** + * Префикс URI наших chart-media-частей. Двойной смысл: уникальные имена в + * {@link #nextMediaName} и маркер «это наш chart-PNG» для + * {@link ChartImageHandler} (отключение docx4j-пересжатия CR-029 только + * для них). Package-private — общий контракт двух классов. + */ + static final String CHART_MEDIA_URI_PREFIX = "/word/media/chart-"; + private DrawingPreRenderer() { } @@ -98,8 +111,9 @@ public final class DrawingPreRenderer { } DrawMlColor colors = new DrawMlColor(themePart == null ? null : themePart.getJaxbElement()); - // Снимок: createImagePart докидывает части в тот же реестр, - // обход живого HashMap дал бы ConcurrentModificationException. + // Снимок: вставка media-частей (addChartMedia→addPart→loadPart) докидывает + // части в тот же реестр, обход живого HashMap дал бы + // ConcurrentModificationException. List parts = new ArrayList<>(pkg.getParts().getParts().values()); Set handled = new HashSet<>(); int[] idSeq = {1000}; @@ -284,7 +298,15 @@ public final class DrawingPreRenderer { return rel == null ? null : rels.getPart(rel); } - /** a:graphic -> pic:pic того же размера; PNG кладётся в ImagePart этой же части. */ + /** + * a:graphic -> pic:pic того же размера; PNG кладётся в ImagePart этой же + * части. Часть вставляется вручную ({@code newPartForContentType} + + * {@code addPart}), без {@code BinaryPartAbstractImage.createImagePart}: + * тот пишет PNG во временный файл и декодирует его обратно (ImageInfo) + * ради mime и размеров — ~15–20 МБ alloc и temp-файл на каждый chart, + * хотя байты собраны здесь же, mime заведомо image/png, а размер задаёт + * wp:extent. Регрессия — WordPdfConverterTest#chartMedia_notDownsampled. + */ private static void swapForPicture(Part part, GraphicData gd, BufferedImage img, long cx, long cy, int[] idSeq, WordprocessingMLPackage pkg) { @@ -303,20 +325,14 @@ public final class DrawingPreRenderer { gd.getAny().clear(); // контракт: упавший рендер — объект удалён return; } - BinaryPartAbstractImage imagePart; + String relId; try { - imagePart = BinaryPartAbstractImage.createImagePart(pkg, part, png); + relId = addChartMedia(pkg, part, png); } catch (Exception e) { LOG.warn("ImagePart не создан: {}", e.toString()); gd.getAny().clear(); return; } - String relId = relIdFor(part, imagePart); - if (relId == null) { - LOG.warn("r:id для ImagePart {} не найден", imagePart.getPartName()); - gd.getAny().clear(); - return; - } Pic pic = new Pic(); org.docx4j.dml.picture.CTPictureNonVisual nv = new org.docx4j.dml.picture.CTPictureNonVisual(); @@ -358,12 +374,49 @@ public final class DrawingPreRenderer { gd.getAny().add(pic); } - private static String relIdFor(Part part, Part target) { + /** + * Вставляет chart-PNG как media-часть пакета, прикреплённую к части, и + * возвращает её r:id. Обходной путь вокруг + * {@code BinaryPartAbstractImage.createImagePart}: тот пишет байты во + * временный файл и декодирует PNG обратно (ImageInfo) ради mime и + * размеров — ~15–20 МБ alloc и temp-файл на каждый chart, хотя mime + * заведомо image/png, а размер задаёт wp:extent. Здесь — тот же маршрут + * docx4j ({@code newPartForContentType} → {@code setBinaryData} → + * {@code addPart}), но без decode: часть держит исходные байты. + * Хук юнит-теста DrawingPreRendererTest#addChartMediaKeepsBytesAndPrefix. + */ + static String addChartMedia(WordprocessingMLPackage pkg, Part part, byte[] png) + throws Docx4JException { RelationshipsPart rels = relsOf(part); - if (rels == null || rels.getRelationships() == null) { - return null; + if (rels == null) { + rels = RelationshipsPart.createRelationshipsPartForPart(part); + } + BinaryPartAbstractImage imagePart = (BinaryPartAbstractImage) pkg.getContentTypeManager() + .newPartForContentType(ContentTypes.IMAGE_PNG, nextMediaName(pkg), null); + imagePart.setBinaryData(new ByteArrayInputStream(png)); + // RENAME, а не OVERWRITE: при совпадении имени с media-частью + // враждебного документа наша часть переименовывается (префикс + // сохраняется), а не затирает документную картинку. addPart сам + // регистрирует content-type и выдаёт r:id (addRelationship→getNextId). + return rels.addPart(imagePart, + RelationshipsPart.AddPartBehaviour.RENAME_IF_NAME_EXISTS, + pkg.getContentTypeManager()).getId(); + } + + /** + * Первый свободный {@code /word/media/chart-N.png} в реестре пакета. + * Имя — счётчик с проверкой по реестру: {@code PartName.generateUniqueName} + * уникальность НЕ обеспечивает (это конкатенация имени части-источника с + * relId), а нам нужен именно префикс {@link #CHART_MEDIA_URI_PREFIX}. + * Реестр пополняется в {@code addPart→loadPart}, так что следующий вызов + * видит уже вставленные части. + */ + private static String nextMediaName(WordprocessingMLPackage pkg) throws InvalidFormatException { + for (int i = 1; ; i++) { + PartName name = new PartName(CHART_MEDIA_URI_PREFIX + i + ".png"); + if (pkg.getParts().get(name) == null) { + return name.getName(); + } } - var rel = rels.getRel(target.getPartName()); - return rel == null ? null : rel.getId(); } } 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 c900e4c..f3810ee 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java @@ -14,6 +14,7 @@ import org.apache.pdfbox.pdmodel.interactive.annotation.PDAnnotationLink; import org.apache.pdfbox.rendering.PDFRenderer; import org.apache.pdfbox.text.PDFTextStripper; import org.apache.poi.poifs.filesystem.POIFSFileSystem; +import org.docx4j.Docx4jProperties; import org.junit.jupiter.api.Test; import java.io.ByteArrayInputStream; @@ -112,6 +113,21 @@ class WordPdfConverterTest { return s.replaceAll("\\s+", " "); } + /** Размеры ("WxH") всех image XObject страницы 1 PDF (SMask тоже). */ + private static Set imageDims(Path pdf) throws IOException { + Set dims = new TreeSet<>(); + try (PDDocument doc = Loader.loadPDF(pdf.toFile())) { + PDResources res = doc.getPage(0).getResources(); + for (COSName name : res.getXObjectNames()) { + if (res.isImageXObject(name)) { + PDImageXObject img = (PDImageXObject) res.getXObject(name); + dims.add(img.getWidth() + "x" + img.getHeight()); + } + } + } + return dims; + } + /** /URI всех ссылочных аннотаций PDF'а (все страницы). */ private static List linkUris(Path pdf) throws IOException { List uris = new ArrayList<>(); @@ -230,6 +246,29 @@ class WordPdfConverterTest { "каждый из 14 графиков должен стать PNG-вставкой"); } + /** + * Chart-PNG не проходят docx4j «Compress Pictures» (CR-029): с + * {@code docx4j.convert.out.fo.images.resolution=220} (порог ниже + * 300 ppi наших растров) в PDF нативные 1500×900 фикстуры (extent 5″×3″ + * при 300 dpi) — {@code ChartImageHandler} для chart-частей вариант не + * выдаёт, decode+resample не запускается вовсе. + * Регрессия — ChartImageHandler#compressedVariant. + */ + @Test + void chartMedia_notDownsampled() throws Exception { + try { + Docx4jProperties.setProperty( + "docx4j.convert.out.fo.images.resolution", "220"); + Path pdf = convertPdf(sampleBytes("chart-types.docx"), "chart-types"); + Set dims = imageDims(pdf); + assertTrue(dims.contains("1500x900"), + "chart-растр обязан лечь в PDF нативным размером, найдено: " + dims); + } finally { + Docx4jProperties.setProperty( + "docx4j.convert.out.fo.images.resolution", "word"); + } + } + /** * errorOnCharts=true: находка диаграмм — {@link DrawingFoundException} * с {@code Kind.CHARTS}, документ отвергается целиком. Error-флаг SmartArt diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartImageHandlerTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartImageHandlerTest.java new file mode 100644 index 0000000..01e086e --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartImageHandlerTest.java @@ -0,0 +1,52 @@ +package ru.pjandro.wordpdf.internal.chart; + +import org.docx4j.Docx4jProperties; +import org.docx4j.model.images.AbstractWordXmlPicture; +import org.docx4j.openpackaging.parts.PartName; +import org.docx4j.openpackaging.parts.WordprocessingML.ImagePngPart; +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertNull; + +/** + * {@link ChartImageHandler}: для {@code /word/media/chart-*} вариантов + * «Compress Pictures» не существует вовсе (decode/resample не запускается), + * медиа документов получают штатный docx4j-вариант. + */ +class ChartImageHandlerTest { + + /** Картинка «для XSL-FO»: в этой точке super обязан вернуть подпись варианта. */ + private static final AbstractWordXmlPicture FO_PICTURE = + new AbstractWordXmlPicture() { + { + forXslFo = true; + } + }; + + /** + * Режим Word «Print» (свойство resolution=220 — порог ниже 300 ppi + * chart-растров): chart-часть — null (картинка уйдёт в PDF как есть), + * рядовая media-часть — вариант, т.е. CR-029 для неё жив. + */ + @Test + void compressedVariant_skipsChartPartsOnly() throws Exception { + try { + Docx4jProperties.setProperty("docx4j.convert.out.fo.images.resolution", "220"); + ChartImageHandler handler = new ChartImageHandler(); + + assertNull(handler.compressedVariant(FO_PICTURE, null, + pngPart(DrawingPreRenderer.CHART_MEDIA_URI_PREFIX + "1.png")), + "для chart-части вариант выдаваться не должен"); + assertNotNull(handler.compressedVariant(FO_PICTURE, null, + pngPart("/word/media/image9.png")), + "медиа документов обязан оставаться штатный вариант CR-029"); + } finally { + Docx4jProperties.setProperty("docx4j.convert.out.fo.images.resolution", "word"); + } + } + + private static ImagePngPart pngPart(String name) throws Exception { + return new ImagePngPart(new PartName(name)); + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawingPreRendererTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawingPreRendererTest.java new file mode 100644 index 0000000..c195025 --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawingPreRendererTest.java @@ -0,0 +1,109 @@ +package ru.pjandro.wordpdf.internal.chart; + +import org.docx4j.openpackaging.packages.WordprocessingMLPackage; +import org.docx4j.openpackaging.parts.Part; +import org.docx4j.openpackaging.parts.relationships.RelationshipsPart; +import org.docx4j.openpackaging.parts.WordprocessingML.BinaryPart; +import org.junit.jupiter.api.Test; + +import javax.imageio.ImageIO; +import java.awt.image.BufferedImage; +import java.io.ByteArrayInputStream; +import java.io.ByteArrayOutputStream; +import java.io.InputStream; +import java.util.ArrayList; +import java.util.List; + +import static org.junit.jupiter.api.Assertions.assertArrayEquals; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertSame; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * Ручная вставка chart-media-частей ({@link DrawingPreRenderer#addChartMedia}): + * часть держит исходные байты PNG (без docx4j-перекодирования), именуется с + * префиксом {@code /word/media/chart-} (маркер ChartImageHandler) и + * регистрируется с корректным r:id. + */ +class DrawingPreRendererTest { + + /** Миниатюрный настоящий PNG (2×2, заданный цвет). */ + private static byte[] png(int rgb) throws Exception { + BufferedImage img = new BufferedImage(2, 2, BufferedImage.TYPE_INT_ARGB); + img.setRGB(0, 0, 2, 2, new int[]{rgb, rgb, rgb, rgb}, 0, 2); + ByteArrayOutputStream bos = new ByteArrayOutputStream(); + ImageIO.write(img, "png", bos); + return bos.toByteArray(); + } + + /** Реальный пакет фикстуры (собственные rels документа, media нет). */ + private static WordprocessingMLPackage chartPkg() throws Exception { + try (InputStream in = DrawingPreRendererTest.class.getClassLoader() + .getResourceAsStream("samples/chart-types.docx")) { + assertNotNull(in, "Нет фикстуры: samples/chart-types.docx"); + return WordprocessingMLPackage.load(new ByteArrayInputStream(in.readAllBytes())); + } + } + + /** Все media-части пакета с префиксом chart-, отсортированы по имени. */ + private static List chartMedia(WordprocessingMLPackage pkg) { + List out = new ArrayList<>(); + for (Part p : pkg.getParts().getParts().values()) { + if (p.getPartName().getName().startsWith(DrawingPreRenderer.CHART_MEDIA_URI_PREFIX)) { + out.add(p); + } + } + out.sort((a, b) -> a.getPartName().getName().compareTo(b.getPartName().getName())); + return out; + } + + /** + * Вставленная часть: имя /word/media/chart-N.png, побайтно исходный PNG + * (docx4j {@code createImagePart} переписывал бы растр через decode) и + * r:id, ведущий ровно на эту часть. + */ + @Test + void addChartMediaKeepsBytesAndPrefix() throws Exception { + WordprocessingMLPackage pkg = chartPkg(); + byte[] png = png(0xFF00FF00); + + String relId = DrawingPreRenderer.addChartMedia(pkg, pkg.getMainDocumentPart(), png); + + assertNotNull(relId, "r:id не выдан"); + List media = chartMedia(pkg); + assertEquals(1, media.size(), "ожидалась одна chart-media-часть"); + assertTrue(media.get(0).getPartName().getName() + .startsWith(DrawingPreRenderer.CHART_MEDIA_URI_PREFIX), + "имя без префикса chart-: " + media.get(0).getPartName()); + assertArrayEquals(png, ((BinaryPart) media.get(0)).getBytes(), + "часть обязана держать исходные байты PNG"); + + RelationshipsPart rels = pkg.getMainDocumentPart().getRelationshipsPart(); + assertSame(media.get(0), rels.getPart(rels.getRelationshipByID(relId)), + "r:id ведёт не на вставленную часть"); + } + + /** + * Имена уникальны по реестру пакета (chart-1, chart-2): + * {@code PartName.generateUniqueName} уникальность не даёт, счётчик с + * проверкой реестра — единственная защита от взаимного затирания частей + * при нескольких графиках. + */ + @Test + void addChartMediaNamesAreUnique() throws Exception { + WordprocessingMLPackage pkg = chartPkg(); + byte[] green = png(0xFF00FF00); + byte[] red = png(0xFFFF0000); + + DrawingPreRenderer.addChartMedia(pkg, pkg.getMainDocumentPart(), green); + DrawingPreRenderer.addChartMedia(pkg, pkg.getMainDocumentPart(), red); + + List media = chartMedia(pkg); + assertEquals(2, media.size(), "ожидались две chart-media-части"); + List names = media.stream().map(p -> p.getPartName().getName()).toList(); + assertEquals(List.of("/word/media/chart-1.png", "/word/media/chart-2.png"), names); + assertArrayEquals(green, ((BinaryPart) media.get(0)).getBytes()); + assertArrayEquals(red, ((BinaryPart) media.get(1)).getBytes()); + } +}