YStudio Y++

二维码支持库

Y++ / YStudio 开发文档 · 一点滴

路径：支持库 → 二维码支持库。

硬约束

  1. 扁平命令；生成结果为 PNG/BMP 字节集，可赋图片框或交图片支持库再处理。
  2. 前景/背景/渐变/LOGO/静区/点阵为进程内全局，影响后续所有 二维码_生成*；用 二维码_清除样式() 复位。
  3. 失败：字节集空 / 逻辑假 / 整数 0 / 文本空；查 二维码_取最后错误()。
  4. 边长 64–2048（默认 256）；纠错 0L · 1M(默认) · 2Q · 3H。

快速开始

二维码_清除样式()
二维码_置前景色("#FF1565C0")
二维码_置背景色("#FFFFFFFF")
字节集 图 = 二维码_生成网址("example.com", 280, 1)
图片框1.图片 = 图

生成

本分类共 12 条。

二维码_生成

  • 签名：字节集 二维码_生成(文本 内容, [整数 边长=256], [整数 纠错=1], [整数 格式=0])
  • 说明：生成二维码。格式 0=PNG 1=BMP。纠错 0=L 1=M 2=Q 3=H。边长 64–2048。
  • 参数一│内容
  • 参数二│[边长]: 默认 256
  • 参数三│[纠错]: 0–3，默认 1（M）
  • 参数四│[格式]: 0=PNG 1=BMP，默认 0

二维码_生成BMP

  • 签名：字节集 二维码_生成BMP(文本 内容, [整数 边长=256], [整数 纠错=1])
  • 说明：生成 BMP 字节集（同 二维码_生成 但固定 BMP 格式）。
  • 参数一│内容
  • 参数二│[边长]: 默认 256
  • 参数三│[纠错]: 0–3，默认 1

二维码_生成WiFi

  • 签名：字节集 二维码_生成WiFi(文本 SSID, [文本 密码=""], [整数 加密=1], [逻辑 隐藏=假], [整数 边长=256], [整数 纠错=1])
  • 说明：生成 WiFi 连接码。加密 0=开放 1=WPA/WPA2 2=WEP；密码空则开放。
  • 参数一│SSID
  • 参数二│[密码]: 默认空（开放网络）
  • 参数三│[加密]: 0/1/2，默认 1
  • 参数四│[隐藏]: 默认假
  • 参数五│[边长]: 默认 256
  • 参数六│[纠错]: 0–3，默认 1

二维码_生成到文件

  • 签名：逻辑 二维码_生成到文件(文本 内容, 文本 路径, [整数 边长=256], [整数 纠错=1], [整数 格式=0])
  • 说明：生成并写入文件。格式 0=PNG 1=BMP。
  • 参数一│内容
  • 参数二│路径
  • 参数三│[边长]: 默认 256
  • 参数四│[纠错]: 0–3
  • 参数五│[格式]: 0=PNG 1=BMP

二维码_生成文本

  • 签名：字节集 二维码_生成文本(文本 内容, [整数 边长=256], [整数 纠错=1])
  • 说明：生成纯文本二维码（与 二维码_生成 等价，语义更明确）。
  • 参数一│内容
  • 参数二│[边长]: 默认 256
  • 参数三│[纠错]: 0–3，默认 1

二维码_生成电话

  • 签名：字节集 二维码_生成电话(文本 号码, [整数 边长=256], [整数 纠错=1])
  • 说明：生成 tel: 拨号码二维码。自动忽略空格、横线等分隔符。
  • 参数一│号码
  • 参数二│[边长]: 默认 256
  • 参数三│[纠错]: 0–3，默认 1

二维码_生成短信

  • 签名：字节集 二维码_生成短信(文本 号码, [文本 内容=""], [整数 边长=256], [整数 纠错=1])
  • 说明：生成 sms: 二维码。内容非空时附带 body 参数。
  • 参数一│号码
  • 参数二│[内容]: 默认空
  • 参数三│[边长]: 默认 256
  • 参数四│[纠错]: 0–3，默认 1

二维码_生成网址

  • 签名：字节集 二维码_生成网址(文本 网址, [整数 边长=256], [整数 纠错=1])
  • 说明：生成网址二维码。无 http(s):// 时自动补 https://。
  • 参数一│网址
  • 参数二│[边长]: 默认 256
  • 参数三│[纠错]: 0–3，默认 1

二维码_生成邮件

  • 签名：字节集 二维码_生成邮件(文本 地址, [文本 主题=""], [文本 正文=""], [整数 边长=256], [整数 纠错=1])
  • 说明：生成 mailto: 二维码。主题/正文自动 URL 编码。
  • 参数一│地址
  • 参数二│[主题]: 默认空
  • 参数三│[正文]: 默认空
  • 参数四│[边长]: 默认 256
  • 参数五│[纠错]: 0–3，默认 1

二维码_识别

  • 签名：文本 二维码_识别(字节集 图像)
  • 说明：从图像识别第一个二维码文本（内置 quirc）。失败返回空。
  • 参数一│图像

二维码_识别全部

  • 签名：文本数组 二维码_识别全部(字节集 图像)
  • 说明：识别图像中全部二维码，返回文本数组（按检测顺序）。
  • 参数一│图像

二维码_识别数量

  • 签名：整数 二维码_识别数量(字节集 图像)
  • 说明：返回图像中检测到的二维码个数（未解码）。无码返回 0。
  • 参数一│图像

样式

本分类共 9 条。

二维码_清除样式

  • 签名：通用 二维码_清除样式()
  • 说明：恢复默认：黑前景、白背景、无渐变、无 LOGO、静区 4、方块点阵。
  • 签名：逻辑 二维码_置LOGO(字节集 图像, [整数 占比=20])
  • 说明：居中叠 LOGO。空字节清除。占比 8–30（相对边长百分比）。
  • 参数一│图像
  • 参数二│[占比]: 8–30，默认 20

二维码_置LOGO底色

  • 签名：逻辑 二维码_置LOGO底色(文本 颜色)
  • 说明：LOGO 衬底颜色。空=恢复白色。
  • 参数一│颜色

二维码_置前景色

  • 签名：逻辑 二维码_置前景色(文本 颜色)
  • 说明：设置模块颜色。#RRGGBB / #AARRGGBB；空=恢复黑色。
  • 参数一│颜色

二维码_置圆角

  • 签名：逻辑 二维码_置圆角(整数 半径)
  • 说明：圆角方块模式的圆角半径，0–50（相对模块边长百分比）。
  • 参数一│半径: 0–50，默认 30

二维码_置渐变

  • 签名：逻辑 二维码_置渐变(文本 起始色, 文本 结束色, [整数 方向=0])
  • 说明：前景渐变。结束色为空则关闭。方向 0 水平 · 1 垂直 · 2 对角。
  • 参数一│起始色
  • 参数二│结束色
  • 参数三│[方向]: 0/1/2，默认 0

二维码_置点阵样式

  • 签名：逻辑 二维码_置点阵样式(整数 模式)
  • 说明：模块外观：0 方块 · 1 圆点 · 2 圆角方块。
  • 参数一│模式: 0/1/2

二维码_置背景色

  • 签名：逻辑 二维码_置背景色(文本 颜色)
  • 说明：设置底色。空=恢复白色。
  • 参数一│颜色

二维码_置静区

  • 签名：逻辑 二维码_置静区(整数 模块数)
  • 说明：设置静区宽度（模块数）。范围 0–8，默认 4。
  • 参数一│模块数: 0–8

信息

本分类共 4 条。

二维码_取最后错误

  • 签名：文本 二维码_取最后错误()
  • 说明：最近一次失败原因。

二维码_取最大容量

  • 签名：整数 二维码_取最大容量(整数 纠错, [整数 编码=0])
  • 说明：返回指定纠错下最大可编码量（版本 40）。编码 0=字节 1=数字 2=字母数字。
  • 参数一│纠错: 0–3
  • 参数二│[编码]: 0/1/2，默认 0

二维码_取模块数

  • 签名：整数 二维码_取模块数(文本 内容, [整数 纠错=1])
  • 说明：返回编码后的模块边长（21–177，不含静区）。失败返回 0。
  • 参数一│内容
  • 参数二│[纠错]: 0–3，默认 1

二维码_取版本

  • 签名：整数 二维码_取版本(文本 内容, [整数 纠错=1])
  • 说明：返回编码该内容所需的 QR 版本号（1–40）。失败返回 0。
  • 参数一│内容
  • 参数二│[纠错]: 0–3，默认 1

常量速查

项 取值
纠错 0L · 1M(默认) · 2Q · 3H
格式 0PNG · 1BMP
WiFi 加密 0开放 · 1WPA/WPA2 · 2WEP
渐变方向 0水平 · 1垂直 · 2对角
点阵样式 0方块 · 1圆点 · 2圆角方块

易错对照

错误 正确
改样式却不清 换风格前可 二维码_清除样式
失败不查错误 二维码_取最后错误()

相关

图片支持库 · 编码支持库