Εργασία με επιλογές Encode
Εργασία με επιλογές Encode
Κάθε σύμβολο κωδικού γραμμής στο Aspose.BarCode FOSS για Python έχει μια αφιερωμένη κατηγορία επιλογών που ελέγχει την κρυπτογράφηση συμπεριφοράς. EncodeOptions, η οποία παρέχει gs1_enabled και eci_assignment_number Μοιράζονται τα χαρακτηριστικά σε σύμβολα.
Code128Options
Code128Options Ο κωδικός 128 χαρακτήρα που ορίζει τον κωδικό επιλέγει. encode_mode Η ιδιοκτησία αποδέχεται το Code128EncodeMode Αξία του ΕΝΟ.
| Mode | Description |
|---|---|
AUTO | Επιλέξτε αυτόματα την πιο συμπαγή κωδικοποίηση |
CODE_A | Ανώτατο, αριθμοί και χαρακτήρες ελέγχου |
CODE_B | Ανώτερος, χαμηλότερος και ψηφίσματα |
CODE_C | Digit pairs – βελτιστοποιημένα για αριθμητικά μόνο δεδομένα |
CODE_AB | Μετακίνηση μεταξύ Κώδικα Α και Κωδίου Β |
CODE_AC | Μετακίνηση μεταξύ Κώδικα Α και Κωδίου Γ |
CODE_BC | Μετακίνηση μεταξύ Κώδικα Β και Κωδίου Γ |
import aspose_barcode_foss as barcode
from aspose_barcode_foss import Code128Options, Code128EncodeMode
# AUTO mode — library picks the most compact encoding
bc_auto = barcode.code128("ABC123", encode=Code128Options(encode_mode=Code128EncodeMode.AUTO))
# CODE_C mode — compact encoding for digit-only data
bc_c = barcode.code128("9876543210", encode=Code128Options(encode_mode=Code128EncodeMode.CODE_C))
# CODE_B mode — full alphanumeric support
bc_b = barcode.code128("Hello World", encode=Code128Options(encode_mode=Code128EncodeMode.CODE_B))Code39Options
Code39Options ελέγχει αν ο κωδικός χρησιμοποιεί το σύνολο χαρακτήρων βάσης 43 ή την επέκταση Full ASCII.
| Property | Type | Default | Description |
|---|---|---|---|
full_ascii | bool | None | Ενεργοποιεί τη λειτουργία Full ASCII (128 χαρακτήρες μέσω ζευγών μετατροπής) |
add_check_digit | bool | None | Εισάγετε ένα modulo-43 check digit |
from aspose_barcode_foss import Code39Options
# Base mode — uppercase letters, digits, and a few special characters
bc_base = barcode.code39("CODE 39")
# Full ASCII mode — encodes the full 128-character ASCII range
bc_full = barcode.code39(
"Hello, World!",
encode=Code39Options(full_ascii=True, add_check_digit=True),
)ΚΡΕΦΟΡΙΕΣ
QrOptions Έχει την πιο διαμορφωμένη επιφάνεια μεταξύ όλων των συμβολαιολογιών.
| Property | Type | Values |
|---|---|---|
error_correction_level | QrErrorCorrectionLevel | L (7 % ) και, M 15 % ) , Q 25 % ) , H (30%) για την |
encoding_mode | QrEncodeMode | AUTO, NUMERIC, ALPHANUMERIC, BYTE, KANJI |
version | int | 1–40 (controls symbol dimensions) |
mask | int | 0–7 (manual mask pattern selection) |
from aspose_barcode_foss import QrOptions, QrErrorCorrectionLevel, QrEncodeMode
# High error correction with byte encoding
bc = barcode.qr(
"https://example.com",
encode=QrOptions(
error_correction_level=QrErrorCorrectionLevel.H,
encoding_mode=QrEncodeMode.BYTE,
),
)
# Numeric mode for digit-only data — most compact QR
bc_num = barcode.qr(
"0123456789",
encode=QrOptions(encoding_mode=QrEncodeMode.NUMERIC),
)
# Explicit version and mask
bc_v5 = barcode.qr(
"TEST",
encode=QrOptions(version=5, mask=3),
)Ean13Options
Ean13Options Ελέγξτε τον έλεγχο των ψηφιακών χειρισμών για τους κωδικούς γραμμής EAN-13.
| Property | Type | Default | Description |
|---|---|---|---|
allow_check_digit_input | bool | None | Αποδέχεται εισαγωγή 13 ψηφίων με προεπιλεγμένο αριθμό ελέγχου |
from aspose_barcode_foss import Ean13Options
# 12 digits — library computes the 13th check digit
bc = barcode.ean13("590123412345")
# 13 digits — library validates the provided check digit
bc2 = barcode.ean13(
"5901234123457",
encode=Ean13Options(allow_check_digit_input=True),
)Ean8Options
Ean8Options λειτουργεί ταυτόσημα με το Ean13Options Αλλά για 8 ψηφία EAN κωδικούς. Παρέχετε 7 αριθμούς φόρτωσης (ο βιβλιοθηκός υπολογίζει το 8ο), ή ρυθμίστε allow_check_digit_input=True 8 ψηφία εισόδου.
from aspose_barcode_foss import Ean8Options
bc = barcode.ean8("1234567")
bc2 = barcode.ean8("12345670", encode=Ean8Options(allow_check_digit_input=True))UpcaOptions και UpceOption
UpcaOptions και UpceOptions Ακολουθήστε το ίδιο allow_check_digit_input Η επιλογή του ΕΝ. UpceOptions Επίσης έχει ένα number_system ιδιοκτησία .
from aspose_barcode_foss import UpcaOptions, UpceOptions
# UPC-A: 11 digits, library adds check digit
bc_a = barcode.upca("01234567890")
# UPC-E with pre-computed check digit
bc_e = barcode.upce(
"01234565",
encode=UpceOptions(allow_check_digit_input=True),
)Ετικέτες Βάση ιδιότητες
Όλες οι κατηγορίες επιλογής κληρονομήσουν αυτές τις ιδιότητες από την EncodeOptions:
| Property | Type | Description |
|---|---|---|
gs1_enabled | `bool | None` |
eci_assignment_number | `int | None` |
Συμβουλές και βέλτιστες πρακτικές
- Χρησιμοποιήστε
Code128EncodeMode.AUTOεκτός αν έχετε συγκεκριμένο λόγο για να περιορίσετε τα σύνολα χαρακτήρων - παράγει τον συντομότερο κωδικό γραμμής για οποιαδήποτε εισαγωγή. - ΣΕΤΙΔΑ
QrErrorCorrectionLevel.Hγια κωδικούς QR που θα εκτυπώνονται σε επιφάνειες ευάλωτες στην ζημιά. - Αφήστε τη βιβλιοθήκη να ελέγχει τις αριθμούς προεπιλογή - μόνο ρυθμίσεις
allow_check_digit_input=Trueόταν λαμβάνετε προεπιλεγμένα δεδομένα από άλλο σύστημα. - Χρησιμοποιήστε
QrEncodeMode.NUMERICΓια να χρησιμοποιήσετε μόνο τα δεδομένα QR για να ελαχιστοποιήσουν το μέγεθος του σύμβολου.
κοινά ζητήματα
| Issue | Cause | ΦΙΛΕΞΗ |
|---|---|---|
InvalidInputError Κωδικός 39 | Η εισαγωγή περιέχει λιγότερο γραπτές λέξεις | ΣΕΤΙΔΑ full_ascii=True Σε Code39Options |
| Κωδικός QR είναι πολύ μεγάλος. | Η έκδοση είναι πολύ χαμηλή για το μήκος των δεδομένων. | Αφαιρέστε το ρητό version ή να αυξήσει |
| Ελέγξτε το λάθος ψηφίο στο EAN-13 | 13-digit input without allow_check_digit_input=True | Πληκτρολογήστε 12 αριθμούς (αυτοκίνητα) ή ρυθμίστε την επιλογή για να True |
SymbologyNotFoundError | Το όνομα της σωματικής συμβολαιογραφίας στο generate() | Χρησιμοποιήστε ένα από: code128, code39, ean13, ean8, qr, upca, upce |