Register name used to load filter: pin
This filter handles generic input pipes (mono-directionnal) in blocking or non blocking mode.
Warning: Input pipes cannot seek.
The associated protocol scheme is
pipe:// when loaded as a generic input (eg,
-i pipe://URL where URL is a relative or absolute pipe name).
Data format of the pipe should be specified using extension (either in file name or through ext) or MIME type through mime.
Note: Unless disabled at session level (see -no-probe ), file extensions are usually ignored and format probing is done on the first data block.
On Windows hosts, the default pipe prefix is
\\.\pipe\gpac\ if no prefix is set
dst=mypipe resolves in \\.\pipe\gpac\mypipe
dst=\\.\pipe\myapp\mypipe resolves in \\.\pipe\myapp\mypipe
Any destination name starting with
\\ is used as is, with
\ translated in
Input pipes are created by default in non-blocking mode.
The pipe input can create the pipe if not found using mkp. On windows hosts, this will create a pipe server.
On non windows hosts, the created pipe will delete the pipe file upon filter destruction.
Input pipes can be setup to run forever using ka. In this case, any potential pipe close on the writing side and end of stream will only be triggered upon session close.
This can be useful to pipe raw streams from different process into gpac:
gpac -i pipe://mypipe:ext=.264:mkp:ka
cat raw1.264 > mypipe && gpac -i raw2.264 -o pipe://mypipe:ext=.264
The pipe input can be created in blocking mode or non-blocking mode. If the filter creates the pipe, blocking mode is always enabled.
src (string): location of source content
block_size (unsigned int, default: 5000): buffer size used to read pipe
ext (string): indicate file extension of pipe data
mime (string): indicate mime type of pipe data
blk (boolean, default: false): open pipe in block mode - see filter help
ka (boolean, default: false): keep-alive pipe when end of input is detected - see filter help
mkp (boolean, default: false): create pipe if not found - see filter help