Extraire des images vidéo en images (Outils Image Analyst)

Résumé

Extrait des images vidéo et les métadonnées associées à partir d’un flux vidéo compatible métadonnées. Il est possible d’ajouter les images extraites à un jeu de données mosaïque ou à d’autres outils et fonctions en vue d’une analyse approfondie.

Utilisation

Cet outil fonctionne uniquement avec des données vidéo archivées. Les flux vidéo en direct ne sont pas pris en charge.
Les images d’un flux vidéo compatible métadonnées sont extraites et stockées dans un répertoire au format TIFF, NITF, PNG ou JPEG.
Les métadonnées associées à l’imagerie vidéo sont écrites dans un fichier de valeurs séparées par des virgules (.csv) dans le même répertoire.

Etiqueter	Explication	Type de données
Fichier vidéo en entrée	Fichier vidéo en entrée dans l’un des formats de fichier vidéo pris en charge suivant : `.avi`, `.m2ts`, `.mkv`, `.mov`, `.mp2`, `.mp4`, `.mpeg`, `.mpeg2`, `.mpeg4`, `.mpg`, `.mpg2`, `.mpg4`, `.ps`, `.ts`, `.vob` et `.wmv`.	File
Dossier en sortie	Répertoire de fichiers dans lequel les images en sortie et les métadonnées sont enregistrées.	Folder
Type d’image (Facultatif)	Spécifie le format des images en sortie. JPEG—Les images en sortie sont au format JPEG. TIFF—Les images en sortie sont au format TIFF. Il s’agit de l’option par défaut. NITF—Les images en sortie sont au format NITF. PNG—Les images en sortie sont au format PNG.	String
Pourcentage de superposition maximal (Facultatif)	Pourcentage de superposition maximal entre deux images. Si la superposition entre une image candidate et la dernière image écrite sur le disque est supérieure à cette valeur, l’image candidate est ignorée. Le pourcentage par défaut est de 100 %, ce qui revient à écrire toutes les images sur le disque.	Double
Nouvelles métadonnées requises (Facultatif)	Indique si seules les images vidéo avec des métadonnées associées sont extraites et enregistrées. Activé—Seules les images vidéo avec des métadonnées associées sont enregistrées. Décoché—Toutes les images vidéo sont enregistrées. Il s’agit de l’option par défaut.	Boolean
Temps minimal entre les entités (Facultatif)	Intervalle de temps minimal entre les images vidéo qui sont enregistrées. Si cette valeur n’est pas renseignée, toutes les images vidéo sont enregistrées en tant qu’images.	Time Unit

ExtractVideoFramesToImages(in_video, out_folder, {image_type}, {image_overlap}, {require_fresh_metadata}, {min_time})

Nom	Explication	Type de données
in_video	Fichier vidéo en entrée dans l’un des formats de fichier vidéo pris en charge suivant : `.avi`, `.m2ts`, `.mkv`, `.mov`, `.mp2`, `.mp4`, `.mpeg`, `.mpeg2`, `.mpeg4`, `.mpg`, `.mpg2`, `.mpg4`, `.ps`, `.ts`, `.vob` et `.wmv`.	File
out_folder	Répertoire de fichiers dans lequel les images en sortie et les métadonnées sont enregistrées.	Folder
image_type (Facultatif)	Spécifie le format des images en sortie. `JPEG`—Les images en sortie sont au format JPEG. `TIFF`—Les images en sortie sont au format TIFF. Il s’agit de l’option par défaut. `NITF`—Les images en sortie sont au format NITF. `PNG`—Les images en sortie sont au format PNG.	String
image_overlap (Facultatif)	Pourcentage de superposition maximal entre deux images. Si la superposition entre une image candidate et la dernière image écrite sur le disque est supérieure à cette valeur, l’image candidate est ignorée. Le pourcentage par défaut est de 100 %, ce qui revient à écrire toutes les images sur le disque.	Double
require_fresh_metadata (Facultatif)	Indique si seules les images vidéo avec des métadonnées associées sont extraites et enregistrées. `REQUIRE_FRESH_METADATA`—Seules les images vidéo avec des métadonnées associées sont enregistrées. `NO_REQUIRE_FRESH_METADATA`—Toutes les images vidéo sont enregistrées. Il s’agit de l’option par défaut.	Boolean
min_time (Facultatif)	Intervalle de temps minimal entre les images vidéo qui sont enregistrées. Si cette valeur n’est pas renseignée, toutes les images vidéo sont enregistrées en tant qu’images.	Time Unit

Exemple de code

Exemple 1 d’utilisation de la fonction ExtractVideoFramesToImages (fenêtre Python)

Cet exemple extrait les images vidéo et les métadonnées associées d’un flux vidéo et enregistre les données dans un répertoire.

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

Exemple 2 d’utilisation de la fonction ExtractVideoFramesToImages (script autonome)

Cet exemple extrait les images vidéo et les métadonnées associées d’un flux vidéo et enregistre les données dans un répertoire.

import arcpy
from arcpy.ia import *

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)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence