Dicionário

O que é Preview Time?

Preview Time é um valor no cabeçalho de filme QuickTime. Ele marca onde começa uma prévia curta do filme e muitos arquivos, como MP4, mostram 0 s.

preview-time

Preview Time é o ponto de um filme em que sua prévia começa. A prévia de um filme é uma versão bem curta do filme, normalmente com menos de 5 segundos.

O arquivo define essa prévia com 2 valores, um início e um comprimento. Preview Time é o início e Preview Duration é o comprimento. Um sinalizador em cada faixa indica se a prévia usa aquela faixa.

Quais arquivos o carregam

Preview Time fica no cabeçalho do filme QuickTime, que descreve o filme inteiro. O cabeçalho também contém a escala de tempo do filme e sua Duration.

O QuickTime chama essa parte do arquivo de átomo com o tipo mvhd. O formato MP4 tem um cabeçalho do mesmo tipo e o chama de box.

O leitor de metadados ExifTool lê esse cabeçalho em arquivos QuickTime e nos formatos que ele chama de baseados em QuickTime. Esses arquivos, por exemplo, podem mostrar Preview Time:

  • MOV e QT, o formato de filme Apple QuickTime
  • MP4, o formato de arquivo MPEG-4
  • Arquivos de áudio e vídeo M4A, M4B, M4P e M4V
  • Arquivos de áudio e vídeo 3GP e 3GPP
  • Arquivos F4A, F4B, F4P e F4V para o Adobe Flash Player
  • AAX, o formato Audible Enhanced Audiobook

Assim, um audiolivro AAX pode mostrar Preview Time mesmo não sendo um vídeo. Arquivos AVI são diferentes. O ExifTool descreve AVI como baseado em RIFF, e suas listas de valores AVI não incluem Preview Time.

Como é o valor

Dentro do arquivo, Preview Time é um número de 4 bytes. O número conta unidades da escala de tempo do filme, não segundos.

A escala de tempo é o número de unidades por segundo. Com uma escala de tempo de 60, 60 unidades formam 1 segundo.

O ExifTool divide o número armazenado pela escala de tempo. Em seguida, ele mostra o resultado como um horário, em uma de 3 formas:

  • 0 s quando o número armazenado é 0
  • segundos com 2 casas decimais e a letra s, para um tempo abaixo de 30 segundos
  • horas, minutos e segundos separados por dois-pontos, para um tempo de 30 segundos ou mais

De onde vem o valor

O software que grava o arquivo de filme define Preview Time. A documentação do QuickTime da Apple descreve uma função que permite a um aplicativo definir o início e o comprimento da prévia.

Arquivos MP4 são baseados na norma ISO/IEC 14496-12. Essa norma dá ao mesmo lugar no cabeçalho o nome pre_defined e o define como 0. Um leitor de metadados ainda pode mostrar esses bytes como Preview Time, então um arquivo MP4 geralmente mostra 0 s.

Alguns softwares escrevem 0 aqui. O FFmpeg grava 0 nesse lugar e o rotula como reservado. O gravador de MP4 no projeto do navegador Chromium também grava 0.

O FFmpeg também ignora esse valor quando lê um arquivo. Um relatório que depende apenas do FFmpeg portanto não tem linha de Preview Time.

Por que isso é importante para o seu arquivo

Leia Preview Time em conjunto com Preview Duration. Um valor de 0 s sozinho não informa se o filme tem ou não uma prévia.

Na documentação do QuickTime da Apple, uma função retorna 0 para ambos os valores quando um filme não tem prévia. O código de exemplo da Apple também testa por uma duração acima de 0 para decidir se um filme tem prévia. Então, se Preview Duration também for 0 s, o filme não tem prévia.

Como ele difere de valores semelhantes

Outros valores ficam ao lado de Preview Time ou têm um nome parecido. Cada um responde a uma pergunta diferente:

  • Preview Duration é o comprimento da prévia, nas mesmas unidades da escala de tempo.
  • Poster Time é o momento do pôster do filme, um quadro estático que representa o filme.
  • Preview Image Size é a largura e a altura de uma imagem de prévia dentro de um arquivo, não um tempo.