C++ のプレゼンテーションでフォント置換を設定する

このページの概要

PowerPoint および OpenDocument のプレゼンテーションをレンダリングまたは変換する際に、C++ 用 Aspose.Slides でフォント置換ルールを設定し、置換されたフォントを確認します。

概要

フォント置換を使用すると、プレゼンテーションのレンダリングまたは変換時にアクセスできないフォントの代わりに、利用可能なフォントを Aspose.Slides が使用できます。置換はレンダリング結果にのみ影響し、プレゼンテーションコンテンツに割り当てられたフォントは変更されません。

特定のフォントが利用不可の場合に使用するフォントを定義でき、また Aspose.Slides がレンダリング時に行う置換を確認できます。これにより、インストールされているフォントが異なる環境間でも出力を一貫させることができます。

フォント置換の取得

プレゼンテーションがレンダリングされる際にどのフォントが置換されるかを判断するには、IFontsManager::GetSubstitutions メソッドを使用します。このメソッドは、元のフォント名と置換後のフォント名を示すFontSubstitutionInfo オブジェクトを返します。

以下の C++ の例は、プレゼンテーションに対するすべてのフォント置換を一覧表示します。

#include <DOM/FontSubstitutionInfo.h>
#include <DOM/IFontsManager.h>
#include <DOM/Presentation.h>
#include <system/console.h>

using namespace Aspose::Slides;
using namespace System;

auto presentation = MakeObject<Presentation>(u"Presentation.pptx");

for (auto&& substitution : presentation->get_FontsManager()->GetSubstitutions())
{
    Console::WriteLine(u"{0} -> {1}", substitution->get_OriginalFontName(), substitution->get_SubstitutedFontName());
}

presentation->Dispose();

選択スライドのフォント置換の取得

System::ArrayPtr<int32_t> slides 引数を使用したIFontsManager::GetSubstitutions のオーバーロードを利用すると、特定のスライドのレンダリングに必要な置換のみを確認できます。これは、プレゼンテーションの一部をレンダリングまたはエクスポートする場合、大規模なプレゼンテーションを段階的にチェックする場合、利用できないフォントに依存するスライドを特定する場合、サーバーやコンテナ用に最小限のフォントパッケージを準備する場合、または関係のないスライドを処理せずにレンダリングの差異を診断する場合に役立ちます。

slides 配列は 1 ベースのスライドインデックスを含みます。1 は最初のスライドを示します。対照的に、Presentation::get_Slide メソッドは 0 ベースのインデックスを使用するため、同じスライドは presentation->get_Slide(0) でアクセスされます。配列を作成する際はこの違いに注意し、オフバイワンエラーを防いでください。

このオーバーロードはPresentation::get_FontsManager メソッド経由で呼び出します。選択されたスライドのレンダリング中に決定された置換のみが返されます。各結果は、元のフォント名と置換後のフォント名を含むFontSubstitutionInfo オブジェクトです。結果は現在のフォント環境、構成されたフォールバックルール、IFontSubstRuleCollection に保存された置換ルール、および外部フォントのロードを反映します。

同じ置換が複数の選択スライドで必要になることがあります。フォントインベントリや事前チェックレポートを作成する際は、結果を重複排除してください。以下の例は、返されたすべての置換を報告し、その後ユニークなフォントマッピングのソート済みリストを作成します。

#include <DOM/FontSubstitutionInfo.h>
#include <DOM/IFontsManager.h>
#include <DOM/Presentation.h>
#include <system/array.h>
#include <system/collections/sorted_set.h>
#include <system/console.h>
#include <system/string.h>
#include <system/string_comparer.h>

using namespace Aspose::Slides;
using namespace System;
using namespace System::Collections::Generic;

auto presentation = MakeObject<Presentation>(u"Presentation.pptx");

auto selectedSlides = MakeArray<int32_t>({1, 3, 5});
auto substitutions = presentation->get_FontsManager()->GetSubstitutions(selectedSlides);
auto sortedPreflightEntries = MakeObject<SortedSet<String>>(StringComparer::get_OrdinalIgnoreCase());

Console::WriteLine(u"Substitutions for the selected slides:");
for (auto&& substitution : substitutions)
{
    auto entry = String::Format(u"{0} -> {1}", substitution->get_OriginalFontName(), substitution->get_SubstitutedFontName());
    Console::WriteLine(entry);
    sortedPreflightEntries->Add(entry);
}

Console::WriteLine(u"Deduplicated font preflight report:");
for (auto&& entry : sortedPreflightEntries)
{
    Console::WriteLine(entry);
}

presentation->Dispose();

IFontsManager インターフェイスは両方のオーバーロードを提供します。レンダリング操作の対象範囲に応じて適切なものを選択してください。

オーバーロード	使用する状況
GetSubstitutions（引数なし）	プレゼンテーション全体の置換が必要な場合。
GetSubstitutions（`System::ArrayPtr<int32_t> slides` 指定）	選択範囲、増分チェック、または部分エクスポートの置換が必要な場合。

フォント置換ルールの設定

元のフォントが利用できない場合に Aspose.Slides が使用すべきフォントを指定するには、次の手順を実行します。

プレゼンテーションを読み込みます。
元フォントと置換フォントのフォント定義を作成します。
WhenInaccessible 条件を持つ FontSubstRule を作成します。
そのルールを FontSubstRuleCollection に追加します。
IFontsManager::set_FontSubstRuleList メソッドを使用してコレクションを割り当てます。
プレゼンテーションをレンダリングまたは変換します。

以下の C++ の例は、SomeRareFont が利用できない場合に Arial に置換し、結果を確認するために最初のスライドをレンダリングします。置換フォントは Aspose.Slides が使用できる状態である必要があります。

#include <DOM/FontSubstCondition.h>
#include <DOM/Fonts/FontData.h>
#include <DOM/Fonts/FontSubstRule.h>
#include <DOM/Fonts/FontSubstRuleCollection.h>
#include <DOM/IFontsManager.h>
#include <DOM/ISlide.h>
#include <DOM/Presentation.h>
#include <IImage.h>
#include <ImageFormat.h>

using namespace Aspose::Slides;
using namespace System;

auto presentation = MakeObject<Presentation>(u"Fonts.pptx");

auto sourceFont = MakeObject<FontData>(u"SomeRareFont");
auto substituteFont = MakeObject<FontData>(u"Arial");
auto substitutionRule = MakeObject<FontSubstRule>(sourceFont, substituteFont, FontSubstCondition::WhenInaccessible);

auto substitutionRules = MakeObject<FontSubstRuleCollection>();
substitutionRules->Add(substitutionRule);
presentation->get_FontsManager()->set_FontSubstRuleList(substitutionRules);

auto image = presentation->get_Slide(0)->GetImage(1.0f, 1.0f);
image->Save(u"slide.jpg", ImageFormat::Jpeg);

image->Dispose();
presentation->Dispose();

Note

プレゼンテーション全体で使用されるフォントを無条件に変更する場合は、Font Replacement を参照してください。

数式フォントの制限

フォント置換ルールは、レンダリングおよび変換時に使用される標準的なフォント選択プロセスの一部です。ルールで指定された利用可能なフォントでアクセスできないフォントを置換できる場合、通常のテキストに対して機能します。

Office Math の数式には追加の要件があります。数式が Cambria Math を使用している場合、Aspose.Slides はレイアウトの計算とレンダリングのためにその正確なフォントが必要になることがあります。STIX Two Math のような別の数式フォントに置換するルールは、この目的で Cambria Math を置き換えることはできず、レンダリングは依然として Cambria Math が必要であると報告する可能性があります。

このようなプレゼンテーションをレンダリングまたは変換するには、Cambria Math を Aspose.Slides が使用できるようにしてください。OS にインストールするか、外部フォントとしてロードします。

この制限は数式のレイアウトにのみ適用されます。上記の置換ルールは通常のプレゼンテーションテキストには引き続き適用されます。

FAQ

フォント置換（Replacement）とフォント置換（Substitution）の違いは何ですか？

Font replacement は、プレゼンテーション全体で意図的にあるフォントを別のフォントに変更します。フォント置換は、元のフォントが利用できないなど、設定された条件が満たされたときに、レンダリング結果用のフォントを選択します。

置換ルールはいつ適用されますか？

これらのルールは、レンダリングおよび変換時のフォント選択シークエンスに参加します。WhenInaccessible を使用した場合、ルールは Aspose.Slides が元のフォントにアクセスできないときのみ適用されます。

フォントが存在せず、置換ルールが設定されていない場合はどうなりますか？

Aspose.Slides は、フォント選択プロセスに基づいて最も近い利用可能なフォントを選択します。結果は実行環境で利用できるフォントに依存します。

外部フォントをロードして置換を回避できますか？

はい。外部フォントをロードすれば、Aspose.Slides がレンダリングおよび変換時にそれらを使用できるようになります。

Aspose はライブラリにフォントを同梱していますか？

いいえ。フォントの提供およびライセンス遵守はお客様の責任です。

Windows、Linux、macOS で置換結果が異なることがありますか？

はい。インストールされているフォントやフォント検索場所は OS によって異なるため、あるマシンで利用できるフォントが別のマシンでは置換が必要になることがあります。

バッチ変換でフォント選択を一貫させるにはどうすればよいですか？

各マシンまたはコンテナで同一のフォントファイルとバージョンを使用し、必要な外部フォントをロードし、ライセンスが許可する場合はフォントを埋め込むことが推奨されます。また、エクスポート前にIFontsManager::GetSubstitutions を呼び出して予期しない置換を確認することもできます。

プレゼンテーションでの C++ を使用したフォント置換を効率化 Aspose.Slides for C++ のフォント選択シークエンス