产品类库

一、类库简介

`loquat.barcode` 是一个功能完整的条码生成和解析 COM 对象，支持多种一维和二维条码格式，专为 VBA/VB6 设计。

二、类库特征

## 🎨 支持的条码类型

### 一维条码 (1D)

- Code 128

- Code 39

- Code 93

- EAN-8 / EAN-13

- UPC-A / UPC-E

- ITF (Interleaved 2 of 5)

- ITF-14

- Codabar

- MSI Plessey

- DataBar (RSS)

### 二维条码 (2D)

- QR Code

- Data Matrix

- PDF417

- Aztec Code

- MaxiCode

## 🔧 特效选项详细说明

 条码特效文档

三、使用简介

Dim barcode As Object
Set barcode = CreateObject("loquat.barcode")

' 生成条码
Dim result As String
result = barcode.Generate("QRCode", "Hello World", "{""width"":200,""height"":200}")

' 解析条码
result = barcode.Decode(imageBase64, "{""try_harder"":true}")

四、详细说明

 1、生成条码

 Generate - 生成条码图像

 result = barcode.Generate(barcodeType, content, options)

**参数**：

- `barcodeType` (BSTR): 条码类型

 - 一维：`"Code128"`, `"Code39"`, `"EAN13"`, `"UPC-A"`, `"ITF"`, `"Codabar"`, `"Code93"` 等

 - 二维：`"QRCode"`, `"DataMatrix"`, `"PDF417"`, `"Aztec"` 等

- `content` (BSTR): 条码内容

- `options` (BSTR, 可选): JSON 选项字符串，默认 `"{}"`

**返回值** (JSON):

```json

{

 "success": true,

 "data": {

 "image_base64": "iVBORw0KGgo...",

 "format": "PNG",

 "width": 200,

 "height": 200,

 "mime_type": "image/png"

 },

 "error": ""

}

```

**选项参数** (options JSON):

```json

{

 "width": 200, // 宽度（像素），0=自动

 "height": 200, // 高度（像素），0=自动

 "scale": 1.0, // 缩放比例

 "margin": 10, // 边距（像素）

 "foreground_color": "#000000", // 前景色

 "background_color": "#FFFFFF", // 背景色

 "transparent": false, // 透明背景

 "show_text": true, // 显示文本

 "text_position": "bottom", // 文本位置

 "format": "PNG", // 输出格式: "PNG", "JPEG", "SVG"

 "error_correction": "H", // 错误纠正级别（仅 QR Code）: "L", "M", "Q", "H"

 "gradient_type": "linear", // 渐变类型: "none", "linear", "radial", "rainbow"

 "gradient_colors": ["#FF0000", "#0000FF"], // 渐变颜色

 "logo_path": "C:\\\\\\\\logo.png", // Logo 路径（仅二维码）

 "logo_size": 0.2, // Logo 大小比例（0.0-0.4）

 "module_shape": "square", // 模块形状: "square", "circle", "rounded", "diamond"

 "shadow_enabled": false, // 启用阴影

 "shadow_offset_x": 3, // 阴影 X 偏移

 "shadow_offset_y": 3, // 阴影 Y 偏移

 "shadow_color": "#00000080" // 阴影颜色（支持透明度）

}

```

 GenerateToFile - 生成条码文件

result = barcode.GenerateToFile(barcodeType, content, filePath, options)

**参数**：

- `barcodeType` (BSTR): 条码类型

- `content` (BSTR): 条码内容

- `filePath` (BSTR): 输出文件路径

- `options` (BSTR, 可选): JSON 选项字符串

**返回值** (JSON):

```json

{

 "success": true,

 "data": {

 "file_path": "C:\\\\\\\\output.png",

 "format": "PNG",

 "width": 200,

 "height": 200

 },

 "error": ""

}

```

 2、解析条码

 Decode - 从Base64图像解码条码

result = barcode.Decode(imageBase64, options)

**参数**：

- `imageBase64` (BSTR): Base64 编码的图像数据

- `options` (BSTR, 可选): JSON 选项字符串

**返回值** (JSON):

```json

{

 "success": true,

 "data": {

 "barcodes": [

 {

 "type": "QRCode",

 "content": "Hello World",

 "format": "QR_CODE",

 "points": [[10, 10], [200, 10], [200, 200], [10, 200]],

 "confidence": 1.0

 }

 ],

 "count": 1

 },

 "error": ""

}

```

**选项参数** (options JSON):

```json

{

 "try_harder": true, // 更努力尝试（更慢但更准确）

 "multiple": false, // 是否查找多个条码

 "formats": [], // 指定格式（空数组=全部）

 "contrast": 1.0, // 对比度调整（1.0=原始）

 "brightness": 1.0, // 亮度调整（1.0=原始）

 "rotation": 0, // 旋转角度（0, 90, 180, 270）

 "auto_rotate": false, // 自动旋转

 "grayscale": false, // 转灰度

 "invert": false, // 反转颜色

 "region": { // 扫描区域限制（可选）

 "x": 0,

 "y": 0,

 "width": 100,

 "height": 100

 }

}

```

 DecodeFromFile - 从文件解码条码

result = barcode.DecodeFromFile(filePath, options)

 DecodeFromBytes - 从字节数组解码条码

result = barcode.DecodeFromBytes(imageData, options)

 3、辅助方法

 GetSupportedTypes - 获取支持的条码类型列表

result = barcode.GetSupportedTypes("all") ' 或 "1d", "2d", "generate", "decode"

**返回值** (JSON):

```json

{

 "success": true,

 "data": {

 "types": [

 {

 "name": "QRCode",

 "display_name": "QR Code",

 "category": "2d",

 "can_generate": true,

 "can_decode": true,

 "max_length": 2953,

 "min_length": 1

 }

 ]

 },

 "error": ""

}

```

 ValidateContent - 验证条码内容

result = barcode.ValidateContent("EAN13", "1234567890123")

**返回值** (JSON):

```json

{

 "success": true,

 "data": {

 "valid": true,

 "error": ""

 },

 "error": ""

}

 SetDebug - 设置调试模式

barcode.SetDebug True ' 或 False

 SetDebugLogPath - 设置调试日志文件路径

result = barcode.SetDebugLogPath("C:\\\\temp\\\\barcode_debug.log")

 GetSystemFonts - 获取系统字体列表

result = barcode.GetSystemFonts()

 SetSIMDEnabled - 设置 SIMD 优化开关

barcode.SetSIMDEnabled True ' 需要 CPU 支持 AVX2

 GetSIMDStatus - 获取 SIMD 状态信息

result = barcode.GetSIMDStatus()

**返回值** (JSON):

```json

{

 "success": true,

 "data": {

 "enabled": true,

 "cpu_has_avx2": true,

 "active": true

 },

 "error": ""

}

```

 4、批量操作

 BatchGenerate - 批量生成条码

Dim requests As String

requests = "[{""type"":""QRCode"",""content"":""Content1"",""options"":{}},{""type"":""Code128"",""content"":""Content2"",""options"":{}}]"

result = barcode.BatchGenerate(requests)

**返回值** (JSON):

```json

{

 "success": true,

 "data": {

 "results": [

 {"success": true, "image_base64": "...", "index": 0},

 {"success": false, "error": "...", "index": 1}

 ]

 },

 "error": ""

}

```

 BatchDecode - 批量解码条码

Dim images As String

images = "[{""image_base64"":""..."",""options"":{}},{""file_path"":""C:\\\\\\\\test.png"",""options"":{}}]"

result = barcode.BatchDecode(images)

五、下载地址

 统一下载地址