Python（Java 経由）を使用したプレゼンテーションのフォント置換の構成

このページの概要

PowerPoint と OpenDocument のプレゼンテーションをレンダリングまたは変換する際に、Python（Java 経由）用 Aspose.Slides でフォント置換ルールを構成し、置換されたフォントを確認します。

概要

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

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

フォント置換の取得

FontsManager.getSubstitutions メソッドを使用して、プレゼンテーションのレンダリング時に置換されるフォントを確認します。このメソッドは、元のフォント名と置換後のフォント名を特定する FontSubstitutionInfo オブジェクトを返します。

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

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation

presentation = Presentation("Presentation.pptx")
try:
    for substitution in presentation.getFontsManager().getSubstitutions():
        print(f"{substitution.getOriginalFontName()} -> {substitution.getSubstitutedFontName()}")
finally:
    presentation.dispose()

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

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

slides 配列は 1 ベースのスライドインデックスを格納します: 1 は最初のスライドを示します。対照的に、Presentation.getSlides コレクションアクセッサは 0 ベースのインデックスを使用するため、同じスライドは presentation.getSlides().get_Item(0) として取得します。配列を作成する際はこの違いに注意し、オフバイワンエラーを防いでください。

オーバーロードは Presentation.getFontsManager メソッドから呼び出します。選択スライドのレンダリング中に決定された置換のみが返されます。各結果は元のフォント名と置換後のフォント名を含む FontSubstitutionInfo オブジェクトです。結果は現在のフォント環境、構成されたフォールバックルール、FontSubstRuleCollection に格納された置換ルール、および externally loaded fonts を反映します。

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

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation

presentation = Presentation("Presentation.pptx")
try:
    selected_slides = jpype.JArray(jpype.JInt)([1, 3, 5])
    substitutions = list(presentation.getFontsManager().getSubstitutions(selected_slides))

    print("Substitutions for the selected slides:")
    for substitution in substitutions:
        print(f"{substitution.getOriginalFontName()} -> {substitution.getSubstitutedFontName()}")

    unique_entries = {}
    for substitution in substitutions:
        entry = f"{substitution.getOriginalFontName()} -> {substitution.getSubstitutedFontName()}"
        unique_entries.setdefault(entry.casefold(), entry)

    print("Deduplicated font preflight report:")
    for key in sorted(unique_entries):
        print(unique_entries[key])
finally:
    presentation.dispose()

FontsManager クラスは両方のオーバーロードを提供します。レンダリング操作の対象範囲に応じて選択してください。

オーバーロード	使用する状況
getSubstitutions（引数なし）	プレゼンテーション全体の置換が必要なとき
getSubstitutions（Java 整数配列付き）	選択範囲、段階的チェック、または部分エクスポートが必要なとき

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

ソースフォントが利用できない場合に Aspose.Slides が使用すべきフォントを指定する手順:

プレゼンテーションをロードします。
ソースフォントと置換フォントの定義を作成します。
WhenInaccessible 条件で FontSubstRule を作成します。
そのルールを FontSubstRuleCollection に追加します。
FontsManager.setFontSubstRuleList メソッドでコレクションを割り当てます。
プレゼンテーションをレンダリングまたは変換します。

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

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FontData, FontSubstCondition, FontSubstRule, FontSubstRuleCollection, ImageFormat, Presentation

presentation = Presentation("Fonts.pptx")
try:
    source_font = FontData("SomeRareFont")
    substitute_font = FontData("Arial")
    substitution_rule = FontSubstRule(source_font, substitute_font, FontSubstCondition.WhenInaccessible)

    substitution_rules = FontSubstRuleCollection()
    substitution_rules.add(substitution_rule)
    presentation.getFontsManager().setFontSubstRuleList(substitution_rules)

    image = presentation.getSlides().get_Item(0).getImage(1.0, 1.0)
    try:
        image.save("slide.jpg", ImageFormat.Jpeg)
    finally:
        image.dispose()
finally:
    presentation.dispose()

注意

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

数式フォントの制限

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

Office Math の数式には追加の要件があります。数式が Cambria Math を使用している場合、Aspose.Slides はレイアウトの計算とレンダリングにその正確なフォントが必要になることがあります。STIX Two Math のような別の数式フォントに置き換えるルールは Cambria Math の代替にはなりません。その結果、レンダリング時に Cambria Math が必要である旨が報告されることがあります。

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

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

FAQ

フォント置換とフォント置き換えの違いは何ですか？

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

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

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

フォントが欠落していて置換ルールが設定されていない場合はどうなりますか？

Aspose.Slides はフォント選択プロセスに従って最も近い利用可能なフォントを選択します。結果は実行環境にインストールされているフォントに依存します。

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

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

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

いいえ。フォントの提供とライセンス遵守はユーザーの責任です。

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

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

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

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

Python（Java経由）でプレゼンテーションのフォント置き換えを効率化 Aspose.Slides for Python via Java におけるフォント選択シーケンス