From patchwork Tue Apr 3 14:23:13 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bodecs Bela X-Patchwork-Id: 8307 Delivered-To: ffmpegpatchwork@gmail.com Received: by 10.2.1.70 with SMTP id c67csp3742221jad; Tue, 3 Apr 2018 07:23:20 -0700 (PDT) X-Google-Smtp-Source: AIpwx49FL1adAlv3NGBZxWbxP93QmuXEb5XcpSIW9IiWwR98Dx2iYv1JdxZVVfSlUrNM0QfeJmdw X-Received: by 10.28.112.11 with SMTP id l11mr3994294wmc.31.1522765400642; Tue, 03 Apr 2018 07:23:20 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1522765400; cv=none; d=google.com; s=arc-20160816; b=TZb3jMIvTCIjWf7/aSBjLhLCWyOvLZS1CLdZ2R4W3yxIoxrhndj5z1hJLhrLwQZ3kP I76nXMLn+A+0MFRAQwW77BFmC1dZTyOU57dfoOoA91NFHwugXFBbHrtjAvHtVz4EXYpV 7zaDGodvaKRMtRh0+/pApOXkUB8m/iX3UX7r7lBU1HcI5lGG7Tvx01Rq/cOPiA03oTW6 2tpzyb+BIz+zKWFTypFf3tZJ8cUEOlW4dnTj4jk+05wdTuh7ClB3XyH+94GzdvECkkOk TENuJ4+IH2etzZoRw5FujHlyxw3Zc+A2Ta1ICDlSHV5z1fAENvYf0UPALnP7HzAUWD16 13Zg== 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 :content-language:mime-version:user-agent:date:message-id:from:to :delivered-to:arc-authentication-results; bh=YLT+924FsQ/u1650w8p6Im5rQeV+i0bPja60mdkks3Y=; b=c5SSAUzGwoUGmkYD7jHBbdpfZKvXynbJXNVPvSR2D+UIoDQszwqiruo+kG24FBWHDF buDhhTMq4Rtw6J+4bMxG250o9gcu4fIq4cIaTF+W3XjlS6Jr3RpGja8cZo+arUsMywG2 ekAuCe3QoBv9i/KSxq7GQnhAFX1U2nKDZWOR9/HnBzacLCPWNCnSx67KCF0D4/swDGb2 Y/KhDIZ9vleGp5Ss9R40YQMoB1FA9Y+F4/YDu0Ga9LfQM58OU9+uzteRuER2CZnXeuQZ 4uQp3iu4IykkFPNETl3Nq/5gIvA2XNhPFm8O8//iHWTWIBO1HZ55gG0pwWVfcF8aaOAq B+Og== ARC-Authentication-Results: i=1; mx.google.com; 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 Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org. [79.124.17.100]) by mx.google.com with ESMTP id l15si2090983wrb.494.2018.04.03.07.23.19; Tue, 03 Apr 2018 07:23: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; 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 Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 6CE72689950; Tue, 3 Apr 2018 17:22:57 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-xsmtp2.externet.hu (mail-xsmtp2.externet.hu [212.40.96.153]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 26D6B680414 for ; Tue, 3 Apr 2018 17:22:50 +0300 (EEST) Received: (qmail 13067 invoked from network); 3 Apr 2018 14:23:09 -0000 Received: from unknown (HELO ?192.168.3.7?) (bodecsb@vivanet.hu@100.100.1.36) by 0 with ESMTPA; 3 Apr 2018 14:23:09 -0000 To: FFmpeg development discussions and patches From: Bodecs Bela Message-ID: <59092e57-8d1c-b531-b3f8-3c4eb9a2eaf9@vivanet.hu> Date: Tue, 3 Apr 2018 16:23:13 +0200 User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:52.0) Gecko/20100101 Thunderbird/52.6.0 MIME-Version: 1.0 Content-Language: hu Subject: [FFmpeg-devel] [PATCH] doc/filters: some more details and modified example to, zmq/azmq 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" Dear All, I added some more information about default value of bind_address option and its abbreviated version (b). I modified the example to have named instanced filter and to show its use. please review this patch. thanky you in advance, best regards, Bela Bodecs From 5464b56e6d21f1e87166ada31affc7e63cf6f90d Mon Sep 17 00:00:00 2001 From: Bela Bodecs Date: Tue, 3 Apr 2018 16:18:02 +0200 Subject: [PATCH] doc/filters: some more details and modified example to zmq/azmq Info about default value of bind_address option and its abbreviated version (b). Example modified to have named instanced filter and to show its use. Signed-off-by: Bela Bodecs --- doc/filters.texi | 29 +++++++++++++++++++++++------ 1 file changed, 23 insertions(+), 6 deletions(-) diff --git a/doc/filters.texi b/doc/filters.texi index bf2b94e..6665bfa 100644 --- a/doc/filters.texi +++ b/doc/filters.texi @@ -221,6 +221,7 @@ Here is a BNF description of the filtergraph syntax: @var{FILTERGRAPH} ::= [sws_flags=@var{flags};] @var{FILTERCHAIN} [;@var{FILTERGRAPH}] @end example +@anchor{filtergraph escaping} @section Notes on filtergraph escaping Filtergraph description composition entails several levels of @@ -20267,7 +20268,8 @@ filters in the filtergraph. @code{zmq} and @code{azmq} work as a pass-through filters. @code{zmq} must be inserted between two video filters, @code{azmq} between two -audio filters. +audio filters. Both of them are capable to send messages to any filter +type. To enable these filters you need to install the libzmq library and headers and configure FFmpeg with @code{--enable-libzmq}. @@ -20277,7 +20279,10 @@ For more information about libzmq see: The @code{zmq} and @code{azmq} filters work as a libzmq server, which receives messages sent through a network interface defined by the -@option{bind_address} option. +@option{bind_address} option. (An alternative, abbreviated name of this +option is @option{b}.) Default value of this option is +"tcp://*:5555". You may want to alter this value to your needs, +but don't forget to escape ':' signs. (See @ref{filtergraph escaping} section.) The received message must be in the form: @example @@ -20285,7 +20290,10 @@ The received message must be in the form: @end example @var{TARGET} specifies the target of the command, usually the name of -the filter class or a specific filter instance name. +the filter class or a specific filter instance name. The default +filter instance name is something like this "Parsed__", +but you can override this by using filter_name@@id syntax. +(See @ref{Filtergraph syntax} section.) @var{COMMAND} specifies the name of the command for the target filter. @@ -20307,14 +20315,17 @@ will send a reply to the client, adopting the format: Look at @file{tools/zmqsend} for an example of a zmq client which can be used to send commands processed by these filters. -Consider the following filtergraph generated by @command{ffplay} +Consider the following filtergraph generated by @command{ffplay}, +We specify instance name for the 1st overlay filter only, +the other ones will have default instance names. + @example ffplay -dumpgraph 1 -f lavfi " color=s=100x100:c=red [l]; color=s=100x100:c=blue [r]; nullsrc=s=200x100, zmq [bg]; -[bg][l] overlay [bg+l]; -[bg+l][r] overlay=x=100 " +[bg][l] overlay [bg+l]; +[bg+l][r] overlay@@my=x=100 " @end example To change the color of the left side of the video, the following @@ -20328,6 +20339,12 @@ To change the right side: echo Parsed_color_1 c pink | tools/zmqsend @end example +To change the position of the right side: +@example +echo overlay@@my x 150 | tools/zmqsend +@end example + + @c man end MULTIMEDIA FILTERS @chapter Multimedia Sources