f40cf96ec0
Force re-generation of the manuals when an included file is modified. The current dependency generation system is enable to track nested inclusions. The drawback is that the files will be generated even when there is no strict need (for example if filters.texi is modified, ffmpeg.1 is rebuilt), thus it trades a false negative with a false positive.
275 lines
7.0 KiB
Plaintext
275 lines
7.0 KiB
Plaintext
\input texinfo @c -*- texinfo -*-
|
|
|
|
@settitle ffplay Documentation
|
|
@titlepage
|
|
@center @titlefont{ffplay Documentation}
|
|
@end titlepage
|
|
|
|
@top
|
|
|
|
@contents
|
|
|
|
@chapter Synopsis
|
|
|
|
ffplay [@var{options}] [@file{input_file}]
|
|
|
|
@chapter Description
|
|
@c man begin DESCRIPTION
|
|
|
|
FFplay is a very simple and portable media player using the FFmpeg
|
|
libraries and the SDL library. It is mostly used as a testbed for the
|
|
various FFmpeg APIs.
|
|
@c man end
|
|
|
|
@chapter Options
|
|
@c man begin OPTIONS
|
|
|
|
@include avtools-common-opts.texi
|
|
|
|
@section Main options
|
|
|
|
@table @option
|
|
@item -x @var{width}
|
|
Force displayed width.
|
|
@item -y @var{height}
|
|
Force displayed height.
|
|
@item -s @var{size}
|
|
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.
|
|
@item -an
|
|
Disable audio.
|
|
@item -vn
|
|
Disable video.
|
|
@item -ss @var{pos}
|
|
Seek to a given position in seconds.
|
|
@item -t @var{duration}
|
|
play <duration> seconds of audio/video
|
|
@item -bytes
|
|
Seek by bytes.
|
|
@item -nodisp
|
|
Disable graphical display.
|
|
@item -f @var{fmt}
|
|
Force format.
|
|
@item -window_title @var{title}
|
|
Set window title (default is the input filename).
|
|
@item -loop @var{number}
|
|
Loops movie playback <number> times. 0 means forever.
|
|
@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}.
|
|
|
|
@item -vf @var{filtergraph}
|
|
Create the filtergraph specified by @var{filtergraph} and use it to
|
|
filter the video stream.
|
|
|
|
@var{filtergraph} is a description of the filtergraph to apply to
|
|
the stream, and must have a single video input and a single video
|
|
output. In the filtergraph, the input is associated to the label
|
|
@code{in}, and the output to the label @code{out}. See the
|
|
ffmpeg-filters manual for more information about the filtergraph
|
|
syntax.
|
|
|
|
@item -af @var{filtergraph}
|
|
@var{filtergraph} is a description of the filtergraph to apply to
|
|
the input audio.
|
|
Use the option "-filters" to show all the available filters (including
|
|
sources and sinks).
|
|
|
|
@item -i @var{input_file}
|
|
Read @var{input_file}.
|
|
@end table
|
|
|
|
@section Advanced options
|
|
@table @option
|
|
@item -pix_fmt @var{format}
|
|
Set pixel format.
|
|
This option has been deprecated in favor of private options, try -pixel_format.
|
|
|
|
@item -stats
|
|
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}.
|
|
|
|
@item -bug
|
|
Work around bugs.
|
|
@item -fast
|
|
Non-spec-compliant optimizations.
|
|
@item -genpts
|
|
Generate pts.
|
|
@item -rtp_tcp
|
|
Force RTP/TCP protocol usage instead of RTP/UDP. It is only meaningful
|
|
if you are streaming with the RTSP protocol.
|
|
@item -sync @var{type}
|
|
Set the master clock to audio (@code{type=audio}), video
|
|
(@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.
|
|
@item -threads @var{count}
|
|
Set the thread count.
|
|
@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.
|
|
@item -autoexit
|
|
Exit when video is done playing.
|
|
@item -exitonkeydown
|
|
Exit if any key is pressed.
|
|
@item -exitonmousedown
|
|
Exit if any mouse button is pressed.
|
|
|
|
@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.
|
|
@end table
|
|
|
|
@section While playing
|
|
|
|
@table @key
|
|
@item q, ESC
|
|
Quit.
|
|
|
|
@item f
|
|
Toggle full screen.
|
|
|
|
@item p, SPC
|
|
Pause.
|
|
|
|
@item a
|
|
Cycle audio channel.
|
|
|
|
@item v
|
|
Cycle video channel.
|
|
|
|
@item t
|
|
Cycle subtitle channel.
|
|
|
|
@item w
|
|
Show audio waves.
|
|
|
|
@item left/right
|
|
Seek backward/forward 10 seconds.
|
|
|
|
@item down/up
|
|
Seek backward/forward 1 minute.
|
|
|
|
@item page down/page up
|
|
Seek backward/forward 10 minutes.
|
|
|
|
@item mouse click
|
|
Seek to percentage in file corresponding to fraction of width.
|
|
|
|
@end table
|
|
|
|
@c man end
|
|
|
|
@include config.texi
|
|
@ifset config-all
|
|
@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
|
|
@end ifset
|
|
|
|
@chapter See Also
|
|
|
|
@ifhtml
|
|
@ifset config-all
|
|
@url{ffplay.html,ffplay},
|
|
@end ifset
|
|
@ifset config-not-all
|
|
@url{ffplay-all.html,ffmpeg-all},
|
|
@end ifset
|
|
@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},
|
|
@url{ffmpeg-bitstream-filters.html,ffmpeg-bitstream-filters},
|
|
@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
|
|
@ifset config-all
|
|
ffplay(1),
|
|
@end ifset
|
|
@ifset config-not-all
|
|
ffplay-all(1),
|
|
@end ifset
|
|
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
|
|
|
|
@include authors.texi
|
|
|
|
@ignore
|
|
|
|
@setfilename ffplay
|
|
@settitle FFplay media player
|
|
|
|
@end ignore
|
|
|
|
@bye
|