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 では、2 番目のパラメータは作成する AVI ファイルのパスです。
モード 2、3、および 4 では、2 番目のパラメータは既存の出力フォルダーのパスであり、末尾は /（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 サポート（WITH_FFMPEG）付きの OpenCV ビルドが必要になる場合があります。あるいは、生成された AVI ファイルを FFmpeg で変換できます：
 
ffmpeg -i output.avi -c:v libx264 output.mp4
その他のエクスポートサンプル
ZED SDK には、その他の種類のデータをエクスポートするサンプルも用意されています：
PLY 点群：深度センシングサンプル
OBJ 3D メッシュ（空間マッピングから）：空間マッピングサンプル
JSON 形式のセンサーデータ：センサーデータエクスポートサンプル
JSON または FBX 形式のボディトラッキングデータ：ボディトラッキングエクスポートサンプル
サポート
SVO のエクスポートについてサポートが必要な場合は、https://community.stereolabs.com/ のコミュニティフォーラムをご利用ください。