Ö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ı :
| Symbology | Type | Helper | Opsiyon Sınıfı |
|---|---|---|---|
| Kodu 128 | 1D | code128() | Code128Options |
| Kod 39 | 1D | code39() | Code39Options |
| EAN-13 | 1D | ean13() | Ean13Options |
| EAN-8 | 1D | ean8() | Ean8Options |
| QR Kodu | 2D | qr() | QrOptions |
| UPC-A | 1D | upca() | UpcaOptions |
| UPC-E | 1D | upce() | 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çinTrue128 karakter ASCII aralığını değiştirme çiftleri kullanarak kodlamak içinadd_check_digitModulo-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:
| Property | Type | Values |
|---|---|---|
error_correction_level | QrErrorCorrectionLevel | L %7 % , M %15 İle İlgili Yazılar, Q %25 İle İlgili Yazılar, H %30 (yüzde 30 ) |
encoding_mode | QrEncodeMode | AUTO, NUMERIC, ALPHANUMERIC, BYTE, KANJI |
version | int | 1–40 (controls symbol size) |
mask | int | 0–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():
| Property | Type | Description |
|---|---|---|
scale | float | Tek ölçekli multiplier |
dpi | int | PNG üretimi için çözüm |
module_width | float | Bir barkod modülü genişliği |
module_height | float | Bir barkod modülü yüksekliği |
quiet_zone | float | Whiteespace barkodun etrafında kaydırma |
foreground_color | str | Barlar için hex renk (örneğin,., "#000000") |
background_color | str | Hex renk arka plan için |
transparent_background | bool | PNG için şeffaf arka plan |
show_text | bool | Barkod altında insan okunabilir metin göster |
font_family | str | İnsan okunabilir metin için yazı tipi |
font_size | float | İ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ı
| Format | Method | Geri Dönüş Türü |
|---|---|---|
| SVG | to_svg() | str |
| PNG | to_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:
| Exception | Yetişkin olduğunda |
|---|---|
InvalidInputError | Bilgiler, simbololojiden desteklemediği karakterler içerir. |
EncodingError | Kodlama eksiklikleri (örneğin, veri kapasiteyi aşar) |
SymbologyNotFoundError | Anonim simbol adı kabul edilemez generate() |
UnsupportedCapabilityError | Bu 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 renderto_png(options)- PNG byte için ödeme yapınrender(renderer, options)- Özel bir kullanımı yaparRendererUygulamasymbol- OEncodedSymbolModül Matris ve Metadataprofile- OSymbologyProfileDefault ve kapasite ile
API Referans Özetleri
| Class | Description |
|---|---|
Barcode | Barkod Object ile ilgili bilgiler to_svg() ve to_png() |
Code128Options | Kodu 128 için seçenekleri kodlama (encode_mode) |
Code39Options | Kodu için seçenekleri kodlama 39 (full_ascii, add_check_digit) |
QrOptions | QR kod seçenekleri (error_correction_level, encoding_mode, version, mask) |
Ean13Options | EAN-13 için kodlama seçenekleri (allow_check_digit_input) |
Ean8Options | EAN-8 için kodlama seçenekleri (allow_check_digit_input) |
UpcaOptions | UPC-A için kodlama seçenekleri (allow_check_digit_input) |
UpceOptions | UPC-E için kodlama seçenekleri (allow_check_digit_input, number_system) |
RenderOptions | Görsel çıkış kontrolü (bölge, DPI, renkler, metin) |
EncodeOptions | Simbolik-specifik kodlama seçenekleri için temel türü |
BarcodeError | Barkod Kütüphanesi için Temel Bir Üstün |