[FFmpeg-devel] [PATCH] avcodec: be more explicit about the buffer size in get_encode_buffer documentation

[James Almer]

On 5/4/2021 11:12 PM, James Almer wrote:
> Signed-off-by: James Almer <jamrial at gmail.com>
> ---
>   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.

Will apply.