Quickstart

Quickstart Aspose.BarCode FOSS สําหรับ Python

คู่มือนี้นําไปใช้การสร้างบาร์โค้ดโดยใช้สัญลักษณ์สามอย่างที่ทั่วไปที่สุด คือ Code 128, QR Code และ EAN-13 ตัวอย่างแต่ละตัวอย่างแสดง API ระดับสูง, ทางเลือกในการรหัสตามสยามโลคและควบคุมการทําผลิต.

สร้างบาร์โค้ด 128

รหัส 128 เป็นสัญลักษณ์ 1 มิติที่ใช้ในด้านโลจิสติกและการขนส่ง code128() helper ยอมรับรหัสข้อมูลและ optional Code128Options:

import aspose_barcode_foss as barcode
from aspose_barcode_foss import Code128Options, Code128EncodeMode

bc = barcode.code128(
    "1234567890",
    encode=Code128Options(encode_mode=Code128EncodeMode.CODE_C),
)
svg = bc.to_svg()

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

Code128EncodeMode.CODE_C เป็นการอัพพลายสําหรับข้อมูลที่มีตัวเลขเท่านั้น มันโค้ดคู่ของตัวหลักเป็นจุดรหัสเดียว, สร้างบาร์โค๊ดที่สั้นกว่า.

สร้าง QR Code

QR Code เป็นสัญลักษณ์ 2 มิติ ที่รองรับการแก้ไขความผิดพลาดและรูปแบบโคดหลายรุ่น. QrOptions การควบคุมระดับการแก้ไขความผิดพลาด รูปแบบโค้ด ภาพ และรูปแบบหน้ากาก:

import aspose_barcode_foss as barcode
from aspose_barcode_foss import QrOptions, QrErrorCorrectionLevel, QrEncodeMode

bc = barcode.qr(
    "https://example.com/product/12345",
    encode=QrOptions(
        error_correction_level=QrErrorCorrectionLevel.Q,
        encoding_mode=QrEncodeMode.BYTE,
    ),
)

with open("qr.png", "wb") as f:
    f.write(bc.to_png())

ระดับการแก้ไขความผิดพลาด: L (การซ่อมแซม 7%), M (15%), Q (25%), H (30%).

สร้าง Barcode EAN-13

EAN-13 เป็นสัญลักษณ์ 1D ที่ใช้ในวงการขายปลีก จําหน่ายตัวเลข 12 ตัว ห้องสมุดคํานวณตัวหลักเช็คที่ 13 โดยอัตโนมัติ:

import aspose_barcode_foss as barcode

bc = barcode.ean13("590123412345")
svg = bc.to_svg()

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

เพื่อให้บริการตัวเลขเช็คที่คํานวณก่อนของคุณเอง (รวม 13 ตัว) กําหนด allow_check_digit_input=True:

from aspose_barcode_foss import Ean13Options

bc = barcode.ean13(
    "5901234123457",
    encode=Ean13Options(allow_check_digit_input=True),
)

ปรับแต่งการทําตัวให้กับตัวเอง

RenderOptions ใช้กับทุกตัวอักษร และควบคุมผลิตทางสายตา to_svg() หรือ to_png():

import aspose_barcode_foss as barcode
from aspose_barcode_foss import RenderOptions

bc = barcode.upca("01234567890")
png = bc.to_png(options=RenderOptions(
    scale=3.0,
    dpi=300,
    foreground_color="#1a1a1a",
    background_color="#ffffff",
    show_text=True,
    font_family="Courier New",
))

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

อสังหาริมทรัพย์ที่มีอยู่: scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family, font_size.

ใช้ Generic generate ((() API

การ generate() การใช้งานรับ string ชื่อสัญลักษณ์แทนการเรียกตัวช่วยที่ตั้งไว้:

import aspose_barcode_foss as barcode

bc = barcode.generate("code128", "ABC123")
svg = bc.to_svg()

ชื่อสัญลักษณ์ที่ใช้ได้: "code128", "code39", "ean13", "ean8", "qr", "upca", "upce".

การจัดการข้อผิดพลาด

การตรวจสอบความถูกต้องทั้งหมดเกิดขึ้นก่อนการรหัส หากข้อมูลที่ไม่ถูก หรือตัวเลือกที่สอดคล้องกันไม่ได้ ถูกนํามาใช้ หนังสือพิมพ์จะยกเว้นข้อกด:

import aspose_barcode_foss as barcode
from aspose_barcode_foss import InvalidInputError

try:
    bc = barcode.ean13("ABC")  # EAN-13 requires digits
except InvalidInputError as e:
    print(f"Invalid input: {e}")

การจัดเรียงความจํากัด:

ทุกคลาสความพิเศษได้รับมรดกจาก BarcodeError.

สัญลักษณ์ที่สนับสนุน

รูปแบบการออก: SVG และ PNG.

ขั้นตอนต่อไป

• คู่มือผู้พัฒนา: ตัวเลือกการโค้ดพอร์-สยามบอลิก, การควบคุมการทํารันเดอรี่และสถาปนิก
• Features: การอธิบายภาพรวมของลักษณะที่ครบถ้วน พร้อมตัวอย่างโค๊ด
• บทความ KB:การนําทางและ FAQ

See Also

• Aspose.BarCode for Python — Enterprise Documentation