クイックスタート
クイックスタート — Aspose.BarCode Python 用の FOSS
このガイドでは、最も一般的な 3 つのシンボロジー (Code 128、QR Code、および EAN-13) を使用したバーコードの生成手順を説明します。各例は、高レベルの API、シンボロジー別のエンコードオプション、およびレンダリングコントロールを示しています。
Code 128 バーコードを生成
Code 128 は、物流や出荷で使用される可変長の 1 次元シンボロジーです。code128() ヘルパーはデータ文字列とオプションの 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%）。
EAN-13 バーコードを生成する
EAN-13 は、小売で使用される固定長の 1 次元シンボルです。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。
ジェネリック generate() API を使用する
generate() 関数は、専用ヘルパーを呼び出す代わりにシンボロジー名文字列を受け取ります：
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}")例外階層：
| Exception | 発生したとき |
|---|---|
InvalidInputError | データにシンボロジーがサポートしていない文字が含まれています |
EncodingError | エンコードに失敗しました（例：データがシンボロジーの容量を超えています） |
SymbologyNotFoundError | 認識できないシンボロジー名が generate() に渡されました |
UnsupportedCapabilityError | このシンボロジーでは要求された機能は利用できません |
すべての例外クラスは BarcodeError から継承します。
サポートされているシンボロジー
| Symbology | 型 | オプションクラス | 主要プロパティ |
|---|---|---|---|
| Code 128 | 1D | Code128Options | encode_mode |
| Code 39 | 1D | Code39Options | full_ascii, add_check_digit |
| EAN-13 | 1D | Ean13Options | allow_check_digit_input |
| EAN-8 | 1D | Ean8Options | allow_check_digit_input |
| QR Code | 2D | QrOptions | error_correction_level, encoding_mode, version, mask |
| UPC-A | 1D | UpcaOptions | allow_check_digit_input |
| UPC-E | 1D | UpceOptions | allow_check_digit_input |
出力フォーマット: SVG と PNG。
