문제 해결 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() 호출할 때
가능한 원인:
- 파일 경로가 올바르지 않거나 파일이 존재하지 않습니다
- 파일이 손상되었거나 비표준 헤더를 가지고 있습니다
- 유효한 폰트가 아닌 bytes 객체를 전달했습니다
로드하기 전에 파일이 존재하는지 확인하십시오:
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에서는 원시 문자열이나 슬래시(/)를 사용하세요:
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_tablesNotImplementedError 에서 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)