ffmpeg文档27-输出设备

27 输出设备

输出设备是可配置用于ffmpeg写入多媒体数据的元素，其附加到系统的输出设备。

在编译配置ffmepg时，所有支持的输出设备都被默认允许。你可以使用配置选项–list-outdevs了解有哪些设备。

你可以通过–disable-outdevs禁止编译所有输出设备，然后再通过–enable-outdev=OUTDEV以支持个别的设备，也可以通过默认配置，再添加–disable-outdev=OUTDEV来禁用个别设备。

在ff*工具集中，-devices可以显示当前允许的输出设备。

当前有效的输出设备介绍见下。

alsa

ALSA(Advanced Linux Sound Architecture) 音频输出设备

alsa例子

• 在默认ALSA设备播放:

  ffmpeg -i INPUT -f alsa default

• 在声卡1的7音频设备播放:

  ffmpeg -i INPUT -f alsa hw:1,7

caca

CACA输出设备

这个输出设备允许在CACA窗口显示视频流。每个程序仅有一个CACA窗口。所以在一个实例中你只能有一个CACA输出。

要允许这个输出设备，需要编译时配置--enable-libcaca，libcaca是一个输出文本而不是像素的图形库。

关于libcaca的更多信息参考http://caca.zoy.org/wiki/libcaca

caca选项

• window_title

  设置CACA窗口标题,如果没有设置，文件名作为默认值指定到输出设备

• window_size

  设置CACA窗口尺寸, 参数可以是widthxheight或者一个视频大小缩写。如果没有指定，则以输入视频为默认

• driver

  设置显示驱动

• algorithm

  设置抖动算法。有时抖动是必要的，其可以让感觉到的颜色大于调色板。其接受-list_dither列出的算法

• antialias

  设置抗锯齿算法。抗锯齿可柔滑渲染后的图像,并避免常见的楼梯效果。其接受-list_dither列出的抗锯齿算法

• charset

  设置哪些字符将显示文本时使用。它接受-list_dither列出的字符集

• color

  设置将用于渲染的颜色，接受-list_dither列出的颜色

• list_drivers

  如果设置为真，输出可用的设备并退出

• list_dither

  抖动可用选项列表相关的参数。参数为algorithms, antialiases, charsets, colors

caca例子

• 下面的命令将强制一个80x25的CACA窗口输出:

  ffmpeg -i INPUT -vcodec rawvideo -pix_fmt rgb24 -window_size 80x25 -f caca -

• 列出有效设备并退出:

  ffmpeg -i INPUT -pix_fmt rgb24 -f caca -list_drivers true -

• 列出有效抖动颜色并退出:

  ffmpeg -i INPUT -pix_fmt rgb24 -f caca -list_dither colors -

decklink

在Blackmagic DeckLink设备输出回放。

编译需要Blackmagic DeckLink SDK，以及配置--extra-cflags和--extra-ldflags以允许。在Windows下，你需要通过widl运行IDL文件。

DEckLink非常挑剔所支持的格式。像素格式必须是uyvy422，帧率和视频分辨率必须是设备-list_formats 1列出的值，音频采样频率必须是48kHz。

decklink选项

• list_devices

  如果设置为true，将列出设备并退出。默认为false.

• list_formats

  如果设置为true,将列出支持的格式并退出，默认为false.

• preroll

  以秒为单位设置预卷视频的时间，默认为0.5

decklink例子

• 列出输出设备:

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

• 列出支持的格式:

  ffmpeg -i test.avi -f decklink -list_formats 1 'DeckLink Mini Monitor'

• 播放视频片段:

  ffmpeg -i test.avi -f decklink -pix_fmt uyvy422 'DeckLink Mini Monitor'

• 按非标准的帧率和视频大小播放视频:

  ffmpeg -i test.avi -f decklink -pix_fmt uyvy422 -s 720x486 -r 24000/1001 'DeckLink Mini Monitor'

fbdev

Linux framebuffer（linux帧缓冲）输出设备

Linux framebuffer是独立于硬件的计算机屏幕显示图形的抽象层，通常用于控制台，它通过文件设备点访问，通常为/dev/fb0

更多信息阅读Linux源码树中的 Documentation/fb/framebuffer.txt文档。

fbdev选项

• xoffset

• yoffset

  设置左上角的x/y坐标，默认为0

fbdev例子

在设备/dev/fb0播放文件，需要的像素格式依赖于当前framebuffer设置

ffmpeg -re -i INPUT -vcodec rawvideo -pix_fmt bgra -f fbdev /dev/fb0

更多请参考http://linux-fbdev.sourceforge.net/的fbset(1)

opengl

OpenGL输出设备

编译允许配置选项--enable-opengl

这个输出设备允许渲染输出OpenGL内容。内容可以是由程序提供或者默认创建的的SDL窗口。

当设备呈现到外部环境时，程序必须实现处理如下的消息：

• AV_DEV_TO_APP_CREATE_WINDOW_BUFFER - 在当前线程创建OpenGL 环境

• AV_DEV_TO_APP_PREPARE_WINDOW_BUFFER - OpenGL当前上下文（环境）

• AV_DEV_TO_APP_DISPLAY_WINDOW_BUFFER - 交换缓冲区

• AV_DEV_TO_APP_DESTROY_WINDOW_BUFFER - 分解/摧毁OpenGL环境

• AV_APP_TO_DEV_WINDOW_SIZE - 告知相关设备（更新信息，程序向设备的）

opengl选项

• background

  设置背景颜色，默认为Black (黑色)

• no_window

  非0表示禁止默认的SDL窗口。程序必须提供OpenGL环境（上下文）同时设置 window_size_cb与window_swap_buffers_cb两个回调

• window_title

  设置SDL窗口标题,如果没有指定将以指代输出设备的文件名作为默认。当no_window设置时会被忽略。

• window_size

  设置首选窗口尺寸，可以是形如widthxheight的字符串参数或者视频尺寸短语。如果不指定则默认以输入视频尺寸进行等比例缩放（让高或者宽恰好等于窗口最大可能且完全展示的尺寸）。如果no_window没有设置可用

opengl例子

使用OpenGL渲染播放到SDL窗口

ffmpeg  -i INPUT -f opengl "window title"

oss

OSS（open Sound System）输出设备

pulse

PulseAudio输出设备

编译选项开关--enable-libpulse

更多关于PulseAudio信息参考http://www.pulseaudio.org

pulse选项

• server

  以IP地址描述的用于连接到的PulseAudio服务器，如果不提供则为默认服务器（其他地方进行配置）

• name

  将显示在活动客户端的应用名，默认为LIBAVFORMAT_IDENT

• stream_name

  显示为活动流的流名称，默认为指定的输出名

• device

  指定设备。如果不指定则采用默认设备。可以用命令pactl列出输出设备

• buffer_size

• buffer_duration

  控制缓冲尺寸和持续时间。一个小的缓冲区提供了更多的控制，当需要更频繁的更新。

  buffer_size是按字节指定
  buffer_duration以milliseconds为单位指定

  当两个都被指定时，使用更大的值(持续时间将按使用流的参数重新计算——即按流参数可以把buffer_size转换成buffer_duration来比较). 如果设置为0 (默认值), 将采用默认的PulseAudio持续时间，即2秒.

• prebuf

  指定pre-buffering尺寸，单位字节。它指定服务器开始播放前至少缓冲的量。默认会同于buffer_size 或buffer_duration（中大的一个）

• minreq

  指定最小请求尺寸，单位字节。即如果数据量达到这里指定的值，就可向服务器发送请求，而不是达到缓冲区填满。它不被建议设置，由服务器来初始化这个值更明智

pulse例子

在默认服务器的默认设备上播放文件

ffmpeg  -i INPUT -f pulse "stream name"

sdl

SDL（Simple DirectMedia Layer）输出设备

其可以允许在SDL窗口上显示视频流。每个进程仅能创建一个SDL窗口所以你的程序实例只有一个SDL设备输出。

编译需要libsdl库。

关于SDL的更多信息参考http://www.libsdl.org/

sdl选项

• window_title

  设置SDL窗口标题，如果没有指定，则用输出文件名

• icon_title

  置图标化SDL窗口的名称，如果没有指定则采用和window_title

• window_size

  设置SDL窗口尺寸，可以是widthxheight格式，也可以是视频尺寸短语。如果没有指定则以输入文件的等比例填充放大最大可能值（某边和屏幕窗口边重合）

• window_fullscreen

  非0则设置全屏模式，默认为0

sdl交换命令

• 窗口创建的设备可以通过下面的交互式控制命令；

  Quit the device immediately.

sdl例子

下面强制以qcif尺寸标准中SDL窗口上显示图像

andio

sndio 音频输出设备

xv

XV（XVideo）输出设备

这个X环境设备允许在Xwindow系统的一个窗口上显示视频流

xv选项

• display_name

  指定用在显示的硬件名，它决定了显示和通信

  显示名或者DISPLAY环境变量值是一个格式字符串hostname[:number[.screen_number]]

  hostname是指定了主机的物理连接，number指明了在主机上显示服务索引号，screen_number指定了服务上的那个屏幕

  如果不指定，则采用DISPLAY环境变量值

  例如：dual-headed:0.1指定了是dual-headed主机上的0号显示服务的1号屏幕

  通过X11介绍了解更多关于显示名的格式信息

• window_id

  为非0值表示不创建新窗口而是使用已有的window_id窗口（如果该window_id窗口已经存在）。默认为0表示创建自己的窗口。

• window_size

  设置窗口尺寸，参数可以是widthxheight或者视频尺寸短语。如果不指定，则默认以输入视频尺寸，当window_id被设置时忽略

• window_x

• window_y

  设置创建窗口的坐标偏移。默认都为0.它可能被窗口管理器忽略。当window_id被设置后被忽略。

• window_title

  设置窗口标题，如果不设置默认以输出文件名作为值，当window_id被设置后被忽略

xv例子

• 同时解码、显示和编码输入

  ffmpeg -i INPUT OUTPUT -f xv display

• 解码显示输入视频到多个X11窗口:

  ffmpeg -i INPUT -f xv normal -vf negate -f xv negated