Preview Time est le point dans un film où commence son aperçu. Un aperçu de film est une version très courte du film, généralement de moins de 5 secondes.
Le fichier définit cet aperçu avec 2 valeurs, un début et une durée. Preview Time est le début, et Preview Duration est la durée. Un indicateur sur chaque piste indique si l’aperçu utilise cette piste.
Quels fichiers le portent
Preview Time se trouve dans l’en-tête de film QuickTime, qui décrit l’ensemble du film. L’en-tête contient aussi l’échelle de temps du film et sa Duration.
QuickTime appelle cette partie du fichier un atome de type mvhd. Le format MP4 a un en-tête du même type et l’appelle une box.
Le lecteur de métadonnées ExifTool lit cet en-tête dans les fichiers QuickTime et dans les formats qu’il appelle basés sur QuickTime. Ces fichiers, par exemple, peuvent afficher Preview Time :
- MOV et QT, le format de film Apple QuickTime
- MP4, le format de fichier MPEG-4
- Fichiers audio et vidéo M4A, M4B, M4P et M4V
- Fichiers audio et vidéo 3GP et 3GPP
- Fichiers F4A, F4B, F4P et F4V pour Adobe Flash Player
- AAX, le format Audible Enhanced Audiobook
Un livre audio AAX peut donc afficher Preview Time même si ce n’est pas une vidéo. Les fichiers AVI sont différents. ExifTool décrit AVI comme basé sur RIFF, et ses listes de valeurs AVI n’incluent pas Preview Time.
À quoi ressemble la valeur
À l’intérieur du fichier, Preview Time est un nombre de 4 octets. Ce nombre compte des unités de l’échelle de temps du film, et non des secondes.
L’échelle de temps est le nombre d’unités par seconde. Avec une échelle de temps de 60, 60 unités font 1 seconde.
ExifTool divise le nombre stocké par l’échelle de temps. Il affiche ensuite le résultat comme une heure, sous l’une de 3 formes :
0 slorsque le nombre stocké est 0- secondes avec 2 décimales et la lettre s, pour un temps inférieur à 30 secondes
- heures, minutes et secondes séparées par des deux-points, pour un temps de 30 secondes ou plus
D'où vient la valeur
Le logiciel qui écrit le fichier vidéo définit Preview Time. La documentation QuickTime d’Apple décrit une fonction qui permet à une application de définir le début et la durée de l’aperçu.
Les fichiers MP4 sont basés sur la norme ISO/IEC 14496-12. Cette norme nomme le même emplacement dans l’en-tête pre_defined et le définit à 0. Un lecteur de métadonnées peut tout de même afficher ces octets comme Preview Time, de sorte qu’un fichier MP4 affiche généralement 0 s.
Certains logiciels écrivent 0 ici. FFmpeg écrit 0 à cet emplacement et l’étiquette comme réservé. Le module d’écriture MP4 du projet de navigateur Chromium écrit également 0.
FFmpeg ignore aussi cette valeur lorsqu’il lit un fichier. Un rapport qui dépend uniquement de FFmpeg n’a donc pas de ligne Preview Time.
Pourquoi cela est important pour votre fichier
Consultez Preview Time avec Preview Duration. Une valeur de 0 s seule ne vous indique pas si le film a un aperçu.
Dans la documentation QuickTime d’Apple, une fonction renvoie 0 pour les deux valeurs lorsqu’un film n’a pas d’aperçu. L’exemple de code d’Apple teste également une durée supérieure à 0 pour décider si un film a un aperçu. Donc, si Preview Duration vaut aussi 0 s, le film n’a pas d’aperçu.
En quoi il diffère de valeurs similaires
D’autres valeurs se trouvent à côté de Preview Time ou portent un nom similaire. Chacune répond à une question différente :
- Preview Duration est la durée de l’aperçu, dans les mêmes unités d’échelle de temps.
- Poster Time est le moment de l’image d’affiche du film, une image fixe qui le représente.
- Preview Image Size est la largeur et la hauteur d’une image d’aperçu à l’intérieur d’un fichier, pas un temps.