chart: 9 новых типов диаграмм (scatter/bubble/radar/stock/ofPie/surface2D/bar3D/area3D/line3D)
PR checks / web (pull_request) Successful in 55s
PR checks / java (pull_request) Successful in 1m6s
Main: tests, deploy, autotests / web (push) Successful in 32s
Main: tests, deploy, autotests / images-web (push) Successful in 35s
Main: tests, deploy, autotests / java (push) Successful in 2m17s
Main: tests, deploy, autotests / images-app (push) Successful in 31s
Main: tests, deploy, autotests / deploy (push) Successful in 1m46s
Main: tests, deploy, autotests / autotests (push) Successful in 52s
Main: tests, deploy, autotests / rollback (push) Has been skipped

- ChartSpec: enum +9 типов, readGroup 9 веток, два c:valAx для scatter/bubble
  (X — первый), автозаголовок OF_PIE как у круговых
- ChartRenderer: диспетчер + легенда высотных полос для SURFACE
- Пейнтеры: ScatterPainter, RadarPainter, StockPainter, OfPiePainter,
  Surface2dPainter, Cartesian3dPainter (камера Surface3dPainter.project)
- Фикстура samples/chart-types.docx (ChartTypesDocxGenerator, chart-XML
  литералами) + регрессия WordPdfConverterTest#chartTypes_allTypesRenderAsImages
- docs/standards: полные наборы XSD strict/transitional + validate-fixtures.py;
  все 13 фикстур валидны по ECMA-376 (битые атрибуты в старых фикстурах
  исправлены в генераторе и пересозданных .docx)
- AGENTS.md/README обновлены
This commit was merged in pull request #42.
This commit is contained in:
Pjandro
2026-10-25 02:13:28 +00:00
parent 6ab732b1b4
commit fbdada1fda
81 changed files with 33512 additions and 87 deletions
@@ -0,0 +1,263 @@
package ru.pjandro.wordpdf;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.ArrayList;
import java.util.List;
import java.util.zip.ZipEntry;
import java.util.zip.ZipOutputStream;
/**
* Генератор фикстуры {@code samples/chart-types.docx}: 9 диаграмм типов,
* которых POI не пишет (scatter, bubble, radar, stock, ofPie, bar3D,
* area3D, line3D, surface2D) — chart-XML литералами по ECMA-376 §21.2
* (фикстура проходит docs/standards/validate-fixtures.py). Регрессия —
* WordPdfConverterTest#chartTypes_allTypesRenderAsImages.
*
* Пересоздание (аргумент — путь к .docx):
* {@code mvn -pl wordpdf-core test-compile -Dmdep.outputFile=/tmp/cp.txt dependency:build-classpath -q &&
* javac -cp "$(cat /tmp/cp.txt)" -d /tmp/ct wordpdf-core/src/test/java/ru/pjandro/wordpdf/ChartTypesDocxGenerator.java &&
* java -cp "/tmp/ct:$(cat /tmp/cp.txt)" ru.pjandro.wordpdf.ChartTypesDocxGenerator wordpdf-core/src/test/resources/samples/chart-types.docx}
*/
public final class ChartTypesDocxGenerator {
private ChartTypesDocxGenerator() {
}
private static final String C = "http://schemas.openxmlformats.org/drawingml/2006/chart";
private static final String A = "http://schemas.openxmlformats.org/drawingml/2006/main";
private static final String R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
public static void main(String[] args) throws IOException {
Path out = Path.of(args[0]);
List<String> titles = List.of(
"Точечная", "Пузырьковая", "Лепестковая", "Биржевая",
"Кольцевая-доля", "Объёмная с столбцами", "Объёмная с областями",
"Объёмная с линиями", "Поверхность");
List<String> charts = new ArrayList<>();
charts.add(scatter());
charts.add(bubble());
charts.add(radar());
charts.add(stock());
charts.add(ofPie());
charts.add(bar3d());
charts.add(area3d());
charts.add(line3d());
charts.add(surface());
StringBuilder body = new StringBuilder();
body.append("<w:p><w:r><w:t>Типы диаграмм</w:t></w:r></w:p>");
StringBuilder docRels = new StringBuilder(
"<Relationships xmlns=\"http://schemas.openxmlformats.org/package/2006/relationships\">");
StringBuilder overrides = new StringBuilder();
for (int i = 0; i < charts.size(); i++) {
int n = i + 1;
body.append("<w:p><w:r><w:drawing>"
+ "<wp:inline xmlns:wp=\"http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing\""
+ " distT=\"0\" distB=\"0\" distL=\"0\" distR=\"0\">"
+ "<wp:extent cx=\"4572000\" cy=\"2743200\"/>"
+ "<wp:docPr id=\"" + n + "\" name=\"Диаграмма " + n + "\"/>"
+ "<a:graphic xmlns:a=\"" + A + "\"><a:graphicData uri=\"" + C + "\">"
+ "<c:chart xmlns:c=\"" + C + "\" xmlns:r=\"" + R + "\" r:id=\"rId" + n + "\"/>"
+ "</a:graphicData></a:graphic></wp:inline></w:drawing></w:r></w:p>");
docRels.append("<Relationship Id=\"rId").append(n)
.append("\" Type=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart\"")
.append(" Target=\"charts/chart").append(n).append(".xml\"/>");
overrides.append("<Override PartName=\"/word/charts/chart").append(n)
.append(".xml\" ContentType=\"application/vnd.openxmlformats-officedocument.drawingml.chart+xml\"/>");
}
docRels.append("</Relationships>");
ByteArrayOutputStream out2 = new ByteArrayOutputStream();
try (ZipOutputStream zos = new ZipOutputStream(out2)) {
put(zos, "[Content_Types].xml",
"<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>"
+ "<Types xmlns=\"http://schemas.openxmlformats.org/package/2006/content-types\">"
+ "<Default Extension=\"rels\" ContentType=\"application/vnd.openxmlformats-package.relationships+xml\"/>"
+ "<Default Extension=\"xml\" ContentType=\"application/xml\"/>"
+ "<Override PartName=\"/word/document.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml\"/>"
+ overrides
+ "</Types>");
put(zos, "_rels/.rels",
"<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>"
+ "<Relationships xmlns=\"http://schemas.openxmlformats.org/package/2006/relationships\">"
+ "<Relationship Id=\"rId1\" Type=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument\" Target=\"word/document.xml\"/>"
+ "</Relationships>");
put(zos, "word/document.xml",
"<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>"
+ "<w:document xmlns:w=\"http://schemas.openxmlformats.org/wordprocessingml/2006/main\">"
+ "<w:body>" + body
+ "<w:sectPr><w:pgSz w:w=\"11906\" w:h=\"16838\"/></w:sectPr></w:body></w:document>");
put(zos, "word/_rels/document.xml.rels",
"<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>" + docRels);
for (int i = 0; i < charts.size(); i++) {
put(zos, "word/charts/chart" + (i + 1) + ".xml",
space(titles.get(i), charts.get(i)));
}
}
Files.write(out, out2.toByteArray());
System.out.println("written " + out + " " + out2.size() + " bytes");
}
private static String space(String title, String groupWithAxes) {
return "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>"
+ "<c:chartSpace xmlns:c=\"" + C + "\" xmlns:a=\"" + A + "\" xmlns:r=\"" + R + "\">"
+ "<c:chart>"
+ "<c:title><c:tx><c:rich><a:bodyPr/><a:lstStyle/><a:p><a:r><a:t>" + title
+ "</a:t></a:r></a:p></c:rich></c:tx></c:title>"
+ "<c:plotArea><c:layout/>" + groupWithAxes + "</c:plotArea>"
+ "<c:legend><c:legendPos val=\"b\"/></c:legend>"
+ "<c:plotVisOnly val=\"1\"/>"
+ "</c:chart></c:chartSpace>";
}
// ---- группы ----
private static String scatter() {
return "<c:scatterChart><c:scatterStyle val=\"lineMarker\"/><c:varyColors val=\"0\"/>"
+ "<c:ser><c:idx val=\"0\"/><c:order val=\"0\"/><c:tx><c:v>Точки</c:v></c:tx>"
+ xVal("1", "2", "3", "4")
+ "<c:yVal><c:numRef><c:f>Лист1!$C$2:$C$5</c:f>" + numRef("2", "3", "5", "4") + "</c:numRef></c:yVal></c:ser>"
+ "<c:axId val=\"1\"/><c:axId val=\"2\"/></c:scatterChart>"
+ valAx(1, "b", 2) + valAx(2, "l", 1);
}
private static String bubble() {
return "<c:bubbleChart><c:varyColors val=\"1\"/>"
+ "<c:ser><c:idx val=\"0\"/><c:order val=\"0\"/><c:tx><c:v>Размер</c:v></c:tx>"
+ xVal("2", "3", "5", "7")
+ "<c:yVal><c:numRef><c:f>Лист1!$C$2:$C$5</c:f>" + numRef("4", "9", "6", "2") + "</c:numRef></c:yVal>"
+ "<c:bubbleSize><c:numRef><c:f>Лист1!$D$2:$D$5</c:f>" + numRef("1", "2", "3", "4") + "</c:numRef></c:bubbleSize>"
+ "</c:ser>"
+ "<c:bubbleScale val=\"20\"/><c:showNegBubbles val=\"0\"/>"
+ "<c:axId val=\"1\"/><c:axId val=\"2\"/></c:bubbleChart>"
+ valAx(1, "b", 2) + valAx(2, "l", 1);
}
private static String radar() {
return "<c:radarChart><c:radarStyle val=\"filled\"/><c:varyColors val=\"0\"/>"
+ ser("Профиль", cat("А", "Б", "В", "Г"), num("3", "7", "5", "8"))
+ "<c:axId val=\"1\"/><c:axId val=\"2\"/></c:radarChart>"
+ catAx(1, 2) + valAx(2, "l", 1);
}
private static String stock() {
return "<c:stockChart>"
+ ser("Мин", cat("Пн", "Вт", "Ср"), num("10", "14", "12"))
+ ser("Макс", cat("Пн", "Вт", "Ср"), num("20", "24", "18"))
+ ser("Закрытие", cat("Пн", "Вт", "Ср"), num("15", "22", "13"))
+ "<c:dropLines/><c:hiLowLines/>"
+ "<c:upDownBars><c:gapWidth val=\"60\"/>"
+ "<c:upBars><c:spPr><a:solidFill><a:srgbClr val=\"00B050\"/></a:solidFill></c:spPr></c:upBars>"
+ "<c:downBars><c:spPr><a:solidFill><a:srgbClr val=\"C00000\"/></a:solidFill></c:spPr></c:downBars>"
+ "</c:upDownBars>"
+ "<c:axId val=\"1\"/><c:axId val=\"2\"/></c:stockChart>"
+ catAx(1, 2) + valAx(2, "l", 1);
}
private static String ofPie() {
return "<c:ofPieChart><c:ofPieType val=\"bar\"/><c:varyColors val=\"1\"/>"
+ ser("Доли", cat("Север", "Юг", "Восток", "Запад", "Центр"),
num("40", "25", "18", "10", "7"))
+ "<c:splitType val=\"cust\"/>"
+ "<c:custSplit><c:secondPiePt val=\"3\"/><c:secondPiePt val=\"4\"/></c:custSplit>"
+ "<c:secondPieSize val=\"40\"/>"
+ "<c:serLines/>"
+ "</c:ofPieChart>";
}
private static String bar3d() {
return "<c:bar3DChart><c:barDir val=\"col\"/><c:grouping val=\"clustered\"/><c:varyColors val=\"0\"/>"
+ ser("План", cat("Q1", "Q2", "Q3"), num("5", "9", "7"))
+ ser("Факт", cat("Q1", "Q2", "Q3"), num("6", "8", "10"))
+ "<c:gapWidth val=\"150\"/><c:gapDepth val=\"150\"/><c:shape val=\"box\"/>"
+ "<c:axId val=\"1\"/><c:axId val=\"2\"/></c:bar3DChart>"
+ catAx(1, 2) + valAx(2, "l", 1);
}
private static String area3d() {
return "<c:area3DChart><c:grouping val=\"standard\"/><c:varyColors val=\"0\"/>"
+ ser("Серия 1", cat("Q1", "Q2", "Q3"), num("4", "7", "5"))
+ ser("Серия 2", cat("Q1", "Q2", "Q3"), num("6", "5", "9"))
+ "<c:gapDepth val=\"150\"/>"
+ "<c:axId val=\"1\"/><c:axId val=\"2\"/></c:area3DChart>"
+ catAx(1, 2) + valAx(2, "l", 1);
}
private static String line3d() {
return "<c:line3DChart><c:grouping val=\"standard\"/>"
+ ser("Серия 1", cat("Q1", "Q2", "Q3"), num("4", "7", "5"))
+ ser("Серия 2", cat("Q1", "Q2", "Q3"), num("6", "5", "9"))
+ "<c:gapDepth val=\"150\"/>"
+ "<c:axId val=\"1\"/><c:axId val=\"2\"/><c:axId val=\"3\"/></c:line3DChart>"
+ catAx(1, 2) + valAx(2, "l", 1) + serAx(3, 2);
}
private static String surface() {
return "<c:surfaceChart><c:wireframe val=\"0\"/>"
+ ser("Высота", cat("X1", "X2", "X3"), num("1", "5", "3"))
+ ser("Глубина", cat("X1", "X2", "X3"), num("4", "2", "6"))
+ "<c:axId val=\"1\"/><c:axId val=\"2\"/></c:surfaceChart>"
+ catAx(1, 2) + valAx(2, "l", 1);
}
// ---- фрагменты ----
/** ser с cat (или null) и val. */
private static String ser(String name, String cat, String val) {
return "<c:ser><c:idx val=\"0\"/><c:order val=\"0\"/><c:tx><c:v>" + name + "</c:v></c:tx>"
+ (cat == null ? "" : cat) + val + "</c:ser>";
}
private static String cat(String... names) {
StringBuilder sb = new StringBuilder("<c:cat><c:strRef><c:f>Лист1!$A$2:$A$"
+ (names.length + 1) + "</c:f><c:strCache><c:ptCount val=\"" + names.length + "\"/>");
for (int i = 0; i < names.length; i++) {
sb.append("<c:pt idx=\"").append(i).append("\"><c:v>").append(names[i]).append("</c:v></c:pt>");
}
return sb.append("</c:strCache></c:strRef></c:cat>").toString();
}
private static String num(String... vals) {
return "<c:val><c:numRef><c:f>Лист1!$B$2:$B$" + (vals.length + 1) + "</c:f>"
+ numRef(vals) + "</c:numRef></c:val>";
}
private static String numRef(String... vals) {
StringBuilder sb = new StringBuilder("<c:numCache><c:formatCode>Общий</c:formatCode>"
+ "<c:ptCount val=\"" + vals.length + "\"/>");
for (int i = 0; i < vals.length; i++) {
sb.append("<c:pt idx=\"").append(i).append("\"><c:v>").append(vals[i]).append("</c:v></c:pt>");
}
return sb.append("</c:numCache>").toString();
}
private static String xVal(String... vals) {
return "<c:xVal><c:numRef><c:f>Лист1!$A$2:$A$" + (vals.length + 1) + "</c:f>"
+ numRef(vals) + "</c:numRef></c:xVal>";
}
private static String valAx(int id, String pos, int cross) {
return "<c:valAx><c:axId val=\"" + id + "\"/><c:scaling><c:orientation val=\"minMax\"/></c:scaling>"
+ "<c:delete val=\"0\"/><c:axPos val=\"" + pos + "\"/><c:crossAx val=\"" + cross + "\"/></c:valAx>";
}
private static String catAx(int id, int cross) {
return "<c:catAx><c:axId val=\"" + id + "\"/><c:scaling><c:orientation val=\"minMax\"/></c:scaling>"
+ "<c:delete val=\"0\"/><c:axPos val=\"b\"/><c:crossAx val=\"" + cross + "\"/></c:catAx>";
}
private static String serAx(int id, int cross) {
return "<c:serAx><c:axId val=\"" + id + "\"/><c:scaling><c:orientation val=\"minMax\"/></c:scaling>"
+ "<c:delete val=\"0\"/><c:axPos val=\"b\"/><c:crossAx val=\"" + cross + "\"/></c:serAx>";
}
private static void put(ZipOutputStream zos, String name, String xml) throws IOException {
zos.putNextEntry(new ZipEntry(name));
zos.write(xml.getBytes(StandardCharsets.UTF_8));
zos.closeEntry();
}
}
@@ -147,6 +147,7 @@ public final class SampleDocxGenerator {
// Таблица 2x2 с границами
XWPFTable table = doc.createTable(2, 2);
addTableGrid(table, 2);
setCell(table, 0, 0, "Заголовок 1", "Calibri");
setCell(table, 0, 1, "Header 1", "Calibri");
setCell(table, 1, 0, "Ячейка А", "Calibri");
@@ -176,6 +177,7 @@ public final class SampleDocxGenerator {
heading(doc, "Таблица и изображение", "Arial");
XWPFTable table = doc.createTable(3, 2);
addTableGrid(table, 2);
setCell(table, 0, 0, "Имя", "Arial");
setCell(table, 0, 1, "Значение", "Arial");
setCell(table, 1, 0, "Шрифт", "Arial");
@@ -479,6 +481,19 @@ public final class SampleDocxGenerator {
setFont(r, font);
}
/**
* POI {@code createTable} не пишет {@code w:tblGrid}, а ECMA-376 §17.4.63
* (CT_Tbl) требует его обязательным между {@code w:tblPr} и {@code w:tr} —
* без него документ не conformant. XmlBeans вставляет элемент на
* schema-позицию (после tblPr), колонки — равной ширины.
*/
private static void addTableGrid(XWPFTable table, int cols) {
var grid = table.getCTTbl().addNewTblGrid();
for (int i = 0; i < cols; i++) {
grid.addNewGridCol().setW(BigInteger.valueOf(4320));
}
}
private static void save(XWPFDocument doc, Path out) throws Exception {
try (FileOutputStream fos = new FileOutputStream(out.toFile())) {
doc.write(fos);
@@ -1,11 +1,13 @@
package ru.pjandro.wordpdf;
import org.apache.pdfbox.Loader;
import org.apache.pdfbox.cos.COSBase;
import org.apache.pdfbox.cos.COSName;
import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDPage;
import org.apache.pdfbox.pdmodel.PDResources;
import org.apache.pdfbox.pdmodel.font.PDFont;
import org.apache.pdfbox.pdmodel.graphics.image.PDImageXObject;
import org.apache.pdfbox.text.PDFTextStripper;
import org.junit.jupiter.api.Test;
@@ -15,6 +17,7 @@ import java.io.IOException;
import java.io.InputStream;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.HashSet;
import java.util.List;
import java.util.Set;
import java.util.TreeSet;
@@ -131,6 +134,26 @@ class WordPdfConverterTest {
return count;
}
/** Количество РАЗЛИЧНЫХ image-потоков без SMask (FOP режет ARGB-PNG на
* картинку + мягкую маску, а большой PNG ещё и на горизонтальные полосы). */
private static int distinctImageCount(Path pdf) throws IOException {
Set<COSBase> streams = new HashSet<>();
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)) {
PDImageXObject img = (PDImageXObject) res.getXObject(name);
if (img.getSoftMask() == null) {
streams.add(img.getCOSObject());
}
}
}
}
}
return streams.size();
}
/**
* Диаграммы (c:chart) и SmartArt (dgm:relIds) до экспорта в FO
* рендерятся в PNG: без этого docx2fo.xslt выбрасывает весь w:drawing
@@ -146,6 +169,23 @@ class WordPdfConverterTest {
"ожидались 4 растра (SmartArt + 3 графика), найдено: " + imageCount(pdf));
}
/**
* Фикстура chart-types.docx (создана вручную, chart-XML литералами — POI
* эти типы не пишет): все девять новых типов — точечная, пузырьковая,
* лепестковая, биржевая, кольцевая-доля, три объёмных декартовых и
* поверхность — рендерятся в растр, а не удаляются с warn.
* Регрессия — WordPdfConverterTest#chartTypes_allNineRendered.
*/
@Test
void chartTypes_allNineRendered() throws Exception {
Path pdf = convertPdf(sampleBytes("chart-types.docx"), "chart-types");
String text = norm(pdfText(pdf));
assertTrue(text.contains("Типы диаграмм"), "пропал текст: " + text);
assertEquals(9, distinctImageCount(pdf),
"каждый из 9 графиков должен стать PNG-вставкой");
}
/**
* errorOnCharts=true: находка диаграмм — {@link DrawingFoundException}
* с {@code Kind.CHARTS}, документ отвергается целиком. Error-флаг SmartArt
@@ -0,0 +1,150 @@
package ru.pjandro.wordpdf.internal.chart;
import org.junit.jupiter.api.Test;
import java.awt.Color;
import java.awt.image.BufferedImage;
import java.util.ArrayList;
import java.util.List;
import static org.junit.jupiter.api.Assertions.*;
/**
* Объёмные декартовы графики (c:bar3DChart/line3DChart/area3DChart):
* колонки — связные прогоны цвета ряда по горизонтали, линия ряда —
* пиксели цвета, стена area — полупрозрачная заливка; c:shape≠box
* рисуется как box (документированное ограничение, тест его пинит).
* Регрессия — Cartesian3dPainterTest, фикстура samples/chart-types.docx
* (WordPdfConverterTest#chartTypes_allTypesRenderAsImages).
*/
class Cartesian3dPainterTest {
private static final Color ACCENT1 = new Color(0x4472C4);
/** accent1 с альфой 0,55 поверх белого (стена area3D). */
private static final Color FILLED = new Color(152, 178, 222);
/** Прогоны тоньше этого — антиалиасинг рёбер/подписей, не столбцы. */
private static final int MIN_RUN_PX = 8;
/** bar3D: три категории — три связных столбца цвета ряда. */
@Test
void bar3d_threeCategoriesThreeColumns() {
ChartSpec spec = bar3dSpec(3);
BufferedImage img = render(spec);
int bestRuns = 0;
for (int y = 0; y < img.getHeight(); y++) {
bestRuns = Math.max(bestRuns, runsInRow(img, y, ACCENT1));
}
assertEquals(3, bestRuns, "три категории bar3D должны дать три столбца");
}
/** line3D: линия ряда рисуется цветом ряда. */
@Test
void line3d_drawsSeriesLine() {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.LINE3D;
spec.legendPos = null;
ChartSpec.Series s = new ChartSpec.Series();
s.values.add(1.0);
s.values.add(3.0);
s.values.add(2.0);
spec.series.add(s);
assertTrue(countColor(render(spec), ACCENT1) > 200,
"линии line3D не найдено");
}
/** area3D: стена ряда — полупрозрачная заливка цвета ряда. */
@Test
void area3d_drawsTranslucentWall() {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.AREA3D;
spec.legendPos = null;
ChartSpec.Series s = new ChartSpec.Series();
s.values.add(2.0);
s.values.add(4.0);
s.values.add(3.0);
spec.series.add(s);
assertTrue(countColor(render(spec), FILLED) > 500,
"полупрозрачной стены area3D не найдено");
}
/** c:shape="cylinder" рисуется как box — документированное ограничение. */
@Test
void shape3d_cylinderRendersAsBox() {
ChartSpec box = bar3dSpec(3);
box.shape3d = "box";
ChartSpec cylinder = bar3dSpec(3);
cylinder.shape3d = "cylinder";
BufferedImage a = render(box);
BufferedImage b = render(cylinder);
for (int y = 0; y < a.getHeight(); y++) {
for (int x = 0; x < a.getWidth(); x++) {
assertEquals(a.getRGB(x, y), b.getRGB(x, y),
"shape3d не должен влиять на рендер (рисуются боксы)");
}
}
}
private static ChartSpec bar3dSpec(int nCat) {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.BAR3D;
spec.legendPos = null;
ChartSpec.Series s = new ChartSpec.Series();
for (int i = 0; i < nCat; i++) {
s.values.add(5.0);
}
spec.series.add(s);
return spec;
}
private static BufferedImage render(ChartSpec spec) {
return ChartRenderer.render(spec, 219.23, 149.08, new DrawMlColor(null));
}
/** Число связных прогонов цвета в строке. */
private static int runsInRow(BufferedImage img, int y, Color c) {
boolean in = false;
List<Integer> lens = new ArrayList<>();
int len = 0;
for (int x = 0; x < img.getWidth(); x++) {
boolean hit = matches(img.getRGB(x, y), c);
if (hit && !in) {
in = true;
len = 0;
} else if (!hit && in) {
in = false;
lens.add(len);
}
if (hit) {
len++;
}
}
int real = 0;
for (int l : lens) {
if (l >= MIN_RUN_PX) {
real++;
}
}
if (in && len >= MIN_RUN_PX) {
real++;
}
return real;
}
private static long countColor(BufferedImage img, Color c) {
long n = 0;
for (int y = 0; y < img.getHeight(); y++) {
for (int x = 0; x < img.getWidth(); x++) {
if (matches(img.getRGB(x, y), c)) {
n++;
}
}
}
return n;
}
private static boolean matches(int rgb, Color c) {
return Math.abs(((rgb >> 16) & 0xFF) - c.getRed()) <= 24
&& Math.abs(((rgb >> 8) & 0xFF) - c.getGreen()) <= 24
&& Math.abs((rgb & 0xFF) - c.getBlue()) <= 24;
}
}
@@ -8,6 +8,12 @@ import org.docx4j.dml.CTSolidColorFillProperties;
import org.docx4j.dml.CTSRgbColor;
import org.docx4j.dml.CTTextBody;
import org.docx4j.dml.CTTextParagraph;
import org.docx4j.dml.chart.CTArea3DChart;
import org.docx4j.dml.chart.CTBar3DChart;
import org.docx4j.dml.chart.CTBubbleChart;
import org.docx4j.dml.chart.CTBubbleScale;
import org.docx4j.dml.chart.CTBubbleSer;
import org.docx4j.dml.chart.CTCustSplit;
import org.docx4j.dml.chart.CTAreaChart;
import org.docx4j.dml.chart.CTAreaSer;
import org.docx4j.dml.chart.CTAxDataSource;
@@ -43,29 +49,51 @@ import org.docx4j.dml.chart.CTNumFmt;
import org.docx4j.dml.chart.CTNumRef;
import org.docx4j.dml.chart.CTNumVal;
import org.docx4j.dml.chart.CTOverlap;
import org.docx4j.dml.chart.CTPerspective;
import org.docx4j.dml.chart.CTLine3DChart;
import org.docx4j.dml.chart.CTPieChart;
import org.docx4j.dml.chart.CTPieSer;
import org.docx4j.dml.chart.CTPlotArea;
import org.docx4j.dml.chart.CTRotY;
import org.docx4j.dml.chart.CTScaling;
import org.docx4j.dml.chart.CTSerAx;
import org.docx4j.dml.chart.CTOfPieChart;
import org.docx4j.dml.chart.CTOfPieType;
import org.docx4j.dml.chart.CTPerspective;
import org.docx4j.dml.chart.CTPieSer;
import org.docx4j.dml.chart.CTSerTx;
import org.docx4j.dml.chart.CTTx;
import org.docx4j.dml.chart.STLegendPos;
import org.junit.jupiter.api.Test;
import org.docx4j.dml.chart.CTRotY;
import org.docx4j.dml.chart.CTRadarChart;
import org.docx4j.dml.chart.CTRadarSer;
import org.docx4j.dml.chart.CTRadarStyle;
import org.docx4j.dml.chart.CTScatterChart;
import org.docx4j.dml.chart.CTScatterSer;
import org.docx4j.dml.chart.CTScatterStyle;
import org.docx4j.dml.chart.CTShape;
import org.docx4j.dml.chart.CTSizeRepresents;
import org.docx4j.dml.chart.CTSplitType;
import org.docx4j.dml.chart.CTStockChart;
import org.docx4j.dml.chart.CTSerAx;
import org.docx4j.dml.chart.CTSecondPieSize;
import org.docx4j.dml.chart.CTStrData;
import org.docx4j.dml.chart.CTStrRef;
import org.docx4j.dml.chart.CTStrVal;
import org.docx4j.dml.chart.CTSurface3DChart;
import org.docx4j.dml.chart.CTSurfaceSer;
import org.docx4j.dml.chart.CTTitle;
import org.docx4j.dml.chart.CTTx;
import org.docx4j.dml.chart.CTUpDownBar;
import org.docx4j.dml.chart.CTUpDownBars;
import org.docx4j.dml.chart.CTUnsignedInt;
import org.docx4j.dml.chart.CTValAx;
import org.docx4j.dml.chart.CTView3D;
import org.docx4j.dml.chart.STAxPos;
import org.docx4j.dml.chart.STBarDir;
import org.docx4j.dml.chart.STLegendPos;
import org.docx4j.dml.chart.STOfPieType;
import org.docx4j.dml.chart.STMarkerStyle;
import org.junit.jupiter.api.Test;
import org.docx4j.dml.chart.STRadarStyle;
import org.docx4j.dml.chart.STScatterStyle;
import org.docx4j.dml.chart.STShape;
import org.docx4j.dml.chart.STSizeRepresents;
import org.docx4j.dml.chart.STSplitType;
import java.awt.Color;
import java.util.List;
@@ -1119,4 +1147,279 @@ class ChartSpecTest {
assertEquals(Color.BLUE, s.fillAt(0, List.of(Color.RED)), "c:dPt приоритетнее c:fill");
assertEquals(Color.MAGENTA, s.fillAt(1, List.of(Color.RED)), "c:fill приоритетнее палитры");
}
// ---- новые типы: scatter/bubble/radar/stock/ofPie/3D-декартовы ----
/** c:scatterChart: c:xVal/c:yVal и c:scatterStyle разбираются. */
@Test
void scatterXyValuesParsed() {
CTScatterChart chart = new CTScatterChart();
CTScatterStyle style = new CTScatterStyle();
style.setVal(STScatterStyle.LINE_MARKER);
chart.setScatterStyle(style);
CTScatterSer ser = new CTScatterSer();
CTSerTx tx = new CTSerTx();
tx.setV("Точки");
ser.setTx(tx);
ser.setXVal(axisNum(1.5, 2.5));
ser.setYVal(numSource(numCache(10, 20)));
chart.getSer().add(ser);
ChartSpec spec = new ChartSpec();
ChartSpec.readGroup(chart, spec, new DrawMlColor(null), List.of());
assertEquals(ChartSpec.Type.SCATTER, spec.type);
assertEquals("lineMarker", spec.scatterStyle);
assertEquals("Точки", spec.series.get(0).name);
assertEquals(List.of(1.5, 2.5), spec.series.get(0).xValues);
assertEquals(List.of(10.0, 20.0), spec.series.get(0).values);
}
/** scatter: первая c:valAx — ось X, вторая — ось значений. */
@Test
void scatterFirstValAxisIsX() {
CTChart chart = new CTChart();
CTPlotArea pa = new CTPlotArea();
CTScatterChart sc = new CTScatterChart();
sc.getSer().add(new CTScatterSer());
pa.getAreaChartOrArea3DChartOrLineChart().add(sc);
pa.getValAxOrCatAxOrDateAx().add(valAxWithMin(100));
pa.getValAxOrCatAxOrDateAx().add(valAxWithMin(-5));
chart.setPlotArea(pa);
ChartSpec spec = ChartSpec.parse(spaceWith(chart), new DrawMlColor(null));
assertEquals(100.0, spec.xAxis.min, "первая c:valAx должна стать осью X");
assertEquals(-5.0, spec.valAxis.min, "вторая c:valAx должна остаться осью значений");
}
/** c:bubbleChart: bubbleScale/showNegBubbles/sizeRepresents и c:bubbleSize. */
@Test
void bubbleSizesAndScaleParsed() {
CTBubbleChart chart = new CTBubbleChart();
CTBubbleScale scale = new CTBubbleScale();
scale.setVal(150L);
chart.setBubbleScale(scale);
CTBoolean neg = new CTBoolean();
neg.setVal(false);
chart.setShowNegBubbles(neg);
CTSizeRepresents rep = new CTSizeRepresents();
rep.setVal(STSizeRepresents.W);
chart.setSizeRepresents(rep);
CTBubbleSer ser = new CTBubbleSer();
ser.setXVal(axisNum(1, 2));
ser.setYVal(numSource(numCache(5, 6)));
ser.setBubbleSize(numSource(numCache(1, 4)));
chart.getSer().add(ser);
ChartSpec spec = new ChartSpec();
ChartSpec.readGroup(chart, spec, new DrawMlColor(null), List.of());
assertEquals(ChartSpec.Type.BUBBLE, spec.type);
assertEquals(150, spec.bubbleScale);
assertFalse(spec.showNegBubbles);
assertEquals("w", spec.sizeRepresents);
assertEquals(List.of(1.0, 4.0), spec.series.get(0).bubbleSizes);
}
/** c:radarChart: c:radarStyle и ряд с категориями. */
@Test
void radarStyleParsed() {
CTRadarChart chart = new CTRadarChart();
CTRadarStyle style = new CTRadarStyle();
style.setVal(STRadarStyle.FILLED);
chart.setRadarStyle(style);
CTRadarSer ser = new CTRadarSer();
ser.setCat(catStr("А", "Б"));
ser.setVal(numSource(numCache(1, 2)));
chart.getSer().add(ser);
ChartSpec spec = new ChartSpec();
ChartSpec.readGroup(chart, spec, new DrawMlColor(null), List.of());
assertEquals(ChartSpec.Type.RADAR, spec.type);
assertEquals("filled", spec.radarStyle);
assertEquals(List.of("А", "Б"), spec.series.get(0).categories);
}
/** c:stockChart: hiLowLines/dropLines/upDownBars с цветами up/down. */
@Test
void stockFlagsParsed() {
CTStockChart chart = new CTStockChart();
chart.setHiLowLines(new CTChartLines());
chart.setUpDownBars(upDownBars());
chart.getSer().add(new CTLineSer());
chart.getSer().add(new CTLineSer());
chart.getSer().add(new CTLineSer());
ChartSpec spec = new ChartSpec();
ChartSpec.readGroup(chart, spec, new DrawMlColor(null), List.of());
assertEquals(ChartSpec.Type.STOCK, spec.type);
assertTrue(spec.hiLowLines);
assertFalse(spec.dropLines, "нет c:dropLines — флага нет");
assertTrue(spec.upDownBars);
assertEquals(80, spec.upDownGapWidth);
assertEquals(new Color(0, 0xB0, 0x50), spec.upFill);
assertEquals(new Color(0xC0, 0, 0), spec.downFill);
assertEquals(3, spec.series.size());
}
/** c:ofPieChart: custSplit → secondPiePts, percent/pos со splitPos, auto-дефолт. */
@Test
void ofPieSplitParsed() {
CTOfPieChart cust = new CTOfPieChart();
CTSplitType custType = new CTSplitType();
custType.setVal(STSplitType.CUST);
cust.setSplitType(custType);
CTCustSplit cs = new CTCustSplit();
cs.getSecondPiePt().add(uint(1));
cs.getSecondPiePt().add(uint(3));
cust.setCustSplit(cs);
ChartSpec spec = new ChartSpec();
ChartSpec.readGroup(cust, spec, new DrawMlColor(null), List.of());
assertEquals(ChartSpec.Type.OF_PIE, spec.type);
assertEquals("cust", spec.splitType);
assertEquals(List.of(1, 3), spec.secondPiePts);
ChartSpec def = new ChartSpec();
ChartSpec.readGroup(new CTOfPieChart(), def, new DrawMlColor(null), List.of());
assertEquals("auto", def.splitType, "без c:splitType — дефолт auto");
assertNull(def.splitPos);
}
/** c:ofPieChart: ofPieType="bar", secondPieSize, splitPos, serLines. */
@Test
void ofPieTypeAndSecondPieSizeParsed() {
CTOfPieChart chart = new CTOfPieChart();
CTOfPieType type = new CTOfPieType();
type.setVal(STOfPieType.BAR);
chart.setOfPieType(type);
CTSecondPieSize size = new CTSecondPieSize();
size.setVal(60);
chart.setSecondPieSize(size);
CTSplitType split = new CTSplitType();
split.setVal(STSplitType.PERCENT);
chart.setSplitType(split);
CTDouble pos = new CTDouble();
pos.setVal(5);
chart.setSplitPos(pos);
chart.getSerLines().add(new CTChartLines());
chart.getSer().add(new CTPieSer());
ChartSpec spec = new ChartSpec();
ChartSpec.readGroup(chart, spec, new DrawMlColor(null), List.of());
assertEquals("bar", spec.ofPieType);
assertEquals(60, spec.secondPieSize);
assertEquals("percent", spec.splitType);
assertEquals(5.0, spec.splitPos);
assertTrue(spec.serLines);
assertEquals(1, spec.series.size());
}
/** bar3D: barDir/gapWidth/gapDepth/shape; area3D/line3D: gapDepth. */
@Test
void threeDCartesianGapDepthShapeParsed() {
CTBar3DChart bar = new CTBar3DChart();
CTBarDir dir = new CTBarDir();
dir.setVal(STBarDir.BAR);
bar.setBarDir(dir);
CTGapAmount gw = new CTGapAmount();
gw.setVal(200);
bar.setGapWidth(gw);
CTGapAmount gd = new CTGapAmount();
gd.setVal(120);
bar.setGapDepth(gd);
CTShape shape = new CTShape();
shape.setVal(STShape.CYLINDER);
bar.setShape(shape);
ChartSpec barSpec = new ChartSpec();
ChartSpec.readGroup(bar, barSpec, new DrawMlColor(null), List.of());
assertEquals(ChartSpec.Type.BAR3D, barSpec.type);
assertTrue(barSpec.bar3dHorizontal);
assertEquals(200, barSpec.gapWidth);
assertEquals(120, barSpec.gapDepth);
assertEquals("cylinder", barSpec.shape3d);
CTArea3DChart area = new CTArea3DChart();
CTGapAmount agd = new CTGapAmount();
agd.setVal(90);
area.setGapDepth(agd);
ChartSpec areaSpec = new ChartSpec();
ChartSpec.readGroup(area, areaSpec, new DrawMlColor(null), List.of());
assertEquals(ChartSpec.Type.AREA3D, areaSpec.type);
assertEquals(90, areaSpec.gapDepth);
CTLine3DChart line = new CTLine3DChart();
ChartSpec lineSpec = new ChartSpec();
ChartSpec.readGroup(line, lineSpec, new DrawMlColor(null), List.of());
assertEquals(ChartSpec.Type.LINE3D, lineSpec.type);
assertEquals(150, lineSpec.gapDepth, "без c:gapDepth — дефолт 150");
}
/** Автозаголовок OF_PIE — имя ряда (круговая семантика, как PIE). */
@Test
void autoTitleOfPieUsesSeriesName() {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.OF_PIE;
ChartSpec.Series s = new ChartSpec.Series();
s.name = "Распределение";
spec.series.add(s);
ChartSpec.readTitle(emptyTitleChart(), spec, new DrawMlColor(null));
assertEquals("Распределение", spec.title);
}
/** MAX_POINTS распространяется и на c:xVal (тот же numCache-обход). */
@Test
void hugePointIndexOnXValRejected() {
CTScatterChart chart = new CTScatterChart();
CTScatterSer ser = new CTScatterSer();
CTNumData cache = new CTNumData();
cache.getPt().add(numPt(2_000_000_000L, "5"));
CTAxDataSource xVal = new CTAxDataSource();
CTNumRef ref = new CTNumRef();
ref.setNumCache(cache);
xVal.setNumRef(ref);
ser.setXVal(xVal);
chart.getSer().add(ser);
CTChart ct = new CTChart();
CTPlotArea pa = new CTPlotArea();
pa.getAreaChartOrArea3DChartOrLineChart().add(chart);
ct.setPlotArea(pa);
assertThrows(IllegalArgumentException.class,
() -> ChartSpec.parse(spaceWith(ct), new DrawMlColor(null)));
}
private static CTNumData numCache(double... vals) {
CTNumData cache = new CTNumData();
for (int i = 0; i < vals.length; i++) {
cache.getPt().add(numPt(i, String.valueOf(vals[i])));
}
return cache;
}
private static CTAxDataSource axisNum(double... vals) {
CTAxDataSource x = new CTAxDataSource();
CTNumRef ref = new CTNumRef();
ref.setNumCache(numCache(vals));
x.setNumRef(ref);
return x;
}
private static CTValAx valAxWithMin(double min) {
CTValAx ax = new CTValAx();
CTScaling scaling = new CTScaling();
CTDouble m = new CTDouble();
m.setVal(min);
scaling.setMin(m);
ax.setScaling(scaling);
return ax;
}
private static CTUpDownBars upDownBars() {
CTUpDownBars u = new CTUpDownBars();
CTGapAmount gap = new CTGapAmount();
gap.setVal(80);
u.setGapWidth(gap);
CTUpDownBar up = new CTUpDownBar();
CTShapeProperties upSp = new CTShapeProperties();
upSp.setSolidFill(fill("00B050"));
up.setSpPr(upSp);
u.setUpBars(up);
CTUpDownBar down = new CTUpDownBar();
CTShapeProperties downSp = new CTShapeProperties();
downSp.setSolidFill(fill("C00000"));
down.setSpPr(downSp);
u.setDownBars(down);
return u;
}
}
@@ -0,0 +1,158 @@
package ru.pjandro.wordpdf.internal.chart;
import org.junit.jupiter.api.Test;
import java.awt.Color;
import java.awt.image.BufferedImage;
import static org.junit.jupiter.api.Assertions.*;
/**
* Комбинированная диаграмма: главный пирог слева, вторичная — справа
* (ECMA-376 §21.2.2.108); c:splitType="cust" отправляет во второй торт
* ровно перечисленные c:secondPiePt, "percent" — точки ниже доли, пустой
* secondary — обычная круговая. Регрессия — OfPiePainterTest, фикстура
* samples/chart-types.docx (WordPdfConverterTest#chartTypes_allTypesRenderAsImages).
*/
class OfPiePainterTest {
private static final Color ACCENT1 = new Color(0x4472C4);
private static final Color ACCENT2 = new Color(0xED7D31);
/** «Цветной» px — разброс каналов (как в пиксельных тестах chart-пейнтеров). */
private static final int GRAY_MAX_SPREAD = 25;
/** cust-разбиение: заданные точки — во вторичном кластере справа. */
@Test
void custSplit_movesListedPointsToSecondary() {
ChartSpec spec = ofPieSpec("cust", null);
spec.secondPiePts.add(1);
spec.secondPiePts.add(2);
BufferedImage img = render(spec);
assertTrue(onlyRight(img, ACCENT2), "точка 1 не во вторичном торте");
assertTrue(onlyLeft(img, ACCENT1), "точка 0 ушла из главного торта");
}
/** percent-разбиение: минимальные значения уходят во вторичный торт. */
@Test
void percentSplit_movesSmallestPoints() {
ChartSpec spec = ofPieSpec("percent", 5.0);
spec.series.get(0).values.clear();
spec.series.get(0).values.add(100.0);
spec.series.get(0).values.add(1.0);
spec.series.get(0).values.add(2.0);
spec.series.get(0).values.add(100.0);
BufferedImage img = render(spec);
assertTrue(onlyRight(img, ACCENT2), "минимальная точка не во вторичном торте");
}
/** Пустой secondary (val без splitPos) — один торт, а не два. */
@Test
void emptySecondary_singlePie() {
ChartSpec split = ofPieSpec("cust", null);
split.secondPiePts.add(1);
ChartSpec single = ofPieSpec("val", null);
double splitExtent = extent(render(split));
double singleExtent = extent(render(single));
assertTrue(splitExtent > singleExtent * 1.25,
"вторичный торт не расширяет силуэт: split=" + splitExtent
+ ", single=" + singleExtent);
}
/** c:serLines — связи серого цвета только с элементом. */
@Test
void serLines_drawnOnlyWithElement() {
ChartSpec spec = ofPieSpec("cust", null);
spec.series.get(0).values.set(3, 1.0);
// accent3 (A5A5A5) совпал бы с цветом serLines по допуску — перекрашиваем точку 2
spec.series.get(0).pointFills.put(2, new Color(0, 0xB0, 0x50));
spec.secondPiePts.add(3);
assertEquals(0, countColor(render(spec), OfPiePainter.SER_LINE_COLOR),
"без c:serLines связей быть не должно");
spec.serLines = true;
assertTrue(countColor(render(spec), OfPiePainter.SER_LINE_COLOR) > 20,
"c:serLines не нарисована");
}
private static ChartSpec ofPieSpec(String splitType, Double splitPos) {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.OF_PIE;
spec.splitType = splitType;
spec.splitPos = splitPos;
spec.legendPos = null;
ChartSpec.Series s = new ChartSpec.Series();
s.values.add(10.0);
s.values.add(1.0);
s.values.add(2.0);
s.values.add(20.0);
spec.series.add(s);
return spec;
}
private static BufferedImage render(ChartSpec spec) {
return ChartRenderer.render(spec, 219.23, 149.08, new DrawMlColor(null));
}
/** Пиксели цвета есть, и все — правее середины. */
private static boolean onlyRight(BufferedImage img, Color c) {
return side(img, c, true);
}
/** Пиксели цвета есть, и все — левее середины. */
private static boolean onlyLeft(BufferedImage img, Color c) {
return side(img, c, false);
}
private static boolean side(BufferedImage img, Color c, boolean right) {
int mid = img.getWidth() / 2;
int n = 0;
for (int y = 0; y < img.getHeight(); y++) {
for (int x = 0; x < img.getWidth(); x++) {
if (matches(img.getRGB(x, y), c)) {
if ((x >= mid) != right) {
return false;
}
n++;
}
}
}
return n > 100;
}
/** Горизонтальный размер всех насыщенных пикселей. */
private static int extent(BufferedImage img) {
int min = Integer.MAX_VALUE;
int max = -1;
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;
if (Math.max(Math.max(r, g), b) - Math.min(Math.min(r, g), b) > GRAY_MAX_SPREAD) {
min = Math.min(min, x);
max = Math.max(max, x);
}
}
}
return max < 0 ? 0 : max - min + 1;
}
private static long countColor(BufferedImage img, Color c) {
long n = 0;
for (int y = 0; y < img.getHeight(); y++) {
for (int x = 0; x < img.getWidth(); x++) {
if (matches(img.getRGB(x, y), c)) {
n++;
}
}
}
return n;
}
private static boolean matches(int rgb, Color c) {
return Math.abs(((rgb >> 16) & 0xFF) - c.getRed()) <= 24
&& Math.abs(((rgb >> 8) & 0xFF) - c.getGreen()) <= 24
&& Math.abs((rgb & 0xFF) - c.getBlue()) <= 24;
}
}
@@ -0,0 +1,94 @@
package ru.pjandro.wordpdf.internal.chart;
import org.junit.jupiter.api.Test;
import java.awt.Color;
import java.awt.image.BufferedImage;
import static org.junit.jupiter.api.Assertions.*;
/**
* Лепестковая диаграмма: паутина (концентрические многоугольники + спицы)
* рисуется цветом сетки, c:radarStyle="filled" — полупрозрачная заливка без
* контура и маркеров, "marker" — контур с маркерами (ECMA-376 §21.2.2.119).
* Регрессия — RadarPainterTest, фикстура samples/chart-types.docx
* (WordPdfConverterTest#chartTypes_allTypesRenderAsImages).
*/
class RadarPainterTest {
private static final Color ACCENT1 = new Color(0x4472C4);
private static final Color GRID = new Color(0xD9, 0xD9, 0xD9);
/** accent1 с альфой 0,55 поверх белого: 0,55·c + 0,45·255. */
private static final Color FILLED = new Color(152, 178, 222);
/** Паутина (сетка + спицы) рисуется цветом gridlines оси значений. */
@Test
void web_drawnInGridColor() {
BufferedImage img = render(radarSpec("standard"));
assertTrue(countColor(img, GRID) > 500,
"паутины лепестковой диаграммы не найдено");
}
/** "filled" — залитая область, чистого цвета ряда (контур/маркеры) нет. */
@Test
void filledStyle_fillsWithoutOutline() {
BufferedImage img = render(radarSpec("filled"));
assertTrue(countColor(img, FILLED) > 1000,
"заливки filled не найдено");
assertEquals(0, countColor(img, ACCENT1),
"filled не рисует контур и маркеры чистым цветом ряда");
}
/** "marker" — к контуру добавляются маркеры (пикселей больше, чем у standard). */
@Test
void markerStyle_addsMarkers() {
long standard = countColor(render(radarSpec("standard")), ACCENT1);
long marker = countColor(render(radarSpec("marker")), ACCENT1);
assertTrue(standard > 200, "контура standard не найдено");
assertTrue(marker > standard,
"маркеров больше, чем контура: marker=" + marker + ", standard=" + standard);
}
private static ChartSpec radarSpec(String style) {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.RADAR;
spec.radarStyle = style;
spec.legendPos = null;
DrawMlText.Style label = new DrawMlText.Style(9, false, false,
new Color(0x59, 0x59, 0x59), "carlito");
spec.valAxis = new ChartSpec.AxisSpec();
spec.valAxis.labelStyle = label;
spec.catAxis = new ChartSpec.AxisSpec();
spec.catAxis.labelStyle = label;
ChartSpec.Series s = new ChartSpec.Series();
s.values.add(2.0);
s.values.add(4.0);
s.values.add(3.0);
s.values.add(5.0);
spec.series.add(s);
spec.categories.add("А");
spec.categories.add("Б");
spec.categories.add("В");
spec.categories.add("Г");
return spec;
}
private static BufferedImage render(ChartSpec spec) {
return ChartRenderer.render(spec, 219.23, 149.08, new DrawMlColor(null));
}
private static long countColor(BufferedImage img, Color c) {
long n = 0;
for (int y = 0; y < img.getHeight(); y++) {
for (int x = 0; x < img.getWidth(); x++) {
int rgb = img.getRGB(x, y);
if (Math.abs(((rgb >> 16) & 0xFF) - c.getRed()) <= 24
&& Math.abs(((rgb >> 8) & 0xFF) - c.getGreen()) <= 24
&& Math.abs((rgb & 0xFF) - c.getBlue()) <= 24) {
n++;
}
}
}
return n;
}
}
@@ -0,0 +1,169 @@
package ru.pjandro.wordpdf.internal.chart;
import org.junit.jupiter.api.Test;
import java.awt.Color;
import java.awt.image.BufferedImage;
import static org.junit.jupiter.api.Assertions.*;
/**
* Точечная и пузырьковая диаграммы: маркеры по c:marker, линия по
* c:scatterStyle, радиус пузыря sqrt(size) при c:sizeRepresents="area"
* (ECMA-376 §21.2.2.128/.136). Замер — счётчики пикселей цвета ряда
* (эталона Word 300 dpi для этих типов в репо нет).
* Регрессия — ScatterPainterTest, фикстура samples/chart-types.docx
* (WordPdfConverterTest#chartTypes_allTypesRenderAsImages).
*/
class ScatterPainterTest {
private static final Color ACCENT1 = new Color(0x4472C4);
private static final Color ACCENT2 = new Color(0xED7D31);
/** Точки scatter рисуются маркерами (c:marker по умолчанию). */
@Test
void markers_drawnForEveryPoint() {
ChartSpec spec = scatterSpec("marker");
BufferedImage img = render(spec);
assertTrue(countColor(img, ACCENT1) > 200,
"маркеров ряда (accent1) не найдено");
}
/** scatterStyle="line" рисует связную линию между точками, "marker" — нет. */
@Test
void lineStyle_connectsPoints() {
long withLine = countColor(render(scatterSpec("line")), ACCENT1);
long markersOnly = countColor(render(scatterSpec("marker")), ACCENT1);
assertTrue(withLine > 5 * markersOnly,
"линия между точками не рисуется: line=" + withLine
+ " px, marker=" + markersOnly + " px");
}
/** c:sizeRepresents="area": радиусы относятся как sqrt(1):sqrt(4) = 1:2. */
@Test
void bubbleAreaRadiiScaleWithSqrt() {
ChartSpec spec = bubbleSpec("area", true);
BufferedImage img = render(spec);
double r1 = radiusOf(img, ACCENT1);
double r2 = radiusOf(img, ACCENT2);
assertTrue(r1 > 0 && r2 > 0, "пузырей не найдено");
double ratio = r2 / r1;
assertTrue(Math.abs(ratio - 2) / 2 < 0.10,
"отношение радиусов size 1:4 при \"area\" = " + ratio + ", ожидается 2");
}
/** c:sizeRepresents="w": радиусы относятся линейно 1:4. */
@Test
void bubbleWidthRadiiScaleLinearly() {
ChartSpec spec = bubbleSpec("w", true);
BufferedImage img = render(spec);
double ratio = radiusOf(img, ACCENT2) / radiusOf(img, ACCENT1);
assertTrue(Math.abs(ratio - 4) / 4 < 0.10,
"отношение радиусов size 1:4 при \"w\" = " + ratio + ", ожидается 4");
}
/** showNegBubbles="0" — отрицательный пузырь не рисуется. */
@Test
void negativeBubbleHiddenWhenShowNegBubblesOff() {
ChartSpec hidden = bubbleSpec("area", false);
assertEquals(0, countColor(render(hidden), ACCENT2),
"отрицательный пузырь нарисован при showNegBubbles=false");
ChartSpec shown = bubbleSpec("area", true);
assertTrue(countColor(render(shown), ACCENT2) > 200,
"отрицательный пузырь не нарисован при showNegBubbles=true");
}
/** Пустые данные — пустой растр (как у CartesianPainter). */
@Test
void emptyData_paintsNothing() {
ChartSpec spec = scatterSpec("marker");
spec.series.clear();
BufferedImage img = render(spec);
assertEquals(0, countColor(img, ACCENT1), "на пустых данных рисовать нечего");
}
private static ChartSpec scatterSpec(String style) {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.SCATTER;
spec.scatterStyle = style;
spec.legendPos = null;
DrawMlText.Style label = new DrawMlText.Style(9, false, false,
new Color(0x59, 0x59, 0x59), "carlito");
spec.valAxis = new ChartSpec.AxisSpec();
spec.valAxis.labelStyle = label;
spec.xAxis = new ChartSpec.AxisSpec();
spec.xAxis.labelStyle = label;
ChartSpec.Series s = new ChartSpec.Series();
s.xValues.add(1.0);
s.xValues.add(2.0);
s.xValues.add(3.0);
s.values.add(1.0);
s.values.add(2.0);
s.values.add(3.0);
spec.series.add(s);
return spec;
}
private static ChartSpec bubbleSpec(String sizeRepresents, boolean showNeg) {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.BUBBLE;
spec.sizeRepresents = sizeRepresents;
spec.showNegBubbles = showNeg;
// bubbleScale=20: пузыри не клипаются рамкой и не перекрываются
spec.bubbleScale = 20;
spec.legendPos = null;
DrawMlText.Style label = new DrawMlText.Style(9, false, false,
new Color(0x59, 0x59, 0x59), "carlito");
spec.valAxis = new ChartSpec.AxisSpec();
spec.valAxis.labelStyle = label;
spec.xAxis = new ChartSpec.AxisSpec();
spec.xAxis.labelStyle = label;
ChartSpec.Series s = new ChartSpec.Series();
s.xValues.add(1.0);
s.xValues.add(2.0);
s.values.add(5.0);
s.values.add(5.0);
s.bubbleSizes.add(1.0);
s.bubbleSizes.add(showNeg ? 4.0 : -4.0);
spec.series.add(s);
return spec;
}
private static BufferedImage render(ChartSpec spec) {
return ChartRenderer.render(spec, 219.23, 149.08, new DrawMlColor(null));
}
/** Пикселей точно цвета c (с допуском на антиалиасинг ±24 по каналу). */
private static long countColor(BufferedImage img, Color c) {
long n = 0;
for (int y = 0; y < img.getHeight(); y++) {
for (int x = 0; x < img.getWidth(); x++) {
int rgb = img.getRGB(x, y);
if (Math.abs(((rgb >> 16) & 0xFF) - c.getRed()) <= 24
&& Math.abs(((rgb >> 8) & 0xFF) - c.getGreen()) <= 24
&& Math.abs((rgb & 0xFF) - c.getBlue()) <= 24) {
n++;
}
}
}
return n;
}
/** Радиус кластера цвета: половина горизонтального прогона. */
private static double radiusOf(BufferedImage img, Color c) {
int min = Integer.MAX_VALUE;
int max = -1;
for (int y = 0; y < img.getHeight(); y++) {
for (int x = 0; x < img.getWidth(); x++) {
int rgb = img.getRGB(x, y);
if (Math.abs(((rgb >> 16) & 0xFF) - c.getRed()) <= 24
&& Math.abs(((rgb >> 8) & 0xFF) - c.getGreen()) <= 24
&& Math.abs((rgb & 0xFF) - c.getBlue()) <= 24) {
min = Math.min(min, x);
max = Math.max(max, x);
}
}
}
return max < 0 ? 0 : (max - min + 1) / 2.0;
}
}
@@ -0,0 +1,124 @@
package ru.pjandro.wordpdf.internal.chart;
import org.junit.jupiter.api.Test;
import java.awt.Color;
import java.awt.image.BufferedImage;
import static org.junit.jupiter.api.Assertions.*;
/**
* Биржевая диаграмма: c:hiLowLines (вертикаль min..max категории, серый),
* c:upDownBars (столбик первый↔последний ряд: вверх — зелёный, вниз —
* красный), c:dropLines (точка → базовая линия) — ECMA-376 §21.2.2.61/.172/.65.
* Регрессия — StockPainterTest, фикстура samples/chart-types.docx
* (WordPdfConverterTest#chartTypes_allTypesRenderAsImages).
*/
class StockPainterTest {
private static final Color HI_LOW = StockPainter.HI_LOW_COLOR;
private static final Color UP = StockPainter.UP_FILL;
private static final Color DOWN = StockPainter.DOWN_FILL;
private static final Color DROP = StockPainter.DROP_COLOR;
/** hiLowLines: вертикаль цвета HI_LOW появляется только с элементом. */
@Test
void hiLowLines_drawnBetweenMinMax() {
ChartSpec spec = stockSpec(false, false, false);
assertEquals(0, countColor(render(spec), HI_LOW),
"без c:hiLowLines серых вертикалей быть не должно");
spec.hiLowLines = true;
assertTrue(countColor(render(spec), HI_LOW) > 50,
"c:hiLowLines не нарисована");
}
/** upDownBars: последний ряд выше первого — вверх (зелёный), ниже — вниз. */
@Test
void upDownBars_colorByDirection() {
ChartSpec up = stockSpec(false, true, false);
assertTrue(countColor(render(up), UP) > 100,
"upDownBars «вверх» не нарисована (последний ряд выше первого)");
assertEquals(0, countColor(render(up), DOWN), "лишняя down-полоса");
ChartSpec down = stockSpec(false, true, true);
assertTrue(countColor(render(down), DOWN) > 100,
"upDownBars «вниз» не нарисована (последний ряд ниже первого)");
}
/** dropLines: вертикали до базовой линии только с элементом. */
@Test
void dropLines_drawnToBaseline() {
ChartSpec spec = stockSpec(false, false, false);
assertEquals(0, countColor(render(spec), DROP),
"без c:dropLines серых дропов быть не должно");
spec.dropLines = true;
assertTrue(countColor(render(spec), DROP) > 50,
"c:dropLines не нарисована");
}
/** Ни одного факультативного элемента — ни одного цвета из перечня. */
@Test
void noOptionalElements_noneDrawn() {
BufferedImage img = render(stockSpec(false, false, false));
assertEquals(0, countColor(img, HI_LOW));
assertEquals(0, countColor(img, UP));
assertEquals(0, countColor(img, DOWN));
assertEquals(0, countColor(img, DROP));
}
/** @param inverted последний ряд ниже первого (down-полоса). */
private static ChartSpec stockSpec(boolean withDrop, boolean withUpDown,
boolean inverted) {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.STOCK;
spec.legendPos = null;
spec.hiLowLines = false;
spec.dropLines = withDrop;
spec.upDownBars = withUpDown;
// подписи/линия оси/рамка chartSpace выключены: антиалиасинг их
// серых пикселей совпадает с константами hiLow/dropLines по допуску
spec.chartBorder = null;
spec.valAxis = new ChartSpec.AxisSpec();
spec.catAxis = new ChartSpec.AxisSpec();
spec.catAxis.axisLineColor = null;
ChartSpec.Series first = new ChartSpec.Series();
first.values.add(10.0);
first.values.add(20.0);
ChartSpec.Series last = new ChartSpec.Series();
last.values.add(inverted ? 5.0 : 30.0);
last.values.add(inverted ? 10.0 : 50.0);
spec.series.add(first);
spec.series.add(last);
spec.categories.add("Пн");
spec.categories.add("Вт");
return spec;
}
private static BufferedImage render(ChartSpec spec) {
return ChartRenderer.render(spec, 219.23, 149.08, new DrawMlColor(null));
}
private static long countColor(BufferedImage img, Color c) {
boolean gray = c.getRed() == c.getGreen() && c.getGreen() == c.getBlue();
long n = 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;
// серые цели: только нейтральные пиксели — голубые/тёплые
// края антиалиасинга не должны попадать в допуск-куб
if (gray && Math.max(Math.max(r, g), b) - Math.min(Math.min(r, g), b) > 12) {
continue;
}
if (Math.abs(r - c.getRed()) <= 24
&& Math.abs(g - c.getGreen()) <= 24
&& Math.abs(b - c.getBlue()) <= 24) {
n++;
}
}
}
return n;
}
}
@@ -0,0 +1,95 @@
package ru.pjandro.wordpdf.internal.chart;
import org.junit.jupiter.api.Test;
import java.awt.Color;
import java.awt.image.BufferedImage;
import static org.junit.jupiter.api.Assertions.*;
/**
* Контурная поверхностная диаграмма (ECMA-376 §21.2.2.204): лист между
* ломаными соседних рядов режется контурными полосами высот (c:bandFmts,
* §21.2.2.13 — от низкого к высокого; без них — палитра), c:wireframe —
* сетка из ломаных рядов и линий по категориям без заливок. Регрессия —
* Surface2dPainterTest, фикстура samples/chart-types.docx
* (WordPdfConverterTest#chartTypes_allTypesRenderAsImages).
*/
class Surface2dPainterTest {
private static final Color ACCENT1 = new Color(0x4472C4);
private static final Color ACCENT2 = new Color(0xED7D31);
private static final Color ACCENT3 = new Color(0xA5A5A5);
private static final Color ACCENT4 = new Color(0xFFC000);
private static final Color GRID = new Color(0xD9, 0xD9, 0xD9);
/**
* Плоские ряды 0/2/4: lo=0, hi=4, unit=1 → лист от 0 до 4 делится на
* четыре горизонтальные полосы высот: снизу вверх accent1 (0-1),
* accent2 (1-2), accent3 (2-3), accent4 (3-4).
*/
@Test
void contourStripes_areValueBandsBottomUp() {
BufferedImage img = render(surfaceSpec(false));
assertTrue(matches(px(img, 400, 507), ACCENT1),
"полоса 0-1 не accent1: " + hex(px(img, 400, 507)));
assertTrue(matches(px(img, 400, 368), ACCENT2),
"полоса 1-2 не accent2: " + hex(px(img, 400, 368)));
assertTrue(matches(px(img, 400, 227), ACCENT3),
"полоса 2-3 не accent3: " + hex(px(img, 400, 227)));
assertTrue(matches(px(img, 400, 87), ACCENT4),
"полоса 3-4 не accent4: " + hex(px(img, 400, 87)));
}
/** wireframe: заливок нет, есть сетка листа цветом gridlines. */
@Test
void wireframe_gridOnly() {
BufferedImage img = render(surfaceSpec(true));
assertFalse(matches(px(img, 400, 507), ACCENT1),
"wireframe не должен заливать полосы");
long grid = 0;
for (int y = 0; y < img.getHeight(); y++) {
for (int x = 0; x < img.getWidth(); x++) {
if (matches(img.getRGB(x, y), GRID)) {
grid++;
}
}
}
assertTrue(grid > 500, "сетки wireframe не найдено");
}
private static ChartSpec surfaceSpec(boolean wireframe) {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.SURFACE;
spec.wireframe = wireframe;
spec.legendPos = null;
spec.valAxis = new ChartSpec.AxisSpec();
double[] rows = {0, 2, 4};
for (double row : rows) {
ChartSpec.Series s = new ChartSpec.Series();
for (int c = 0; c < 3; c++) {
s.values.add(row);
}
spec.series.add(s);
}
return spec;
}
private static BufferedImage render(ChartSpec spec) {
return ChartRenderer.render(spec, 219.23, 149.08, new DrawMlColor(null));
}
private static int px(BufferedImage img, int x, int y) {
return img.getRGB(x, y);
}
private static boolean matches(int rgb, Color c) {
return Math.abs(((rgb >> 16) & 0xFF) - c.getRed()) <= 24
&& Math.abs(((rgb >> 8) & 0xFF) - c.getGreen()) <= 24
&& Math.abs((rgb & 0xFF) - c.getBlue()) <= 24;
}
private static String hex(int rgb) {
return String.format("#%06X", rgb & 0xFFFFFF);
}
}