Kelola Font Tema Spesifik Skrip di Java

Tentang apa halaman ini

Periksa, tambahkan, ganti, dan hapus pemetaan font khusus skrip dalam tema PowerPoint dengan Aspose.Slides untuk Java.

Gambaran Umum

Tema presentasi dapat memilih keluarga font yang berbeda untuk sistem penulisan yang berbeda. Ini memungkinkan teks multibahasa yang masih menggunakan font tema mengikuti satu skema font terkoordinasi sambil menggunakan font yang cocok untuk Cyrillic, Arab, Jepang, Georgia, Thaana, dan skrip lainnya.

Tema IFontScheme berisi koleksi font utama, biasanya digunakan untuk judul, dan koleksi font sekunder, biasanya digunakan untuk teks tubuh. Selain pengaturan font Latin dan Asia Timur mereka, kedua koleksi tersebut mengekspos pemetaan dari tag sistem penulisan ke nama keluarga font melalui antarmuka IFonts.

Artikel ini menunjukkan cara memeriksa dan mengubah pemetaan tersebut dalam tema master presentasi dan memverifikasi bahwa perubahan bertahan melalui siklus simpan‑dan‑muat kembali.

Memahami Tag Skrip

Metode font skrip menggunakan sub‑tag skrip BCP 47 empat huruf untuk mengidentifikasi sistem penulisan. Nilai umum meliputi:

Tag skrip	Sistem penulisan
Cyrl	Cyrillic
Arab	Arab
Hans	Mandarin Sederhana
Jpan	Jepang
Geor	Georgia
Thaa	Thaana

Pemetaan ini milik skema font tema, bukan bagian teks individu. Presentasi dapat mendefinisikan pemetaan yang berbeda untuk koleksi utama dan sekunder, serta dapat menghilangkan pemetaan untuk beberapa skrip.

Akses dan Periksa Pemetaan Font Skrip

Gunakan Presentation.getMasterTheme untuk mengakses tema pada level presentasi. Metode IFontScheme.getMajor dan IFontScheme.getMinor mengembalikan dua koleksi IFonts.

Panggil IFonts.getScriptFontMap untuk mengambil semua pemetaan dari sebuah koleksi. Untuk mencari satu sistem penulisan, panggil IFonts.getScriptFont dengan tag skripnya. getScriptFont mengembalikan null ketika koleksi tersebut tidak mendefinisikan pemetaan yang diminta.

Ubah Pemetaan dan Verifikasi Persistensi

Gunakan IFonts.setScriptFont untuk membuat pemetaan atau mengganti keluarga fontnya saat ini. Gunakan IFonts.removeScriptFont untuk menghapus pemetaan.

Contoh end‑to‑end berikut membaca semua pemetaan utama dan sekunder yang ada, mencari font utama Jepang, mengubah font utama Cyrillic, menghapus pemetaan sekunder Thaana, menyimpan presentasi, dan membukanya kembali untuk memverifikasi kedua perubahan. Untuk membuat langkah penghapusan independen dari tema awal, contoh pertama membuat pemetaan Thaana hanya bila belum ada yang didefinisikan.

import com.aspose.slides.*;
import com.aspose.slides.Collections.Generic.Dictionary;
import com.aspose.slides.Collections.Generic.KeyValuePair;

Presentation presentation = new Presentation();
try {
    IFontScheme fontScheme = presentation.getMasterTheme().getFontScheme();
    IFonts majorFonts = fontScheme.getMajor();
    IFonts minorFonts = fontScheme.getMinor();

    System.out.println("Existing major mappings:");
    Dictionary.Enumerator<String, String> majorMappings = majorFonts.getScriptFontMap().iterator();
    while (majorMappings.hasNext()) {
        KeyValuePair<String, String> mapping = majorMappings.next();
        System.out.println("  " + mapping.getKey() + ": " + mapping.getValue());
    }

    System.out.println("Existing minor mappings:");
    Dictionary.Enumerator<String, String> minorMappings = minorFonts.getScriptFontMap().iterator();
    while (minorMappings.hasNext()) {
        KeyValuePair<String, String> mapping = minorMappings.next();
        System.out.println("  " + mapping.getKey() + ": " + mapping.getValue());
    }

    String japaneseFont = majorFonts.getScriptFont("Jpan");
    if (japaneseFont == null) {
        System.out.println("No major Japanese font is defined.");
    } else {
        System.out.println("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", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

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

    if ("Arial".equals(savedCyrillicFont)) {
        System.out.println("The Cyrillic mapping was preserved.");
    } else {
        System.out.println("The Cyrillic mapping was not preserved.");
    }

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

Verifikasi menggunakan perilaku null yang sama seperti pencarian biasa: setelah penghapusan disimpan, getScriptFont("Thaa") mengembalikan null untuk koleksi sekunder.

Membedakan Pemetaan Tema dari Pengaturan Font Lain

Pemetaan tema khusus skrip berpartisipasi dalam pemilihan font, tetapi mereka menyelesaikan masalah yang berbeda dari pemformatan teks langsung, substitusi, dan fallback:

Mekanisme	Tujuan	Efek mengubah pemetaan tema
Pemetaan font tema khusus skrip	Memilih font tema utama atau sekunder untuk suatu sistem penulisan.	Teks yang masih menggunakan font tema yang bersangkutan dapat beralih ke keluarga font yang baru dipetakan.
Font yang ditetapkan secara eksplisit pada bagian teks	Mengunci keluarga font yang diminta pada bagian tersebut alih‑alih mengandalkan tema.	Bagian tersebut mungkin tetap tidak berubah karena format langsungnya menimpa pilihan tema.
Substitusi font	Mengganti font yang diminta ketika font tersebut tidak tersedia atau ketika aturan substitusi berlaku.	Ini bekerja setelah font diminta; tidak mengubah kembali pemetaan skrip tema.
Fallback font	Menyediakan glyph yang tidak dimiliki font yang dipilih, biasanya untuk rentang Unicode tertentu.	Ini mengisi kekurangan glyph; tidak mengubah pemetaan tema yang disimpan.

Untuk informasi lebih lanjut tentang dua mekanisme terakhir, lihat Font Substitution dan Fallback Fonts.

Mengubah pemetaan di Presentation.getMasterTheme memengaruhi hanya konten yang format efektifnya masih bergantung pada tema tersebut. Teks dapat mewarisi penimpaan tema dari master, tata letak, atau slide, atau menggunakan font yang ditetapkan secara eksplisit. Periksa tingkat tersebut ketika hasil yang terlihat tidak mengikuti pemetaan level presentasi.

Sediakan Font yang Dipetakan dan Validasi Hasil

Pemetaan skrip menyimpan nama keluarga font; ia tidak menginstal atau memuat file font yang bersangkutan. Untuk rendering dan ekspor yang konsisten, setiap font yang dipetakan harus diinstal di lingkungan atau disediakan ke Aspose.Slides melalui sumber khusus seperti FontsLoader.loadExternalFonts atau LoadOptions.getDocumentLevelFontSources. Lihat Custom Fonts untuk opsi pemuatan yang tersedia.

Memverifikasi pemetaan yang disimpan hanya memastikan definisi tema tetap terjaga. Itu tidak membuktikan bahwa font tersedia, berisi semua glyph yang diperlukan, atau menghasilkan tata letak yang diinginkan. Render teks representatif untuk setiap sistem penulisan yang diperlukan ke dalam gambar atau PDF dan periksa outputnya. Ini menangkap font yang hilang, cakupan glyph yang tidak lengkap, perilaku fallback, dan perubahan tata letak sebelum presentasi didistribusikan. Lihat Convert PowerPoint Presentations untuk contoh rendering dan ekspor.

FAQ

Apa yang dikembalikan getScriptFont ketika sebuah skrip tidak dipetakan?

IFonts.getScriptFont mengembalikan null ketika pemetaan skrip yang diminta tidak didefinisikan dalam koleksi font utama atau sekunder tersebut.

Apakah setScriptFont menambahkan pemetaan kedua ketika skrip sudah ada?

Tidak. IFonts.setScriptFont membuat pemetaan jika belum ada dan mengganti keluarga font yang dipetakan ketika tag skrip yang sama sudah ada.

Mengapa mengubah pemetaan tema tidak mengubah beberapa teks?

Teks mungkin memiliki font yang ditetapkan secara eksplisit, mewarisi tema yang berbeda melalui penimpaan, atau terpengaruh oleh substitusi atau fallback saat rendering. Pemetaan skrip pada level presentasi hanya mengontrol teks yang format efektifnya masih merujuk pada koleksi font tema tersebut.

Apakah menyimpan dan membuka kembali cukup untuk memvalidasi output multibahasa?

Tidak. Membuka kembali hanya memverifikasi persistensi data tema. Selain itu, render teks representatif dari setiap sistem penulisan yang diperlukan untuk memastikan bahwa font yang dipetakan tersedia dan berisi glyph yang diperlukan.