From patchwork Wed May 5 02:12:02 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: James Almer X-Patchwork-Id: 27590 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a6b:6109:0:0:0:0:0 with SMTP id v9csp50802iob; Tue, 4 May 2021 19:12:31 -0700 (PDT) X-Google-Smtp-Source: ABdhPJzIv7fT5kDFWZywg6LM4dM2m0yEqYeEeylHYwHdmf7B+JDa1i5twjDsmSV7gnKIMob46XNj X-Received: by 2002:a50:fc0b:: with SMTP id i11mr30473632edr.259.1620180751517; Tue, 04 May 2021 19:12:31 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1620180751; cv=none; d=google.com; s=arc-20160816; b=bEUv+KxC0Baen8VOHCRoL6+rTGOOpnr9mHNWcnNJx1Iqyws4aeHUn14vsSGAa8RjIe p/+lThTsTHFiXo3BUP0GFhyWTtpYXyo5LTYxnUtMjFkwCKfF0gaAVOGchB/XDiS1Bk73 8JR/rI5Z8gxNE3ciUB/dAc86QZBZqGGPGqDLUQmgvKl/4XP5Tu2vuQnIge/aXzlYQT5D QPZ3sAgKShLG9tfiMHeasiBrjn3UlsSW9nUXqBRXA6ui1yDvH8ItZuj1DKck2lxKQSRf DuMErZpqSE3mEkyw43rH6zrqDz5C9kR8hDhzN+G+B7kvPaahWZf0PiuL1T1MymCtGXEF e9tw== 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 :dkim-signature:delivered-to; bh=HM19fXzTsi2fUmr/I7pQHn1Bg5yNCqsFSss+VliKrM8=; b=evbGOltLSM5DxDSiev1h/sOk+fRPjURZWEX9PIkQ09dw74+cUfjPYjGkuJ7e2QV8bH 1+Pq/adZG2o73lbfjPbonzElKUXgGkDsyfZpuiM7Ft4gCgTea59loM3Gx1Eyb5fG22hK u7g6Vpsz0QZyqk1+BsSil5KF+QXmNlatduEH4u46+bRccB6IB6LuoDNXdTRXKH7bF+FB gJLn4oKMn1F3TyaxQmiSbl4focV6+jqT1ix2IIN5dPe8wzgqISl8ofg6IlqiCUjYpaSu V33vfUwk37TyEp2Lj8YJ0I41iF1V3rU7dd2Pz8KDKHlr9w9oj4yXkP2SbsOXzhwNxVUg nv/Q== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@gmail.com header.s=20161025 header.b=q5NSMn9G; 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; dmarc=fail (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org. [79.124.17.100]) by mx.google.com with ESMTP id ca23si14552277edb.92.2021.05.04.19.12.30; Tue, 04 May 2021 19:12:31 -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; dkim=neutral (body hash did not verify) header.i=@gmail.com header.s=20161025 header.b=q5NSMn9G; 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; dmarc=fail (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 075976806F3; Wed, 5 May 2021 05:12:27 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-qt1-f178.google.com (mail-qt1-f178.google.com [209.85.160.178]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id A86EA680328 for ; Wed, 5 May 2021 05:12:20 +0300 (EEST) Received: by mail-qt1-f178.google.com with SMTP id g13so142126qts.4 for ; Tue, 04 May 2021 19:12:20 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:subject:date:message-id:mime-version :content-transfer-encoding; bh=3RrJeAZKqjFGh2T+tdT1poxLjdv9MYoZnxqykjxE/zo=; b=q5NSMn9Gvs3nUBPuPLyj8vHmeR2hXoMMoa6qCvsFbk/GrP8JcKg9Z115q6e4cL+chw i9gjkiMvrmui3G3h+QxoHVtb4u5604hbqo45uuC7M/7u7p5cn1vAd+Pps5GzsWyfgyTx WGgQoOiYn3ib1KXIO4kCW7gUo5njAkbUYzXT3tNcNsT7yKLZ12CXqdqUqIo/2PsbTdTD S1tPw1kDjNUYn1tuPVY4M+L3d7XyuQdiHmA8fTAQaD5a8rwFCEUIXRUG8kmm1D5B2pC5 rgZFQEWHnbMSRpM8Jt2y0BmqmHje7GcbZUcF8EiejQAB9LzEpbw0DKOaer1Br0SUdkCD ZFNA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:subject:date:message-id:mime-version :content-transfer-encoding; bh=3RrJeAZKqjFGh2T+tdT1poxLjdv9MYoZnxqykjxE/zo=; b=IXNNdw2Zv+36tU9LTZqTh3R4kGbFRUNa9sRB/n3Unx8aV9ZO8grgeppgd+g4iVICbz rEHaRzTsAPewf0eZUEyJJA0V2NYbMOvCXUlpWGBFK3j9iE8Nipvy6c9Xg+LLXxx6nG8S anIXiVnXvzUXKLrGm9FM4C3Fg1eruTqadLeTOPZLQj5yZKoGF8x+DiWPiKhCYfTqTXja GOWKamiqoCbI9a2PPmNIzJCWjzfzBvfEeuVbiVw8CmY8xEFLylnlHs+KfD0L8jCO2LQg wAsUBs77H7bbSSq+F1RXc86dq8HXHxHn/GWNURrEecVghnqjxPOfAtcj+g1A7LWeT4Gn 4oGQ== X-Gm-Message-State: AOAM5311mDun/ofYmwpl05bRIp4eDR0ZBJCFgF6cDz5iOO5E6SQ/gcTK KVcgPbIPu/movBrkuCng0cLXdQI3biU= X-Received: by 2002:ac8:6c59:: with SMTP id z25mr22891670qtu.302.1620180737743; Tue, 04 May 2021 19:12:17 -0700 (PDT) Received: from localhost.localdomain ([191.83.208.172]) by smtp.gmail.com with ESMTPSA id y84sm8758822qkb.134.2021.05.04.19.12.16 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 04 May 2021 19:12:17 -0700 (PDT) From: James Almer To: ffmpeg-devel@ffmpeg.org Date: Tue, 4 May 2021 23:12:02 -0300 Message-Id: <20210505021202.2157-1-jamrial@gmail.com> X-Mailer: git-send-email 2.31.1 MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH] avcodec: be more explicit about the buffer size in get_encode_buffer 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: jgN0mUO/ssYb Signed-off-by: James Almer --- libavcodec/avcodec.h | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/libavcodec/avcodec.h b/libavcodec/avcodec.h index 0ef1676daf..3cf131d0a5 100644 --- a/libavcodec/avcodec.h +++ b/libavcodec/avcodec.h @@ -2097,6 +2097,10 @@ typedef struct AVCodecContext { * This callback must use the above value to calculate the required buffer size, * which must padded by at least AV_INPUT_BUFFER_PADDING_SIZE bytes. * + * In some specific cases, the encoder may not use the entire buffer allocated by this + * callback. This will be reflected in the size value in the packet once returned by + * avcodec_receive_packet(). + * * This callback must fill the following fields in the packet: * - data: alignment requirements for AVPacket apply, if any. Some architectures and * encoders may benefit from having aligned data.