پیکربندی جایگزینی قلم در ارائه‌ها در .NET
مرور کلی
جایگزینی قلم به Aspose.Slides امکان می‌دهد تا در صورت عدم دسترسی به یک قلم هنگام رندر یا تبدیل ارائه، از یک قلم موجود استفاده کند. این جایگزینی فقط بر خروجی رندر شده تأثیر می‌گذارد؛ فونتی که به محتوای ارائه اختصاص یافته است را تغییر نمی‌دهد.
می‌توانید قلم مورد استفاده را زمانی که قلم خاصی در دسترس نیست تعریف کنید و می‌توانید جایگزین‌های انجام‌شده توسط Aspose.Slides در هنگام رندر را بررسی کنید. این کار به حفظ سازگاری خروجی در محیط‌های مختلف با قلم‌های نصب‌شده متفاوت کمک می‌کند.
اگر قلم در دسترس باشد اما نسخه ضخیم اختصاصی نداشته باشد، به مدیریت قلم‌ها بدون خط ضخیم اختصاصی مراجعه کنید. آن بخش توضیح می‌دهد چگونه متن تحت تأثیر را در هنگام استخراج PDF رستر کنید و پیامدهای آن برای انتخاب متن، جستجو و مقیاس‌گذاری.
دریافت جایگزینی‌های قلم
از متد IFontsManager.GetSubstitutions برای تعیین اینکه کدام قلم‌ها هنگام رندر ارائه جایگزین می‌شوند استفاده کنید. این متد اشیاء FontSubstitutionInfo را برمی‌گرداند که نام‌های قلم اصلی و جایگزین را شناسایی می‌کند.
مثال C# زیر تمام جایگزینی‌های قلم برای یک ارائه را فهرست می‌کند:
using System;
using Aspose.Slides;
using var presentation = new Presentation("Presentation.pptx");
foreach (var substitution in presentation.FontsManager.GetSubstitutions())
{
Console.WriteLine($"{substitution.OriginalFontName} -> {substitution.SubstitutedFontName}");
}
دریافت جایگزینی‌های قلم برای اسلایدهای انتخاب‌شده
از بارگذاری IFontsManager.GetSubstitutions با آرگومان int[] slides برای بررسی تنها جایگزینی‌های لازم جهت رندر اسلایدهای خاص استفاده کنید. این روش زمانی مفید است که بخواهید بخشی از یک ارائه را رندر یا صادر کنید، یک ارائه بزرگ را به صورت افزایشی بررسی کنید، اسلایدهایی که به قلم‌های در دسترس نیستند را پیدا کنید، یک بسته قلم حداقل برای سرور یا کانتینر آماده کنید، یا اختلافات رندر را بدون پردازش اسلایدهای نامرتبط تشخیص دهید.
آرایه slides شامل ایندکس‌های اسلاید به صورت یک‌پایه است: 1 اولین اسلاید را شناسایی می‌کند. در مقابل، ایندکسر مجموعه Presentation.Slides صفرپایه است، بنابراین همان اسلاید به صورت presentation.Slides[0] دسترسی پیدا می‌شود. هنگام ساخت آرایه این تفاوت را در نظر بگیرید تا از خطاهای یک‌واحدی جلوگیری کنید.
از این بارگذاری از طریق ویژگی Presentation.FontsManager صدا بزنید. این ویژگی فقط جایگزینی‌هایی را که در حین رندر اسلایدهای انتخاب‌شده تعیین شده‌اند برمی‌گرداند. هر نتیجه یک شیء FontSubstitutionInfo است که نام‌های قلم اصلی و جایگزین را شامل می‌شود. نتیجه محیط قلم فعلی و قلم‌های بارگذاری‌شده به صورت خارجی را بازتاب می‌دهد. قوانین جایگزینی که در یک IFontSubstRuleCollection ذخیره شده‌اند خروجی رندر شده را تغییر می‌دهند اما در نتیجه نشان داده نمی‌شوند.
یک جایگزینی ممکن است برای بیش از یک اسلاید انتخاب‌شده مورد نیاز باشد. هنگام ایجاد فهرست قلم یا گزارش پیش‌پرواز، نتایج را حذف تکرار کنید. مثال زیر هر جایگزینی بازگشتی را گزارش می‌کند و سپس فهرست مرتب‌شده‌ای از نگاشت‌های قلم منحصر به‌فرد ایجاد می‌نماید:
using System;
using System.Linq;
using Aspose.Slides;
using var presentation = new Presentation("Presentation.pptx");
int[] selectedSlides = { 1, 3, 5 };
var substitutions = presentation.FontsManager.GetSubstitutions(selectedSlides).ToList();
Console.WriteLine("Substitutions for the selected slides:");
foreach (var substitution in substitutions)
{
Console.WriteLine($"{substitution.OriginalFontName} -> {substitution.SubstitutedFontName}");
}
var preflightEntries = substitutions.Select(substitution => $"{substitution.OriginalFontName} -> {substitution.SubstitutedFontName}");
var uniquePreflightEntries = preflightEntries.Distinct(StringComparer.OrdinalIgnoreCase);
var sortedPreflightEntries = uniquePreflightEntries.OrderBy(entry => entry, StringComparer.OrdinalIgnoreCase).ToList();
Console.WriteLine("Deduplicated font preflight report:");
foreach (var entry in sortedPreflightEntries)
{
Console.WriteLine(entry);
}
رابط IFontsManager هر دو بارگذاری را فراهم می‌کند. بسته به دامنه عملیات رندر، یکی را انتخاب کنید:
| بارگذاری | زمان استفاده |
|---|---|
| GetSubstitutions بدون آرگومان | زمانی که برای کل ارائه به جایگزینی‌ها نیاز دارید. |
GetSubstitutions با int[] slides |
زمانی که برای بازهٔ انتخاب‌شده، بررسی افزایشی یا خروجی جزئی نیاز دارید. |
تنظیم قوانین جایگزینی قلم
برای مشخص کردن قلم‌ای که Aspose.Slides باید هنگام عدم دسترسی به قلم منبع استفاده کند:
- ارائه را بارگذاری کنید.
- تعاریف قلم برای قلم منبع و جایگزین ایجاد کنید.
- یک FontSubstRule با شرط WhenInaccessible ایجاد کنید.
- قانون را به یک FontSubstRuleCollection اضافه کنید.
- مجموعه را به ویژگی FontsManager.FontSubstRuleList اختصاص دهید.
- ارائه را رندر یا تبدیل کنید.
مثال C# زیر Arial را به‌جای SomeRareFont هنگام عدم دسترسی به SomeRareFont جایگزین می‌کند و سپس اولین اسلاید را رندر می‌نماید تا نتیجه را تأیید کند. قلم جایگزین باید برای Aspose.Slides در دسترس باشد.
using Aspose.Slides;
using var presentation = new Presentation("Fonts.pptx");
var sourceFont = new FontData("SomeRareFont");
var substituteFont = new FontData("Arial");
var substitutionRule = new FontSubstRule(sourceFont, substituteFont, FontSubstCondition.WhenInaccessible);
var substitutionRules = new FontSubstRuleCollection();
substitutionRules.Add(substitutionRule);
presentation.FontsManager.FontSubstRuleList = substitutionRules;
using var image = presentation.Slides[0].GetImage(1f, 1f);
image.Save("slide.jpg", ImageFormat.Jpeg);
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 قلم‌ها را همراه کتابخانه توزیع می‌کند؟
خیر. شما مسئول فراهم کردن قلم‌ها و رعایت مجوزهای آن‌ها هستید.
آیا نتایج جایگزینی می‌توانند بین Windows، Linux و macOS متفاوت باشند؟
بله. قلم‌های نصب‌شده و مکان‌های جستجوی قلم در هر سیستم‌عامل متفاوت است، بنابراین قلمی که در یک دستگاه در دسترس است ممکن است در دستگاه دیگر نیاز به جایگزینی داشته باشد.
چگونه می‌توانم انتخاب قلم را در تبدیل‌های دسته‌ای یک‌دست کنم؟
از یک‌سان بودن فایل‌ها و نسخه‌های قلم در هر ماشین یا کانتینر استفاده کنید، قلم‌های خارجی مورد نیاز را بارگذاری کنید و هنگام اجازه‌نامه، قلم‌ها را تعبیه کنید. همچنین می‌توانید پیش از خروجی‌گیری IFontsManager.GetSubstitutions را صدا بزنید تا جایگزینی‌های غیرمنتظره شناسایی شوند.