Вывод: guard составного рана, AREA к базовой линии, вложенные раны текстбоксов, overlay-легенда

This commit is contained in:
Pjandro
2026-10-24 21:38:33 +00:00
parent 41fe926ba0
commit 50447aa9d0
10 changed files with 346 additions and 27 deletions
@@ -122,9 +122,11 @@ public final class GlyphCoverageNormalizer {
}
/**
* Проходит невложенные блоки {@code <w:r>} ... {@code </w:r>} и заменяет
* каждый через {@link #rewriteBlock}. Приём тот же, что в
* {@link SymbolFontNormalizer}: полные раны не вложены друг в друга.
* Проходит блоки {@code <w:r>} ... {@code </w:r>} и заменяет каждый через
* {@link #rewriteBlock}. Вложенные раны текстбоксов (w:r → w:drawing →
* txbxContent → w:r) переписываются рекурсивно по телу внешнего блока —
* каркас внешнего рана остаётся нетронутым. Приём общий с
* {@link SymbolFontNormalizer}.
*/
private static String rewriteBlocks(String xml, String tag) {
String open = "<" + tag;
@@ -141,6 +143,15 @@ public final class GlyphCoverageNormalizer {
if (openEnd < 0 || end < 0) {
break;
}
int matching = matchingClose(xml, open, close, openEnd);
if (matching > end) {
// Внешний ран с вложенным: тело — рекурсивно, каркас внешнего не трогаем.
sb.append(xml, pos, start).append(xml, start, openEnd + 1)
.append(rewriteBlocks(xml.substring(openEnd + 1, matching), tag))
.append(close);
pos = matching + close.length();
continue;
}
end += close.length();
sb.append(xml, pos, start).append(rewriteBlock(xml.substring(start, end)));
pos = end;
@@ -169,6 +180,30 @@ public final class GlyphCoverageNormalizer {
return -1;
}
/** Позиция закрывающего тега, балансирующего открывающий тег на openEnd; -1 — не сбалансирован. */
private static int matchingClose(String xml, String open, String close, int openEnd) {
int depth = 1;
int i = openEnd;
while (i < xml.length()) {
int nextOpen = indexOfOpenTag(xml, open, i);
int nextClose = xml.indexOf(close, i);
if (nextClose < 0) {
return -1;
}
if (nextOpen >= 0 && nextOpen < nextClose) {
depth++;
i = nextOpen + open.length();
} else {
depth--;
if (depth == 0) {
return nextClose;
}
i = nextClose + close.length();
}
}
return -1;
}
/**
* Разрезает один {@code w:r}: части текста без глифа в шрифте ранa
* получают собственное {@code w:rFonts}.
@@ -200,6 +235,13 @@ public final class GlyphCoverageNormalizer {
// Составной ран (w:tab, w:drawing, несколько w:t) не трогаем.
return block;
}
if (text.group(2).contains("</w:t>")) {
// matches() с ленивой (.*?) поглощает разметку между w:t (напр.
// lastRenderedPageBreak) — в сырой текст w:t литеральный </w:t> не
// попадает (XML-экранирование), значит это составной ран.
// Регрессия — GlyphCoverageNormalizerTest#multipleTextNodes_runLeftUntouched.
return block;
}
String decoded = decode(text.group(2));
List<Segment> segments = split(decoded, runFamily);
if (segments.isEmpty()) {
@@ -116,8 +116,11 @@ public final class SymbolFontNormalizer {
}
/**
* Проходит невложенные блоки {@code <tag ...>} ... {@code </tag>} и
* заменяет каждый через {@link #rewriteBlock}.
* Проходит блоки {@code <tag ...>} ... {@code </tag>} и заменяет каждый через
* {@link #rewriteBlock}. Вложенные раны текстбоксов (w:r → w:drawing →
* txbxContent → w:r) переписываются рекурсивно по телу внешнего блока —
* каркас внешнего рана остаётся нетронутым (тот же приём, что в
* {@link GlyphCoverageNormalizer}).
*/
private static String rewriteBlocks(String xml, String tag) {
String open = "<" + tag;
@@ -134,6 +137,15 @@ public final class SymbolFontNormalizer {
if (openEnd < 0 || end < 0) {
break;
}
int matching = matchingClose(xml, open, close, openEnd);
if (matching > end) {
// Внешний ран с вложенным: тело — рекурсивно, каркас внешнего не трогаем.
sb.append(xml, pos, start).append(xml, start, openEnd + 1)
.append(rewriteBlocks(xml.substring(openEnd + 1, matching), tag))
.append(close);
pos = matching + close.length();
continue;
}
end += close.length();
String block = xml.substring(start, end);
sb.append(xml, pos, start).append(rewriteBlock(block));
@@ -174,6 +186,30 @@ public final class SymbolFontNormalizer {
return -1;
}
/** Позиция закрывающего тега, балансирующего открывающий тег на openEnd; -1 — не сбалансирован. */
private static int matchingClose(String xml, String open, String close, int openEnd) {
int depth = 1;
int i = openEnd;
while (i < xml.length()) {
int nextOpen = indexOfOpenTag(xml, open, i);
int nextClose = xml.indexOf(close, i);
if (nextClose < 0) {
return -1;
}
if (nextOpen >= 0 && nextOpen < nextClose) {
depth++;
i = nextOpen + open.length();
} else {
depth--;
if (depth == 0) {
return nextClose;
}
i = nextClose + close.length();
}
}
return -1;
}
/** Переписывает один блок {@code w:lvl} или {@code w:r}. */
private static String rewriteBlock(String block) {
String symbolFont = symbolFontOf(block);
@@ -284,10 +284,14 @@ final class CartesianPainter {
p.lineTo(toX(along.get(i), cross.get(i), horizontal),
toY(along.get(i), cross.get(i), horizontal));
}
p.lineTo(toX(along.get(along.size() - 1), cross.get(cross.size() - 1), horizontal),
toY(along.get(along.size() - 1), cross.get(cross.size() - 1), horizontal));
p.lineTo(toX(along.get(0), cross.get(0), horizontal),
toY(along.get(0), cross.get(0), horizontal));
// Word заполняет область между кривой и осью категорий (ECMA-376
// §21.2.2.5 c:areaChart), а не хордой последняя→первая: замыкаем
// путь по базовой линии (значение lo).
// Регрессия — CartesianPainterTest#areaFill_closesToBaseline.
double base = valuePos(lo, lo, hi, plot, horizontal);
p.lineTo(toX(along.get(along.size() - 1), base, horizontal),
toY(along.get(along.size() - 1), base, horizontal));
p.lineTo(toX(along.get(0), base, horizontal), toY(along.get(0), base, horizontal));
p.closePath();
g.setColor(DrawMlColor.withAlpha(c, 0.55));
g.fill(p);
@@ -78,13 +78,16 @@ final class ChartRenderer {
box.getWidth(), box.getHeight() - titleH);
Legend legend = measureLegend(spec, palette);
double legendH = legend == null ? 0 : legend.height;
if (legend != null && "b".equals(spec.legendPos)) {
// c:overlay (ECMA-376 §21.2.2.132): легенда не резервирует место и
// дорисовывается поверх после художника. Регрессия — ChartRendererTest#overlayLegend_drawnOverPlot.
double legendH = legend == null || spec.legendOverlay ? 0 : legend.height;
Rectangle2D box0 = box;
if (legend != null && !spec.legendOverlay && "b".equals(spec.legendPos)) {
legend.draw(g, box.getX(), box.getY() + box.getHeight() - legendH,
box.getWidth());
box = new Rectangle2D.Double(box.getX(), box.getY(),
box.getWidth(), box.getHeight() - legendH);
} else if (legend != null && "t".equals(spec.legendPos)) {
} else if (legend != null && !spec.legendOverlay && "t".equals(spec.legendPos)) {
legend.draw(g, box.getX(), box.getY(), box.getWidth());
box = new Rectangle2D.Double(box.getX(), box.getY() + legendH,
box.getWidth(), box.getHeight() - legendH);
@@ -92,13 +95,19 @@ final class ChartRenderer {
switch (spec.type) {
case PIE, PIE3D, DOUGHNUT ->
PiePainter.paint(g, spec, box, palette, legend);
PiePainter.paint(g, spec, box, palette,
spec.legendOverlay ? null : legend);
case LINE, AREA, BAR, BAR_HORIZONTAL ->
CartesianPainter.paint(g, spec, box, palette);
case SURFACE3D ->
Surface3dPainter.paint(g, spec, box, palette);
default -> { /* UNSUPPORTED: вызывающий не должен сюда доходить */ }
}
if (legend != null && spec.legendOverlay) {
double y = "t".equals(spec.legendPos)
? box0.getY() : box0.getY() + box0.getHeight() - legend.height;
legend.draw(g, box0.getX(), y, box0.getWidth());
}
} finally {
g.dispose();
}
@@ -117,6 +117,8 @@ final class ChartSpec {
DrawMlText.Style titleStyle;
DrawMlText.Style legendStyle;
String legendPos = "b";
/** c:overlay (ECMA-376 §21.2.2.132): легенда рисуется поверх, место не резервируется. */
boolean legendOverlay;
final List<Series> series = new ArrayList<>();
final List<String> categories = new ArrayList<>();
AxisSpec valAxis;
@@ -419,10 +421,10 @@ final class ChartSpec {
return;
}
var legend = chart.getLegend();
if (isTrue(legend.getOverlay())) {
// легенда поверх области построения — не резервируем место
spec.legendPos = null;
}
// c:overlay (§21.2.2.132) — «other chart elements shall be allowed to
// overlap this chart element»: легенда остаётся и сохраняет позицию,
// просто не резервирует место. Регрессия — ChartSpecTest#overlayLegend_keepsPositionAndFlag.
spec.legendOverlay = isTrue(legend.getOverlay());
if (legend.getLegendPos() != null && legend.getLegendPos().getVal() != null) {
spec.legendPos = legend.getLegendPos().getVal().value();
}
@@ -96,6 +96,40 @@ class GlyphCoverageNormalizerTest {
assertNull(GlyphCoverageNormalizer.rewrite(xml));
}
/**
* Ленивая (.*?) в matches() поглощала разметку между двумя w:t: ран с
* lastRenderedPageBreak между текстами не должен переписываться.
* Регрессия — GlyphCoverageNormalizerTest#multipleTextNodes_runLeftUntouched.
*/
@Test
void multipleTextNodes_runLeftUntouched() {
String xml = run(timesRPr(),
"<w:t>foo</w:t><w:lastRenderedPageBreak/><w:t>bar" + ROMAN + "</w:t>");
assertNull(GlyphCoverageNormalizer.rewrite(xml));
}
/** Ран внутри текстбокса (вложенный w:r) разрезается, каркас внешнего цел. */
@Test
void nestedRunInTextBox_innerSplit() {
String inner = "<w:r>" + timesRPr() + "<w:t>ы" + ROMAN + "ы</w:t></w:r>";
String xml = NS + "<w:r><w:rPr><w:rFonts w:ascii=\"Calibri\"/></w:rPr>"
+ "<w:drawing><wp:inline><wp:txbx><w:txbxContent><w:p>"
+ inner
+ "</w:p></w:txbxContent></wp:txbx></wp:inline></w:drawing></w:r>"
+ "</w:body></w:document>";
String out = GlyphCoverageNormalizer.rewrite(xml);
assertNotNull(out, "вложенный ран не разрезан");
assertTrue(out.contains("DejaVu Serif"), "нет подстановки во вложенном ране: " + out);
assertTrue(out.contains("<w:r><w:rPr><w:rFonts w:ascii=\"Calibri\"/></w:rPr><w:drawing>"),
"каркас внешнего рана повреждён: " + out);
assertTrue(out.endsWith("</w:p></w:txbxContent></wp:txbx></wp:inline></w:drawing></w:r>"
+ "</w:body></w:document>"), "хвост внешнего рана потерян: " + out);
}
/** Знака нет ни в одном бандл-шрифте: решётку не прячем за случайный шрифт. */
@Test
void glyphMissingEverywhereUntouched() {
@@ -156,4 +156,27 @@ class SymbolFontNormalizerTest {
assertNull(SymbolFontNormalizer.rewrite(
"<w:r><w:rPr><w:rFonts w:ascii=\"Arial\"/></w:rPr><w:t>\uF0A7</w:t></w:r>"));
}
/**
* Ран внутри текстбокса (вложенный w:r): внутренний ран с Wingdings
* переписывается, каркас внешнего остаётся целым.
* Регрессия — SymbolFontNormalizerTest#nestedRunInTextBox_innerNormalized.
*/
@Test
void nestedRunInTextBox_innerNormalized() {
String xml = "<w:document><w:r><w:rPr><w:rFonts w:ascii=\"Calibri\"/></w:rPr>"
+ "<w:drawing><wp:inline><wp:txbx><w:txbxContent><w:p>"
+ "<w:r><w:rPr><w:rFonts w:ascii=\"Wingdings\"/></w:rPr><w:t>\uF0A7 хвостик</w:t></w:r>"
+ "</w:p></w:txbxContent></wp:txbx></wp:inline></w:drawing></w:r></w:document>";
String out = SymbolFontNormalizer.rewrite(xml);
assertNotNull(out, "внутренний ран не переписан");
assertTrue(out.contains("<w:t>▪ хвостик</w:t>"), "PUA не стал Unicode: " + out);
assertFalse(out.contains("Wingdings"), "имя шрифта не заменено: " + out);
assertTrue(out.contains("w:ascii=\"" + SymbolFontNormalizer.REPLACEMENT_FAMILY + "\""),
"нет fallback-семейства: " + out);
assertTrue(out.contains("<w:r><w:rPr><w:rFonts w:ascii=\"Calibri\"/></w:rPr><w:drawing>"),
"каркас внешнего рана повреждён: " + out);
}
}
@@ -50,6 +50,66 @@ class CartesianPainterTest {
runs.get(0)[1] - runs.get(0)[0] + 1, 0.75 * slot);
}
/**
* AREA замыкается по базовой линии оси значений (Word заполняет область
* между кривой и осью категорий, ECMA-376 §21.2.2.5), а не хордой
* последняя→первая: у базовой линии посередине между категориями 2 и 3
* заливка обязана быть.
* Регрессия — CartesianPainterTest#areaFill_closesToBaseline.
*/
@Test
void areaFill_closesToBaseline() {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.AREA;
spec.legendPos = null;
DrawMlText.Style style = new DrawMlText.Style(9, false, false,
new Color(0x59, 0x59, 0x59), "carlito");
spec.catAxis = new ChartSpec.AxisSpec();
spec.catAxis.labelStyle = style;
spec.valAxis = new ChartSpec.AxisSpec();
spec.valAxis.labelStyle = style;
ChartSpec.Series s = new ChartSpec.Series();
s.values.add(0.0);
s.values.add(100.0);
s.values.add(50.0);
spec.series.add(s);
BufferedImage img = ChartRenderer.render(spec, 219.23, 149.08, new DrawMlColor(null));
int lowest = -1;
int xLeft = -1;
int xRight = -1;
for (int y = img.getHeight() - 1; y >= 0 && lowest < 0; y--) {
for (int x = 0; x < img.getWidth(); x++) {
if (saturated(img.getRGB(x, y))) {
lowest = y;
break;
}
}
}
for (int x = 0; x < img.getWidth(); x++) {
boolean any = false;
for (int y = 0; y < img.getHeight(); y++) {
if (saturated(img.getRGB(x, y))) {
any = true;
break;
}
}
if (any) {
if (xLeft < 0) {
xLeft = x;
}
xRight = x;
}
}
assertTrue(xLeft >= 0 && xRight > xLeft, "заливки области не найдено");
assertTrue(lowest > 0, "нижнего края заливки не найдено");
int xMid = (xLeft + xRight) / 2;
assertTrue(saturated(img.getRGB(xMid, lowest - 6)),
"на середине между категориями 2 и 3 у базовой линии пусто: "
+ "путь замкнут хордой последняя→первая, а не по оси");
}
private static ChartSpec barSpec(double gapWidth, double overlap, int nSer) {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.BAR;
@@ -0,0 +1,102 @@
package ru.pjandro.wordpdf.internal.chart;
import org.junit.jupiter.api.Test;
import java.awt.Color;
import java.awt.image.BufferedImage;
import static org.junit.jupiter.api.Assertions.*;
/**
* Компоновка chartSpace в {@link ChartRenderer}: легенда c c:overlay
* (ECMA-376 §21.2.2.132) остаётся видимой и не резервирует место —
* область построения выше, чем без overlay.
*/
class ChartRendererTest {
/**
* Одна и та же LINE-спека с legendOverlay=false/true: легенда видима
* в обеих (нижняя полоса), но у overlay кривая опускается ниже —
* место под легенду не вырезано из области построения.
* Регрессия — ChartRendererTest#overlayLegend_drawnOverPlot.
*/
@Test
void overlayLegend_drawnOverPlot() {
BufferedImage plain = ChartRenderer.render(lineSpec(false), 219.23, 149.08,
new DrawMlColor(null));
BufferedImage overlay = ChartRenderer.render(lineSpec(true), 219.23, 149.08,
new DrawMlColor(null));
assertTrue(hasSaturated(plain, plain.getWidth() / 2,
(int) (plain.getHeight() * 0.90), plain.getHeight()),
"легенда пропала без overlay");
assertTrue(hasSaturated(overlay, overlay.getWidth() / 2,
(int) (overlay.getHeight() * 0.90), overlay.getHeight()),
"overlay-легенда не нарисована");
int yPlain = lowestSaturated(plain, rightEdge(plain) - 5);
int yOverlay = lowestSaturated(overlay, rightEdge(overlay) - 5);
assertTrue(yOverlay > yPlain + 5,
"overlay не отдаёт область построения обратно: yPlain=" + yPlain
+ ", yOverlay=" + yOverlay);
}
private static ChartSpec lineSpec(boolean overlay) {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.LINE;
spec.legendPos = "b";
spec.legendOverlay = overlay;
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;
ChartSpec.Series s = new ChartSpec.Series();
s.name = "R";
s.values.add(50.0);
s.values.add(100.0);
s.values.add(0.0);
spec.series.add(s);
return spec;
}
/** Правый насыщенный столбец (конец кривой). */
private static int rightEdge(BufferedImage img) {
for (int x = img.getWidth() - 1; x >= 0; x--) {
for (int y = 0; y < img.getHeight(); y++) {
if (saturated(img.getRGB(x, y))) {
return x;
}
}
}
return -1;
}
/** Есть ли насыщенный (цвет ряда) пиксель в столбце x между строками y0..y1. */
private static boolean hasSaturated(BufferedImage img, int x, int y0, int y1) {
for (int y = y0; y < y1; y++) {
if (saturated(img.getRGB(x, y))) {
return true;
}
}
return false;
}
/** Нижняя насыщенная строка в столбце x; -1 — нет таких. */
private static int lowestSaturated(BufferedImage img, int x) {
for (int y = img.getHeight() - 1; y >= 0; y--) {
if (saturated(img.getRGB(x, y))) {
return y;
}
}
return -1;
}
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;
}
}
@@ -456,17 +456,9 @@ class ChartSpecTest {
assertEquals(1, spec.series.get(0).pointFills.size());
}
/** overlay не затирает позицию: явный c:legendPos сохраняет силу (ECMA-376 §21.2.2.132). */
@Test
void legendOverlayClearsPosExplicitPosWins() {
CTChart chart = new CTChart();
CTLegend legend = new CTLegend();
CTBoolean overlay = new CTBoolean();
overlay.setVal(Boolean.TRUE);
legend.setOverlay(overlay);
chart.setLegend(legend);
ChartSpec spec = ChartSpec.parse(spaceWith(chart), new DrawMlColor(null));
assertNull(spec.legendPos, "overlay-легенда не резервирует место");
void legendOverlayKeepsExplicitPos() {
CTChart chart2 = new CTChart();
CTLegend legend2 = new CTLegend();
CTBoolean overlay2 = new CTBoolean();
@@ -478,6 +470,7 @@ class ChartSpecTest {
chart2.setLegend(legend2);
ChartSpec spec2 = ChartSpec.parse(spaceWith(chart2), new DrawMlColor(null));
assertEquals("t", spec2.legendPos);
assertTrue(spec2.legendOverlay);
}
@Test
@@ -652,6 +645,20 @@ class ChartSpecTest {
() -> ChartSpec.parse(spaceWith(chart), new DrawMlColor(null)));
}
/** c:overlay=1 без c:legendPos: флаг взведён, позиция осталась дефолтной «b». */
@Test
void overlayLegend_keepsPositionAndFlag() {
CTChart chart = new CTChart();
CTLegend legend = new CTLegend();
CTBoolean overlay = new CTBoolean();
overlay.setVal(true);
legend.setOverlay(overlay);
chart.setLegend(legend);
ChartSpec spec = ChartSpec.parse(spaceWith(chart), new DrawMlColor(null));
assertTrue(spec.legendOverlay, "оверлей не запомнен");
assertEquals("b", spec.legendPos, "позиция легенды затёрта");
}
private static CTChart barChartWithVal(CTNumDataSource val) {
CTChart chart = new CTChart();
CTPlotArea pa = new CTPlotArea();