From patchwork Fri Jul 10 13:26:11 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lance Wang X-Patchwork-Id: 20943 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 7DC8E449156 for ; Fri, 10 Jul 2020 16:26:27 +0300 (EEST) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 5DF8668920C; Fri, 10 Jul 2020 16:26:27 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-pl1-f175.google.com (mail-pl1-f175.google.com [209.85.214.175]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 67F61688067 for ; Fri, 10 Jul 2020 16:26:20 +0300 (EEST) Received: by mail-pl1-f175.google.com with SMTP id p1so2251417pls.4 for ; Fri, 10 Jul 2020 06:26:20 -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=iTWkWLldDH8YRAQlr0whc9rLtUEPZGuzkDPcrQ4/uB4=; b=kIvWBrszh6zKuu/DUyhppuqB5EhVl1TcLgExnXU8/Fr94iKDPMih/QsviQXbu4BAvD UF7rYqYD4XDMcbZLn1JZwH7t4FNTVTNPUJkGHe6Emcj/KheVFRWSCQOnr7tn2M00PvdD FMVG4ldvUjynvH2d+3iLr9KNl8/zHm0PI9mYKL8uKRj14zaFGLwNz6T5wvEt3zutb3bE pGWY/5CprwFwukdMQGZE/LRD75TMyA45jU8dClsKHh+KZClXP0rRfcX8DMVNk198vGJG vxfwDsVQju1cl5yxBDPBMh8CghuGvLuQPLvcmo4Ze0OyAIFpa77jyLlKmzqXy41woqwv 3OEw== 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=iTWkWLldDH8YRAQlr0whc9rLtUEPZGuzkDPcrQ4/uB4=; b=VJtuxOeBaGf3kGBHQJP+n65lSyGYoX0vu9w3iGidnj0ZBVb9AaLL8iT+Ne3wq97QTf gci4tyH051oBHA/kT+zNo5bW+IprcFrFbIgnmsCNp8FjsqZm25efzpHTAWQ+lkuG8fPn SJ8BubWqzxZWaWwXecZThJZEHVpElUpKRMH4j7vUYu2zLqxlHmu62zq1jzQejZlMXvkF Lr/tGqG8bP9jSAHZOYShLbww/Y2PAIqxLbeEWhvVZ01woKoAflj7+r/kD92Qy4i9eUv/ p7DGdKeoGg2CPJIBFrOJSvE1Sz0rEGmj7Fa185CZ0ttrOaDRdqYkH9HqXLK3N8t0KGYu uVaQ== X-Gm-Message-State: AOAM530f10jOtEgexBvCLhholDGTS8oPBRKVBmMF6gu49Gi72u1L46Uq 6UFqwJgS6Z+Xsx4OvxHxiU7vP1n/ X-Google-Smtp-Source: ABdhPJwyODEXCDoPU2dE5CSrULm7Cs75+bAPouwtdFOcxCw0jo6INW1EcSoG/StzEcLI+jXPuvvYMg== X-Received: by 2002:a17:902:fe11:: with SMTP id g17mr60213668plj.145.1594387578493; Fri, 10 Jul 2020 06:26:18 -0700 (PDT) Received: from vpn2.localdomain ([161.117.202.209]) by smtp.gmail.com with ESMTPSA id d16sm6093575pfo.156.2020.07.10.06.26.15 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Fri, 10 Jul 2020 06:26:16 -0700 (PDT) From: lance.lmwang@gmail.com To: ffmpeg-devel@ffmpeg.org Date: Fri, 10 Jul 2020 21:26:11 +0800 Message-Id: <1594387571-22966-1-git-send-email-lance.lmwang@gmail.com> X-Mailer: git-send-email 1.8.3.1 In-Reply-To: <1593610798-21093-1-git-send-email-lance.lmwang@gmail.com> References: <1593610798-21093-1-git-send-email-lance.lmwang@gmail.com> Subject: [FFmpeg-devel] [PATCH v7 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 | 13 +++++++++++++ 2 files changed, 15 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..0d1aca2 100644 --- a/libavutil/timecode.h +++ b/libavutil/timecode.h @@ -62,6 +62,19 @@ int av_timecode_adjust_ntsc_framenum2(int framenum, int fps); * @param framenum frame number * @return the SMPTE binary representation * + * See SMPTE ST 314M-2005 Sec 4.4.2.2.1 "Time code pack (TC)" + * 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.