Aspose.BarCode FOSS
Python
자주 묻는 질문

자주 묻는 질문

라이선스 및 오픈 소스

어떤 라이선스를 Aspose.BarCode FOSS for Python가 사용합니까?

Aspose.BarCode FOSS for Python는 MIT 라이선스로 배포됩니다. 전체 라이선스 텍스트는 패키지와 함께 배포되는 LICENSE 파일에 포함되어 있습니다. 오픈 소스 프로젝트와 상용 프로젝트 모두에서 라이브러리를 사용, 수정 및 재배포할 수 있습니다.

상업용 제품에서 Aspose.BarCode FOSS를 사용할 수 있나요?

예. MIT 라이선스는 원본 라이선스 고지를 포함하는 것을 제외하고는 로열티나 추가적인 출처 표기 요구 없이 상업적 사용을 허용합니다. 애플리케이션을 오픈 소스로 공개할 필요가 없습니다.

설치 및 요구 사항

Aspose.BarCode FOSS for Python를 어떻게 설치합니까?

아래 명령어로 설치하세요:

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

이 라이브러리는 Python 3.12 이상이 필요합니다.

필요한 네이티브 종속성이나 시스템 패키지가 있나요?

아니요. Aspose.BarCode FOSS for Python는 순수-Python 패키지입니다. 네이티브 확장 기능이 없으며, C 종속성도 없고, 설치할 시스템 수준 패키지도 없습니다. Windows, macOS, Linux에서 실행되며 — python:3.12-slim와 같은 슬림 Docker 이미지에서도 동작합니다.

심볼 지원

지원되는 바코드 심볼은 무엇인가요?

이 라이브러리는 일곱 가지 심볼을 지원합니다:

Symbology유형옵션 클래스
Code 1281DCode128Options
Code 391DCode39Options
EAN-131DEan13Options
EAN-81DEan8Options
QR Code2DQrOptions
UPC-A1DUpcaOptions
UPC-E1DUpceOptions

각 심볼(문자 체계)마다 전용 헬퍼 함수(code128(), code39(), ean13(), ean8(), qr(), upca(), upce())와 심볼 이름 문자열을 받아들이는 일반적인 generate() 함수가 있습니다.

사용 가능한 출력 형식은 무엇입니까?

이 라이브러리는 바코드를 SVG와 PNG로 렌더링합니다:

  • to_svg() — SVG 문자열을 반환합니다
  • to_png() — PNG 바이트를 반환합니다

두 메서드 모두 스케일, DPI, 색상, 퀸트 존, 인간이 읽을 수 있는 텍스트를 제어하기 위한 선택적 RenderOptions 매개변수를 허용합니다.

API Usage

바코드를 어떻게 생성하나요?

각 심볼에 대한 헬퍼 함수를 사용하십시오:

import aspose_barcode_foss as barcode

bc = barcode.code128("Hello World")
svg = bc.to_svg()

with open("barcode.svg", "w") as f:
    f.write(svg)

또는 일반 generate() 함수를 사용하십시오:

bc = barcode.generate("qr", "https://example.com")

인코드 옵션을 어떻게 구성합니까?

각 심볼마다 전용 옵션 클래스가 있습니다. 이를 encode 매개변수로 전달하십시오:

from aspose_barcode_foss import QrOptions, QrErrorCorrectionLevel

bc = barcode.qr(
    "https://example.com",
    encode=QrOptions(error_correction_level=QrErrorCorrectionLevel.H),
)

바코드의 시각적 외관을 어떻게 제어합니까?

RenderOptions를 to_svg() 또는 to_png()와 함께 사용하십시오:

from aspose_barcode_foss import RenderOptions

bc = barcode.code128("DATA")
png = bc.to_png(options=RenderOptions(
    scale=3.0,
    dpi=300,
    foreground_color="#003366",
    show_text=True,
))

사용 가능한 속성: scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family, font_size.

라이브러리는 EAN 및 UPC 바코드의 체크 디지트를 어떻게 처리합니까?

기본적으로 라이브러리는 체크 디지털을 자동으로 계산합니다. 페이로드 숫자만 제공하세요 (12 for EAN-13, 7 for EAN-8, 11 for UPC-A):

bc = barcode.ean13("590123412345")  # 12 digits — check digit computed

미리 계산된 체크 디지털을 제공하려면 allow_check_digit_input=True을 설정하십시오:

from aspose_barcode_foss import Ean13Options

bc = barcode.ean13(
    "5901234123457",  # 13 digits with check digit
    encode=Ean13Options(allow_check_digit_input=True),
)

알려진 제한 사항

PDF 출력이 지원됩니까?

아니요. to_pdf() 메서드와 PdfRenderer 클래스는 API 표면에 존재하지만 NotImplementedError를 발생시킵니다. 대신 to_svg() 또는 to_png()를 사용하십시오. SVG 출력은 외부 도구를 사용하여 PDF 문서에 삽입할 수 있습니다.

ECI 및 GS1 표준이 지원됩니까?

아직 지원되지 않습니다. EciHelper와 Gs1Helper 클래스는 NotImplementedError를 발생시키는 메서드 스텁을 가지고 있습니다. 현재 릴리스에서는 EncodeOptions의 eci_assignment_number 및 gs1_enabled 속성이 존재하지만 기능하지 않습니다.

라이브러리가 바코드를 읽거나 스캔할 수 있나요?

No. Aspose.BarCode Python용 FOSS는 생성 전용 라이브러리입니다. 데이터에서 바코드를 생성하지만 바코드 인식 또는 스캔 기능은 포함하지 않습니다.

참조

 한국어