ra1nty/DXcam

해결하는 문제

DXcam은 표준 Python 스크린샷 도구의 지연 시간 및 처리량 제한을 극복하는 Windows용 고성능 화면 캡처 라이브러리입니다. 특히 데스크톱 및 전체 화면 Direct3D 애플리케이션의 고FPS, 저지연 캡처 요구를 해결하며, 이는 실시간 AI 에이전트 및 컴퓨터 비전 파이프라인의 병목 지점이 되는 경우가 많습니다.

작동 방식

이 라이브러리는 Windows Desktop Duplication API (DXGI) 및 Windows Graphics Capture (WinRT) 백엔드를 활용하여 GPU에서 직접 프레임을 획득합니다. 두 가지 작동 모드를 제공합니다: 일회성 스냅샷 (grab()) 및 비동기 소비를 위해 프레임을 메모리 내 링 버퍼에 저장하는 연속 캡처 스레드입니다. 성능을 유지하기 위해 버퍼의 제로 카피 뷰와 OpenCV 또는 컴파일된 Cython/NumPy 커널을 통한 선택적 색상 변환을 지원합니다.

대상 사용자

이 도구는 Windows에서 AI 에이전트, 컴퓨터 비전 애플리케이션 또는 고속 비디오 녹화 소프트웨어를 개발하는 개발자를 위해 설계되었으며, 최소한의 CPU 오버헤드로 60 FPS(최대 240+ FPS)를 초과하는 프레임 속도가 필요합니다.

주요 특징

• 극한의 처리량: 1080p에서 240+ FPS를 달성하여 python-mss와 같은 대안보다 훨씬 뛰어납니다.
• 저지연 중심: 저지연 파이프라인 및 전체 화면 독점 Direct3D 앱의 안정적인 캡처를 위해 설계되었습니다.
• 이중 백엔드: 일반 용도로 dxgi를, 커서 렌더링이 필요한 경우 winrt를 지원합니다.
• 유연한 출력: 다양한 색상 모드(RGB, RGBA, BGR, BGRA, GRAY)의 NumPy 배열로 프레임을 반환합니다.
• 리소스 효율성: 고속 캡처 중 불필요한 메모리 할당을 피하기 위해 제로 카피 뷰를 제공합니다.