From patchwork Wed May 12 18:44:36 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Shubhanshu Saxena X-Patchwork-Id: 27725 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a6b:b214:0:0:0:0:0 with SMTP id b20csp5281580iof; Wed, 12 May 2021 11:45:20 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwNvsao3f9IAIV1dDg5YxfNB5rrTDFhjTfs/6KZyO1DdrW639mfY3z6lukT2Og8EMOVM4IB X-Received: by 2002:aa7:d4d5:: with SMTP id t21mr31794685edr.95.1620845120093; Wed, 12 May 2021 11:45:20 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1620845120; cv=none; d=google.com; s=arc-20160816; b=FDXyfCU8TDHf2Dm7Of8FsFFCgM4/UTzACTbdegcEacCqgIlmUu6Yz2O8T232u0Llyf JlYPxON523Y7iUBca9EKZCDctes2OnyoNNgXfKoGjmlraricJPzskGezPH2ePX3Kq9fU ymvz0a7OCHfb7CzXdB20AhfNpwmUs+WeHyK1Ax3fByNmftwdBJUT20clatkLLIF3qxQ9 rU7dAQNw0bevqn9fptjACMoAqGO13KC/fGnauRcmw4qmZ+fnB1c4IrGvyB4jnCIIphr5 fQBY1xql1TOCvfeFsrqDV50YoI8LOmy6lytU783SUtrH2yLAKNexgzANMPClxAJHYCq6 K6VA== 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=aRPba5jiaRIKOdw86oTfrlUVs6BPzlimXbTNN9EpEWg=; b=JrdUzvJMNM30XcyZk6jj8WVJ/bWyUISTlTJMYldX9Z3QM71aLy9Ait1qtht2Gg5RJf LMAo9VXZ4wgyskxs8Oxczjuu/taD+wWen5UCOsI+ATiSBhknDrYJYGEpwnhnykIShVKV nqJw+X5kTJ1pccXGlJjkq9Sd88ph3fd7+ZASMngVSm4XsgqvX/zpIDMmwSVuZUHMpzEm vfxe4nVN/2HoCKPooVsDKZEhE/lns1h8LQfDrJHdVpQp7Za9XAQBB4wfmvcubCOZjKcp jslsIVllcawSWuMh5gU6wRKsALCClNF0sv6suDZ2SO1Dc5zd6fnMt8tyZ32IP5Si42Ax meuw== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@gmail.com header.s=20161025 header.b=XVua2uEX; 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 q17si754688ejj.672.2021.05.12.11.45.19; Wed, 12 May 2021 11:45:20 -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=XVua2uEX; 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 226FB680A37; Wed, 12 May 2021 21:45:16 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-pl1-f173.google.com (mail-pl1-f173.google.com [209.85.214.173]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id C4ED26802C0 for ; Wed, 12 May 2021 21:45:09 +0300 (EEST) Received: by mail-pl1-f173.google.com with SMTP id a11so12976479plh.3 for ; Wed, 12 May 2021 11:45:09 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=m7z4xbKiuTsnBL8Mqd37rEVFpWszK/1dGTyTDuHQhAs=; b=XVua2uEXFux0XQW0EtQBjcFNlfAFXlRgYr74AC6EP9B4CWvRV97LiSPF4bYV3T8TnR 0tlKGeTvMJHiMIkquFvrjBOwLuhwqThNCQfDeRFD3ubMF5/cimRqJpQIgRKIIKHxlQgD pnZrSl95eXRLZm7Qgs1euaGwbseLBDq2EGKKx48RMjgwZPkmhZMLcwWQRgHD5g/gUyKU 8phRWLxuh16pa/gqqs5fqPoXYtdV14ImRteLJ/Fi3IaWnUrM7rv0eDSrLX066G1OgoDV sV8s1vHHPz8sxTC7n3QZjCZopaNzqNnD8MwYtNOSG0kJcMQwUSl0R2TjAF8MOReJTavU Rrdw== 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=m7z4xbKiuTsnBL8Mqd37rEVFpWszK/1dGTyTDuHQhAs=; b=Nn3SJOdAsx3DZH2h6tpv6QTfuw3ZrxyJDx5IFARaifN/hGkck7+V31Rbv+6FToS7wP XLQjopU8UtHf8XpH+T+JdKYxI5Dp6RjI9WELc4Uf5BuOFVQ5OXEgkuX451DJEIY2ft0v 6+FMcQ+F814hDp1xQ1UhfUTu6DhwhUSCr8o19kYFb0E+7/UCKKrO29MkBBfS7A/lNHdD 3aOsHgcvRUHwzOpVTOw+3WhN0GKep++yJPumk+03I+JDowN8LmTUoh4F31tY3yZLwgTo t6xkMcOqKXpJ8ssM1VliUu77d4LGDh8ziYNCJaK91S365Cy7uiV6IRcBfyLtQG/FdP3L O0rA== X-Gm-Message-State: AOAM533refif/4GvmAgi+M7gZ0ynLncVkE6U1TOIlonzh5DMMvA7WzVR KMhYB3lSN7Af2D0MfTNn58dd+qM/cJTWIQ== X-Received: by 2002:a17:902:d482:b029:ef:28db:4405 with SMTP id c2-20020a170902d482b02900ef28db4405mr21917055plg.40.1620845107463; Wed, 12 May 2021 11:45:07 -0700 (PDT) Received: from Pavilion-x360.bbrouter ([103.133.123.78]) by smtp.googlemail.com with ESMTPSA id js6sm4866120pjb.0.2021.05.12.11.45.05 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 12 May 2021 11:45:06 -0700 (PDT) From: Shubhanshu Saxena To: ffmpeg-devel@ffmpeg.org Date: Thu, 13 May 2021 00:14:36 +0530 Message-Id: <20210512184439.30591-1-shubhanshu.e01@gmail.com> X-Mailer: git-send-email 2.27.0 MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH 1/5 v2] lavfi/dnn_backend_native_layer_avgpool.h: 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 Cc: Shubhanshu Saxena Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" X-TUID: P+Buiy+Yb5C/ Add documentation for Average Pool Layer Signed-off-by: Shubhanshu Saxena --- .../dnn/dnn_backend_native_layer_avgpool.h | 29 +++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/libavfilter/dnn/dnn_backend_native_layer_avgpool.h b/libavfilter/dnn/dnn_backend_native_layer_avgpool.h index 75d9eb187b..ae55940366 100644 --- a/libavfilter/dnn/dnn_backend_native_layer_avgpool.h +++ b/libavfilter/dnn/dnn_backend_native_layer_avgpool.h @@ -33,7 +33,36 @@ typedef struct AvgPoolParams{ DNNPaddingParam padding_method; } AvgPoolParams; +/** + * @brief Load Average Pooling Layer. + * + * It assigns the layer parameters to the hyperparameters + * like strides, padding method, and kernel size after + * parsing from the model file context. + * + * @param layer pointer to the DNN layer instance + * @param model_file_context pointer to model file context + * @param file_size model file size to check if data is read + * correctly from the model file + * @param operands_num operand count of the whole model to + * check if data is read correctly from the model file + * @return number of bytes read from the model file + * @retval 0 if out of memory or an error occurs + */ int ff_dnn_load_layer_avg_pool(Layer *layer, AVIOContext *model_file_context, int file_size, int operands_num); + +/** + * @brief Execute the Average Pooling Layer. + * Padding in channel dimensions is currently not supported. + * + * @param operands all operands for the model + * @param input_operand_indexes input operand indexes for this layer + * @param output_operand_index output operand index for this layer + * @param parameters average pooling parameters + * @param ctx pointer to Native model context for logging + * @retval 0 if the execution succeeds + * @retval DNN_ERROR if the execution fails + */ int ff_dnn_execute_layer_avg_pool(DnnOperand *operands, const int32_t *input_operand_indexes, int32_t output_operand_index, const void *parameters, NativeContext *ctx);