Come posso convertire i file SVO in AVI o in sequenze di immagini/profondità?
Last updated: August 13, 2026
Il formato di file SVO è un formato proprietario che può essere letto solo dallo ZED SDK e dai relativi strumenti. Memorizza le immagini non rettificate della fotocamera insieme a metadati come timestamp, dati dei sensori (IMU, barometro, magnetometro, quando disponibili) e, a partire dal formato SVO2 introdotto in ZED SDK 4.1, dati dei sensori ad alta frequenza e dati personalizzati definiti dall'utente.
SVO/SVO2 è l'unico formato video accettato come input dallo ZED SDK; altri formati video (AVI, MP4, ecc.) non possono essere utilizzati con lo SDK. Tuttavia, è possibile esportare facilmente un file SVO in formati standard per uso esterno.
Esempio di esportazione SVO
L'esempio ZED SVO Export illustra come convertire un file SVO in:
- un video AVI (vista LEFT+RIGHT affiancata o vista LEFT+DEPTH)
- una sequenza di immagini PNG (vista LEFT+RIGHT, LEFT+DEPTH o LEFT+DEPTH a 16 bit)
La sequenza di profondità a 16 bit memorizza i valori di profondità in millimetri come file PNG a 16 bit, utili per l'elaborazione offline dei dati di profondità metrici.
L'esempio è disponibile in C++, Python e C# su GitHub: https://github.com/stereolabs/zed-sdk/tree/master/recording/export/svo
Una copia viene installata anche con lo ZED SDK nella cartella locale samples:
- Windows:
C:\Program Files (x86)\ZED SDK\samples\recording\export\svo - Linux:
/usr/local/zed/samples/recording/export/svo
Modalità di esportazione
| Modalità | Output |
|---|---|
| 0 | Video AVI LEFT+RIGHT |
| 1 | Video AVI vista LEFT+DEPTH |
| 2 | Sequenza di immagini PNG LEFT+RIGHT |
| 3 | Sequenza di immagini PNG vista LEFT+DEPTH |
| 4 | Sequenza di immagini PNG LEFT+DEPTH a 16 bit |
Utilizzo dello strumento C++
L'esempio è uno strumento da riga di comando con la seguente sintassi:
ZED_SVO_Export
Note:
- Per le modalità 0 e 1, il secondo parametro è il percorso del file AVI da creare.
- Per le modalità 2, 3 e 4, il secondo parametro è il percorso di una cartella di output esistente e deve terminare con
/ (Linux) o \ (Windows).
Esempi:
Windows (dalla cartella contenente l'eseguibile compilato):
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 (dalla directory di compilazione):
./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
Utilizzo dello script Python
La stessa conversione può essere eseguita con lo script Python svo_export.py, senza compilare nulla:
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 è obbligatorio per le modalità 0 e 1.--output_path_dir è obbligatorio per le modalità 2, 3 e 4 e deve puntare a una cartella esistente.
Esempi:
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/
Esportazione in MP4 o altri formati video
L'esempio utilizza OpenCV VideoWriter per generare il file AVI. Se desideri esportare in un altro contenitore/codec (ad esempio MP4), puoi modificare le impostazioni del codec nel codice di esempio; a seconda della piattaforma, ciò potrebbe richiedere una compilazione di OpenCV con il supporto FFmpeg (WITH_FFMPEG). In alternativa, puoi convertire il file AVI generato con FFmpeg:
ffmpeg -i output.avi -c:v libx264 output.mp4
Altri esempi di esportazione
ZED SDK fornisce anche esempi per esportare altri tipi di dati:
- Nuvole di punti PLY: esempio di sensori di profondità
- Mesh 3D OBJ dalla mappatura spaziale: esempio di mappatura spaziale
- Dati dei sensori come JSON: esempio di esportazione dei sensori
- Dati del tracciamento del corpo come JSON o FBX: esempi di esportazione del tracciamento del corpo
Supporto
Se hai bisogno di assistenza con l'esportazione SVO, visita il nostro forum della comunità all'indirizzo https://community.stereolabs.com/.