Özellikler ve fonksiyonlar

Özellikler ve fonksiyonlar

Aspose.BarCode FOSS for Python provides a high-level API for generating seven barcode symbologies with per-symbology encode options and rendering controls. This page is the primary reference for all feature areas.


Desteklenen Simbollar

Kütüphane, yedi sembolojiyi özel yardımcı fonksiyonları ve genel işlevleri aracılığıyla destekler. generate() Giriş Noktası :

SymbologyTypeHelperOpsiyon Sınıfı
Kodu 1281Dcode128()Code128Options
Kod 391Dcode39()Code39Options
EAN-131Dean13()Ean13Options
EAN-81Dean8()Ean8Options
QR Kodu2Dqr()QrOptions
UPC-A1Dupca()UpcaOptions
UPC-E1Dupce()UpceOptions
import aspose_barcode_foss as barcode

# Per-symbology helpers
bc_128 = barcode.code128("ABC123")
bc_qr = barcode.qr("https://example.com")

# Generic API
bc_gen = barcode.generate("ean13", "590123412345")

128 Kodlama Modları

Code128Options 128 karakter kodun hangi kontrolü kullanır. encode_mode Mülkiyet A’yı kabul eder Code128EncodeMode Enum değerleri :

  • AUTO - En kompakt kodlama otomatik olarak seçilir.
  • CODE_A, CODE_B, CODE_C - Tek karakter setine sınırlıdır.
  • CODE_AB, CODE_AC, CODE_BC - İki karakter setleri arasında geçiş yaptırmak için izin verir.
from aspose_barcode_foss import Code128Options, Code128EncodeMode

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

39 Kodlama

Code39Options kodlayıcının temel 43 karakter setini veya tam ASCII uzantısını kullanıp kullanmadığını kontrol eder:

  • full_ascii - Seti için True 128 karakter ASCII aralığını değiştirme çiftleri kullanarak kodlamak için
  • add_check_digit Modulo-43 kontrol numarası ile bağlantı kurun.
from aspose_barcode_foss import Code39Options

bc = barcode.code39(
    "Hello",
    encode=Code39Options(full_ascii=True, add_check_digit=True),
)

QR Kodu Kurulumu

QrOptions Tüm simgeler arasında en çok yapılandırma sağlar:

PropertyTypeValues
error_correction_levelQrErrorCorrectionLevelL %7 % , M %15 İle İlgili Yazılar, Q %25 İle İlgili Yazılar, H %30 (yüzde 30 )
encoding_modeQrEncodeModeAUTO, NUMERIC, ALPHANUMERIC, BYTE, KANJI
versionint1–40 (controls symbol size)
maskint0–7 (manual mask pattern selection)
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,
    ),
)

EAN ve UPC kontrol numarasını kullanır.

Ean13Options, Ean8Options, UpcaOptions,ve UpceOptions Her birinin bir allow_check_digit_input varlık. varsayılan olarak, kütüphane kontrol sayısını otomatik olarak hesaplar. allow_check_digit_input=True Eğer verileriniz zaten içeriyorsa.

from aspose_barcode_foss import Ean13Options

# Automatic check digit (12 digits in, library appends the 13th)
bc = barcode.ean13("590123412345")

# Pre-computed check digit (13 digits, library validates)
bc2 = barcode.ean13(
    "5901234123457",
    encode=Ean13Options(allow_check_digit_input=True),
)

Rendering Kontrolü

RenderOptions Tüm simgelere uygulanır ve görsel çıkış kontrol eder. to_svg() veya to_png():

PropertyTypeDescription
scalefloatTek ölçekli multiplier
dpiintPNG üretimi için çözüm
module_widthfloatBir barkod modülü genişliği
module_heightfloatBir barkod modülü yüksekliği
quiet_zonefloatWhiteespace barkodun etrafında kaydırma
foreground_colorstrBarlar için hex renk (örneğin,., "#000000")
background_colorstrHex renk arka plan için
transparent_backgroundboolPNG için şeffaf arka plan
show_textboolBarkod altında insan okunabilir metin göster
font_familystrİnsan okunabilir metin için yazı tipi
font_sizefloatİnsan okunabilir metin için yazı tipi boyutu
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,
))

çıkış formatı

FormatMethodGeri Dönüş Türü
SVGto_svg()str
PNGto_png()bytes

Her iki yöntem de seçmeli bir yöntem kabul eder. RenderOptions Parametreler için.


Hata İşleme

Tüm kodlama seçeneği doğrulama zamanında gerçekleşir. kütüphane yazdırılmış istisnaları kaldırır önce kodlamaya başlar:

ExceptionYetişkin olduğunda
InvalidInputErrorBilgiler, simbololojiden desteklemediği karakterler içerir.
EncodingErrorKodlama eksiklikleri (örneğin, veri kapasiteyi aşar)
SymbologyNotFoundErrorAnonim simbol adı kabul edilemez generate()
UnsupportedCapabilityErrorBu simbol için kullanılamaz talep edilen özellikler

Tüm sınıflar, her türlü BarcodeError.

from aspose_barcode_foss import InvalidInputError

try:
    bc = barcode.ean13("ABC")
except InvalidInputError as e:
    print(f"Invalid input: {e}")

Giriş Validasyonu

Her bir simbolun kendine özgü bir InputParser Parser karakter set, uzunluk ve biçim gereksinimleri her sembol için özel kontrol eder. Code128InputParser, Code39InputParser, Ean13InputParser, Ean8InputParser, QrInputParser, UpcaInputParser,ve UpceInputParser Bu fonksiyonlar kendi yardımcı fonsiyonları tarafından kullanılmaktadır.


Barkod Object

O zamanlar Barcode Tüm yardımcı fonksiyonları ile geri getirilmiş nesne şunları sağlar:

  • to_svg(options) - SVG string için render
  • to_png(options) - PNG byte için ödeme yapın
  • render(renderer, options) - Özel bir kullanımı yapar Renderer Uygulama
  • symbol - O EncodedSymbol Modül Matris ve Metadata
  • profile - O SymbologyProfile Default ve kapasite ile

API Referans Özetleri

ClassDescription
BarcodeBarkod Object ile ilgili bilgiler to_svg() ve to_png()
Code128OptionsKodu 128 için seçenekleri kodlama (encode_mode)
Code39OptionsKodu için seçenekleri kodlama 39 (full_ascii, add_check_digit)
QrOptionsQR kod seçenekleri (error_correction_level, encoding_mode, version, mask)
Ean13OptionsEAN-13 için kodlama seçenekleri (allow_check_digit_input)
Ean8OptionsEAN-8 için kodlama seçenekleri (allow_check_digit_input)
UpcaOptionsUPC-A için kodlama seçenekleri (allow_check_digit_input)
UpceOptionsUPC-E için kodlama seçenekleri (allow_check_digit_input, number_system)
RenderOptionsGörsel çıkış kontrolü (bölge, DPI, renkler, metin)
EncodeOptionsSimbolik-specifik kodlama seçenekleri için temel türü
BarcodeErrorBarkod Kütüphanesi için Temel Bir Üstün

See Also

 Türkçe