outdevs.texi 2.1 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273
  1. @chapter Output Devices
  2. @c man begin OUTPUT DEVICES
  3. Output devices are configured elements in FFmpeg which allow to write
  4. multimedia data to an output device attached to your system.
  5. When you configure your FFmpeg build, all the supported output devices
  6. are enabled by default. You can list all available ones using the
  7. configure option "--list-outdevs".
  8. You can disable all the output devices using the configure option
  9. "--disable-outdevs", and selectively enable an output device using the
  10. option "--enable-outdev=@var{OUTDEV}", or you can disable a particular
  11. input device using the option "--disable-outdev=@var{OUTDEV}".
  12. The option "-formats" of the ff* tools will display the list of
  13. enabled output devices (amongst the muxers).
  14. A description of the currently available output devices follows.
  15. @section alsa
  16. ALSA (Advanced Linux Sound Architecture) output device.
  17. @section oss
  18. OSS (Open Sound System) output device.
  19. @section sdl
  20. SDL (Simple Directmedia Layer) output device.
  21. This output devices allows to show a video stream in an SDL
  22. window. Only one SDL window is allowed per application, so you can
  23. have only one instance of this output device in an application.
  24. To enable this output device you need libsdl installed on your system
  25. when configuring your build.
  26. For more information about SDL, check:
  27. @url{http://www.libsdl.org/}
  28. @subsection Options
  29. @table @option
  30. @item window_title
  31. Set the SDL window title, if not specified default to the filename
  32. specified for the output device.
  33. @item icon_title
  34. Set the name of the iconified SDL window, if not specified it is set
  35. to the same value of @var{window_title}.
  36. @item window_size
  37. Set the SDL window size, can be a string of the form
  38. @var{width}x@var{height} or a video size abbreviation.
  39. If not specified it defaults to the size of the input video.
  40. @end table
  41. @subsection Examples
  42. The following command shows the @file{ffmpeg} output is an
  43. SDL window, forcing its size to the qcif format:
  44. @example
  45. ffmpeg -i INPUT -vcodec rawvideo -pix_fmt yuv420p -window_size qcif -f sdl "SDL output"
  46. @end example
  47. @section sndio
  48. sndio audio output device.
  49. @c man end OUTPUT DEVICES