# @goodboy008/labelize-wasm 中文文档

规范地址：https://npmcn.com/package/%40goodboy008/labelize-wasm/

版本：1\.12\.0
npm 元数据更新时间：2026-11-12T11:09:16.193Z
中文译文更新时间：2026-11-16T19:13:02.239Z
软件包许可：MIT AND BSD-3-Clause

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40goodboy008/labelize-wasm
原文对照：https://npmcn.com/package/%40goodboy008/labelize-wasm/?lang=original
项目主页：https://github.com/GOODBOY008/labelize
源码仓库：https://github.com/GOODBOY008/labelize

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：6.5 MB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：0 个
- 首次发布：2026-08-23T04:42:32.229Z
- 最新版本发布：2026-11-12T11:09:15.929Z
- 近 30 天下载量：4680（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

标签化 ZPL/EPL/TSPL/CPCL/DPL 标签渲染器编译到WebAssembly-在浏览器,Node.js和捆绑器中将标签数据给PNG/PDF

## 安装

```sh
npm install @goodboy008/labelize-wasm
```

也可以使用：`pnpm add @goodboy008/labelize-wasm`、`yarn add @goodboy008/labelize-wasm`、`bun add @goodboy008/labelize-wasm`

## README

![Labelize logo](https://raw.githubusercontent.com/GOODBOY008/labelize/main/docs/logo-icon.svg)

# @好男孩008/标签化-wasm

这个 [标签](https://github.com/GOODBOY008/labelize) 编入WebAssembly的ZPL/EPL/TSPL/CPCL/DPL标签引擎. 将 ZPL, ESL, TSPL/ TSC, CPCL 或 DPL 标签数据完全在浏览器、 Node.js 或您的 捆绑者——不需要服务器.

## 使用量

### Bundlers (网页包 5, Vite 带有 `vite-plugin-wasm`(中文(简体) )

```js
import { lz_render } from "@goodboy008/labelize-wasm";

const zpl = new TextEncoder().encode("^XA^FO50,50^A0N,40,40^FDHELLO WORLD^FS^XZ");
const png = lz_render(zpl, 102.0, 152.0, 8, false, false, false);
// png is a Uint8Array — pass it to an <img> via URL.createObjectURL
```

软件包是标准hem-bindgen捆绑器输出 : `labelize_wasm.js` 初始化 模块顶层的引擎和导出 `lz_render` 编号 : `lz_render_lang` 编号 : `lz_playground_html`。 。 。 .

### 节点.js( ·20)

```js
import { lz_render } from "@goodboy008/labelize-wasm/init";

const zpl = Buffer.from("^XA^FO50,50^A0N,40,40^FDHELLO WORLD^FS^XZ", "ascii");
const png = lz_render(zpl, 102.0, 152.0, 8, false, false, false);
```

这个 `/init` 子路径将引擎从包件中即时化 `.wasm` 直接, 没有捆绑者支持或节点旗帜.

### API 密码

`lz_render(src, width_mm, height_mm, dpmm, antialias, want_pdf, is_epl) -> Uint8Array`

| 段落 | 含义 |
| --- | --- |
| `src` | 原始标签字节( ZPL 或 ESL 当 `is_epl = true`(中文(简体) ) |
| `width_mm` 编号 : `height_mm` | 以毫米计的标签帆布大小( 默认: 102 × 152) |
| `dpmm` | 每毫米点数( 默认 8) |
| `antialias` | 将渲染器灰色保持为 1- 位 |
| `want_pdf` | 返回 PDF 而不是 PNG |
| `is_epl` | 解析输入为 IPL 而不是 ZPL |

`lz_render_lang(src, width_mm, height_mm, dpmm, antialias, want_pdf, lang) -> Uint8Array` 这是 语言解释性变体: `lang` 实值 `"zpl"`, (中文(简体) ), `"epl"`, (中文(简体) ), `"tspl"`, (中文(简体) ), `"cpcl"`,或 `"dpl"` (TSPL/TSC和CPCL标签;标签本身) `SIZE` 在 TSPL 中不覆盖 `width_mm`编号 :`height_mm` 你通过 - 大小画布像任何其他 输入). 未知 `lang` 值返回到 ZPL .

```js
import { lz_render_lang } from "@goodboy008/labelize-wasm/init";

const tspl = Buffer.from('SIZE 101.6 mm,152.4 mm\nCLS\nTEXT 40,40,"4",0,1,1,"HELLO WORLD"\nPRINT 1', "ascii");
const png = lz_render_lang(tspl, 101.6, 152.4, 8, false, false, "tspl");
```

丢出带有失败阶段的字符串前缀错误 : `1:` 分析错误, `2:` 渲染错误.

`lz_validate(src, dpmm, lang) -> string` 语法检查没有渲染,而且从未投出—— jSON报告载有结果,所以SDK呼叫者得到准确的解析错误而不是赤裸 抛出字符串 :

```js
import { lz_validate } from "@goodboy008/labelize-wasm/init";

const report = JSON.parse(lz_validate(src, 8, "")); // "" = auto-detect the language
// { language: "zpl", ok: true,  labels: 1 }
// { language: "epl", ok: false, labels: 0, error: "Parse error: EPL X command requires 5 parameters, got 2" }

if (!report.ok) console.error(`[${report.language}] ${report.error}`);
```

`lz_format(src, lang) -> Uint8Array` 相当的打印来源: 每行一个命令, `^XA` 区块缩进, CRLF 规范化。 二进制有效载荷`^FD` 数据, `GW`编号 :`BITMAP` 图形)通过 通过字节换字节,所以格式化的源使像素-等同:

```js
import { lz_format } from "@goodboy008/labelize-wasm/init";

const pretty = new TextDecoder().decode(lz_format(src, "")); // "" = auto-detect
```

`lz_encode(src, dpmm, threshold, lang) -> Uint8Array` 转换已编码的图像 (PNG/JPEG/GIF/BMP)改为打印机代码. `lang` 必须是 `"zpl"` 或者说 `"tspl"` (对案件不敏感); 不支持的目标、无效的图像和无效的选项 `1:` 输入出错. 一个图像像素变成一个打印机点. 阈值默认由调用者提供: 128使128平面下复合光度为黑色;透明像素平面为白色. 编码输入尊重 EXIF 方向 。 图像限于16个米像素,32000 每个维度点和128个已解码数据的米B.

```js
import { readFileSync, writeFileSync } from "node:fs";
import { lz_encode } from "@goodboy008/labelize-wasm/init";

const source = readFileSync("logo.png");
writeFileSync("logo.zpl", lz_encode(source, 8, 128, "zpl"));
writeFileSync("logo.tspl", lz_encode(source, 8, 128, "tspl")); // binary BITMAP payload
```

生成的 ZPL 在 Zebra 内部需要时使用多个图形字段 999999字节字段限制. 对于匹配的 ZPL 预览,请将画布设置为图像 宽度/ 高度除以 `dpmm` 以毫米计。 TSPL本身宣布这个尺寸.

`lz_playground_html() -> string` 返回标签游戏页面(与 HTTP 服务器 `/`) (中文(简体) ).

## 释放资产

GitHub 发布也附加 `labelize-wasm-wasm32.zip` 与生胶 + `.wasm` 文档, 用于无 npm 的直接使用。 见 `wasm/build.sh` 以重建引擎:

```bash
cd wasm && ./build.sh   # requires Rust wasm32 target + wasm-bindgen-cli
```

## 许可证

麻省理工学院和BSD-3级

## 常见问题

### @goodboy008/labelize-wasm 是什么？

标签化 ZPL/EPL/TSPL/CPCL/DPL 标签渲染器编译到WebAssembly-在浏览器,Node\.js和捆绑器中将标签数据给PNG/PDF

### 如何安装 @goodboy008/labelize-wasm？

在项目目录运行 npm install @goodboy008/labelize-wasm，或使用 pnpm add / yarn add / bun add。

### @goodboy008/labelize-wasm 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @goodboy008/labelize-wasm 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @goodboy008/labelize-wasm 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @goodboy008/labelize-wasm 可以商用吗？

@goodboy008/labelize-wasm 使用 MIT AND BSD-3-Clause 许可。声明的许可为 MIT AND BSD-3-Clause，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @goodboy008/labelize-wasm 的下载量有多少？

根据 npm 官方下载统计，@goodboy008/labelize-wasm 在 2026/10/17 – 2026/11/15 这 30 天内被下载 4,680 次，日均约 156 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @goodboy008/labelize-wasm 还在维护吗？

最新版本 1\.12\.0 发布于 2026/11/12（4 天前）；至今共发布 12 个版本，其中过去 12 个月发布了 12 个；首次发布于 2026/08/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

