Merge pull request 'feat: диаграммы как формулы — геометрия из семантики DrawingML вместо подгонки под растр Word' (#21) from feat/chart-spec-math into main
Main: tests, deploy, autotests / java (push) Successful in 1m50s
Main: tests, deploy, autotests / web (push) Successful in 1m13s
Main: tests, deploy, autotests / images (push) Successful in 4m56s
Main: tests, deploy, autotests / deploy (push) Successful in 1m40s
Main: tests, deploy, autotests / autotests (push) Successful in 1m33s
Main: tests, deploy, autotests / rollback (push) Has been skipped

Reviewed-on: #21
This commit was merged in pull request #21.
This commit is contained in:
2026-10-21 01:42:15 +03:00
8 changed files with 599 additions and 143 deletions
@@ -46,7 +46,7 @@ final class CartesianPainter {
if (!cats.isEmpty()) {
catGutter = DrawMlText.textHeight(catStyle, g.getFontRenderContext());
}
catGutter += 6;
catGutter += 6; // auto-layout Word: отступ от подписей до области (Word-эмпирика)
// Word укрупняет шаг оси значений, если подписи не влезают: интервал
// между делениями не меньше ~2,5 высоты строки подписи. В word-export.pdf
@@ -72,7 +72,7 @@ final class CartesianPainter {
for (String l : valLabels) {
valGutter = Math.max(valGutter, DrawMlText.textWidth(l, valStyle, g.getFontRenderContext()));
}
valGutter += 8;
valGutter += 8; // auto-layout Word: отступ от подписей до области (Word-эмпирика)
Rectangle2D plot = horizontal
? new Rectangle2D.Double(box.getX() + valGutter, box.getY() + catGutter,
@@ -308,8 +308,20 @@ final class CartesianPainter {
boolean horizontal) {
int nSer = spec.series.size();
double slot = (horizontal ? plot.getHeight() : plot.getWidth()) / nCat;
double group = slot * 0.82;
double bar = group / Math.max(1, nSer);
// ECMA-376 CT_GapAmount/CT_Overlap: зазор между группами категорий и
// перекрытие рядов внутри группы задаются в процентах ширины бара.
// Слот = nSer баров + зазор => barW = slot/(nSer + gap/100)
// (Word default gapWidth=150, один ряд => bar = 0.4 слота).
// Шаг между рядами внутри группы step = barW·(1 - overlap/100):
// overlap>0 — перекрытие, <0 — раздвижка; раздвижка не выносит
// группу за пределы слота.
double overlap = Math.max(-100, Math.min(100, spec.overlap));
double barW = slot / (Math.max(1, nSer) + spec.gapWidth / 100.0);
double step = barW * (1 - overlap / 100.0);
if (nSer > 1 && step > barW) {
step = Math.min(step, (slot - barW) / (nSer - 1));
}
double groupW = barW + (nSer - 1) * step;
double zero = valuePos(0, lo, hi, plot, horizontal);
for (int si = 0; si < nSer; si++) {
ChartSpec.Series s = spec.series.get(si);
@@ -321,14 +333,14 @@ final class CartesianPainter {
Color c = s.fillAt(i, palette);
g.setColor(c);
double center = catPos(i, nCat, plot, horizontal);
double start = center - group / 2 + si * bar;
double start = center - groupW / 2 + si * step;
double end = valuePos(v, lo, hi, plot, horizontal);
if (horizontal) {
g.fill(new Rectangle2D.Double(Math.min(zero, end), start,
Math.abs(end - zero), bar * 0.92));
Math.abs(end - zero), barW));
} else {
g.fill(new Rectangle2D.Double(start, Math.min(zero, end),
bar * 0.92, Math.abs(end - zero)));
barW, Math.abs(end - zero)));
}
}
}
@@ -29,6 +29,7 @@ final class ChartRenderer {
/** Разрешение растра: 300 dpi, чтобы подписи не мылились при печати. */
static final int DPI = 300;
/** Поля вокруг chartSpace от рамки графика. Auto-layout Word — Word-эмпирика. */
private static final double PADDING = 4.0;
private ChartRenderer() {
@@ -116,6 +116,13 @@ final class ChartSpec {
double depthPercent = 100;
double perspective = 30;
boolean rightAngledAxes = true;
// Спека-параметры DrawingML, исполнение Word; дефолты — ECMA-376/Word.
// firstSliceAng для PIE3D не читается: в JAXB-модели docx4j 17.3.2
// у CTPie3DChart геттера CTFirstSliceAng нет.
double firstSliceAng = 0;
double holeSize = 50;
double gapWidth = 150;
double overlap = 0;
final List<Color> bandColors = new ArrayList<>();
boolean wireframe;
Color chartFill = Color.WHITE;
@@ -219,8 +226,8 @@ final class ChartSpec {
}
}
private static void readGroup(Object group, ChartSpec spec, DrawMlColor colors,
List<Color> palette) {
static void readGroup(Object group, ChartSpec spec, DrawMlColor colors,
List<Color> palette) {
if (group instanceof CTPie3DChart g) {
spec.type = Type.PIE3D;
for (CTPieSer s : g.getSer()) {
@@ -228,11 +235,20 @@ final class ChartSpec {
}
} else if (group instanceof CTPieChart g) {
spec.type = Type.PIE;
if (g.getFirstSliceAng() != null) {
spec.firstSliceAng = g.getFirstSliceAng().getVal();
}
for (CTPieSer s : g.getSer()) {
spec.series.add(readPieSer(s, colors));
}
} else if (group instanceof CTDoughnutChart g) {
spec.type = Type.DOUGHNUT;
if (g.getFirstSliceAng() != null) {
spec.firstSliceAng = g.getFirstSliceAng().getVal();
}
if (g.getHoleSize() != null) {
spec.holeSize = g.getHoleSize().getVal();
}
for (CTPieSer s : g.getSer()) {
spec.series.add(readPieSer(s, colors));
}
@@ -257,6 +273,13 @@ final class ChartSpec {
&& g.getBarDir().getVal() != null
&& "bar".equalsIgnoreCase(g.getBarDir().getVal().value());
spec.type = horizontal ? Type.BAR_HORIZONTAL : Type.BAR;
// getVal() у CTGapAmount/CTOverlap — примитив, проверяется только обёртка
if (g.getGapWidth() != null) {
spec.gapWidth = g.getGapWidth().getVal();
}
if (g.getOverlap() != null) {
spec.overlap = g.getOverlap().getVal();
}
for (CTBarSer s : g.getSer()) {
Series ser = new Series();
readCommon(s.getTx(), s.getCat(), s.getVal(), s.getDPt(), ser, colors);
@@ -12,27 +12,37 @@ import java.util.Comparator;
import java.util.List;
/**
* Секторная диаграмма: 2D (pie/doughnut) и 3D (pie3D) одним кодом —
* у 2D-варианта глубина экструзии равна нулю.
* Секторная диаграмма: плоские PIE/DOUGHNUT — круг, PIE3D — экструдированный
* диск в общей камере {@link Surface3dPainter#project} (одна формула камеры
* для surface и pie: c:view3D/perspective — угол обзора, см.
* {@link Surface3dPainter#cameraDistance}).
*
* 3D в Word — это круг, наклонённый на c:view3D/rotX вокруг горизонтальной
* оси, с экструзией вниз. Рисуется художником алгоритма: сектора от задних
* к передним, у каждого сначала боковая стенка и торцы, затем верхняя
* грань.
* 3D-диск лежит в модельной плоскости (u, v) (единица — диаметр диска),
* наклонён на c:view3D/rotX и повёрнут на c:view3D/rotY, экструзия — вниз
* по w на {@link #PIE_DEPTH}·c:view3D/depth. Рисуется художником алгоритма:
* сектора от задних к передним (по спроецированной глубине середины), у
* каждого стенки и торцы, затем верхняя грань. Углы Word — от 12 часов по
* часовой: обод (u, v) = (sin A, cos A)/2.
*/
final class PiePainter {
/** Доля радиуса, уходящая в глубину при depthPercent=100. */
private static final double DEPTH_RATIO = 0.22;
/**
* Маппинг Word c:depthPercent -> высота экструзии в радиусах диска
* (100 -> 0,22·R). Word-эмпирика: спека высоту экструзии pie не
* описывает; замер по word-export.pdf
* (PiePainterTest.pie3dSilhouetteMatchesWordReference).
*/
private static final double PIE_DEPTH = 0.22;
/**
* Word рисует pie3D чуть более «пологим» и с запасом вокруг торта:
* замер по word-export.pdf (300 dpi, область 219,2×149,1 pt) — силуэт 540×316 px,
* ry/rx = 0,475 при rotX=30° (sin 30° = 0,5) и радиус 270 px из
* вписанного 288 px. Без этих поправок торт на 8% выше эталона.
* Auto-layout Word: доля области построения под силуэт торта.
* Word-эмпирика: спека auto-layout не описывает; замер по
* word-export.pdf (PiePainterTest.pie3dSilhouetteMatchesWordReference).
*/
private static final double TILT_CORRECTION = 0.95;
private static final double FIT_MARGIN = 0.865;
private static final double PIE_FIT = 0.865;
/** Точек обода на полный круг при замере силуэта. */
private static final int RIM_SAMPLES = 128;
private PiePainter() {
}
@@ -60,22 +70,12 @@ final class PiePainter {
return;
}
boolean threeD = spec.type == ChartSpec.Type.PIE3D;
double tilt = threeD ? Math.sin(Math.toRadians(clampRotX(spec.rotX))) * TILT_CORRECTION : 1.0;
double depthPct = threeD ? spec.depthPercent / 100.0 : 0.0;
double depthRatio = DEPTH_RATIO * depthPct;
// Подбираем радиус так, чтобы эллипс вместе с экструзией влез в box
double rx = Math.min(box.getWidth() / 2.0,
box.getHeight() / (2.0 * tilt + 2.0 * depthRatio));
rx = Math.max(4, rx * FIT_MARGIN);
double ry = rx * tilt;
double depth = rx * depthRatio;
double cx = box.getCenterX();
double cy = box.getY() + ry + (box.getHeight() - (2 * ry + depth)) / 2.0;
double holeRatio = spec.type == ChartSpec.Type.DOUGHNUT ? spec.holeSize / 100.0 : 0.0;
List<Slice> slices = new ArrayList<>();
double angle = 0;
// c:firstSliceAng — стартовый угол первого сектора (ECMA-376, default 0;
// для PIE3D в JAXB-модели docx4j 17.3.2 геттера нет, остаётся 0)
double angle = spec.firstSliceAng;
for (int i = 0; i < s.values.size(); i++) {
Double v = s.values.get(i);
if (v == null || v <= 0) {
@@ -90,16 +90,65 @@ final class PiePainter {
angle += sweep;
}
// Задние сектора раньше, передние позже: дальняя сторона торта —
// это 12 часов (midDeg≈0/360, cos≈1), поэтому сортировка по cos
// должна быть убывающей, иначе дальние сектора рисуются поверх
// передних и перекрывают их торцы.
if (spec.type == ChartSpec.Type.PIE3D) {
paint3d(g, spec, slices, box);
return;
}
// Плоские PIE/DOUGHNUT: круг, вписанный в область построения.
double rx = Math.max(4, Math.min(box.getWidth() / 2.0, box.getHeight() / 2.0) * PIE_FIT);
double cx = box.getCenterX();
double cy = box.getY() + box.getHeight() / 2.0;
for (Slice sl : slices) {
drawSlice(g, sl, cx, cy, rx, rx, holeRatio);
}
}
/**
* 3D-пирог: радиус подбирается по замеренному силуэту — обод сверху
* (w = ext) и снизу (w = 0); перспектива окружности эллипсом не является,
* поэтому вписка по эллипсу неверна. Масштаб =
* {@link #PIE_FIT}·min(доступная ширина/силуэт, высота/силуэт).
*/
private static void paint3d(Graphics2D g, ChartSpec spec, List<Slice> slices, Rectangle2D box) {
double rotX = Math.toRadians(clampRotX(spec.rotX));
// 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;
double dcam = Surface3dPainter.cameraDistance(1, persp);
double minX = Double.MAX_VALUE;
double maxX = -Double.MAX_VALUE;
double minY = Double.MAX_VALUE;
double maxY = -Double.MAX_VALUE;
for (int i = 0; i < RIM_SAMPLES; i++) {
double a = 360.0 * i / RIM_SAMPLES;
for (double w : new double[]{ext, 0}) {
Surface3dPainter.Node n = rim(a, w, rotX, rotY, persp);
minX = Math.min(minX, n.x());
maxX = Math.max(maxX, n.x());
minY = Math.min(minY, n.y());
maxY = Math.max(maxY, n.y());
}
}
double silW = Math.max(1e-6, maxX - minX);
double silH = Math.max(1e-6, maxY - minY);
double scale = PIE_FIT * Math.min(box.getWidth() / silW, box.getHeight() / silH);
double midX = (minX + maxX) / 2.0;
double midY = (minY + maxY) / 2.0;
double cx = box.getCenterX();
double cy = box.getCenterY();
Cam cam = new Cam(rotX, rotY, ext, persp, dcam, scale, midX, midY, cx, cy,
cx + (minX - midX) * scale, cx + (maxX - midX) * scale);
// Задние сектора раньше, передние позже — по спроецированной глубине
// середины сектора (замена прежней сортировки по -cos(midDeg)):
// дальняя сторона торта — 12 часов.
slices.sort(Comparator.comparingDouble(
(Slice sl) -> -Math.cos(Math.toRadians(sl.midDeg()))));
(Slice sl) -> -rim(sl.midDeg(), ext, rotX, rotY, persp).depth()));
for (Slice sl : slices) {
drawSlice(g, sl, cx, cy, rx, ry, depth,
spec.type == ChartSpec.Type.DOUGHNUT ? 0.5 : 0.0);
draw3dSlice(g, sl, cam);
}
}
@@ -108,17 +157,15 @@ final class PiePainter {
}
/**
* Один сектор. Углы Word: от 12 часов по часовой. Перевод в параметрический
* угол Java: theta = 90 - wordAngle (y на экране растёт вниз).
* Один плоский сектор. Углы Word: от 12 часов по часовой. Перевод в
* параметрический угол Java: theta = 90 - wordAngle (y на экране растёт
* вниз).
*/
private static void drawSlice(Graphics2D g, Slice sl, double cx, double cy,
double rx, double ry, double depth, double holeRatio) {
double rx, double ry, double holeRatio) {
double thetaStart = 90.0 - sl.startDeg();
double thetaSweep = -sl.sweepDeg();
if (depth > 0.01) {
drawWalls(g, sl, cx, cy, rx, ry, depth);
}
Arc2D.Double top = new Arc2D.Double(cx - rx, cy - ry, 2 * rx, 2 * ry,
thetaStart, thetaSweep, Arc2D.PIE);
g.setColor(sl.color());
@@ -139,73 +186,117 @@ final class PiePainter {
}
}
/** Боковая стенка дуги + торцы радиальных граней (видимая нижняя половина). */
private static void drawWalls(Graphics2D g, Slice sl, double cx, double cy,
double rx, double ry, double depth) {
double thetaStart = 90.0 - sl.startDeg();
double thetaEnd = thetaStart - sl.sweepDeg();
// Боковая стенка цилиндра в Word освещена сбоку: слева ~0,75 от цвета
// сектора, справа ~0,40 (замер по word-export.pdf, 300 dpi: ×0,71 у x=250,
// ×0,58 у x=440, ×0,40 у x=640). Плоская заливка делает пирог
// «бумажным», поэтому стенку красят горизонтальным градиентом.
Color left = DrawMlColor.darken(sl.color(), 0.25);
Color right = DrawMlColor.darken(sl.color(), 0.60);
/**
* Один 3D-сектор: стенки видимой части дуги (наружная нормаль обода
* смотрит на камеру), торцы радиальных граней (нижняя экранная четверть —
* Word-эмпирика), затем верхняя грань по замеренному ободу.
*/
private static void draw3dSlice(Graphics2D g, Slice sl, Cam cam) {
double a0 = sl.startDeg();
double a1 = a0 + sl.sweepDeg();
// Видимая часть дуги: sin(theta) < 0 (нижняя половина эллипса)
List<double[]> visible = visibleArc(thetaStart, thetaEnd);
for (double[] seg : visible) {
Path2D wall = new Path2D.Double();
boolean first = true;
// шаг 1°: при 4° хорда между точками дуги отстаёт от дуги на
// десятки пикселей (эллипс пологий) и вдоль границы сектора
// остаётся белый клин между стенкой соседнего сектора и торцом
for (double t = seg[0]; t <= seg[1] + 1e-9; t += 1.0) {
Point2D p = point(cx, cy, rx, ry, t);
if (first) {
wall.moveTo(p.getX(), p.getY());
first = false;
} else {
wall.lineTo(p.getX(), p.getY());
}
}
Point2D end = point(cx, cy, rx, ry, seg[1]);
wall.lineTo(end.getX(), end.getY() + depth);
for (double t = seg[1]; t >= seg[0] - 1e-9; t -= 1.0) {
Point2D p = point(cx, cy, rx, ry, t);
wall.lineTo(p.getX(), p.getY() + depth);
}
wall.closePath();
g.setPaint(new java.awt.GradientPaint(
new Point2D.Double(cx - rx, 0), left,
new Point2D.Double(cx + rx, 0), right));
g.fill(wall);
if (sl.outline() != null) {
g.setColor(sl.outline());
g.setStroke(new BasicStroke((float) sl.outlineWidth()));
g.draw(wall);
// шаг 1°: при 4° хорда между точками дуги отстаёт от дуги на десятки
// пикселей и вдоль границы сектора остаётся белый клин между стенкой
// соседнего сектора и торцом
List<Double> angles = new ArrayList<>();
for (double a = a0; a < a1 - 1e-9; a += 1.0) {
angles.add(a);
}
angles.add(a1);
draw3dWalls(g, sl, cam, angles);
Point2D topCenter = cam.screen(cam.center(cam.ext()));
draw3dEndFaces(g, sl, cam, a0, a1, topCenter);
// Верхняя грань по замеренному ободу.
Path2D top = new Path2D.Double();
top.moveTo(topCenter.getX(), topCenter.getY());
for (double a : angles) {
Point2D p = cam.rimPoint(a, cam.ext());
top.lineTo(p.getX(), p.getY());
}
top.closePath();
g.setColor(sl.color());
g.fill(top);
if (sl.outline() != null) {
g.setColor(sl.outline());
g.setStroke(new BasicStroke((float) sl.outlineWidth()));
g.draw(top);
}
}
/**
* Стенки цилиндра: Word освещает их сбоку — слева ~0,75 от цвета сектора,
* справа ~0,40 (замер по word-export.pdf, 300 dpi: ×0,71 у x=250, ×0,58
* у x=440, ×0,40 у x=640). Плоская заливка делает пирог «бумажным»,
* поэтому стенка красится горизонтальным градиентом по ширине силуэта.
* Видимая часть дуги: наружная нормаль обода смотрит на камеру.
*/
private static void draw3dWalls(Graphics2D g, Slice sl, Cam cam, List<Double> angles) {
g.setPaint(new java.awt.GradientPaint(
new Point2D.Double(cam.leftX(), 0), DrawMlColor.darken(sl.color(), 0.25),
new Point2D.Double(cam.rightX(), 0), DrawMlColor.darken(sl.color(), 0.60)));
int runStart = -1;
for (int i = 0; i <= angles.size(); i++) {
boolean vis = i < angles.size() && cam.wallVisible(angles.get(i));
if (vis && runStart < 0) {
runStart = i;
} else if (!vis && runStart >= 0) {
fillWall(g, sl, cam, angles, runStart, i - 1);
runStart = -1;
}
}
}
// Торцы: радиальные грани на границах сектора. Видна только та грань,
// чья внешняя нормаль смотрит «вверх» по экрану (камера наклонена на
// rotX: грань видна, если её нормаль в плоскости круга имеет
// составляющую к наблюдателю). Для начальной границы сектора внешняя
// нормаль — это dP/dt, для конечной — обратная, отсюда разные признаки
// cos(t). Прежний признак sin(t)<0 рисовал обе грани общей границы
// соседних секторов, и торец дальнего сектора выползал наружу.
private static void fillWall(Graphics2D g, Slice sl, Cam cam,
List<Double> angles, int from, int to) {
Path2D wall = new Path2D.Double();
Point2D p = cam.rimPoint(angles.get(from), cam.ext());
wall.moveTo(p.getX(), p.getY());
for (int i = from + 1; i <= to; i++) {
p = cam.rimPoint(angles.get(i), cam.ext());
wall.lineTo(p.getX(), p.getY());
}
for (int i = to; i >= from; i--) {
p = cam.rimPoint(angles.get(i), 0);
wall.lineTo(p.getX(), p.getY());
}
wall.closePath();
g.fill(wall);
if (sl.outline() != null) {
g.setColor(sl.outline());
g.setStroke(new BasicStroke((float) sl.outlineWidth()));
g.draw(wall);
}
}
/**
* Торцы: радиальные грани на границах сектора. Word рисует торец, только
* если грань выходит в нижнюю четверть экрана относительно центра
* верхней грани: торец конца сектора — в нижне-левой, торец начала — в
* нижне-правой (Word-эмпирика по word-export.pdf: признак по истинной
* нормали камеры рисует на общей границе секторов торец дальнего сектора,
* а в Word виден торец переднего). Регрессия —
* PiePainterTest#pie3dSharedEdgeShowsOnlyCameraFacingEnd.
*/
private static void draw3dEndFaces(Graphics2D g, Slice sl, Cam cam,
double a0, double a1, Point2D topCenter) {
for (int e = 0; e < 2; e++) {
double t = e == 0 ? thetaStart : thetaEnd;
double outwardUp = e == 0 ? -Math.cos(Math.toRadians(t))
: Math.cos(Math.toRadians(t));
if (outwardUp >= 0 || Math.sin(Math.toRadians(t)) >= 0) {
double a = e == 0 ? a0 : a1;
Point2D edge = cam.rimPoint(a, cam.ext());
boolean drawn = e == 0
? edge.getX() > topCenter.getX() && edge.getY() > topCenter.getY()
: edge.getX() < topCenter.getX() && edge.getY() > topCenter.getY();
if (!drawn) {
continue;
}
Point2D p = point(cx, cy, rx, ry, t);
Point2D edgeBottom = cam.rimPoint(a, 0);
Point2D bottom = cam.screen(cam.center(0));
Path2D face = new Path2D.Double();
face.moveTo(cx, cy);
face.lineTo(p.getX(), p.getY());
face.lineTo(p.getX(), p.getY() + depth);
face.lineTo(cx, cy + depth);
face.moveTo(topCenter.getX(), topCenter.getY());
face.lineTo(edge.getX(), edge.getY());
face.lineTo(edgeBottom.getX(), edgeBottom.getY());
face.lineTo(bottom.getX(), bottom.getY());
face.closePath();
g.setColor(DrawMlColor.darken(sl.color(), 0.30));
g.fill(face);
@@ -217,32 +308,47 @@ final class PiePainter {
}
}
/**
* Пересечение дуги [a,b] (может идти по убыванию) с нижней полуокружностью
* sin(theta) < 0. Возвращает сегменты в порядке возрастания угла.
*/
private static List<double[]> visibleArc(double a, double b) {
double lo = Math.min(a, b);
double hi = Math.max(a, b);
List<double[]> out = new ArrayList<>();
// нормализуем в [0,360) и идём по виткам
double span = hi - lo;
if (span >= 360) {
out.add(new double[]{lo, lo + 360});
return out;
}
for (double base = Math.floor(lo / 360.0) * 360.0; base < hi + 360; base += 360.0) {
double segLo = Math.max(lo, base + 180.0);
double segHi = Math.min(hi, base + 360.0);
if (segHi > segLo + 1e-9) {
out.add(new double[]{segLo, segHi});
}
}
return out;
/** Обод диска: Word-угол aDeg от 12 часов по часовой -> (u, v) = (sin, cos)/2. */
private static Surface3dPainter.Node rim(double aDeg, double w,
double rotX, double rotY, double persp) {
double t = Math.toRadians(aDeg);
return Surface3dPainter.project(Math.sin(t) / 2.0, Math.cos(t) / 2.0,
w, rotX, rotY, 1, persp);
}
private static Point2D point(double cx, double cy, double rx, double ry, double thetaDeg) {
double t = Math.toRadians(thetaDeg);
return new Point2D.Double(cx + rx * Math.cos(t), cy - ry * Math.sin(t));
/** Камера 3D-пирога + вписка силуэта в область построения. */
private record Cam(double rotX, double rotY, double ext, double persp, double dcam,
double scale, double midX, double midY, double cx, double cy,
double leftX, double rightX) {
Surface3dPainter.Node center(double w) {
return Surface3dPainter.project(0, 0, w, rotX, rotY, 1, persp);
}
Point2D rimPoint(double aDeg, double w) {
Surface3dPainter.Node n = rim(aDeg, w, rotX, rotY, persp);
return screen(n);
}
/**
* Стенка видна: наружная нормаль обода (2u, 2v, 0) смотрит на камеру.
* Камера в модели: (-d·cos(rotX)·sin(rotY), -d·cos(rotX)·cos(rotY),
* d·sin(rotX)); скалярное произведение нормали на (камера - точка)
* равно -2·d·cos(rotX)·y1 - 0.5, где y1 = u·sin(rotY) + v·cos(rotY)
* — повёрнутая v-координата обода. Ортография (d = ∞) => y1 < 0,
* rotX = 90 => не видно ни одной стенки.
*/
boolean wallVisible(double aDeg) {
double t = Math.toRadians(aDeg);
double y1 = (Math.sin(t) * Math.sin(rotY)
+ Math.cos(t) * Math.cos(rotY)) / 2.0;
double limit = Double.isInfinite(dcam) ? 0.0 : -0.25 / (dcam * Math.cos(rotX));
return y1 < limit;
}
Point2D screen(Surface3dPainter.Node n) {
return new Point2D.Double(cx + (n.x() - midX) * scale,
cy + (n.y() - midY) * scale);
}
}
}
@@ -25,14 +25,6 @@ import java.util.List;
*/
final class Surface3dPainter {
/**
* Расстояние камеры сцены (в долях ширины коробки построения).
* `c:view3D/perspective` (по умолчанию 30) — это НЕ угол обзора, а
* коэффициент глубины: он масштабирует расстояние относительно
* эталонных 30. Значение откалибровано по эталону Word
* (см. Surface3dPainterTest.cameraMatchesWordReference).
*/
static final double CAMERA_DISTANCE = 2.36;
/**
* Глубина коробки построения относительно ширины (при c:view3D/depth = 100).
@@ -521,12 +513,28 @@ final class Surface3dPainter {
double height = y1 * sb + w * cb;
double k = 1.0;
if (perspective > 0.01) {
double d = CAMERA_DISTANCE * (30.0 / Math.max(1.0, perspective));
double d = cameraDistance(depthScale, perspective);
k = d / Math.max(0.05, d + depth);
}
return new Node(x1 * k, -height * k, depth);
}
/**
* Расстояние камеры от центра коробки построения (в единицах её
* полуширины): поле зрения c:view3D/perspective (θ, градусы, Word
* default 30) накрывает описанную сферу коробки — полуширина 0.5 (u) и
* полуглубина 0.5·depthScale (v) => R = sqrt(0.25 + 0.25·ds²),
* d = R/tan(θ/2). Ортография (perspective ≤ 0.01) — бесконечность.
* Единая камера surface и pie3D (PiePainter).
*/
static double cameraDistance(double depthScale, double perspective) {
if (perspective <= 0.01) {
return Double.POSITIVE_INFINITY;
}
return Math.sqrt(0.25 + 0.25 * depthScale * depthScale)
/ Math.tan(Math.toRadians(perspective) / 2.0);
}
private static double uOf(int c, int nCat) {
return nCat > 1 ? (double) c / (nCat - 1) - 0.5 : 0;
}
@@ -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;
import org.docx4j.dml.chart.CTBarChart;
import org.docx4j.dml.chart.CTBoolean;
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.junit.jupiter.api.Test;
import java.util.List;
import static org.junit.jupiter.api.Assertions.*;
/**
@@ -46,6 +55,66 @@ class ChartSpecTest {
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() {
CTChart chart = new CTChart();
chart.setTitle(new CTTitle());
@@ -82,6 +82,124 @@ class PiePainterTest {
+ "синего " + 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() {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.PIE3D;