From patchwork Mon Aug 6 21:24:29 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sergey Lavrushkin X-Patchwork-Id: 9920 Delivered-To: ffmpegpatchwork@gmail.com Received: by 2002:a02:104:0:0:0:0:0 with SMTP id c4-v6csp3730805jad; Mon, 6 Aug 2018 14:24:39 -0700 (PDT) X-Google-Smtp-Source: AAOMgpcr7/Oz7SyP7FYmLyq+KslyuCmoU3Lg1w1agU6SCXKtpXNM2AjmhtVvfc9XwFIj5b6wrWYb X-Received: by 2002:adf:8806:: with SMTP id d6-v6mr10472899wrd.41.1533590679460; Mon, 06 Aug 2018 14:24:39 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1533590679; cv=none; d=google.com; s=arc-20160816; b=jBLmaqwm8x8DEljLVDl9h0nPUzY2HeRn2+ycGQwWL9mmXMc4VeMxzVZ+rdLzm2CFHt pOyUbIqIhn7jGsIKxyL6XUzNmMt9RliBTdgWaYAZ8ChkP75vZB2MyeRy/EaTPQjQpwoS 1Hf09VReFfxj5NyqDQj1yGByssax5MMcCnKAFvMVSb7QeJbE5RW1kN/j7CM8feXMH1ZT xfRMHCeavxmWYrNrw6ypxoiI+UapTfz48gtT4u0Q4Iw1O4PZWtu6bT/R7J1DVQ71SFtV lr/8sEMcFFrbwiUA2DBRHOYeo++dzvP7oSx4cHwtTmgaA6K0zkzv3F26XhIurvADIXJl xalA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:reply-to:list-subscribe:list-help:list-post :list-archive:list-unsubscribe:list-id:precedence:subject:to :message-id:date:from:mime-version:dkim-signature:delivered-to :arc-authentication-results; bh=/r3BD9QLgCCnbvO7atTaW3MI54H7f/a+mcdZ8XJHYr0=; b=bFqqqFXrLrwATg6PoAx0ahkQCA3jSKLUNnpDrJ/Wpr2IBXAtvZijWrdVuFq4+oZguD Ce0hM+TMfbyLYDphmlipocWZD0O0AYuzPDyzdgogHXwdAHcLeavF0AyadlsGJEmTvWsJ 2tIcUvrtXoMH66d71sxBu/bV6GwP5jYROi1Y4EK3zwE8qqXjuH3dH2QdusMkmAyQe4cv Byn4T9u+++SkBH33aon+ZXnV2HRguTlcGZ0HUiTH3n1cieMIL9k94Z/kwAfo+4PTtAaF XLkVMtQwPNdawcRkTwPZu2jP0Cal8PasavVWiJdGhZKKyMycUgJ/61DwH1+lFDJAbvAn 8eNA== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@gmail.com header.s=20161025 header.b=vQ1M2oQe; 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 o18-v6si6110472wmd.123.2018.08.06.14.24.39; Mon, 06 Aug 2018 14:24:39 -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=vQ1M2oQe; 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 6C6CA68999A; Tue, 7 Aug 2018 00:24:17 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-pf1-f170.google.com (mail-pf1-f170.google.com [209.85.210.170]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 5218A680D38 for ; Tue, 7 Aug 2018 00:24:11 +0300 (EEST) Received: by mail-pf1-f170.google.com with SMTP id a26-v6so7461568pfo.4 for ; Mon, 06 Aug 2018 14:24:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:from:date:message-id:subject:to; bh=z66o/qaaS3FVBeMDG+Sj+0JaIxhbuRbpjO1Gln7muFg=; b=vQ1M2oQepcqvn4kir3DJjahIW9uv5uXjDZmdLoiGBzKLWmkzfOBqt4cwJHyDBdNqcL XSkmnn5iedUxXpUHjnAce+lZo8G2mB1rVgQbMqNNhQzZ8/PcEcc/E1tRB7jDO8mDeSbs FUUiRfyAJmLaw1DoZYxzVEDX23zVNNume1DK4MqDJ+7J82cbXFdhS+wMLA1Rc+3JmKy3 L8YDJRUa3oe8txikTuIE7KEw0XjHNLmuo+BCqYOWqQLuv+0em5ngvSFLT5RkLGpmqtWE H2Mh0n2tpoj03R9aSzhZF+jAMo+z7L4vcxv7ldJRJMKoSIIQDnnGhHEQ3yvNvjuDir5F eepA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=z66o/qaaS3FVBeMDG+Sj+0JaIxhbuRbpjO1Gln7muFg=; b=U548VkTOlz4ZyTGB0+zc3HfQkfg3AZSMgjcRMSB5fiYZVYb3YDapTjv75upW9GlkAq +y+g3RIC3jWpLlEVn2rSQ7/RIlaCTff23NwO5+0vlwMnRQ9h3eayCoCi1ubNecEK05MW BRL/M/w5IDMyCiiVmHXRk7BurRUOviG97BwgDH1m0IMU7VNwuCRi/KQIsnhPu7PCu4+2 mqm/D51QAb6wum5NkRejhI2Y/VoUepT3VaqXq950du3hz/NmaHjoLOGeT06/eJ8vVtFc 9lDFLdAtZksES6zmY37m93J9znn+1B0VWrl3jRpEqTr50ydVqTzpBIVL2NFhzf99qHzN N47A== X-Gm-Message-State: AOUpUlGXo6UMc4Q0KWdZnjHC3ulWTo27OBosEQaB9onQk0jNouMASMyG nP9d0KtZ3XANgFvZg2Q7xO1lQv2/2SMksoQ1xx6O1Urq X-Received: by 2002:a62:a649:: with SMTP id t70-v6mr18923514pfe.149.1533590670050; Mon, 06 Aug 2018 14:24:30 -0700 (PDT) MIME-Version: 1.0 Received: by 2002:a17:90a:501:0:0:0:0 with HTTP; Mon, 6 Aug 2018 14:24:29 -0700 (PDT) From: Sergey Lavrushkin Date: Tue, 7 Aug 2018 00:24:29 +0300 Message-ID: To: FFmpeg development discussions and patches X-Content-Filtered-By: Mailman/MimeDel 2.1.20 Subject: [FFmpeg-devel] [PATCH] 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 Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" From f076c4be5455331958b928fcea6b3dd8da287527 Mon Sep 17 00:00:00 2001 From: Sergey Lavrushkin Date: Fri, 3 Aug 2018 17:24:00 +0300 Subject: [PATCH 9/9] doc/filters.texi: Adds documentation for sr filter. --- doc/filters.texi | 60 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 60 insertions(+) diff --git a/doc/filters.texi b/doc/filters.texi index 0b0903e5a7..e2436a24e7 100644 --- a/doc/filters.texi +++ b/doc/filters.texi @@ -15394,6 +15394,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 what 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 what 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 neccessary +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 format. If path to model +file is not specified, built-in models for 2x upscaling are used. + +@end table + @anchor{subtitles} @section subtitles -- 2.14.1