chart: combo-диаграммы (barChart+lineChart) — ряды по своим осям и семействам
PR checks / web (pull_request) Successful in 47s
PR checks / java (pull_request) Successful in 1m36s

Word «Комбинированная» — несколько групп в одном c:plotArea (§21.2.2.145),
каждая со своими c:axId (§21.2.2.9); прежний ChartSpec хранил один type/
valAxis (last-wins) — побеждала последняя группа, столбцы рисовались линиями
по шкале вторичной оси.

- Series.renderAs/grouping/valAxis, AxisSpec.axId, ChartSpec.secondaryValAxis;
  привязка групп к осям по c:axId в parse(), valAx/catAx first-wins,
  тип combo = первая группа;
- CartesianPainter: семейства BAR/AREA/LINE, порядок отрисовки столбцы→линия,
  масштаб каждой серии по своей оси, вторичная ось справа (линия+подписи),
  накопление stacked внутри семейства;
- ChartRenderer: valueRange/stackedCumulative по подмножеству рядов,
  легенда lineLike по renderAs ряда;
- фикстура chart-types.docx +combo (14 диаграмм), регрессии
  ChartSpecTest#combo_*, CartesianPainterTest#combo_barsAndLineOnSecondary_bothDrawn.
This commit is contained in:
Pjandro
2026-10-26 12:34:08 +00:00
parent b29972fbf8
commit 60c60ba9ec
8 changed files with 602 additions and 78 deletions
@@ -11,11 +11,12 @@ import java.util.zip.ZipEntry;
import java.util.zip.ZipOutputStream;
/**
* Генератор фикстуры {@code samples/chart-types.docx}: 13 диаграмм: 9 типов,
* Генератор фикстуры {@code samples/chart-types.docx}: 14 диаграмм: 9 типов,
* которых POI не пишет (scatter, bubble, radar, stock, ofPie, bar3D,
* area3D, line3D, surface2D), + ofPie pie-вариант + lineChart и линейчатая
* (barDir=bar) с c:grouping=stacked + wireframe-поверхность
* (c:wireframe val="1") — chart-XML литералами по ECMA-376 §21.2
* (c:wireframe val="1") + combo barChart+lineChart на вторичной оси (§21.2.2.145)
* — chart-XML литералами по ECMA-376 §21.2
* (фикстура проходит docs/standards/validate-fixtures.py). Регрессия —
* WordPdfConverterTest#chartTypes_allTypesRenderAsImages.
*
@@ -39,7 +40,8 @@ public final class ChartTypesDocxGenerator {
"Точечная", "Пузырьковая", "Лепестковая", "Биржевая",
"Кольцевая-доля", "Объёмная с столбцами", "Объёмная с областями",
"Объёмная с линиями", "Поверхность", "Поверхность без заливки",
"График с накоплением", "Вторичная круговая", "Линейчатая с накоплением");
"График с накоплением", "Вторичная круговая", "Линейчатая с накоплением",
"Комбинация");
List<String> charts = new ArrayList<>();
charts.add(scatter());
charts.add(bubble());
@@ -54,6 +56,7 @@ public final class ChartTypesDocxGenerator {
charts.add(stackedLine());
charts.add(ofPiePie());
charts.add(stackedBar());
charts.add(combo());
StringBuilder body = new StringBuilder();
body.append("<w:p><w:r><w:t>Типы диаграмм</w:t></w:r></w:p>");
@@ -260,6 +263,23 @@ public final class ChartTypesDocxGenerator {
+ catAx(1, 2) + valAx(2, "b", 1);
}
/** Combo (§21.2.2.145): barChart (первичная ось) + lineChart (вторичная c:valAx pos="r"). */
private static String combo() {
return "<c:barChart><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:axId val=\"1\"/><c:axId val=\"2\"/></c:barChart>"
+ "<c:lineChart><c:grouping val=\"standard\"/><c:varyColors val=\"0\"/>"
+ ser("Тренд", cat("Q1", "Q2", "Q3"), num("120", "80", "150"))
+ "<c:axId val=\"3\"/><c:axId val=\"4\"/></c:lineChart>"
+ catAx(1, 2) + valAx(2, "l", 1)
+ "<c:catAx><c:axId val=\"3\"/><c:scaling>"
+ "<c:orientation val=\"minMax\"/></c:scaling><c:delete val=\"1\"/>"
+ "<c:axPos val=\"l\"/><c:crossAx val=\"4\"/></c:catAx>"
+ valAx(4, "r", 3);
}
// ---- фрагменты ----
/** ser с cat (или null) и val. */
@@ -186,8 +186,8 @@ class WordPdfConverterTest {
String text = norm(pdfText(pdf));
assertTrue(text.contains("Типы диаграмм"), "пропал текст: " + text);
assertEquals(13, distinctImageCount(pdf),
"каждый из 13 графиков должен стать PNG-вставкой");
assertEquals(14, distinctImageCount(pdf),
"каждый из 14 графиков должен стать PNG-вставкой");
}
/**
@@ -520,6 +520,54 @@ class CartesianPainterTest {
"stacked: сумма 4→2 — линия снижается, spread=" + (sBlue[2] - sBlue[0]));
}
/**
* Combo (§21.2.2.145): бар-ряд на первичной оси, линейный ряд на вторичной
* (secondaryValAxis). Значения 100/200 на первичной шкале ушли бы за холст —
* красных пикселей не было бы вовсе, поэтому наличие красной линии в верхней
* половине — наблюдаемый признак вторичной шкалы. Два прогона залитых пикселей
* в нижней полосе — столбцы нарисованы СТОЛБЦАМИ (в баге вся combo рисовалась
* линиями: в нижней полосе был один прогон/пусто).
* Регрессия — CartesianPainterTest#combo_barsAndLineOnSecondary_bothDrawn.
*/
@Test
void combo_barsAndLineOnSecondary_bothDrawn() {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.BAR;
spec.legendPos = null;
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;
spec.secondaryValAxis = new ChartSpec.AxisSpec();
spec.secondaryValAxis.labelStyle = style;
ChartSpec.Series bar = new ChartSpec.Series();
bar.renderAs = ChartSpec.Type.BAR;
bar.fill = Color.GREEN;
bar.values.add(5.0);
bar.values.add(10.0);
spec.series.add(bar);
ChartSpec.Series line = new ChartSpec.Series();
line.renderAs = ChartSpec.Type.LINE;
line.lineColor = Color.RED;
line.marker = false;
line.valAxis = spec.secondaryValAxis;
line.values.add(100.0);
line.values.add(200.0);
spec.series.add(line);
BufferedImage img = ChartRenderer.render(spec, 219.23, 149.08,
new DrawMlColor(null));
int[] red = yStats(img, Color.RED);
assertTrue(red[0] < NO_LINE,
"линейный ряд не найден — вторичная шкала не применена (значения ушли за холст)");
assertTrue(red[1] < img.getHeight() * 0.6,
"медиана красной линии должна быть в верхней части холста: " + red[1]);
assertEquals(2, barRuns(spec).size(),
"в нижней полосе — два столбца (бар-ряд рисуется столбцами, не линией)");
}
/**
* barChart c:grouping=stacked (§21.2.2.76): сегмент ряда на кумулятивной
* сумме предыдущих. Данные {{2,2,2},{1,1,1}}: в standard верх красного
@@ -1264,6 +1264,65 @@ class ChartSpecTest {
assertEquals(-5.0, spec.valAxis.min, "вторая c:valAx должна остаться осью значений");
}
/** Combo (§21.2.2.145): barChart + lineChart на вторичной оси — renderAs по рядам,
* привязка осей по c:axId (§21.2.2.9), тип от первой группы, первичная catAx не затирается. */
@Test
void combo_barAndLine_renderAsAndAxes() {
CTChart chart = new CTChart();
CTPlotArea pa = new CTPlotArea();
CTBarChart bar = new CTBarChart();
bar.getSer().add(new CTBarSer());
bar.getAxId().add(uint(1));
bar.getAxId().add(uint(2));
CTLineChart line = new CTLineChart();
line.getSer().add(new CTLineSer());
line.getAxId().add(uint(3));
line.getAxId().add(uint(4));
pa.getAreaChartOrArea3DChartOrLineChart().add(bar);
pa.getAreaChartOrArea3DChartOrLineChart().add(line);
pa.getValAxOrCatAxOrDateAx().add(catAxWithId(1, false));
pa.getValAxOrCatAxOrDateAx().add(valAxWithId(2, 10));
pa.getValAxOrCatAxOrDateAx().add(catAxWithId(3, true));
pa.getValAxOrCatAxOrDateAx().add(valAxWithId(4, 1000));
chart.setPlotArea(pa);
ChartSpec spec = ChartSpec.parse(spaceWith(chart), new DrawMlColor(null));
assertEquals(ChartSpec.Type.BAR, spec.series.get(0).renderAs);
assertEquals(ChartSpec.Type.LINE, spec.series.get(1).renderAs);
assertEquals(ChartSpec.Type.BAR, spec.type, "тип combo задаёт первая группа");
assertEquals(10.0, spec.valAxis.min, "первичная ось значений — первая c:valAx");
assertEquals(1000.0, spec.secondaryValAxis.min);
assertSame(spec.secondaryValAxis, spec.series.get(1).valAxis);
assertNull(spec.series.get(0).valAxis);
assertFalse(spec.catAxis.deleted, "первичная catAx — не удалённая вторичная");
}
/** Combo с обеими группами на одной оси: вторичной оси нет, renderAs сохранён. */
@Test
void combo_sameAxis_noSecondary() {
CTChart chart = new CTChart();
CTPlotArea pa = new CTPlotArea();
CTBarChart bar = new CTBarChart();
bar.getSer().add(new CTBarSer());
bar.getAxId().add(uint(1));
bar.getAxId().add(uint(2));
CTLineChart line = new CTLineChart();
line.getSer().add(new CTLineSer());
line.getAxId().add(uint(1));
line.getAxId().add(uint(2));
pa.getAreaChartOrArea3DChartOrLineChart().add(bar);
pa.getAreaChartOrArea3DChartOrLineChart().add(line);
pa.getValAxOrCatAxOrDateAx().add(catAxWithId(1, false));
pa.getValAxOrCatAxOrDateAx().add(valAxWithId(2, 0));
chart.setPlotArea(pa);
ChartSpec spec = ChartSpec.parse(spaceWith(chart), new DrawMlColor(null));
assertNull(spec.secondaryValAxis);
assertNull(spec.series.get(1).valAxis);
assertEquals(ChartSpec.Type.BAR, spec.series.get(0).renderAs);
assertEquals(ChartSpec.Type.LINE, spec.series.get(1).renderAs);
}
/** c:bubbleChart: bubbleScale/showNegBubbles/sizeRepresents и c:bubbleSize. */
@Test
void bubbleSizesAndScaleParsed() {
@@ -1622,6 +1681,21 @@ class ChartSpecTest {
return ax;
}
private static CTValAx valAxWithId(int id, double min) {
CTValAx ax = valAxWithMin(min);
ax.setAxId(uint(id));
return ax;
}
private static CTCatAx catAxWithId(int id, boolean deleted) {
CTCatAx ax = new CTCatAx();
ax.setAxId(uint(id));
CTBoolean d = new CTBoolean();
d.setVal(deleted);
ax.setDelete(d);
return ax;
}
private static CTUpDownBars upDownBars() {
CTUpDownBars u = new CTUpDownBars();
CTGapAmount gap = new CTGapAmount();