پیکربندی جایگزینی قلم در ارائه‌ها با استفاده از JavaScript

این صفحه درباره چیست

قوانین جایگزینی قلم را پیکربندی کنید و قلم‌های جایگزین‌شده را در Aspose.Slides برای Node.js از طریق Java هنگام رندر یا تبدیل ارائه‌های PowerPoint و OpenDocument بررسی کنید.

بررسی کلی

جایگزینی قلم (Font substitution) به Aspose.Slides اجازه می‌دهد که به‌جای قلم‌ای که در هنگام رندر یا تبدیل ارائه دسترسی‌پذیر نیست، از قلم موجود استفاده کند. این جایگزینی فقط بر خروجی رندر شده تأثیر می‌گذارد؛ قلم اختصاص‌یافته به محتوای ارائه تغییر نمی‌کند.

شما می‌توانید قلمی را که هنگام عدم دسترسی به یک قلم خاص استفاده می‌شود تعریف کنید و می‌توانید جایگزینی‌هایی را که Aspose.Slides در حین رندر انجام می‌دهد بررسی کنید. این کار به حفظ یکنواختی خروجی در محیط‌هایی با قلم‌های نصب‌شده متفاوت کمک می‌کند.

دریافت جایگزینی‌های قلم

از روش FontsManager.getSubstitutions برای تعیین اینکه کدام قلم‌ها هنگام رندر ارائه جایگزین می‌شوند استفاده کنید. این روش اشیاء FontSubstitutionInfo را برمی‌گرداند که نام قلم اصلی و قلم جایگزین را شناسایی می‌کند.

مثال زیر به‌زبان JavaScript تمام جایگزینی‌های قلم برای یک ارائه را فهرست می‌کند:

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

var presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    var substitutions = presentation.getFontsManager().getSubstitutions().iterator();
    while (substitutions.hasNext()) {
        var substitution = substitutions.next();
        console.log(substitution.getOriginalFontName() + " -> " + substitution.getSubstitutedFontName());
    }
} finally {
    presentation.dispose();
}

دریافت جایگزینی‌های قلم برای اسلایدهای انتخابی

از بارگذاری ‎FontsManager.getSubstitutions با آرایه‌ای از اندیس‌های اسلاید برای بررسی تنها جایگزینی‌های لازم برای رندر اسلایدهای خاص استفاده کنید. این کار زمانی مفید است که بخواهید بخشی از یک ارائه را رندر یا صادرات کنید، ارائهٔ بزرگ را به‌صورت تدریجی بررسی کنید، اسلایدهایی را که به قلم‌های غیرقابل دسترس وابسته‌اند پیدا کنید، بستهٔ قلم‌های حداقلی برای سرور یا کانتینر تهیه کنید یا تفاوت‌های رندر را بدون پردازش اسلایدهای نامرتبط تشخیص دهید.

این بارگذاری انتظار یک ‎int[]‎ اولیهٔ جاوا را دارد. آن را با ‎java.newArray("int", [...])‎ بسازید؛ یک آرایهٔ سادهٔ JavaScript به ‎Integer[]‎ تبدیل می‌شود و با این بارگذاری مطابقت ندارد.

آرایه شامل اندیس‌های اسلاید با شمارش یک‌پایه است: ‎1‎ اسلاید اول را شناسایی می‌کند. برعکس، دسترسی‌کنندهٔ مجموعهٔ Presentation.getSlides از شمارش صفرپایه استفاده می‌کند، بنابراین همان اسلاید به‌صورت ‎presentation.getSlides().get_Item(0)‎ دسترسی‌پذیر است. هنگام ساختن آرایه این تفاوت را در نظر بگیرید تا از خطای یک‑واحدی جلوگیری کنید.

بارگذاری را از طریق Presentation.getFontsManager صدا بزنید. این فقط جایگزینی‌هایی را که هنگام رندر اسلایدهای انتخابی تعیین شده‌اند برمی‌گرداند. هر نتیجه یک شیء FontSubstitutionInfo است که شامل نام‌های قلم اصلی و جایگزین می‌باشد. نتیجه بازتاب‌دهندهٔ محیط قلم فعلی، قوانین fallback پیکربندی‌شده، قوانین جایگزینی ذخیره‌شده در یک ‎FontSubstRuleCollection‎ و ‎قلم‌های بارگذاری‌شدهٔ خارجی‎ است.

یک جایگزینی ممکن است برای بیش از یک اسلاید انتخابی لازم باشد. هنگام ایجاد فهرست موجودی قلم یا گزارش پیش‌پروازی، نتایج را بدون تکرار کنید. مثال زیر هر جایگزینی برگردانده‌شده را گزارش می‌کند و سپس فهرست مرتب‌ شده‌ای از نگاشت‌های قلم یکتا ایجاد می‌نماید:

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

var presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    var selectedSlides = java.newArray("int", [1, 3, 5]);
    var substitutions = [];
    var substitutionIterator = presentation.getFontsManager().getSubstitutions(selectedSlides).iterator();
    while (substitutionIterator.hasNext()) {
        substitutions.push(substitutionIterator.next());
    }

    console.log("Substitutions for the selected slides:");
    substitutions.forEach(function (substitution) {
        console.log(substitution.getOriginalFontName() + " -> " + substitution.getSubstitutedFontName());
    });

    var preflightEntries = substitutions.map(function (substitution) {
        return substitution.getOriginalFontName() + " -> " + substitution.getSubstitutedFontName();
    });
    var sortedPreflightEntries = Array.from(new Set(preflightEntries)).sort(function (first, second) {
        return first.localeCompare(second, undefined, { sensitivity: "base" });
    });

    console.log("Deduplicated font preflight report:");
    sortedPreflightEntries.forEach(function (entry) {
        console.log(entry);
    });
} finally {
    presentation.dispose();
}

کلاس FontsManager هر دو بارگذاری را فراهم می‌کند. بر حسب دامنهٔ عملیات رندر، یکی را انتخاب کنید:

بارگذاری	زمان استفاده
getSubstitutions بدون آرگومان	نیاز به جایگزینی برای کل ارائه دارید.
getSubstitutions با ‎`int[]`‎ جاوا شامل اندیس‌های اسلاید	نیاز به جایگزینی برای بازهٔ انتخابی، بررسی تدریجی یا صادرات جزئی دارید.

تنظیم قوانین جایگزینی قلم

برای مشخص کردن قلمی که Aspose.Slides باید وقتی قلم منبع در دسترس نیست استفاده کند:

ارائه را بارگذاری کنید.
تعریف‌های قلم برای قلم منبع و قلم جایگزین ایجاد کنید.
یک ‎FontSubstRule‎ با شرط ‎WhenInaccessible‎ ایجاد کنید.
قانون را به یک ‎FontSubstRuleCollection‎ اضافه کنید.
مجموعه را با استفاده از روش ‎FontsManager.setFontSubstRuleList‎ اختصاص دهید.
ارائه را رندر یا تبدیل کنید.

مثال زیر به‌زبان JavaScript، وقتی ‎SomeRareFont‎ در دسترس نیست، ‎Arial‎ را به‌جای آن جایگزین می‌کند و سپس اولین اسلاید را برای تأیید نتیجه رندر می‌کند. قلم جایگزین باید برای Aspose.Slides قابل دسترس باشد.

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

var presentation = new aspose.slides.Presentation("presentation.pptx");
try {
    var sourceFont = new aspose.slides.FontData("SomeRareFont");
    var substituteFont = new aspose.slides.FontData("Arial");
    var substitutionRule = new aspose.slides.FontSubstRule(sourceFont, substituteFont, aspose.slides.FontSubstCondition.WhenInaccessible);

    var substitutionRules = new aspose.slides.FontSubstRuleCollection();
    substitutionRules.add(substitutionRule);
    presentation.getFontsManager().setFontSubstRuleList(substitutionRules);

    var image = presentation.getSlides().get_Item(0).getImage(1.0, 1.0);
    try {
        image.save("slide.jpg", aspose.slides.ImageFormat.Jpeg);
    } finally {
        image.dispose();
    }
} finally {
    presentation.dispose();
}

Note

برای تغییر بی‌قید و شرط قلم‌های استفاده‌شده در سراسر یک ارائه، به ‎جایگزینی قلم‎ مراجعه کنید.

محدودیت‌ها برای قلم‌های معادلات ریاضی

قوانین جایگزینی قلم جزو فرآیند استاندارد انتخاب قلم استفاده‌شده در حین رندر و تبدیل هستند. آن‌ها برای متن معمولی کار می‌کنند وقتی Aspose.Slides می‌تواند قلم غیرقابل دسترس را با قلم موجود تعیین‌شده در یک قانون جایگزین کند.

معادلات Office Math نیازمندی اضافی دارند. اگر یک معادله از ‎Cambria Math‎ استفاده کند، Aspose.Slides ممکن است برای محاسبه و رندر چیدمان معادله به دقیقاً همان قلم نیاز داشته باشد. قانونی که قلم ریاضی دیگری مانند ‎STIX Two Math‎ را جایگزین می‌کند، نمی‌تواند ‎Cambria Math‎ را برای این منظور جایگزین کند و رندر ممکن است همچنان گزارش دهد که ‎Cambria Math‎ لازم است.

برای رندر یا تبدیل چنین ارائه‌ای، ‎Cambria Math‎ را در دسترس Aspose.Slides قرار دهید. آن را در سیستم عامل نصب کنید یا به‌عنوان یک ‎قلم خارجی‎ بارگذاری کنید.

این محدودیت فقط بر چیدمان معادله اعمال می‌شود. قوانین جایگزینی توصیف‌شده در بالا همچنان برای متن معمولی ارائه معتبر هستند.

سوالات متداول

تفاوت جایگزینی قلم و جایگزینی کامل قلم چیست؟

جایگزینی قلم به‌طور عمدی یک قلم را در سراسر ارائه با قلم دیگری تغییر می‌دهد. جایگزینی قلم قلمی برای خروجی رندر شده انتخاب می‌کند وقتی شرط پیکربندی‌شده برآورده شود، مثلاً وقتی قلم اصلی در دسترس نباشد.

قوانین جایگزینی چه زمانی اعمال می‌شوند؟

قوانین در ‎دنبالهٔ انتخاب قلم‎ در طول رندر و تبدیل شرکت می‌کنند. با ‎WhenInaccessible‎، قانون فقط وقتی استفاده می‌شود که Aspose.Slides نتواند به قلم منبع دسترسی پیدا کند.

اگر قلمی موجود نباشد و هیچ قانونی برای جایگزینی تعریف نشده باشد چه می‌شود؟

Aspose.Slides نزدیک‌ترین قلم موجود را بر اساس فرآیند انتخاب قلم خود انتخاب می‌کند. نتیجه به قلم‌های موجود در محیط زمان اجرا بستگی دارد.

آیا می‌توانم قلم‌های خارجی را بارگذاری کنم تا از جایگزینی جلوگیری کنم؟

بله. می‌توانید ‎قلم‌های خارجی را بارگذاری‎ کنید تا Aspose.Slides در حین رندر و تبدیل از آن‌ها استفاده کند.

آیا Aspose قلم‌ها را همراه کتابخانه توزیع می‌کند؟

خیر. مسئولیت تهیهٔ قلم‌ها و رعایت مجوزهای آن‌ها بر عهدهٔ شماست.

آیا نتایج جایگزینی می‌توانند بین ویندوز، لینوکس و macOS متفاوت باشند؟

بله. قلم‌های نصب‌شده و مکان‌های جستجوی قلم توسط سیستم‌عامل متفاوت است، بنابراین قلمه‌ای که در یک ماشین موجود است ممکن است در ماشین دیگری نیاز به جایگزینی داشته باشد.

چگونه می‌توانم انتخاب قلم را در تبدیل‌های دسته‌ای یکنواخت نگه دارم؟

از همان فایل‌ها و نسخه‌های قلم در تمام ماشین‌ها یا کانتینرها استفاده کنید، ‎قلم‌های خارجی لازم را بارگذاری‎ کنید و هنگام اجازهٔ مجوز، ‎قلم‌ها را جاسازی‎ کنید. همچنین می‌توانید قبل از صادرات، ‎FontsManager.getSubstitutions‎ را فراخوانی کنید تا جایگزینی‌های غیرمنتظره را شناسایی کنید.

بهینه‌سازی جایگزینی فونت در ارائه‌ها با استفاده از JavaScript دنبالهٔ انتخاب قلم در Aspose.Slides برای Node.js از طریق Java