Converter timecode em frames

Editores de vídeo, coloristas, operadores de QC e engenheiros de pipeline alternam constantemente entre o timecode legível no estilo SMPTE e os contadores inteiros de frames que NLEs, fazendas de render e ferramentas de legenda realmente indexam. Um erro de um frame no dígito FF ou um desalinhamento de framerate pode colocar um corte no frame errado, quebrar um EDL ou deslocar uma legenda por um segundo inteiro. Este conversor aceita uma string non-drop HH:MM:SS:FF mais um framerate inteiro do projeto e devolve o número total de frames a partir de zero, ou recebe um contador total e reconstrói um timecode com zeros à esquerda. Quando o dígito de frame FF é maior ou igual ao framerate, a solicitação falha com invalid_input em vez de envolver o valor em silêncio.

Como o timecode non-drop se mapeia para o número total de frames

O caminho inverso decompõe com divisão inteira e resto: FF é frames módulo fps; em seguida os segundos inteiros restantes são repartidos em horas, minutos e segundos com o relógio usual de base sessenta. Escolha o fps inteiro que corresponda ao seu projeto (vinte e quatro, vinte e cinco, trinta, quarenta e oito, cinquenta, sessenta e similares) e mantenha os rótulos coerentes em todas as ferramentas que leem o mesmo material. O timecode non-drop no estilo SMPTE rotula cada frame com horas, minutos, segundos e um dígito de frame dentro do segundo atual. A um framerate inteiro constante fps, cada segundo completo contribui com exatamente fps frames, cada minuto com sessenta segundos e cada hora com três mil e seiscentos segundos. A conversão multiplica portanto a parte de relógio do rótulo por fps e soma o dígito de frame: frames é igual a ((horas vezes três mil e seiscentos mais minutos vezes sessenta mais segundos) vezes fps) mais FF. A contagem base zero começa em 00:00:00:00 como frame zero, de modo que 00:00:01:00 a trinta frames por segundo é o frame trinta, e 00:01:00:00 a trinta fps é o frame mil e oitocentos. Este endpoint implementa apenas essa aritmética non-drop; não aplica as regras de salto drop-frame do NTSC para vinte e nove ponto nove sete, porque essas regras alteram o rótulo sem mudar da mesma forma a fórmula subjacente da contagem.

Contrato de entrada, regras de validação e campos da resposta

As horas podem ir de zero a nove mil novecentos e noventa e nove; minutos e segundos devem ficar entre zero e cinquenta e nove. O inverso com frames mil e oitocentos e o mesmo fps reconstrói 00:01:00:00. Envie por POST um corpo JSON com direction, framerate e timecode ou frames. A direção to_frames (aliases frames, tc_to_frames) exige uma string de timecode HH:MM:SS:FF; dois-pontos ou ponto e vírgula são aceitos como separadores, mas a matemática é sempre non-drop. A direção to_timecode (aliases timecode, frames_to_tc) exige um campo frames inteiro não negativo. O framerate deve ser um inteiro de um a duzentos e quarenta frames por segundo. A regra editorial crítica se aplica ao dígito de frame: FF deve satisfazer zero menor ou igual a FF e FF estritamente menor que framerate. Em caso de sucesso o corpo ecoa direction e framerate, devolve um timecode normalizado com padding de zeros, o inteiro total de frames, os componentes decompostos de horas, minutos, segundos e frame, e uma string curta de fórmula que reafirma a identidade non-drop. Exemplo: direction to_frames, framerate trinta, timecode 00:01:00:00 produz frames mil e oitocentos.