yading@10: @chapter Output Devices yading@10: @c man begin OUTPUT DEVICES yading@10: yading@10: Output devices are configured elements in FFmpeg which allow to write yading@10: multimedia data to an output device attached to your system. yading@10: yading@10: When you configure your FFmpeg build, all the supported output devices yading@10: are enabled by default. You can list all available ones using the yading@10: configure option "--list-outdevs". yading@10: yading@10: You can disable all the output devices using the configure option yading@10: "--disable-outdevs", and selectively enable an output device using the yading@10: option "--enable-outdev=@var{OUTDEV}", or you can disable a particular yading@10: input device using the option "--disable-outdev=@var{OUTDEV}". yading@10: yading@10: The option "-formats" of the ff* tools will display the list of yading@10: enabled output devices (amongst the muxers). yading@10: yading@10: A description of the currently available output devices follows. yading@10: yading@10: @section alsa yading@10: yading@10: ALSA (Advanced Linux Sound Architecture) output device. yading@10: yading@10: @section caca yading@10: yading@10: CACA output device. yading@10: yading@10: This output devices allows to show a video stream in CACA window. yading@10: Only one CACA window is allowed per application, so you can yading@10: have only one instance of this output device in an application. yading@10: yading@10: To enable this output device you need to configure FFmpeg with yading@10: @code{--enable-libcaca}. yading@10: libcaca is a graphics library that outputs text instead of pixels. yading@10: yading@10: For more information about libcaca, check: yading@10: @url{http://caca.zoy.org/wiki/libcaca} yading@10: yading@10: @subsection Options yading@10: yading@10: @table @option yading@10: yading@10: @item window_title yading@10: Set the CACA window title, if not specified default to the filename yading@10: specified for the output device. yading@10: yading@10: @item window_size yading@10: Set the CACA window size, can be a string of the form yading@10: @var{width}x@var{height} or a video size abbreviation. yading@10: If not specified it defaults to the size of the input video. yading@10: yading@10: @item driver yading@10: Set display driver. yading@10: yading@10: @item algorithm yading@10: Set dithering algorithm. Dithering is necessary yading@10: because the picture being rendered has usually far more colours than yading@10: the available palette. yading@10: The accepted values are listed with @code{-list_dither algorithms}. yading@10: yading@10: @item antialias yading@10: Set antialias method. Antialiasing smoothens the rendered yading@10: image and avoids the commonly seen staircase effect. yading@10: The accepted values are listed with @code{-list_dither antialiases}. yading@10: yading@10: @item charset yading@10: Set which characters are going to be used when rendering text. yading@10: The accepted values are listed with @code{-list_dither charsets}. yading@10: yading@10: @item color yading@10: Set color to be used when rendering text. yading@10: The accepted values are listed with @code{-list_dither colors}. yading@10: yading@10: @item list_drivers yading@10: If set to @option{true}, print a list of available drivers and exit. yading@10: yading@10: @item list_dither yading@10: List available dither options related to the argument. yading@10: The argument must be one of @code{algorithms}, @code{antialiases}, yading@10: @code{charsets}, @code{colors}. yading@10: @end table yading@10: yading@10: @subsection Examples yading@10: yading@10: @itemize yading@10: @item yading@10: The following command shows the @command{ffmpeg} output is an yading@10: CACA window, forcing its size to 80x25: yading@10: @example yading@10: ffmpeg -i INPUT -vcodec rawvideo -pix_fmt rgb24 -window_size 80x25 -f caca - yading@10: @end example yading@10: yading@10: @item yading@10: Show the list of available drivers and exit: yading@10: @example yading@10: ffmpeg -i INPUT -pix_fmt rgb24 -f caca -list_drivers true - yading@10: @end example yading@10: yading@10: @item yading@10: Show the list of available dither colors and exit: yading@10: @example yading@10: ffmpeg -i INPUT -pix_fmt rgb24 -f caca -list_dither colors - yading@10: @end example yading@10: @end itemize yading@10: yading@10: @section oss yading@10: yading@10: OSS (Open Sound System) output device. yading@10: yading@10: @section sdl yading@10: yading@10: SDL (Simple DirectMedia Layer) output device. yading@10: yading@10: This output devices allows to show a video stream in an SDL yading@10: window. Only one SDL window is allowed per application, so you can yading@10: have only one instance of this output device in an application. yading@10: yading@10: To enable this output device you need libsdl installed on your system yading@10: when configuring your build. yading@10: yading@10: For more information about SDL, check: yading@10: @url{http://www.libsdl.org/} yading@10: yading@10: @subsection Options yading@10: yading@10: @table @option yading@10: yading@10: @item window_title yading@10: Set the SDL window title, if not specified default to the filename yading@10: specified for the output device. yading@10: yading@10: @item icon_title yading@10: Set the name of the iconified SDL window, if not specified it is set yading@10: to the same value of @var{window_title}. yading@10: yading@10: @item window_size yading@10: Set the SDL window size, can be a string of the form yading@10: @var{width}x@var{height} or a video size abbreviation. yading@10: If not specified it defaults to the size of the input video, yading@10: downscaled according to the aspect ratio. yading@10: @end table yading@10: yading@10: @subsection Examples yading@10: yading@10: The following command shows the @command{ffmpeg} output is an yading@10: SDL window, forcing its size to the qcif format: yading@10: @example yading@10: ffmpeg -i INPUT -vcodec rawvideo -pix_fmt yuv420p -window_size qcif -f sdl "SDL output" yading@10: @end example yading@10: yading@10: @section sndio yading@10: yading@10: sndio audio output device. yading@10: yading@10: @c man end OUTPUT DEVICES