@好男孩008/标签化-wasm
这个 标签 编入WebAssembly的ZPL/EPL/TSPL/CPCL/DPL标签引擎. 将 ZPL, ESL, TSPL/ TSC, CPCL 或 DPL 标签数据完全在浏览器、 Node.js 或您的 捆绑者——不需要服务器.
使用量
Bundlers (网页包 5, Vite 带有 vite-plugin-wasm(中文(简体) )
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)
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 .
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呼叫者得到准确的解析错误而不是赤裸
抛出字符串 :
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 图形)通过
通过字节换字节,所以格式化的源使像素-等同:
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.
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 以重建引擎:
cd wasm && ./build.sh # requires Rust wasm32 target + wasm-bindgen-cli
许可证
麻省理工学院和BSD-3级