~medibuntu-maintainers/mplayer/medibuntu.precise

« back to all changes in this revision

Viewing changes to ffmpeg/doc/ffmpeg.texi

  • Committer: Gauvain Pocentek
  • Date: 2012-03-06 11:59:12 UTC
  • mfrom: (66.1.15 precise)
  • Revision ID: gauvain@pocentek.net-20120306115912-h9d6kt9j0l532oo5
* Merge from Ubuntu:
  - put back faac support
  - recommends apport-hooks-medibuntu
  - change Maintainer, Uploaders & Vcs-* fields.
* New upstream snapshot
* upload to unstable
* Build against external libmpeg2
* drop 51_FTBFS_arm.patch again
* no longer build depend on libcdparanoia-dev on the Hurd
* Fix FTBFS on the hurd.
  Thanks to Samuel Thibault <sthibault@debian.org> (Closes: #654974)
* Fix FTBFS on arm
* New upstream snapshot, Closes: #650339, #643621, #481807
* Imported Upstream version 1.0~rc4+svn34492
* Bump standards version
* Bump dependency on libav >= 4:0.8~, Closes: #653887
* Fix build-indep
* Build mplayer-gui again, Closes: #568514
* Drop debian/all-lang-config-mak.sh, no longer needed
* include .dfsg1 in version number
* remove get-orig-source target
* no longer prune compiler flags from the environment
* No longer advertise nor build 3fdx, mga and dxr3 backends,
  Closes: #496106, #442181, #533546
* beautify mplayer version identification string
* Brown paperbag upload.
* Next try to fix build failure on sparce after recent binutils change.
* Brown paperbag upload.
* Really fix build failure on sparc after recent binutils change.
* Properly set Replaces/Conflicts on mplayer2{,-dbg} to avoid
  file overwrite errors.
* Adjust versioning of mplayer listed in the mplayer-dbg's Depends field.
* Fix build failure on sparc after recent binutils change.
* Urgency medium bumped because of RC-level bugfix
  and speeding up x264 transition.
* Update to my @debian.org email.
* Upload to unstable
* Enable joystick support on Linux only, Closes: #638408
* Rebuild fixes toolchain issue on arm, Closes: #637077
* New upstream snapshot
* following the discussion started by Diego Biurrun <diego@biurrun.de>
  in debian-devel, I have prepared a new packaging of 'mplayer'
  (with code that comes from CVS)
* the upstream tar.bz cannot be distributed by Debian, since it contains
   CSS code; so I am repackaging it 
* I have tried my best to address all known issues:
  - the package contains the detailed Copyright made by Diego Biurrun 
  - the package does not contain CSS code, or  AFAIK other code on which 
     there is active patent enforcement
  - there is a script  debian/cvs-changelog.sh  that shows all changes
     done to files included in this source.
    This should comply with GPLv2 sec 2.a  (in spirit if not in letter)
    For this reason, the source code contains CVS directories.
* needs   make (>= 3.80) for 'html-chunked-$(1)' in DOCS/xml/Makefile

* some corrections, as suggested Diego Biurrun
  - binary codecs should go into /usr/lib/codecs (upstream default)
  - better template 'mplayer/install_codecs'
  - an empty 'font=' in mplayer.conf breaks mplayer: postinst corrected
* correction in 'mplayer/cfgnote'
* better mplayer.postinst and mplayer.config

* New upstream release
* better debian/copyright file
* do not ship a skin
* New upstream release
* changed DEB_BUILD_OPTIONS to DEB_BUILD_CONFIGURE ,
  DEB_BUILD_OPTIONS is used as in debian policy
* use gcc-3.4
* changed xlibs-dev to a long list of dependencies, for Debian/etch
* try to adhere to  http://www.mplayerhq.hu/DOCS/tech/binary-packaging.txt
  (see README.Debian for details)
* removed dependency on xlibmesa-dev, disabled opengl
* New upstream release
* Simon McVittie <hacks@pseudorandom.co.uk> wonderful work:
- Work around Debian bug #267442 (glibc's sys/uio.h and gcc's altivec.h have
  conflicting uses for __vector) by re-ordering #includes
- Fix potential symlink attack in ./configure
- Disable support for binary codecs on platforms for which those codecs
  aren't available; also disable the corresponding Debconf note when it's
  inappropriate
- Changed Build-Depends: so it works in pbuilder
- Explicitly build-depend on libjpeg62-dev, libfontconfig1-dev,
  libungif4-dev 
- Tweak debian/rules to avoid certain errors being ignored
- Use --language=all
* provide a target  'debian/rules get-orig-source' 
  that recreates the orig.tar.gz ; then use the above orig.tar.gz
* rewrote some parts of debian/rules
* don't clean and recompile docs if upstream ships them
* mplayer-doc was shipping too much stuff
* translated man pages where not installed properly
* compile with libdv4-dev
* correct README.Debian
* Forgot build-dep on libtheora
* Must not depend on libxvidcore
* New upstream release
* new release.
* rc1 to become 0.90
* new pre-release
* new pre-release
* gtk bug fixed.
* new release.
* version bumped
* 0.60 pre2 release
* 0.60 pre-release.

Show diffs side-by-side

added added

removed removed

Lines of Context:
68
68
@chapter Options
69
69
@c man begin OPTIONS
70
70
 
71
 
@include fftools-common-opts.texi
 
71
@include avtools-common-opts.texi
72
72
 
73
73
@section Main options
74
74
 
159
159
@section Video Options
160
160
 
161
161
@table @option
162
 
@item -b @var{bitrate}
163
 
Set the video bitrate in bit/s (default = 200 kb/s).
164
162
@item -vframes @var{number}
165
163
Set the number of video frames to record.
166
164
@item -r @var{fps}
167
165
Set frame rate (Hz value, fraction or abbreviation), (default = 25).
168
166
@item -s @var{size}
169
 
Set frame size. The format is @samp{wxh} (ffserver default = 160x128, ffmpeg default = same as source).
 
167
Set frame size. The format is @samp{wxh} (avserver default = 160x128, ffmpeg default = same as source).
170
168
The following abbreviations are recognized:
171
169
@table @samp
172
170
@item sqcif
471
469
@item 3
472
470
FF_ER_AGGRESSIVE
473
471
@item 4
474
 
FF_ER_VERY_AGGRESSIVE
 
472
FF_ER_EXPLODE
475
473
@end table
476
474
 
477
475
@item -ec @var{bit_mask}
551
549
@item -aframes @var{number}
552
550
Set the number of audio frames to record.
553
551
@item -ar @var{freq}
554
 
Set the audio sampling frequency. For input streams it is set by
555
 
default to 44100 Hz, for output streams it is set by default to the
556
 
frequency of the input stream. If the input file has audio streams
557
 
with different frequencies, the behaviour is undefined.
558
 
@item -ab @var{bitrate}
559
 
Set the audio bitrate in bit/s (default = 64k).
 
552
Set the audio sampling frequency. For output streams it is set by
 
553
default to the frequency of the corresponding input stream. For input
 
554
streams this option only makes sense for audio grabbing devices and raw
 
555
demuxers and is mapped to the corresponding demuxer options.
560
556
@item -aq @var{q}
561
557
Set the audio quality (codec-specific, VBR).
562
558
@item -ac @var{channels}
563
 
Set the number of audio channels. For input streams it is set by
564
 
default to 1, for output streams it is set by default to the same
565
 
number of audio channels in input. If the input file has audio streams
566
 
with different channel count, the behaviour is undefined.
 
559
Set the number of audio channels. For output streams it is set by
 
560
default to the number of input audio channels. For input streams
 
561
this option only makes sense for audio grabbing devices and raw demuxers
 
562
and is mapped to the corresponding demuxer options.
567
563
@item -an
568
564
Disable audio recording.
569
565
@item -acodec @var{codec}
730
726
Read input at native frame rate. Mainly used to simulate a grab device.
731
727
@item -loop_input
732
728
Loop over the input stream. Currently it works only for image
733
 
streams. This option is used for automatic FFserver testing.
 
729
streams. This option is used for automatic AVserver testing.
 
730
This option is deprecated, use -loop.
734
731
@item -loop_output @var{number_of_times}
735
732
Repeatedly loop output for formats that support looping such as animated GIF
736
733
(0 will loop the output infinitely).
 
734
This option is deprecated, use -loop.
737
735
@item -threads @var{count}
738
736
Thread count.
739
737
@item -vsync @var{parameter}
793
791
one for each line, specifying a sequence of options which would be
794
792
awkward to specify on the command line. Lines starting with the hash
795
793
('#') character are ignored and are used to provide comments. Check
796
 
the @file{ffpresets} directory in the Libav source tree for examples.
 
794
the @file{presets} directory in the Libav source tree for examples.
797
795
 
798
796
Preset files are specified with the @code{vpre}, @code{apre},
799
797
@code{spre}, and @code{fpre} options. The @code{fpre} option takes the
808
806
following rules:
809
807
 
810
808
First ffmpeg searches for a file named @var{arg}.ffpreset in the
811
 
directories @file{$FFMPEG_DATADIR} (if set), and @file{$HOME/.ffmpeg}, and in
812
 
the datadir defined at configuration time (usually @file{PREFIX/share/ffmpeg})
 
809
directories @file{$AVCONV_DATADIR} (if set), and @file{$HOME/.avconv}, and in
 
810
the datadir defined at configuration time (usually @file{PREFIX/share/avconv})
813
811
in that order. For example, if the argument is @code{libx264-max}, it will
814
812
search for the file @file{libx264-max.ffpreset}.
815
813
 
880
878
@end example
881
879
 
882
880
Note that you must activate the right video source and channel before
883
 
launching ffmpeg with any TV viewer such as xawtv
884
 
(@url{http://linux.bytesex.org/xawtv/}) by Gerd Knorr. You also
 
881
launching ffmpeg with any TV viewer such as
 
882
@uref{http://linux.bytesex.org/xawtv/, xawtv} by Gerd Knorr. You also
885
883
have to set the audio recording levels correctly with a
886
884
standard mixer.
887
885
 
900
898
ffmpeg -f x11grab -s cif -r 25 -i :0.0+10,20 /tmp/out.mpg
901
899
@end example
902
900
 
903
 
0.0 is display.screen number of your X11 server, same as the DISPLAY environment
904
 
variable. 10 is the x-offset and 20 the y-offset for the grabbing.
 
901
10 is the x-offset and 20 the y-offset for the grabbing.
 
902
 
 
903
@example
 
904
ffmpeg -f x11grab -follow_mouse centered -s cif -r 25 -i :0.0 /tmp/out.mpg
 
905
@end example
 
906
 
 
907
The grabbing region follows the mouse pointer, which stays at the center of
 
908
region.
 
909
 
 
910
@example
 
911
ffmpeg -f x11grab -follow_mouse 100 -s cif -r 25 -i :0.0 /tmp/out.mpg
 
912
@end example
 
913
 
 
914
Only follows when mouse pointer reaches within 100 pixels to the edge of
 
915
region.
 
916
 
 
917
@example
 
918
ffmpeg -f x11grab -show_region 1 -s cif -r 25 -i :0.0+10,20 /tmp/out.mpg
 
919
@end example
 
920
 
 
921
The grabbing region will be indicated on screen.
 
922
 
 
923
@example
 
924
ffmpeg -f x11grab -follow_mouse centered -show_region 1 -s cif -r 25 -i :0.0 /tmp/out.mpg
 
925
@end example
 
926
 
 
927
The grabbing region indication will follow the mouse pointer.
 
928
 
905
929
 
906
930
@section Video and Audio file format conversion
907
931
 
1055
1079
@settitle ffmpeg video converter
1056
1080
 
1057
1081
@c man begin SEEALSO
1058
 
ffplay(1), ffprobe(1), ffserver(1) and the Libav HTML documentation
 
1082
avplay(1), avprobe(1), avserver(1) and the Libav HTML documentation
1059
1083
@c man end
1060
1084
 
1061
1085
@c man begin AUTHORS