fix(fonts): реальные начертания бандла в getBoldForm/getItalicForm/getBoldItalicForm
PR checks / web (pull_request) Successful in 9s
PR checks / java (pull_request) Successful in 3m57s
Main: tests, deploy, autotests / web (push) Successful in 8s
Main: tests, deploy, autotests / java (push) Successful in 1m16s
Main: tests, deploy, autotests / images-web (push) Successful in 1m22s
Main: tests, deploy, autotests / images-app (push) Successful in 20s
Main: tests, deploy, autotests / deploy (push) Successful in 2m8s
Main: tests, deploy, autotests / autotests (push) Successful in 14s
Main: tests, deploy, autotests / rollback (push) Has been skipped
PR checks / web (pull_request) Successful in 9s
PR checks / java (pull_request) Successful in 3m57s
Main: tests, deploy, autotests / web (push) Successful in 8s
Main: tests, deploy, autotests / java (push) Successful in 1m16s
Main: tests, deploy, autotests / images-web (push) Successful in 1m22s
Main: tests, deploy, autotests / images-app (push) Successful in 20s
Main: tests, deploy, autotests / deploy (push) Successful in 2m8s
Main: tests, deploy, autotests / autotests (push) Successful in 14s
Main: tests, deploy, autotests / rollback (push) Has been skipped
На macOS PhysicalFonts.getBoldForm для имён бандл-шрифтов ('Tinos Regular',
'Carlito Regular', ...) уходит в MicrosoftFontsRegistry, где у этих записей
Mac-имя файла null, и возвращает null; docx4j строит simulate-style fopconf
(все начертания на regular-TTF), FOP теряет реальные Bold/Italic — метрики и
кернинг ломают переносы (strictOoxml: 'таблица' -> 'таблиц а').
BundledFontMapper переопределяет три variant-form метода: семейство опознаётся
по embeddedURI regular-варианта, начертание берётся реальным из бандла; вне
бандла / без init() — родительская логика без изменений.
Тест: BundledFontMapperTest#variantForms_resolveBundleSibling (красный на macOS
без override); регрессии: WordPdfConverterTest#strictOoxml_convertsNotRejected,
#ruPlain_regularRunsUseRegularFont (проверены под -Dos.name='Mac OS X').
docs/agent/pipeline.md: абзац о macOS-ветке.
This commit was merged in pull request #114.
This commit is contained in:
@@ -16,6 +16,8 @@
|
|||||||
| 6 | `Docx4J.toFO(foSettings, os, FLAG_EXPORT_PREFER_XSL)` | XSL-FO → PDF |
|
| 6 | `Docx4J.toFO(foSettings, os, FLAG_EXPORT_PREFER_XSL)` | XSL-FO → PDF |
|
||||||
| 7 | `finally` → `getFontTablePart().deleteEmbeddedFontTempFiles()` | В docx4j 17.x `OpcPackage.close()` нет — пакет в памяти |
|
| 7 | `finally` → `getFontTablePart().deleteEmbeddedFontTempFiles()` | В docx4j 17.x `OpcPackage.close()` нет — пакет в памяти |
|
||||||
|
|
||||||
|
`BundledFontMapper` переопределяет `getBoldForm`/`getItalicForm`/`getBoldItalicForm`: на macOS `PhysicalFonts.getBoldForm` для имён `Tinos Regular`/`Carlito Regular`/… уходит в `MicrosoftFontsRegistry` и возвращает `null` (у записей нет Mac-имени файла), из-за чего docx4j строил simulate-style fopconf — FOP терял реальные начертания и кернинг (регрессии `strictOoxml_convertsNotRejected`, `ruPlain_regularRunsUseRegularFont`). Override находит реальный вариант по `embeddedURI` regular-варианта.
|
||||||
|
|
||||||
### `warmup()` — прогрев ядра (шаги 0–7 на минимальном docx)
|
### `warmup()` — прогрев ядра (шаги 0–7 на минимальном docx)
|
||||||
|
|
||||||
Первая конвертация после старта JVM стоит 1,3–1,7 с (JAXB/XSLT/FOP/классы; замер 2026-11), её платил первый запрос после деплоя. Публичный `WordPdfConverter.warmup()` прогоняет шаги 0–7 на минимальном docx, собранном в байтах (три zip-части константами, фикстуры не задействованы; алиас Calibri→Carlito греет маппер и embed-подмножество), и греет Java2D/PNG-энкодер (`warmRaster()` — растер + `GlyphFont.draw` + `ImageIO.write`), иначе первый чартный документ платит ещё ~200 мс. Идемпотентен (`volatile warmedUp`, метод `synchronized`), никогда не бросает (провал — warn в JUL), артефакты отбрасываются; вызывать на потоке, сериализующем конвертации. Ядро само себя не зовёт: `wordpdf-app` ставит warmup головой очереди воркеров в конструкторе `ConversionService`. Прогретый первый конверт ru-plain.docx HTTP-запросом: 0,13 с против 1,74 с (A/B на одной машине, сборки ветки и `main`).
|
Первая конвертация после старта JVM стоит 1,3–1,7 с (JAXB/XSLT/FOP/классы; замер 2026-11), её платил первый запрос после деплоя. Публичный `WordPdfConverter.warmup()` прогоняет шаги 0–7 на минимальном docx, собранном в байтах (три zip-части константами, фикстуры не задействованы; алиас Calibri→Carlito греет маппер и embed-подмножество), и греет Java2D/PNG-энкодер (`warmRaster()` — растер + `GlyphFont.draw` + `ImageIO.write`), иначе первый чартный документ платит ещё ~200 мс. Идемпотентен (`volatile warmedUp`, метод `synchronized`), никогда не бросает (провал — warn в JUL), артефакты отбрасываются; вызывать на потоке, сериализующем конвертации. Ядро само себя не зовёт: `wordpdf-app` ставит warmup головой очереди воркеров в конструкторе `ConversionService`. Прогретый первый конверт ru-plain.docx HTTP-запросом: 0,13 с против 1,74 с (A/B на одной машине, сборки ветки и `main`).
|
||||||
|
|||||||
@@ -26,6 +26,17 @@ import java.util.Set;
|
|||||||
* файл для каждого начертания. Ключи register*Form — точное имя из
|
* файл для каждого начертания. Ключи register*Form — точное имя из
|
||||||
* документа: docx4j ищет варианты именно по нему.
|
* документа: docx4j ищет варианты именно по нему.
|
||||||
*
|
*
|
||||||
|
* ВАЖНО (macOS): {@code PhysicalFonts.getBoldForm} для имён бандл-шрифтов
|
||||||
|
* ({@code Tinos Regular}, {@code Carlito Regular}, …) на macOS уходит в
|
||||||
|
* {@code MicrosoftFontsRegistry} и возвращает {@code null} — у этих записей
|
||||||
|
* нет Mac-имени файла. docx4j тогда строит simulate-style fopconf (все
|
||||||
|
* начертания на regular-TTF), и FOP теряет реальные Bold/Italic: другие
|
||||||
|
* метрики и кернинг ломают переносы в узких ячейках (регрессии —
|
||||||
|
* {@code WordPdfConverterTest#strictOoxml_convertsNotRejected},
|
||||||
|
* {@code #ruPlain_regularRunsUseRegularFont}). Override-ы
|
||||||
|
* {@code getBoldForm}/{@code getItalicForm}/{@code getBoldItalicForm}
|
||||||
|
* отдают реальные бандл-варианты.
|
||||||
|
*
|
||||||
* ВАЖНО (порядок инициализации): конструктор BestMatchingMapper
|
* ВАЖНО (порядок инициализации): конструктор BestMatchingMapper
|
||||||
* запускает обнаружение системных шрифтов, которые могут занять те же
|
* запускает обнаружение системных шрифтов, которые могут занять те же
|
||||||
* имена в реестре docx4j. Поэтому {@code BundledFonts.init()} нужно
|
* имена в реестре docx4j. Поэтому {@code BundledFonts.init()} нужно
|
||||||
@@ -86,6 +97,51 @@ public class BundledFontMapper extends BestMatchingMapper {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/** Начертание бандла вместо registry-эвристики: см. «ВАЖНО (macOS)» в javadoc класса. */
|
||||||
|
@Override
|
||||||
|
public PhysicalFont getBoldForm(String fontName, PhysicalFont physicalFont) {
|
||||||
|
PhysicalFont bundled = bundledSibling(physicalFont, BundledFonts.V_BOLD);
|
||||||
|
return bundled != null ? bundled : super.getBoldForm(fontName, physicalFont);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Начертание бандла вместо registry-эвристики: см. «ВАЖНО (macOS)» в javadoc класса. */
|
||||||
|
@Override
|
||||||
|
public PhysicalFont getItalicForm(String fontName, PhysicalFont physicalFont) {
|
||||||
|
PhysicalFont bundled = bundledSibling(physicalFont, BundledFonts.V_ITALIC);
|
||||||
|
return bundled != null ? bundled : super.getItalicForm(fontName, physicalFont);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Начертание бандла вместо registry-эвристики: см. «ВАЖНО (macOS)» в javadoc класса. */
|
||||||
|
@Override
|
||||||
|
public PhysicalFont getBoldItalicForm(String fontName, PhysicalFont physicalFont) {
|
||||||
|
PhysicalFont bundled = bundledSibling(physicalFont, BundledFonts.V_BOLD_ITALIC);
|
||||||
|
return bundled != null ? bundled : super.getBoldItalicForm(fontName, physicalFont);
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Реальное начертание бандл-семейства, к которому относится {@code pf}.
|
||||||
|
*
|
||||||
|
* <p>Семейство опознаётся по {@code embeddedURI} regular-варианта, а не
|
||||||
|
* по имени: на macOS имя в реестре docx4j — полное из TTF-таблицы
|
||||||
|
* ({@code Tinos Regular}), и именно на нём ломается
|
||||||
|
* {@code PhysicalFonts.getBoldForm}. Шрифт вне бандла (или {@code pf ==
|
||||||
|
* null}, {@code BundledFonts.init()} не вызван) → {@code null}, вызывающий
|
||||||
|
* идёт родительской логикой.</p>
|
||||||
|
*/
|
||||||
|
private static PhysicalFont bundledSibling(PhysicalFont pf, String variant) {
|
||||||
|
if (pf == null || pf.getEmbeddedURI() == null) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
String uri = pf.getEmbeddedURI().toString();
|
||||||
|
for (String family : BundledFonts.families()) {
|
||||||
|
PhysicalFont regular = BundledFonts.regular(family);
|
||||||
|
if (regular != null && uri.equals(regular.getEmbeddedURI().toString())) {
|
||||||
|
return BundledFonts.font(family, variant);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Привязывает все начертания семейства к имени шрифта из документа.
|
* Привязывает все начертания семейства к имени шрифта из документа.
|
||||||
*/
|
*/
|
||||||
|
|||||||
@@ -99,4 +99,31 @@ class BundledFontMapperTest {
|
|||||||
"без init() алиасованный шрифт не должен попасть и в fallback");
|
"без init() алиасованный шрифт не должен попасть и в fallback");
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Варианты начертаний отдаются реальным sibling-файлом бандла, а не
|
||||||
|
* результатом registry-эвристики: на macOS без override
|
||||||
|
* {@code PhysicalFonts.getBoldForm} для «Carlito Regular» уходит в
|
||||||
|
* {@code MicrosoftFontsRegistry} (Mac-имя файла {@code null}) и возвращает
|
||||||
|
* {@code null} — на этой платформе тест красный. На Linux super тоже
|
||||||
|
* находит bold, поэтому сквозная регрессия macOS — конвертерные тесты
|
||||||
|
* {@code WordPdfConverterTest#strictOoxml_convertsNotRejected} и
|
||||||
|
* {@code #ruPlain_regularRunsUseRegularFont}, а этот фиксирует контракт
|
||||||
|
* маппера.
|
||||||
|
*/
|
||||||
|
@Test
|
||||||
|
void variantForms_resolveBundleSibling() {
|
||||||
|
BundledFonts.init();
|
||||||
|
BundledFontMapper mapper = new BundledFontMapper();
|
||||||
|
PhysicalFont regular = BundledFonts.regular("carlito");
|
||||||
|
|
||||||
|
assertSame(BundledFonts.bold("carlito"),
|
||||||
|
mapper.getBoldForm("Carlito Regular", regular), "bold-вариант");
|
||||||
|
assertSame(BundledFonts.italic("carlito"),
|
||||||
|
mapper.getItalicForm("Carlito Regular", regular), "italic-вариант");
|
||||||
|
assertSame(BundledFonts.boldItalic("carlito"),
|
||||||
|
mapper.getBoldItalicForm("Carlito Regular", regular), "bolditalic-вариант");
|
||||||
|
assertNull(mapper.getBoldForm("Unknown", null),
|
||||||
|
"путь super без physicalFont не должен падать");
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
Reference in New Issue
Block a user