Extraer cuadros de vídeo a imágenes (Image Analyst)

Disponible con licencia de Image Analyst.

Resumen

Extrae imágenes de fotograma de vídeo y metadatos asociados de una transmisión de vídeo compatible con FMV. Las imágenes extraídas se pueden agregar a un dataset de mosaico u otras herramientas y funciones para un análisis posterior.

Uso

  • Esta herramienta funciona únicamente con datos de vídeo archivados. Los vídeos de transmisión en directo no son compatibles.

  • Las imágenes de una transmisión de vídeo compatible con FMV se extraen y almacenan en un directorio en formato TIFF, NITF o JPEG.

  • Los metadatos asociados con las imágenes de vídeo se escribirán en un archivo de valores separados por comas (.csv) en el mismo directorio.

Parámetros

EtiquetaExplicaciónTipo de datos
Archivo de vídeo de entrada

Archivo de vídeo de entrada en cualquiera de los formatos de archivo de vídeo compatibles, incluidos PS, TS, MPG, MPEG, MP2, MPG2, MPEG2, MP4, MPG4, MPEG4, H264, VOB y M2TS.

File
Carpeta de salida

Directorio de archivos en el que se guardarán las imágenes y los metadatos de salida.

Folder
Tipo de imagen

Especifica el formato de imagen de salida.

  • JPEGLa salida tendrá el formato de imagen JPEG.
  • TIFFLa salida tendrá el formato de imagen TIFF. Esta es la opción predeterminada.
  • NITFLa salida tendrá el formato de imagen NITF.
String
Porcentaje máximo de superposición
(Opcional)

Porcentaje máximo de superposición entre dos imágenes. Si la superposición entre una imagen candidata y la última imagen escrita en el disco es mayor que este valor, la imagen candidata se ignorará. El porcentaje predeterminado es el 100 por ciento, que escribe todas las imágenes en el disco.

Double
Metadatos nuevos obligatorios
(Opcional)

Especifica si los fotogramas de vídeo con metadatos asociados se extraerán y guardarán.

  • Activado: solo se guardarán los fotogramas de vídeo con metadatos asociados.
  • Desactivado: se guardarán todos los fotogramas de vídeo. Esta es la opción predeterminada.
Boolean
Tiempo mínimo entre entidades
(Opcional)

Intervalo de tiempo mínimo entre los fotogramas de vídeo que se van a guardar. Si no se especifica, todos los fotogramas de vídeo se guardarán como imágenes.

Time Unit

ExtractVideoFramesToImages(in_video, out_folder, image_type, {image_overlap}, {require_fresh_metadata}, {min_time})
NombreExplicaciónTipo de datos
in_video

Archivo de vídeo de entrada en cualquiera de los formatos de archivo de vídeo compatibles, incluidos PS, TS, MPG, MPEG, MP2, MPG2, MPEG2, MP4, MPG4, MPEG4, H264, VOB y M2TS.

File
out_folder

Directorio de archivos en el que se guardarán las imágenes y los metadatos de salida.

Folder
image_type

Especifica el formato de imagen de salida.

  • JPEGLa salida tendrá el formato de imagen JPEG.
  • TIFFLa salida tendrá el formato de imagen TIFF. Esta es la opción predeterminada.
  • NITFLa salida tendrá el formato de imagen NITF.
String
image_overlap
(Opcional)

Porcentaje máximo de superposición entre dos imágenes. Si la superposición entre una imagen candidata y la última imagen escrita en el disco es mayor que este valor, la imagen candidata se ignorará. El porcentaje predeterminado es el 100 por ciento, que escribe todas las imágenes en el disco.

Double
require_fresh_metadata
(Opcional)

Especifica si los fotogramas de vídeo con metadatos asociados se extraerán y guardarán.

  • REQUIRE_FRESH_METADATASolo se guardarán los fotogramas de vídeo con metadatos asociados.
  • NO_REQUIRE_FRESH_METADATASe guardarán todos los fotogramas de vídeo. Esta es la opción predeterminada.
Boolean
min_time
(Opcional)

Intervalo de tiempo mínimo entre los fotogramas de vídeo que se van a guardar. Si no se especifica, todos los fotogramas de vídeo se guardarán como imágenes.

Time Unit

Muestra de código

Ejemplo 1 de ExtractVideoFramesToImages (ventana de Python)

En este ejemplo se extraen imágenes de fotograma de vídeo y metadatos asociados de una transmisión de vídeo y se guardan los datos en un directorio.

arcpy.ia.ExtractVideoFramesToImages(r"c:\test\video.ts", r"C:\temp2\outimages",
"TIFF", 100, "", "20 Seconds")
Ejemplo 2 de ExtractVideoFramesToImages (script independiente)

En este ejemplo se extraen imágenes de fotograma de vídeo y metadatos asociados de una transmisión de vídeo y se guardan los datos en un directorio.

import arcpy
from arcpy.ia import *

arcpy.CheckOutExtension("ImageAnalyst")

in_video = "c:\\test\\drone_vid.ts"
out_folder = "c:\\output"
outformat = "NITF"
maxoverlap = 100
requirefreshmeta = “REQUIRE_FRESH_METADATA” 
mintimebetween = "1 minute"


arcpy.ia.ExtractVideoFramesToImages(in_video, out_folder, outformat, maxoverlap,
requirefreshmeta, mintimebetween)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.