Aspose.Font FOSS
トラブルシューティング Aspose.Font FOSS for Python

トラブルシューティング Aspose.Font FOSS for Python

インポートエラー

ModuleNotFoundError: No module named 'aspose_font'

パッケージがアクティブな Python 環境にインストールされていません。インストールしてください:

git clone https://github.com/aspose-font-foss/Aspose.Font-FOSS-for-Python.git
cd Aspose.Font-FOSS-for-Python
pip install -e .

仮想環境を使用している場合は、正しい仮想環境にインストールしていることを確認してください。

ImportError: cannot import name 'FontType' from 'aspose_font'

FontType はトップレベルの aspose_font パッケージからエクスポートされます。使用してください:

from aspose_font import FontType  # correct

このエラーが表示された場合、アクティブな環境に aspose-font>=1.0.0 がインストールされていることを確認してください。

フォント読み込みエラー

FontLoadException は FontLoader.open() を呼び出すとき

考えられる原因:

  • ファイルパスが間違っているか、ファイルが存在しません
  • ファイルが破損しているか、非標準のヘッダーが含まれています
  • 有効なフォントではないバイトオブジェクトを渡しました

読み込む前にファイルが存在するか確認してください:

import os
from aspose_font import FontLoader

path = "MyFont.ttf"
if not os.path.exists(path):
    raise FileNotFoundError(path)
font = FontLoader.open(path)

Windows パスのバックスラッシュの問題

Windows では raw 文字列またはスラッシュ（/）を使用してください:

font = FontLoader.open(r"C:\Fonts\MyFont.ttf")
# or
font = FontLoader.open("C:/Fonts/MyFont.ttf")

API エラー

AttributeError: 'Font' object has no attribute 'ttf_tables'

ttf_tables は TtfFont のプロパティであり、基底 Font クラスではありません。型アノテーションを使用してください:

from aspose_font import TtfFont
ttf_font: TtfFont = FontLoader.open("MyFont.ttf")
tables = ttf_font.ttf_tables

NotImplementedError は Font.to_bytes() から

Font.to_bytes(font_type) は抽象基底クラスで呼び出されたときのみ NotImplementedError を発生させます。すべての具体的なフォントクラス（TtfFont、CffFont、WoffFont、Woff2Font など）は to_bytes() を実装し、フォントバイトを返します。FontLoader.open() を呼び出すと具体インスタンスが得られます — to_bytes() を直接呼び出すか、先に形式を変更するために FontConverter.convert() を使用してください:

from aspose_font.converter import FontConverter  # internal API — may change between releases
from aspose_font import FontType

woff2 = FontConverter.convert(font, FontType.WOFF2)

参照

 日本語