From 9d1aea516ed35ef27c77ce7062cba81a0530225b Mon Sep 17 00:00:00 2001
From: Ben <987807597@qq.com>
Date: Sun, 5 Jul 2026 23:41:11 -0700
Subject: [PATCH] =?UTF-8?q?=E8=BF=9B=E5=BA=A6:=E8=AE=B0=E5=BD=95=20FillLas?=
 =?UTF-8?q?erPoint=20=E4=BF=AE=E6=AD=A3=E4=B8=8E=E7=AE=A1=E9=81=93?=
 =?UTF-8?q?=E9=87=8D=E5=AE=9A=E5=90=91=E4=B8=8B=E6=94=B6=E5=B0=BE=E6=AE=B5?=
 =?UTF-8?q?=E9=94=99=E8=AF=AF=E7=9A=84=E5=B7=B2=E7=9F=A5=E6=80=AA=E7=99=96?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/PROGRESS.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/docs/PROGRESS.md b/docs/PROGRESS.md
index 57b2695..a718414 100644
--- a/docs/PROGRESS.md
+++ b/docs/PROGRESS.md
@@ -1,5 +1,26 @@
 # VizumCameraKit 进度
 
+### 2026-07-05 点云栅格化修正:启用 SDK 激光点填充
+
+Scope:
+- CapturePointCloudWithAutoDetect 在 BeginDetectLaser 后新增
+  `VzNL_EnableFillLaserPoint(handle, VzTrue)`(VZNL_DetectLaser.h:307,SDK 默认不填充)。
+- 根因:默认模式下每条激光线只回传检出点、长度不一,软件侧左对齐拼 W×H 网格时
+  列向错位(同列不代表同横向位置)。启用填充后 SDK 输出定长线(无测量处填占位点),
+  回调侧 scanLine 本就保留全部点,网格自然列对齐,MatchVerify 的 cloud.txt 栅格随之正确。
+
+Verification:
+```
+kit 与 MatchVerify 重编译通过;kit_smoke 终端运行退出码 0 全流程正常。
+待实机:采一次点云,确认日志"收到扫描线 N 个点"各线等长、cloud.txt 网格列对齐。
+```
+
+Known quirk(与本次改动无关,业务无影响):
+- kit_smoke 在 stdout 重定向到管道(>/dev/null 或 >file)时,业务流程完整跑完
+  ("SDK destroyed"已打印、main 已返回)后进程收尾阶段段错误(139);
+  终端直跑恒为退出码 0。疑为 VzNL DLL 卸载时其日志组件写已关闭管道所致。
+  GUI 程序不受影响;自动化脚本调用 kit_smoke 时以日志内容而非退出码判断成败。
+
 ### 2026-07-05 模块建立(从 Mark3DCalibration 毕业)
 
 Scope: