← Back to branch summary

~ubuntu-branches/ubuntu/trusty/libav/trusty-proposed

« back to all changes in this revision

Viewing changes to doc/indevs.texi

  • Committer: Package Import Robot
  • Author(s): Reinhard Tartler
  • Date: 2013-10-22 23:24:08 UTC
  • mfrom: (1.3.36 sid)
  • Revision ID: package-import@ubuntu.com-20131022232408-b8tvvn4pyzri9mi3
Tags: 6:9.10-1ubuntu1
https://launchpad.net/bugs/1243235
https://launchpad.net/bugs/1180288
https://launchpad.net/bugs/1242802
* Build all -extra flavors from this source package, as libav got demoted
  from main to universe, cf LP: #1243235
* Simplify debian/rules to follow exactly the code that debian executes
* New upstream (LP: #1180288) fixes lots of security issues (LP: #1242802)
* Merge from unstable, remaining changes:
  - build-depend on libtiff5-dev rather than libtiff4-dev,
    avoids FTBFS caused by imlib
  - follow the regular debian codepaths

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/indevs.texi
254
254
avconv -f sndio -i /dev/audio0 /tmp/oss.wav
255
255
@end example
256
256
 
257
 
@section video4linux and video4linux2
 
257
@section video4linux2
258
258
 
259
 
Video4Linux and Video4Linux2 input video devices.
 
259
Video4Linux2 input video device.
260
260
 
261
261
The name of the device to grab is a file device node, usually Linux
262
262
systems tend to automatically create such nodes when the device
264
264
kind @file{/dev/video@var{N}}, where @var{N} is a number associated to
265
265
the device.
266
266
 
267
 
Video4Linux and Video4Linux2 devices only support a limited set of
 
267
Video4Linux2 devices usually support a limited set of
268
268
@var{width}x@var{height} sizes and framerates. You can check which are
269
 
supported for example with the command @file{dov4l} for Video4Linux
270
 
devices and using @command{-list_formats all} for Video4Linux2 devices.
271
 
 
272
 
If the size for the device is set to 0x0, the input device will
273
 
try to autodetect the size to use.
274
 
Only for the video4linux2 device, if the frame rate is set to 0/0 the
275
 
input device will use the frame rate value already set in the driver.
276
 
 
277
 
Video4Linux support is deprecated since Linux 2.6.30, and will be
278
 
dropped in later versions.
279
 
 
280
 
Follow some usage examples of the video4linux devices with the av*
281
 
tools.
 
269
supported using @command{-list_formats all} for Video4Linux2 devices.
 
270
 
 
271
Some usage examples of the video4linux2 devices with avconv and avplay:
 
272
 
282
273
@example
283
 
# Grab and show the input of a video4linux device, frame rate is set
284
 
# to the default of 25/1.
285
 
avplay -s 320x240 -f video4linux /dev/video0
286
 
 
287
 
# Grab and show the input of a video4linux2 device, autoadjust size.
288
 
avplay -f video4linux2 /dev/video0
289
 
 
290
 
# Grab and record the input of a video4linux2 device, autoadjust size,
291
 
# frame rate value defaults to 0/0 so it is read from the video4linux2
292
 
# driver.
293
 
avconv -f video4linux2 -i /dev/video0 out.mpeg
 
274
# Grab and show the input of a video4linux2 device.
 
275
avplay -f video4linux2 -framerate 30 -video_size hd720 /dev/video0
 
276
 
 
277
# Grab and record the input of a video4linux2 device, leave the
 
278
framerate and size as previously set.
 
279
avconv -f video4linux2 -input_format mjpeg -i /dev/video0 out.mpeg
294
280
@end example
295
281
 
296
282
@section vfwcap
314
300
 
315
301
@var{hostname}:@var{display_number}.@var{screen_number} specifies the
316
302
X11 display name of the screen to grab from. @var{hostname} can be
317
 
ommitted, and defaults to "localhost". The environment variable
 
303
omitted, and defaults to "localhost". The environment variable
318
304
@env{DISPLAY} contains the default display name.
319
305
 
320
306
@var{x_offset} and @var{y_offset} specify the offsets of the grabbed