YStudio Y++

车牌类

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

类对象支持库。路径:支持库 → 扩展类库 → 车牌类。

类型名写「车牌类」。声明时自动创建。

基于 HyperLPR3(Apache-2.0)ONNX 模型 + 动态加载 ONNX Runtime,从图片字节集识别中国车牌。含运动门控与同一车牌去重。适合固定机位、道闸/停车场等近拍场景;角度与距离主要靠现场布置,不作为代码层硬矫正卖点。

通用截图文字请用 OCR类,二者不要混用场景。

  • 能力包:plugins/supportlib.plate/
  • 收费位:supportlib.plate(仅开发期验票;发行程序不再验票)
  • 系统:Windows 10 / 11(推荐)
  • 模型与 onnxruntime.dll:见插件内 models/、ort/,或运行 build\fetch_plate_assets.ps1

快速开始

车牌类 plate
如果 (!plate.打开()) {
    信息框(plate.取错误())
    返回()
}

摄像头类 cam
如果 (!cam.打开(0)) {
    信息框("打开摄像头失败")
    返回()
}

' 定时器或循环中:
字节集 帧 = cam.取一帧()
文本 号 = plate.识别(帧)
如果 (号 != "") {
    输出(号 + " " + plate.取颜色() + " " + 到文本(plate.取置信度()))
}

须先 打开() 成功再识别;同一对象可连续识别,不用每次打开。

模型与自研

方法 说明
置模型目录 含 onnx 的目录;空则自动找插件 models
置检测模型 / 置识别模型 / 置分类模型 覆盖文件名或绝对路径(二次训练权重)
置引擎目录 onnxruntime.dll 目录
置检测尺寸 320 或 640(默认 640)

默认文件名:y5fu_640x_sim.onnx、rpv3_mdict_160_r3.onnx、litemodel_cls_96x_r1.onnx。自研权重只要输入输出约定一致即可替换。

过车相关

方法 说明
置运动检测 / 置运动阈值 画面变化不足时跳过识别(演示静态图请先关;道闸过车可开)
置去重秒数 同一车牌号冷却,避免重复上报
识别 含运动门控 + 去重
识别全部 多行全部车牌;仍受运动门控,不受去重限制
取框左 / 取框上 / 取框宽 / 取框高 最近一次检测框(相对图像素);可配合描边画框
取颜色 / 取车牌类型 / 取置信度 / 取错误 最近一次结果与失败原因
是否有运动 / 重置运动 / 清除去重 辅助控制

摄像头只负责取帧;是否连续抓拍由定时器/循环决定。

连续识别时建议在业务层做「短窗投票 + 结果锁定」:锁定期间丢弃晃动误读,画面无牌若干帧后再解锁接下一辆(见示例「车牌识别演示」)。库内 置去重秒数 只抑制同号连报,挡不住「读成另一个号」。

外场正式枪机用 RTSP(视频类 打开后再取帧);本机 USB 用 摄像头类。示例工程可切换两种视频源。

注意

  • 未放置模型或引擎时,打开 失败,错误见 取错误(用户句以「车牌类:…」开头)。
  • 远距离、大角度、高速模糊会明显掉精度——请用合适镜头与机位。
  • 未引用本类时,ORT/模型不会进入用户程序链接图。
  • 示例:examples/车牌识别演示/。