¿Cómo convierto archivos SVO a AVI o a secuencias de imágenes/profundidad?
Last updated: August 13, 2026
El formato de archivo SVO es un formato propietario que solo puede ser leído por el ZED SDK y sus herramientas. Almacena las imágenes no rectificadas de la cámara junto con metadatos como marcas de tiempo, datos de sensores (IMU, barómetro, magnetómetro, cuando están disponibles) y, a partir del formato SVO2 introducido en ZED SDK 4.1, datos de sensores de alta frecuencia y datos personalizados definidos por el usuario.
SVO/SVO2 es el único formato de vídeo aceptado como entrada por el ZED SDK; otros formatos de vídeo (AVI, MP4, etc.) no se pueden utilizar con el SDK. Sin embargo, puedes exportar fácilmente un archivo SVO a formatos estándar para uso externo.
Ejemplo de exportación SVO
El ejemplo ZED SVO Export muestra cómo convertir un archivo SVO en:
- un vídeo AVI (LEFT+RIGHT lado a lado, o vista LEFT+DEPTH)
- una secuencia de imágenes PNG (vista LEFT+RIGHT, LEFT+DEPTH o LEFT+DEPTH de 16 bits)
La secuencia de profundidad de 16 bits almacena los valores de profundidad en milímetros como archivos PNG de 16 bits, lo que resulta útil para el procesamiento sin conexión de datos de profundidad métricos.
El ejemplo está disponible en C++, Python y C# en GitHub: https://github.com/stereolabs/zed-sdk/tree/master/recording/export/svo
También se instala una copia con el ZED SDK en la carpeta local samples:
- Windows:
C:\Program Files (x86)\ZED SDK\samples\recording\export\svo - Linux:
/usr/local/zed/samples/recording/export/svo
Modos de exportación
| Modo | Salida |
|---|---|
| 0 | Vídeo AVI LEFT+RIGHT |
| 1 | Vídeo AVI de vista LEFT+DEPTH |
| 2 | Secuencia de imágenes PNG LEFT+RIGHT |
| 3 | Secuencia de imágenes PNG de vista LEFT+DEPTH |
| 4 | Secuencia de imágenes PNG de 16 bits LEFT+DEPTH |
Uso de la herramienta de C++
El ejemplo es una herramienta de línea de comandos con la siguiente sintaxis:
ZED_SVO_Export
Notas:
- Para los modos 0 y 1, el segundo parámetro es la ruta del archivo AVI que se creará.
- Para los modos 2, 3 y 4, el segundo parámetro es la ruta de una carpeta de salida existente y debe terminar con
/ (Linux) o \ (Windows).
Ejemplos:
Windows (desde la carpeta que contiene el ejecutable compilado):
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 (desde la carpeta de compilación):
./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
Uso del script de Python
La misma conversión se puede realizar con el script de Python svo_export.py, sin compilar nada:
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 es obligatorio para los modos 0 y 1.--output_path_dir es obligatorio para los modos 2, 3 y 4, y debe apuntar a una carpeta existente.
Ejemplos:
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/
Exportación a MP4 u otros formatos de video
El ejemplo utiliza OpenCV VideoWriter para generar el archivo AVI. Si quieres exportar a otro contenedor/códec (por ejemplo, MP4), puedes modificar la configuración del códec en el código de ejemplo; dependiendo de tu plataforma, esto puede requerir una compilación de OpenCV con compatibilidad con FFmpeg (WITH_FFMPEG). Como alternativa, puedes convertir el archivo AVI generado con FFmpeg:
ffmpeg -i output.avi -c:v libx264 output.mp4
Otros ejemplos de exportación
El ZED SDK también proporciona ejemplos para exportar otros tipos de datos:
- Nubes de puntos PLY: ejemplo de detección de profundidad
- Mallas 3D OBJ procedentes del mapeo espacial: ejemplo de mapeo espacial
- Datos de sensores como JSON: ejemplo de exportación de sensores
- Datos de seguimiento del cuerpo como JSON o FBX: ejemplos de exportación de seguimiento del cuerpo
Asistencia
Si necesitas asistencia con la exportación de SVO, visita nuestro foro de la comunidad en https://community.stereolabs.com/.