librealsense 深度相机 SDK 快速上手2.58.2 版从安装到深度流采集 4 个实战场景【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsenselibrealsense 是 Intel 开源的 RealSense 深度相机 SDK当前源码 API 版本 2.58.2见 include/librealsense2/rs.h它负责把 D435、D455 等相机的红外双目数据算成带距离信息的深度图。读完本文你不需要啃 C API 文档就能在 Ubuntu 上装好它、采到第一张深度图并把彩色图像和深度图对齐、录制数据、用滤波后处理补洞。最快上手路径一条命令装 Python 版 源码版两条路线 最省事的路线是用官方 Python 封装包一行命令装完直接跑 examples 示例 里的脚本pip install pyrealsense2验证是否装好python -c import pyrealsense2 as rs; print(rs.__version__)能打印版本号且枚举到设备就算成功。需要自定义编译比如给 Jetson 裁剪、开 CUDA就走源码路线git clone https://gitcode.com/GitHub_Trending/li/librealsense ./scripts/setup_udev_rules.sh cmake ../ -DBUILD_EXAMPLEStrue -DCMAKE_BUILD_TYPERelease make -j$(nproc)详细步骤在 doc/installation.mdUbuntu 用户建议先跑./scripts/patch-realsense-ubuntu-lts-hwe.sh打上 uvcvideo 驱动补丁否则高分辨率深度流可能丢帧。场景一采出第一张深度图和彩色图深度流是这套 SDK 的核心产出相机用两个红外镜头看场景算出每个像素到镜头的距离单位毫米。examples/hello-realsense/ 是最短可运行示例Python 侧只需pipeline rs.pipeline(); frames pipeline.wait_for_frames() depth frames.get_depth_frame(); color frames.get_color_frame()默认参数下 D435 可输出 1280×72030fps 彩色 848×48030fps 深度无需任何配置。想确认相机支持哪些分辨率pipeline.get_stream_profile_list()枚举即可。场景二把彩色图叠到深度图上对齐深度图原始是 848×480彩色是 1280×720两张图坐标系还不一样——直接用会把脸贴错位置。rs.align()把深度拉伸并投影到彩色坐标系之后两个数组逐像素一一对应做 AR 标注、点云着色都是这一步的下游。参考 examples/align/ 的 C 写法Python 里就是一行align.process(frames)。场景三把现场数据录成 bag 文件回放外景采集贵室内调试便宜。rs::save_to_disk/rs::playback把彩色、深度、IMU 全部原始帧存成 .bag 文件回放时逐帧还原连帧序号和时间戳都保留适合回归测试算法。官方示例在 examples/record-playback/录制界面长这样场景四用后处理滤波器把深度图补干净立体视觉算出的原始深度图常有小洞空洞填充滤波器 hole_filling 可补和抖动temporal 时间域滤波器跨帧平滑、spatial 空间域滤波器压噪。三个滤波器在 src/proc/ 下用法统一f rs.hole_filling_filter(); f.set_option(rs.option.radius, 2)实测 D435 近景1 米内加 spatial(radius2)temporal(enabled) 后静态墙面深度噪点明显减少代价是运动物体边缘出现拖影——动态场景建议关掉 temporal。避坑与调优这几个参数直接决定体验 ⚙️Linux 相机不识别9 成是没跑setup_udev_rules.sh或内核没打 uvcvideo 补丁sudo dmesg | tail检查驱动加载。分辨率怎么选距离远、需要细节就上 1280×720 彩色 最高深度只要前景避障640×40030 足够且 CPU 占用减半。内存注意源码编译时gcc: internal compiler error多半是内存不够VM 里给到 2GB 以上再编译。多相机一台主机接多路 D 系列相机时用 examples/multicam/ 的序列号区分设备别依赖枚举顺序。高级模式需要调发射器功率、自动曝光等底层参数用 rs_advanced_mode 接口examples/sensor-control/。资源索引与展望Python 封装与 20 个可运行脚本在 wrappers/python/C 官方 API 头文件在 include/librealsense2/故障排查看 doc/troubleshooting.md。librealsense 同时覆盖 Windows、Linux、Android 与 Jetson 平台装好包、跑通第一帧剩下的就是按你的场景调参数了。【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考