From patchwork Fri Mar 12 23:15:37 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: James Almer X-Patchwork-Id: 26362 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 0427A448BD8 for ; Sat, 13 Mar 2021 01:16:00 +0200 (EET) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id D7B0D68AABC; Sat, 13 Mar 2021 01:15:59 +0200 (EET) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-qt1-f174.google.com (mail-qt1-f174.google.com [209.85.160.174]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 0E15568A980 for ; Sat, 13 Mar 2021 01:15:54 +0200 (EET) Received: by mail-qt1-f174.google.com with SMTP id s2so5156496qtx.10 for ; Fri, 12 Mar 2021 15:15:53 -0800 (PST) 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=ZudSWPzyGztqBR5OPgldDTjtTAyqkrm1mZXz5QFQfvQ=; b=gmjlojDW3iQ4kv1l+aJtRwbvTK/jwAigQlBihAzNxCacvIizVqUcaAlYexffsRFBPz sPVMhpKd/0oESyn3qTxBct6xHPJ1kLoztJ6KJ47kX+lrXU6G6ecttonUEqkxKq9o1pKL R2p+gLJIamWm8zcavoO+jMkO7L8yyosLHmH4eCNnwBgkx8iMFfPJR/0N0SPzIK4kxjJV ffVRMXFFeuXij8nw+1swtCCMG7g+H6NpYr9DtvXEHJPp16iDHjCsKfkUEWwZCk2eZS6+ IO+vxRRPE+bkFy8BPa+ty8yy98a8iZujyjvH9wVfV0Jk+G4l4gtrH+t6y0BR2UzUwXu7 GK9A== 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=ZudSWPzyGztqBR5OPgldDTjtTAyqkrm1mZXz5QFQfvQ=; b=sW0SSuXdCS5cqv1Qh5U18UyTdxjXLpa5Wgoys3a7M9YSFsk68o1Dj39jkCh486VjSz 3GtuqYSXQFDqTGk8LxyOWvee1aIodThbaO1pEW0do61NkX4qREiVrnSQ9x889XReb5Ng fMh9hbCMc2ZB9iE9yfmBgVI5bX0sxuJjj0QAAlKOb0oDben93T4lQhEjNAWBllQktXPw SQQkZjE5/B2bwsOD5fW21O/kdAvKuPopd+Wi3aeMw5pF/365+fjW1SFS1sqjBTsfj/GV gEroyupKxNGLGNfr+x/wknRUHUZRHBNvL0Eim4zUxNJjKJBJZF5kdTrljY8j2CdCIs2Y 1dDg== X-Gm-Message-State: AOAM533kiWvrzABQ/ujUg2of5RLfs0nUsJ2Q9CXZHYFNtyQEGgbqXuWU Dn2ySd+4tFJr4ttwRm7KaRoDXjiF/2Q= X-Google-Smtp-Source: ABdhPJz5j7reYOaMc3S9Gh8FrsCuUTe+a4/oGWV+8/u00uxzBPbUfvSxUBUAZZvW8QTVkRLd98ulow== X-Received: by 2002:ac8:16dd:: with SMTP id y29mr8780935qtk.159.1615590952581; Fri, 12 Mar 2021 15:15:52 -0800 (PST) Received: from localhost.localdomain ([181.23.75.214]) by smtp.gmail.com with ESMTPSA id d16sm5368563qka.43.2021.03.12.15.15.51 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 12 Mar 2021 15:15:52 -0800 (PST) From: James Almer To: ffmpeg-devel@ffmpeg.org Date: Fri, 12 Mar 2021 20:15:37 -0300 Message-Id: <20210312231537.5300-1-jamrial@gmail.com> X-Mailer: git-send-email 2.30.2 MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH] avcodec: add a mention about get_encode_buffer in the old encode API doxy 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 Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" Direct users to the callback that should be used to keep supporting user provided buffers with the new encode API. Signed-off-by: James Almer --- libavcodec/avcodec.h | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/libavcodec/avcodec.h b/libavcodec/avcodec.h index fbd4804160..76911baea2 100644 --- a/libavcodec/avcodec.h +++ b/libavcodec/avcodec.h @@ -3680,7 +3680,9 @@ void av_parser_close(AVCodecParserContext *s); * not be used. * @return 0 on success, negative error code on failure * - * @deprecated use avcodec_send_frame()/avcodec_receive_packet() instead + * @deprecated use avcodec_send_frame()/avcodec_receive_packet() instead, and + * if allowed and required, set AVCodecContext.get_encode_buffer to + * a custom function to pass user supplied output buffers. */ attribute_deprecated int avcodec_encode_audio2(AVCodecContext *avctx, AVPacket *avpkt, @@ -3719,7 +3721,9 @@ int avcodec_encode_audio2(AVCodecContext *avctx, AVPacket *avpkt, * not be used. * @return 0 on success, negative error code on failure * - * @deprecated use avcodec_send_frame()/avcodec_receive_packet() instead + * @deprecated use avcodec_send_frame()/avcodec_receive_packet() instead, and + * if allowed and required, set AVCodecContext.get_encode_buffer to + * a custom function to pass user supplied output buffers. */ attribute_deprecated int avcodec_encode_video2(AVCodecContext *avctx, AVPacket *avpkt,