feat: рантайм без fontconfig — глиф-движок GlyphFont (fontbox) вместо java.awt.Font
PR checks / java (pull_request) Successful in 2m11s
PR checks / web (pull_request) Successful in 1m8s

На OpenJDK/Linux любое обращение к java.awt.Font требует fontconfig-нативки
(Fontconfig head is null на хосте без libfontconfig). java.awt.Font убран из
всего рантайм-пути: текст chart-движка (DrawMlText) и проверка покрытия глифов
(GlyphCoverageNormalizer) переведены на GlyphFont — чистый Java-парсер TTF
org.apache.pdfbox:fontbox 3.0.8 (compile; commons-logging исключён,
единственный провайдер jcl-over-slf4j). Метрики совпадают с AWT до 4-го знака,
кернинг-дрейф 0.0000 (DejaVu Sans, Carlito). AWT остаётся только как геометрия
(Graphics2D/Path2D), которая fontconfig не требует.

- GlyphFont: of/canDisplay/advance/ascent/descent/leading/draw; TTF читается
  напрямую из classpath, не зависит от BundledFonts.init(); битый бандл падает
  IllegalStateException, отсутствующее семейство/начертание -> null
- DrawMlText.fontFor: цепочка фолбэка family/variant -> family/regular ->
  fallback/variant -> fallback/regular (bold у Noto остаётся своим regular)
- BundledFonts: awtFont/AWT_FONTS удалены (чистый cutover), CLASSPATH_DIR ->
  package-private
- ChartRenderer.measureLegend: убран неиспользуемый после cutover параметр g (PMD)
- GlyphFontTest (6 юнитов) без единого java.awt.Font — обязан проходить на хосте
  без fontconfig; Containerfile/AGENTS.md: fontconfig рантайму не нужен

Проверено: mvn clean verify локально (153 теста, PMD); приёмочный стенд —
контейнер без libfontconfig.so и /etc/fonts: mvn verify BUILD SUCCESS и
java -jar + конвертация charts-smartart.docx -> PDF 466 КБ с 4 растрами
(деградации нет).
This commit is contained in:
Pjandro
2026-10-21 19:06:28 +00:00
parent 13b7c2f39b
commit c09a3f5adf
13 changed files with 405 additions and 99 deletions
@@ -0,0 +1,81 @@
package ru.pjandro.wordpdf.fonts;
import org.junit.jupiter.api.Test;
import java.awt.Graphics2D;
import java.awt.RenderingHints;
import java.awt.image.BufferedImage;
import static org.junit.jupiter.api.Assertions.*;
/**
* Глиф-движок GlyphFont (fontbox). Тест намеренно не использует
* {@code java.awt.Font} ни в одной строке: он обязан проходить на хосте
* без fontconfig (контейнер без libfontconfig.so и /etc/fonts) — это и
* есть приёмочный стенд перехода с AWT-шрифтов на fontbox.
*/
class GlyphFontTest {
/** Нет такого семейства в бандле -> null (запрашивающий делает фолбэк). */
@Test
void of_unknownFamily_returnsNull() {
assertNull(GlyphFont.of("comic sans ms", BundledFonts.V_REGULAR));
}
/** Семейство есть, начертания нет (Noto — только regular) -> null. */
@Test
void of_missingVariant_returnsNull() {
assertNull(GlyphFont.of("noto naskh arabic", BundledFonts.V_BOLD));
}
/** Кириллица покрыта; известный остаток эталона U+2188 — нет. */
@Test
void canDisplay_cyrillicTrue_missingGlyphFalse() {
GlyphFont f = GlyphFont.of("dejavu sans", BundledFonts.V_REGULAR);
assertNotNull(f);
assertTrue(f.canDisplay('а'));
assertFalse(f.canDisplay(0x2188));
}
/** Ширина строки — сумма ширин глифов по кодовым точкам. */
@Test
void advance_sumsCodePoints() {
GlyphFont f = GlyphFont.of("carlito", BundledFonts.V_REGULAR);
assertNotNull(f);
assertEquals(f.advance("A", 12) + f.advance("V", 12),
f.advance("AV", 12), 1e-9);
assertTrue(f.advance("AV", 12) > 0);
}
/** Растеризация глифов-контуров оставляет чернила (пиксели с alpha). */
@Test
void draw_leavesInkPixels() {
GlyphFont f = GlyphFont.of("dejavu sans", BundledFonts.V_REGULAR);
assertNotNull(f);
BufferedImage img = new BufferedImage(200, 100, BufferedImage.TYPE_INT_ARGB);
Graphics2D g = img.createGraphics();
g.setRenderingHint(RenderingHints.KEY_ANTIALIASING,
RenderingHints.VALUE_ANTIALIAS_ON);
g.setColor(java.awt.Color.BLACK);
f.draw(g, "Тест", 10, 60, 12);
g.dispose();
int ink = 0;
for (int px : img.getRGB(0, 0, img.getWidth(), img.getHeight(),
null, 0, img.getWidth())) {
if ((px >>> 24) > 0) {
ink++;
}
}
assertTrue(ink > 100, "Глифы не оставили пикселей: " + ink);
}
/** Вертикальные метрики: ascent/descent положительные, leading >= 0. */
@Test
void ascentDescent_positive() {
GlyphFont f = GlyphFont.of("carlito", BundledFonts.V_REGULAR);
assertNotNull(f);
assertTrue(f.ascent(12) > 0);
assertTrue(f.descent(12) > 0);
assertTrue(f.leading(12) >= 0);
}
}