
3 步跑通 RealSense 深度相机【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense机器人要绕开障碍、机械臂要抓起物件前提都是手里有一份可靠的距离数据。librealsenseRealSense SDK 2.0把深度相机的彩色/深度流、标定参数和后处理封装成跨平台 C 库Python、C#、ROS 等语言都有绑定在 Ubuntu 上打好内核补丁你就能拿到第一帧深度图。 最快出图从克隆到第一帧深度数据第 1 步拉仓库。不想从源码编译的话官方 Releases 也提供预编译包但源码路线最透明git clone https://gitcode.com/GitHub_Trending/li/librealsense cd librealsense第 2 步装设备权限和内核驱动。RealSense 在 Linux 上必须打 uvcvideo 内核补丁先拔下相机再依次跑权限脚本和内核补丁脚本Ubuntu 20/22/24 LTS 用 hwe 版本./scripts/setup_udev_rules.sh ./scripts/patch-realsense-ubuntu-lts-hwe.sh踩坑提示udev 脚本和内核补丁脚本运行时相机必须是拔出状态插着跑容易装错规则。跑完用sudo dmesg | tail -n 50确认新的 uvcvideo 驱动已注册。第 3 步编译安装带上示例mkdir build cd build cmake ../ -DBUILD_EXAMPLEStrue make -j$(nproc) sudo make install安装后rs-hello-realsense会落到/usr/local/bin直接运行终端开始滚动输出画面中心像素的距离米——这就是你的第一帧深度数据。想看多路画面再启动realsense-viewer 深度图噪点怎么调后处理滤波器与高级模式原始深度图天生带毛刺边缘噪点、逐帧抖动、局部空洞。SDK 提供一组后处理滤波器各解决一个问题decimation_filter下采样深度图用分辨率换帧率spatial_filter空间去噪压孤立噪点、锐化边缘temporal_filter时序平滑抑制帧间抖动hole_fill_filter填补深度空洞。典型顺序是先 decimation 再 spatial/temporalrs-post-processing 示例 可直接演示各滤波器叠加后的差异。如果你的深度和彩色分辨率不一致跑 align 示例 做 depth-to-color 对齐后面做分割、检测才不会对不上像素。D400 系列相机还支持高级模式激光功率、曝光时间、深度置信度阈值都能精确调整且参数持久化掉电不丢。文档见 D400 高级模式参数界面如下踩坑提示spatial/temporal 等级不是越高越好开太高等级会让深度边缘糊掉、物体轮廓变圆。从 1 级加起对着真实物体看效果。 完整案例双相机量箱子长宽高场景是物流分拣线入库验收纸箱过线系统自动输出长宽高替代人工卡尺。仓库里的box_dimensioner_multicam示例用两台 RealSense 深度相机从两个视角拍同一个箱子配合棋盘格标定出相机位姿Kabsch 解算最终输出箱子三维尺寸。输入两台深度相机、示例自带的pattern_chessboard.png棋盘格、HighResHighAccuracyPreset.json高分辨率预设输出数值化的长宽高结果适用于物流、仓储、体积计价等场景。pip install pyrealsense2 cd wrappers/python/examples/box_dimensioner_multicam python box_dimensioner_multicam_demo.py⚠️ 四个高频卡点设备识别、依赖与平台1. 插相机后完全找不到设备。原因内核 uvcvideo 驱动未打补丁相机枚举异常。解法重跑./scripts/patch-realsense-ubuntu-lts-hwe.sh再查sudo dmesg | tail -n 50是否出现新驱动注册信息。2. 报Multiple realsense udev-rules were found!。原因Debian 包和源码安装并存udev 规则重复。解法二选一源码安装可用./scripts/setup_udev_rules.sh --uninstall卸掉多余规则。3. 编译报openssl/opensslv.h缺失或fastrtps、curl依赖错误。原因系统构建依赖不全。解法装libssl-dev与 DDS 或版本检查无关的项目分别用-DBUILD_WITH_DDSOFF、-DCHECK_FOR_UPDATESOFF关掉。4. 虚拟机里相机不识别或流卡死。原因USB 3.0 虚拟化层限制官方不支持 VM 环境。解法换真机必须用 VM 时选 VMware 的 USB3 仿真并核对内核版本是否受支持。 继续深入文档与示例入口文档总索引Linux 安装手册后处理滤波器详解录制与回放.db3 格式示例代码总览Python 绑定与示例OpenCV Kinect Fusion 三维重建示例故障排除API 头文件rs.hpp把你的目标测量距离和帧率要求换算成 decimation 与 spatial 的等级重跑一次 rs-post-processing再用 Depth Quality 工具 对比填充率和精度再定最终参数。【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考