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

Disponible con licencia de Image Analyst.

Resumen

Extrae imágenes de cuadros de vídeo y los metadatos asociados de una transmisión de vídeo que se ajusta a 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 con datos de vídeo archivados solamente. No se admiten vídeos de transmisión en directo.

  • Las imágenes de transmisiones de vídeo compatibles con FMV se extraerán y almacenarán 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) del mismo directorio.

Parámetros

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

Archivo de vídeo de entrada en cualquier formato de archivo de vídeo admitido, incluidos PS, TS, MPG, MPEG, MP2, MPG2, MPEG2, MP4, MPG4, MPEG4, H264, H265, VOB y M2TS.

File
Carpeta de salida

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

Folder
Tipo de imagen
(Opcional)

Especifica el formato de la imagen de salida.

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

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

Double
Metadatos nuevos obligatorios
(Opcional)

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

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

Intervalo mínimo de tiempo entre cuadros de vídeo que se va a guardar. Si no se especifica ningún valor, todos los cuadros 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 cualquier formato de archivo de vídeo admitido, incluidos PS, TS, MPG, MPEG, MP2, MPG2, MPEG2, MP4, MPG4, MPEG4, H264, H265, VOB y M2TS.

File
out_folder

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

Folder
image_type
(Opcional)

Especifica el formato de la imagen de salida.

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

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

Double
require_fresh_metadata
(Opcional)

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

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

Intervalo mínimo de tiempo entre cuadros de vídeo que se va a guardar. Si no se especifica ningún valor, todos los cuadros de vídeo se guardarán como imágenes.

Time Unit

Muestra de código

Ejemplo 1 de ExtractVideoFramesToImages (ventana Python)

En este ejemplo se extraen cuadros 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 cuadros 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.

Información de licenciamiento

  • Basic: Requiere Image Analyst
  • Standard: Requiere Image Analyst
  • Advanced: Requiere Image Analyst

Temas relacionados