fix(fonts): реальные начертания бандла в variant-form методах маппера (macOS) #114
@@ -16,6 +16,8 @@
|
||||
| 6 | `Docx4J.toFO(foSettings, os, FLAG_EXPORT_PREFER_XSL)` | XSL-FO → PDF |
|
||||
| 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)
|
||||
|
||||
Первая конвертация после старта 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 — точное имя из
|
||||
* документа: 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
|
||||
* запускает обнаружение системных шрифтов, которые могут занять те же
|
||||
* имена в реестре 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");
|
||||
});
|
||||
}
|
||||
|
||||
/**
|
||||
* Варианты начертаний отдаются реальным 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