Surface2dPainter: wireframe-контур — вид сверху как Word (изолинии marching squares)
PR checks / web (pull_request) Successful in 36s
PR checks / java (pull_request) Successful in 1m40s
Main: tests, deploy, autotests / web (push) Successful in 33s
Main: tests, deploy, autotests / images-web (push) Successful in 30s
Main: tests, deploy, autotests / java (push) Successful in 1m24s
Main: tests, deploy, autotests / images-app (push) Successful in 1m59s
Main: tests, deploy, autotests / deploy (push) Successful in 1m26s
Main: tests, deploy, autotests / autotests (push) Successful in 49s
Main: tests, deploy, autotests / rollback (push) Has been skipped

c:wireframe val="1" (§21.2.2.230) рисовался линейной диаграммой «значение ×
категория» (ломаные рядов + вертикали) — неверная геометрия. Word рисует вид
сверху: X — категории, Y — ряды (серия 0 внизу), без заливок и оси значений;
только изолинии на внутренних границах полос высот lo+k·unit цветом полосы
ниже уровня (marching squares, седло — по среднему ячейки, узлы на уровне —
ребро-сегмент/дедупликация пересечений), сетка узлов catAx/serAx, рамка
области, подписи рядов со стороны serAx (axPos="r" — справа).

Фикстура chart-types.docx: +13-я диаграмма «Поверхность без заливки»
(4 ряда × 5 категорий «холмом», catAx/serAx с c:majorGridlines);
chartTypes_allTypesRenderAsImages — 13 растров. Surface2dPainterTest:
wireframe_gridOnly удалён (пинил снятое поведение), +4 рендер-теста
изолиний + 5 юнитов cellSegments. AGENTS.md синхронизирован.
This commit was merged in pull request #50.
This commit is contained in:
Pjandro
2026-10-25 19:13:54 +00:00
parent 90e3b8040b
commit 922bc915ba
6 changed files with 579 additions and 62 deletions
+2 -2
View File
File diff suppressed because one or more lines are too long
@@ -5,24 +5,32 @@ import java.awt.Color;
import java.awt.Graphics2D; import java.awt.Graphics2D;
import java.awt.RenderingHints; import java.awt.RenderingHints;
import java.awt.geom.Line2D; import java.awt.geom.Line2D;
import java.awt.geom.Path2D;
import java.awt.geom.Rectangle2D; import java.awt.geom.Rectangle2D;
import java.util.ArrayList; import java.util.ArrayList;
import java.util.List; import java.util.List;
/** /**
* Поверхностная диаграмма без объёма (c:surfaceChart, ECMA-376 §21.2.2.204): * Контурная диаграмма (c:surfaceChart, ECMA-376 §21.2.2.204), два режима.
* «отображает взаимосвязь между категориями и осью значений» — то есть
* рисуется в системе координат «категория × значение»: ось значений слева,
* категории снизу. Каждый ряд — ломаная через категории; лист поверхности
* идёт от переднего ряда к задним, и на экране виден торцом: полосы между
* соседними ломаными красятся контурными полосами высот (c:bandFmts,
* §21.2.2.13 — индексация от низкого к высокого; без bandFmts — палитра),
* передняя стенка от пола до ряда 0 — полосой значения переднего края.
* c:wireframe (§21.2.2.205) — вместо заливок сетка из ломаных рядов и
* линий по категориям.
* *
* Регрессия — Surface2dPainterTest, фикстура samples/chart-types.docx * <p>Заливочный (c:wireframe val="0"): «отображает взаимосвязь между
* категориями и осью значений» — система координат «категория × значение»:
* ось значений слева, категории снизу. Каждый ряд — ломаная через
* категории; лист поверхности идёт от переднего ряда к задним, и на экране
* виден торцом: полосы между соседними ломаными красятся контурными
* полосами высот (c:bandFmts, §21.2.2.13 — индексация от низкого к
* высокого; без bandFmts — палитра), передняя стенка от пола до ряда 0 —
* полосой значения переднего края.
*
* <p>c:wireframe (§21.2.2.230) — вид сверху, как Word: «surface charts
* viewed from above… shows only the lines. The lines… connect interpolated
* points of equal value» (Microsoft Support). X — категории, Y — ряды
* (серия 0 внизу), заливок и оси значений нет: изолинии на внутренних
* границах полос высот lo + k·unit цветом полосы НИЖЕ уровня
* (c:bandFmts §21.2.2.13/.14, без них — палитра), marching squares
* ({@link #cellSegments}), седло — по среднему ячейки; сетка узлов
* catAx/serAx и рамка области построения.
*
* <p>Регрессия — Surface2dPainterTest, фикстура samples/chart-types.docx
* (WordPdfConverterTest#chartTypes_allTypesRenderAsImages). * (WordPdfConverterTest#chartTypes_allTypesRenderAsImages).
*/ */
final class Surface2dPainter { final class Surface2dPainter {
@@ -33,6 +41,18 @@ final class Surface2dPainter {
/** Отрезок полосы короче этого не рисуется (эпсилон float-сравнения). */ /** Отрезок полосы короче этого не рисуется (эпсилон float-сравнения). */
private static final double MIN_SEGMENT = 1e-9; private static final double MIN_SEGMENT = 1e-9;
/** Страж нулевой длины ребра при интерполяции уровня (marching squares). */
private static final double LEVEL_EPS = 1e-12;
/** Число пересечений ребра ячейки уровнем: пара — один сегмент. */
private static final int HITS_PAIR = 2;
/** Число пересечений ребра ячейки уровнем: седло — два сегмента. */
private static final int HITS_SADDLE = 4;
/** Число пересечений ребра ячейки уровнем: два поперечных + узел — один сегмент. */
private static final int HITS_WITH_NODE = 3;
static void paint(Graphics2D g, ChartSpec spec, Rectangle2D box, List<Color> palette) { static void paint(Graphics2D g, ChartSpec spec, Rectangle2D box, List<Color> palette) {
int nSer = spec.series.size(); int nSer = spec.series.size();
int nCat = 0; int nCat = 0;
@@ -65,6 +85,11 @@ final class Surface2dPainter {
int bandCount = Math.max(1, (int) Math.ceil((hi - lo) / unit - 1e-9)); int bandCount = Math.max(1, (int) Math.ceil((hi - lo) / unit - 1e-9));
List<Color> bands = spec.bandColors.isEmpty() ? palette : spec.bandColors; List<Color> bands = spec.bandColors.isEmpty() ? palette : spec.bandColors;
if (spec.wireframe) {
paintWireframe(g, spec, z, nSer, nCat, lo, unit, bandCount, bands, box);
return;
}
// Поля под подписи осей — та же auto-layout-эвристика, что у // Поля под подписи осей — та же auto-layout-эвристика, что у
// CartesianPainter (подписи значений слева, категорий снизу). // CartesianPainter (подписи значений слева, категорий снизу).
List<String> cats = CartesianPainter.categoriesOf(spec, nCat); List<String> cats = CartesianPainter.categoriesOf(spec, nCat);
@@ -97,11 +122,7 @@ final class Surface2dPainter {
} }
} }
if (spec.wireframe) { drawContour(g, z, nSer, nCat, lo, hi, unit, bandCount, bands, plot);
drawWireframe(g, z, nSer, nCat, lo, hi, plot, valAxis);
} else {
drawContour(g, z, nSer, nCat, lo, hi, unit, bandCount, bands, plot);
}
// Оси поверх: линия категории и подписи. // Оси поверх: линия категории и подписи.
if (catAxis.axisLineColor != null && !catAxis.deleted) { if (catAxis.axisLineColor != null && !catAxis.deleted) {
@@ -167,31 +188,280 @@ final class Surface2dPainter {
g.setRenderingHint(RenderingHints.KEY_ANTIALIASING, oldAA); g.setRenderingHint(RenderingHints.KEY_ANTIALIASING, oldAA);
} }
/** c:wireframe: сетка листа — ломаные рядов + линии по категориям. */ /**
private static void drawWireframe(Graphics2D g, double[][] z, int nSer, int nCat, * c:wireframe (§21.2.2.230) — вид сверху, как Word: X — категории,
double lo, double hi, Rectangle2D plot, * Y — ряды (серия 0 внизу); рисуются только изолинии, сетка узлов
ChartSpec.AxisSpec valAxis) { * catAx/serAx и рамка области построения — заливок и оси значений нет
g.setColor(valAxis.gridColor); * (значения кодируют изолинии и легенда полос). Word пишет serAx
g.setStroke(new BasicStroke(0.6f)); * axPos="r" для поверхностей; иное положение serAx — подписи слева.
*/
private static void paintWireframe(Graphics2D g, ChartSpec spec, double[][] z,
int nSer, int nCat, double lo, double unit,
int bandCount, List<Color> bands,
Rectangle2D box) {
ChartSpec.AxisSpec serAxis = spec.serAxis != null
? spec.serAxis : new ChartSpec.AxisSpec();
ChartSpec.AxisSpec catAxis = spec.catAxis != null
? spec.catAxis : new ChartSpec.AxisSpec();
boolean serRight = spec.serAxis != null && "r".equals(serAxis.pos);
List<String> cats = CartesianPainter.categoriesOf(spec, nCat);
List<String> serLabels = new ArrayList<>();
for (int r = 0; r < nSer; r++) { for (int r = 0; r < nSer; r++) {
Path2D p = new Path2D.Double(); String name = spec.series.get(r).name;
serLabels.add(name == null || name.isEmpty() ? String.valueOf(r + 1) : name);
}
// Поля под подписи — та же эвристика, что у filled-ветки (ряды вместо значений).
double catGutter = catAxis.labelStyle != null
? DrawMlText.textHeight(catAxis.labelStyle) + 6 : 6;
double serGutter = 8;
if (serAxis.labelStyle != null) {
for (String l : serLabels) {
serGutter = Math.max(serGutter,
DrawMlText.textWidth(l, serAxis.labelStyle) + 8);
}
}
Rectangle2D plot = new Rectangle2D.Double(
serRight ? box.getX() : box.getX() + serGutter, box.getY(),
Math.max(10, box.getWidth() - serGutter),
Math.max(10, box.getHeight() - catGutter));
// Сетка по узлам осей — под изолиниями.
if (catAxis.gridlines && !catAxis.deleted) {
g.setColor(catAxis.gridColor);
g.setStroke(new BasicStroke(0.6f));
for (int c = 0; c < nCat; c++) { for (int c = 0; c < nCat; c++) {
double x = xOf(c, plot, nCat); double x = xOf(c, plot, nCat);
double y = yOf(z[r][c], lo, hi, plot); g.draw(new Line2D.Double(x, plot.getY(), x,
if (c == 0) { plot.getY() + plot.getHeight()));
p.moveTo(x, y); }
} else { }
p.lineTo(x, y); if (spec.serAxis != null && serAxis.gridlines && !serAxis.deleted) {
g.setColor(serAxis.gridColor);
g.setStroke(new BasicStroke(0.6f));
for (int r = 0; r < nSer; r++) {
double y = serY(r, plot, nSer);
g.draw(new Line2D.Double(plot.getX(), y,
plot.getX() + plot.getWidth(), y));
}
}
// Изолинии — с антиалиасингом (в отличие от заливки filled-ветки).
g.setStroke(new BasicStroke(0.75f));
drawContourLines(g, z, nSer, nCat, lo, unit, bandCount, bands, plot);
// Рамка области построения — это рамка области, а не ось.
if (catAxis.axisLineColor != null) {
g.setColor(catAxis.axisLineColor);
g.setStroke(new BasicStroke((float) Math.max(0.5, catAxis.axisLineWidth)));
g.draw(plot);
}
// Подписи категорий — по ЦЕНТРАМ узлов сетки (не слотов, как в filled).
if (catAxis.labelStyle != null) {
DrawMlText.Style style = catAxis.labelStyle;
double h = DrawMlText.textHeight(style) + 2;
double slot = plot.getWidth() / Math.max(1, nCat - 1);
for (int i = 0; i < nCat && i < cats.size(); i++) {
String label = cats.get(i);
if (label.isEmpty()) {
continue;
}
double w = DrawMlText.textWidth(label, style);
if (w > slot * 1.15) {
continue;
}
DrawMlText.paint(g, List.of(new DrawMlText.Paragraph(label, style, "ctr")),
new Rectangle2D.Double(xOf(i, plot, nCat) - w / 2,
plot.getY() + plot.getHeight() + 3, w, h),
"ctr", "t", 1.0);
}
}
// Подписи рядов — по центрам узлов строк, со стороны serAx.
if (serAxis.labelStyle != null) {
DrawMlText.Style style = serAxis.labelStyle;
double h = DrawMlText.textHeight(style) + 2;
for (int r = 0; r < nSer; r++) {
String label = serLabels.get(r);
if (label.isEmpty()) {
continue;
}
double w = Math.max(10, DrawMlText.textWidth(label, style));
double y = serY(r, plot, nSer);
Rectangle2D rect = serRight
? new Rectangle2D.Double(plot.getX() + plot.getWidth() + 6,
y - h / 2, w, h)
: new Rectangle2D.Double(plot.getX() - 6 - w, y - h / 2, w, h);
DrawMlText.paint(g,
List.of(new DrawMlText.Paragraph(label, style,
serRight ? "l" : "r")),
rect, serRight ? "l" : "r", "ctr", 1.0);
}
}
}
/**
* Изолинии: «the lines… connect interpolated points of equal value» —
* на каждой внутренней границе полос высот lo + k·unit (k = 1..bandCount−1)
* цветом полосы НИЖЕ уровня (пиксельный разбор эталона Excel: линия на
* границе «коричневая полоса | серая полоса» — оттенок коричневого).
* Геометрия — marching squares по ячейкам сетки, см. {@link #cellSegments}.
*/
private static void drawContourLines(Graphics2D g, double[][] z, int nSer, int nCat,
double lo, double unit, int bandCount,
List<Color> bands, Rectangle2D plot) {
for (int k = 1; k < bandCount; k++) {
double level = lo + k * unit;
g.setColor(bands.get((k - 1) % bands.size()));
for (int r = 0; r < nSer - 1; r++) {
double y0 = serY(r, plot, nSer);
double y1 = serY(r + 1, plot, nSer);
for (int c = 0; c < nCat - 1; c++) {
double x0 = xOf(c, plot, nCat);
double x1 = xOf(c + 1, plot, nCat);
for (Line2D.Double seg : cellSegments(z[r][c], z[r][c + 1],
z[r + 1][c + 1], z[r + 1][c], level, x0, x1, y0, y1)) {
g.draw(seg);
}
} }
} }
g.draw(p);
} }
for (int c = 0; c < nCat; c++) { }
double x = xOf(c, plot, nCat);
double yTop = yOf(z[nSer - 1][c], lo, hi, plot); /**
double yBot = yOf(z[0][c], lo, hi, plot); * Marching squares: сегменты линии уровня в одной ячейке сетки.
g.draw(new Line2D.Double(x, Math.min(yTop, yBot), x, Math.max(yTop, yBot))); * Узлы A=(x0,y0)↔z00, B=(x1,y0)↔z10, C=(x1,y1)↔z11, D=(x0,y1)↔z01;
* «внутри» — z >= level (узел точно на уровне = внутри → линия проходит
* через узел). Возвращает 0, 1 или 2 сегмента. Ребро, оба конца которого
* точно на уровне, — целый сегмент (иначе вдоль ребра дыра в изолинии;
* Word её рисует), а такой узел «поглощает» пересечение соседнего ребра
* (линия проходит через узел вдоль ребра, диагональ неверна — двучленное
* уровень-множество биллинейной функции в этом случае даёт именно рёбра).
* Совпавшие в узле пересечения соседних рёбер дедуплицируются: изолиния
* проходит через узел. Седло (4 пересечения) решается центром ячейки:
* avg >= level — сегменты огибают «внутренние» углы, иначе — «внешние».
*
* <p>Package-private для прямых геометрических юнит-тестов (как
* rewrite-хук нормализаторов). Регрессия — Surface2dPainterTest#cellSegments_*.
*/
static List<Line2D.Double> cellSegments(double z00, double z10, double z11, double z01,
double level, double x0, double x1,
double y0, double y1) {
double[] z = {z00, z10, z11, z01};
double[] xs = {x0, x1, x1, x0};
double[] ys = {y0, y0, y1, y1};
boolean[] inside = new boolean[4];
boolean[] onLevel = new boolean[4];
for (int i = 0; i < 4; i++) {
inside[i] = z[i] >= level;
onLevel[i] = z[i] == level;
} }
List<Line2D.Double> segs = new ArrayList<>();
boolean[] full = new boolean[4];
for (int i = 0; i < 4; i++) {
int j = (i + 1) % 4;
if (onLevel[i] && onLevel[j]) {
full[i] = true;
addSegment(segs, xs[i], ys[i], xs[j], ys[j]);
}
}
boolean[] absorbed = new boolean[4];
for (int i = 0; i < 4; i++) {
absorbed[i] = onLevel[i] && (full[i] || full[(i + 3) % 4]);
}
double[][] hit = new double[4][];
for (int i = 0; i < 4; i++) {
int j = (i + 1) % 4;
if (full[i] || inside[i] == inside[j]
|| Math.abs(z[j] - z[i]) < LEVEL_EPS
|| absorbed[i] || absorbed[j]) {
continue;
}
double t = (level - z[i]) / (z[j] - z[i]);
hit[i] = new double[] {xs[i] + (xs[j] - xs[i]) * t, ys[i] + (ys[j] - ys[i]) * t};
}
// Совпадения пересечений в узлах (соседние рёбра бьют в один узел) —
// одно пересечение: без дедупликации в ячейках вида (3,6,4,2) — узел
// z=4 фикстуры hill, уровень 4 — было бы «3 удара» и сегмент терялся.
List<Integer> edges = new ArrayList<>();
for (int i = 0; i < 4; i++) {
if (hit[i] != null && !coincident(hit, edges, i)) {
edges.add(i);
}
}
if (edges.size() == HITS_PAIR) {
double[] p = hit[edges.get(0)];
double[] q = hit[edges.get(1)];
addSegment(segs, p[0], p[1], q[0], q[1]);
} else if (edges.size() == HITS_WITH_NODE) {
// Два поперечных + одно точно в узле: узел — изолированная точка
// уровень-множества (ветвь уходит из ячейки по ребру соседям),
// рисуем сегмент между поперечными пересечениями.
double[] p = null;
double[] q = null;
for (int e : edges) {
if (isNode(hit[e], xs, ys)) {
continue;
}
if (p == null) {
p = hit[e];
} else {
q = hit[e];
}
}
if (p != null && q != null) {
addSegment(segs, p[0], p[1], q[0], q[1]);
}
} else if (edges.size() == HITS_SADDLE) {
double avg = (z00 + z10 + z11 + z01) / 4;
// Рёбра e0=A-B, e1=B-C, e2=C-D, e3=D-A. A,C внутри: avg >= level —
// огибаем внутренние углы парами (e3,e0)+(e1,e2), иначе зеркально;
// B,D внутри — наоборот.
int[][] pairs = inside[0] == (avg >= level)
? new int[][] {{3, 0}, {1, 2}}
: new int[][] {{0, 1}, {2, 3}};
for (int[] pr : pairs) {
addSegment(segs, hit[pr[0]][0], hit[pr[0]][1],
hit[pr[1]][0], hit[pr[1]][1]);
}
}
return segs;
}
/** Совпадает ли пересечение ребра i с пересечением одного из рёбер done. */
private static boolean coincident(double[][] hit, List<Integer> done, int i) {
for (int e : done) {
if (hit[e][0] == hit[i][0] && hit[e][1] == hit[i][1]) {
return true;
}
}
return false;
}
/** Точка — узел ячейки. */
private static boolean isNode(double[] p, double[] xs, double[] ys) {
for (int k = 0; k < 4; k++) {
if (p[0] == xs[k] && p[1] == ys[k]) {
return true;
}
}
return false;
}
/** Сегмент ненулевой длины (эпсилон {@link #MIN_SEGMENT}). */
private static void addSegment(List<Line2D.Double> segs, double x1, double y1,
double x2, double y2) {
double dx = x2 - x1;
double dy = y2 - y1;
if (dx * dx + dy * dy >= MIN_SEGMENT * MIN_SEGMENT) {
segs.add(new Line2D.Double(x1, y1, x2, y2));
}
}
/** Узел строки в виде сверху: серия 0 — внизу. */
private static double serY(int r, Rectangle2D plot, int nSer) {
return plot.getY() + plot.getHeight() * (1 - (double) r / (nSer - 1));
} }
/** Высота листа на срезе x: линейная интерполяция ломаной ряда. */ /** Высота листа на срезе x: линейная интерполяция ломаной ряда. */
@@ -11,11 +11,11 @@ import java.util.zip.ZipEntry;
import java.util.zip.ZipOutputStream; import java.util.zip.ZipOutputStream;
/** /**
* Генератор фикстуры {@code samples/chart-types.docx}: 12 диаграмм: 9 типов, * Генератор фикстуры {@code samples/chart-types.docx}: 13 диаграмм: 9 типов,
* которых POI не пишет (scatter, bubble, radar, stock, ofPie, bar3D, * которых POI не пишет (scatter, bubble, radar, stock, ofPie, bar3D,
* area3D, line3D, surface2D), + ofPie pie-вариант + lineChart и линейчатая * area3D, line3D, surface2D), + ofPie pie-вариант + lineChart и линейчатая
* (barDir=bar) с c:grouping=stacked — chart-XML * (barDir=bar) с c:grouping=stacked + wireframe-поверхность
* литералами по ECMA-376 §21.2 * (c:wireframe val="1") — chart-XML литералами по ECMA-376 §21.2
* (фикстура проходит docs/standards/validate-fixtures.py). Регрессия — * (фикстура проходит docs/standards/validate-fixtures.py). Регрессия —
* WordPdfConverterTest#chartTypes_allTypesRenderAsImages. * WordPdfConverterTest#chartTypes_allTypesRenderAsImages.
* *
@@ -38,8 +38,8 @@ public final class ChartTypesDocxGenerator {
List<String> titles = List.of( List<String> titles = List.of(
"Точечная", "Пузырьковая", "Лепестковая", "Биржевая", "Точечная", "Пузырьковая", "Лепестковая", "Биржевая",
"Кольцевая-доля", "Объёмная с столбцами", "Объёмная с областями", "Кольцевая-доля", "Объёмная с столбцами", "Объёмная с областями",
"Объёмная с линиями", "Поверхность", "График с накоплением", "Объёмная с линиями", "Поверхность", "Поверхность без заливки",
"Вторичная круговая", "Линейчатая с накоплением"); "График с накоплением", "Вторичная круговая", "Линейчатая с накоплением");
List<String> charts = new ArrayList<>(); List<String> charts = new ArrayList<>();
charts.add(scatter()); charts.add(scatter());
charts.add(bubble()); charts.add(bubble());
@@ -50,6 +50,7 @@ public final class ChartTypesDocxGenerator {
charts.add(area3d()); charts.add(area3d());
charts.add(line3d()); charts.add(line3d());
charts.add(surface()); charts.add(surface());
charts.add(surfaceWireframe());
charts.add(stackedLine()); charts.add(stackedLine());
charts.add(ofPiePie()); charts.add(ofPiePie());
charts.add(stackedBar()); charts.add(stackedBar());
@@ -219,6 +220,30 @@ public final class ChartTypesDocxGenerator {
+ catAx(1, 2) + valAx(2, "l", 1); + catAx(1, 2) + valAx(2, "l", 1);
} }
/**
* c:wireframe val="1" (§21.2.2.230) — wireframe-контур: рендерится видом
* сверху (изолинии, сетка catAx/serAx, рамка). Оси — локальными
* литералами с c:majorGridlines (общие хелперы сетку не пишут); serAx —
* axPos="r", как Word пишет для поверхностей. Порядок элементов
* CT_CatAx/CT_SerAx по XSD: axId, scaling, delete, axPos,
* majorGridlines, …, crossAx.
*/
private static String surfaceWireframe() {
return "<c:surfaceChart><c:wireframe val=\"1\"/>"
+ ser("Строка 1", cat("К1", "К2", "К3", "К4", "К5"), num("1", "2", "3", "2", "1"))
+ ser("Строка 2", cat("К1", "К2", "К3", "К4", "К5"), num("2", "4", "6", "4", "2"))
+ ser("Строка 3", cat("К1", "К2", "К3", "К4", "К5"), num("3", "6", "9", "6", "3"))
+ ser("Строка 4", cat("К1", "К2", "К3", "К4", "К5"), num("2", "4", "6", "4", "2"))
+ "<c:axId val=\"1\"/><c:axId val=\"2\"/><c:axId val=\"3\"/></c:surfaceChart>"
+ "<c:catAx><c:axId val=\"1\"/><c:scaling>"
+ "<c:orientation val=\"minMax\"/></c:scaling><c:delete val=\"0\"/>"
+ "<c:axPos val=\"b\"/><c:majorGridlines/><c:crossAx val=\"2\"/></c:catAx>"
+ valAx(2, "l", 1)
+ "<c:serAx><c:axId val=\"3\"/><c:scaling>"
+ "<c:orientation val=\"minMax\"/></c:scaling><c:delete val=\"0\"/>"
+ "<c:axPos val=\"r\"/><c:majorGridlines/><c:crossAx val=\"1\"/></c:serAx>";
}
private static String stackedLine() { private static String stackedLine() {
return "<c:lineChart><c:grouping val=\"stacked\"/><c:varyColors val=\"0\"/>" return "<c:lineChart><c:grouping val=\"stacked\"/><c:varyColors val=\"0\"/>"
+ ser("План", cat("Q1", "Q2", "Q3"), num("4", "7", "5")) + ser("План", cat("Q1", "Q2", "Q3"), num("4", "7", "5"))
@@ -282,8 +307,12 @@ public final class ChartTypesDocxGenerator {
} }
private static String serAx(int id, int cross) { private static String serAx(int id, int cross) {
return serAx(id, cross, "b");
}
private static String serAx(int id, int cross, String pos) {
return "<c:serAx><c:axId val=\"" + id + "\"/><c:scaling><c:orientation val=\"minMax\"/></c:scaling>" 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>"; + "<c:delete val=\"0\"/><c:axPos val=\"" + pos + "\"/><c:crossAx val=\"" + cross + "\"/></c:serAx>";
} }
private static void put(ZipOutputStream zos, String name, String xml) throws IOException { private static void put(ZipOutputStream zos, String name, String xml) throws IOException {
@@ -171,9 +171,10 @@ class WordPdfConverterTest {
/** /**
* Фикстура chart-types.docx (создана вручную, chart-XML литералами — POI * Фикстура chart-types.docx (создана вручную, chart-XML литералами — POI
* эти типы не пишет): все двенадцать — точечная, пузырьковая, * эти типы не пишет): все тринадцать — точечная, пузырьковая,
* лепестковая, биржевая, кольцевая-доля, три объёмных декартовых, * лепестковая, биржевая, кольцевая-доля, три объёмных декартовых,
* поверхность, график с накоплением и линейчатая с накоплением * поверхность, wireframe-поверхность (c:wireframe val="1"),
* график с накоплением и линейчатая с накоплением
* (c:grouping=stacked, §21.2.2.76) и pie-вариант кольцевой-доли * (c:grouping=stacked, §21.2.2.76) и pie-вариант кольцевой-доли
* (c:ofPieType="pie") — * (c:ofPieType="pie") —
* рендерятся в растр, а не удаляются с warn. * рендерятся в растр, а не удаляются с warn.
@@ -185,8 +186,8 @@ class WordPdfConverterTest {
String text = norm(pdfText(pdf)); String text = norm(pdfText(pdf));
assertTrue(text.contains("Типы диаграмм"), "пропал текст: " + text); assertTrue(text.contains("Типы диаграмм"), "пропал текст: " + text);
assertEquals(12, distinctImageCount(pdf), assertEquals(13, distinctImageCount(pdf),
"каждый из 12 графиков должен стать PNG-вставкой"); "каждый из 13 графиков должен стать PNG-вставкой");
} }
/** /**
@@ -3,17 +3,22 @@ package ru.pjandro.wordpdf.internal.chart;
import org.junit.jupiter.api.Test; import org.junit.jupiter.api.Test;
import java.awt.Color; import java.awt.Color;
import java.awt.geom.Line2D;
import java.awt.image.BufferedImage; import java.awt.image.BufferedImage;
import java.util.List;
import static org.junit.jupiter.api.Assertions.*; import static org.junit.jupiter.api.Assertions.*;
/** /**
* Контурная поверхностная диаграмма (ECMA-376 §21.2.2.204): лист между * Контурная диаграмма (ECMA-376 §21.2.2.204). Заливочный режим: лист между
* ломаными соседних рядов режется контурными полосами высот (c:bandFmts, * ломаными соседних рядов режется контурными полосами высот (c:bandFmts,
* §21.2.2.13 — от низкого к высокого; без них — палитра), c:wireframe — * §21.2.2.13 — от низкого к высокого; без них — палитра). c:wireframe
* сетка из ломаных рядов и линий по категориям без заливок. Регрессия — * (§21.2.2.230) — вид сверху, как Word: X — категории, Y — ряды (серия 0
* Surface2dPainterTest, фикстура samples/chart-types.docx * внизу), без заливок и оси значений; рисуются изолинии на внутренних
* (WordPdfConverterTest#chartTypes_allTypesRenderAsImages). * границах полос высот lo + k·unit цветом полосы НИЖЕ уровня (marching
* squares, седло — по среднему ячейки), сетка узлов catAx/serAx и рамка
* области построения. Регрессия — Surface2dPainterTest, фикстура
* samples/chart-types.docx (WordPdfConverterTest#chartTypes_allTypesRenderAsImages).
*/ */
class Surface2dPainterTest { class Surface2dPainterTest {
@@ -21,7 +26,18 @@ class Surface2dPainterTest {
private static final Color ACCENT2 = new Color(0xED7D31); private static final Color ACCENT2 = new Color(0xED7D31);
private static final Color ACCENT3 = new Color(0xA5A5A5); private static final Color ACCENT3 = new Color(0xA5A5A5);
private static final Color ACCENT4 = new Color(0xFFC000); private static final Color ACCENT4 = new Color(0xFFC000);
private static final Color GRID = new Color(0xD9, 0xD9, 0xD9);
/** Масштаб растра: 300 dpi → pt·25/6 px. */
private static final double PX = 300.0 / 72.0;
/**
* Геометрия render(): box = (4, 4, 211.23, 141.08) pt; в wireframe без
* подписей осей plot = (12, 4, 203.23, 135.08) pt (serGutter 8, catGutter 6).
*/
private static final double PLOT_X = 12;
private static final double PLOT_W = 203.23;
private static final double PLOT_Y = 4;
private static final double PLOT_H = 135.08;
/** /**
* Плоские ряды 0/2/4: lo=0, hi=4, unit=1 → лист от 0 до 4 делится на * Плоские ряды 0/2/4: lo=0, hi=4, unit=1 → лист от 0 до 4 делится на
@@ -41,21 +57,217 @@ class Surface2dPainterTest {
"полоса 3-4 не accent4: " + hex(px(img, 400, 87))); "полоса 3-4 не accent4: " + hex(px(img, 400, 87)));
} }
/** wireframe: заливок нет, есть сетка листа цветом gridlines. */ /**
* Вид сверху, z[r][c] = c: lo=0, hi=4, unit=1 → изолинии уровней 1, 2, 3 —
* вертикали точно в узлах xOf(1..3) цветами полос НИЖЕ уровня
* (accent1/2/3); между изолиниями — белый.
*/
@Test @Test
void wireframe_gridOnly() { void wireframeContour_verticalIsolinesAtNodeColumns() {
BufferedImage img = render(surfaceSpec(true)); double[][] z = {
assertFalse(matches(px(img, 400, 507), ACCENT1), {0, 1, 2, 3, 4},
"wireframe не должен заливать полосы"); {0, 1, 2, 3, 4},
long grid = 0; {0, 1, 2, 3, 4},
};
BufferedImage img = render(wireframeSpec(z));
int y = (int) Math.round((PLOT_Y + PLOT_H / 2) * PX);
assertTrue(matches(px(img, xPx(1, 5), y), ACCENT1),
"изолиния уровня 1 не accent1: " + hex(px(img, xPx(1, 5), y)));
assertTrue(matches(px(img, xPx(2, 5), y), ACCENT2),
"изолиния уровня 2 не accent2: " + hex(px(img, xPx(2, 5), y)));
assertTrue(matches(px(img, xPx(3, 5), y), ACCENT3),
"изолиния уровня 3 не accent3: " + hex(px(img, xPx(3, 5), y)));
int between = (int) Math.round((xPt(0, 5) + xPt(1, 5)) / 2 * PX);
assertFalse(isAccent(px(img, between, y)),
"между изолиниями не белый: " + hex(px(img, between, y)));
}
/**
* z[r][c] = c + 0.5: уровень 1 (lo=0, hi=5, unit=1) пересекает ребро
* c0→c1 в t=0.5 — изолиния на середине шага категорий, не в узле.
*/
@Test
void wireframeContour_interpolatedCrossingPosition() {
double[][] z = {
{0.5, 1.5, 2.5, 3.5, 4.5},
{0.5, 1.5, 2.5, 3.5, 4.5},
{0.5, 1.5, 2.5, 3.5, 4.5},
};
BufferedImage img = render(wireframeSpec(z));
int y = (int) Math.round((PLOT_Y + PLOT_H / 2) * PX);
double xLevel1 = xPt(0, 5) + (xPt(1, 5) - xPt(0, 5)) * 0.5;
int xc = (int) Math.round(xLevel1 * PX);
boolean found = false;
for (int x = xc - 3; x <= xc + 3; x++) {
if (matches(px(img, x, y), ACCENT1)) {
found = true;
}
}
assertTrue(found, "изолиния уровня 1 не найдена у x=" + xc);
assertFalse(isAccent(px(img, xc - 25, y)),
"слева от изолинии не белый: " + hex(px(img, xc - 25, y)));
}
/**
* 4 ряда × 3 категории, z[r][c] = r: lo=0, hi=3, unit=1 → горизонтали
* уровней 1, 2 в узлах serY(1), serY(2) цветами accent1/2; серия 0 — внизу
* (serY(1) ниже serY(2) на экране).
*/
@Test
void wireframeContour_horizontalIsolinesAcrossSeries() {
double[][] z = {
{0, 0, 0},
{1, 1, 1},
{2, 2, 2},
{3, 3, 3},
};
BufferedImage img = render(wireframeSpec(z));
int x = (int) Math.round((PLOT_X + PLOT_W / 2) * PX);
int y1 = yPx(1, 4);
int y2 = yPx(2, 4);
assertTrue(y1 > y2, "серия 0 должна быть внизу: serY(1)=" + y1 + " serY(2)=" + y2);
assertTrue(matches(px(img, x, y1), ACCENT1),
"изолиния уровня 1 не accent1: " + hex(px(img, x, y1)));
assertTrue(matches(px(img, x, y2), ACCENT2),
"изолиния уровня 2 не accent2: " + hex(px(img, x, y2)));
assertFalse(isAccent(px(img, x, (y1 + y2) / 2)),
"между изолиниями не белый: " + hex(px(img, x, (y1 + y2) / 2)));
}
/**
* «Холм» (данные 13-го графика фикстуры chart-types): wireframe рисует
* линии, а не заливки — акцентных пикселей меньше 2% области построения.
*/
@Test
void wireframeContour_noFills() {
double[][] z = {
{1, 2, 3, 2, 1},
{2, 4, 6, 4, 2},
{3, 6, 9, 6, 3},
{2, 4, 6, 4, 2},
};
BufferedImage img = render(wireframeSpec(z));
long accent = 0;
for (int y = 0; y < img.getHeight(); y++) { for (int y = 0; y < img.getHeight(); y++) {
for (int x = 0; x < img.getWidth(); x++) { for (int x = 0; x < img.getWidth(); x++) {
if (matches(img.getRGB(x, y), GRID)) { if (isAccent(img.getRGB(x, y))) {
grid++; accent++;
} }
} }
} }
assertTrue(grid > 500, "сетки wireframe не найдено"); long plotPx = Math.round(PLOT_W * PX) * Math.round(PLOT_H * PX);
assertTrue(accent < plotPx * 2 / 100,
"wireframe не должен заливать полосы: акцентных px " + accent
+ " из " + plotPx);
}
/**
* Седло z=(A,B,C,D)=(0,2,0,2), level 1: avg=1 >= level → сегменты огибают
* «внутренние» углы B и D: (середина A-B ↔ середина B-C) и
* (середина C-D ↔ середина D-A).
*/
@Test
void cellSegments_saddleWrapsInsideCorners() {
List<Line2D.Double> segs = Surface2dPainter.cellSegments(
0, 2, 0, 2, 1, 0, 10, 0, 10);
assertEquals(2, segs.size(), "седло должно дать 2 сегмента");
assertTrue(hasSegment(segs, 5, 0, 10, 5), "нет сегмента середина(A-B)–середина(B-C)");
assertTrue(hasSegment(segs, 5, 10, 0, 5), "нет сегмента середина(C-D)–середина(D-A)");
}
/**
* Узлы B и C точно на уровне (z=(0,1,1,0), level 1): изолиния проходит
* точно по узлам — сегмент B–C, без диагоналей в ячейку.
*/
@Test
void cellSegments_exactLevelNodesLineThroughNode() {
List<Line2D.Double> segs = Surface2dPainter.cellSegments(
0, 1, 1, 0, 1, 0, 10, 0, 10);
assertEquals(1, segs.size(), "ожидался один сегмент по узлам уровня");
assertTrue(hasSegment(segs, 10, 0, 10, 10), "сегмент должен идти B–C");
}
/**
* Оба конца ребра A-B точно на уровне (z=(1,1,0,0), level 1): всё рёбер —
* сегмент (иначе вдоль ребра дыра в изолинии).
*/
@Test
void cellSegments_bothEndsOnLevel_edgeIsSegment() {
List<Line2D.Double> segs = Surface2dPainter.cellSegments(
1, 1, 0, 0, 1, 0, 10, 0, 10);
assertEquals(1, segs.size(), "ожидался один сегмент по ребру A-B");
assertTrue(hasSegment(segs, 0, 0, 10, 0), "сегмент должен идти A–B");
}
/**
* Ячейка (3,6,4,2), level 4: узел C точно на уровне, соседние рёбра бьют
* в него дважды — после дедупликации один сегмент от поперечного
* пересечения e0 до узла C (без дедупликации — «3 удара» и дыра; случай
* фикстуры hill: узел z=4).
*/
@Test
void cellSegments_nodeCrossingNotDropped() {
List<Line2D.Double> segs = Surface2dPainter.cellSegments(
3, 6, 4, 2, 4, 0, 10, 0, 10);
assertEquals(1, segs.size(), "изолиния через узел не должна теряться");
assertTrue(hasSegment(segs, 10.0 / 3, 0, 10, 10),
"сегмент должен идти от t=1/3 на A-B до узла C");
}
/** Все узлы ниже уровня — сегментов нет. */
@Test
void cellSegments_allBelowLevel_empty() {
assertTrue(Surface2dPainter.cellSegments(0, 0, 0, 0, 1, 0, 10, 0, 10).isEmpty(),
"ниже уровня изолинии быть не должно");
}
/** Спека wireframe-поверхности без подписей осей (серии из z, категории пустые). */
private static ChartSpec wireframeSpec(double[][] z) {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.SURFACE;
spec.wireframe = true;
spec.legendPos = null;
spec.valAxis = new ChartSpec.AxisSpec();
for (double[] row : z) {
ChartSpec.Series s = new ChartSpec.Series();
for (double v : row) {
s.values.add(v);
}
spec.series.add(s);
}
return spec;
}
/** Пиксельная координата узла категории: xOf(c) = 12 + 203.23·c/(nCat−1). */
private static double xPt(double c, int nCat) {
return PLOT_X + PLOT_W * c / (nCat - 1);
}
private static int xPx(double c, int nCat) {
return (int) Math.round(xPt(c, nCat) * PX);
}
/** Пиксельная координата узла ряда: serY(r) = 4 + 135.08·(1 − r/(nSer−1)), серия 0 внизу. */
private static int yPx(double r, int nSer) {
return (int) Math.round((PLOT_Y + PLOT_H * (1 - r / (nSer - 1))) * PX);
}
private static boolean hasSegment(List<Line2D.Double> segs,
double x1, double y1, double x2, double y2) {
for (Line2D.Double s : segs) {
boolean direct = close(s.getX1(), x1) && close(s.getY1(), y1)
&& close(s.getX2(), x2) && close(s.getY2(), y2);
boolean reversed = close(s.getX1(), x2) && close(s.getY1(), y2)
&& close(s.getX2(), x1) && close(s.getY2(), y1);
if (direct || reversed) {
return true;
}
}
return false;
}
private static boolean close(double a, double b) {
return Math.abs(a - b) < 1e-9;
} }
private static ChartSpec surfaceSpec(boolean wireframe) { private static ChartSpec surfaceSpec(boolean wireframe) {
@@ -89,6 +301,11 @@ class Surface2dPainterTest {
&& Math.abs((rgb & 0xFF) - c.getBlue()) <= 24; && Math.abs((rgb & 0xFF) - c.getBlue()) <= 24;
} }
private static boolean isAccent(int rgb) {
return matches(rgb, ACCENT1) || matches(rgb, ACCENT2)
|| matches(rgb, ACCENT3) || matches(rgb, ACCENT4);
}
private static String hex(int rgb) { private static String hex(int rgb) {
return String.format("#%06X", rgb & 0xFFFFFF); return String.format("#%06X", rgb & 0xFFFFFF);
} }