2003-08-24 11:16:29 +00:00
|
|
|
\input texinfo @c -*- texinfo -*-
|
|
|
|
|
2011-04-23 13:19:17 +00:00
|
|
|
@settitle ffplay Documentation
|
2003-08-24 11:16:29 +00:00
|
|
|
@titlepage
|
2011-04-23 13:19:17 +00:00
|
|
|
@center @titlefont{ffplay Documentation}
|
2003-08-24 11:16:29 +00:00
|
|
|
@end titlepage
|
|
|
|
|
2011-01-29 12:24:13 +00:00
|
|
|
@top
|
|
|
|
|
|
|
|
@contents
|
|
|
|
|
2010-06-08 22:32:29 +00:00
|
|
|
@chapter Synopsis
|
|
|
|
|
2012-12-17 11:55:28 +00:00
|
|
|
ffplay [@var{options}] [@file{input_file}]
|
2003-08-24 11:16:29 +00:00
|
|
|
|
2010-06-03 21:23:07 +00:00
|
|
|
@chapter Description
|
2003-08-24 11:16:29 +00:00
|
|
|
@c man begin DESCRIPTION
|
2010-06-03 21:23:07 +00:00
|
|
|
|
2011-03-17 15:55:58 +00:00
|
|
|
FFplay is a very simple and portable media player using the FFmpeg
|
2005-06-09 18:12:07 +00:00
|
|
|
libraries and the SDL library. It is mostly used as a testbed for the
|
2011-03-17 15:55:58 +00:00
|
|
|
various FFmpeg APIs.
|
2003-08-24 11:16:29 +00:00
|
|
|
@c man end
|
|
|
|
|
2010-06-08 22:32:29 +00:00
|
|
|
@chapter Options
|
2003-08-24 11:16:29 +00:00
|
|
|
@c man begin OPTIONS
|
2010-02-21 10:56:38 +00:00
|
|
|
|
2013-09-08 22:36:55 +00:00
|
|
|
@include fftools-common-opts.texi
|
2010-02-21 10:56:38 +00:00
|
|
|
|
2003-08-24 11:16:29 +00:00
|
|
|
@section Main options
|
|
|
|
|
|
|
|
@table @option
|
2008-04-08 16:39:30 +00:00
|
|
|
@item -x @var{width}
|
2008-05-26 23:01:22 +00:00
|
|
|
Force displayed width.
|
2008-04-08 16:39:30 +00:00
|
|
|
@item -y @var{height}
|
2008-05-26 23:01:22 +00:00
|
|
|
Force displayed height.
|
2008-04-08 16:39:30 +00:00
|
|
|
@item -s @var{size}
|
2011-07-31 22:40:28 +00:00
|
|
|
Set frame size (WxH or abbreviation), needed for videos which do
|
|
|
|
not contain a header with the frame size like raw YUV. This option
|
|
|
|
has been deprecated in favor of private options, try -video_size.
|
2003-08-24 11:16:29 +00:00
|
|
|
@item -an
|
2008-05-26 23:01:22 +00:00
|
|
|
Disable audio.
|
2003-08-24 11:16:29 +00:00
|
|
|
@item -vn
|
2008-05-26 23:01:22 +00:00
|
|
|
Disable video.
|
2008-04-08 16:39:30 +00:00
|
|
|
@item -ss @var{pos}
|
2008-05-26 23:01:22 +00:00
|
|
|
Seek to a given position in seconds.
|
2010-04-01 20:56:23 +00:00
|
|
|
@item -t @var{duration}
|
|
|
|
play <duration> seconds of audio/video
|
2007-03-12 17:16:12 +00:00
|
|
|
@item -bytes
|
2008-05-26 23:01:22 +00:00
|
|
|
Seek by bytes.
|
2003-08-24 11:16:29 +00:00
|
|
|
@item -nodisp
|
2008-05-26 23:01:22 +00:00
|
|
|
Disable graphical display.
|
2008-04-08 16:39:30 +00:00
|
|
|
@item -f @var{fmt}
|
2008-05-26 23:01:22 +00:00
|
|
|
Force format.
|
2010-03-17 23:39:18 +00:00
|
|
|
@item -window_title @var{title}
|
|
|
|
Set window title (default is the input filename).
|
2010-03-23 17:39:51 +00:00
|
|
|
@item -loop @var{number}
|
|
|
|
Loops movie playback <number> times. 0 means forever.
|
2011-04-12 11:10:33 +00:00
|
|
|
@item -showmode @var{mode}
|
|
|
|
Set the show mode to use.
|
|
|
|
Available values for @var{mode} are:
|
|
|
|
@table @samp
|
|
|
|
@item 0, video
|
|
|
|
show video
|
|
|
|
@item 1, waves
|
|
|
|
show audio waves
|
|
|
|
@item 2, rdft
|
|
|
|
show audio frequency band using RDFT ((Inverse) Real Discrete Fourier Transform)
|
|
|
|
@end table
|
|
|
|
|
|
|
|
Default value is "video", if video is not present or cannot be played
|
|
|
|
"rdft" is automatically selected.
|
|
|
|
|
|
|
|
You can interactively cycle through the available show modes by
|
|
|
|
pressing the key @key{w}.
|
|
|
|
|
2013-03-30 19:13:08 +00:00
|
|
|
@item -vf @var{filtergraph}
|
|
|
|
Create the filtergraph specified by @var{filtergraph} and use it to
|
2013-01-13 14:23:15 +00:00
|
|
|
filter the video stream.
|
|
|
|
|
2013-03-30 19:13:08 +00:00
|
|
|
@var{filtergraph} is a description of the filtergraph to apply to
|
2013-01-13 14:23:15 +00:00
|
|
|
the stream, and must have a single video input and a single video
|
2013-03-30 19:13:08 +00:00
|
|
|
output. In the filtergraph, the input is associated to the label
|
2013-01-13 14:23:15 +00:00
|
|
|
@code{in}, and the output to the label @code{out}. See the
|
|
|
|
ffmpeg-filters manual for more information about the filtergraph
|
|
|
|
syntax.
|
2010-06-21 22:09:07 +00:00
|
|
|
|
2014-01-06 20:14:23 +00:00
|
|
|
You can specify this parameter multiple times and cycle through the specified
|
|
|
|
filtergraphs along with the show modes by pressing the key @key{w}.
|
|
|
|
|
2013-03-30 19:13:08 +00:00
|
|
|
@item -af @var{filtergraph}
|
|
|
|
@var{filtergraph} is a description of the filtergraph to apply to
|
2013-02-25 21:00:30 +00:00
|
|
|
the input audio.
|
|
|
|
Use the option "-filters" to show all the available filters (including
|
|
|
|
sources and sinks).
|
|
|
|
|
2011-06-04 22:06:20 +00:00
|
|
|
@item -i @var{input_file}
|
|
|
|
Read @var{input_file}.
|
2009-12-21 21:50:23 +00:00
|
|
|
@end table
|
2003-08-24 11:16:29 +00:00
|
|
|
|
|
|
|
@section Advanced options
|
|
|
|
@table @option
|
2008-04-08 16:39:30 +00:00
|
|
|
@item -pix_fmt @var{format}
|
2011-07-31 22:40:28 +00:00
|
|
|
Set pixel format.
|
|
|
|
This option has been deprecated in favor of private options, try -pixel_format.
|
2013-03-10 10:51:00 +00:00
|
|
|
|
2003-08-24 11:16:29 +00:00
|
|
|
@item -stats
|
2013-03-10 10:51:00 +00:00
|
|
|
Print several playback statistics, in particular show the stream
|
|
|
|
duration, the codec parameters, the current position in the stream and
|
|
|
|
the audio/video synchronisation drift. It is on by default, to
|
|
|
|
explicitly disable it you need to specify @code{-nostats}.
|
|
|
|
|
2007-03-12 17:16:12 +00:00
|
|
|
@item -bug
|
2008-05-26 23:01:22 +00:00
|
|
|
Work around bugs.
|
2007-03-12 17:16:12 +00:00
|
|
|
@item -fast
|
2008-05-26 23:01:22 +00:00
|
|
|
Non-spec-compliant optimizations.
|
2007-03-12 17:16:12 +00:00
|
|
|
@item -genpts
|
2008-05-26 23:01:22 +00:00
|
|
|
Generate pts.
|
2003-08-24 11:16:29 +00:00
|
|
|
@item -rtp_tcp
|
2005-06-09 18:12:07 +00:00
|
|
|
Force RTP/TCP protocol usage instead of RTP/UDP. It is only meaningful
|
|
|
|
if you are streaming with the RTSP protocol.
|
2008-04-08 16:39:30 +00:00
|
|
|
@item -sync @var{type}
|
2005-06-09 18:12:07 +00:00
|
|
|
Set the master clock to audio (@code{type=audio}), video
|
2003-08-24 11:16:29 +00:00
|
|
|
(@code{type=video}) or external (@code{type=ext}). Default is audio. The
|
|
|
|
master clock is used to control audio-video synchronization. Most media
|
|
|
|
players use audio as master clock, but in some cases (streaming or high
|
|
|
|
quality broadcast) it is necessary to change that. This option is mainly
|
|
|
|
used for debugging purposes.
|
2008-04-08 16:39:30 +00:00
|
|
|
@item -threads @var{count}
|
2008-05-26 23:01:22 +00:00
|
|
|
Set the thread count.
|
2009-03-01 17:13:33 +00:00
|
|
|
@item -ast @var{audio_stream_number}
|
|
|
|
Select the desired audio stream number, counting from 0. The number
|
|
|
|
refers to the list of all the input audio streams. If it is greater
|
|
|
|
than the number of audio streams minus one, then the last one is
|
|
|
|
selected, if it is negative the audio playback is disabled.
|
|
|
|
@item -vst @var{video_stream_number}
|
|
|
|
Select the desired video stream number, counting from 0. The number
|
|
|
|
refers to the list of all the input video streams. If it is greater
|
|
|
|
than the number of video streams minus one, then the last one is
|
|
|
|
selected, if it is negative the video playback is disabled.
|
|
|
|
@item -sst @var{subtitle_stream_number}
|
|
|
|
Select the desired subtitle stream number, counting from 0. The number
|
|
|
|
refers to the list of all the input subtitle streams. If it is greater
|
|
|
|
than the number of subtitle streams minus one, then the last one is
|
|
|
|
selected, if it is negative the subtitle rendering is disabled.
|
2014-09-06 18:20:44 +00:00
|
|
|
@item -noautoexit
|
|
|
|
Do not exit after playback is finished.
|
2010-07-04 12:43:12 +00:00
|
|
|
@item -exitonkeydown
|
|
|
|
Exit if any key is pressed.
|
|
|
|
@item -exitonmousedown
|
|
|
|
Exit if any mouse button is pressed.
|
2012-12-15 21:40:26 +00:00
|
|
|
|
|
|
|
@item -codec:@var{media_specifier} @var{codec_name}
|
|
|
|
Force a specific decoder implementation for the stream identified by
|
|
|
|
@var{media_specifier}, which can assume the values @code{a} (audio),
|
|
|
|
@code{v} (video), and @code{s} subtitle.
|
|
|
|
|
|
|
|
@item -acodec @var{codec_name}
|
|
|
|
Force a specific audio decoder.
|
|
|
|
|
|
|
|
@item -vcodec @var{codec_name}
|
|
|
|
Force a specific video decoder.
|
|
|
|
|
|
|
|
@item -scodec @var{codec_name}
|
|
|
|
Force a specific subtitle decoder.
|
2014-04-18 21:15:54 +00:00
|
|
|
|
|
|
|
@item -autorotate
|
|
|
|
Automatically rotate the video according to presentation metadata. Set by
|
|
|
|
default, use -noautorotate to disable.
|
2003-08-24 11:16:29 +00:00
|
|
|
@end table
|
|
|
|
|
|
|
|
@section While playing
|
|
|
|
|
|
|
|
@table @key
|
|
|
|
@item q, ESC
|
2008-05-26 23:01:22 +00:00
|
|
|
Quit.
|
2003-08-24 11:16:29 +00:00
|
|
|
|
|
|
|
@item f
|
2008-05-26 23:01:22 +00:00
|
|
|
Toggle full screen.
|
2003-08-24 11:16:29 +00:00
|
|
|
|
|
|
|
@item p, SPC
|
2008-05-26 23:01:22 +00:00
|
|
|
Pause.
|
2003-08-24 11:16:29 +00:00
|
|
|
|
|
|
|
@item a
|
2014-05-10 12:59:28 +00:00
|
|
|
Cycle audio channel in the current program.
|
2003-08-24 11:16:29 +00:00
|
|
|
|
|
|
|
@item v
|
2008-05-26 23:01:22 +00:00
|
|
|
Cycle video channel.
|
2003-08-24 11:16:29 +00:00
|
|
|
|
2009-02-08 22:22:26 +00:00
|
|
|
@item t
|
2013-10-13 20:15:39 +00:00
|
|
|
Cycle subtitle channel in the current program.
|
|
|
|
|
|
|
|
@item c
|
|
|
|
Cycle program.
|
2009-02-08 22:22:26 +00:00
|
|
|
|
2003-08-24 11:16:29 +00:00
|
|
|
@item w
|
2014-01-06 20:14:23 +00:00
|
|
|
Cycle video filters or show modes.
|
2007-03-12 17:16:12 +00:00
|
|
|
|
2013-12-29 17:42:56 +00:00
|
|
|
@item s
|
|
|
|
Step to the next frame.
|
|
|
|
|
|
|
|
Pause if the stream is not already paused, step to the next video
|
|
|
|
frame, and pause.
|
|
|
|
|
2007-03-12 17:16:12 +00:00
|
|
|
@item left/right
|
2008-05-26 23:01:22 +00:00
|
|
|
Seek backward/forward 10 seconds.
|
2007-03-12 17:16:12 +00:00
|
|
|
|
|
|
|
@item down/up
|
2008-05-26 23:01:22 +00:00
|
|
|
Seek backward/forward 1 minute.
|
2007-03-12 17:16:12 +00:00
|
|
|
|
2011-11-28 12:48:13 +00:00
|
|
|
@item page down/page up
|
2014-02-10 12:09:13 +00:00
|
|
|
Seek to the previous/next chapter.
|
|
|
|
or if there are no chapters
|
2011-11-28 12:48:13 +00:00
|
|
|
Seek backward/forward 10 minutes.
|
|
|
|
|
2007-03-12 17:16:12 +00:00
|
|
|
@item mouse click
|
2008-05-26 23:01:22 +00:00
|
|
|
Seek to percentage in file corresponding to fraction of width.
|
2007-03-12 17:16:12 +00:00
|
|
|
|
2003-08-24 11:16:29 +00:00
|
|
|
@end table
|
|
|
|
|
|
|
|
@c man end
|
|
|
|
|
2013-04-24 16:39:49 +00:00
|
|
|
@include config.texi
|
2013-03-19 19:54:26 +00:00
|
|
|
@ifset config-all
|
2014-01-09 05:19:52 +00:00
|
|
|
@set config-readonly
|
2013-04-24 16:39:49 +00:00
|
|
|
@ifset config-avutil
|
|
|
|
@include utils.texi
|
|
|
|
@end ifset
|
|
|
|
@ifset config-avcodec
|
|
|
|
@include codecs.texi
|
|
|
|
@include bitstream_filters.texi
|
|
|
|
@end ifset
|
|
|
|
@ifset config-avformat
|
|
|
|
@include formats.texi
|
|
|
|
@include protocols.texi
|
|
|
|
@end ifset
|
|
|
|
@ifset config-avdevice
|
|
|
|
@include devices.texi
|
|
|
|
@end ifset
|
|
|
|
@ifset config-swresample
|
|
|
|
@include resampler.texi
|
|
|
|
@end ifset
|
|
|
|
@ifset config-swscale
|
|
|
|
@include scaler.texi
|
|
|
|
@end ifset
|
|
|
|
@ifset config-avfilter
|
|
|
|
@include filters.texi
|
|
|
|
@end ifset
|
2013-03-19 19:54:26 +00:00
|
|
|
@end ifset
|
|
|
|
|
2012-12-16 19:53:16 +00:00
|
|
|
@chapter See Also
|
|
|
|
|
|
|
|
@ifhtml
|
2013-03-19 19:54:26 +00:00
|
|
|
@ifset config-all
|
|
|
|
@url{ffplay.html,ffplay},
|
|
|
|
@end ifset
|
|
|
|
@ifset config-not-all
|
|
|
|
@url{ffplay-all.html,ffmpeg-all},
|
|
|
|
@end ifset
|
2012-12-16 19:53:16 +00:00
|
|
|
@url{ffmpeg.html,ffmpeg}, @url{ffprobe.html,ffprobe}, @url{ffserver.html,ffserver},
|
|
|
|
@url{ffmpeg-utils.html,ffmpeg-utils},
|
|
|
|
@url{ffmpeg-scaler.html,ffmpeg-scaler},
|
|
|
|
@url{ffmpeg-resampler.html,ffmpeg-resampler},
|
|
|
|
@url{ffmpeg-codecs.html,ffmpeg-codecs},
|
2013-02-15 12:31:09 +00:00
|
|
|
@url{ffmpeg-bitstream-filters.html,ffmpeg-bitstream-filters},
|
2012-12-16 19:53:16 +00:00
|
|
|
@url{ffmpeg-formats.html,ffmpeg-formats},
|
|
|
|
@url{ffmpeg-devices.html,ffmpeg-devices},
|
|
|
|
@url{ffmpeg-protocols.html,ffmpeg-protocols},
|
|
|
|
@url{ffmpeg-filters.html,ffmpeg-filters}
|
|
|
|
@end ifhtml
|
|
|
|
|
|
|
|
@ifnothtml
|
2013-03-19 19:54:26 +00:00
|
|
|
@ifset config-all
|
|
|
|
ffplay(1),
|
|
|
|
@end ifset
|
|
|
|
@ifset config-not-all
|
|
|
|
ffplay-all(1),
|
|
|
|
@end ifset
|
2012-12-16 19:53:16 +00:00
|
|
|
ffmpeg(1), ffprobe(1), ffserver(1),
|
|
|
|
ffmpeg-utils(1), ffmpeg-scaler(1), ffmpeg-resampler(1),
|
|
|
|
ffmpeg-codecs(1), ffmpeg-bitstream-filters(1), ffmpeg-formats(1),
|
|
|
|
ffmpeg-devices(1), ffmpeg-protocols(1), ffmpeg-filters(1)
|
|
|
|
@end ifnothtml
|
|
|
|
|
2012-12-16 17:04:37 +00:00
|
|
|
@include authors.texi
|
|
|
|
|
2003-08-24 11:16:29 +00:00
|
|
|
@ignore
|
|
|
|
|
|
|
|
@setfilename ffplay
|
|
|
|
@settitle FFplay media player
|
|
|
|
|
|
|
|
@end ignore
|
|
|
|
|
|
|
|
@bye
|