바코드를 Aspose.BarCode FOSS로 렌더링하는 방법

Problem

바코드를 생성한 후에는 이미지 파일로 렌더링해야 합니다. Aspose.BarCode FOSS for Python는 to_svg() 및 to_png() 메서드를 통해 Barcode 객체에서 바코드를 SVG 및 PNG 형식으로 렌더링합니다. RenderOptions 클래스는 배율, DPI, 색상, 조용 영역, 그리고 사람이 읽을 수 있는 텍스트 표시와 같은 시각적 속성을 제어합니다.

import aspose_barcode_foss as barcode
from aspose_barcode_foss import RenderOptions

bc = barcode.code128("RENDER-ME")
png = bc.to_png(options=RenderOptions(scale=2.0, dpi=300))

전제 조건

Python 3.12 이상
pip 패키지 관리자
aspose-barcode-foss 소스에서 빌드된

SVG 출력

바코드를 SVG 문자열로 가져오려면 to_svg()을(를) 호출하십시오. SVG 출력은 벡터 기반이며 품질 저하 없이 확대됩니다.

import aspose_barcode_foss as barcode

bc = barcode.qr("https://example.com")
svg_string = bc.to_svg()

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

PNG 출력

바코드를 PNG 바이트로 가져오려면 to_png()을(를) 호출하십시오. PNG 출력은 지정된 배율과 DPI에서 래스터화됩니다.

import aspose_barcode_foss as barcode

bc = barcode.code128("PNG-OUTPUT")
png_bytes = bc.to_png()

with open("barcode.png", "wb") as f:
    f.write(png_bytes)

배율 및 DPI 제어

RenderOptions을(를) 사용하여 scale(모듈 크기의 부동 소수점 배수)과 dpi(래스터 출력의 인치당 도트 수)를 설정하십시오. 또한 개별 모듈 치수에 대한 정밀 제어를 위해 module_width와 module_height를 직접 설정할 수 있습니다.

from aspose_barcode_foss import RenderOptions

options = RenderOptions(
    scale=3.0,
    dpi=300,
    module_width=1.5,
    module_height=25.0,
)
png = bc.to_png(options=options)

색상 설정

foreground_color와 background_color을 CSS 색상 문자열로 설정하십시오. 배경 채우기 없이 PNG 출력을 위해 transparent_background=True를 사용하십시오.

from aspose_barcode_foss import RenderOptions

options = RenderOptions(
    foreground_color="#003366",
    background_color="#FFFFFF",
)
svg = bc.to_svg(options=options)

# Transparent background for PNG
options_transparent = RenderOptions(
    foreground_color="#000000",
    transparent_background=True,
)
png = bc.to_png(options=options_transparent)

조용한 영역

quiet_zone 속성은 모듈 단위로 바코드 주변의 공백 여백을 제어합니다. 바코드 표준은 일반적으로 신뢰할 수 있는 스캔을 위해 최소 조용 영역을 요구합니다.

from aspose_barcode_foss import RenderOptions

options = RenderOptions(quiet_zone=10.0)
svg = bc.to_svg(options=options)

사람이 읽을 수 있는 텍스트

show_text=True을 설정하여 바코드 아래에 사람이 읽을 수 있는 텍스트를 렌더링합니다. font_family과 font_size로 글꼴을 제어합니다.

from aspose_barcode_foss import RenderOptions

options = RenderOptions(
    show_text=True,
    font_family="monospace",
    font_size=12.0,
)
svg = bc.to_svg(options=options)

RenderOptions 속성

속성	유형	설명
`scale`	`float`	모듈 크기의 배수
`dpi`	`int`	인치당 도트 수 (래스터 출력)
`module_width`	`float`	하나의 모듈 너비
`module_height`	`float`	하나의 모듈 높이
`quiet_zone`	`float`	모듈 단위의 공백 여백
`foreground_color`	`str`	CSS 바와 모듈의 색상
`background_color`	`str`	CSS 배경 색상
`transparent_background`	`bool`	투명한 PNG 배경
`show_text`	`bool`	읽을 수 있는 텍스트 표시
`font_family`	`str`	읽을 수 있는 텍스트용 글꼴
`font_size`	`float`	인간이 읽을 수 있는 텍스트의 글꼴 크기

알려진 제한 사항

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