Aspose.BarCode FOSS
よくある質問

よくある質問

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

Aspose.BarCode FOSS for Python はどのライセンスを使用していますか？

Aspose.BarCode FOSS for Python は MIT ライセンスの下でリリースされています。完全なライセンス文は、パッケージに同梱されている LICENSE ファイルに含まれています。オープンソースプロジェクトでも商用プロジェクトでも、ライブラリを使用、修正、再配布することが自由です。

商用製品で Aspose.BarCode FOSS を使用できますか？

はい。MIT ライセンスは、元のライセンス表示を含めること以外にロイヤリティや帰属表示の要求なしに商用利用を許可します。アプリケーションをオープンソースにする必要はありません。

インストール & 必要条件

Aspose.BarCode FOSS for Python をインストールするにはどうすればよいですか？

以下のコマンドでインストールしてください：

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

このライブラリは Python 3.12 以降が必要です。

ネイティブの依存関係やシステムパッケージは必要ですか？

いいえ。Aspose.BarCode FOSS for Python は純粋な Python パッケージです。ネイティブ拡張や C の依存関係はなく、インストールすべきシステムレベルのパッケージもありません。Windows、macOS、Linux で動作します — python:3.12-slim のようなスリムな Docker イメージも含みます。

シンボロジーサポート

サポートされているバーコードシンボロジーは何ですか？

このライブラリは 7 つのシンボロジーをサポートしています：

Symbology型Options クラス
Code 1281DCode128Options
Code 391DCode39Options
EAN-131DEan13Options
EAN-81DEan8Options
QR Code2DQrOptions
UPC-A1DUpcaOptions
UPC-E1DUpceOptions

各シンボロジーには専用のヘルパー関数（code128()、code39()、ean13()、ean8()、qr()、upca()、upce()）と、シンボロジー名文字列を受け取る汎用のgenerate()関数があります。

利用可能な出力形式は何ですか？

このライブラリはバーコードを SVG と PNG に出力します:

  • to_svg() — SVG 文字列を返します
  • to_png() — PNG バイト列を返します

両方のメソッドは、スケール、DPI、色、クワイエットゾーン、ヒューマンリーダブルテキストを制御するためのオプションのRenderOptionsパラメータを受け取ります。

API Usage

バーコードはどうやって生成しますか？

シンボロジーごとのヘルパー関数を使用してください:

import aspose_barcode_foss as barcode

bc = barcode.code128("Hello World")
svg = bc.to_svg()

with open("barcode.svg", "w") as f:
    f.write(svg)

または汎用の generate() 関数を使用してください:

bc = barcode.generate("qr", "https://example.com")

エンコードオプションはどのように設定しますか？

各シンボロジーには専用のオプションクラスがあります。encode パラメータとして渡してください:

from aspose_barcode_foss import QrOptions, QrErrorCorrectionLevel

bc = barcode.qr(
    "https://example.com",
    encode=QrOptions(error_correction_level=QrErrorCorrectionLevel.H),
)

バーコードの視覚的外観はどのように制御しますか？

RenderOptions を to_svg() または to_png() と組み合わせて使用してください:

from aspose_barcode_foss import RenderOptions

bc = barcode.code128("DATA")
png = bc.to_png(options=RenderOptions(
    scale=3.0,
    dpi=300,
    foreground_color="#003366",
    show_text=True,
))

使用可能なプロパティ: scale, dpi, module_width, module_height, quiet_zone, foreground_color, background_color, transparent_background, show_text, font_family, font_size.

ライブラリは EAN および UPC バーコードのチェックデジットをどのように処理しますか？

デフォルトでは、ライブラリがチェックデジットを自動的に計算します。ペイロードの数字だけを指定してください（EAN-13 は 12 桁、EAN-8 は 7 桁、UPC-A は 11 桁）:

bc = barcode.ean13("590123412345")  # 12 digits — check digit computed

事前に計算したチェックデジットを指定するには、allow_check_digit_input=True を設定してください：

from aspose_barcode_foss import Ean13Options

bc = barcode.ean13(
    "5901234123457",  # 13 digits with check digit
    encode=Ean13Options(allow_check_digit_input=True),
)

既知の制限事項

PDF 出力はサポートされていますか？

いいえ。to_pdf() メソッドと PdfRenderer クラスは API の表面に存在しますが、NotImplementedError を発生させます。代わりに to_svg() または to_png() を使用してください。SVG 出力は外部ツールを使用して PDF 文書に埋め込むことができます。

ECI と GS1 規格はサポートされていますか？

まだ対応していません。EciHelper と Gs1Helper クラスには、NotImplementedError を発生させるメソッドスタブが用意されています。EncodeOptions の eci_assignment_number と gs1_enabled プロパティは存在しますが、現在のリリースでは機能していません。

ライブラリはバーコードの読み取りやスキャンができますか？

No. Aspose.BarCode FOSS for Python は生成のみのライブラリです。データからバーコードを生成しますが、バーコードの認識やスキャン機能は含まれていません。

参照

 日本語