timecode.c 4.94 KB
Newer Older
1 2 3 4 5 6 7
/*
 * Copyright (C) 2006 Smartjog S.A.S, Baptiste Coudurier <baptiste.coudurier@gmail.com>
 * Copyright (C) 2011 Smartjog S.A.S, Clément Bœsch      <clement.boesch@smartjog.com>
 *
 * This file is part of FFmpeg.
 *
 * FFmpeg is free software; you can redistribute it and/or
8 9 10
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
11 12 13 14
 *
 * FFmpeg is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15
 * Lesser General Public License for more details.
16
 *
17
 * You should have received a copy of the GNU Lesser General Public
18 19
 * License along with FFmpeg; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20
 */
21 22 23 24

/**
 * @file
 * Timecode helpers
25
 * This *private* API is deprecated, please use the one available in libavutil instead.
26 27
 */

28 29 30 31
#include "version.h"

#if FF_API_OLD_TIMECODE

32 33 34 35
#include <stdio.h>
#include "timecode.h"
#include "libavutil/log.h"

36
int avpriv_framenum_to_drop_timecode(int frame_num)
37 38 39 40 41 42 43 44
{
    /* only works for NTSC 29.97 */
    int d = frame_num / 17982;
    int m = frame_num % 17982;
    //if (m < 2) m += 2; /* not needed since -2,-1 / 1798 in C returns 0 */
    return frame_num + 18 * d + 2 * ((m - 2) / 1798);
}

45
uint32_t avpriv_framenum_to_smpte_timecode(unsigned frame, int fps, int drop)
46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62
{
    return (0                                    << 31) | // color frame flag
           (drop                                 << 30) | // drop  frame flag
           ( ((frame % fps) / 10)                << 28) | // tens  of frames
           ( ((frame % fps) % 10)                << 24) | // units of frames
           (0                                    << 23) | // field phase (NTSC), b0 (PAL)
           ((((frame / fps) % 60) / 10)          << 20) | // tens  of seconds
           ((((frame / fps) % 60) % 10)          << 16) | // units of seconds
           (0                                    << 15) | // b0 (NTSC), b2 (PAL)
           ((((frame / (fps * 60)) % 60) / 10)   << 12) | // tens  of minutes
           ((((frame / (fps * 60)) % 60) % 10)   <<  8) | // units of minutes
           (0                                    <<  7) | // b1
           (0                                    <<  6) | // b2 (NTSC), field phase (PAL)
           ((((frame / (fps * 3600) % 24)) / 10) <<  4) | // tens  of hours
           (  (frame / (fps * 3600) % 24)) % 10;          // units of hours
}

63
int avpriv_check_timecode_rate(void *avcl, AVRational rate, int drop)
64 65 66 67 68 69 70 71
{
    int fps;

    if (!rate.num || !rate.den) {
        av_log(avcl, AV_LOG_ERROR, "Timecode frame rate must be specified\n");
        return -1;
    }
    fps = (rate.num + rate.den/2) / rate.den;
72
    if (drop && fps != 30) {
73 74 75 76 77 78 79 80 81 82 83 84 85 86
        av_log(avcl, AV_LOG_ERROR, "Drop frame is only allowed with 30000/1001 FPS\n");
        return -2;
    }
    switch (fps) {
    case 24:
    case 25:
    case 30: return  0;

    default:
        av_log(avcl, AV_LOG_ERROR, "Timecode frame rate not supported\n");
        return -3;
    }
}

87 88 89 90
char *avpriv_timecode_to_string(char *buf, const struct ff_timecode *tc, unsigned frame)
{
    int frame_num = tc->start + frame;
    int fps = (tc->rate.num + tc->rate.den/2) / tc->rate.den;
91
    int hh, mm, ss, ff, neg = 0;
92 93

    if (tc->drop)
94
        frame_num = avpriv_framenum_to_drop_timecode(frame_num);
95 96 97 98
    if (frame_num < 0) {
        frame_num = -frame_num;
        neg = 1;
    }
99 100 101
    ff = frame_num % fps;
    ss = frame_num / fps        % 60;
    mm = frame_num / (fps*60)   % 60;
102
    hh = frame_num / (fps*3600);
103 104
    snprintf(buf, 16, "%s%02d:%02d:%02d%c%02d",
             neg ? "-" : "",
105 106 107 108
             hh, mm, ss, tc->drop ? ';' : ':', ff);
    return buf;
}

109
int avpriv_init_smpte_timecode(void *avcl, struct ff_timecode *tc)
110
{
111
    int hh, mm, ss, ff, fps, ret;
112 113 114 115 116 117 118 119
    char c;

    if (sscanf(tc->str, "%d:%d:%d%c%d", &hh, &mm, &ss, &c, &ff) != 5) {
        av_log(avcl, AV_LOG_ERROR, "unable to parse timecode, "
                                   "syntax: hh:mm:ss[:;.]ff\n");
        return -1;
    }

120 121
    tc->drop  = c != ':'; // drop if ';', '.', ...

122
    ret = avpriv_check_timecode_rate(avcl, tc->rate, tc->drop);
123 124 125
    if (ret < 0)
        return ret;

126 127 128 129 130 131 132 133 134
    fps       = (tc->rate.num + tc->rate.den/2) / tc->rate.den;
    tc->start = (hh*3600 + mm*60 + ss) * fps + ff;

    if (tc->drop) { /* adjust frame number */
        int tmins = 60*hh + mm;
        tc->start -= 2 * (tmins - tmins/10);
    }
    return 0;
}
135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150

int ff_framenum_to_drop_timecode(int frame_num)
{
    return avpriv_framenum_to_drop_timecode(frame_num);
}

uint32_t ff_framenum_to_smtpe_timecode(unsigned frame, int fps, int drop)
{
    return avpriv_framenum_to_smpte_timecode(frame, fps, drop);
}

int ff_init_smtpe_timecode(void *avcl, struct ff_timecode *tc)
{
    return avpriv_init_smpte_timecode(avcl, tc);
}
#endif