SVO 파일을 AVI 또는 이미지/깊이 시퀀스로 변환하려면 어떻게 해야 하나요?

Last updated: August 13, 2026

SVO 파일 형식은 ZED SDK와 해당 도구에서만 읽을 수 있는 독점 형식입니다. 카메라의 보정되지 않은 이미지와 타임스탬프, 센서 데이터(사용 가능한 경우 IMU, 기압계, 자력계) 등의 메타데이터를 저장하며, ZED SDK 4.1에서 도입된 SVO2 형식부터는 고주파 센서 데이터와 사용자 정의 데이터도 저장합니다.

SVO/SVO2는 ZED SDK에서 입력으로 허용되는 유일한 비디오 형식이며, 다른 비디오 형식(AVI, MP4 등)은 SDK에서 사용할 수 없습니다. 하지만 외부 사용을 위해 SVO 파일을 표준 형식으로 쉽게 내보낼 수 있습니다.

SVO 내보내기 샘플

ZED SVO Export 샘플은 SVO 파일을 다음 형식으로 변환하는 방법을 보여줍니다.

AVI 비디오(좌우 나란히 배치된 LEFT+RIGHT 또는 LEFT+DEPTH 보기)
PNG 이미지 시퀀스(LEFT+RIGHT, LEFT+DEPTH 보기 또는 LEFT+DEPTH 16비트)

16비트 깊이 시퀀스는 깊이 값을 밀리미터 단위의 16비트 PNG 파일로 저장하므로, 미터법 깊이 데이터의 오프라인 처리에 유용합니다.

샘플은 GitHub에서 C++, Python 및 C#으로 제공됩니다: https://github.com/stereolabs/zed-sdk/tree/master/recording/export/svo

복사본은 ZED SDK와 함께 로컬 samples 폴더에도 설치됩니다.

Windows: C:\Program Files (x86)\ZED SDK\samples\recording\export\svo
Linux: /usr/local/zed/samples/recording/export/svo

내보내기 모드

모드	출력
0	LEFT+RIGHT AVI 비디오
1	LEFT+DEPTH 보기 AVI 비디오
2	LEFT+RIGHT PNG 이미지 시퀀스
3	LEFT+DEPTH 보기 PNG 이미지 시퀀스
4	LEFT+DEPTH 16비트 PNG 이미지 시퀀스

C++ 도구 사용

샘플은 다음 구문을 사용하는 명령줄 도구입니다:

ZED_SVO_Export   
참고:
모드 0과 1의 경우 두 번째 매개변수는 생성할 AVI 파일의 경로입니다.
모드 2, 3, 4의 경우 두 번째 매개변수는 기존 출력 폴더의 경로이며, Linux에서는 /, Windows에서는 \로 끝나야 합니다.
예시:
Windows(빌드된 실행 파일이 포함된 폴더에서):
 
ZED_SVO_Export.exe "C:\path\to\your\file.svo2" "C:\Users\YOUR-USER-NAME\Desktop\output.avi" 0
ZED_SVO_Export.exe "C:\path\to\your\file.svo2" "C:\Users\YOUR-USER-NAME\Desktop\sequence\" 2
Linux(빌드 디렉터리에서):
 
./ZED_SVO_Export "/path/to/your/file.svo2" "/home/YOUR-USER-NAME/Desktop/output.avi" 0
./ZED_SVO_Export "/path/to/your/file.svo2" "/home/YOUR-USER-NAME/Desktop/sequence/" 4
Python 스크립트 사용
아무것도 컴파일하지 않고 Python 스크립트 svo_export.py를 사용하여 동일한 변환을 수행할 수 있습니다:
 
python svo_export.py --mode  --input_svo_file  --output_avi_file 
python svo_export.py --mode  --input_svo_file  --output_path_dir 
--output_avi_file은 모드 0과 1에서 필수입니다.
--output_path_dir은 모드 2, 3, 4에서 필수이며, 기존 폴더를 가리켜야 합니다.
예시:
 
python svo_export.py --mode 0 --input_svo_file recording.svo2 --output_avi_file output.avi
python svo_export.py --mode 4 --input_svo_file recording.svo2 --output_path_dir ./depth_sequence/
MP4 또는 기타 비디오 형식으로 내보내기
이 샘플은 OpenCV VideoWriter를 사용하여 AVI 파일을 생성합니다. 다른 컨테이너/코덱(예: MP4)으로 내보내려면 샘플 코드에서 코덱 설정을 수정할 수 있습니다. 플랫폼에 따라 FFmpeg를 지원하는 OpenCV 빌드(WITH_FFMPEG)가 필요할 수 있습니다. 또는 FFmpeg를 사용하여 생성된 AVI 파일을 변환할 수 있습니다:
 
ffmpeg -i output.avi -c:v libx264 output.mp4
기타 내보내기 샘플
ZED SDK는 다른 유형의 데이터를 내보내기 위한 샘플도 제공합니다:
PLY 포인트 클라우드: 깊이 감지 샘플
OBJ 3D 메시(공간 매핑에서): 공간 매핑 샘플
JSON 형식의 센서 데이터: 센서 내보내기 샘플
JSON 또는 FBX 형식의 바디 트래킹 데이터: 바디 트래킹 내보내기 샘플
지원
SVO 내보내기에 대한 도움이 필요하면 https://community.stereolabs.com/의 커뮤니티 포럼을 방문하세요.