feat: диаграммы как формулы — геометрия из семантики DrawingML вместо подгонки под растр Word #21

Merged
pjandro merged 5 commits from feat/chart-spec-math into main 2026-10-21 01:42:15 +03:00
3 changed files with 306 additions and 0 deletions
Showing only changes of commit cd7d9f1386 - Show all commits
@@ -0,0 +1,119 @@
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:gapWidth/c:overlap (ECMA-376: зазор между
* группами категорий и перекрытие рядов внутри группы — в процентах
* ширины бара). Замер по растру: связные прогоны залитых пикселей в
* строке, пересекающей все столбцы; слот категории — расстояние между
* началами соседних прогонов.
*/
class CartesianPainterTest {
/** Word default gapWidth=150, один ряд: bar = slot/(1 + 1,5) = 0,4·slot. */
@Test
void barWidthMatchesGapWidth() {
List<int[]> runs = barRuns(barSpec(150, 0, 1));
assertEquals(2, runs.size(), "две категории — два столбца");
double slot = runs.get(1)[0] - runs.get(0)[0];
assertRatio("ширина столбца при gapWidth=150",
(runs.get(0)[1] - runs.get(0)[0] + 1) / slot, 0.4);
}
/** gapWidth=0: столбцы сливаются в один прогон шириной nCat·slot. */
@Test
void zeroGapWidthBarsTouch() {
List<int[]> withGap = barRuns(barSpec(150, 0, 1));
double slot = withGap.get(1)[0] - withGap.get(0)[0];
List<int[]> noGap = barRuns(barSpec(0, 0, 1));
assertEquals(1, noGap.size(), "gapWidth=0 — столбцы касаются, один прогон");
assertRatio("прогон при gapWidth=0 = nCat·slot",
noGap.get(0)[1] - noGap.get(0)[0] + 1, 2 * slot);
}
/** overlap=50: ряды перекрываются наполовину — группа уже на полбара. */
@Test
void overlapShiftsSeriesBars() {
List<int[]> runs = barRuns(barSpec(0, 50, 2));
assertEquals(2, runs.size(), "две группы категорий");
double slot = runs.get(1)[0] - runs.get(0)[0];
// barW = slot/2, связная ширина группы = barW + step = barW·1,5 = 0,75·slot
assertRatio("связная ширина группы при overlap=50",
runs.get(0)[1] - runs.get(0)[0] + 1, 0.75 * slot);
}
private static ChartSpec barSpec(double gapWidth, double overlap, int nSer) {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.BAR;
spec.gapWidth = gapWidth;
spec.overlap = overlap;
spec.legendPos = null;
// стили осей, как у реального c:chartSpace (CartesianPainter мерит
// высоту подписей до отрисовки)
DrawMlText.Style style = new DrawMlText.Style(9, false, false,
new Color(0x59, 0x59, 0x59), "carlito");
spec.catAxis = new ChartSpec.AxisSpec();
spec.catAxis.labelStyle = style;
spec.valAxis = new ChartSpec.AxisSpec();
spec.valAxis.labelStyle = style;
for (int si = 0; si < nSer; si++) {
ChartSpec.Series s = new ChartSpec.Series();
s.values.add(5.0);
s.values.add(5.0);
spec.series.add(s);
}
return spec;
}
/** Прогоны залитых пикселей в строке с наибольшей заливкой. */
private static List<int[]> barRuns(ChartSpec spec) {
BufferedImage img = ChartRenderer.render(spec, 219.23, 149.08, new DrawMlColor(null));
List<int[]> best = List.of();
int bestColored = 0;
for (int y = (int) (img.getHeight() * 0.55); y < img.getHeight() * 0.9; y++) {
List<int[]> runs = new ArrayList<>();
int colored = 0;
int runStart = -1;
for (int x = 0; x <= img.getWidth(); x++) {
boolean filled = x < img.getWidth() && saturated(img.getRGB(x, y));
if (filled) {
colored++;
if (runStart < 0) {
runStart = x;
}
} else if (runStart >= 0) {
runs.add(new int[]{runStart, x - 1});
runStart = -1;
}
}
if (colored > bestColored) {
bestColored = colored;
best = runs;
}
}
return best;
}
private static boolean saturated(int rgb) {
int r = (rgb >> 16) & 0xFF;
int g = (rgb >> 8) & 0xFF;
int b = rgb & 0xFF;
return Math.max(Math.max(r, g), b) - Math.min(Math.min(r, g), b) > 25;
}
private static void assertRatio(String what, double actual, double expected) {
double deviation = Math.abs(actual - expected) / Math.abs(expected);
assertTrue(deviation < 0.06,
what + ": получено " + String.format("%.0f", actual)
+ " px, ожидается " + String.format("%.0f", expected)
+ " px (отклонение " + String.format("%.1f", deviation * 100) + "%)");
}
}
@@ -1,10 +1,19 @@
package ru.pjandro.wordpdf.internal.chart; package ru.pjandro.wordpdf.internal.chart;
import org.docx4j.dml.chart.CTBarChart;
import org.docx4j.dml.chart.CTBoolean; import org.docx4j.dml.chart.CTBoolean;
import org.docx4j.dml.chart.CTChart; import org.docx4j.dml.chart.CTChart;
import org.docx4j.dml.chart.CTDoughnutChart;
import org.docx4j.dml.chart.CTFirstSliceAng;
import org.docx4j.dml.chart.CTGapAmount;
import org.docx4j.dml.chart.CTHoleSize;
import org.docx4j.dml.chart.CTOverlap;
import org.docx4j.dml.chart.CTPieChart;
import org.docx4j.dml.chart.CTTitle; import org.docx4j.dml.chart.CTTitle;
import org.junit.jupiter.api.Test; import org.junit.jupiter.api.Test;
import java.util.List;
import static org.junit.jupiter.api.Assertions.*; import static org.junit.jupiter.api.Assertions.*;
/** /**
@@ -46,6 +55,66 @@ class ChartSpecTest {
assertNull(spec.title); assertNull(spec.title);
} }
@Test
void barGapWidthAndOverlapParsed() {
CTBarChart chart = new CTBarChart();
CTGapAmount gap = new CTGapAmount();
gap.setVal(220);
chart.setGapWidth(gap);
CTOverlap overlap = new CTOverlap();
overlap.setVal((byte) -27);
chart.setOverlap(overlap);
ChartSpec spec = new ChartSpec();
ChartSpec.readGroup(chart, spec, new DrawMlColor(null), List.of());
assertEquals(ChartSpec.Type.BAR, spec.type);
assertEquals(220, spec.gapWidth);
assertEquals(-27, spec.overlap);
}
@Test
void pieFirstSliceAngParsed() {
CTPieChart chart = new CTPieChart();
CTFirstSliceAng ang = new CTFirstSliceAng();
ang.setVal(90);
chart.setFirstSliceAng(ang);
ChartSpec spec = new ChartSpec();
ChartSpec.readGroup(chart, spec, new DrawMlColor(null), List.of());
assertEquals(ChartSpec.Type.PIE, spec.type);
assertEquals(90, spec.firstSliceAng);
}
@Test
void doughnutHoleSizeParsed() {
CTDoughnutChart chart = new CTDoughnutChart();
CTFirstSliceAng ang = new CTFirstSliceAng();
ang.setVal(45);
chart.setFirstSliceAng(ang);
CTHoleSize hole = new CTHoleSize();
hole.setVal((short) 75);
chart.setHoleSize(hole);
ChartSpec spec = new ChartSpec();
ChartSpec.readGroup(chart, spec, new DrawMlColor(null), List.of());
assertEquals(ChartSpec.Type.DOUGHNUT, spec.type);
assertEquals(45, spec.firstSliceAng);
assertEquals(75, spec.holeSize);
}
/**
* Дефолты ECMA-376/Word при отсутствии элементов: firstSliceAng 0,
* holeSize 50, gapWidth 150, overlap 0.
*/
@Test
void chartDefaultsMatchWord() {
ChartSpec doughnut = new ChartSpec();
ChartSpec.readGroup(new CTDoughnutChart(), doughnut, new DrawMlColor(null), List.of());
assertEquals(0, doughnut.firstSliceAng);
assertEquals(50, doughnut.holeSize);
ChartSpec bar = new ChartSpec();
ChartSpec.readGroup(new CTBarChart(), bar, new DrawMlColor(null), List.of());
assertEquals(150, bar.gapWidth);
assertEquals(0, bar.overlap);
}
private static CTChart emptyTitleChart() { private static CTChart emptyTitleChart() {
CTChart chart = new CTChart(); CTChart chart = new CTChart();
chart.setTitle(new CTTitle()); chart.setTitle(new CTTitle());
@@ -82,6 +82,124 @@ class PiePainterTest {
+ "синего " + blue + " px, оранжевого " + orange + " px"); + "синего " + blue + " px, оранжевого " + orange + " px");
} }
/**
* c:holeSize (ECMA-376, default 50) — диаметр дырки doughnut в процентах
* от внешнего диаметра: на центральной строке кольца белая дырка между
* левой и правой дугой.
*/
@Test
void doughnutHoleMatchesHoleSize() {
ChartSpec spec = pieSpec(ChartSpec.Type.DOUGHNUT);
spec.holeSize = 60;
BufferedImage img = ChartRenderer.render(spec, 219.23, 149.08, new DrawMlColor(null));
int minX = Integer.MAX_VALUE;
int maxX = -1;
int minY = Integer.MAX_VALUE;
int maxY = -1;
for (int y = 0; y < img.getHeight(); y++) {
for (int x = 0; x < img.getWidth(); x++) {
if (saturated(img.getRGB(x, y))) {
minX = Math.min(minX, x);
maxX = Math.max(maxX, x);
minY = Math.min(minY, y);
maxY = Math.max(maxY, y);
}
}
}
int cy = (minY + maxY) / 2;
List<int[]> runs = runsOnRow(img, cy);
assertEquals(2, runs.size(), "на центральной строке — два полукольца");
double outer = maxX - minX + 1;
double hole = runs.get(1)[0] - runs.get(0)[1] - 1;
assertRatio("дырка/внешний диаметр doughnut", hole / outer, 0.6);
}
/**
* c:firstSliceAng (ECMA-376, default 0) поворачивает старт первого
* сектора: один сектор 90° при firstSliceAng=90 занимает правую нижнюю
* четверть (90°..180° от 12 часов по часовой), а не верхнюю правую (0°..90°).
*/
@Test
void firstSliceAngRotatesStart() {
ChartSpec spec = pieSpec(ChartSpec.Type.PIE);
spec.firstSliceAng = 90;
spec.series.get(0).values.clear();
spec.series.get(0).values.add(1.0);
spec.series.get(0).values.add(3.0);
BufferedImage img = ChartRenderer.render(spec, 219.23, 149.08, new DrawMlColor(null));
long blueX = 0;
long blueY = 0;
long blue = 0;
int minX = Integer.MAX_VALUE;
int maxX = -1;
int minY = Integer.MAX_VALUE;
int maxY = -1;
for (int y = 0; y < img.getHeight(); y++) {
for (int x = 0; x < img.getWidth(); x++) {
int rgb = img.getRGB(x, y);
if (!saturated(rgb)) {
continue;
}
minX = Math.min(minX, x);
maxX = Math.max(maxX, x);
minY = Math.min(minY, y);
maxY = Math.max(maxY, y);
int r = (rgb >> 16) & 0xFF;
int g = (rgb >> 8) & 0xFF;
int b = rgb & 0xFF;
if (b > r + 40 && b > g + 40) { // accent1 — первый (единственный малый) сектор
blueX += x;
blueY += y;
blue++;
}
}
}
assertTrue(blue > 1000, "слишком мало пикселей первого сектора: " + blue);
double cx = (minX + maxX) / 2.0;
double cy = (minY + maxY) / 2.0;
assertTrue(blueX / (double) blue > cx && blueY / (double) blue > cy,
"сектор 90° при firstSliceAng=90 должен быть в правой нижней четверти");
}
private static ChartSpec pieSpec(ChartSpec.Type type) {
ChartSpec spec = new ChartSpec();
spec.type = type;
spec.legendPos = null;
ChartSpec.Series s = new ChartSpec.Series();
s.values.add(1.0);
s.values.add(1.0);
s.categories.addAll(List.of("Кв. 1", "Кв. 2"));
spec.series.add(s);
return spec;
}
/** Связные прогоны залитых пикселей в строке. */
private static List<int[]> runsOnRow(BufferedImage img, int y) {
List<int[]> runs = new java.util.ArrayList<>();
int runStart = -1;
for (int x = 0; x <= img.getWidth(); x++) {
boolean filled = x < img.getWidth() && saturated(img.getRGB(x, y));
if (filled) {
if (runStart < 0) {
runStart = x;
}
} else if (runStart >= 0) {
runs.add(new int[]{runStart, x - 1});
runStart = -1;
}
}
return runs;
}
private static boolean saturated(int rgb) {
int r = (rgb >> 16) & 0xFF;
int g = (rgb >> 8) & 0xFF;
int b = rgb & 0xFF;
return Math.max(Math.max(r, g), b) - Math.min(Math.min(r, g), b) > 25;
}
private static ChartSpec pie3dSpec() { private static ChartSpec pie3dSpec() {
ChartSpec spec = new ChartSpec(); ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.PIE3D; spec.type = ChartSpec.Type.PIE3D;