문제 해결 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() 호출할 때

가능한 원인:

  • 파일 경로가 올바르지 않거나 파일이 존재하지 않습니다
  • 파일이 손상되었거나 비표준 헤더를 가지고 있습니다
  • 유효한 폰트가 아닌 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_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)

참조

 한국어