realsenseai/librealsense

이것이 무엇인가

RealSense SDK 2.0(librealsense 라이브러리)은 Intel RealSense 깊이 카메라와 통신하기 위한 오픈소스, 크로스 플랫폼 C++ SDK입니다. 프로그램이 동기화된 컬러 및 깊이 스트림을 캡처하고, 카메라 내부/외부 파라미터를 쿼리하며, 포인트 클라우드 생성, 깊이 품질 측정, 장치 구성과 같은 고급 도구에 액세스할 수 있게 합니다.

왜 중요한가

깊이 인식은 로보틱스, 3D 스캐닝, AR/VR, 드론, 생체 인식 애플리케이션의 핵심 구성 요소입니다. 안정적이고 잘 문서화된 API(Python, C#, ROS 2, Unity 등의 래퍼 제공)를 제공하고 Windows, Linux, macOS, Android, Jetson, 심지어 AMD GPU 가속을 지원함으로써, librealsense는 개발자가 저수준 드라이버 코드를 작성하지 않고도 프로젝트에 신뢰할 수 있는 3D 비전을 쉽게 추가할 수 있게 합니다.

시작하는 방법

사전 컴파일된 SDK – 최신 릴리스 번들을 다운로드하고, RealSense 카메라를 연결한 후, 포함된 도구(RealSense Viewer, Depth Quality Tool)를 실행합니다.
소스에서 빌드 – 저장소를 클론하고, cmake .. 및 cmake --build .를 실행하여 플랫폼용 라이브러리를 컴파일합니다. 자세한 OS별 가이드는 README에 링크되어 있습니다.
Python 래퍼 설치 – pip install pyrealsense2(안정 버전) 또는 최신 빌드용 pyrealsense2-beta.

예제 사용법 (C++ 및 Python)

#include <librealsense2/rs.hpp>
rs2::pipeline p; p.start();
while (true) {
    auto frames = p.wait_for_frames();
    auto depth = frames.get_depth_frame();
    float d = depth.get_distance(depth.get_width()/2, depth.get_height()/2);
    std::cout << "center distance: " << d << " m\r";
}

import pyrealsense2 as rs
pipe = rs.pipeline(); pipe.start()
while True:
    frames = pipe.wait_for_frames()
    depth = frames.get_depth_frame()
    w, h = depth.get_width(), depth.get_height()
    d = depth.get_distance(w//2, h//2)
    print(f"center distance: {d:.3f} m", end="\r")

두 스니펫 모두 파이프라인을 열고, 프레임을 가져오고, 이미지 중심의 깊이를 읽습니다.

누가 사용해야 하는가

로보틱스 엔지니어 – 실시간 깊이가 필요한 내비게이션 또는 조작 시스템을 구축하는 분.
컴퓨터 비전 연구자 – 3D 재구성 또는 SLAM을 위해 보정된 컬러-깊이 데이터가 필요한 분.
AR/VR, 드론 또는 생체 인식 시스템 개발자 – 정확한 거리 감지에 의존하는 분.
교육자 및 취미 개발자 – 여러 언어로 된 예제가 포함된 즉시 사용 가능한 SDK를 원하는 분.

위 정보는 저장소의 README에서 직접 가져온 것입니다.