core: chart-PNG без docx4j-декода и без пересжатия CR-029 (−23% alloc chart-документов)
PR checks / web (pull_request) Successful in 43s
PR checks / java (pull_request) Successful in 1m51s
Main: tests, deploy, autotests / web (push) Successful in 58s
Main: tests, deploy, autotests / images-web (push) Successful in 31s
Main: tests, deploy, autotests / java (push) Successful in 1m38s
Main: tests, deploy, autotests / images-app (push) Successful in 49s
Main: tests, deploy, autotests / deploy (push) Failing after 2m46s
Main: tests, deploy, autotests / autotests (push) Has been skipped
Main: tests, deploy, autotests / rollback (push) Successful in 2m20s
PR checks / web (pull_request) Successful in 43s
PR checks / java (pull_request) Successful in 1m51s
Main: tests, deploy, autotests / web (push) Successful in 58s
Main: tests, deploy, autotests / images-web (push) Successful in 31s
Main: tests, deploy, autotests / java (push) Successful in 1m38s
Main: tests, deploy, autotests / images-app (push) Successful in 49s
Main: tests, deploy, autotests / deploy (push) Failing after 2m46s
Main: tests, deploy, autotests / autotests (push) Has been skipped
Main: tests, deploy, autotests / rollback (push) Successful in 2m20s
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.
This commit was merged in pull request #88.
This commit is contained in:
@@ -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`.
|
||||
|
||||
### Критические инварианты (нарушение = битый вывод, не исключение)
|
||||
|
||||
+3
-1
@@ -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`.
|
||||
|
||||
@@ -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 встроил подмножество
|
||||
|
||||
@@ -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);
|
||||
}
|
||||
}
|
||||
+69
-16
@@ -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<Part> parts = new ArrayList<>(pkg.getParts().getParts().values());
|
||||
Set<Part> 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();
|
||||
}
|
||||
}
|
||||
|
||||
@@ -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<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'а (все страницы). */
|
||||
private static List<String> linkUris(Path pdf) throws IOException {
|
||||
List<String> 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<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}
|
||||
* с {@code Kind.CHARTS}, документ отвергается целиком. Error-флаг SmartArt
|
||||
|
||||
+52
@@ -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));
|
||||
}
|
||||
}
|
||||
+109
@@ -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());
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user