From patchwork Sat Jun 26 20:12:21 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: liudingming X-Patchwork-Id: 28720 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a5d:965a:0:0:0:0:0 with SMTP id d26csp581554ios; Sat, 26 Jun 2021 13:12:38 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxKKitElM06VRY8vHdQKxxxNamauhMBXm5+9kWNsimN7dTkP8vLUIvT2qBp+c06r92c9n0A X-Received: by 2002:a50:8fc3:: with SMTP id y61mr22761717edy.107.1624738358054; Sat, 26 Jun 2021 13:12:38 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1624738358; cv=none; d=google.com; s=arc-20160816; b=DaI/GDEI4bijsNPPZ3Q2/CZ12fMt9nNa2IEAnmGnSbYZohUaCaaX1va9fbns6X+6hw lMVN/Mg+JLg3wUCGYNGWWKbtHC8aNslAYoHcQtGJX4iidjnqSKdIhLIk6q3G0TdBrOsc Ow9kNn4pKTgKprfCMbecIpeBGUdMPAcpopN+w7J4aKlfa3zUxeoXZNNEl/59POrUgf5Q ayIMXYP+qyD9PiViES1A5YsudTLYbPIIOlBBk9BYsVxeTzuHJhK/1yYUAK3vs9Rh8k+w 6Z0a5SC3LffDwzFazHwtct96vwemjOS2LHrJWijiBZKH7dILQ8gSfwIEIQdP2MWXM+oK 8MTw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:cc: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=htxBz0FWwbgLWrem85XtoK3dD7nfl1/oi6HBSUSxNqE=; b=aiQxqkP4Jt/lWJWDmHBYmEirnFhSGI8jYlDxNfmCwGr3g9hTJAnor/lMU1925t9bCZ 3Q8oKid1tyTFmSWyJRK+J1lg2TPxTKw+wHOl4VwXJWM8RDMTCuS7M8hoUU/+DnCcNAp2 fbereDwVc8caSt+BVefT6x3r4ITQxoUnt3i9GzQQ9KBIBHTVcsUHkpwgHUVh7nr9tqg2 tHdtapC97aDU+pwxhEP7wm4gW9eOQANGrqjR2KQ9clvahGZPMgYphncGFahxVM/uTclS xEg7JvuVQsl9xuyIFT/+RcnVl+vTIC7ov1AlDF4Hx/876as0iO/KZTJSpLxCNcm0orCn iFsQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@bytedance-com.20150623.gappssmtp.com header.s=20150623 header.b=1sMnAoXU; 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=NONE dis=NONE) header.from=bytedance.com Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org. [79.124.17.100]) by mx.google.com with ESMTP id ze12si9311151ejb.669.2021.06.26.13.12.37; Sat, 26 Jun 2021 13:12:38 -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=@bytedance-com.20150623.gappssmtp.com header.s=20150623 header.b=1sMnAoXU; 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=NONE dis=NONE) header.from=bytedance.com Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id B006168A048; Sat, 26 Jun 2021 23:12:33 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-pf1-f172.google.com (mail-pf1-f172.google.com [209.85.210.172]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id D3E2C6899DD for ; Sat, 26 Jun 2021 23:12:27 +0300 (EEST) Received: by mail-pf1-f172.google.com with SMTP id k6so10369636pfk.12 for ; Sat, 26 Jun 2021 13:12:27 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bytedance-com.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=wpf4PTsIpl9UIvCvDUqC+0l9gMs8+rXlBadsy6bnjCc=; b=1sMnAoXUOxjvoXV6LSaeuPKresdecU3ZDrmcQKohtdd+QzukFzDTZHCgLggtzBFYGR rYmnGzUjUKDfVVvTiz7iX3AHoKUH3OGRdrV/TQ9zNtDl7cZso5WygSUDpex5xpqz6jCF xYPFVus2ILV8ykRExuSS3wfuav2FKa8NX54S24jTQuc5qFJ8G4H+8aAO7+BytRCk0zJ2 qDMJI7HkfbySTVXKtV4rPxGNXyjIE0QBYDje+wVV/VggLM6RmvnwqTP5kILcDhRCr1zR MzndiwMdKKesr8dvkCXqLvhcwmLvkTNaYNzwVsry1JNX3GAu/LuhfqACoreOCuzmqQiy SxJA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=wpf4PTsIpl9UIvCvDUqC+0l9gMs8+rXlBadsy6bnjCc=; b=S5Lti3srt4Y0FFs9KAy4JWbnQqPFzXLYtX5n78HgP6IdK94d3l6BMUtvoHCeyPRj5I rnIwMOqpL79iXgo1ADXmgBP4gq6lFt8RUdGe5IHUl0nj3QyLhCAn1NoVJvaxxMtc/9Fx xMPdrtJrV9QDxDKXzLsxSeZhDY9oXnDb3b5buLVX4xw0y5ONb4g+jkEKBJ96A2OIJKtL bYzwzDblFEYpG4lN61k+1oIz4F7nhsmHkbkMZu2pC0Acf3WQDfazJup6zn57LQFv7i07 G5cc20Pzz5HRvbCbcL+Swc31Zl01mkZUlbHIHnyWScPw79Sdk9dR58F6Qg24ulEbApLc mqtA== X-Gm-Message-State: AOAM532MM5TzXCfphil73OhSuK2KLDO6R5dUNs8BrlghdnjqmIjNdVEO 1AAWIv94/i/j2YZ2d58QuL1ZEU/fPLhrVXNF X-Received: by 2002:aa7:829a:0:b029:2e9:e53:198d with SMTP id s26-20020aa7829a0000b02902e90e53198dmr17329802pfm.72.1624738346036; Sat, 26 Jun 2021 13:12:26 -0700 (PDT) Received: from localhost.localdomain ([139.177.225.228]) by smtp.gmail.com with ESMTPSA id b70sm9428317pfb.183.2021.06.26.13.12.24 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Sat, 26 Jun 2021 13:12:25 -0700 (PDT) From: liudingming To: ffmpeg-devel@ffmpeg.org Date: Sun, 27 Jun 2021 04:12:21 +0800 Message-Id: <20210626201221.28822-1-liudingming@bytedance.com> X-Mailer: git-send-email 2.28.0 MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH] avutil/frame: fix av_frame_get_buffer's doc 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 Cc: liudingming Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" X-TUID: og6pToaNgkwj av_frame_get_buffer can be used with channels set. Signed-off-by: liudingming --- libavutil/frame.h | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/libavutil/frame.h b/libavutil/frame.h index ff2540a20f..40523aff71 100644 --- a/libavutil/frame.h +++ b/libavutil/frame.h @@ -722,9 +722,16 @@ void av_frame_move_ref(AVFrame *dst, AVFrame *src); * Allocate new buffer(s) for audio or video data. * * The following fields must be set on frame before calling this function: - * - format (pixel format for video, sample format for audio) - * - width and height for video - * - nb_samples and channel_layout for audio + * + * Video: + * - format (pixel format) + * - width + * - height + * + * Audio: + * - format (sample format) + * - nb_samples + * - channel_layout or channels * * This function will fill AVFrame.data and AVFrame.buf arrays and, if * necessary, allocate and fill AVFrame.extended_data and AVFrame.extended_buf.