` → 0, `pageCount_breaksInsideTablesAreCounted`, `pageCount_continuousSectionsNotCountedLightweight`, `validate_notAZip`↔`inputNotAZip_rejectedBeforeRender`, `validate_plainZipRejected`/`validate_xlsxRenamedRejected`/`validate_zipBombRejected`/`validate_tooManyEntriesRejected`↔`plainZipNotDocx_rejected`/`inputNotDocx_rejectedBeforeRender` — контейнер и zip-бомба), `BundledFontsTest`↔`ruPlain_emDashEmbeddedNotHelvetica`, `ChartSpecTest`↔автозаголовки, `PresetGeometryTest`↔`chartsSmartArt_drawingsBecomeImages` (`tableMatchesEcmaXml` — синхрон таблицы пресетов с ECMA XML; кольцевые стрелки — семантика `?:` и знаки дуг Arc2D), chart-пейнтеры↔`chartsSmartArt_drawingsBecomeImages` (+`drawingErrors_*`↔app `errorFlagCharts_rejected`/`errorFlagSmartArt_rejected`), новые пейнтеры `ScatterPainterTest`/`RadarPainterTest`/`StockPainterTest`/`OfPiePainterTest`/`Surface2dPainterTest`/`Cartesian3dPainterTest`↔`chartTypes_allTypesRenderAsImages` (фикстура `chart-types`; ось X scatter/bubble и OF_PIE-заголовок — `ChartSpecTest`), вид сверху контурной — `Surface2dPainterTest#filledContour_*` + `ChartRendererTest#wireframeSurfaceLegend_hollowMarkers`↔`chartTypes_allTypesRenderAsImages` (заливка полос `fillBands` одним путём на полосу без AA-шва; полые маркеры легенды при `c:wireframe` §21.2.2.230), lineChart stacked — `ChartSpecTest#lineGroupingParsed` + `ChartRendererTest#stackedCumulative_*`/`stackedRange_coversNegativeSums` + `CartesianPainterTest#stackedLine_seriesStackCumulatively`/`percentStackedLine_topSeriesFlatAtHundred`↔`chartTypes_allTypesRenderAsImages`; `noLoggingWarningInPdf` — регрессия `slf4j-simple`, `pdfTitle_comesFromParameter` — регрессия PDF-title (юнит-партнёра нет). App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed` (гонка реестра `PhysicalFonts`), `corruptNotAZip_rejected`, `plainZipNotDocx_rejected` (голый zip без манифеста → 400), `junkInsideValidZip_conversionError` (500 на валидном .docx-контейнере с мусором), `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `drawingsAlwaysRendered`, `cyrillicAndPathInFilename_sanitizedResponseName` (RFC 5987 + path-traversal), `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey` (открытая документация + матч фильтра без forwarded-contextPath), `dotSegmentOpenPrefix_rejected` (точечные сегменты `..`/`%2e` — не открытый путь), `errorFlagNotBoolean_rejected` (битый error-флаг → 400), `methodNotSupportedReturns405`/`badContentTypeReturns415` (405/415 вместо catch-all 500); DoS/корректность core: `ChartSpecTest#hugePointIndex_rejectedNotOom`/`hugePtCount_rejectedNotOom`/`hugeCategoryIndex_rejectedNotOom` (`MAX_POINTS`), `Surface3dPainterTest#axisBounds_tinyMajorUnit_fallsBackToNiceUnit`/`axisBounds_zeroMajorUnit_fallsBackToNiceUnit` (`MAX_TICKS`), `ChartRendererTest#axisBounds_explicitHugeRange_reunitsToMaxTicks`/`axisBounds_infiniteSpan_fallsBackToData` (шаг при враждебном/неконечном диапазоне), `ChartSpecTest#nonFiniteScalingBounds_dropped` (±∞ scaling), `WordPdfConverterTest#hostileChartAxis_convertsNotHangs`/`hugeExtentChart_removedNotOom`/`chartWithoutExtent_errorFlagRejects` (`MAX_EXTENT_EMU`), `DrawMlTextTest#hugeWord_wrapsLinearly` (fitCut — прогресс реза), `DrawMlColorTest#invalidSrgbHexFallsBackToOfficeDefault` (битый hex темы — деградация), `GlyphCoverageNormalizerTest#multipleTextNodes_runLeftUntouched` (guard составного рана)/`nestedRunInTextBox_innerSplit` + `SymbolFontNormalizerTest#nestedRunInTextBox_innerNormalized` (вложенные раны текстбоксов), `CartesianPainterTest#areaFill_closesToBaseline` (AREA к базовой линии), `ChartRendererTest#overlayLegend_drawnOverPlot` + `ChartSpecTest#overlayLegend_keepsPositionAndFlag` (overlay-легенда).
- SmartArt-текст: `SmartArtRendererTest#normAutofitShrinksToFit`/`#missingAutofitKeepsDeclaredSize`/`#emptyTxBody_noPlaceholderInk` + `DrawMlTextTest#fallbackFamilyAliasedToBundle`/`#lineSpacingPct_compactsLines` ↔ `chartsSmartArt_drawingsBecomeImages` (autofit только `normAutofit` §21.1.2.1.2/.3 с подбором кегля под перенесённый текст, высота строки из `a:lnSpc`, фолбэк-семейство темы алиасится в бандл, `phldrT` не рисуется).
- UI-тестов нет; гейт SPA — `npm run build` (tsc -b) + `npm run lint` (oxlint, `.oxlintrc.json`: rules-of-hooks error, only-export-components warn). Прод-автотесты (pytest 9.1.1 + requests 2.34.2, 21 проверка — 17 под маркером `needs_key` (SKIP без ключа), 4 открытых: health/SPA-root/swagger/spec; env-конфиг, `mise exec -- python -m pytest -q .` из `prod-autotests/`) гоняются CI после deploy против живого прода.
diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartRenderer.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartRenderer.java
index c82bfd1..ed6a11b 100644
--- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartRenderer.java
+++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartRenderer.java
@@ -164,10 +164,17 @@ final class ChartRenderer {
static final class Legend {
/** lineWidth > 0 — маркер-отрезок (линейный ряд), иначе — квадратик.
* В Word у линейных рядов в легенде короткая линия той же толщины,
- * что и сама линия; у круговых — маленький квадратик. */
- record Entry(String label, Color color, double lineWidth) {
+ * что и сама линия; у круговых — маленький квадратик.
+ * outline — полый квадратик (цветной контур, белый интерьер): у
+ * wireframe-поверхностей (§21.2.2.230 «no color on the surface»)
+ * полосы не залиты нигде, включая легенду. */
+ record Entry(String label, Color color, double lineWidth, boolean outline) {
Entry(String label, Color color) {
- this(label, color, -1);
+ this(label, color, -1, false);
+ }
+
+ Entry(String label, Color color, double lineWidth) {
+ this(label, color, lineWidth, false);
}
}
@@ -188,6 +195,11 @@ final class ChartRenderer {
BasicStroke.CAP_BUTT, BasicStroke.JOIN_MITER));
g.draw(new Line2D.Double(startX, midY, startX + lineLen, midY));
startX += lineLen + 3;
+ } else if (e.outline()) {
+ g.setStroke(new BasicStroke(1.0f));
+ g.draw(new Rectangle2D.Double(startX, midY - square / 2.0,
+ square, square));
+ startX += square + 3;
} else {
g.fill(new Rectangle2D.Double(startX, midY - square / 2.0, square, square));
startX += square + 3;
@@ -243,7 +255,8 @@ final class ChartRenderer {
? palette.get(idx % palette.size())
: spec.bandColors.get(idx % spec.bandColors.size());
legend.entries.add(new Legend.Entry(
- formatValue(b, "General") + "-" + formatValue(b + unit, "General"), c));
+ formatValue(b, "General") + "-" + formatValue(b + unit, "General"),
+ c, -1, spec.wireframe));
idx++;
}
}
diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainter.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainter.java
index fa09eda..db5bbe4 100644
--- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainter.java
+++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainter.java
@@ -3,32 +3,30 @@ package ru.pjandro.wordpdf.internal.chart;
import java.awt.BasicStroke;
import java.awt.Color;
import java.awt.Graphics2D;
-import java.awt.RenderingHints;
+import java.awt.Shape;
import java.awt.geom.Line2D;
+import java.awt.geom.Path2D;
import java.awt.geom.Rectangle2D;
import java.util.ArrayList;
import java.util.List;
/**
- * Контурная диаграмма (c:surfaceChart, ECMA-376 §21.2.2.204), два режима.
+ * Контурная диаграмма (c:surfaceChart, ECMA-376 §21.2.2.204) — оба режима
+ * «surface charts viewed from above, similar to 2-D topographic maps»
+ * (Microsoft Support): X — категории по узлам сетки, Y — ряды (серия 0
+ * внизу, подписи со стороны serAx); оси значений нет — высоты кодируют
+ * полосы высот lo + k·unit (c:bandFmts §21.2.2.13/.14, без них — палитра).
*
- * Заливочный (c:wireframe val="0"): «отображает взаимосвязь между
- * категориями и осью значений» — система координат «категория × значение»:
- * ось значений слева, категории снизу. Каждый ряд — ломаная через
- * категории; лист поверхности идёт от переднего ряда к задним, и на экране
- * виден торцом: полосы между соседними ломаными красятся контурными
- * полосами высот (c:bandFmts, §21.2.2.13 — индексация от низкого к
- * высокого; без bandFmts — палитра), передняя стенка от пола до ряда 0 —
- * полосой значения переднего края.
- *
- *
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 и рамка области построения.
+ *
Заливочный (c:wireframe val="0") — «color bands represent specific
+ * ranges of values»: области полос залиты их цветами без изолиний
+ * ({@link #fillBands}). c:wireframe (§21.2.2.230) — «shows only the lines.
+ * The lines… connect interpolated points of equal value»: изолинии на
+ * внутренних границах полос цветом полосы НИЖЕ уровня, без заливок
+ * ({@link #drawContourLines}, marching squares {@link #cellSegments}).
+ * В обоих режимах — сетка узлов catAx/serAx и рамка области построения;
+ * маркеры легенды следуют заливке полос: залитые при wireframe=false,
+ * полые при wireframe=true (§21.2.2.230 «no color on the surface»
+ * распространяется и на легенду).
*
*
Регрессия — Surface2dPainterTest, фикстура samples/chart-types.docx
* (WordPdfConverterTest#chartTypes_allTypesRenderAsImages).
@@ -53,6 +51,9 @@ final class Surface2dPainter {
/** Число пересечений ребра ячейки уровнем: два поперечных + узел — один сегмент. */
private static final int HITS_WITH_NODE = 3;
+ /** Полигон подобласти полосы: меньше трёх различных вершин — нулевая площадь. */
+ private static final int MIN_POLYGON_POINTS = 3;
+
static void paint(Graphics2D g, ChartSpec spec, Rectangle2D box, List palette) {
int nSer = spec.series.size();
int nCat = 0;
@@ -76,129 +77,30 @@ final class Surface2dPainter {
}
ChartSpec.AxisSpec valAxis = spec.valAxis != null
? spec.valAxis : new ChartSpec.AxisSpec();
- ChartSpec.AxisSpec catAxis = spec.catAxis != null
- ? spec.catAxis : new ChartSpec.AxisSpec();
double[] bounds = ChartRenderer.axisBounds(valAxis, min, max);
double lo = bounds[0];
double hi = bounds[1];
double unit = bounds[2];
int bandCount = Math.max(1, (int) Math.ceil((hi - lo) / unit - 1e-9));
List bands = spec.bandColors.isEmpty() ? palette : spec.bandColors;
-
- if (spec.wireframe) {
- paintWireframe(g, spec, z, nSer, nCat, lo, unit, bandCount, bands, box);
- return;
- }
-
- // Поля под подписи осей — та же auto-layout-эвристика, что у
- // CartesianPainter (подписи значений слева, категорий снизу).
- List cats = CartesianPainter.categoriesOf(spec, nCat);
- DrawMlText.Style valStyle = valAxis.labelStyle;
- DrawMlText.Style catStyle = catAxis.labelStyle;
- List valLabels = new ArrayList<>();
- for (double v = lo; v <= hi + unit / 2; v += unit) {
- valLabels.add(ChartRenderer.formatValue(v, valAxis.numFmt));
- }
- double catGutter = catStyle != null ? DrawMlText.textHeight(catStyle) + 6 : 6;
- double valGutter = 8;
- if (valStyle != null) {
- for (String l : valLabels) {
- valGutter = Math.max(valGutter, DrawMlText.textWidth(l, valStyle) + 8);
- }
- }
- Rectangle2D plot = new Rectangle2D.Double(
- box.getX() + valGutter, box.getY(),
- Math.max(10, box.getWidth() - valGutter),
- Math.max(10, box.getHeight() - catGutter));
-
- // Сетка по делениям оси значений — под поверхностью.
- if (valAxis.gridlines && !valAxis.deleted) {
- g.setColor(valAxis.gridColor);
- g.setStroke(new BasicStroke(0.6f));
- for (double v = lo; v <= hi + unit / 2; v += unit) {
- double y = yOf(v, lo, hi, plot);
- g.draw(new Line2D.Double(plot.getX(), y,
- plot.getX() + plot.getWidth(), y));
- }
- }
-
- drawContour(g, z, nSer, nCat, lo, hi, unit, bandCount, bands, plot);
-
- // Оси поверх: линия категории и подписи.
- if (catAxis.axisLineColor != null && !catAxis.deleted) {
- g.setColor(catAxis.axisLineColor);
- g.setStroke(new BasicStroke((float) Math.max(0.5, catAxis.axisLineWidth)));
- double y = plot.getY() + plot.getHeight();
- g.draw(new Line2D.Double(plot.getX(), y,
- plot.getX() + plot.getWidth(), y));
- }
- drawCategoryLabels(g, cats, plot, catStyle);
- drawValueLabels(g, valLabels, plot, valStyle, lo, hi);
+ // Оба режима — вид сверху (§21.2.2.204 «viewed from above»); valAxis
+ // задаёт lo/unit/bandCount полос высот и больше нигде не рисуется.
+ paintTopView(g, spec, z, nSer, nCat, lo, unit, bandCount, bands, box,
+ !spec.wireframe);
}
- /**
- * Контурная заливка: по вертикальным срезам листа. На срезе x лист
- * занимает вертикальные промежутки между соседними ломаными (ряд r и
- * r+1) плюс переднюю стенку [пол, ряд 0]; промежуток режется по
- * границам полос высот, каждая часть красится своей полосой.
- */
- private static void drawContour(Graphics2D g, double[][] z, int nSer, int nCat,
- double lo, double hi, double unit, int bandCount,
- List bands, Rectangle2D plot) {
- double step = Math.max(0.4, plot.getWidth() / 400.0);
- // Без сглаживания: соседние колонки-заливки иначе дают полупрозрачные
- // стыки-«полоски» (границы полос меняются от колонки к колонке).
- Object oldAA = g.getRenderingHint(RenderingHints.KEY_ANTIALIASING);
- g.setRenderingHint(RenderingHints.KEY_ANTIALIASING,
- RenderingHints.VALUE_ANTIALIAS_OFF);
- for (double x = plot.getX(); x < plot.getX() + plot.getWidth(); x += step) {
- double w = Math.min(step + 0.6, plot.getX() + plot.getWidth() - x + 0.6);
- double[] h = new double[nSer];
- for (int r = 0; r < nSer; r++) {
- h[r] = interp(z[r], x, plot, nCat);
- }
- // Задние полосы — первыми, передняя стенка перекрывает всё снизу.
- for (int r = nSer - 2; r >= 0; r--) {
- double v0 = Math.min(h[r], h[r + 1]);
- double v1 = Math.max(h[r], h[r + 1]);
- int k0 = Math.max(0, Math.min(bandCount - 1, (int) Math.floor((v0 - lo) / unit)));
- int k1 = Math.max(0, Math.min(bandCount - 1, (int) Math.floor((v1 - lo) / unit)));
- for (int k = k0; k <= k1; k++) {
- double segLo = Math.max(v0, lo + k * unit);
- double segHi = Math.min(v1, lo + (k + 1) * unit);
- if (segHi - segLo <= MIN_SEGMENT) {
- continue;
- }
- g.setColor(bands.get(k % bands.size()));
- double yTop = yOf(segHi, lo, hi, plot);
- g.fill(new Rectangle2D.Double(x, yTop, w,
- yOf(segLo, lo, hi, plot) - yTop));
- }
- }
- double front = h[0];
- if (front > lo) {
- int k = Math.max(0, Math.min(bandCount - 1,
- (int) Math.floor((front - lo) / unit)));
- g.setColor(bands.get(k % bands.size()));
- double yTop = yOf(front, lo, hi, plot);
- g.fill(new Rectangle2D.Double(x, yTop, w,
- plot.getY() + plot.getHeight() - yTop));
- }
- }
- g.setRenderingHint(RenderingHints.KEY_ANTIALIASING, oldAA);
- }
/**
- * c:wireframe (§21.2.2.230) — вид сверху, как Word: X — категории,
- * Y — ряды (серия 0 внизу); рисуются только изолинии, сетка узлов
- * catAx/serAx и рамка области построения — заливок и оси значений нет
- * (значения кодируют изолинии и легенда полос). Word пишет serAx
- * axPos="r" для поверхностей; иное положение serAx — подписи слева.
+ * Вид сверху (§21.2.2.204 «viewed from above»): X — категории по узлам,
+ * Y — ряды (серия 0 внизу); filled — заливка полос высот, иначе —
+ * изолинии без заливок (c:wireframe, §21.2.2.230). Оси значений нет;
+ * Word пишет serAx axPos="r" для поверхностей; иное положение serAx —
+ * подписи слева.
*/
- private static void paintWireframe(Graphics2D g, ChartSpec spec, double[][] z,
- int nSer, int nCat, double lo, double unit,
- int bandCount, List bands,
- Rectangle2D box) {
+ private static void paintTopView(Graphics2D g, ChartSpec spec, double[][] z,
+ int nSer, int nCat, double lo, double unit,
+ int bandCount, List bands,
+ Rectangle2D box, boolean filled) {
ChartSpec.AxisSpec serAxis = spec.serAxis != null
? spec.serAxis : new ChartSpec.AxisSpec();
ChartSpec.AxisSpec catAxis = spec.catAxis != null
@@ -212,7 +114,7 @@ final class Surface2dPainter {
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;
@@ -227,7 +129,7 @@ final class Surface2dPainter {
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));
@@ -247,9 +149,15 @@ final class Surface2dPainter {
}
}
- // Изолинии — с антиалиасингом (в отличие от заливки filled-ветки).
- g.setStroke(new BasicStroke(0.75f));
- drawContourLines(g, z, nSer, nCat, lo, unit, bandCount, bands, plot);
+ // Контент: заливка полос (filled) или изолинии (wireframe) — обе с
+ // антиалиасингом; полигоны соседних ячеек стыкуются по общим вершинам,
+ // швы субпиксельные на 300 dpi.
+ if (filled) {
+ fillBands(g, z, nSer, nCat, lo, unit, bandCount, bands, plot);
+ } else {
+ g.setStroke(new BasicStroke(0.75f));
+ drawContourLines(g, z, nSer, nCat, lo, unit, bandCount, bands, plot);
+ }
// Рамка области построения — это рамка области, а не ось.
if (catAxis.axisLineColor != null) {
@@ -258,7 +166,7 @@ final class Surface2dPainter {
g.draw(plot);
}
- // Подписи категорий — по ЦЕНТРАМ узлов сетки (не слотов, как в filled).
+ // Подписи категорий — по ЦЕНТРАМ узлов сетки.
if (catAxis.labelStyle != null) {
DrawMlText.Style style = catAxis.labelStyle;
double h = DrawMlText.textHeight(style) + 2;
@@ -301,6 +209,152 @@ final class Surface2dPainter {
}
}
+ /**
+ * Заливка полос высот в виде сверху: каждая ячейка сетки режется по
+ * границам lo + k·unit — полигон подобласти k-й полосы строится обходом
+ * периметра A→B→C→D→A (конвенция {@link #cellSegments}: «узел точно на
+ * уровне = полоса выше», {@link #bandOf}); ячейка целиком в одной полосе
+ * — сплошной прямоугольник (билинейная функция достигает min/max на
+ * углах, так что interior тоже в этой полосе). Подобласти одной полосы
+ * со всех ячеек накапливаются в ОДИН путь и заливаются за проход:
+ * раздельные fill соседних ячеек покрывают каждый половину пограничного
+ * пикселя и композитятся в светлую AA-«полоску» на общем ребре
+ * (замер 75% цвета на узловой колонке); в едином пути общее ребро —
+ * interior, шва нет.
+ */
+ private static void fillBands(Graphics2D g, double[][] z, int nSer, int nCat,
+ double lo, double unit, int bandCount,
+ List bands, Rectangle2D plot) {
+ Path2D.Double[] paths = new Path2D.Double[bandCount];
+ 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);
+ double[] zv = {z[r][c], z[r][c + 1], z[r + 1][c + 1], z[r + 1][c]};
+ double[] xs = {x0, x1, x1, x0};
+ double[] ys = {y0, y0, y1, y1};
+ int[] band = new int[4];
+ int kMin = bandCount - 1;
+ int kMax = 0;
+ for (int i = 0; i < 4; i++) {
+ band[i] = bandOf(zv[i], lo, unit, bandCount);
+ kMin = Math.min(kMin, band[i]);
+ kMax = Math.max(kMax, band[i]);
+ }
+ if (kMin == kMax) {
+ appendSubpath(paths, kMin, new Rectangle2D.Double(x0,
+ Math.min(y0, y1), x1 - x0, Math.abs(y1 - y0)));
+ continue;
+ }
+ for (int k = kMin; k <= kMax; k++) {
+ Path2D.Double poly = bandPolygon(zv, xs, ys, band, k, lo, unit);
+ if (poly != null) {
+ appendSubpath(paths, k, poly);
+ }
+ }
+ }
+ }
+ for (int k = 0; k < bandCount; k++) {
+ if (paths[k] != null) {
+ g.setColor(bands.get(k % bands.size()));
+ g.fill(paths[k]);
+ }
+ }
+ }
+
+ /** Подпуть области ячейки в путь полосы k (создаётся при первом добавлении). */
+ private static void appendSubpath(Path2D.Double[] paths, int k, Shape sub) {
+ if (paths[k] == null) {
+ paths[k] = new Path2D.Double();
+ }
+ paths[k].append(sub, false);
+ }
+
+ /**
+ * Полигон подобласти полосы k в ячейке: обход периметра A→B→C→D→A —
+ * углы с bandOf == k и пересечения рёбер с уровнями lo + k·unit и
+ * lo + (k+1)·unit в порядке возрастания t вдоль ребра; совпанные
+ * вершины (пересечение точно в узле) пропускаются. null — вырожденный
+ * полигон: площадь нулевая (узел/ребро целиком на границе полосы).
+ */
+ private static Path2D.Double bandPolygon(double[] z, double[] xs, double[] ys,
+ int[] band, int k, double lo,
+ double unit) {
+ double lLo = lo + k * unit;
+ double lHi = lo + (k + 1) * unit;
+ List pts = new ArrayList<>();
+ for (int i = 0; i < 4; i++) {
+ int j = (i + 1) % 4;
+ if (band[i] == k) {
+ addPoint(pts, xs[i], ys[i]);
+ }
+ double tLo = crossingT(z[i], z[j], lLo);
+ double tHi = crossingT(z[i], z[j], lHi);
+ double first = Math.min(tLo, tHi);
+ double second = Math.max(tLo, tHi);
+ if (first >= 0) {
+ addPoint(pts, xs[i] + (xs[j] - xs[i]) * first,
+ ys[i] + (ys[j] - ys[i]) * first);
+ }
+ if (second >= 0) {
+ addPoint(pts, xs[i] + (xs[j] - xs[i]) * second,
+ ys[i] + (ys[j] - ys[i]) * second);
+ }
+ }
+ while (pts.size() > 1) {
+ double[] first = pts.get(0);
+ double[] last = pts.get(pts.size() - 1);
+ if (first[0] != last[0] || first[1] != last[1]) {
+ break;
+ }
+ pts.remove(pts.size() - 1);
+ }
+ if (pts.size() < MIN_POLYGON_POINTS) {
+ return null;
+ }
+ Path2D.Double poly = new Path2D.Double();
+ poly.moveTo(pts.get(0)[0], pts.get(0)[1]);
+ for (int i = 1; i < pts.size(); i++) {
+ poly.lineTo(pts.get(i)[0], pts.get(i)[1]);
+ }
+ poly.closePath();
+ return poly;
+ }
+
+ /**
+ * Полоса высоты значения: узел точно на уровне lo + k·unit принадлежит
+ * полосе ВЫШЕ (k) — конвенция «on level = внутри» из {@link #cellSegments}.
+ */
+ private static int bandOf(double v, double lo, double unit, int bandCount) {
+ int k = (int) Math.floor((v - lo) / unit);
+ return Math.max(0, Math.min(bandCount - 1, k));
+ }
+
+ /**
+ * Параметр пересечения ребра zi→zj уровнем L в [0, 1] или -1: ребро
+ * пересекает уровень, если min(zi, zj) < L <= max(zi, zj) — конец ребра
+ * точно на уровне считается пересечением (полоса выше включает его).
+ */
+ private static double crossingT(double zi, double zj, double level) {
+ if (Math.min(zi, zj) >= level || Math.max(zi, zj) < level) {
+ return -1;
+ }
+ return (level - zi) / (zj - zi);
+ }
+
+ /** Вершина полигона; совпавшая с предыдущей (пересечение в узле) — пропускается. */
+ private static void addPoint(List pts, double x, double y) {
+ if (!pts.isEmpty()) {
+ double[] last = pts.get(pts.size() - 1);
+ if (last[0] == x && last[1] == y) {
+ return;
+ }
+ }
+ pts.add(new double[] {x, y});
+ }
+
/**
* Изолинии: «the lines… connect interpolated points of equal value» —
* на каждой внутренней границе полос высот lo + k·unit (k = 1..bandCount−1)
@@ -464,68 +518,10 @@ final class Surface2dPainter {
return plot.getY() + plot.getHeight() * (1 - (double) r / (nSer - 1));
}
- /** Высота листа на срезе x: линейная интерполяция ломаной ряда. */
- private static double interp(double[] row, double x, Rectangle2D plot, int nCat) {
- double t = (x - plot.getX()) / plot.getWidth() * (nCat - 1);
- int c = (int) Math.floor(t);
- if (c < 0) {
- return row[0];
- }
- if (c >= nCat - 1) {
- return row[nCat - 1];
- }
- double f = t - c;
- return row[c] + (row[c + 1] - row[c]) * f;
- }
private static double xOf(int c, Rectangle2D plot, int nCat) {
return plot.getX() + plot.getWidth() * c / (nCat - 1);
}
- private static double yOf(double v, double lo, double hi, Rectangle2D plot) {
- return plot.getY() + (1 - (v - lo) / (hi - lo)) * plot.getHeight();
- }
- private static void drawCategoryLabels(Graphics2D g, List cats,
- Rectangle2D plot, DrawMlText.Style style) {
- if (style == null || cats.isEmpty()) {
- return;
- }
- int n = cats.size();
- double h = DrawMlText.textHeight(style) + 2;
- double slot = plot.getWidth() / n;
- for (int i = 0; i < n; i++) {
- String label = cats.get(i);
- if (label.isEmpty()) {
- continue;
- }
- double cx = plot.getX() + plot.getWidth() * (i + 0.5) / n;
- 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(cx - w / 2, plot.getY() + plot.getHeight() + 3,
- w, h),
- "ctr", "t", 1.0);
- }
- }
-
- private static void drawValueLabels(Graphics2D g, List labels,
- Rectangle2D plot, DrawMlText.Style style,
- double lo, double hi) {
- if (style == null) {
- return;
- }
- double h = DrawMlText.textHeight(style) + 2;
- for (int i = 0; i < labels.size(); i++) {
- double v = lo + (hi - lo) * i / Math.max(1, labels.size() - 1);
- double y = yOf(v, lo, hi, plot);
- DrawMlText.paint(g,
- List.of(new DrawMlText.Paragraph(labels.get(i), style, "r")),
- new Rectangle2D.Double(plot.getX() - 6, y - h / 2,
- Math.max(10, DrawMlText.textWidth(labels.get(i), style)), h),
- "r", "ctr", 1.0);
- }
- }
}
diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartRendererTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartRendererTest.java
index 84935d4..95ba113 100644
--- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartRendererTest.java
+++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartRendererTest.java
@@ -15,6 +15,15 @@ import static org.junit.jupiter.api.Assertions.*;
*/
class ChartRendererTest {
+ /**
+ * Полый маркер: в средней колонке — верхняя и нижняя рамки контура
+ * 1pt ≈ 4px @300dpi + AA-ряды (замер ~5), прогон не больше порога.
+ */
+ private static final int HOLLOW_MAX_RUN = 8;
+
+ /** Залитый маркер: квадрат 0,55·9pt ≈ 21px @300dpi, прогон не меньше. */
+ private static final int FILLED_MIN_RUN = 15;
+
/**
* Одна и та же LINE-спека с legendOverlay=false/true: легенда видима
* в обеих (нижняя полоса), но у overlay кривая опускается ниже —
@@ -361,6 +370,37 @@ class ChartRendererTest {
"surface с данными и полосами должен рисоваться");
}
+ /**
+ * c:wireframe (§21.2.2.230) — «no color on the surface» распространяется
+ * и на легенду: маркеры полос полые (цветной контур, белый интерьер) —
+ * в средней колонке маркера только верхняя и нижняя рамки. Контраст —
+ * та же спека с wireframe=false: маркер залит на всю высоту квадратика.
+ * Регрессия — ChartRendererTest#wireframeSurfaceLegend_hollowMarkers.
+ */
+ @Test
+ void wireframeSurfaceLegend_hollowMarkers() {
+ ChartSpec spec = surfaceLegendSpec(true);
+ BufferedImage hollow = ChartRenderer.render(spec, 219.23, 149.08,
+ new DrawMlColor(null));
+ int[] box = firstAccent1Box(hollow);
+ int cx = (box[0] + box[2]) / 2;
+ int cy = (box[1] + box[3]) / 2;
+ assertTrue(isWhite(hollow.getRGB(cx, cy)),
+ "интерьер wireframe-маркера не белый: " + Integer.toHexString(hollow.getRGB(cx, cy)));
+ int run = maxVerticalAccent1Run(hollow, cx);
+ assertTrue(run <= HOLLOW_MAX_RUN,
+ "wireframe-маркер легенды залит: вертикальный прогон=" + run);
+
+ spec.wireframe = false;
+ BufferedImage filled = ChartRenderer.render(spec, 219.23, 149.08,
+ new DrawMlColor(null));
+ int[] fbox = firstAccent1Box(filled);
+ int fcx = (fbox[0] + fbox[2]) / 2;
+ int filledRun = maxVerticalAccent1Run(filled, fcx);
+ assertTrue(filledRun >= FILLED_MIN_RUN,
+ "заливочный маркер легенды не залит: вертикальный прогон=" + filledRun);
+ }
+
/** BAR: легенда без имени ряда — квадратик; без рядов — легенды нет. */
@Test
void barLegendDefaultSquareAndNameless() {
@@ -563,4 +603,75 @@ class ChartRendererTest {
&& Math.abs(((rgb >> 8) & 0xFF) - 114) < 30
&& Math.abs((rgb & 0xFF) - 196) < 30;
}
+
+ /**
+ * SURFACE 2 ряда × 2 категории, c:majorUnit=1 → полосы 0-1/1-2, легенда
+ * «0-1» (accent1) «1-2» (accent2); данные 1.2/1.8 — выше первой границы
+ * полос, поэтому область построения не рисует ни изолиний, ни accent1.
+ */
+ private static ChartSpec surfaceLegendSpec(boolean wireframe) {
+ ChartSpec spec = new ChartSpec();
+ spec.type = ChartSpec.Type.SURFACE;
+ spec.wireframe = wireframe;
+ spec.legendPos = "b";
+ spec.valAxis = new ChartSpec.AxisSpec();
+ spec.valAxis.majorUnit = 1.0;
+ ChartSpec.Series bottom = new ChartSpec.Series();
+ bottom.values.add(1.2);
+ bottom.values.add(1.2);
+ ChartSpec.Series top = new ChartSpec.Series();
+ top.values.add(1.8);
+ top.values.add(1.8);
+ spec.series.add(bottom);
+ spec.series.add(top);
+ return spec;
+ }
+
+ /** Bounding box пикселей accent1 (первый маркер легенды): {minX, minY, maxX, maxY}. */
+ private static int[] firstAccent1Box(BufferedImage img) {
+ int minX = Integer.MAX_VALUE;
+ int minY = Integer.MAX_VALUE;
+ int maxX = -1;
+ int maxY = -1;
+ for (int y = 0; y < img.getHeight(); y++) {
+ for (int x = 0; x < img.getWidth(); x++) {
+ if (isAccent1(img.getRGB(x, y))) {
+ minX = Math.min(minX, x);
+ minY = Math.min(minY, y);
+ maxX = Math.max(maxX, x);
+ maxY = Math.max(maxY, y);
+ }
+ }
+ }
+ assertTrue(maxX >= 0, "маркер легенды accent1 не найден");
+ return new int[] {minX, minY, maxX, maxY};
+ }
+
+ /** Максимальный вертикальный прогон accent1 в колонке x. */
+ private static int maxVerticalAccent1Run(BufferedImage img, int x) {
+ int best = 0;
+ int run = 0;
+ for (int y = 0; y < img.getHeight(); y++) {
+ if (isAccent1(img.getRGB(x, y))) {
+ run++;
+ best = Math.max(best, run);
+ } else {
+ run = 0;
+ }
+ }
+ return best;
+ }
+
+ /** Пиксель — цвет accent1 (0x4472C4) с запасом на AA-края. */
+ private static boolean isAccent1(int rgb) {
+ return Math.abs(((rgb >> 16) & 0xFF) - 0x44) <= 24
+ && Math.abs(((rgb >> 8) & 0xFF) - 0x72) <= 24
+ && Math.abs((rgb & 0xFF) - 0xC4) <= 24;
+ }
+
+ /** Пиксель — белый фон. */
+ private static boolean isWhite(int rgb) {
+ return ((rgb >> 16) & 0xFF) >= 0xF0 && ((rgb >> 8) & 0xFF) >= 0xF0
+ && (rgb & 0xFF) >= 0xF0;
+ }
}
diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainterTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainterTest.java
index d3c2a63..16a7cf4 100644
--- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainterTest.java
+++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/Surface2dPainterTest.java
@@ -10,14 +10,14 @@ import java.util.List;
import static org.junit.jupiter.api.Assertions.*;
/**
- * Контурная диаграмма (ECMA-376 §21.2.2.204). Заливочный режим: лист между
- * ломаными соседних рядов режется контурными полосами высот (c:bandFmts,
- * §21.2.2.13 — от низкого к высокого; без них — палитра). c:wireframe
- * (§21.2.2.230) — вид сверху, как Word: X — категории, Y — ряды (серия 0
- * внизу), без заливок и оси значений; рисуются изолинии на внутренних
- * границах полос высот lo + k·unit цветом полосы НИЖЕ уровня (marching
- * squares, седло — по среднему ячейки), сетка узлов catAx/serAx и рамка
- * области построения. Регрессия — Surface2dPainterTest, фикстура
+ * Контурная диаграмма (ECMA-376 §21.2.2.204) — оба режима вид сверху
+ * («viewed from above», Microsoft Support): X — категории по узлам сетки,
+ * Y — ряды (серия 0 внизу), оси значений нет. Заливочный
+ * (c:wireframe val="0") — области полос высот lo + k·unit залиты их
+ * цветами (c:bandFmts §21.2.2.13/.14, без них — палитра), без изолиний.
+ * c:wireframe (§21.2.2.230) — изолинии на внутренних границах полос
+ * цветом полосы НИЖЕ уровня (marching squares, седло — по среднему
+ * ячейки), без заливок. Регрессия — Surface2dPainterTest, фикстура
* samples/chart-types.docx (WordPdfConverterTest#chartTypes_allTypesRenderAsImages).
*/
class Surface2dPainterTest {
@@ -27,36 +27,22 @@ class Surface2dPainterTest {
private static final Color ACCENT3 = new Color(0xA5A5A5);
private static final Color ACCENT4 = new Color(0xFFC000);
+ /** Порог «тёмный» пикселя по каждому каналу (текст подписей 0x595959). */
+ private static final int DARK_MAX = 0x80;
+
/** Масштаб растра: 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).
+ * Геометрия render(): box = (4, 4, 211.23, 141.08) pt; без подписей
+ * осей 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 делится на
- * четыре горизонтальные полосы высот: снизу вверх accent1 (0-1),
- * accent2 (1-2), accent3 (2-3), accent4 (3-4).
- */
- @Test
- void contourStripes_areValueBandsBottomUp() {
- BufferedImage img = render(surfaceSpec(false));
- assertTrue(matches(px(img, 400, 507), ACCENT1),
- "полоса 0-1 не accent1: " + hex(px(img, 400, 507)));
- assertTrue(matches(px(img, 400, 368), ACCENT2),
- "полоса 1-2 не accent2: " + hex(px(img, 400, 368)));
- assertTrue(matches(px(img, 400, 227), ACCENT3),
- "полоса 2-3 не accent3: " + hex(px(img, 400, 227)));
- assertTrue(matches(px(img, 400, 87), ACCENT4),
- "полоса 3-4 не accent4: " + hex(px(img, 400, 87)));
- }
-
/**
* Вид сверху, z[r][c] = c: lo=0, hi=4, unit=1 → изолинии уровней 1, 2, 3 —
* вертикали точно в узлах xOf(1..3) цветами полос НИЖЕ уровня
@@ -221,11 +207,94 @@ class Surface2dPainterTest {
"ниже уровня изолинии быть не должно");
}
+ /**
+ * Заливка, вид сверху: z[r][c] = r, 4 ряда × 3 категории — lo=0, hi=3,
+ * unit=1 → полосы 0-1/1-2/2-3 заливают межрядные ячейки
+ * (accent1/2/3); серия 0 внизу (центр ячейки ряда 0 ниже центра
+ * ячейки ряда 2 на экране).
+ */
+ @Test
+ void filledContour_flatRows_bandsFillRowsTopView() {
+ double[][] z = {
+ {0, 0, 0},
+ {1, 1, 1},
+ {2, 2, 2},
+ {3, 3, 3},
+ };
+ BufferedImage img = render(surfaceSpec(z, false));
+ int x = (int) Math.round((xPt(0, 3) + xPt(1, 3)) / 2 * PX);
+ int yCell0 = (yPx(0, 4) + yPx(1, 4)) / 2;
+ int yCell1 = (yPx(1, 4) + yPx(2, 4)) / 2;
+ int yCell2 = (yPx(2, 4) + yPx(3, 4)) / 2;
+ assertTrue(yCell0 > yCell2,
+ "серия 0 должна быть внизу: yCell0=" + yCell0 + ", yCell2=" + yCell2);
+ assertTrue(matches(px(img, x, yCell0), ACCENT1),
+ "полоса 0-1 не accent1: " + hex(px(img, x, yCell0)));
+ assertTrue(matches(px(img, x, yCell1), ACCENT2),
+ "полоса 1-2 не accent2: " + hex(px(img, x, yCell1)));
+ assertTrue(matches(px(img, x, yCell2), ACCENT3),
+ "полоса 2-3 не accent3: " + hex(px(img, x, yCell2)));
+ }
+
+ /**
+ * «Холм» 3×3 (углы z=0, середины рёбер z=2, центр z=4): lo=0, hi=4,
+ * unit=1 → в ячейке (0..1, 0..1) биллинейно z = 2x̂+2ŷ, точки диагонали
+ * от угла (0,0) к центру при t=0.15/0.35/0.65/0.85 (z=0.6/1.4/2.6/3.4)
+ * залиты цветами полос 0-1…3-4.
+ */
+ @Test
+ void filledContour_hillCell_bandsNestedDiagonal() {
+ double[][] z = {
+ {0, 2, 0},
+ {2, 4, 2},
+ {0, 2, 0},
+ };
+ BufferedImage img = render(surfaceSpec(z, false));
+ double[] ts = {0.15, 0.35, 0.65, 0.85};
+ Color[] want = {ACCENT1, ACCENT2, ACCENT3, ACCENT4};
+ for (int i = 0; i < ts.length; i++) {
+ double t = ts[i];
+ double x = xPt(0, 3) + (xPt(1, 3) - xPt(0, 3)) * t;
+ double y = yPt(0, 3) + (yPt(1, 3) - yPt(0, 3)) * t;
+ int xp = (int) Math.round(x * PX);
+ int yp = (int) Math.round(y * PX);
+ assertTrue(matches(px(img, xp, yp), want[i]),
+ "точка диагонали t=" + t + " не " + want[i] + ": " + hex(px(img, xp, yp)));
+ }
+ }
+
+ /**
+ * Оси значений в виде сверху нет: слева от plot (x < plotX−1) в
+ * вертикальной полосе области построения нет тёмных пикселей — ни в
+ * заливочном, ни в wireframe-режиме.
+ */
+ @Test
+ void filledContour_noValueAxisLabels() {
+ double[][] z = {
+ {0, 0, 0},
+ {1, 1, 1},
+ {2, 2, 2},
+ {3, 3, 3},
+ };
+ int xLimit = (int) Math.round((PLOT_X - 1) * PX);
+ int yTop = (int) Math.round(PLOT_Y * PX);
+ int yBottom = (int) Math.round((PLOT_Y + PLOT_H) * PX);
+ assertFalse(hasDarkLeftOf(render(surfaceSpec(z, false)), xLimit, yTop, yBottom),
+ "слева от plot подписи оси значений (заливка)");
+ assertFalse(hasDarkLeftOf(render(surfaceSpec(z, true)), xLimit, yTop, yBottom),
+ "слева от plot подписи оси значений (wireframe)");
+ }
+
/** Спека wireframe-поверхности без подписей осей (серии из z, категории пустые). */
private static ChartSpec wireframeSpec(double[][] z) {
+ return surfaceSpec(z, true);
+ }
+
+ /** Спека поверхности без подписей осей (серии из z, категории пустые), режим по флагу. */
+ private static ChartSpec surfaceSpec(double[][] z, boolean wireframe) {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.SURFACE;
- spec.wireframe = true;
+ spec.wireframe = wireframe;
spec.legendPos = null;
spec.valAxis = new ChartSpec.AxisSpec();
for (double[] row : z) {
@@ -248,8 +317,12 @@ class Surface2dPainterTest {
}
/** Пиксельная координата узла ряда: serY(r) = 4 + 135.08·(1 − r/(nSer−1)), серия 0 внизу. */
+ private static double yPt(double r, int nSer) {
+ return PLOT_Y + PLOT_H * (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);
+ return (int) Math.round(yPt(r, nSer) * PX);
}
private static boolean hasSegment(List segs,
@@ -270,23 +343,6 @@ class Surface2dPainterTest {
return Math.abs(a - b) < 1e-9;
}
- private static ChartSpec surfaceSpec(boolean wireframe) {
- ChartSpec spec = new ChartSpec();
- spec.type = ChartSpec.Type.SURFACE;
- spec.wireframe = wireframe;
- spec.legendPos = null;
- spec.valAxis = new ChartSpec.AxisSpec();
- double[] rows = {0, 2, 4};
- for (double row : rows) {
- ChartSpec.Series s = new ChartSpec.Series();
- for (int c = 0; c < 3; c++) {
- s.values.add(row);
- }
- spec.series.add(s);
- }
- return spec;
- }
-
private static BufferedImage render(ChartSpec spec) {
return ChartRenderer.render(spec, 219.23, 149.08, new DrawMlColor(null));
}
@@ -306,6 +362,21 @@ class Surface2dPainterTest {
|| matches(rgb, ACCENT3) || matches(rgb, ACCENT4);
}
+ /** Есть ли тёмный пиксель в полосе x < xLimit, yTop..yBottom. */
+ private static boolean hasDarkLeftOf(BufferedImage img, int xLimit,
+ int yTop, int yBottom) {
+ for (int y = yTop; y <= yBottom && y < img.getHeight(); y++) {
+ for (int x = 0; x < xLimit; x++) {
+ int rgb = img.getRGB(x, y);
+ if (((rgb >> 16) & 0xFF) < DARK_MAX && ((rgb >> 8) & 0xFF) < DARK_MAX
+ && (rgb & 0xFF) < DARK_MAX) {
+ return true;
+ }
+ }
+ }
+ return false;
+ }
+
private static String hex(int rgb) {
return String.format("#%06X", rgb & 0xFFFFFF);
}