From patchwork Wed Jul 1 13:39:56 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lance Wang X-Patchwork-Id: 20757 Return-Path: X-Original-To: patchwork@ffaux-bg.ffmpeg.org Delivered-To: patchwork@ffaux-bg.ffmpeg.org Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org [79.124.17.100]) by ffaux.localdomain (Postfix) with ESMTP id D788244B634 for ; Wed, 1 Jul 2020 16:40:15 +0300 (EEST) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id B9B3F6881F5; Wed, 1 Jul 2020 16:40:15 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-pl1-f174.google.com (mail-pl1-f174.google.com [209.85.214.174]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 76E73688047 for ; Wed, 1 Jul 2020 16:40:09 +0300 (EEST) Received: by mail-pl1-f174.google.com with SMTP id x8so9035684plm.10 for ; Wed, 01 Jul 2020 06:40:09 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=Odh7brwsiI+Kii7F1fDw+lc6LQGcCO5hRDGrXEUPEYQ=; b=FKHe4Yv72K4vdn0yJKzRNxKz6tkpRUe/tBGyWdbL+giLh80pofy8qqdtJO8DMAK9S7 eMuadRayGkwu1Roy+n2w2X3BrNAUCcYBxPN6Xuw1YzUtzg9KfsOfqiOqjg//UuqkGOPm BCZ6ZKDdKXit6BsfRgUgUsHdW1t5Cl815NN5vAtgRm80kOS+YNsuIgwabOULvzm8QrGX epXKiK8G5AjNNH7lIF4+CHJE2H4I9axePGjHeWs6MIJYjBGjrRWIP0cMrgQASky2/TPN S1T4aIQU23RidUWBtfMxsyED6RZMeVo+iJDLO9y3wCZta8zIcldbH7mSe6pflQ9EjF9A HliA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=Odh7brwsiI+Kii7F1fDw+lc6LQGcCO5hRDGrXEUPEYQ=; b=c8RRTNU0ii+Lqbme4c40G8HIVoTVD8oblBcOT0fathhN0mcbBKi1bknOvoawZPh3/V 6Z41nF4hKvg7emYMfXfx99jVHne5UVwK3x00O6nVjN747cmesBPwj543THXL/+rLue+9 Ja+nocC6s8uNtUTXHpjPaNafwF7udfII1JnEZK1r5TaE7c7HdOc8WVN1B0I5aPh0WxJB cwwsCYOywbiivATvcT49YBuh131f8OCS2fF0WtZEpfrH6XoLGFAu8NS1BGfZ9KQbxEkG oSeIIJLUw9/0Ubg7OtlABVF8PNL+84Uvv5oFZzakVsf5vJ9EXLCKfhnizteoMm76txIC VT6Q== X-Gm-Message-State: AOAM533HIHy5ais/rpcaOJZuXbwaPZvxjGFGMrNa2B7aIuPaMjXiwcYx eBKE+Vf/boYx7k++mjTcxZf+Pg/1 X-Google-Smtp-Source: ABdhPJyt6VG74zPXVMSoh0u6i+6qCr1vr0AY/V3M+DVKjN01+g3ZH0u+uzKrDwiR+iUDk3bHeNC7pA== X-Received: by 2002:a17:902:7109:: with SMTP id a9mr23090550pll.58.1593610807246; Wed, 01 Jul 2020 06:40:07 -0700 (PDT) Received: from vpn2.localdomain ([161.117.202.209]) by smtp.gmail.com with ESMTPSA id s9sm5897718pjz.2.2020.07.01.06.40.05 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Wed, 01 Jul 2020 06:40:06 -0700 (PDT) From: lance.lmwang@gmail.com To: ffmpeg-devel@ffmpeg.org Date: Wed, 1 Jul 2020 21:39:56 +0800 Message-Id: <1593610798-21093-1-git-send-email-lance.lmwang@gmail.com> X-Mailer: git-send-email 1.8.3.1 In-Reply-To: <1592663151-24180-1-git-send-email-lance.lmwang@gmail.com> References: <1592663151-24180-1-git-send-email-lance.lmwang@gmail.com> Subject: [FFmpeg-devel] [PATCH v6 1/3] avutil/timecode: add description for SMPTE binary format X-BeenThere: ffmpeg-devel@ffmpeg.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: FFmpeg development discussions and patches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: FFmpeg development discussions and patches Cc: Limin Wang MIME-Version: 1.0 Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" From: Limin Wang Signed-off-by: Limin Wang --- libavutil/frame.h | 4 ++-- libavutil/timecode.h | 12 ++++++++++++ 2 files changed, 14 insertions(+), 2 deletions(-) diff --git a/libavutil/frame.h b/libavutil/frame.h index 3fb8c56..3bd240f 100644 --- a/libavutil/frame.h +++ b/libavutil/frame.h @@ -162,8 +162,8 @@ enum AVFrameSideDataType { /** * Timecode which conforms to SMPTE ST 12-1. The data is an array of 4 uint32_t * where the first uint32_t describes how many (1-3) of the other timecodes are used. - * The timecode format is described in the av_timecode_get_smpte_from_framenum() - * function in libavutil/timecode.c. + * The timecode format is described in the documentation of av_timecode_get_smpte_from_framenum() + * function in libavutil/timecode.h. */ AV_FRAME_DATA_S12M_TIMECODE, diff --git a/libavutil/timecode.h b/libavutil/timecode.h index ab38e66..65c5e91 100644 --- a/libavutil/timecode.h +++ b/libavutil/timecode.h @@ -62,6 +62,18 @@ int av_timecode_adjust_ntsc_framenum2(int framenum, int fps); * @param framenum frame number * @return the SMPTE binary representation * + * the format description as follows: + * bits 0-5: hours, in BCD + * bits 6: BGF1 + * bits 7: BGF2 (NTSC) or PC (PAL) + * bits 8-13: minutes, in BCD + * bits 15: BGF0 (NTSC) or BGF2 (PAL) + * bits 16-21: seconds, in BCD + * bits 23: PC (NTSC) or BGF0 (PAL) + * bits 24-29: frames, in BCD + * bits 30: drop frame flag (0: non drop, 1: drop) + * bits 31: color frame flag (0: unsync mode, 1: sync mode) + * @note BCD numbers (6 bits): 4 lower bits for units, 2 higher bits for tens. * @note Frame number adjustment is automatically done in case of drop timecode, * you do NOT have to call av_timecode_adjust_ntsc_framenum2(). * @note The frame number is relative to tc->start.