core: chart-PNG без docx4j-декода и без пересжатия CR-029 (−23% alloc) #88

Merged
pjandro merged 1 commits from perf/chart-media-churn into main 2026-11-03 00:41:07 +03:00
8 changed files with 328 additions and 17 deletions
+2
View File
@@ -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. 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`. Пейнтеры со всеми калибровками, `autoTitleDeleted`/автозаголовки, Combo-семантика, защитные обходы JAXB — `docs/agent/chart.md`.
### Критические инварианты (нарушение = битый вывод, не исключение) ### Критические инварианты (нарушение = битый вывод, не исключение)
+3 -1
View File
@@ -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` не рисуется). Пейнтеры: `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, каждая серия масштабируется по своей оси, вторичная ось — линия справа + подписи справа. **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`.
@@ -11,6 +11,7 @@ import org.docx4j.convert.out.fo.renderers.FORendererApacheFOP;
import org.docx4j.openpackaging.packages.WordprocessingMLPackage; import org.docx4j.openpackaging.packages.WordprocessingMLPackage;
import ru.pjandro.wordpdf.fonts.BundledFontMapper; import ru.pjandro.wordpdf.fonts.BundledFontMapper;
import ru.pjandro.wordpdf.fonts.BundledFonts; 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.chart.DrawingPreRenderer;
import ru.pjandro.wordpdf.internal.DependencyGuard; import ru.pjandro.wordpdf.internal.DependencyGuard;
import ru.pjandro.wordpdf.internal.DocxNormalizer; import ru.pjandro.wordpdf.internal.DocxNormalizer;
@@ -185,6 +186,13 @@ public final class WordPdfConverter {
// 4. Настройки экспорта (FOP-конфиг с embed-шрифтами) // 4. Настройки экспорта (FOP-конфиг с embed-шрифтами)
FOSettings foSettings = new FOSettings(pkg); 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, а символы // FOP-конфиг знает только шрифты из fontsInUse, а символы
// U+2000–U+2EFF (em-dash и т.п.) в FO маппятся на fallback // U+2000–U+2EFF (em-dash и т.п.) в FO маппятся на fallback
// семейство — декларируем его, чтобы FOP встроил подмножество // семейство — декларируем его, чтобы FOP встроил подмножество
@@ -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);
}
}
@@ -22,9 +22,13 @@ import org.docx4j.dml.diagram2008.CTDrawing;
import org.docx4j.dml.picture.Pic; import org.docx4j.dml.picture.Pic;
import org.docx4j.dml.wordprocessingDrawing.Anchor; import org.docx4j.dml.wordprocessingDrawing.Anchor;
import org.docx4j.dml.wordprocessingDrawing.Inline; 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.packages.WordprocessingMLPackage;
import org.docx4j.openpackaging.parts.JaxbXmlPart; import org.docx4j.openpackaging.parts.JaxbXmlPart;
import org.docx4j.openpackaging.parts.Part; import org.docx4j.openpackaging.parts.Part;
import org.docx4j.openpackaging.parts.PartName;
import org.docx4j.openpackaging.parts.ThemePart; import org.docx4j.openpackaging.parts.ThemePart;
import org.docx4j.openpackaging.parts.WordprocessingML.BinaryPartAbstractImage; import org.docx4j.openpackaging.parts.WordprocessingML.BinaryPartAbstractImage;
import org.docx4j.openpackaging.parts.relationships.RelationshipsPart; import org.docx4j.openpackaging.parts.relationships.RelationshipsPart;
@@ -36,6 +40,7 @@ import ru.pjandro.wordpdf.DrawingFoundException;
import javax.imageio.ImageIO; import javax.imageio.ImageIO;
import java.awt.image.BufferedImage; import java.awt.image.BufferedImage;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream; import java.io.ByteArrayOutputStream;
import java.lang.reflect.Method; import java.lang.reflect.Method;
import java.util.ArrayList; import java.util.ArrayList;
@@ -80,6 +85,14 @@ public final class DrawingPreRenderer {
*/ */
private static final long MAX_EXTENT_EMU = 22_000_000L; 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() { private DrawingPreRenderer() {
} }
@@ -98,8 +111,9 @@ public final class DrawingPreRenderer {
} }
DrawMlColor colors = new DrawMlColor(themePart == null ? null : themePart.getJaxbElement()); DrawMlColor colors = new DrawMlColor(themePart == null ? null : themePart.getJaxbElement());
// Снимок: createImagePart докидывает части в тот же реестр, // Снимок: вставка media-частей (addChartMedia→addPart→loadPart) докидывает
// обход живого HashMap дал бы ConcurrentModificationException. // части в тот же реестр, обход живого HashMap дал бы
// ConcurrentModificationException.
List<Part> parts = new ArrayList<>(pkg.getParts().getParts().values()); List<Part> parts = new ArrayList<>(pkg.getParts().getParts().values());
Set<Part> handled = new HashSet<>(); Set<Part> handled = new HashSet<>();
int[] idSeq = {1000}; int[] idSeq = {1000};
@@ -284,7 +298,15 @@ public final class DrawingPreRenderer {
return rel == null ? null : rels.getPart(rel); 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, private static void swapForPicture(Part part, GraphicData gd, BufferedImage img,
long cx, long cy, int[] idSeq, long cx, long cy, int[] idSeq,
WordprocessingMLPackage pkg) { WordprocessingMLPackage pkg) {
@@ -303,20 +325,14 @@ public final class DrawingPreRenderer {
gd.getAny().clear(); // контракт: упавший рендер — объект удалён gd.getAny().clear(); // контракт: упавший рендер — объект удалён
return; return;
} }
BinaryPartAbstractImage imagePart; String relId;
try { try {
imagePart = BinaryPartAbstractImage.createImagePart(pkg, part, png); relId = addChartMedia(pkg, part, png);
} catch (Exception e) { } catch (Exception e) {
LOG.warn("ImagePart не создан: {}", e.toString()); LOG.warn("ImagePart не создан: {}", e.toString());
gd.getAny().clear(); gd.getAny().clear();
return; return;
} }
String relId = relIdFor(part, imagePart);
if (relId == null) {
LOG.warn("r:id для ImagePart {} не найден", imagePart.getPartName());
gd.getAny().clear();
return;
}
Pic pic = new Pic(); Pic pic = new Pic();
org.docx4j.dml.picture.CTPictureNonVisual nv = new org.docx4j.dml.picture.CTPictureNonVisual(); org.docx4j.dml.picture.CTPictureNonVisual nv = new org.docx4j.dml.picture.CTPictureNonVisual();
@@ -358,12 +374,49 @@ public final class DrawingPreRenderer {
gd.getAny().add(pic); 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); RelationshipsPart rels = relsOf(part);
if (rels == null || rels.getRelationships() == null) { if (rels == null) {
return 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();
} }
} }
@@ -14,6 +14,7 @@ import org.apache.pdfbox.pdmodel.interactive.annotation.PDAnnotationLink;
import org.apache.pdfbox.rendering.PDFRenderer; import org.apache.pdfbox.rendering.PDFRenderer;
import org.apache.pdfbox.text.PDFTextStripper; import org.apache.pdfbox.text.PDFTextStripper;
import org.apache.poi.poifs.filesystem.POIFSFileSystem; import org.apache.poi.poifs.filesystem.POIFSFileSystem;
import org.docx4j.Docx4jProperties;
import org.junit.jupiter.api.Test; import org.junit.jupiter.api.Test;
import java.io.ByteArrayInputStream; import java.io.ByteArrayInputStream;
@@ -112,6 +113,21 @@ class WordPdfConverterTest {
return s.replaceAll("\\s+", " "); return s.replaceAll("\\s+", " ");
} }
/** Размеры ("WxH") всех image XObject страницы 1 PDF (SMask тоже). */
private static Set<String> imageDims(Path pdf) throws IOException {
Set<String> 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'а (все страницы). */ /** /URI всех ссылочных аннотаций PDF'а (все страницы). */
private static List<String> linkUris(Path pdf) throws IOException { private static List<String> linkUris(Path pdf) throws IOException {
List<String> uris = new ArrayList<>(); List<String> uris = new ArrayList<>();
@@ -230,6 +246,29 @@ class WordPdfConverterTest {
"каждый из 14 графиков должен стать PNG-вставкой"); "каждый из 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<String> dims = imageDims(pdf);
assertTrue(dims.contains("1500x900"),
"chart-растр обязан лечь в PDF нативным размером, найдено: " + dims);
} finally {
Docx4jProperties.setProperty(
"docx4j.convert.out.fo.images.resolution", "word");
}
}
/** /**
* errorOnCharts=true: находка диаграмм — {@link DrawingFoundException} * errorOnCharts=true: находка диаграмм — {@link DrawingFoundException}
* с {@code Kind.CHARTS}, документ отвергается целиком. Error-флаг SmartArt * с {@code Kind.CHARTS}, документ отвергается целиком. Error-флаг SmartArt
@@ -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));
}
}
@@ -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<Part> chartMedia(WordprocessingMLPackage pkg) {
List<Part> 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<Part> 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<Part> media = chartMedia(pkg);
assertEquals(2, media.size(), "ожидались две chart-media-части");
List<String> 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());
}
}