はじめに

Aspose.BarCode FOSS for Python は、サポートされている7つのバーコード形式すべてにわたってエンコード動作を制御するシンボロジー別オプションクラスを提供します。各オプションクラスは EncodeOptions から継承し、シンボロジー固有のプロパティ — Code 128 エンコードモード、Code 39 ASCII 選択、QR エラー訂正レベル、そして EAN/UPC チェックデジット処理 — を追加します。

この記事では、各オプションクラス、そのプロパティ、および動作するコード例を取り上げます。クラスはトップレベルの aspose_barcode_foss パッケージから利用できます。


主な機能

Code 128 エンコードモード

Code128Options はエンコーダが使用する Code 128 の文字セットを制御します。encode_mode プロパティは Code128EncodeMode 列挙値を受け取ります: AUTO、CODE_A、CODE_B、CODE_C、CODE_AB、CODE_AC、または CODE_BC。AUTO は最もコンパクトなエンコードを自動的に選択します。CODE_C は数字のみのデータ用に最適化されており(数字のペアが単一のコードポイントとしてエンコードされます)。

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()

Code 128 は、EncodeOptions から継承された gs1_enabled および eci_assignment_number プロパティもサポートし、GS1 と ECI メタデータに対応します。

Code 39 エンコーディング

Code39Options はエンコーダがベースの43文字セットを使用するか、Full ASCII 拡張を使用するかを制御します。full_ascii=True を設定して Full ASCII モードを有効にすると、シフトペアを使用して全128文字の ASCII 範囲をエンコードします。オプションの add_check_digit プロパティは、モジュロ-43 のチェックデジットを付加します。

import aspose_barcode_foss as barcode
from aspose_barcode_foss import Code39Options

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

QR Code 設定

QrOptions はサポートされているシンボロジーの中で最も豊富な設定セットを提供します:

  • error_correction_level: QrErrorCorrectionLevel.L (7%), .M (15%), .Q (25%), .H (30%)
  • encoding_mode: QrEncodeMode.AUTO, .NUMERIC, .ALPHANUMERIC, .BYTE, .KANJI
  • version: QR バージョン (1–40)、シンボルサイズを制御
  • mask: 手動選択用のマスクパターン (0–7)
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,
    ),
)
png_bytes = bc.to_png()

EAN と UPC のチェックデジット

Ean13Options、Ean8Options、UpcaOptions、および UpceOptions はそれぞれ allow_check_digit_input プロパティを持ちます。デフォルトでは、ライブラリはデータからチェックデジットを自動的に計算します。データにすでにチェックデジットが含まれている場合は、allow_check_digit_input=True を設定してください。

import aspose_barcode_foss as barcode
from aspose_barcode_foss import Ean13Options

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

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

レンダリングオプション

RenderOptions はすべてのシンボロジーに適用され、視覚的出力を制御します。to_svg() または to_png() に渡してください:

プロパティ型説明
scalefloat均一スケール倍率
dpiintPNG出力の解像度
module_widthfloat1つのバーコードモジュールの幅
module_heightfloat1つのバーコードモジュールの高さ
quiet_zonefloatバーコードの周囲のホワイトスペースパディング
foreground_colorstrバーの Hex カラー(例: "#000000")
background_colorstr背景の Hex カラー
transparent_backgroundboolPNG の透明背景
show_textboolバーコードの下に人が読めるテキストを表示
font_familystr人が読みやすいテキスト用フォント
font_sizefloat人が読みやすいテキスト用フォントサイズ
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",
))

エラーハンドリング

すべてのエンコードオプションの検証は解析時に行われます。無効なデータや互換性のないオプションが提供された場合、ライブラリはエンコードが開始される前に型付き例外をスローします:

  • InvalidInputError — データにシンボロジーでサポートされていない文字が含まれています
  • EncodingError — エンコードに失敗しました(例: データが容量を超えている)
  • SymbologyNotFoundError — generate() に渡された認識できないシンボロジー名
  • UnsupportedCapabilityError — このシンボロジーでは利用できない機能が要求されました

すべての例外クラスは BarcodeError から継承します。


クイックスタート

git clone https://github.com/aspose-barcode-foss/Aspose.BarCode-FOSS-for-Python.git
cd Aspose.BarCode-FOSS-for-Python
pip install -e .

さまざまなエンコードオプションでバーコードを生成し、保存します:

import aspose_barcode_foss as barcode
from aspose_barcode_foss import (
    Code128Options, Code128EncodeMode,
    QrOptions, QrErrorCorrectionLevel,
    RenderOptions,
)

# Code 128 in CODE_C mode (compact digit encoding)
c128 = barcode.code128(
    "9876543210",
    encode=Code128Options(encode_mode=Code128EncodeMode.CODE_C),
)
with open("code128.svg", "w") as f:
    f.write(c128.to_svg())

# QR with high error correction
qr = barcode.qr(
    "https://example.com",
    encode=QrOptions(error_correction_level=QrErrorCorrectionLevel.H),
)
with open("qr.png", "wb") as f:
    f.write(qr.to_png(options=RenderOptions(scale=4.0)))

# EAN-13 with custom colors
ean = barcode.ean13("590123412345")
with open("ean13.svg", "w") as f:
    f.write(ean.to_svg(options=RenderOptions(
        foreground_color="#003366",
        show_text=True,
    )))

サポートされているフォーマット

Symbology型オプション クラス主要プロパティ
Code 1281DCode128Optionsencode_mode
Code 391DCode39Optionsfull_ascii, add_check_digit
EAN-131DEan13Optionsallow_check_digit_input
EAN-81DEan8Optionsallow_check_digit_input
QR Code2DQrOptionserror_correction_level, encoding_mode, version, mask
UPC-A1DUpcaOptionsallow_check_digit_input
UPC-E1DUpceOptionsallow_check_digit_input

出力フォーマット:

フォーマット拡張子Export
SVG.svg✓
PNG.png✓

オープンソース & ライセンス

Aspose.BarCode の Python 用 FOSS は MIT ライセンスです。ソースは GitHub で入手可能です;ソースからビルドしてください。ネイティブ依存関係なし、テレメトリなし、使用制限なし。


はじめに

関連リソース