From patchwork Wed Aug 15 16:35:09 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sergey Lavrushkin X-Patchwork-Id: 10001 Delivered-To: ffmpegpatchwork@gmail.com Received: by 2002:a02:104:0:0:0:0:0 with SMTP id c4-v6csp1010970jad; Wed, 15 Aug 2018 09:43:20 -0700 (PDT) X-Google-Smtp-Source: AA+uWPwIEmC6QxgJ9OluFrk0k96/97Ep48lCtSIKIRTK2UwShsYbm19yIGdktPWjo0hpM2ThO+8B X-Received: by 2002:a5d:528f:: with SMTP id c15-v6mr16688314wrv.102.1534351400497; Wed, 15 Aug 2018 09:43:20 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1534351400; cv=none; d=google.com; s=arc-20160816; b=T50IrMI6Y+jbKSAMUTHRWzPvG8NG++Dhf/n4FoG6MmAByMK4A5dSyS43jksTzixe/2 UelMZDb7vBlVVU/5LpGKC5tHivS8mIc32ZIYWzw6UWovPh6Da/1lTD+BR74JIYE/6kvy rIlEAowwZLHiVBvr4jiUJnmoKYWRYBm5zqXLobonYdmWGioIg8MgQ83+zrG50sF9is4C T+egPGs8PFqv/EnI8LHIUJlNz9tvPCdIdZKMZxzZDkTCo2cTR87bc3m/biYmb4mNUqec N6KN/SPzwCJ2AHDFDf0aHPYyXO3bGWuCIsx1CHrpUhsPptQb0NJAAkVPzgVfMfZ8GGRL XNsQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:mime-version:cc:reply-to :list-subscribe:list-help:list-post:list-archive:list-unsubscribe :list-id:precedence:subject:message-id:date:to:from:dkim-signature :delivered-to:arc-authentication-results; bh=6nuomRklSMeYujwY1hEgwJRvR+rNCXg9fjSrUqaOrYk=; b=Lkoiv7t0fHjoyVwnZflORwJe+osTjb+cS27zjlMWYhc+zg+ZTyNTwS2wFpmjFM0r+8 g2pzqJRTqf6mklf/RYKMRkH69C25OBM+CohtVFh5yJu3CEaCeC7JSr07GnoMf+U9NHl9 l4oMqj9/GqT2jWYAU3pswZhMRsrO2Y+lGnqFjkUZV91A2jOUWBfEHQIU1daEY/ybH4md LZf7xHdzezVpznRvgq0yctGzByc98bWV0iJJPga4UrpL47YjgxgQhq+l79hWIuJ+Y3Gh QyN0pEASx5CBtoe4+j37T+7yqlnMQFTFqnZ5s7RslZCpS1om7MdmYisS6uDifv0WUDdI 5PAQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@gmail.com header.s=20161025 header.b=uCZ06gU2; 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 a6-v6si1557953wmc.33.2018.08.15.09.43.19; Wed, 15 Aug 2018 09:43: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=uCZ06gU2; 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 14A4668A671; Wed, 15 Aug 2018 19:42:53 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-lf1-f49.google.com (mail-lf1-f49.google.com [209.85.167.49]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id CCC3868A410 for ; Wed, 15 Aug 2018 19:42:46 +0300 (EEST) Received: by mail-lf1-f49.google.com with SMTP id f135-v6so1307107lfg.10 for ; Wed, 15 Aug 2018 09:43:11 -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; bh=qVy6PrWnTFNmvfa8pu9nyfZjm86tNc7YgZXIKChzdGk=; b=uCZ06gU2A0jp4EXGnCH9TMw3g/P8tYPeICrB1IQe67NB1VOOfKDssQE/TnlNc1GKDO PYDj6mYd04/JHninHtSFNGvp1TID0ded63Pagfu53aMx1gpNXt+QYY6F375BssxtGUAk J9HWj6sVQUYVKK8kQyl8tL9/uA65IPaNu9y3+JmXi+LEeP+yQcKIADLrhVLEA8rf274A D86GdCh4cMWhD1ddNOh3XndGNos1C4lAQk88jPGwQFLZxH0wtgomUAToTJf3D/W4Q/Fh 6CmMzO6fRTmWCkxu7ZXHhQtR37vDUS8c1n8JhoFCxm/+6KIl95no7Ako3E3cuC9kPVp0 zK6Q== 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; bh=qVy6PrWnTFNmvfa8pu9nyfZjm86tNc7YgZXIKChzdGk=; b=sB5zxB0pDPdorkSs90gxtiEY0ZtV7+9QT+MLY0DLXXN9ne+HeJlN2xexb8ZQx1Fch6 HWvvGGtElqsoSQvs233k6yhDN86eTvHg8usssJUYmFmLY050u/0rq+1OUGVDIrXQtQ7+ mImJqgj2RBcsKpFjVQHnInup87+XxHqgowMcnXpT6F8m/esprM2vHoLnxUae0u8VaQcc ZNYg3BqQYwIxQXxurWOYicotWXjGmJFbJxd5X6gQlsKtCYvlbdgUdpe79GJv31TWwtYr p5MYTFLD7B6ZXO46VXHd0mHuh6422nZU6z0QfpEzXInwuygyYH4M0S+cF5Xrga8iCyV/ Rwcg== X-Gm-Message-State: AOUpUlE0+kx8Iqg8BBu1JrGFF5u1BQTusr2aRZglrd/2sS3BnMe5/R+8 sxiCQj3mislEutWRSU9AXIl0tgaj X-Received: by 2002:a19:f015:: with SMTP id p21-v6mr16515567lfc.77.1534350944562; Wed, 15 Aug 2018 09:35:44 -0700 (PDT) Received: from localhost.localdomain (nat-1-27.msu.umos.ru. [85.89.127.27]) by smtp.gmail.com with ESMTPSA id n23-v6sm4029796ljh.77.2018.08.15.09.35.43 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 15 Aug 2018 09:35:43 -0700 (PDT) From: Sergey Lavrushkin To: ffmpeg-devel@ffmpeg.org Date: Wed, 15 Aug 2018 19:35:09 +0300 Message-Id: <20180815163510.29123-1-dualfal@gmail.com> X-Mailer: git-send-email 2.14.1 Subject: [FFmpeg-devel] [PATCH 1/2] doc/filters.texi: Adds documentation for sr filter. 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 Cc: Sergey Lavrushkin MIME-Version: 1.0 Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" Resending patch with documentation for sr filter. --- doc/filters.texi | 60 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 60 insertions(+) diff --git a/doc/filters.texi b/doc/filters.texi index 267bd04a43..b2a74cb1ce 100644 --- a/doc/filters.texi +++ b/doc/filters.texi @@ -15403,6 +15403,66 @@ option may cause flicker since the B-Frames have often larger QP. Default is @code{0} (not enabled). @end table +@section sr + +Scale the input by applying one of the super-resolution methods based on +convolutional neural networks. + +Training scripts as well as scripts for model generation are provided in +the repository @url{https://github.com/HighVoltageRocknRoll/sr.git}. + +The filter accepts the following options: + +@table @option +@item model +Specify which super-resolution model to use. This option accepts the following values: + +@table @samp +@item srcnn +Super-Resolution Convolutional Neural Network model +@url{https://arxiv.org/abs/1501.00092}. + +@item espcn +Efficient Sub-Pixel Convolutional Neural Network model +@url{https://arxiv.org/abs/1609.05158}. + +@end table + +Default value is @samp{srcnn}. + +@item dnn_backend +Specify which DNN backend to use for model loading and execution. This option accepts +the following values: + +@table @samp +@item native +Native implementation of DNN loading and execution. + +@item tensorflow +TensorFlow backend @url{https://www.tensorflow.org/}. To enable this backend you +need to install the TensorFlow for C library (see +@url{https://www.tensorflow.org/install/install_c}) and configure FFmpeg with +@code{--enable-libtensorflow} + +@end table + +Default value is @samp{native}. + +@item scale_factor +Set scale factor for SRCNN model, for which custom model file was provided. +Allowed values are @code{2}, @code{3} and @code{4}. Scale factor is necessary +for SRCNN model, because it accepts input upscaled using bicubic upscaling with +proper scale factor. + +Default value is @code{2}. + +@item model_filename +Set path to model file specifying network architecture and its parameters. +Note that different backends use different file formats. If path to model +file is not specified, built-in models for 2x upscaling are used. + +@end table + @anchor{subtitles} @section subtitles