From c09a3f5adfc2d8a70f20b278d0ff0dad0e18f7c9 Mon Sep 17 00:00:00 2001 From: Pjandro Date: Wed, 21 Oct 2026 19:06:28 +0000 Subject: [PATCH] =?UTF-8?q?feat:=20=D1=80=D0=B0=D0=BD=D1=82=D0=B0=D0=B9?= =?UTF-8?q?=D0=BC=20=D0=B1=D0=B5=D0=B7=20fontconfig=20=E2=80=94=20=D0=B3?= =?UTF-8?q?=D0=BB=D0=B8=D1=84-=D0=B4=D0=B2=D0=B8=D0=B6=D0=BE=D0=BA=20Glyph?= =?UTF-8?q?Font=20(fontbox)=20=D0=B2=D0=BC=D0=B5=D1=81=D1=82=D0=BE=20java.?= =?UTF-8?q?awt.Font?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit На 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 растрами (деградации нет). --- AGENTS.md | 11 +- Containerfile | 7 +- pom.xml | 24 +++ wordpdf-core/pom.xml | 13 ++ .../pjandro/wordpdf/fonts/BundledFonts.java | 34 +-- .../ru/pjandro/wordpdf/fonts/GlyphFont.java | 200 ++++++++++++++++++ .../internal/GlyphCoverageNormalizer.java | 15 +- .../internal/chart/CartesianPainter.java | 14 +- .../wordpdf/internal/chart/ChartRenderer.java | 14 +- .../wordpdf/internal/chart/DrawMlText.java | 77 ++++--- .../internal/chart/SmartArtRenderer.java | 2 +- .../internal/chart/Surface3dPainter.java | 12 +- .../pjandro/wordpdf/fonts/GlyphFontTest.java | 81 +++++++ 13 files changed, 405 insertions(+), 99 deletions(-) create mode 100644 wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/GlyphFont.java create mode 100644 wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/GlyphFontTest.java diff --git a/AGENTS.md b/AGENTS.md index 2fbf722..8e7a905 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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, переписывает и элементы ``; 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, переписывает и элементы ``; 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 — chart-движку нужен модуль java.desktop (Graphics2D); fontconfig и системные шрифты рантайму не нужны — текст рисуется глифами fontbox, см. `fonts/GlyphFont`; 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-стенда одновременно не поднять (общая подсеть)| |корневой `.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` (кэш `1` + 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`). diff --git a/Containerfile b/Containerfile index 5be33a9..2d1dd79 100644 --- a/Containerfile +++ b/Containerfile @@ -10,9 +10,10 @@ 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. +# curl — только для HEALTHCHECK; runtime полный jre (не alpine-slim): chart-движку +# нужен модуль java.desktop (Graphics2D); fontconfig и системные шрифты рантайму +# не нужны — текст рисуется глифами fontbox, см. fonts/GlyphFont. Тесты в образе +# не гоняем — гейт mvn clean verify. # Прокси-переменные хоста (HTTP_PROXY/HTTPS_PROXY/http_proxy/https_proxy) # podman/buildah подмешивает в шелл RUN/HEALTHCHECK и ломает curl # (127.0.0.1:proxy внутри контейнера недоступен) — обнуляем на команде. diff --git a/pom.xml b/pom.xml index 856c635..de28b58 100644 --- a/pom.xml +++ b/pom.xml @@ -74,16 +74,40 @@ slf4j-simple ${slf4j.version} + + + org.slf4j + jcl-over-slf4j + ${slf4j.version} + org.junit.jupiter junit-jupiter ${junit.version} + + org.apache.pdfbox + fontbox + ${pdfbox.version} + + + commons-logging + commons-logging + + + org.apache.pdfbox pdfbox ${pdfbox.version} + + + commons-logging + commons-logging + + diff --git a/wordpdf-core/pom.xml b/wordpdf-core/pom.xml index c6df595..1b79aac 100644 --- a/wordpdf-core/pom.xml +++ b/wordpdf-core/pom.xml @@ -36,6 +36,19 @@ org.slf4j slf4j-simple + + + org.apache.pdfbox + fontbox + + + + org.slf4j + jcl-over-slf4j + diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java index 7a60546..8e05620 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java @@ -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> VARIANTS = new HashMap<>(); - /** Ключ family/variant -> java.awt.Font (кэш, см. {@link #awtFont}). */ - private static final Map 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; - } - } } diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/GlyphFont.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/GlyphFont.java new file mode 100644 index 0000000..defa85a --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/GlyphFont.java @@ -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/}), а не из временного + * каталога {@link BundledFonts#init()} — поэтому класс не зависит от + * порядка шагов конвертации. TTF буферизуется в памяти и живёт до конца + * JVM (шрифты бандла конечны, {@link TrueTypeFont} намеренно не закрываем). + */ +public final class GlyphFont { + + /** Кэш распарсенных шрифтов: ключ — {@code family/variant}. */ + private static final Map 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); + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/GlyphCoverageNormalizer.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/GlyphCoverageNormalizer.java index 06ef49c..f617a76 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/GlyphCoverageNormalizer.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/GlyphCoverageNormalizer.java @@ -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; } diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/CartesianPainter.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/CartesianPainter.java index 01de4c0..ff1aa77 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/CartesianPainter.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/CartesianPainter.java @@ -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")), 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 e1a86fc..2ca996d 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 @@ -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 palette) { + private static Legend measureLegend(ChartSpec spec, List 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; } diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlText.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlText.java index 370a470..33c709d 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlText.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlText.java @@ -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 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 wrapLines(String text, Font f, FontRenderContext frc, + private static List wrapLines(String text, GlyphFont f, double sizePt, double maxWidth) { List 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()); } } diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/SmartArtRenderer.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/SmartArtRenderer.java index 8020e0b..e757f2e 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/SmartArtRenderer.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/SmartArtRenderer.java @@ -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; diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Surface3dPainter.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Surface3dPainter.java index 2b70bc3..c16acae 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Surface3dPainter.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/Surface3dPainter.java @@ -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); } diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/GlyphFontTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/GlyphFontTest.java new file mode 100644 index 0000000..ff713ec --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/GlyphFontTest.java @@ -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); + } +}