feat: рантайм без fontconfig — глиф-движок GlyphFont (fontbox) вместо java.awt.Font #22

Merged
pjandro merged 2 commits from no-fontconfig-runtime into main 2026-10-21 23:29:43 +03:00
15 changed files with 414 additions and 109 deletions
+6 -5
View File
@@ -11,7 +11,7 @@
Наружу `WordPdfValidator.validate(docxBytes, options)` (размер → zip-подпись `PK\x03\x04` → контейнер (.docx-манифест + zip-бомба) → страницы) вызывается **до** приватного `convertToStream`; внутри `convertToStream`:
1. `new BundledFontMapper()` → `BundledFonts.init()` → `BundledFonts.restrictToBundled()`. Конструктор маппера каждый раз добавляет системные шрифты в реестр `PhysicalFonts`; ключ реестра — имя из name-таблицы TTF, `addPhysicalFont(URI)` не перезаписывает занятый → `init()` вызывает `dropNonBundled()` **до** регистрации и `load()` (иначе системный Calibri ломает em-dash-fallback).
2. Нормализация байтов docx до JAXB-загрузки (цепочка `byte[] → byte[]`, порядок значим): `StrictOoxmlNormalizer` (strict-OOXML → transitional-байт: `a:`-проценты и `w14:fillToRect` → тысячные ×1000, текст `wp14:pctWidth`/`pctHeight`, элементы и атрибуты `w:start`/`w:end` → `w:left`/`w:right` (кроме `w:lvl/w:start` в numbering.xml), значения `start`/`end` у `w:jc`/`w:tab`; в `mc-preprocessor.xslt` docx4j ветка `%` закомментирована, start/end не маппятся; namespaces и `pt`-значения правит сам mc-preprocessor — собственный рерайт URI ломает его pt-конверсию) → `DocxOnOffNormalizer` (`w:val="off"/"on"` → `false`/`true`) → `SymbolFontNormalizer` (PUA U+F0xx Symbol/Wingdings/Webdings → Unicode + DejaVu Sans, переписывает и элементы `<w:sym>`; 5 карт по 256 слотов, таблица `SymbolMapper` сгенерирована из docx4j 17.x) → `FieldNormalizer` (`fldChar` PAGE/NUMPAGES/SECTIONPAGES → `w:fldSimple`, вложенные/битые поля пропускает) → `GlyphCoverageNormalizer` (режет ран по покрытию глифов, пишет семейство в `w:rFonts`, иначе FOP рисует «#»; покрытие — `java.awt.Font.canDisplay` + BitSet-кэш, НЕ docx4j `GlyphCheck` — тот плодит INFO-лог; для serif-ран fallback ищется сначала в `SERIF_FAMILIES` (DejaVu Serif/Tinos/Caladea), затем в sans) → `WordprocessingMLPackage.load`.
2. Нормализация байтов docx до JAXB-загрузки (цепочка `byte[] → byte[]`, порядок значим): `StrictOoxmlNormalizer` (strict-OOXML → transitional-байт: `a:`-проценты и `w14:fillToRect` → тысячные ×1000, текст `wp14:pctWidth`/`pctHeight`, элементы и атрибуты `w:start`/`w:end` → `w:left`/`w:right` (кроме `w:lvl/w:start` в numbering.xml), значения `start`/`end` у `w:jc`/`w:tab`; в `mc-preprocessor.xslt` docx4j ветка `%` закомментирована, start/end не маппятся; namespaces и `pt`-значения правит сам mc-preprocessor — собственный рерайт URI ломает его pt-конверсию) → `DocxOnOffNormalizer` (`w:val="off"/"on"` → `false`/`true`) → `SymbolFontNormalizer` (PUA U+F0xx Symbol/Wingdings/Webdings → Unicode + DejaVu Sans, переписывает и элементы `<w:sym>`; 5 карт по 256 слотов, таблица `SymbolMapper` сгенерирована из docx4j 17.x) → `FieldNormalizer` (`fldChar` PAGE/NUMPAGES/SECTIONPAGES → `w:fldSimple`, вложенные/битые поля пропускает) → `GlyphCoverageNormalizer` (режет ран по покрытию глифов, пишет семейство в `w:rFonts`, иначе FOP рисует «#»; покрытие — `GlyphFont` (fontbox, cmap) + BitSet-кэш, НЕ docx4j `GlyphCheck` — тот плодит INFO-лог, `java.awt.Font` требовал fontconfig на хосте; для serif-ран fallback ищется сначала в `SERIF_FAMILIES` (DejaVu Serif/Tinos/Caladea), затем в sans) → `WordprocessingMLPackage.load`.
3. `WordPdfValidator.checkPageCount(docxBytes, maxPages)` — **до** рендера, lightweight (zip/StAX) по нормализованным байтам — тот же путь, что у приложения до очереди.
4. `pkg.setFontMapper(mapper)` → `DrawingPreRenderer.run(pkg, options)` (шаг 3.5: `c:chart`/`dgm:relIds` docx2fo.xslt не умеет — свой Java2D-движок `internal/chart/*` рендерит в PNG 300 dpi и подменяет на `pic:pic`; объект, выключенный в `ConvertOptions`, пропускается до рендера и остаётся в docx; упавший рендер — объект **удаляется** из docx (`gd.getAny().clear()`) + warn, деградация не падение).
5. `new FOSettings(pkg)` + `FopFallbackFonts.declare` (декларирует **все** бандл-семейства — FOP встраивает только задекларированные) → `FORendererApacheFOP`/`FOUserAgent` (непустой `title` → заголовок PDF) → `Docx4J.toFO(..., FLAG_EXPORT_PREFER_XSL)`.
@@ -41,21 +41,21 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр
### Шрифты (30 TTF + 3 лицензии, SIL OFL, `wordpdf-core/src/main/resources/fonts/`)
7 семейств × 4 начертания (Carlito/Caladea/Arimo/Tinos/Cousine/DejaVu Sans/DejaVu Serif) + Noto Naskh Arabic / Noto Sans Armenian (только regular). Алиасы в `BundledFontMapper.ALIASES` (ключи lowercase): MS→аналоги — Calibri→Carlito, **Calibri Light→Carlito**, Cambria→Caladea, Arial→Arimo, Times New Roman→Tinos, Courier New→Cousine; **self-map** всех бандл-семейств, включая Noto (иначе unmatched уходит в DejaVu-фолбэк); fallback — DejaVu Sans; виртуальный `SYMBOL_FONT` «Segoe UI Symbol» (U+2000–U+2EFF) → fallback до основного цикла. `DISPLAY_NAMES` — обратный маппинг lowercase→отображаемое имя для `documentFontName` (пишет `GlyphCoverageNormalizer` в `w:rFonts`); `BundledFontMapper.bundledFamily` — public-хук «имя шрифта из docx → бандл-семейство или fallback» (пользуется chart-движок). Публичный API `BundledFonts` шире реестра: `families()` (источник для `FopFallbackFonts`), `font/regular/bold/italic/boldItalic(family)`, `FALLBACK_FAMILY`; `awtFont` возвращает `Font` размера 1 — всегда `deriveFont(size)`. Новый шрифт = файл + запись в `BundledFonts.ENTRIES` (синхрон проверяет `BundledFontsTest`).
7 семейств × 4 начертания (Carlito/Caladea/Arimo/Tinos/Cousine/DejaVu Sans/DejaVu Serif) + Noto Naskh Arabic / Noto Sans Armenian (только regular). Алиасы в `BundledFontMapper.ALIASES` (ключи lowercase): MS→аналоги — Calibri→Carlito, **Calibri Light→Carlito**, Cambria→Caladea, Arial→Arimo, Times New Roman→Tinos, Courier New→Cousine; **self-map** всех бандл-семейств, включая Noto (иначе unmatched уходит в DejaVu-фолбэк); fallback — DejaVu Sans; виртуальный `SYMBOL_FONT` «Segoe UI Symbol» (U+2000–U+2EFF) → fallback до основного цикла. `DISPLAY_NAMES` — обратный маппинг lowercase→отображаемое имя для `documentFontName` (пишет `GlyphCoverageNormalizer` в `w:rFonts`); `BundledFontMapper.bundledFamily` — public-хук «имя шрифта из docx → бандл-семейство или fallback» (пользуется chart-движок). Публичный API `BundledFonts` шире реестра: `families()` (источник для `FopFallbackFonts`), `font/regular/bold/italic/boldItalic(family)`, `FALLBACK_FAMILY`. `GlyphFont` — глиф-движок на fontbox (метрики + растеризация глифов для текста chart-движка и покрытие глифов в `GlyphCoverageNormalizer`); читает TTF напрямую из classpath (не зависит от `init()`); рантайм не требует fontconfig/системных шрифтов — `java.awt.Font` из рантайм-пути убран, AWT остаётся только как геометрия Graphics2D. Новый шрифт = файл + запись в `BundledFonts.ENTRIES` (синхрон проверяет `BundledFontsTest`).
## Key Directories
|Путь|Назначение|
|---|---|
|`wordpdf-core/src/main/java/ru/pjandro/wordpdf/`|публичный API: `WordPdfConverter`, `WordPdfValidator` (перегрузки `checkInput`/`checkPageCount` и `validate(byte[], ConvertOptions)` — полная цепочка; без зависимости от docx4j), `ConversionException`, `ValidationException` (наследник — «вход некорректен»), `DrawingFoundException` (`enum Kind {CHARTS, SMARTART}` — отказ по error-флагу), `WordPdfSettings` (константы-дефолты: `MAX_INPUT_MB=5`, `MAX_PAGES=100`, защитные `MAX_DECOMPRESSED_MB=200`/`MAX_ZIP_ENTRIES=8192`, `RENDER_*=true`, `ERROR_*=false`), `ConvertOptions` (record: renderCharts, renderSmartArt, errorOnCharts, errorOnSmartArt, maxMb, maxPages)|
|`…/wordpdf/fonts/`|`BundledFonts` (реестр/выгрузка TTF, `families()`, `FALLBACK_FAMILY`), `BundledFontMapper` (алиасы MS→open-source, self-map, DISPLAY_NAMES, public-хук `bundledFamily`)|
|`…/wordpdf/fonts/`|`BundledFonts` (реестр/выгрузка TTF, `families()`, `FALLBACK_FAMILY`), `BundledFontMapper` (алиасы MS→open-source, self-map, DISPLAY_NAMES, public-хук `bundledFamily`), `GlyphFont` (глиф-движок fontbox: метрики/глифы без java.awt.Font)|
|`…/wordpdf/internal/`|5 байтовых нормализатора + `FopFallbackFonts` (классы `public` — вызываются из родительского пакета; публичные члены только `normalize`/`declare`)|
|`…/wordpdf/internal/chart/`|11 классов Java2D-рендера диаграмм/SmartArt в PNG (public только `DrawingPreRenderer`)|
|`wordpdf-core/src/main/resources/fonts/`|30 TTF + 3 лицензии — бинарные фикстуры, часть jar|
|`wordpdf-core/src/test/resources/samples/`|11 закоммиченных `.docx`-фикстур (единственные фикстуры)|
|`wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/`|REST API (10 классов): `WordPdfApplication` (единственный public), `ConvertController`, `ConversionService` (очередь), `ApiExceptionHandler`, `ApiKeyFilter`, `OpenApiConfig` (`@SecurityScheme` X-API-Key для springdoc) + 5 класса исключений|
|`wordpdf-web/src/`|SPA (React 19 + TS + Vite + Tailwind): `api.ts` (вся сеть), `components/` (App, ApiKeyGate, PdfPreview, StatusMessage, DropZone, Logo)|
|корневые `Containerfile`, `compose.yml`, `compose.dev.yml`, `gateway/nginx.conf`|образ бэкенда (multi-stage maven:3.9-temurin-21 → **полный** temurin-21-jre — Java2D нужны AWT/fontconfig; non-root uid 10001, HEALTHCHECK actuator); compose app+web+gateway: web-образ со своим HEALTHCHECK (`wget /`), в обоих compose `depends_on web: condition: service_healthy`; прод-compose интерполирует `WORDPDF_MAX_MB:-5`/`WORDPDF_MAX_PAGES:-100`; podman-специфика обоих compose: `x-podman.name_separator_compat` (docker-style имена), явные `healthcheck` app/web (дубли Containerfile-HEALTHCHECK — OCI-выгрузка его теряет), зафиксированная подсеть `10.113.0.0/24` gw `10.113.0.1` под резолвер aardvark-dns; два repo-стенда одновременно не поднять (общая подсеть)|
|корневые `Containerfile`, `compose.yml`, `compose.dev.yml`, `gateway/nginx.conf`|образ бэкенда (multi-stage maven:3.9-temurin-21 → temurin-**21-jre-alpine** (musl) — chart-движку нужен только модуль java.desktop (Graphics2D, он внутри JRE); fontconfig и системные шрифты рантайму не нужны — текст рисуется глифами fontbox, см. `fonts/GlyphFont` (проверено на musl-стенде без libfontconfig/`/etc/fonts`); HEALTHCHECK busybox `wget` (curl/apt не ставим), non-root uid 10001); compose app+web+gateway: web-образ со своим HEALTHCHECK (`wget /`), в обоих compose `depends_on web: condition: service_healthy`; прод-compose интерполирует `WORDPDF_MAX_MB:-5`/`WORDPDF_MAX_PAGES:-100`; podman-специфика обоих compose: `x-podman.name_separator_compat` (docker-style имена), явные `healthcheck` app/web (дубли Containerfile-HEALTHCHECK — OCI-выгрузка его теряет; app-хелсчеки — `wget`, как в Containerfile), зафиксированная подсеть `10.113.0.0/24` gw `10.113.0.1` под резолвер aardvark-dns; два repo-стенда одновременно не поднять (общая подсеть)|
|корневой `.env.example`|шаблон env: `WORDPDF_API_KEY` (`openssl rand -hex 32`), закомментированные `WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES` (пустое значение ломает старт — binding long/int); реальный прод `.env` — на прод-сервере (координаты: `/home/pjandro/prod/java-word-pdf/DEPLOY.md`, вне репо)|
|`.gitea/workflows/`|Gitea Actions: `pr.yml` (PR checks), `main.yml` (тесты → `images` (build+push в Nexus) → deploy (pull) → autotests → rollback)|
|корневой `GITEA-vars.md`|инструкция владельца: Secrets/Variables, защита ветки, перезапуск — только имена переменных, без значений|
@@ -153,9 +153,10 @@ SSH-пользователи/логины, ни хосты, ни директо
## Testing & QA
- Гейт `maven-pmd-plugin` 3.28.0 (PMD 7.17) на `verify` для обоих модулей, ruleset `pmd-ruleset.xml` (codestyle без opinionated-правил + unused-правила + XPath `LiteralFirstInEquals` — строковый литерал слева в `equals`/`equalsIgnoreCase`; `junit5TestPattern` разрешает underscore-имена регрессий; `includeTests=true` — тесты сканируются).
- 14 тестовых классов / 138 `@Test` (core 11/112, app 3/26). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true` в argLine; только `Assertions` (Mockito/AssertJ не использовать, несмотря на test-classpath Boot; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`); тестовые классы package-private, зеркалят main-пакеты; только `@Test` (+ единственный `@BeforeAll` — warm-up шрифтов в `GlyphCoverageNormalizerTest`).
- 15 тестовых классов / 144 `@Test` (core 12/118, app 3/26). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true` в argLine; только `Assertions` (Mockito/AssertJ не использовать, несмотря на test-classpath Boot; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`); тестовые классы package-private, зеркалят main-пакеты; только `@Test` (+ единственный `@BeforeAll` — warm-up шрифтов в `GlyphCoverageNormalizerTest`).
- **PDF сравнивается текстом, не растеризацией**: PDFBox 3 (`Loader.loadPDF`) — `PDFTextStripper` для текста (пер-странично `setStartPage/setEndPage`), override `processTextPosition` для шрифта конкретного символа (`fontNameOf`), обход ресурсов страниц для встроенных шрифтов (`EAAAAA+Carlito-Bold`) и счётчика картинок (`imageCount`). Негативные маркеры — регрессии: `assertFalse(text.contains("#"))` (.notdef), `assertFalse(font.startsWith("Helvetica"))`. Текст нормализуется по пробелам (`norm`); в `tableImage_tableAndImage` — полное удаление пробелов (docx4j переносит слова в auto-fit таблицах).
- Пиксели (BufferedImage) — только в unit-тестах chart-пейнтеров: безразмерные отношения к эталону Word, допуски `assertRatio` <0.06 (`PiePainterTest` аспект h/w=0.585) / <0.10 (`Surface3dPainterTest`, + `assertRange` ±6 pt для центров силуэта); пороги залитых px и перцентильные коридоры яркости. Эталонные замеры — по Word-экспорту 300 dpi (`develop/`, вне git).
- `GlyphFont` (fontbox): метрики пиксельно-метрически эквивалентны AWT (ascent/descent/leading/advance совпадают до 4-го знака, кернинг-дрейф 0.0000 — DejaVu Sans, Carlito). Приёмочный стенд без-fontconfig: контейнер без `libfontconfig.so.1*` и `/etc/fonts`, `mvn verify` + `java -jar` (до перехода на GlyphFont там падали `GlyphCoverageNormalizerTest` 12 / `CartesianPainterTest` 3 / `PiePainterTest` 2 / chart-тесты `WordPdfConverterTest` 4, chart-рендер молча деградировал). `GlyphFontTest` написан без единого `java.awt.Font` — обязан проходить на хосте без fontconfig.
- Фикстуры — закоммиченные `samples/*.docx` (11; в тестах не генерировать): core грузит classpath-ресурсом → `byte[]`, PDF для PDFBox — временный файл; app читает `/samples/…` из **test-jar core** (classifier `tests`) → `mvn -pl wordpdf-app` без `-am` не соберётся. In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]`. Ключевые: `too-many-pages` (150 явных разрывов → 151), `stale-cache` (кэш `<Pages>1</Pages>` + 110 `lastRenderedPageBreak`), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject).
- Юниты нормализаторов работают строками (`rewrite`) + zip'ами из `ZipOutputStream`; обязательные контракты: «нечего менять → тот же массив» (`assertSame` покрыт тестами только у zip-нормализаторов `DocxOnOff`/`SymbolFont`/`StrictOoxml`; у `Field`/`GlyphCoverage` — `rewrite`→`null`) и неприкосновенность частей вне `word/*.xml` (`[Content_Types].xml`). Тесты бьют и в package-private API (`GlyphCoverageNormalizer.split(text, family)`, `ChartSpec.readTitle`).
- App-тесты: `@SpringBootTest` + `@AutoConfigureMockMvc` (Boot 4: `org.springframework.boot.webmvc.test.autoconfigure`); три контекста — `ConvertControllerTest` (пустой ключ), `ApiKeyFilterTest` (`properties = "wordpdf.api-key=…"`), `ConvertLimitsTest` (`@TestPropertySource` с лимитами — отдельный класс, не `@Nested`).
+11 -11
View File
@@ -9,21 +9,21 @@ RUN mvn -B -q dependency:go-offline
COPY . .
RUN mvn -B -q -DskipTests package
FROM docker.io/library/eclipse-temurin:21-jre
# curl — только для HEALTHCHECK; runtime полный jre (не alpine-slim): Java2D
# chart-движка нужны AWT и fontconfig-нативки; бандл-шрифты лежат в jar,
# системные шрифты не нужны. Тесты в образе не гоняем — гейт mvn clean verify.
FROM docker.io/library/eclipse-temurin:21-jre-alpine
# runtime alpine (минимальный): chart-движку нужен только модуль java.desktop
# (Graphics2D), он внутри JRE; fontconfig и системные шрифты не нужны —
# текст рисуется глифами fontbox (см. fonts/GlyphFont; проверено на musl-стенде
# без libfontconfig и /etc/fonts). Тесты в образе не гоняем — гейт mvn clean verify.
# HEALTHCHECK — busybox wget (есть в alpine из коробки, curl/apt не ставим).
# Прокси-переменные хоста (HTTP_PROXY/HTTPS_PROXY/http_proxy/https_proxy)
# podman/buildah подмешивает в шелл RUN/HEALTHCHECK и ломает curl
# (127.0.0.1:proxy внутри контейнера недоступен) — обнуляем на команде.
RUN apt-get update \
&& apt-get install -y --no-install-recommends curl \
&& rm -rf /var/lib/apt/lists/* \
&& useradd -r -u 10001 app
# podman/buildah подмешивает в шелл RUN/HEALTHCHECK и ломает сетевые команды
# (127.0.0.1:proxy внутри контейнера недоступен) — обнуляем на самой команде.
RUN adduser -S -D -H -u 10001 app
WORKDIR /app
COPY --from=build /build/wordpdf-app/target/wordpdf-app-1.0.0.jar app.jar
USER app
EXPOSE 8080
HEALTHCHECK --interval=10s --timeout=3s --start-period=45s --retries=5 \
CMD HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= curl -fsS http://127.0.0.1:8080/actuator/health >/dev/null || exit 1
CMD HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1:8080/actuator/health || exit 1
ENTRYPOINT ["java", "-Djava.awt.headless=true", "-jar", "/app/app.jar"]
+1 -1
View File
@@ -16,7 +16,7 @@ services:
# где поля healthcheck нет — без явного healthcheck depends_on
# service_healthy ждал бы healthy вечно. Прокси обнуляем на команде.
healthcheck:
test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= curl -fsS http://127.0.0.1:8080/actuator/health >/dev/null || exit 1"]
test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1:8080/actuator/health || exit 1"]
interval: 10s
timeout: 3s
start_period: 45s
+1 -1
View File
@@ -11,7 +11,7 @@ services:
# где поля healthcheck нет — без явного healthcheck depends_on
# service_healthy ждал бы healthy вечно. Прокси обнуляем на команде.
healthcheck:
test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= curl -fsS http://127.0.0.1:8080/actuator/health >/dev/null || exit 1"]
test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1:8080/actuator/health || exit 1"]
interval: 10s
timeout: 3s
start_period: 45s
+24
View File
@@ -74,16 +74,40 @@
<artifactId>slf4j-simple</artifactId>
<version>${slf4j.version}</version>
</dependency>
<!-- Мост commons-logging -> slf4j: fontbox логирует через
commons-logging, единственный провайдер на classpath -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>jcl-over-slf4j</artifactId>
<version>${slf4j.version}</version>
</dependency>
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter</artifactId>
<version>${junit.version}</version>
</dependency>
<dependency>
<groupId>org.apache.pdfbox</groupId>
<artifactId>fontbox</artifactId>
<version>${pdfbox.version}</version>
<exclusions>
<exclusion>
<groupId>commons-logging</groupId>
<artifactId>commons-logging</artifactId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>org.apache.pdfbox</groupId>
<artifactId>pdfbox</artifactId>
<version>${pdfbox.version}</version>
<exclusions>
<exclusion>
<groupId>commons-logging</groupId>
<artifactId>commons-logging</artifactId>
</exclusion>
</exclusions>
</dependency>
<!-- Только для генерации тестовых .docx (одноразово), в рантайм не используется -->
<dependency>
+13
View File
@@ -36,6 +36,19 @@
<groupId>org.slf4j</groupId>
<artifactId>slf4j-simple</artifactId>
</dependency>
<!-- Чистый Java-парсер TTF (глиф-движок GlyphFont): метрики и
отрисовка глифов без java.awt.Font — рантайму не нужен
fontconfig (OpenJDK/Linux требует его при любом обращении
к java.awt.Font). -->
<dependency>
<groupId>org.apache.pdfbox</groupId>
<artifactId>fontbox</artifactId>
</dependency>
<!-- Мост commons-logging -> slf4j для fontbox -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>jcl-over-slf4j</artifactId>
</dependency>
<!-- ============ Тесты ============ -->
<dependency>
@@ -49,8 +49,9 @@ public final class BundledFonts {
*/
public static final String FALLBACK_FAMILY = "dejavu sans";
/** Каталог с TTF внутри jar (classpath). */
private static final String CLASSPATH_DIR = "fonts";
/** Каталог с TTF внутри jar (classpath). Package-private: доступ
* для {@link GlyphFont} (читает TTF напрямую из classpath). */
static final String CLASSPATH_DIR = "fonts";
/** Описание одного файла: имя в jar, ключ семейства, начертание.
* Package-private: доступ для теста. */
@@ -110,9 +111,6 @@ public final class BundledFonts {
/** Ключ семейства (lowercase) -> начертание -> зарегистрированный PhysicalFont. */
private static final Map<String, Map<String, PhysicalFont>> VARIANTS = new HashMap<>();
/** Ключ family/variant -> java.awt.Font (кэш, см. {@link #awtFont}). */
private static final Map<String, java.awt.Font> AWT_FONTS = new HashMap<>();
/** Каталог, куда выгружены TTF (после init()). */
private static Path extractDir;
private static boolean inited = false;
@@ -252,30 +250,4 @@ public final class BundledFonts {
return font(family, V_BOLD_ITALIC);
}
/**
* Тот же TTF, но как {@link java.awt.Font} для Java2D (пре-рендер
* диаграмм и SmartArt в растр, см. internal/chart). Шрифт читается
* из выгруженного файла один раз и кешируется.
*
* @return базовый Font размера 1 (далее {@code deriveFont(size)}),
* или null, если шрифт не найден / {@link #init()} не вызван
*/
public static synchronized java.awt.Font awtFont(String family, String variant) {
String key = family + "/" + variant;
java.awt.Font cached = AWT_FONTS.get(key);
if (cached != null) {
return cached;
}
PhysicalFont pf = font(family, variant);
if (pf == null || pf.getEmbeddedURI() == null) {
return null;
}
try (InputStream in = Files.newInputStream(Path.of(pf.getEmbeddedURI()))) {
java.awt.Font f = java.awt.Font.createFont(java.awt.Font.TRUETYPE_FONT, in);
AWT_FONTS.put(key, f);
return f;
} catch (IOException | java.awt.FontFormatException e) {
return null;
}
}
}
@@ -0,0 +1,200 @@
package ru.pjandro.wordpdf.fonts;
import org.apache.fontbox.ttf.CmapLookup;
import org.apache.fontbox.ttf.GlyphData;
import org.apache.fontbox.ttf.HorizontalHeaderTable;
import org.apache.fontbox.ttf.TTFParser;
import org.apache.fontbox.ttf.TrueTypeFont;
import java.awt.Graphics2D;
import java.awt.geom.AffineTransform;
import java.awt.geom.GeneralPath;
import java.io.IOException;
import java.io.InputStream;
import java.util.HashMap;
import java.util.Map;
/**
* Глиф-движок бандл-шрифтов: метрики и отрисовка глифов через чистый
* Java-парсер TTF (fontbox), без {@link java.awt.Font}.
*
* Почему: на OpenJDK/Linux любое обращение к {@code java.awt.Font}
* (включая {@code Font.createFont} и {@code TextLayout}) инициализирует
* {@code SunFontManager}, которому нужны fontconfig-нативки и хотя бы
* один системный шрифт — на хосте без libfontconfig это
* {@code RuntimeException: Fontconfig head is null}. Метрики fontbox
* совпадают с AWT до 4-го знака (ascent/descent/leading/advance,
* кернинг-дрейф 0.0000 — DejaVu Sans, Carlito). Приёмочный стенд —
* контейнер без libfontconfig и /etc/fonts (см. GlyphFontTest, там же
* регрессия «тест обязан проходить без fontconfig»).
*
* AWT остаётся только как геометрия (Graphics2D/Path2D/AffineTransform):
* она fontconfig не требует. Растеризация глифов — контуры
* {@link GlyphData#getPath()} + {@link Graphics2D#fill}.
*
* Объект безразмерный: размер в pt передаётся в каждый метод явно
* (в отличие от AWT, где размер живёт в объекте Font). Шрифт читается
* напрямую из classpath ({@code fonts/<file>}), а не из временного
* каталога {@link BundledFonts#init()} — поэтому класс не зависит от
* порядка шагов конвертации. TTF буферизуется в памяти и живёт до конца
* JVM (шрифты бандла конечны, {@link TrueTypeFont} намеренно не закрываем).
*/
public final class GlyphFont {
/** Кэш распарсенных шрифтов: ключ — {@code family/variant}. */
private static final Map<String, GlyphFont> CACHE = new HashMap<>();
private final String key;
private final TrueTypeFont ttf;
private CmapLookup cmap;
private GlyphFont(String key, TrueTypeFont ttf) {
this.key = key;
this.ttf = ttf;
}
/**
* Шрифт бандла по семейству (lowercase-ключ) и начертанию.
*
* @return шрифт или {@code null}, если семейства/начертания нет
* в бандле (нормальный случай: запрашивающий сделает фолбэк).
* {@code null} не кэшируется — повторный вызов дёшев.
* @throws IllegalStateException битый бандл: TTF из jar не читается.
* Падаем громко, а не «null» — null означал бы «всё непокрыто»
* и портил бы разбиение ранов.
*/
public static synchronized GlyphFont of(String family, String variant) {
String key = family + "/" + variant;
GlyphFont cached = CACHE.get(key);
if (cached != null) {
return cached;
}
for (BundledFonts.Entry e : BundledFonts.ENTRIES) {
if (e.family().equals(family) && e.variant().equals(variant)) {
GlyphFont f = load(key, e.file());
CACHE.put(key, f);
return f;
}
}
return null;
}
private static GlyphFont load(String key, String file) {
String path = BundledFonts.CLASSPATH_DIR + "/" + file;
try (InputStream in = GlyphFont.class.getClassLoader().getResourceAsStream(path)) {
if (in == null) {
throw new IllegalStateException(
"Не удалось загрузить шрифт бандла: " + path + " (нет в classpath)");
}
return new GlyphFont(key, new TTFParser().parseEmbedded(in));
} catch (IOException e) {
throw new IllegalStateException(
"Не удалось загрузить шрифт бандла: " + path, e);
}
}
/** Есть ли глиф для кодовой точки (gid 0 = .notdef → нет). */
public boolean canDisplay(int cp) {
return cmap().getGlyphId(cp) != 0;
}
/** Ширина строки в pt: сумма ширин глифов по кодовым точкам. */
public double advance(String text, double sizePt) {
CmapLookup c = cmap();
double w = 0;
for (int i = 0; i < text.length(); ) {
int cp = text.codePointAt(i);
w += advanceWidth(c.getGlyphId(cp)) * sizePt / unitsPerEm();
i += Character.charCount(cp);
}
return w;
}
/** Высота возвышения над базовой линией в pt (hhea.ascender). */
public double ascent(double sizePt) {
return hhea().getAscender() * sizePt / unitsPerEm();
}
/** Глубина ниже базовой линии в pt (hhea.descender — число отрицательное). */
public double descent(double sizePt) {
return -hhea().getDescender() * sizePt / unitsPerEm();
}
/** Межстрочный интервал в pt (hhea.lineGap; у бандла — 0). */
public double leading(double sizePt) {
return hhea().getLineGap() * sizePt / unitsPerEm();
}
/**
* Рисует строку глифами-контурами: базовая линия в {@code baselineY},
* цвет/прочие атрибуты — уже установлены в {@code g} вызывающим.
* Координаты glyf — Y вверх, база в нуле, поэтому контур
* масштабируется с инверсией Y.
*/
public void draw(Graphics2D g, String text, double x, double baselineY, double sizePt) {
CmapLookup c = cmap();
double px = x;
for (int i = 0; i < text.length(); ) {
int cp = text.codePointAt(i);
int gid = c.getGlyphId(cp);
GlyphData glyph = glyph(gid);
GeneralPath p = glyph == null ? null : glyph.getPath();
if (p != null) {
AffineTransform tr = AffineTransform.getTranslateInstance(px, baselineY);
tr.scale(sizePt / unitsPerEm(), -sizePt / unitsPerEm());
g.fill(p.createTransformedShape(tr));
}
px += advanceWidth(gid) * sizePt / unitsPerEm();
i += Character.charCount(cp);
}
}
private CmapLookup cmap() {
CmapLookup c = cmap;
if (c == null) {
try {
c = ttf.getUnicodeCmapLookup();
} catch (IOException e) {
throw broken(e);
}
cmap = c;
}
return c;
}
private GlyphData glyph(int gid) {
try {
return ttf.getGlyph().getGlyph(gid);
} catch (IOException e) {
throw broken(e);
}
}
private double advanceWidth(int gid) {
try {
return ttf.getAdvanceWidth(gid);
} catch (IOException e) {
throw broken(e);
}
}
private int unitsPerEm() {
try {
return ttf.getUnitsPerEm();
} catch (IOException e) {
throw broken(e);
}
}
private HorizontalHeaderTable hhea() {
try {
return ttf.getHorizontalHeader();
} catch (IOException e) {
throw broken(e);
}
}
private IllegalStateException broken(IOException e) {
return new IllegalStateException("Битый шрифт бандла: " + key, e);
}
}
@@ -2,6 +2,7 @@ package ru.pjandro.wordpdf.internal;
import ru.pjandro.wordpdf.fonts.BundledFontMapper;
import ru.pjandro.wordpdf.fonts.BundledFonts;
import ru.pjandro.wordpdf.fonts.GlyphFont;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
@@ -296,24 +297,26 @@ public final class GlyphCoverageNormalizer {
private static Coverage coverage(String family) {
Coverage c = COVERAGE.get(family);
if (c == null) {
c = new Coverage(BundledFonts.awtFont(family, BundledFonts.V_REGULAR));
c = new Coverage(GlyphFont.of(family, BundledFonts.V_REGULAR));
COVERAGE.put(family, c);
}
return c;
}
/**
* Покрытие одного семейства: {@code java.awt.Font.canDisplay} с кэшем
* «проверенных» кодов. AWT берётся вместо {@code GlyphCheck}, чтобы не
* плодить INFO-лог на каждый отсутствующий глиф.
* Покрытие одного семейства: {@link GlyphFont#canDisplay} (fontbox,
* cmap) с кэшем «проверенных» кодов. GlyphFont вместо
* {@code java.awt.Font}, потому что AWT требует fontconfig на хосте
* (OpenJDK/Linux), а docx4j {@code GlyphCheck} плодит INFO-лог на
* каждый отсутствующий глиф.
*/
private static final class Coverage {
private final java.awt.Font font;
private final GlyphFont font;
private final java.util.BitSet checked = new java.util.BitSet();
private final java.util.BitSet covered = new java.util.BitSet();
Coverage(java.awt.Font font) {
Coverage(GlyphFont font) {
this.font = font;
}
@@ -44,7 +44,7 @@ final class CartesianPainter {
// 1. Поля под подписи осей
double catGutter = 0;
if (!cats.isEmpty()) {
catGutter = DrawMlText.textHeight(catStyle, g.getFontRenderContext());
catGutter = DrawMlText.textHeight(catStyle);
}
catGutter += 6; // auto-layout Word: отступ от подписей до области (Word-эмпирика)
@@ -54,7 +54,7 @@ final class CartesianPainter {
// а не 1 (0…5). Явные c:majorUnit/c:max не трогаем.
if (valStyle != null && !valAxis.deleted
&& valAxis.majorUnit == null && valAxis.max == null) {
double labelH = DrawMlText.textHeight(valStyle, g.getFontRenderContext());
double labelH = DrawMlText.textHeight(valStyle);
double axisLen = Math.max(10,
(horizontal ? box.getWidth() : box.getHeight()) - catGutter);
while (hi - lo > unit && axisLen / ((hi - lo) / unit) < 2.5 * labelH) {
@@ -70,7 +70,7 @@ final class CartesianPainter {
}
double valGutter = 0;
for (String l : valLabels) {
valGutter = Math.max(valGutter, DrawMlText.textWidth(l, valStyle, g.getFontRenderContext()));
valGutter = Math.max(valGutter, DrawMlText.textWidth(l, valStyle));
}
valGutter += 8; // auto-layout Word: отступ от подписей до области (Word-эмпирика)
@@ -149,7 +149,7 @@ final class CartesianPainter {
return;
}
double n = cats.size();
double h = DrawMlText.textHeight(style, g.getFontRenderContext()) + 2;
double h = DrawMlText.textHeight(style) + 2;
for (int i = 0; i < n; i++) {
String label = cats.get(i);
if (label.isEmpty()) {
@@ -162,7 +162,7 @@ final class CartesianPainter {
"r", "ctr", 1.0);
} else {
double cx = plot.getX() + plot.getWidth() * (i + 0.5) / n;
double w = DrawMlText.textWidth(label, style, g.getFontRenderContext());
double w = DrawMlText.textWidth(label, style);
double slot = plot.getWidth() / n;
// Word прячет подписи, которые не помещаются в слот
if (w > slot * 1.15) {
@@ -182,11 +182,11 @@ final class CartesianPainter {
if (style == null) {
return;
}
double h = DrawMlText.textHeight(style, g.getFontRenderContext()) + 2;
double h = DrawMlText.textHeight(style) + 2;
double span = hi - lo;
for (int i = 0; i < labels.size(); i++) {
double t = span == 0 ? 0 : i / (double) (labels.size() - 1);
double w = DrawMlText.textWidth(labels.get(i), style, g.getFontRenderContext());
double w = DrawMlText.textWidth(labels.get(i), style);
if (horizontal) {
double x = plot.getX() + t * plot.getWidth();
DrawMlText.paint(g, List.of(new DrawMlText.Paragraph(labels.get(i), style, "ctr")),
@@ -59,7 +59,7 @@ final class ChartRenderer {
box = new Rectangle2D.Double(box.getX(), box.getY() + titleH,
box.getWidth(), box.getHeight() - titleH);
Legend legend = measureLegend(g, spec, palette);
Legend legend = measureLegend(spec, palette);
double legendH = legend == null ? 0 : legend.height;
if (legend != null && "b".equals(spec.legendPos)) {
legend.draw(g, box.getX(), box.getY() + box.getHeight() - legendH,
@@ -105,8 +105,8 @@ final class ChartRenderer {
if (spec.title == null || spec.titleStyle == null) {
return 0;
}
double lineH = DrawMlText.textHeight(spec.titleStyle, g.getFontRenderContext());
double width = DrawMlText.textWidth(spec.title, spec.titleStyle, g.getFontRenderContext());
double lineH = DrawMlText.textHeight(spec.titleStyle);
double width = DrawMlText.textWidth(spec.title, spec.titleStyle);
double height = lineH + 4;
if (width > box.getWidth()) {
DrawMlText.paint(g, List.of(new Paragraph(spec.title, spec.titleStyle, "ctr")),
@@ -152,7 +152,7 @@ final class ChartRenderer {
g.fill(new Rectangle2D.Double(startX, midY - square / 2.0, square, square));
startX += square + 3;
}
double tw = DrawMlText.textWidth(e.label(), style, g.getFontRenderContext());
double tw = DrawMlText.textWidth(e.label(), style);
DrawMlText.paint(g, List.of(new Paragraph(e.label(), style, "l")),
new Rectangle2D.Double(startX, y, tw, height), "l", "ctr", 1.0);
startX += tw + 8;
@@ -160,7 +160,7 @@ final class ChartRenderer {
}
}
private static Legend measureLegend(Graphics2D g, ChartSpec spec, List<Color> palette) {
private static Legend measureLegend(ChartSpec spec, List<Color> palette) {
if (spec.legendPos == null) {
return null;
}
@@ -232,11 +232,11 @@ final class ChartRenderer {
double width = 0;
for (Legend.Entry e : legend.entries) {
double marker = e.lineWidth() > 0 ? legend.lineLen : legend.square;
width += marker + 3 + DrawMlText.textWidth(e.label(), style, g.getFontRenderContext()) + 8;
width += marker + 3 + DrawMlText.textWidth(e.label(), style) + 8;
}
legend.totalWidth = width;
legend.height = Math.max(Math.max(legend.square, legend.lineLen * 0.2),
DrawMlText.textHeight(style, g.getFontRenderContext())) + 4;
DrawMlText.textHeight(style)) + 4;
return legend;
}
@@ -9,11 +9,10 @@ import org.docx4j.dml.TextFont;
import ru.pjandro.wordpdf.fonts.BundledFontMapper;
import ru.pjandro.wordpdf.fonts.BundledFonts;
import ru.pjandro.wordpdf.fonts.GlyphFont;
import java.awt.Color;
import java.awt.Font;
import java.awt.Graphics2D;
import java.awt.font.FontRenderContext;
import java.awt.font.TextLayout;
import java.awt.geom.Rectangle2D;
import java.util.ArrayList;
import java.util.List;
@@ -138,18 +137,32 @@ final class DrawMlText {
return BundledFontMapper.bundledFamily(name != null ? name : fallbackFam);
}
/** java.awt.Font для стиля; null -> логический SansSerif. */
static Font fontFor(Style style) {
/**
* Шрифт бандла ({@link GlyphFont}, без java.awt.Font — рантайму
* не нужен fontconfig) для стиля. Цепочка фолбэка: запрошенное
* начертание -> regular того же семейства -> fallback-семейство
* (dejavu sans имеет все четыре начертания, поэтому null не
* возвращается никогда). Нераспознанное семейство -> sans-фолбэк,
* как раньше. Отличие от AWT-варианта: bold/italic у семейства
* только с regular (Noto) рисуется своим regular, а не логическим
* SansSerif — начертание остаётся в своём семействе.
*/
static GlyphFont fontFor(Style style) {
String variant = style.bold() && style.italic() ? BundledFonts.V_BOLD_ITALIC
: style.bold() ? BundledFonts.V_BOLD
: style.italic() ? BundledFonts.V_ITALIC
: BundledFonts.V_REGULAR;
Font base = BundledFonts.awtFont(style.family(), variant);
int flags = (style.bold() ? Font.BOLD : 0) | (style.italic() ? Font.ITALIC : 0);
if (base == null) {
return new Font(Font.SANS_SERIF, flags, 1).deriveFont((float) style.sizePt());
GlyphFont f = GlyphFont.of(style.family(), variant);
if (f == null) {
f = GlyphFont.of(style.family(), BundledFonts.V_REGULAR);
}
return base.deriveFont((float) style.sizePt());
if (f == null) {
f = GlyphFont.of(BundledFonts.FALLBACK_FAMILY, variant);
}
if (f == null) {
f = GlyphFont.of(BundledFonts.FALLBACK_FAMILY, BundledFonts.V_REGULAR);
}
return f;
}
/**
@@ -162,21 +175,20 @@ final class DrawMlText {
if (paragraphs.isEmpty()) {
return;
}
FontRenderContext frc = g.getFontRenderContext();
record Line(String text, Style style, String align, double width, double height,
double ascent) {
}
List<Line> lines = new ArrayList<>();
double totalHeight = 0;
for (Paragraph p : paragraphs) {
Font f = fontFor(p.style());
TextLayout metrics = new TextLayout("Xg", f, frc);
double lineH = (metrics.getAscent() + metrics.getDescent()
+ metrics.getLeading()) * lineHeightFactor;
for (String line : wrapLines(p.text(), f, frc, box.getWidth())) {
double w = new TextLayout(line, f, frc).getAdvance();
lines.add(new Line(line, p.style(), p.align(), w, lineH,
metrics.getAscent() * lineHeightFactor));
GlyphFont f = fontFor(p.style());
double sizePt = p.style().sizePt();
double lineH = (f.ascent(sizePt) + f.descent(sizePt)
+ f.leading(sizePt)) * lineHeightFactor;
for (String line : wrapLines(p.text(), f, sizePt, box.getWidth())) {
lines.add(new Line(line, p.style(), p.align(),
f.advance(line, sizePt), lineH,
f.ascent(sizePt) * lineHeightFactor));
totalHeight += lineH;
}
}
@@ -188,7 +200,6 @@ final class DrawMlText {
}
y = Math.max(box.getY(), y);
for (Line line : lines) {
g.setFont(fontFor(line.style()));
g.setColor(line.style().color());
double x = box.getX();
String align = line.align() != null ? line.align() : defAlign;
@@ -197,13 +208,14 @@ final class DrawMlText {
} else if ("r".equals(align) || "far".equals(align)) {
x += box.getWidth() - line.width();
}
g.drawString(line.text(), (float) x, (float) (y + line.ascent()));
fontFor(line.style()).draw(g, line.text(), x, y + line.ascent(),
line.style().sizePt());
y += line.height();
}
}
/** Жадный перенос по пробелам; длинные слова режутся по символам. */
private static List<String> wrapLines(String text, Font f, FontRenderContext frc,
private static List<String> wrapLines(String text, GlyphFont f, double sizePt,
double maxWidth) {
List<String> out = new ArrayList<>();
double limit = Math.max(1, maxWidth);
@@ -219,7 +231,7 @@ final class DrawMlText {
continue;
}
String candidate = cur.length() == 0 ? word : cur + " " + word;
double w = new TextLayout(candidate, f, frc).getAdvance();
double w = f.advance(candidate, sizePt);
if (w <= limit || cur.length() == 0) {
cur.setLength(0);
cur.append(candidate);
@@ -228,16 +240,15 @@ final class DrawMlText {
out.add(cur.toString());
cur.setLength(0);
cur.append(word);
curWidth = new TextLayout(word, f, frc).getAdvance();
curWidth = f.advance(word, sizePt);
while (curWidth > limit && cur.length() > 1) {
int cut = cur.length() - 1;
while (cut > 1 && new TextLayout(cur.substring(0, cut), f, frc)
.getAdvance() > limit) {
while (cut > 1 && f.advance(cur.substring(0, cut), sizePt) > limit) {
cut--;
}
out.add(cur.substring(0, cut));
cur.delete(0, cut);
curWidth = new TextLayout(cur.toString(), f, frc).getAdvance();
curWidth = f.advance(cur.toString(), sizePt);
}
}
if (cur.length() > 0) {
@@ -248,14 +259,14 @@ final class DrawMlText {
}
/** Ширина строки в тех же единицах, что и размер шрифта. */
static double textWidth(String text, Style style, FontRenderContext frc) {
return new TextLayout(text, fontFor(style), frc).getAdvance();
static double textWidth(String text, Style style) {
return fontFor(style).advance(text, style.sizePt());
}
/** Высота строки (ascent+descent+leading) для стиля. */
static double textHeight(Style style, FontRenderContext frc) {
Font f = fontFor(style);
TextLayout tl = new TextLayout("Xpg", f, frc);
return tl.getAscent() + tl.getDescent() + tl.getLeading();
static double textHeight(Style style) {
GlyphFont f = fontFor(style);
return f.ascent(style.sizePt()) + f.descent(style.sizePt())
+ f.leading(style.sizePt());
}
}
@@ -264,7 +264,7 @@ final class SmartArtRenderer {
for (int attempt = 0; attempt < 4; attempt++) {
double needed = 0;
for (DrawMlText.Paragraph p : paragraphs) {
needed += DrawMlText.textHeight(p.style(), g.getFontRenderContext());
needed += DrawMlText.textHeight(p.style());
}
if (needed <= th || p0(paragraphs) <= 4) {
break;
@@ -439,7 +439,7 @@ final class Surface3dPainter {
// Ось значений: левый край дальней стенки
DrawMlText.Style vs = valAxis.labelStyle;
if (vs != null) {
double h = DrawMlText.textHeight(vs, g.getFontRenderContext()) + 2;
double h = DrawMlText.textHeight(vs) + 2;
int i = 0;
for (double v = lo; v <= hi + unit / 2; v += unit) {
if (i >= valueAnchors.size()) {
@@ -449,7 +449,7 @@ final class Surface3dPainter {
double x = n.x() * fit.scaleX() + fit.offX();
double y = n.y() * fit.scaleY() + fit.offY();
String label = ChartRenderer.formatValue(v, valAxis.numFmt);
double w = DrawMlText.textWidth(label, vs, g.getFontRenderContext());
double w = DrawMlText.textWidth(label, vs);
DrawMlText.paint(g, List.of(new DrawMlText.Paragraph(label, vs, "r")),
new Rectangle2D.Double(x - w - 4, y - h / 2, w, h), "r", "ctr", 1.0);
}
@@ -458,7 +458,7 @@ final class Surface3dPainter {
// Категории: переднее нижнее ребро пола
DrawMlText.Style cs = catAxis.labelStyle;
if (cs != null) {
double h = DrawMlText.textHeight(cs, g.getFontRenderContext()) + 2;
double h = DrawMlText.textHeight(cs) + 2;
for (int c = 0; c < nCat; c++) {
String label = c < spec.categories.size() ? spec.categories.get(c) : "";
if (label.isEmpty()) {
@@ -470,7 +470,7 @@ final class Surface3dPainter {
// (замер по эталону word-export.pdf, 300 dpi: центры подписей 669/714/
// 764/820 px при линии пола 606/651/700/757 px)
double y = n.y() * fit.scaleY() + fit.offY() + 8;
double w = DrawMlText.textWidth(label, cs, g.getFontRenderContext());
double w = DrawMlText.textWidth(label, cs);
DrawMlText.paint(g, List.of(new DrawMlText.Paragraph(label, cs, "ctr")),
new Rectangle2D.Double(x - w / 2, y, w, h), "ctr", "t", 1.0);
}
@@ -479,7 +479,7 @@ final class Surface3dPainter {
// Ряды: правое нижнее ребро пола
DrawMlText.Style ss = serAxis.labelStyle;
if (ss != null) {
double h = DrawMlText.textHeight(ss, g.getFontRenderContext()) + 2;
double h = DrawMlText.textHeight(ss) + 2;
for (int r = 0; r < nSer; r++) {
String label = spec.series.get(r).name;
if (label == null || label.isEmpty()) {
@@ -488,7 +488,7 @@ final class Surface3dPainter {
Node n = project(0.5, vOf(r, nSer), floorW, rotX, rotY, depthScale, persp);
double x = n.x() * fit.scaleX() + fit.offX() + 4;
double y = n.y() * fit.scaleY() + fit.offY();
double w = DrawMlText.textWidth(label, ss, g.getFontRenderContext());
double w = DrawMlText.textWidth(label, ss);
DrawMlText.paint(g, List.of(new DrawMlText.Paragraph(label, ss, "l")),
new Rectangle2D.Double(x, y - h / 2, w, h), "l", "ctr", 1.0);
}
@@ -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);
}
}