From patchwork Sun May 7 13:32:43 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Anton Khirnov X-Patchwork-Id: 41520 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:dca6:b0:f3:34fa:f187 with SMTP id ky38csp1707556pzb; Sun, 7 May 2023 06:34:14 -0700 (PDT) X-Google-Smtp-Source: ACHHUZ4XGiTJn4rSUwARaZCr+imrroHoxcRRr/+2QMy0K4j/Gqqiy9z6UuVTowZj3jRGtd657Qq2 X-Received: by 2002:aa7:c7da:0:b0:50b:c693:70af with SMTP id o26-20020aa7c7da000000b0050bc69370afmr5429041eds.2.1683466454278; Sun, 07 May 2023 06:34:14 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1683466454; cv=none; d=google.com; s=arc-20160816; b=VxlAnVVbFRDh74mcyL7WOAS6JtEyRLx1OiejcKVS/zsQ6A46PWjreJFjTcyyegLuKk xWZFjZhnBsJ1RVe6q3sBgmOnxCIXGxA+QQdVS+KEW9gKC9ABe77SJT5Dlw7wvcKSntY2 3xjqOBR0SeawJv3DPMLbEEXhpl+XUHQ7BU/e6Ppecu9tzNUyMrWzfjDVh+P+po5fJmGY 8wnQI8SO4etLLakyN5R7pIAXYX+ote2J3kDVPlTmSQVPy//98ngPq4tcNCM4EzJBmFMp sBgrT4gI87r+W9R/ccrjxzhP+7s3yPyHYL9RMl5bOrM/v5sUiKbjObhebrKSyDKxUm05 XMIQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:reply-to:list-subscribe :list-help:list-post:list-archive:list-unsubscribe:list-id :precedence:subject:mime-version:message-id:date:to:from :delivered-to; bh=Z0zolSYmyf0V/c3jmicsN0mnbRqee6BVek6jrjNUEOo=; b=LPJLXsohFOY0MYldGtDIldhI0yvHUKKAzQuVh1THBEldxcyNYg/cm5a84mybknB2Gn LZ56WANMecYcED/KDJdch9xhyBqooe2ak9v+sDBKO6HccHojHFrUla7Tt6fqgG+2cqrO PMFWWQ9WXI7YioPD69OsQPOmSu5LohUPa6wEKu/kgsQhjW7uuNtEHF+IFLWq3kt+1Zo0 QIn4+Vtb9J+ZplRu5psliUrb/dlLVbsAimPRFAnCu2DPRlnvp6fjl2Cj1ZwgElKaoDb/ ceZ98DkUjnRYt8j0FL4NcJxhv9j4WOCD0bnKj761zQb1UtGJRfalDGpahmABM0ne+SFD LC/Q== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) smtp.mailfrom=ffmpeg-devel-bounces@ffmpeg.org Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org. [79.124.17.100]) by mx.google.com with ESMTP id i7-20020a50fc07000000b0050bcded050csi7216240edr.290.2023.05.07.06.34.13; Sun, 07 May 2023 06:34:14 -0700 (PDT) Received-SPF: pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) client-ip=79.124.17.100; Authentication-Results: mx.google.com; spf=pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) smtp.mailfrom=ffmpeg-devel-bounces@ffmpeg.org Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id A0F3468C13C; Sun, 7 May 2023 16:33:27 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail0.khirnov.net (red.khirnov.net [176.97.15.12]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 42CAF68C104 for ; Sun, 7 May 2023 16:33:23 +0300 (EEST) Received: from localhost (localhost [IPv6:::1]) by mail0.khirnov.net (Postfix) with ESMTP id EA91E2404F5 for ; Sun, 7 May 2023 15:33:22 +0200 (CEST) Received: from mail0.khirnov.net ([IPv6:::1]) by localhost (mail0.khirnov.net [IPv6:::1]) (amavisd-new, port 10024) with ESMTP id H35RnOpEv3M5 for ; Sun, 7 May 2023 15:33:21 +0200 (CEST) Received: from libav.khirnov.net (libav.khirnov.net [IPv6:2a00:c500:561:201::7]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "libav.khirnov.net", Issuer "smtp.khirnov.net SMTP CA" (verified OK)) by mail0.khirnov.net (Postfix) with ESMTPS id 494AA2406CD for ; Sun, 7 May 2023 15:33:15 +0200 (CEST) Received: from libav.khirnov.net (libav.khirnov.net [IPv6:::1]) by libav.khirnov.net (Postfix) with ESMTP id 329D33A031B for ; Sun, 7 May 2023 15:33:05 +0200 (CEST) From: Anton Khirnov To: ffmpeg-devel@ffmpeg.org Date: Sun, 7 May 2023 15:32:43 +0200 Message-Id: <20230507133255.20881-1-anton@khirnov.net> X-Mailer: git-send-email 2.39.2 MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH 01/13] lavu/frame: extend AVFrame.repeat_pict documentation X-BeenThere: ffmpeg-devel@ffmpeg.org X-Mailman-Version: 2.1.29 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 Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" X-TUID: t7y0CIMxiRdZ --- libavutil/frame.h | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/libavutil/frame.h b/libavutil/frame.h index f2b56beebb..ed3f199ce1 100644 --- a/libavutil/frame.h +++ b/libavutil/frame.h @@ -491,8 +491,22 @@ typedef struct AVFrame { void *opaque; /** - * When decoding, this signals how much the picture must be delayed. - * extra_delay = repeat_pict / (2*fps) + * Number of fields in this frame which should be repeated, i.e. the total + * duration of this frame should be repeat_pict + 2 normal field durations. + * + * For interlaced frames this field may be set to 1, which signals that this + * frame should be presented as 3 fields: beginning with the first field (as + * determined by AV_FRAME_FLAG_TOP_FIELD_FIRST being set or not), followed + * by the second field, and then the first field again. + * + * For progressive frames this field may be set to a multiple of 2, which + * signals that this frame's duration should be (repeat_pict + 2) / 2 + * normal frame durations. + * + * @note This field is computed from MPEG2 repeat_first_field flag and its + * associated flags, H.264 pic_struct from picture timing SEI, and + * their analogues in other codecs. Typically it should only be used when + * higher-layer timing information is not available. */ int repeat_pict;