chart3d: соответствие ECMA-376 для bar3D/area3D/line3D/surface3D/pie3D
PR checks / web (pull_request) Successful in 34s
PR checks / java (pull_request) Failing after 1m24s

- ChartSpec: парсинг c:hPercent, c:grouping (bar3D/area3D), per-series c:shape
- rAngAx=true имеет приоритет над c:perspective (Surface3d/Cartesian3d/Pie)
- c:hPercent сжимает глубину в Surface3dPainter/Cartesian3dPainter
- c:gapDepth (MS-OI29500 §2.1.1474): раскладка полос рядов по глубине
- подписи оси глубины serAx + учёт c:delete осей
- wireframe = только каркас (без полос высот); bandFmt-полосы сортируются по глубине
- формы bar3D: cone/cylinder/pyramid + *ToMax (§21.2.3.44), per-series override
- stacked/percentStacked для bar3D и area3D (§21.2.2.76); line3D игнорирует grouping

Регрессии: Cartesian3dPainterTest/Surface3dPainterTest/PiePainterTest/ChartSpecTest.
This commit is contained in:
Pjandro
2026-10-25 13:12:56 +00:00
parent fbdada1fda
commit ae63892c71
9 changed files with 986 additions and 135 deletions
@@ -17,12 +17,15 @@ import java.util.List;
* {@link Surface3dPainter#GUTTER_LEFT} и т.д.
*
* bar3D: кластерные колонки — ряды уходят в глубину (ширина полосы
* c:gapWidth, ширина колонки — полоса·(1−max(0,c:overlap))/nSer); торец
* затемняется (псевдо-свет, калибровка — Cartesian3dPainterTest).
* c:gapWidth, глубина колонки — слот 1/nSer·100/(100+c:gapDepth) по MS-OI29500
* §2.1.1474(a)); торец затемняется (псевдо-свет, калибровка — Cartesian3dPainterTest).
* line3D: полилиния ряда на своей глубине, лента-толщина не имитируется;
* area3D: стена ряда от пола до значений, полупрозрачная, как AREA.
* Ограничения: c:shape (cylinder/cone/pyramid…) рисуется как box;
* c:barDir="bar" — горизонтальная ориентация тех же боксов.
* c:shape (§21.2.2.177, ST_Shape §21.2.3.44): box/cone/coneToMax/cylinder/pyramid/
* pyramidToMax; c:shape ряда переопределяет форму диаграммы (MS-OI29500 §2.1.1545(a/b)),
* ToMax-формы сужаются к верху пропорционально val/max (семантика Excel — ECMA геометрию
* не нормирует); неизвестное значение — box. c:barDir="bar" — горизонтальная ориентация
* боксов (Word UI не сочетает barDir=bar с формами).
*
* Регрессия — Cartesian3dPainterTest, фикстура samples/chart-types.docx
* (WordPdfConverterTest#chartTypes_allTypesRenderAsImages).
@@ -39,11 +42,18 @@ final class Cartesian3dPainter {
private record Fit(double scale, double offX, double offY) {
}
/** Одна 3D-колонка: 8 спроецированных углов + цвет + глубина центра. */
private record Column(Surface3dPainter.Node center,
Surface3dPainter.Node[][][] corners, Color color) {
/** Грань колонки: полигон в модельных координатах {u, v, w} + цвет + средняя
* глубина вершин (порядок painter's algorithm). */
private record Face(double[][] pts, Color color, double depth) {
}
/** Одна 3D-колонка: глубина центра (сортировка колонок) + грани. */
private record Column(Surface3dPainter.Node center, List<Face> faces) {
}
/** Сегментов боковой поверхности cone/cylinder. */
private static final int ROUND_SEGMENTS = 12;
static void paint(Graphics2D g, ChartSpec spec, Rectangle2D box, List<Color> palette) {
int nSer = spec.series.size();
int nCat = 0;
@@ -57,7 +67,17 @@ final class Cartesian3dPainter {
? spec.valAxis : new ChartSpec.AxisSpec();
ChartSpec.AxisSpec catAxis = spec.catAxis != null
? spec.catAxis : new ChartSpec.AxisSpec();
double[] range = ChartRenderer.valueRange(spec);
boolean bar3d = spec.type == ChartSpec.Type.BAR3D;
boolean horizontal = bar3d && spec.bar3dHorizontal;
// §21.2.2.76: c:grouping stacked/percentStacked — bar3D/area3D; line3D —
// игнорируется (Word UI не предлагает 3-D Stacked Line), горизонтальный
// bar3D остаётся кластерным.
boolean stacked = (bar3d && !horizontal || spec.type == ChartSpec.Type.AREA3D)
&& isStacked(spec.grouping);
boolean percent = stacked && "percentStacked".equalsIgnoreCase(spec.grouping);
// Кумулятивные значения по категориям: ряд si — полоса/сегмент cum[si]..cum[si+1].
double[][] cum = stacked ? stackedCumulative(spec, percent) : null;
double[] range = stacked ? stackedRange(cum) : ChartRenderer.valueRange(spec);
double[] bounds = ChartRenderer.axisBounds(valAxis, range[0], range[1]);
double lo = bounds[0];
double hi = bounds[1];
@@ -66,7 +86,9 @@ final class Cartesian3dPainter {
double rotX = Math.toRadians(spec.rotX);
double rotY = -Math.toRadians(spec.rotY);
double persp = spec.perspective;
// §21.2.2.136 + MS-OI29500 §2.1.1516(b): rAngAx=true → перспектива
// игнорируется (ортография), c:perspective действует только при rAngAx=false.
double persp = spec.rightAngledAxes ? 0 : spec.perspective;
double leftGutter = Surface3dPainter.GUTTER_LEFT * box.getWidth();
double rightGutter = Surface3dPainter.GUTTER_RIGHT * box.getWidth();
double topGutter = Surface3dPainter.GUTTER_TOP * box.getHeight();
@@ -75,11 +97,12 @@ final class Cartesian3dPainter {
double availH = Math.max(10, box.getHeight() - topGutter - bottomGutter);
double depthScale = Surface3dPainter.DEPTH_RATIO * Math.max(0.05,
spec.depthPercent / 100.0);
double heightScale = Surface3dPainter.HEIGHT_RATIO * availH / availW;
// MS-OI29500 §2.1.1481(c): c:hPercent задан → высота = hPercent% от ширины
// области построения; опущен → автомасштаб (как у Surface3dPainter).
double heightScale = spec.hPercent != null
? spec.hPercent / 100.0 : Surface3dPainter.HEIGHT_RATIO * availH / availW;
double floorW = -0.5 * heightScale;
boolean bar3d = spec.type == ChartSpec.Type.BAR3D;
boolean horizontal = bar3d && spec.bar3dHorizontal;
List<Surface3dPainter.Node> nodes = new ArrayList<>();
Surface3dPainter.Node[] floor = {
@@ -100,26 +123,71 @@ final class Cartesian3dPainter {
List<Column> columns = new ArrayList<>();
double bw = 1.0 / nCat * 100.0 / (100.0 + spec.gapWidth);
double colW = bw * (100.0 - Math.max(0, spec.overlap)) / 100.0 / Math.max(1, nSer);
for (int si = 0; si < nSer; si++) {
ChartSpec.Series s = spec.series.get(si);
double v = vOf(si, nSer);
if (bar3d && stacked) {
// §21.2.2.76: stacked bar3D — одна полоса глубины на категорию (центр v=0,
// colD от c:gapDepth), ряд si — box-сегмент от w(cum[si−1]) до w(cum[si])
// (Word UI: формы c:shape для stacked недоступны — всегда box).
double colD = 100.0 / (100.0 + spec.gapDepth);
for (int c = 0; c < nCat; c++) {
Double val = c < s.values.size() ? s.values.get(c) : null;
if (val == null) {
continue;
double prev = 0;
for (int si = 0; si < nSer; si++) {
List<Double> vals = spec.series.get(si).values;
Double v = c < vals.size() ? vals.get(c) : null;
if (v == null) {
continue;
}
columns.add(makeStackedColumn(spec.series.get(si).fillAt(si, palette),
c, nCat, wOf(prev, lo, span, heightScale),
wOf(cum[si][c], lo, span, heightScale), bw, colD,
rotX, rotY, depthScale, persp, nodes));
prev = cum[si][c];
}
if (bar3d) {
columns.add(makeColumn(s.fillAt(si, palette), c,
si - (nSer - 1) / 2.0, nCat, val, lo, span, heightScale,
floorW, bw, colW, horizontal, rotX, rotY, depthScale,
persp, nodes));
} else {
double w = wOf(val, lo, span, heightScale);
double u = uOf(c, nCat);
nodes.add(proj(u, v, w, rotX, rotY, depthScale, persp));
if (spec.type == ChartSpec.Type.AREA3D) {
nodes.add(proj(u, v, floorW, rotX, rotY, depthScale, persp));
}
} else if (stacked) {
// stacked area3D: одна стена на v=0 — вписка по кумулятивным верхам.
for (int si = 0; si < nSer; si++) {
for (int c = 0; c < nCat; c++) {
nodes.add(proj(uOf(c, nCat), 0,
wOf(cum[si][c], lo, span, heightScale),
rotX, rotY, depthScale, persp));
}
}
} else {
// ToMax-формы: максимум значения по всем рядам/категориям — доля t = val/chartMax
// задаёт степень сужения к верху (семантика Excel; ECMA геометрию не нормирует).
double chartMax = 0;
for (ChartSpec.Series s : spec.series) {
for (Double val : s.values) {
if (val != null) {
chartMax = Math.max(chartMax, val);
}
}
}
for (int si = 0; si < nSer; si++) {
ChartSpec.Series s = spec.series.get(si);
double v = vOf(si, nSer);
for (int c = 0; c < nCat; c++) {
Double val = c < s.values.size() ? s.values.get(c) : null;
if (val == null) {
continue;
}
if (bar3d) {
String shape = s.shape3d != null ? s.shape3d : spec.shape3d;
double t = chartMax > 0 ? Math.max(0, Math.min(1, val / chartMax)) : 0;
if (horizontal || (shape.endsWith("ToMax") && t <= 0)) {
shape = "box";
}
columns.add(makeColumn(s.fillAt(si, palette), shape, t, c, si,
nCat, nSer, val, lo, span, heightScale, floorW, bw,
spec.gapDepth, horizontal, rotX, rotY, depthScale,
persp, nodes));
} else {
double w = wOf(val, lo, span, heightScale);
double u = uOf(c, nCat);
nodes.add(proj(u, v, w, rotX, rotY, depthScale, persp));
if (spec.type == ChartSpec.Type.AREA3D) {
nodes.add(proj(u, v, floorW, rotX, rotY, depthScale, persp));
}
}
}
}
@@ -148,10 +216,13 @@ final class Cartesian3dPainter {
}
if (bar3d) {
drawColumns(g, columns, fit);
drawColumns(g, columns, rotX, rotY, depthScale, persp, fit);
} else if (spec.type == ChartSpec.Type.LINE3D) {
drawLines(g, spec, palette, lo, span, heightScale, nCat, nSer,
rotX, rotY, depthScale, persp, fit);
} else if (stacked) {
drawStackedAreas(g, spec, palette, cum, lo, span, heightScale, nCat, nSer,
rotX, rotY, depthScale, persp, fit);
} else {
drawAreas(g, spec, palette, lo, span, heightScale, floorW, nCat, nSer,
rotX, rotY, depthScale, persp, fit);
@@ -161,11 +232,15 @@ final class Cartesian3dPainter {
rotX, rotY, depthScale, floorW, persp, fit);
}
/** Колонка bar3D: вертикальная (значение по w) или горизонтальная (по u). */
private static Column makeColumn(Color color, int c, double serOffset, int nCat,
/** Колонка bar3D: вертикальная (значение по w) или горизонтальная (по u, всегда
* box). Глубина: MS-OI29500 §2.1.1474(a) — c:gapDepth есть зазор между смежными
* полосами рядов в направлении оси глубины, % от глубины полосы (дефолт 150);
* CT_Bar3DChart не содержит c:overlap — колонки не перекрываются. */
private static Column makeColumn(Color color, String shape, double t,
int c, int si, int nCat, int nSer,
double val,
double lo, double span, double heightScale,
double floorW, double bw, double colW,
double floorW, double bw, double gapDepth,
boolean horizontal,
double rotX, double rotY, double depthScale,
double persp, List<Surface3dPainter.Node> nodes) {
@@ -176,75 +251,325 @@ final class Cartesian3dPainter {
double wTop;
if (horizontal) {
double band = (c + 0.5) / nCat - 0.5;
double vc = band + serOffset * colW;
v0 = vc - colW / 2.0;
v1 = vc + colW / 2.0;
double clusterD = 1.0 / nCat * 100.0 / (100.0 + gapDepth);
double serD = clusterD / nSer;
v0 = band - clusterD / 2.0 + si * serD;
v1 = v0 + serD;
double ua = uVal(0, lo, span);
double ub = uVal(val, lo, span);
u0 = Math.min(ua, ub);
u1 = Math.max(ua, ub);
wTop = floorW + colW * heightScale;
wTop = floorW + serD * heightScale;
} else {
double uc = uOf(c, nCat);
u0 = uc - bw / 2.0;
u1 = uc + bw / 2.0;
double vc = serOffset * colW;
v0 = vc - colW / 2.0;
v1 = vc + colW / 2.0;
double colD = 1.0 / nSer * 100.0 / (100.0 + gapDepth);
double vc = vOf(si, nSer);
v0 = vc - colD / 2.0;
v1 = vc + colD / 2.0;
wTop = wOf(val, lo, span, heightScale);
}
double[] us = {u0, u1};
double[] vs = {v0, v1};
double[] ws = {floorW, wTop};
Surface3dPainter.Node[][][] corners = new Surface3dPainter.Node[2][2][2];
for (int u = 0; u < 2; u++) {
for (int v = 0; v < 2; v++) {
for (int w = 0; w < 2; w++) {
corners[u][v][w] = proj(us[u], vs[v], ws[w],
rotX, rotY, depthScale, persp);
nodes.add(corners[u][v][w]);
List<Face> faces = buildFaces(color, shape, t, u0, u1, v0, v1, floorW, wTop,
rotX, rotY, depthScale, persp, nodes);
Surface3dPainter.Node center = proj((u0 + u1) / 2.0, (v0 + v1) / 2.0,
(floorW + wTop) / 2.0, rotX, rotY, depthScale, persp);
nodes.add(center);
return new Column(center, faces);
}
/** c:grouping stacked/percentStacked (§21.2.2.76). */
private static boolean isStacked(String grouping) {
return "stacked".equalsIgnoreCase(grouping)
|| "percentStacked".equalsIgnoreCase(grouping);
}
/** Кумулятивные значения stacked: cum[si][c] — сумма рядов 0..si в категории c;
* percentStacked — доля от суммы категории ×100 (сумма 0 → 0). */
private static double[][] stackedCumulative(ChartSpec spec, boolean percent) {
int nSer = spec.series.size();
int nCat = 0;
for (ChartSpec.Series s : spec.series) {
nCat = Math.max(nCat, s.values.size());
}
double[] totals = new double[nCat];
if (percent) {
for (ChartSpec.Series s : spec.series) {
for (int c = 0; c < s.values.size(); c++) {
Double v = s.values.get(c);
if (v != null) {
totals[c] += v;
}
}
}
}
Surface3dPainter.Node center = proj((u0 + u1) / 2.0, (v0 + v1) / 2.0,
(floorW + wTop) / 2.0, rotX, rotY, depthScale, persp);
return new Column(center, corners, color);
double[][] cum = new double[nSer][nCat];
for (int c = 0; c < nCat; c++) {
double running = 0;
for (int si = 0; si < nSer; si++) {
List<Double> vals = spec.series.get(si).values;
Double v = c < vals.size() ? vals.get(c) : null;
double add = v == null ? 0 : v;
if (percent) {
add = totals[c] == 0 ? 0 : add / totals[c] * 100.0;
}
running += add;
cum[si][c] = running;
}
}
return cum;
}
/** Колонки от дальних к ближним: верх/перед цветом ряда, торец темнее. */
private static void drawColumns(Graphics2D g, List<Column> columns, Fit fit) {
/** Диапазон значений stacked: от 0 до максимума кумулятивных вершин (учитывая
* отрицательные суммы). */
private static double[] stackedRange(double[][] cum) {
double min = 0;
double max = 0;
for (double[] row : cum) {
for (double v : row) {
min = Math.min(min, v);
max = Math.max(max, v);
}
}
return new double[]{min, max};
}
/** Сегмент stacked bar3D: box от wBottom до wTop на полной полосе глубины
* категории (центр v=0, colD от c:gapDepth). */
private static Column makeStackedColumn(Color color, int c, int nCat,
double wBottom, double wTop,
double bw, double colD,
double rotX, double rotY, double depthScale,
double persp, List<Surface3dPainter.Node> nodes) {
double uc = uOf(c, nCat);
double u0 = uc - bw / 2.0;
double u1 = uc + bw / 2.0;
double v0 = -colD / 2.0;
double v1 = colD / 2.0;
List<Face> faces = buildFaces(color, "box", 0, u0, u1, v0, v1, wBottom, wTop,
rotX, rotY, depthScale, persp, nodes);
Surface3dPainter.Node center = proj((u0 + u1) / 2.0, 0.0, (wBottom + wTop) / 2.0,
rotX, rotY, depthScale, persp);
nodes.add(center);
return new Column(center, faces);
}
/** Стены stacked area3D: одна стена на v=0, ряд si — полоса между кумулятивными
* ломаными cum[si−1] и cum[si], полупрозрачная, как AREA. */
private static void drawStackedAreas(Graphics2D g, ChartSpec spec, List<Color> palette,
double[][] cum, double lo, double span,
double heightScale, int nCat, int nSer,
double rotX, double rotY, double depthScale,
double persp, Fit fit) {
for (int si = nSer - 1; si >= 0; si--) {
ChartSpec.Series s = spec.series.get(si);
Color c = s.fill != null ? s.fill : s.fillAt(si, palette);
List<Double> xs = new ArrayList<>();
List<Double> ys = new ArrayList<>();
List<Double> baseX = new ArrayList<>();
List<Double> baseY = new ArrayList<>();
for (int i = 0; i < nCat; i++) {
double u = uOf(i, nCat);
double top = wOf(cum[si][i], lo, span, heightScale);
double bottom = wOf(si == 0 ? 0 : cum[si - 1][i], lo, span, heightScale);
double[] p = screen(proj(u, 0, top, rotX, rotY, depthScale, persp), fit);
double[] b = screen(proj(u, 0, bottom, rotX, rotY, depthScale, persp), fit);
xs.add(p[0]);
ys.add(p[1]);
baseX.add(b[0]);
baseY.add(b[1]);
}
if (xs.size() < MIN_POLYLINE_POINTS) {
continue;
}
Path2D band = new Path2D.Double();
band.moveTo(xs.get(0), ys.get(0));
for (int i = 1; i < xs.size(); i++) {
band.lineTo(xs.get(i), ys.get(i));
}
for (int i = baseX.size() - 1; i >= 0; i--) {
band.lineTo(baseX.get(i), baseY.get(i));
}
band.closePath();
g.setColor(DrawMlColor.withAlpha(c, 0.55));
g.fill(band);
g.setColor(c);
g.setStroke(new BasicStroke(1.2f));
g.draw(ChartRenderer.polyline(xs, ys, false));
}
}
/** Грани колонки в модельных координатах (§21.2.3.44 ST_Shape); все вершины
* проецируются в nodes — по ним происходит вписка. Неизвестная форма — box. */
private static List<Face> buildFaces(Color color, String shape, double t,
double u0, double u1, double v0, double v1,
double wBase, double wTop,
double rotX, double rotY, double depthScale,
double persp, List<Surface3dPainter.Node> nodes) {
List<Face> faces = switch (shape) {
case "cone" -> roundFaces(color, u0, u1, v0, v1, wBase, wTop, 0,
rotX, rotY, depthScale, persp);
case "coneToMax" -> roundFaces(color, u0, u1, v0, v1, wBase, wTop, 1 - t,
rotX, rotY, depthScale, persp);
case "cylinder" -> roundFaces(color, u0, u1, v0, v1, wBase, wTop, 1,
rotX, rotY, depthScale, persp);
case "pyramid" -> pyramidFaces(color, u0, u1, v0, v1, wBase, wTop, 0,
rotX, rotY, depthScale, persp);
case "pyramidToMax" -> pyramidFaces(color, u0, u1, v0, v1, wBase, wTop, 1 - t,
rotX, rotY, depthScale, persp);
default -> boxFaces(color, u0, u1, v0, v1, wBase, wTop,
rotX, rotY, depthScale, persp);
};
for (Face f : faces) {
for (double[] q : f.pts()) {
nodes.add(proj(q[0], q[1], q[2], rotX, rotY, depthScale, persp));
}
}
return faces;
}
/** Box: три видимые грани — верх, перед, торец u=max (затемнён, псевдо-свет). */
private static List<Face> boxFaces(Color color, double u0, double u1,
double v0, double v1, double wBase, double wTop,
double rotX, double rotY, double depthScale,
double persp) {
return List.of(
face(new double[][]{{u0, v0, wTop}, {u1, v0, wTop},
{u1, v1, wTop}, {u0, v1, wTop}},
color, rotX, rotY, depthScale, persp),
face(new double[][]{{u0, v0, wBase}, {u1, v0, wBase},
{u1, v0, wTop}, {u0, v0, wTop}},
color, rotX, rotY, depthScale, persp),
face(new double[][]{{u1, v0, wBase}, {u1, v1, wBase},
{u1, v1, wTop}, {u1, v0, wTop}},
color.darker(), rotX, rotY, depthScale, persp));
}
/** Пирамида (s=0 — апекс) / усечённая пирамида (s — доля верхнего сечения,
* крышка при s>0); правая грань затемнена, как торец box. */
private static List<Face> pyramidFaces(Color color, double u0, double u1,
double v0, double v1, double wBase, double wTop,
double s,
double rotX, double rotY, double depthScale,
double persp) {
double uc = (u0 + u1) / 2.0;
double vc = (v0 + v1) / 2.0;
double hu = (u1 - u0) / 2.0 * s;
double hv = (v1 - v0) / 2.0 * s;
double[][] base = {{u0, v0}, {u1, v0}, {u1, v1}, {u0, v1}};
double[][] top = {{uc - hu, vc - hv}, {uc + hu, vc - hv},
{uc + hu, vc + hv}, {uc - hu, vc + hv}};
List<Face> faces = new ArrayList<>();
for (int i = 0; i < 4; i++) {
int j = (i + 1) % 4;
Color c = i == 1 ? color.darker() : color;
if (s <= 0) {
faces.add(face(new double[][]{{base[i][0], base[i][1], wBase},
{base[j][0], base[j][1], wBase}, {uc, vc, wTop}},
c, rotX, rotY, depthScale, persp));
} else {
faces.add(face(new double[][]{{base[i][0], base[i][1], wBase},
{base[j][0], base[j][1], wBase},
{top[j][0], top[j][1], wTop},
{top[i][0], top[i][1], wTop}},
c, rotX, rotY, depthScale, persp));
}
}
if (s > 0) {
double[][] cap = new double[4][3];
for (int i = 0; i < 4; i++) {
cap[i] = new double[]{top[i][0], top[i][1], wTop};
}
faces.add(face(cap, color, rotX, rotY, depthScale, persp));
}
return faces;
}
/** Конус (s=0 — апекс), усечённый конус (0<s<1), цилиндр (s=1): основание —
* 12-угольник (эллипс в (u,v)), боковая лента + крышка при s>0; правая четверть
* ленты (к +u) затемнена, как торец box. */
private static List<Face> roundFaces(Color color, double u0, double u1,
double v0, double v1, double wBase, double wTop,
double s,
double rotX, double rotY, double depthScale,
double persp) {
double uc = (u0 + u1) / 2.0;
double vc = (v0 + v1) / 2.0;
double au = (u1 - u0) / 2.0;
double av = (v1 - v0) / 2.0;
List<Face> faces = new ArrayList<>();
for (int i = 0; i < ROUND_SEGMENTS; i++) {
double a0 = 2 * Math.PI * i / ROUND_SEGMENTS;
double a1 = 2 * Math.PI * (i + 1) / ROUND_SEGMENTS;
double am = (a0 + a1) / 2.0;
Color c = Math.cos(am) > Math.abs(Math.sin(am)) ? color.darker() : color;
double bx0 = uc + au * Math.cos(a0);
double by0 = vc + av * Math.sin(a0);
double bx1 = uc + au * Math.cos(a1);
double by1 = vc + av * Math.sin(a1);
if (s <= 0) {
faces.add(face(new double[][]{{bx0, by0, wBase}, {bx1, by1, wBase},
{uc, vc, wTop}}, c, rotX, rotY, depthScale, persp));
} else {
double tx0 = uc + au * s * Math.cos(a0);
double ty0 = vc + av * s * Math.sin(a0);
double tx1 = uc + au * s * Math.cos(a1);
double ty1 = vc + av * s * Math.sin(a1);
faces.add(face(new double[][]{{bx0, by0, wBase}, {bx1, by1, wBase},
{tx1, ty1, wTop}, {tx0, ty0, wTop}},
c, rotX, rotY, depthScale, persp));
}
}
if (s > 0) {
double[][] cap = new double[ROUND_SEGMENTS][3];
for (int i = 0; i < ROUND_SEGMENTS; i++) {
double a = 2 * Math.PI * i / ROUND_SEGMENTS;
cap[i] = new double[]{uc + au * s * Math.cos(a),
vc + av * s * Math.sin(a), wTop};
}
faces.add(face(cap, color, rotX, rotY, depthScale, persp));
}
return faces;
}
/** Грань с средней глубиной вершин (painter's algorithm). */
private static Face face(double[][] pts, Color color,
double rotX, double rotY, double depthScale, double persp) {
double d = 0;
for (double[] q : pts) {
d += Surface3dPainter.project(q[0], q[1], q[2],
rotX, rotY, depthScale, persp).depth();
}
return new Face(pts, color, d / pts.length);
}
/** Колонки от дальних к ближним; внутри колонки — грани по убыванию средней
* глубины вершин (painter's algorithm). */
private static void drawColumns(Graphics2D g, List<Column> columns,
double rotX, double rotY, double depthScale,
double persp, Fit fit) {
columns.sort(Comparator.comparingDouble((Column col) -> col.center.depth())
.reversed());
for (Column col : columns) {
g.setColor(col.color);
// верх: w = 1
quad(g, col, fit, 0, 0, 1, 1, 0, 1, 1, 1, 1, 0, 1, 1);
// перед: v = 0 (при rotY=0 ближняя к камере сторона)
quad(g, col, fit, 0, 0, 0, 1, 0, 0, 1, 0, 1, 0, 0, 1);
// торец u = max — затемнён (псевдо-свет, калибровка тестом)
g.setColor(col.color.darker());
quad(g, col, fit, 1, 0, 0, 1, 1, 0, 1, 1, 1, 1, 0, 1);
}
}
/** Грань по четырём углам (u, v, w) — индексы массивов corners. */
private static void quad(Graphics2D g, Column col, Fit fit,
int u1, int v1, int w1, int u2, int v2, int w2,
int u3, int v3, int w3, int u4, int v4, int w4) {
int[] uu = {u1, u2, u3, u4};
int[] vv = {v1, v2, v3, v4};
int[] ww = {w1, w2, w3, w4};
Path2D p = new Path2D.Double();
for (int i = 0; i < 4; i++) {
double[] s = screen(col.corners[uu[i]][vv[i]][ww[i]], fit);
if (i == 0) {
p.moveTo(s[0], s[1]);
} else {
p.lineTo(s[0], s[1]);
List<Face> faces = new ArrayList<>(col.faces());
faces.sort(Comparator.comparingDouble(Face::depth).reversed());
for (Face f : faces) {
g.setColor(f.color());
Path2D p = new Path2D.Double();
for (int i = 0; i < f.pts().length; i++) {
double[] q = f.pts()[i];
double[] s = screen(proj(q[0], q[1], q[2],
rotX, rotY, depthScale, persp), fit);
if (i == 0) {
p.moveTo(s[0], s[1]);
} else {
p.lineTo(s[0], s[1]);
}
}
p.closePath();
g.fill(p);
}
}
p.closePath();
g.fill(p);
}
private static void drawLines(Graphics2D g, ChartSpec spec, List<Color> palette,
@@ -330,7 +655,9 @@ final class Cartesian3dPainter {
}
}
/** Подписи: значения — вдоль переднего левого ребра, категории — нижнего. */
/** Подписи: значения — вдоль переднего левого ребра, категории — нижнего,
* ряды — правого; c:delete (§21.2.2.38) убирает подписи оси.
* Регрессия — Cartesian3dPainterTest#bar3d_seriesAxisLabelsDrawn. */
private static void drawLabels(Graphics2D g, ChartSpec spec, List<Double> tickValues,
List<Surface3dPainter.Node> valueAnchors, int nCat,
boolean horizontal, double rotX, double rotY,
@@ -340,8 +667,10 @@ final class Cartesian3dPainter {
? spec.valAxis : new ChartSpec.AxisSpec();
ChartSpec.AxisSpec catAxis = spec.catAxis != null
? spec.catAxis : new ChartSpec.AxisSpec();
ChartSpec.AxisSpec serAxis = spec.serAxis != null
? spec.serAxis : new ChartSpec.AxisSpec();
DrawMlText.Style vs = valAxis.labelStyle;
if (vs != null) {
if (vs != null && !valAxis.deleted) {
double h = DrawMlText.textHeight(vs) + 2;
for (int i = 0; i < valueAnchors.size(); i++) {
double[] p = screen(valueAnchors.get(i), fit);
@@ -353,7 +682,7 @@ final class Cartesian3dPainter {
}
}
DrawMlText.Style cs = catAxis.labelStyle;
if (cs != null) {
if (cs != null && !catAxis.deleted) {
List<String> cats = CartesianPainter.categoriesOf(spec, nCat);
double h = DrawMlText.textHeight(cs) + 2;
for (int c = 0; c < nCat; c++) {
@@ -371,6 +700,27 @@ final class Cartesian3dPainter {
new Rectangle2D.Double(p[0] - w / 2, p[1] + 8, w, h), "ctr", "t", 1.0);
}
}
// Ряды: правое нижнее ребро пола на глубине слота ряда (§21.2.2.175;
// CT_Bar3DChart/CT_Line3DChart/CT_Area3DChart несут третий axId — ось рядов).
// В горизонтальной ориентации по глубине лежат категории — подписей рядов нет.
DrawMlText.Style ss = serAxis.labelStyle;
if (ss != null && !serAxis.deleted && !horizontal) {
int nSer = spec.series.size();
double h = DrawMlText.textHeight(ss) + 2;
for (int r = 0; r < nSer; r++) {
String label = spec.series.get(r).name;
if (label == null || label.isEmpty()) {
continue;
}
Surface3dPainter.Node n = proj(0.5, vOf(r, nSer), floorW,
rotX, rotY, depthScale, persp);
double[] p = screen(n, fit);
double w = DrawMlText.textWidth(label, ss);
DrawMlText.paint(g, List.of(new DrawMlText.Paragraph(label, ss, "l")),
new Rectangle2D.Double(p[0] + 4, p[1] - h / 2, w, h),
"l", "ctr", 1.0);
}
}
}
private static Fit fit(List<Surface3dPainter.Node> nodes, Rectangle2D box,
@@ -419,7 +769,8 @@ final class Cartesian3dPainter {
return (c + 0.5) / nCat - 0.5;
}
/** Центр слота ряда по глубине: ряды лежат полосами по всей глубине (§21.2.2.74). */
private static double vOf(int r, int nSer) {
return nSer > 1 ? (double) r / (nSer - 1) - 0.5 : 0;
return (r + 0.5) / nSer - 0.5;
}
}
@@ -55,6 +55,7 @@ import org.docx4j.dml.chart.CTView3D;
import java.awt.Color;
import java.util.ArrayList;
import java.util.Comparator;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
@@ -109,6 +110,8 @@ final class ChartSpec {
final List<Double> xValues = new ArrayList<>();
/** bubble: размеры пузырей (c:bubbleSize). */
final List<Double> bubbleSizes = new ArrayList<>();
/** c:shape ряда bar3D (MS-OI29500 §2.1.1545(b)); null = дефолт диаграммы ({@link #shape3d}). */
String shape3d;
Color fillAt(int i, List<Color> palette) {
Color c = pointFills.get(i);
@@ -149,8 +152,14 @@ final class ChartSpec {
double rotX = 30;
double rotY = 0;
double depthPercent = 100;
/** CT_HPercent c:view3D/hPercent (§21.2.2.83), % от ширины области построения;
* null = элемент отсутствует → автомасштаб (MS-OI29500 §2.1.1481(a)). */
Double hPercent;
double perspective = 30;
boolean rightAngledAxes = true;
/** c:grouping 3D-групп (§21.2.2.76): standard|clustered|stacked|percentStacked;
* используют только bar3D/area3D. */
String grouping = "standard";
// Спека-параметры DrawingML, исполнение Word; дефолты — ECMA-376/Word.
// firstSliceAng (§21.2.2.68) определён только для CT_PieChart/CT_DoughnutChart;
// CT_Pie3DChart (§21.2.2.140, модель §A.5.1) его не содержит — JAXB-класс
@@ -310,6 +319,9 @@ final class ChartSpec {
if (v.getDepthPercent() != null) {
spec.depthPercent = v.getDepthPercent().getVal();
}
if (v.getHPercent() != null) {
spec.hPercent = (double) v.getHPercent().getVal();
}
if (v.getPerspective() != null) {
spec.perspective = v.getPerspective().getVal();
}
@@ -393,6 +405,9 @@ final class ChartSpec {
if (g.getGapDepth() != null) {
spec.gapDepth = g.getGapDepth().getVal();
}
if (g.getGrouping() != null && g.getGrouping().getVal() != null) {
spec.grouping = g.getGrouping().getVal().value();
}
for (org.docx4j.dml.chart.CTAreaSer s : g.getSer()) {
Series ser = new Series();
readCommon(s.getTx(), s.getCat(), s.getVal(), s.getDPt(), ser, colors);
@@ -415,6 +430,9 @@ final class ChartSpec {
spec.bar3dHorizontal = g.getBarDir() != null
&& g.getBarDir().getVal() != null
&& "bar".equalsIgnoreCase(g.getBarDir().getVal().value());
if (g.getGrouping() != null && g.getGrouping().getVal() != null) {
spec.grouping = g.getGrouping().getVal().value();
}
if (g.getGapWidth() != null) {
spec.gapWidth = g.getGapWidth().getVal();
}
@@ -430,6 +448,9 @@ final class ChartSpec {
if (s.getSpPr() != null && s.getSpPr().getSolidFill() != null) {
ser.fill = colors.resolveFill(s.getSpPr().getSolidFill());
}
if (s.getShape() != null && s.getShape().getVal() != null) {
ser.shape3d = s.getShape().getVal().value();
}
spec.series.add(ser);
}
} else if (group instanceof CTRadarChart g) {
@@ -567,7 +588,11 @@ final class ChartSpec {
spec.series.add(ser);
}
if (bf != null) {
for (CTBandFmt b : bf.getBandFmt()) {
// §21.2.2.14: c:bandFmt «indexed from low to high» — порядок полос
// задаёт c:idx, а не порядок следования в XML; сортируем по idx.
List<CTBandFmt> fmts = new ArrayList<>(bf.getBandFmt());
fmts.sort(Comparator.comparingInt(b -> (int) b.getIdx().getVal()));
for (CTBandFmt b : fmts) {
Color c = b.getSpPr() != null && b.getSpPr().getSolidFill() != null
? colors.resolveFill(b.getSpPr().getSolidFill())
: null;
@@ -116,7 +116,9 @@ final class PiePainter {
// c:view3D/rotY — поворот пирога вокруг вертикали (default 0)
double rotY = -Math.toRadians(spec.rotY);
double ext = PIE_DEPTH * spec.depthPercent / 100.0 / 2.0;
double persp = spec.perspective;
// §21.2.2.136 + MS-OI29500 §2.1.1516(b): rAngAx=true → перспектива
// игнорируется (ортография), c:perspective действует только при rAngAx=false.
double persp = spec.rightAngledAxes ? 0 : spec.perspective;
double dcam = Surface3dPainter.cameraDistance(1, persp);
double minX = Double.MAX_VALUE;
@@ -112,7 +112,9 @@ final class Surface3dPainter {
// положительный поворот приближает к зрителю правый край, поэтому
// передняя кромка («Категория 1 → Категория 4») идёт вниз вправо.
double rotY = -Math.toRadians(spec.rotY);
double persp = spec.perspective;
// §21.2.2.136 + MS-OI29500 §2.1.1516(b): rAngAx=true → перспектива
// игнорируется (ортография), c:perspective действует только при rAngAx=false.
double persp = spec.rightAngledAxes ? 0 : spec.perspective;
// Пропорции «коробки» построения, снятые с эталона Word: глубина —
// DEPTH_RATIO ширины (c:view3D/depth от неё), высота значений —
@@ -129,7 +131,11 @@ final class Surface3dPainter {
double availW = Math.max(10, box.getWidth() - leftGutter - rightGutter);
double availH = Math.max(10, box.getHeight() - bottomGutter - topGutter);
double depthScale = DEPTH_RATIO * Math.max(0.05, spec.depthPercent / 100.0);
double heightScale = HEIGHT_RATIO * availH / availW;
// MS-OI29500 §2.1.1481(c): c:hPercent задан → высота значений = hPercent% от
// ширины области построения (в модельных единицах ширина u = 1.0); опущен →
// автомасштаб HEIGHT_RATIO·availH/availW (§2.1.1481(a), калибровка по эталону).
double heightScale = spec.hPercent != null
? spec.hPercent / 100.0 : HEIGHT_RATIO * availH / availW;
// 1. Узлы сетки и пол — в модельно-экранные координаты
Node[][] node = new Node[nSer][nCat];
@@ -208,6 +214,19 @@ final class Surface3dPainter {
double w01 = ((z[r + 1][c] - lo) / span - 0.5) * heightScale;
double w11 = ((z[r + 1][c + 1] - lo) / span - 0.5) * heightScale;
double w10 = ((z[r][c + 1] - lo) / span - 0.5) * heightScale;
if (spec.wireframe) {
// §21.2.2.230: «the surface chart is drawn as a wireframe» —
// только каркас без заливки (прецедент Surface2dPainter.drawWireframe);
// цвет ребра — полоса высот средней высоты ячейки, без шейдинга.
double wAvg = (w00 + w01 + w11 + w10) / 4.0;
List<Color> bands = spec.bandColors.isEmpty() ? palette : spec.bandColors;
int k = Math.max(0, Math.min(bandCount - 1, (int) Math.floor(
(wAvg - (-0.5 * heightScale)) / (spanUnit * heightScale))));
tris.add(wireQuad(u0, u1, v0, v1, w00, w01, w11, w10,
bands.get(k % bands.size()),
rotX, rotY, depthScale, persp, fit));
continue;
}
// Диагональ — та, чьи концы выше (сумма значений больше). Седловая
// ячейка в проекции вогнутая, и фиксированная диагональ даёт то
// грань не той полосы, то треугольник внутри треугольника. Word
@@ -237,17 +256,18 @@ final class Surface3dPainter {
}
}
tris.sort(Comparator.comparingDouble(Tri::depth).reversed());
BasicStroke seam = new BasicStroke(0.4f);
for (Tri t : tris) {
g.setColor(t.color());
g.fill(t.path());
g.setStroke(seam);
g.draw(t.path());
}
if (spec.wireframe) {
g.setColor(new Color(0x80, 0x80, 0x80));
g.setStroke(new BasicStroke(0.5f));
for (Tri t : tris) {
g.setColor(t.color());
g.draw(t.path());
}
} else {
BasicStroke seam = new BasicStroke(0.4f);
for (Tri t : tris) {
g.setColor(t.color());
g.fill(t.path());
g.setStroke(seam);
g.draw(t.path());
}
}
@@ -257,6 +277,29 @@ final class Surface3dPainter {
rotX, rotY, depthScale, heightScale, persp, fit);
}
/** Каркасная ячейка: контур квада в экранных координатах + глубина центроида. */
private static Tri wireQuad(double u0, double u1, double v0, double v1,
double w00, double w01, double w11, double w10,
Color color, double rotX, double rotY,
double depthScale, double persp, Fit fit) {
double[][] pts = {{u0, v0, w00}, {u0, v1, w01}, {u1, v1, w11}, {u1, v0, w10}};
Path2D path = new Path2D.Double();
double depth = 0;
for (int i = 0; i < pts.length; i++) {
Node n = project(pts[i][0], pts[i][1], pts[i][2], rotX, rotY, depthScale, persp);
double x = n.x() * fit.scaleX() + fit.offX();
double y = n.y() * fit.scaleY() + fit.offY();
if (i == 0) {
path.moveTo(x, y);
} else {
path.lineTo(x, y);
}
depth += n.depth();
}
path.closePath();
return new Tri(path, color, depth / pts.length);
}
/**
* Один треугольник ячейки: нормаль (и, как следствие, затемнение) считается
* по исходному треугольнику, а сам он режется плоскостями полос высот —
@@ -416,8 +459,9 @@ final class Surface3dPainter {
project(0.5, v, floorW, rotX, rotY, depthScale, persp), fit);
}
// сетка значений: левая стенка (от переднего левого ребра в глубину)
// и дальней стенка — обе рисует Word
if (valAxis.gridlines) {
// и дальней стенка — обе рисует Word; c:delete (§21.2.2.38) убирает ось
// целиком — сетка удалённой оси не рисуется.
if (valAxis.gridlines && !valAxis.deleted) {
for (double v = lo; v <= hi + unit / 2; v += unit) {
double w = ((v - lo) / span - 0.5) * heightScale;
line(g, project(-0.5, -0.5, w, rotX, rotY, depthScale, persp),
@@ -445,7 +489,7 @@ final class Surface3dPainter {
// Ось значений: левый край дальней стенки
DrawMlText.Style vs = valAxis.labelStyle;
if (vs != null) {
if (vs != null && !valAxis.deleted) {
double h = DrawMlText.textHeight(vs) + 2;
int i = 0;
for (double v = lo; v <= hi + unit / 2; v += unit) {
@@ -464,7 +508,7 @@ final class Surface3dPainter {
// Категории: переднее нижнее ребро пола
DrawMlText.Style cs = catAxis.labelStyle;
if (cs != null) {
if (cs != null && !catAxis.deleted) {
double h = DrawMlText.textHeight(cs) + 2;
for (int c = 0; c < nCat; c++) {
String label = c < spec.categories.size() ? spec.categories.get(c) : "";
@@ -485,7 +529,7 @@ final class Surface3dPainter {
// Ряды: правое нижнее ребро пола
DrawMlText.Style ss = serAxis.labelStyle;
if (ss != null) {
if (ss != null && !serAxis.deleted) {
double h = DrawMlText.textHeight(ss) + 2;
for (int r = 0; r < nSer; r++) {
String label = spec.series.get(r).name;