avformat: remove deprecated AVStream.codec

[ffmpeg] / doc / outdevs.texi

diff --git a/doc/outdevs.texi b/doc/outdevs.texi
index 30d376d793afb1f6e948c18e4d4313303ebf417b..aaf247995cc5e50f4176b80b46c3adc723ee30a9 100644 (file)
--- a/doc/outdevs.texi
+++ b/doc/outdevs.texi
@@ -38,6 +38,52 @@ ffmpeg -i INPUT -f alsa hw:1,7
 @end example
 @end itemize
 
 @end example
 @end itemize
 

+@section AudioToolbox
+
+AudioToolbox output device.
+
+Allows native output to CoreAudio devices on OSX.
+
+The output filename can be empty (or @code{-}) to refer to the default system output device or a number that refers to the device index as shown using: @code{-list_devices true}.
+
+Alternatively, the audio input device can be chosen by index using the
+@option{
+    -audio_device_index <INDEX>
+}
+, overriding any device name or index given in the input filename.
+
+All available devices can be enumerated by using @option{-list_devices true}, listing
+all device names, UIDs and corresponding indices.
+
+@subsection Options
+
+AudioToolbox supports the following options:
+
+@table @option
+
+@item -audio_device_index <INDEX>
+Specify the audio device by its index. Overrides anything given in the output filename.
+
+@end table
+
+@subsection Examples
+
+@itemize
+
+@item
+Print the list of supported devices and output a sine wave to the default device:
+@example
+$ ffmpeg -f lavfi -i sine=r=44100 -f audiotoolbox -list_devices true -
+@end example
+
+@item
+Output a sine wave to the device with the index 2, overriding any output filename:
+@example
+$ ffmpeg -f lavfi -i sine=r=44100 -f audiotoolbox -audio_device_index 2 -
+@end example
+
+@end itemize
+

 @section caca
 
 CACA output device.
 @section caca
 
 CACA output device.


@@ -140,7 +186,8 @@ device with @command{-list_formats 1}. Audio sample rate is always 48 kHz.
 
 @item list_devices
 If set to @option{true}, print a list of devices and exit.
 
 @item list_devices
 If set to @option{true}, print a list of devices and exit.

-Defaults to @option{false}.
+Defaults to @option{false}. This option is deprecated, please use the
+@code{-sinks} option of ffmpeg to list the available output devices.

 
 @item list_formats
 If set to @option{true}, print a list of supported formats and exit.
 
 @item list_formats
 If set to @option{true}, print a list of supported formats and exit.


@@ -150,6 +197,14 @@ Defaults to @option{false}.
 Amount of time to preroll video in seconds.
 Defaults to @option{0.5}.
 
 Amount of time to preroll video in seconds.
 Defaults to @option{0.5}.
 

+@item duplex_mode
+Sets the decklink device duplex mode. Must be @samp{unset}, @samp{half} or @samp{full}.
+Defaults to @samp{unset}.
+
+@item timing_offset
+Sets the genlock timing pixel offset on the used output.
+Defaults to @samp{unset}.
+

 @end table
 
 @subsection Examples
 @end table
 
 @subsection Examples


@@ -159,7 +214,7 @@ Defaults to @option{0.5}.
 @item
 List output devices:
 @example
 @item
 List output devices:
 @example

-ffmpeg -i test.avi -f decklink -list_devices 1 dummy
+ffmpeg -sinks decklink

 @end example
 
 @item
 @end example
 
 @item


@@ -211,51 +266,6 @@ ffmpeg -re -i INPUT -c:v rawvideo -pix_fmt bgra -f fbdev /dev/fb0
 
 See also @url{http://linux-fbdev.sourceforge.net/}, and fbset(1).
 
 
 See also @url{http://linux-fbdev.sourceforge.net/}, and fbset(1).
 

-@section libndi_newtek
-
-The libndi_newtek output device provides playback capabilities for using NDI (Network
-Device Interface, standard created by NewTek).
-
-Output filename is a NDI name.
-
-To enable this output device, you need the NDI SDK and you
-need to configure with the appropriate @code{--extra-cflags}
-and @code{--extra-ldflags}.
-
-NDI uses uyvy422 pixel format natively, but also supports bgra, bgr0, rgba and
-rgb0.
-
-@subsection Options
-
-@table @option
-
-@item reference_level
-The audio reference level in dB. This specifies how many dB above the
-reference level (+4dBU) is the full range of 16 bit audio.
-Defaults to @option{0}.
-
-@item clock_video
-These specify whether video "clock" themselves.
-Defaults to @option{false}.
-
-@item clock_audio
-These specify whether audio "clock" themselves.
-Defaults to @option{false}.
-
-@end table
-
-@subsection Examples
-
-@itemize
-
-@item
-Play video clip:
-@example
-ffmpeg -i "udp://@@239.1.1.1:10480?fifo_size=1000000&overrun_nonfatal=1" -vf "scale=720:576,fps=fps=25,setdar=dar=16/9,format=pix_fmts=uyvy422" -f libndi_newtek NEW_NDI1
-@end example
-
-@end itemize
-

 @section opengl
 OpenGL output device.
 
 @section opengl
 OpenGL output device.
 


@@ -365,6 +375,8 @@ ffmpeg  -i INPUT -f pulse "stream name"
 
 SDL (Simple DirectMedia Layer) output device.
 
 
 SDL (Simple DirectMedia Layer) output device.
 

+"sdl2" can be used as alias for "sdl".
+

 This output device allows one to show a video stream in an SDL
 window. Only one SDL window is allowed per application, so you can
 have only one instance of this output device in an application.
 This output device allows one to show a video stream in an SDL
 window. Only one SDL window is allowed per application, so you can
 have only one instance of this output device in an application.


@@ -393,6 +405,10 @@ Set the SDL window size, can be a string of the form
 If not specified it defaults to the size of the input video,
 downscaled according to the aspect ratio.
 
 If not specified it defaults to the size of the input video,
 downscaled according to the aspect ratio.
 

+@item window_x
+@item window_y
+Set the position of the window on the screen.
+

 @item window_fullscreen
 Set fullscreen mode when non-zero value is provided.
 Default value is zero.
 @item window_fullscreen
 Set fullscreen mode when non-zero value is provided.
 Default value is zero.