Convertire timecode in frame

Montatori, colorist, operatori di controllo qualità e ingegneri di pipeline passano continuamente dal timecode leggibile in stile SMPTE ai contatori interi di frame che NLE, render farm e strumenti di sottotitoli indicizzano davvero. Un errore di un frame sulla cifra FF o un disallineamento di framerate può collocare un taglio sul frame sbagliato, rompere un EDL o spostare una didascalia di un secondo intero. Questo convertitore accetta una stringa non-drop HH:MM:SS:FF più un framerate intero di progetto e restituisce il numero totale di frame da zero, oppure prende un contatore totale e ricostruisce un timecode con zeri a sinistra. Quando la cifra di frame FF è maggiore o uguale al framerate, la richiesta fallisce con invalid_input invece di avvolgere il valore in silenzio.

Come il timecode non-drop si mappa sul numero totale di frame

Il conteggio a base zero inizia a 00:00:00:00 come frame zero, così 00:00:01:00 a trenta frame al secondo è il frame trenta, e 00:01:00:00 a trenta fps è il frame mille ottocento. Il percorso inverso decompone con divisione intera e resto: FF è frames modulo fps; poi i secondi interi rimanenti si ripartiscono in ore, minuti e secondi con l'orologio usuale in base sessanta. Scelga l'fps intero che corrisponde al Suo progetto (ventiquattro, venticinque, trenta, quarantotto, cinquanta, sessanta e simili) e mantenga etichette coerenti su tutti gli strumenti che leggono lo stesso media. Il timecode non-drop in stile SMPTE etichetta ogni frame con ore, minuti, secondi e una cifra di frame all'interno del secondo corrente. A un framerate intero costante fps, ogni secondo completo contribuisce esattamente con fps frame, ogni minuto con sessanta secondi e ogni ora con tremila seicento secondi. La conversione moltiplica quindi la parte orologio dell'etichetta per fps e aggiunge la cifra di frame: frames è uguale a ((ore per tremila seicento più minuti per sessanta più secondi) per fps) più FF. Questo endpoint implementa solo quell'aritmetica non-drop; non applica le regole di salto drop-frame NTSC per ventinove virgola nove sette, perché tali regole cambiano l'etichetta senza modificare allo stesso modo la formula sottostante del conteggio.

Contratto di ingresso, regole di validazione e campi di risposta

Le ore possono andare da zero a novemilanovecentonovantanove; minuti e secondi devono stare tra zero e cinquantanove. L'inverso con frames mille ottocento e lo stesso fps ricostruisce 00:01:00:00. Invii con POST un corpo JSON con direction, framerate e timecode oppure frames. La direzione to_frames (alias frames, tc_to_frames) richiede una stringa di timecode HH:MM:SS:FF; due punti o punto e virgola sono accettati come separatori, ma la matematica è sempre non-drop. La direzione to_timecode (alias timecode, frames_to_tc) richiede un campo frames intero non negativo. Il framerate deve essere un intero da uno a duecentoquaranta frame al secondo. La regola editoriale critica si applica alla cifra di frame: FF deve soddisfare zero minore o uguale a FF e FF strettamente minore di framerate. In caso di successo il corpo ripete direction e framerate, restituisce un timecode normalizzato con zeri a sinistra, l'intero totale di frames, i componenti decomposti di ore, minuti, secondi e frame, e una breve stringa di formula che riafferma l'identità non-drop. Esempio: direction to_frames, framerate trenta, timecode 00:01:00:00 produce frames mille ottocento.

Dove un'API di timecode a frame esatto crea valore

Poiché l'implementazione è pure parse di livello A, ogni chiamata riuscita costa il prezzo base pubblicato $0.002 senza token di modello e senza rete in uscita, e la validazione fallita non consuma il saldo.