TrueType フォントの場所を指定する

このトピックでは、オペレーティングシステム固有の違いを含め、TrueType フォントを検索するときの Aspose.Words のデフォルトの動作について説明し、ユーザーフォントソースを指定する方法を示します。

FontSourceBase クラスは、さまざまなフォントソースを指定するために使用されます。 FontSourceBase クラスにはいくつかの実装があります。

一部のクラスの実装の詳細については、以下で説明します。

システムからフォントをロードする

常にデフォルトで使用される特別な SystemFontSource クラスがあります。これは、システムにインストールされているすべての TrueType フォントを表します。したがって、SystemFontSource およびその他の必要なソースを含むソースリストを作成できます。

SystemFontSource クラスの単一インスタンスはデフォルトで FontSettings に定義されます。オペレーティングシステムが異なると、フォントが異なる場所に配置される場合があります。ただし、ドキュメントごとに FontSettings インスタンスを使用することは最適な解決策ではありません。ほとんどの場合、default_instance を使用すれば十分です。

ドキュメントごとのインスタンスは、ドキュメントごとに異なるフォントソースを使用する必要がある場合にのみ必要になりますが、これはまれなケースです。複数の FontSettings インスタンスを使用すると、キャッシュが共有されないため、パフォーマンスが低下します。

Aspose.Words が Windows 上の TrueType フォントを検索する場所

ほとんどの場合、Windows ユーザーはフォントの欠落やレイアウトの誤りなどの重大な問題に直面することはありません。通常、Aspose.Words はドキュメントを通過し、フォントのリンクに遭遇すると、システムフォルダーからフォントデータを正常に取得します。

Windows では、Aspose.Words はまず、_%windir%\Fonts フォルダーから使用可能なすべてのフォントを取得します。ほとんどの場合、この設定が機能します。必要な場合にのみ、独自のフォントフォルダーを指定します。 Aspose.Words for .NET は、HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts レジストリキーに登録されている追加のフォントも検索します。さらに、Windows 10 では、現在のユーザーがフォントをインストールできるようになります。フォントは %userprofile%\AppData\Local\Microsoft\Windows\Fonts フォルダーに配置され、HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\Fonts レジストリでも指定されます。Aspose.Words はそこでこれらのフォントを検索します。

ドキュメントに埋め込みフォントが含まれている場合、Aspose.Words はドキュメントから関連するフォントデータを読み取り、それを使用してドキュメントのレイアウトを作成できます。ドキュメントには、システムフォルダーにないフォントへのリンクが含まれている場合もあります。その場合は、次のシナリオが機能します。

ユーザーは FontSettings クラスを通じて新しいフォントソースをセットアップできます。
Aspose.Words は、見つからないフォントを類似したフォントに置き換えることを試みることができます

非 Windows システムのフォント

Aspose.Words はシステムフォントフォルダーでフォントを検索します。これらのフォルダーのリストは、SystemFontSource.get_system_font_folders メソッドで表示できます。サポートされているフォントが見つからない場合、Aspose.Words は組み込みのデフォルトフォント Fanwood.ttf を使用します。

Windows OS と非 Windows OS のフォントメトリックは異なるため、Aspose.Words は類似のフォントを見つけて、元のフォントに似たレイアウトを構築するために可能な限りのことを行います。ただし、これが常に可能であるとは限りません。このような場合、FontSettings クラスを使用してカスタムフォントまたは置換ルールを追加する必要があります。

Aspose.Words が Linux 上の TrueType フォントを検索する場所

Linux ディストリビューションが異なると、フォントが異なるフォルダーに保存される場合があります。 Aspose.Words は、いくつかの場所でフォントを検索します。デフォルトでは、Aspose.Words は次のすべての場所でフォントを検索します: /usr/share/fonts /usr/local/share/fonts /usr/X11R6/lib/X11/fonts。このデフォルトの動作はほとんどの Linux ディストリビューションで機能しますが、常に機能することが保証されているわけではありません。その場合は、true タイプのフォントの場所を明示的に指定する必要がある場合があります。これを行うには、TrueType フォントが Linux ディストリビューション上のどこにインストールされているかを知る必要があります。

Aspose.Words が Mac OS X で TrueType フォントを探す場所

Aspose.Words は、/Library/Fonts フォルダでフォントを検索します。これは、Mac OS X 上の TrueType フォントの標準の場所です。ほとんどの場合、この設定で機能しますが、独自のフォントフォルダを必要な場合。

フォルダーからフォントをロードする

処理中のドキュメントにシステムにないフォントへのリンクが含まれている場合、それらのフォントをシステムフォルダーに追加したくない場合、または権限がない場合、最善の解決策は、次のコマンドを使用して独自のフォントを含むフォルダーを追加することです。 FontSettings.set_fonts_sources方式。これにより、システムソースをユーザーソースに置き換えることができます。 Aspose.Words は、レジストリまたは Windows\Font フォルダー内のフォントを検索せず、指定されたフォルダー内のフォントのみをスキャンします。 FontSettings.get_font_sources メソッドは対応する値を返します。

1 つまたは複数のフォントフォルダーの指定

FontSettings.set_fonts_folder メソッドと FontSettings.set_fonts_folders メソッドは、1 つまたは複数の FolderFontSource インスタンスを含む FontSettings.set_font_sources メソッドへのショートカットです。これらのメソッドは、Aspose.Words がフォントを検索する場所を示すために使用されます。フォルダーが存在しない場合、またはアクセスできない場合、Aspose.Words はこのフォルダーを無視します。フォント置換のソースを含むすべてのフォルダーが無視された場合、Aspose.Words はデフォルトとして Fanwood フォントを使用します。

次の例は、フォントのレンダリングまたは埋め込み中に Aspose.Words が TrueType フォントを検索するために使用するフォルダーまたはソースを設定する方法を示しています。

この例のテンプレートファイルは Aspose.Words GitHub からダウンロードできます。

追加のブール値パラメーターは、すべてのフォルダーでフォントを再帰的にスキャンするかどうかを制御します。つまり、指定したフォルダーのすべての子フォルダーをスキャンします。次の例は、フォントのレンダリングまたは埋め込み時に TrueType フォントを複数のフォルダーで検索するように Aspose.Words を設定する方法を示しています。

この例のテンプレートファイルは Aspose.Words GitHub からダウンロードできます。

優先順位に注意してください。異なるフォントソースに同じファミリ名とスタイルを持つフォントが存在する場合、Aspose.Words はソースからフォントを優先して選択します。以下の「優先度」フィールドの説明を参照してください。

システムフォントをまったく使用したくない場合、Aspose.Words ではそれらを無視して独自のフォントのみを使用できます。

優先物件

優先度 プロパティは、異なるフォントソースに同じファミリー名とスタイルのフォントが存在する場合に使用されます。この場合、Aspose.Words はソースから優先度の高いフォントを選択します。たとえば、システムフォルダに古いバージョンのフォントがあり、顧客が同じフォントの新しいバージョンをカスタムフォルダに追加したとします。

利用可能なフォントのリストの取得

たとえば、PDF ドキュメントのレンダリングに使用できる、使用可能なフォントのリストを取得する場合は、次のコード例に示すように、get_available_fonts メソッドを使用できます。 PhysicalFontInfo クラスは、Aspose.Words フォントエンジンで使用できる物理フォントに関する情報を指定します。

Linux に TrueType フォントをインストールする