From patchwork Sat Mar 13 13:34:05 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: James Almer X-Patchwork-Id: 26379 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 B11B644A729 for ; Sat, 13 Mar 2021 15:34:32 +0200 (EET) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 7A00268ACE8; Sat, 13 Mar 2021 15:34:32 +0200 (EET) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-qk1-f169.google.com (mail-qk1-f169.google.com [209.85.222.169]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 21DAB68000F for ; Sat, 13 Mar 2021 15:34:26 +0200 (EET) Received: by mail-qk1-f169.google.com with SMTP id x10so27287175qkm.8 for ; Sat, 13 Mar 2021 05:34:26 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:subject:date:message-id:in-reply-to:references:mime-version :content-transfer-encoding; bh=1z99XClqBkDmCHRdvi/mW+zWc6QI0P6UF2qQIDsCV9g=; b=d7Ggz1QUNg4T94pONow2yuoE1EmLGu7EDgxX5FtxAgQj7RDBNXpGEPwHX+PmmjZiLC Zo49zNPYIjIS498EvnjX2CRMYXQyfTgisCpqBZ87YNtDh3kXEHYeZ+/14b3+ztcX+31Q ibu7ii5Tgz2NYlR1XywOdYkTMgFWu+HvmcvFfhVw+o/Oq51+n/XXbSQkEgFSS9uBkrSS NuihVdZL30Bomy/qAvvvLPJIdHbYXRM6aOmD0GfxD9UNbz0CqLxyi1/2LAxzKdPXN8Ex Kl55GSds7HTjob1t8ruRNlUJvpFnWpo76KdH9vmpGSa3kQWl9l5g7S5tnFOx8dBs9quR Onhg== 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:in-reply-to :references:mime-version:content-transfer-encoding; bh=1z99XClqBkDmCHRdvi/mW+zWc6QI0P6UF2qQIDsCV9g=; b=fEMalK2En0KoraNcwFm16x0V7RJ5OARfFbLbP/C4gKnETE+CvXuyQRYTynC/Zv+Jxv FBI6qncG8qBok4FukVUysq2/odvNpFBjWtDMs58a5bPzcUHmnxyhfRr5S72eb057JXHp k3Yw1IXAq5nuMrZHQfnk79IRjn+PpE1o9XIVHg74/bNU1nqFEGL2TZpmFFEtMDfSy+ju LvXb5CZfj568GuLTon4P0CAxZWyBMMjavVz/GziWnXm7CqDnR+Kcgud7JZAdO18zqduT YE8rzw4pIuhe9GfccpbjU6BzLsXxoLj9SwWoMLbAtL588Qk3MoNUj5oDW91Y37gcCjQL Xeeg== X-Gm-Message-State: AOAM530y5MyoGfgfvUCBiONsIKrHlWngjsswqeXTOJ8BHULgi0ZUY5Og o9Hk1bpAhJhMq9IwsZzH1mtYkdrTu9w= X-Google-Smtp-Source: ABdhPJyCv+3ktv9Gx3YjJV/dmsWsct3AlD5E5Uewd17+Y+bLS2oTpcK+Un93iyiPA2z/ULdwrN97dg== X-Received: by 2002:a05:620a:31a:: with SMTP id s26mr17167001qkm.355.1615642464487; Sat, 13 Mar 2021 05:34:24 -0800 (PST) Received: from localhost.localdomain ([181.23.75.214]) by smtp.gmail.com with ESMTPSA id y19sm6710763qky.111.2021.03.13.05.34.23 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 13 Mar 2021 05:34:23 -0800 (PST) From: James Almer To: ffmpeg-devel@ffmpeg.org Date: Sat, 13 Mar 2021 10:34:05 -0300 Message-Id: <20210313133405.1034-1-jamrial@gmail.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <161561887704.21468.8688397016438469484@lain.red.khirnov.net> References: <161561887704.21468.8688397016438469484@lain.red.khirnov.net> MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH v2] 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..8a71c04230 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. + * 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. + * 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,