Správa specifických písem motivu pro skript v JavaScriptu

O čem je tato stránka

Prozkoumejte, přidejte, nahraďte a odstraňte specifická mapování písem podle skriptu v motivech PowerPointu pomocí Aspose.Slides pro Node.js.

Přehled

Prezentace může vybrat různé rodiny písem pro různé psací systémy. To umožňuje vícejazykový text, který stále používá písma motivu, aby sledoval jednotné schéma písem a zároveň používal vhodná písma pro cyriliku, arabštinu, japonštinu, gruzínštinu, thaana a další skripty.

Motiv obsahuje FontScheme, který má hlavní kolekci písem (obvykle pro nadpisy) a vedlejší kolekci písem (obvykle pro tělo textu). Kromě latinských a východoasijských nastavení písem obě kolekce poskytují mapování od značek psacích systémů k názvům rodin písem prostřednictvím třídy Fonts.

Tento článek ukazuje, jak prozkoumat a upravit tato mapování v hlavním motivu prezentace a ověřit, že změny přetrvají po uložení a znovu načtení.

Pochopení značek skriptů

Metody písma skriptů používají čtyřpísmenné BCP 47 podznačky skriptů k identifikaci psacích systémů. Časté hodnoty zahrnují:

Značka skriptu	Psací systém
`Cyrl`	Cyrilice
`Arab`	Arabština
`Hans`	Zjednodušená čínština
`Jpan`	Japonština
`Geor`	Gruzínština
`Thaa`	Thaana

Tato mapování patří k motivu písma, nikoli k jednotlivým částem textu. Prezentace může definovat odlišná mapování pro hlavní i vedlejší kolekci a může některé skripty vynechat.

Přístup a kontrola mapování písem skriptů

Použijte Presentation.getMasterTheme k získání motivu na úrovni prezentace. Metody FontScheme.getMajor a FontScheme.getMinor vrací dvě kolekce Fonts.

Zavolejte Fonts.getScriptFontMap pro získání všech mapování z kolekce. Pro vyhledání jednoho psacího systému zavolejte Fonts.getScriptFont s jeho značkou skriptu. getScriptFont vrací null, když daná kolekce neobsahuje požadované mapování.

Upravit mapování a ověřit trvalost

Použijte Fonts.setScriptFont k vytvoření mapování nebo k nahrazení aktuální rodiny písma. Použijte Fonts.removeScriptFont k odstranění mapování.

Následující end‑to‑end příklad přečte všechna existující hlavní a vedlejší mapování, vyhledá hlavní japonské písmo, změní hlavní cyrilické písmo, odstraní vedlejší mapování Thaana, uloží prezentaci a znovu ji otevře, aby ověřil obě změny. Aby byl krok odstraňování nezávislý na počátečním motivu, příklad nejprve vytvoří mapování Thaana pouze v případě, že ještě není definováno.

var aspose = aspose || {};
aspose.slides = require("aspose.slides.via.java");

var presentation = new aspose.slides.Presentation();
try {
    var fontScheme = presentation.getMasterTheme().getFontScheme();
    var majorFonts = fontScheme.getMajor();
    var minorFonts = fontScheme.getMinor();

    console.log("Existing major mappings:");
    var majorMappings = majorFonts.getScriptFontMap().iterator();
    while (majorMappings.hasNext()) {
        var mapping = majorMappings.next();
        console.log("  " + mapping.getKey() + ": " + mapping.getValue());
    }

    console.log("Existing minor mappings:");
    var minorMappings = minorFonts.getScriptFontMap().iterator();
    while (minorMappings.hasNext()) {
        var mapping = minorMappings.next();
        console.log("  " + mapping.getKey() + ": " + mapping.getValue());
    }

    var japaneseFont = majorFonts.getScriptFont("Jpan");
    if (japaneseFont == null) {
        console.log("No major Japanese font is defined.");
    } else {
        console.log("Major Japanese font: " + japaneseFont);
    }

    majorFonts.setScriptFont("Cyrl", "Arial");

    if (minorFonts.getScriptFont("Thaa") == null) {
        minorFonts.setScriptFont("Thaa", "Arial");
    }

    minorFonts.removeScriptFont("Thaa");
    presentation.save("script-font-mappings.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

var savedPresentation = new aspose.slides.Presentation("script-font-mappings.pptx");
try {
    var savedMajorFonts = savedPresentation.getMasterTheme().getFontScheme().getMajor();
    var savedMinorFonts = savedPresentation.getMasterTheme().getFontScheme().getMinor();
    var savedCyrillicFont = savedMajorFonts.getScriptFont("Cyrl");
    var savedThaanaFont = savedMinorFonts.getScriptFont("Thaa");

    if (savedCyrillicFont === "Arial") {
        console.log("The Cyrillic mapping was preserved.");
    } else {
        console.log("The Cyrillic mapping was not preserved.");
    }

    if (savedThaanaFont == null) {
        console.log("The Thaana mapping removal was preserved.");
    } else {
        console.log("The Thaana mapping still exists.");
    }
} finally {
    savedPresentation.dispose();
}

Ověření používá stejný chování null jako běžné vyhledávání: po uložení odstranění getScriptFont("Thaa") vrací null pro vedlejší kolekci.

Rozlišovat mapování motivu od ostatních nastavení písma

Mapování motivu specifická pro skript se podílí na výběru písma, ale řeší jiný problém než přímé formátování textu, substituce a fallback:

Mechanismus	Účel	Efekt změny mapování motivu
Mapování písma skriptu specifické pro motiv	Vybere hlavní nebo vedlejší motivové písmo pro psací systém.	Text, který stále používá odpovídající motivové písmo, může být převeden na novou mapovanou rodinu.
Písmo přiřazené explicitně k části textu	Fixuje požadovanou rodinu písma na této části místo spoleh na motiv.	Část může zůstat nezměněna, protože její přímé formátování přebije volbu motivu.
Substituce písma	Nahrazuje požadované písmo, když není dostupné nebo když platí pravidlo substituce.	Probíhá po požadavku na písmo; nepředefinuje mapování skriptu v motivu.
Fallback písma	Poskytuje glyfy, které vybrané písmo neobsahuje, často pro konkrétní rozsahy Unicode.	Doplňuje chybějící glyfy; nemění uložené mapování motivu.

Pro podrobnější informace o posledních dvou mechanismech viz Font Substitution a Fallback Fonts.

Změna mapování v Presentation.getMasterTheme ovlivní jen obsah, jehož efektivní formátování stále závisí na tomto motivu. Text může místo toho dědit přepsání motivu z masteru, layoutu nebo snímku, nebo použít explicitně přiřazené písmo. Prozkoumejte tyto úrovně, když viditelný výsledek neodpovídá mapování na úrovni prezentace.

Zajistit dostupnost mapovaných písem a ověřit výsledek

Mapování skriptu ukládá název rodiny písma; neinstaluje ani nenačítá odpovídající soubor písma. Pro konzistentní vykreslování a export musí být každé mapované písmo nainstalováno v prostředí nebo poskytnuto Aspose.Slides prostřednictvím vlastního zdroje, například pomocí FontsLoader.loadExternalFonts nebo LoadOptions.getDocumentLevelFontSources. Viz Custom Fonts pro dostupné možnosti načítání.

Ověření uloženého mapování potvrzuje pouze, že definice motivu byla zachována. Nepotvrzuje, že je písmo dostupné, obsahuje všechny potřebné glyfy nebo vytváří zamýšlené rozvržení. Vykreslete reprezentativní text pro každý požadovaný psací systém do obrázku nebo PDF a prohlédněte výstup. Tím zachytíte chybějící písma, neúplné pokrytí glyfů, chování fallbacku a změny rozvržení před distribucí prezentace. Viz Convert PowerPoint Presentations pro příklady vykreslování a exportu.

Často kladené otázky

Co vrací getScriptFont, když není skript mapován?

Fonts.getScriptFont vrací null, když požadované mapování skriptu není definováno v hlavní ani vedlejší kolekci písem.

Přidá setScriptFont druhou mapu, když skript již existuje?

Ne. Fonts.setScriptFont vytvoří mapování, pokud chybí, a nahradí mapovanou rodinu písma, když je značka skriptu již přítomna.

Proč změna mapování motivu neovlivnila část textu?

Text může mít explicitně přiřazené písmo, dědit jiný motiv skrze přepsání, nebo být ovlivněn substitucí či fallbackem během vykreslování. Mapování skriptu na úrovni prezentace kontroluje jen text, jehož efektivní formátování stále odkazuje na tuto kolekci motivových písem.

Je uložení a znovu otevření dostatečné k ověření vícejazykového výstupu?

Ne. Otevření znovu ověřuje trvalost dat motivu. Také je třeba vykreslit reprezentativní text z každého požadovaného psacího systému, aby se potvrdila dostupnost mapovaných písem a jejich obsah potřebných glyfů.

Spravovat motivy prezentace v JavaScriptu Správa pozadí prezentací v JavaScriptu