¶ 问题描述
在加工大尺寸材料时，为了提升定位的精准度，您可以使用 xTool Studio 软件提供的 近景拼图（Close-up Stitching） 功能。该功能通过近景相机对材料的多个位置分别拍照，并拼接成一幅完整的材料图像，从而实现高精度定位。
¶ 问题现象
在使用近景拼图功能后，您可能会发现软件生成的拼接图片出现异常情况，例如：
- 拼接后的图像出现明显的错位、重叠或断裂。
- 图像中部分区域出现缺失、模糊或变形（如下图所示）。
一旦出现该问题，近景拼图功能将无法提供准确的定位信息，进而影响您的加工精度。请不用担心，我们将协助您逐步排查并解决此问题。
¶ 常见原因
导致近景拼图异常的常见原因可能包括：
- 材料表面不够平整。
- 自动测量（Auto-measure）功能出现异常。
- 近景相机定位存在偏差。
- 近景相机硬件故障。
¶ 解决方案
请您按照以下步骤逐一进行排查：
¶ 步骤一：检查并更新软件与固件版本
为确保机器功能的稳定运行，请先确认并将 xTool Studio 软件与 M2 机器固件更新至最新版本。
软件版本：
固件版本：
操作提示：更新完成后，请重启 xTool Studio 软件及 M2 机器，然后再次观察拼接异常问题是否已经消失。
¶ 步骤二：检查材料表面平整度
近景拼图功能仅适用于平整的材料。请您务必确认当前使用的材料表面平坦，没有任何翘曲或曲面变形。
使用自动测量功能验证平整度的方法：
- 在 xTool Studio 中连接您的 M2 机器。
- 将激光头移动到材料的不同位置（例如：左上角、中心、右下角）。
- 分别点击“自动测量”按钮，并记录下每个位置测得的材料厚度值。
- 如果多次测量得到的厚度值相差较大（例如偏差超过
1mm），则说明材料本身不平整或未被水平放置。
解决建议：如果材料不平整，请更换一张确认平整的材料（例如新的标准板材、亚克力等），重新固定并确保材料紧密贴合加工平台。更换后请再次尝试使用近景拼图功能。
¶ 步骤三：执行摄像头定位精度校准
如果您确认材料已经完全平整，但拼接图片依然出现异常，请尝试执行摄像头定位精度校准：
- 连接 M2 机器，点击软件右上角的 “设置”（Settings） 图标。
- 选择 “校准设置”（Calibration Settings）。
- 找到 “摄像头定位精度校准”（Camera positioning accuracy calibration），并点击右侧的 “开始”（Start） 按钮。
- 请按照软件内的教程提示，耐心完成整个校准流程。
操作提示：校准完成后，请重新尝试近景拼图功能，观察拼接效果是否恢复正常。
¶ 步骤四：确认自动测距功能是否正常
自动测距功能所提供的“材料厚度数据”是拼接算法中非常重要的参数。如果测距出现较大偏差，也会直接导致拼接错位。
验证方法：
- 请使用您的个人测量工具（如游标卡尺、千分尺）测量当前加工材料的实际物理厚度。
- 在 xTool Studio 软件中点击“自动测量”按钮，读取软件测试得出的测量厚度值。
- 将“软件测量值”与“实际厚度”进行对比。
- 判断标准：如果两者的偏差 大于
0.5mm，则判定为自动测距功能异常。- 举例说明：以实际厚度为
3mm的椴木板为例，如果软件测距值>3.5mm或<2.5mm，即视为异常。
- 举例说明：以实际厚度为
如果您经过多次尝试，测距偏差仍然大于 0.5mm，请直接联系 xTool 售后技术团队寻求帮助。
¶ 联系 xTool 售后团队
如果您已经完整执行了上述所有的检查（材料平整度、摄像头校准、自动测距验证），但近景拼图的拼接结果依旧异常，这可能是由于近景相机出现了硬件故障。
请联系 xTool 售后团队协助处理。我们的工程师团队在分析后，可能会为您提供更换近景相机的专属解决方案。
为了能够更高效地定位和解决您的问题，请在联系时随信附上以下信息：
- 软件与固件信息：当前的 xTool Studio 软件版本号，以及 M2 固件版本。
- 机器 SN 码：M2 机器的 SN 序列号（位于机器背面标签处）。
- 机器日志 (Work log)：
- 效果图：当前出现异常的近景拼接图片截图或照片。
感谢您的理解与配合，我们将竭诚为您提供技术支持！