diff options
Diffstat (limited to 'doc')
46 files changed, 10268 insertions, 1168 deletions
diff --git a/doc/APIchanges b/doc/APIchanges index e94c656e9e..b146cb00ad 100644 --- a/doc/APIchanges +++ b/doc/APIchanges @@ -6,29 +6,33 @@ libavcodec: 2011-04-18 libavdevice: 2011-04-18 libavfilter: 2011-04-18 libavformat: 2011-04-18 -libpostproc: 2011-04-18 (deprecated, to be removed later) +libpostproc: 2011-04-18 libswscale: 2011-06-20 libavutil: 2011-04-18 API changes, most recent first: -2011-01-03 - b73ec05 - lavu 51.21.0 - Add av_popcount64 +2011-12-08 - a502939 - lavfi 2.52.0 + Add av_buffersink_poll_frame() to buffersink.h. + +2011-12-08 - xxxxxxx - lavu 51.31.0 + Add av_log_format_line. + +2011-12-03 - xxxxxxx - lavu 51.30.0 + Add AVERROR_BUG. -2011-12-25 - lavfi 2.14.0 - e1d9dbf Add a new installed header - buffersrc.h - It contains a new function av_buffersrc_buffer() that allows passing - frames to the 'buffer' filter, but unlike av_vsrc_buffer_add_frame() - it allows for direct rendering. - 1c9e340 Add avfilter_copy_frame_props() for copying properties from - AVFrame to AVFilterBufferRef. +2011-xx-xx - xxxxxxx - lavu 51.28.1 + Add av_get_alt_sample_fmt() to samplefmt.h. -2011-12-25 - lavc 53.31.0 - Add the following new fields to AVFrame: - b58dbb5 sample_aspect_ratio - 3a2ddf7 width, height - 8a4a5f6 format +2011-11-03 - 96949da - lavu 51.23.0 + Add av_strcasecmp() and av_strncasecmp() to avstring.h. + +2011-10-20 - b35e9e1 - lavu 51.22.0 + Add av_strtok() to avstring.h. + +2011-01-03 - b73ec05 - lavu 51.21.0 + Add av_popcount64 2011-12-18 - 8400b12 - lavc 53.28.1 Deprecate AVFrame.age. The field is unused. @@ -116,37 +120,126 @@ API changes, most recent first: - 641c7af new functions - av_opt_child_next, av_opt_child_class_next and av_opt_find2() -2011-09-03 - fb4ca26 - lavc 53.10.0 - lavf 53.6.0 +2011-09-22 - a70e787 - lavu 51.17.0 + Add av_x_if_null(). + +2011-09-18 - 645cebb - lavc 53.16.0 + Add showall flag2 + +2011-09-16 - ea8de10 - lavfi 2.42.0 + Add avfilter_all_channel_layouts. + +2011-09-16 - 9899037 - lavfi 2.41.0 + Rename avfilter_all_* function names to avfilter_make_all_*. + + In particular, apply the renames: + avfilter_all_formats -> avfilter_make_all_formats + avfilter_all_channel_layouts -> avfilter_make_all_channel_layouts + avfilter_all_packing_formats -> avfilter_make_all_packing_formats + +2011-09-12 - 4381bdd - lavfi 2.40.0 + Change AVFilterBufferRefAudioProps.sample_rate type from uint32_t to int. + +2011-09-12 - 2c03174 - lavfi 2.40.0 + Simplify signature for avfilter_get_audio_buffer(), make it + consistent with avfilter_get_video_buffer(). + +2011-09-06 - 4f7dfe1 - lavfi 2.39.0 + Rename libavfilter/vsink_buffer.h to libavfilter/buffersink.h. + +2011-09-06 - c4415f6 - lavfi 2.38.0 + Unify video and audio sink API. + + In particular, add av_buffersink_get_buffer_ref(), deprecate + av_vsink_buffer_get_video_buffer_ref() and change the value for the + opaque field passed to the abuffersink init function. + +2011-09-04 - 61e2e29 - lavu 51.16.0 + Add av_asprintf(). + +2011-08-22 - dacd827 - lavf 53.10.0 + Add av_find_program_from_stream(). + +2011-08-20 - 69e2c1a - lavu 51.13.0 + Add av_get_media_type_string(). + +2011-09-03 - fb4ca26 - lavc 53.13.0 + lavf 53.11.0 lsws 2.1.0 Add {avcodec,avformat,sws}_get_class(). -2011-09-03 - c11fb82 - lavu 51.10.0 +2011-08-03 - c11fb82 - lavu 51.15.0 Add AV_OPT_SEARCH_FAKE_OBJ flag for av_opt_find() function. +2011-08-14 - 323b930 - lavu 51.12.0 + Add av_fifo_peek2(), deprecate av_fifo_peek(). + 2011-08-26 - lavu 51.9.0 - - f2011ed Add av_fifo_peek2(), deprecate av_fifo_peek(). - add41de..abc78a5 Do not include intfloat_readwrite.h, mathematics.h, rational.h, pixfmt.h, or log.h from avutil.h. -2011-08-16 - 48f9e45 - lavf 53.4.0 +2011-08-16 - 48f9e45 - lavf 53.8.0 Add avformat_query_codec(). -2011-08-16 - bca06e7 - lavc 53.8.0 +2011-08-16 - bca06e7 - lavc 53.11.0 Add avcodec_get_type(). -2011-08-06 - 2f63440 - lavf 53.4.0 +2011-08-06 - 2f63440 - lavf 53.7.0 Add error_recognition to AVFormatContext. -2011-08-02 - 9d39cbf - lavc 53.7.1 +2011-08-02 - 9d39cbf - lavc 53.9.1 Add AV_PKT_FLAG_CORRUPT AVPacket flag. -2011-07-10 - a67c061 - lavf 53.3.0 +2011-07-16 - b57df29 - lavfi 2.27.0 + Add audio packing negotiation fields and helper functions. + + In particular, add AVFilterPacking enum, planar, in_packings and + out_packings fields to AVFilterLink, and the functions: + avfilter_set_common_packing_formats() + avfilter_all_packing_formats() + +2011-07-10 - a67c061 - lavf 53.6.0 Add avformat_find_stream_info(), deprecate av_find_stream_info(). -2011-07-10 - 0b950fe - lavc 53.6.0 +2011-07-10 - 0b950fe - lavc 53.8.0 Add avcodec_open2(), deprecate avcodec_open(). +2011-07-01 - b442ca6 - lavf 53.5.0 - avformat.h + Add function av_get_output_timestamp(). + +2011-06-28 - 5129336 - lavu 51.11.0 - avutil.h + Define the AV_PICTURE_TYPE_NONE value in AVPictureType enum. + +2011-06-19 - fd2c0a5 - lavfi 2.23.0 - avfilter.h + Add layout negotiation fields and helper functions. + + In particular, add in_chlayouts and out_chlayouts to AVFilterLink, + and the functions: + avfilter_set_common_sample_formats() + avfilter_set_common_channel_layouts() + avfilter_all_channel_layouts() + +2011-06-19 - 527ca39 - lavfi 2.22.0 - AVFilterFormats + Change type of AVFilterFormats.formats from int * to int64_t *, + and update formats handling API accordingly. + + avfilter_make_format_list() still takes a int32_t array and converts + it to int64_t. A new function, avfilter_make_format64_list(), that + takes int64_t arrays has been added. + +2011-06-19 - 44f669e - lavfi 2.21.0 - vsink_buffer.h + Add video sink buffer and vsink_buffer.h public header. + +2011-06-12 - 9fdf772 - lavfi 2.18.0 - avcodec.h + Add avfilter_get_video_buffer_ref_from_frame() function in + libavfilter/avcodec.h. + +2011-06-12 - c535494 - lavfi 2.17.0 - avfiltergraph.h + Add avfilter_inout_alloc() and avfilter_inout_free() functions. + +2011-06-12 - 6119b23 - lavfi 2.16.0 - avfilter_graph_parse() + Change avfilter_graph_parse() signature. + 2011-06-23 - 67e9ae1 - lavu 51.8.0 - attributes.h Add av_printf_format(). @@ -163,34 +256,97 @@ API changes, most recent first: 2011-06-10 - cb7c11c - lavu 51.6.0 - opt.h Add av_opt_flag_is_set(). -2011-06-08 - d9f80ea - lavu 51.5.0 - AVMetadata +2011-06-10 - c381960 - lavfi 2.15.0 - avfilter_get_audio_buffer_ref_from_arrays + Add avfilter_get_audio_buffer_ref_from_arrays() to avfilter.h. + +2011-06-09 - d9f80ea - lavu 51.8.0 - AVMetadata Move AVMetadata from lavf to lavu and rename it to AVDictionary -- new installed header dict.h. All av_metadata_* functions renamed to av_dict_*. -2011-06-07 - a6703fa - lavu 51.4.0 - av_get_bytes_per_sample() +2011-06-07 - a6703fa - lavu 51.8.0 - av_get_bytes_per_sample() Add av_get_bytes_per_sample() in libavutil/samplefmt.h. Deprecate av_get_bits_per_sample_fmt(). -2011-06-05 - b39b062 - lavu 51.3.0 - opt.h +2011-06-05 - b39b062 - lavu 51.8.0 - opt.h Add av_opt_free convenience function. -2011-05-28 - 0420bd7 - lavu 51.2.0 - pixdesc.h +2011-06-06 - 95a0242 - lavfi 2.14.0 - AVFilterBufferRefAudioProps + Remove AVFilterBufferRefAudioProps.size, and use nb_samples in + avfilter_get_audio_buffer() and avfilter_default_get_audio_buffer() in + place of size. + +2011-06-06 - 0bc2cca - lavu 51.6.0 - av_samples_alloc() + Switch nb_channels and nb_samples parameters order in + av_samples_alloc(). + +2011-06-06 - e1c7414 - lavu 51.5.0 - av_samples_* + Change the data layout created by av_samples_fill_arrays() and + av_samples_alloc(). + +2011-06-06 - 27bcf55 - lavfi 2.13.0 - vsrc_buffer.h + Make av_vsrc_buffer_add_video_buffer_ref() accepts an additional + flags parameter in input. + +2011-06-03 - e977ca2 - lavfi 2.12.0 - avfilter_link_free() + Add avfilter_link_free() function. + +2011-06-02 - 5ad38d9 - lavu 51.4.0 - av_force_cpu_flags() + Add av_cpu_flags() in libavutil/cpu.h. + +2011-05-28 - e71f260 - lavu 51.3.0 - pixdesc.h Add av_get_pix_fmt_name() in libavutil/pixdesc.h, and deprecate avcodec_get_pix_fmt_name() in libavcodec/avcodec.h in its favor. -2011-05-25 - 30315a8 - lavf 53.1.0 - avformat.h +2011-05-25 - 30315a8 - lavf 53.3.0 - avformat.h Add fps_probe_size to AVFormatContext. -2011-05-18 - 64150ff - lavc 53.4.0 - AVCodecContext.request_sample_fmt +2011-05-22 - 5ecdfd0 - lavf 53.2.0 - avformat.h + Introduce avformat_alloc_output_context2() and deprecate + avformat_alloc_output_context(). + +2011-05-22 - 83db719 - lavfi 2.10.0 - vsrc_buffer.h + Make libavfilter/vsrc_buffer.h public. + +2011-05-19 - c000a9f - lavfi 2.8.0 - avcodec.h + Add av_vsrc_buffer_add_frame() to libavfilter/avcodec.h. + +2011-05-14 - 9fdf772 - lavfi 2.6.0 - avcodec.h + Add avfilter_get_video_buffer_ref_from_frame() to libavfilter/avcodec.h. + +2011-05-18 - 64150ff - lavc 53.7.0 - AVCodecContext.request_sample_fmt Add request_sample_fmt field to AVCodecContext. -2011-05-10 - 188dea1 - lavc 53.3.0 - avcodec.h +2011-05-10 - 188dea1 - lavc 53.6.0 - avcodec.h Deprecate AVLPCType and the following fields in AVCodecContext: lpc_coeff_precision, prediction_order_method, min_partition_order, max_partition_order, lpc_type, lpc_passes. Corresponding FLAC encoder options should be used instead. +2011-05-07 - 9fdf772 - lavfi 2.5.0 - avcodec.h + Add libavfilter/avcodec.h header and avfilter_copy_frame_props() + function. + +2011-05-07 - 18ded93 - lavc 53.5.0 - AVFrame + Add format field to AVFrame. + +2011-05-07 - 22333a6 - lavc 53.4.0 - AVFrame + Add width and height fields to AVFrame. + +2011-05-01 - 35fe66a - lavfi 2.4.0 - avfilter.h + Rename AVFilterBufferRefVideoProps.pixel_aspect to + sample_aspect_ratio. + +2011-05-01 - 77e9dee - lavc 53.3.0 - AVFrame + Add a sample_aspect_ratio field to AVFrame. + +2011-05-01 - 1ba5727 - lavc 53.2.0 - AVFrame + Add a pkt_pos field to AVFrame. + +2011-04-29 - 35ceaa7 - lavu 51.2.0 - mem.h + Add av_dynarray_add function for adding + an element to a dynamic array. + 2011-04-26 - bebe72f - lavu 51.1.0 - avutil.h Add AVPictureType enum and av_get_picture_type_char(), deprecate FF_*_TYPE defines and av_get_pict_type_char() defined in @@ -242,9 +398,6 @@ API changes, most recent first: 333e894 deprecate url_open_protocol e230705 deprecate url_poll and URLPollEntry -2011-04-10 - lavu 50.40.0 - pixfmt.h - Add PIX_FMT_BGR48LE and PIX_FMT_BGR48BE pixel formats - 2011-04-08 - lavf 52.106.0 - avformat.h Minor avformat.h cleanup: a9bf9d8 deprecate av_guess_image2_codec @@ -269,7 +422,6 @@ API changes, most recent first: d9d86e0 rename url_fprintf -> avio_printf 59f65d9 deprecate url_setbufsize 3e68b3b deprecate url_ferror - 66e5b1d deprecate url_feof e8bb2e2 deprecate url_fget_max_packet_size 76aa876 rename url_fsize -> avio_size e519753 deprecate url_fgetc @@ -293,6 +445,9 @@ API changes, most recent first: 2011-03-25 - 34b47d7 - lavc 52.115.0 - AVCodecContext.audio_service_type Add audio_service_type field to AVCodecContext. +2011-03-17 - e309fdc - lavu 50.40.0 - pixfmt.h + Add PIX_FMT_BGR48LE and PIX_FMT_BGR48BE pixel formats + 2011-03-02 - 863c471 - lavf 52.103.0 - av_pkt_dump2, av_pkt_dump_log2 Add new functions av_pkt_dump2, av_pkt_dump_log2 that uses the source stream timebase for outputting timestamps. Deprecate @@ -359,6 +514,12 @@ API changes, most recent first: 2011-02-02 - dfd2a00 - lavu 50.37.0 - log.h Make av_dlog public. +2011-01-31 - 7b3ea55 - lavfi 1.76.0 - vsrc_buffer + Add sample_aspect_ratio fields to vsrc_buffer arguments + +2011-01-31 - 910b5b8 - lavfi 1.75.0 - AVFilterLink sample_aspect_ratio + Add sample_aspect_ratio field to AVFilterLink. + 2011-01-15 - r26374 - lavfi 1.74.0 - AVFilterBufferRefAudioProps Rename AVFilterBufferRefAudioProps.samples_nb to nb_samples. diff --git a/doc/Makefile b/doc/Makefile index 0acd9844af..2dbf30a0db 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -9,13 +9,24 @@ HTMLPAGES = $(PROGS-yes:%=doc/%.html) \ doc/libavfilter.html \ doc/platform.html \ +TXTPAGES = doc/fate.txt \ + + DOCS = $(HTMLPAGES) $(MANPAGES) $(PODPAGES) +ifdef HAVE_MAKEINFO +DOCS += $(TXTPAGES) +endif all-$(CONFIG_DOC): documentation documentation: $(DOCS) -TEXIDEP = awk '/^@include/ { printf "$@: $(@D)/%s\n", $$2 }' <$< >$(@:%=%.d) +TEXIDEP = awk '/^@(verbatim)?include/ { printf "$@: $(@D)/%s\n", $$2 }' <$< >$(@:%=%.d) + +doc/%.txt: TAG = TXT +doc/%.txt: doc/%.texi + $(Q)$(TEXIDEP) + $(M)makeinfo --force --no-headers -o $@ $< 2>/dev/null doc/%.html: TAG = HTML doc/%.html: doc/%.texi $(SRC_PATH)/doc/t2h.init @@ -46,7 +57,7 @@ uninstall-man: $(RM) $(addprefix "$(MANDIR)/man1/",$(ALLMANPAGES)) clean:: - $(RM) doc/*.html doc/*.pod doc/*.1 $(CLEANSUFFIXES:%=doc/%) + $(RM) $(TXTPAGES) doc/*.html doc/*.pod doc/*.1 $(CLEANSUFFIXES:%=doc/%) -include $(wildcard $(DOCS:%=%.d)) diff --git a/doc/RELEASE_NOTES b/doc/RELEASE_NOTES index b5ced86e85..24edc2e3b2 100644 --- a/doc/RELEASE_NOTES +++ b/doc/RELEASE_NOTES @@ -1,26 +1,15 @@ Release Notes ============= -* 0.8 "Forbidden Fruit" +* 0.9 "Harmony" December, 2011 + General notes ------------- -This release continues the API cleanups that have begun with the -previous release. While it is binary compatible with 0.7, many parts of -the public API were deprecated and will be removed in the git master and -later releases. Note that a couple of header includes have been cleaned -up, which may require code changes in your applications. In particular, -the header "libavutil/mathematics.h" is no longer included from -"libavcodec/avcodec.h". Please consult the doc/APIchanges file to see -intended replacements for the deprecated APIs. - -Furthermore, our work on the 'ffmpeg' command-line tool has resulted in -major revisions to its interface. In order to not break existing scripts -and applications, we have chosen to introduce a new tool called -'avconv', and keep the traditional 'ffmpeg' frontend for end-user's -convenience. Please see the Changelog file for details how 'avconv' -differs from 'ffmpeg'. +This release is binary compatible with 0.8. The 'ffmpeg' command-line tool has +been extended to also support the command line syntax and features of a tool +called avconv. Additionally, this release introduces a number of new interesting codecs such as the Apple Prores, Flash Screen Video 2 and Windows Media Image, @@ -28,13 +17,14 @@ and muxers such as LATM or CELT in Ogg, among many others. Moreover, our H.264 decoder has been improved to decode 4:2:2 material and our libx264 wrapper now allows to produce 4:2:2 and 4:4:4 video. -See the Changelog file for a list of significant changes. +See the Changelog file for a list of significant changes. Note, there +are many more new features and bugfixes than whats listed there. -Please note that our policy on bug reports has not changed. We still only accept -bug reports against HEAD of the Libav trunk repository. If you are experiencing -issues with any formally released version of Libav, please try a current version -of the development code to check if the issue still exists. If it does, make your -report against the development code following the usual bug reporting guidelines. +Bugreports against FFmpeg git master or the most recent FFmpeg release are +accepted. If you are experiencing issues with any formally released version of +FFmpeg, please try git master to check if the issue still exists. If it does, +make your report against the development code following the usual bug reporting +guidelines. API changes @@ -50,4 +40,5 @@ similar programmer-centric information. Other notable changes --------------------- + Please see the Changelog file for a more detailed list of changes. diff --git a/doc/avconv.texi b/doc/avconv.texi index 0a83326379..85c1457621 100644 --- a/doc/avconv.texi +++ b/doc/avconv.texi @@ -113,6 +113,9 @@ input file name @item -y (@emph{global}) Overwrite output files without asking. +@item -n (@emph{global}) +Do not overwrite output files but exit if file exists. + @item -c[:@var{stream_specifier}] @var{codec} (@emph{input/output,per-stream}) @itemx -codec[:@var{stream_specifier}] @var{codec} (@emph{input/output,per-stream}) Select an encoder (when used before an output file) or a decoder (when used @@ -1047,7 +1050,8 @@ the input file in reverse order. @settitle avconv video converter @c man begin SEEALSO -avplay(1), avprobe(1) and the Libav HTML documentation +ffplay(1), ffprobe(1), ffserver(1) and the FFmpeg HTML documentation + @c man end @c man begin AUTHORS diff --git a/doc/avprobe.texi b/doc/avprobe.texi deleted file mode 100644 index 6b2c800bf1..0000000000 --- a/doc/avprobe.texi +++ /dev/null @@ -1,134 +0,0 @@ -\input texinfo @c -*- texinfo -*- - -@settitle avprobe Documentation -@titlepage -@center @titlefont{avprobe Documentation} -@end titlepage - -@top - -@contents - -@chapter Synopsis - -The generic syntax is: - -@example -@c man begin SYNOPSIS -avprobe [options] [@file{input_file}] -@c man end -@end example - -@chapter Description -@c man begin DESCRIPTION - -avprobe gathers information from multimedia streams and prints it in -human- and machine-readable fashion. - -For example it can be used to check the format of the container used -by a multimedia stream and the format and type of each media stream -contained in it. - -If a filename is specified in input, avprobe will try to open and -probe the file content. If the file cannot be opened or recognized as -a multimedia file, a positive exit code is returned. - -avprobe may be employed both as a standalone application or in -combination with a textual filter, which may perform more -sophisticated processing, e.g. statistical processing or plotting. - -Options are used to list some of the formats supported by avprobe or -for specifying which information to display, and for setting how -avprobe will show it. - -avprobe output is designed to be easily parsable by a textual filter, -and consists of one or more sections of the form: -@example -[SECTION] -key1=val1 -... -keyN=valN -[/SECTION] -@end example - -Metadata tags stored in the container or in the streams are recognized -and printed in the corresponding "FORMAT" or "STREAM" section, and -are prefixed by the string "TAG:". - -@c man end - -@chapter Options -@c man begin OPTIONS - -@include avtools-common-opts.texi - -@section Main options - -@table @option - -@item -f @var{format} -Force format to use. - -@item -unit -Show the unit of the displayed values. - -@item -prefix -Use SI prefixes for the displayed values. -Unless the "-byte_binary_prefix" option is used all the prefixes -are decimal. - -@item -byte_binary_prefix -Force the use of binary prefixes for byte values. - -@item -sexagesimal -Use sexagesimal format HH:MM:SS.MICROSECONDS for time values. - -@item -pretty -Prettify the format of the displayed values, it corresponds to the -options "-unit -prefix -byte_binary_prefix -sexagesimal". - -@item -show_format -Show information about the container format of the input multimedia -stream. - -All the container format information is printed within a section with -name "FORMAT". - -@item -show_packets -Show information about each packet contained in the input multimedia -stream. - -The information for each single packet is printed within a dedicated -section with name "PACKET". - -@item -show_streams -Show information about each media stream contained in the input -multimedia stream. - -Each media stream information is printed within a dedicated section -with name "STREAM". - -@end table -@c man end - -@include demuxers.texi -@include muxers.texi -@include protocols.texi -@include indevs.texi - -@ignore - -@setfilename avprobe -@settitle avprobe media prober - -@c man begin SEEALSO -avconv(1), avplay(1) and the Libav HTML documentation -@c man end - -@c man begin AUTHORS -The Libav developers -@c man end - -@end ignore - -@bye diff --git a/doc/avtools-common-opts.texi b/doc/avtools-common-opts.texi index badd35818c..94d47fd64f 100644 --- a/doc/avtools-common-opts.texi +++ b/doc/avtools-common-opts.texi @@ -122,7 +122,17 @@ can be disabled setting the environment variable @env{AV_LOG_FORCE_NOCOLOR} or @env{NO_COLOR}, or can be forced setting the environment variable @env{AV_LOG_FORCE_COLOR}. The use of the environment variable @env{NO_COLOR} is deprecated and -will be dropped in a following Libav version. +will be dropped in a following FFmpeg version. + +@item -report +Dump full command line and console output to a file named +@code{@var{program}-@var{YYYYMMDD}-@var{HHMMSS}.log} in the current +directory. +This file can be useful for bug reports. +It also implies @code{-loglevel verbose}. + +Note: setting the environment variable @code{FFREPORT} to any value has the +same effect. @end table @@ -145,7 +155,7 @@ For example to write an ID3v2.3 header instead of a default ID3v2.4 to an MP3 file, use the @option{id3v2_version} private option of the MP3 muxer: @example -avconv -i input.flac -id3v2_version 3 out.mp3 +ffmpeg -i input.flac -id3v2_version 3 out.mp3 @end example All codec AVOptions are obviously per-stream, so the chapter on stream diff --git a/doc/bitstream_filters.texi b/doc/bitstream_filters.texi index 1fbd40a70c..ae56b355a7 100644 --- a/doc/bitstream_filters.texi +++ b/doc/bitstream_filters.texi @@ -1,7 +1,7 @@ @chapter Bitstream Filters @c man begin BITSTREAM FILTERS -When you configure your Libav build, all the supported bitstream +When you configure your FFmpeg build, all the supported bitstream filters are enabled by default. You can list all available ones using the configure option @code{--list-bsfs}. @@ -34,7 +34,7 @@ JPEG image. The individual frames can be extracted without loss, e.g. by @example -avconv -i ../some_mjpeg.avi -c:v copy frames_%d.jpg +ffmpeg -i ../some_mjpeg.avi -c:v copy frames_%d.jpg @end example Unfortunately, these chunks are incomplete JPEG images, because @@ -57,9 +57,9 @@ stream (carrying the AVI1 header ID and lacking a DHT segment) to produce fully qualified JPEG images. @example -avconv -i mjpeg-movie.avi -c:v copy -vbsf mjpeg2jpeg frame_%d.jpg +ffmpeg -i mjpeg-movie.avi -c:v copy -vbsf mjpeg2jpeg frame_%d.jpg exiftran -i -9 frame*.jpg -avconv -i frame_%d.jpg -c:v copy rotated.avi +ffmpeg -i frame_%d.jpg -c:v copy rotated.avi @end example @section mjpega_dump_header diff --git a/doc/build_system.txt b/doc/build_system.txt index 1011f57f66..36c141e9e4 100644 --- a/doc/build_system.txt +++ b/doc/build_system.txt @@ -1,4 +1,4 @@ -Libav currently uses a custom build system, this text attempts to document +FFmpeg currently uses a custom build system, this text attempts to document some of its obscure features and options. Makefile variables: @@ -9,13 +9,19 @@ V DESTDIR Destination directory for the install targets, useful to prepare packages - or install Libav in cross-environments. + or install FFmpeg in cross-environments. Makefile targets: all Default target, builds all the libraries and the executables. +fate + Run the fate test suite, note you must have installed it + +fate-list + Will list all fate/regression test targets + install Install headers, libraries and programs. @@ -28,3 +34,17 @@ libavcodec/api-example libswscale/swscale-test Build the swscale self-test (useful also as example). + +Useful standard make commands: +make -t <target> + Touch all files that otherwise would be build, this is useful to reduce + unneeded rebuilding when changing headers, but note you must force rebuilds + of files that actually need it by hand then. + +make -j<num> + rebuild with multiple jobs at the same time. Faster on multi processor systems + +make -k + continue build in case of errors, this is useful for the regression tests + sometimes but note it will still not run all reg tests. + diff --git a/doc/decoders.texi b/doc/decoders.texi new file mode 100644 index 0000000000..87ad4eea26 --- /dev/null +++ b/doc/decoders.texi @@ -0,0 +1,63 @@ +@chapter Decoders +@c man begin DECODERS + +Decoders are configured elements in FFmpeg which allow the decoding of +multimedia streams. + +When you configure your FFmpeg build, all the supported native decoders +are enabled by default. Decoders requiring an external library must be enabled +manually via the corresponding @code{--enable-lib} option. You can list all +available decoders using the configure option @code{--list-decoders}. + +You can disable all the decoders with the configure option +@code{--disable-decoders} and selectively enable / disable single decoders +with the options @code{--enable-decoder=@var{DECODER}} / +@code{--disable-decoder=@var{DECODER}}. + +The option @code{-codecs} of the ff* tools will display the list of +enabled decoders. + +@c man end DECODERS + +@chapter Video Decoders +@c man begin VIDEO DECODERS + +A description of some of the currently available video decoders +follows. + +@section rawvideo + +Raw video decoder. + +This decoder decodes rawvideo streams. + +@subsection Options + +@table @option +@item top @var{top_field_first} +Specify the assumed field type of the input video. +@table @option +@item -1 +the video is assumed to be progressive (default) +@item 0 +bottom-field-first is assumed +@item 1 +top-field-first is assumed +@end table + +@end table + +@c man end VIDEO DECODERS + +@chapter Audio Decoders +@c man begin AUDIO DECODERS + +@section ffwavesynth + +Internal wave synthetizer. + +This decoder generates wave patterns according to predefined sequences. Its +use is purely internal and the format of the data it accepts is not publicly +documented. + +@c man end AUDIO DECODERS diff --git a/doc/demuxers.texi b/doc/demuxers.texi index c3049ddfc4..a7af1c8d08 100644 --- a/doc/demuxers.texi +++ b/doc/demuxers.texi @@ -1,10 +1,10 @@ @chapter Demuxers @c man begin DEMUXERS -Demuxers are configured elements in Libav which allow to read the +Demuxers are configured elements in FFmpeg which allow to read the multimedia streams from a particular type of file. -When you configure your Libav build, all the supported demuxers +When you configure your FFmpeg build, all the supported demuxers are enabled by default. You can list all available ones using the configure option "--list-demuxers". @@ -49,19 +49,19 @@ sequence of filenames of the form @file{i%m%g-1.jpg}, The size, the pixel format, and the format of each image must be the same for all the files in the sequence. -The following example shows how to use @command{avconv} for creating a +The following example shows how to use @command{ffmpeg} for creating a video from the images in the file sequence @file{img-001.jpeg}, -@file{img-002.jpeg}, ..., assuming an input framerate of 10 frames per +@file{img-002.jpeg}, ..., assuming an input frame rate of 10 frames per second: @example -avconv -i 'img-%03d.jpeg' -r 10 out.mkv +ffmpeg -i 'img-%03d.jpeg' -r 10 out.mkv @end example Note that the pattern must not necessarily contain "%d" or "%0@var{N}d", for example to convert a single image file @file{img.jpeg} you can employ the command: @example -avconv -i img.jpeg img.png +ffmpeg -i img.jpeg img.png @end example @section applehttp @@ -70,9 +70,39 @@ Apple HTTP Live Streaming demuxer. This demuxer presents all AVStreams from all variant streams. The id field is set to the bitrate variant index number. By setting -the discard flags on AVStreams (by pressing 'a' or 'v' in avplay), +the discard flags on AVStreams (by pressing 'a' or 'v' in ffplay), the caller can decide which variant streams to actually receive. The total bitrate of the variant that the stream belongs to is available in a metadata key named "variant_bitrate". +@section sbg + +SBaGen script demuxer. + +This demuxer reads the script language used by SBaGen +@url{http://uazu.net/sbagen/} to generate binaural beats sessions. A SBG +script looks like that: +@example +-SE +a: 300-2.5/3 440+4.5/0 +b: 300-2.5/0 440+4.5/3 +off: - +NOW == a ++0:07:00 == b ++0:14:00 == a ++0:21:00 == b ++0:30:00 off +@end example + +A SBG script can mix absolute and relative timestamps. If the script uses +either only absolute timestamps (including the script start time) or only +relative ones, then its layout is fixed, and the conversion is +straightforward. On the other hand, if the script mixes both kind of +timestamps, then the @var{NOW} reference for relative timestamps will be +taken from the current time of day at the time the script is read, and the +script layout will be frozen according to that reference. That means that if +the script is directly played, the actual times will match the absolute +timestamps up to the sound controller's clock accuracy, but if the user +somehow pauses the playback or seeks, all times will be shifted accordingly. + @c man end INPUT DEVICES diff --git a/doc/developer.texi b/doc/developer.texi index 046743fd62..32d666ac68 100644 --- a/doc/developer.texi +++ b/doc/developer.texi @@ -17,71 +17,43 @@ decoding). Look at @file{libavcodec/apiexample.c} to see how to use it. @item libavformat is the library containing the file format handling (mux and -demux code for several formats). Look at @file{avplay.c} to use it in a +demux code for several formats). Look at @file{ffplay.c} to use it in a player. See @file{libavformat/output-example.c} to use it to generate audio or video streams. @end itemize -@section Integrating libav in your program - -Shared libraries should be used whenever is possible in order to reduce -the effort distributors have to pour to support programs and to ensure -only the public api is used. - -You can use Libav in your commercial program, but you must abide to the -license, LGPL or GPL depending on the specific features used, please refer -to @uref{http://libav.org/legal.html, our legal page} for a quick checklist and to -the following links for the exact text of each license: -@uref{http://git.libav.org/?p=libav.git;a=blob;f=COPYING.GPLv2, GPL version 2}, -@uref{http://git.libav.org/?p=libav.git;a=blob;f=COPYING.GPLv3, GPL version 3}, -@uref{http://git.libav.org/?p=libav.git;a=blob;f=COPYING.LGPLv2.1, LGPL version 2.1}, -@uref{http://git.libav.org/?p=libav.git;a=blob;f=COPYING.LGPLv3, LGPL version 3}. -Any modification to the source code can be suggested for inclusion. -The best way to proceed is to send your patches to the -@uref{https://lists.libav.org/mailman/listinfo/libav-devel, libav-devel} -mailing list. +@section Integrating libavcodec or libavformat in your program + +You can integrate all the source code of the libraries to link them +statically to avoid any version problem. All you need is to provide a +'config.mak' and a 'config.h' in the parent directory. See the defines +generated by ./configure to understand what is needed. + +You can use libavcodec or libavformat in your commercial program, but +@emph{any patch you make must be published}. The best way to proceed is +to send your patches to the FFmpeg mailing list. + +@section Contributing + +There are 3 ways by which code gets into ffmpeg. +@itemize @bullet +@item Submitting Patches to the main developer mailing list + see @ref{Submitting patches} for details. +@item Directly committing changes to the main tree. +@item Committing changes to a git clone, for example on github.com or + gitorious.org. And asking us to merge these changes. +@end itemize + +Whichever way, changes should be reviewed by the maintainer of the code +before they are committed. And they should follow the @ref{Coding Rules}. +The developer making the commit and the author are responsible for their changes +and should try to fix issues their commit causes. @anchor{Coding Rules} @section Coding Rules @subsection Code formatting conventions -The code is written in K&R C style. That means the following: -@itemize @bullet -@item -The control statements are formatted by putting space between the statement -and parenthesis in the following way: -@example -for (i = 0; i < filter->input_count; i++) @{ -@end example -@item -The case statement is always located at the same level as the switch itself: -@example -switch (link->init_state) @{ -case AVLINK_INIT: - continue; -case AVLINK_STARTINIT: - av_log(filter, AV_LOG_INFO, "circular filter chain detected"); - return 0; -@end example -@item -Braces in function declarations are written on the new line: -@example -const char *avfilter_configuration(void) -@{ - return LIBAV_CONFIGURATION; -@} -@end example -@item -In case of a single-statement if, no curly braces are required: -@example -if (!pic || !picref) - goto fail; -@end example -@item -Do not put spaces immediately inside parentheses. @samp{if (ret)} is -a valid style; @samp{if ( ret )} is not. -@end itemize There are the following guidelines regarding the indentation in files: @itemize @bullet @@ -97,7 +69,7 @@ and only if this improves readability. @end itemize The presentation is one inspired by 'indent -i4 -kr -nut'. -The main priority in Libav is simplicity and small code size in order to +The main priority in FFmpeg is simplicity and small code size in order to minimize the bug count. @subsection Comments @@ -142,7 +114,7 @@ int myfunc(int my_parameter) @subsection C language features -Libav is programmed in the ISO C90 language with a few additional +FFmpeg is programmed in the ISO C90 language with a few additional features from ISO C99, namely: @itemize @bullet @item @@ -174,10 +146,10 @@ GCC statement expressions (@samp{(x = (@{ int y = 4; y; @})}). @end itemize @subsection Naming conventions -All names are using underscores (_), not CamelCase. For example, -@samp{avfilter_get_video_buffer} is a valid function name and -@samp{AVFilterGetVideo} is not. The only exception from this are structure -names; they should always be in the CamelCase +All names are using underscores (_), not CamelCase. For example, @samp{avfilter_get_video_buffer} is +a valid function name and @samp{AVFilterGetVideo} is not. The exception from this are type names, like +for example structs and enums; they should always be in the CamelCase + There are following conventions for naming variables and functions: @itemize @bullet @@ -208,10 +180,10 @@ should also be avoided if they don't make the code easier to understand. @end itemize @subsection Editor configuration -In order to configure Vim to follow Libav formatting conventions, paste +In order to configure Vim to follow FFmpeg formatting conventions, paste the following snippet into your @file{.vimrc}: @example -" indentation rules for libav: 4 spaces, no tabs +" indentation rules for FFmpeg: 4 spaces, no tabs set expandtab set shiftwidth=4 set softtabstop=4 @@ -241,33 +213,17 @@ For Emacs, add these roughly equivalent lines to your @file{.emacs.d/init.el}: an "or any later version" clause is also acceptable, but LGPL is preferred. @item - All the patches MUST be reviewed in the mailing list before they are - committed. -@item - The Libav coding style should remain consistent. Changes to - conform will be suggested during the review or implemented on commit. -@item - Patches should be generated using @code{git format-patch} or directly sent - using @code{git send-email}. - Please make sure you give the proper credit by setting the correct author - in the commit. -@item - The commit message should have a short first line in the form of - @samp{topic: short description} as header, separated by a newline - from the body consting in few lines explaining the reason of the patch. - Referring to the issue on the bug tracker does not exempt to report an - excerpt of the bug. -@item - Work in progress patches should be sent to the mailing list with the [WIP] - or the [RFC] tag. + You must not commit code which breaks FFmpeg! (Meaning unfinished but + enabled code which breaks compilation or compiles but does not work or + breaks the regression tests) + You can commit unfinished stuff (for testing etc), but it must be disabled + (#ifdef etc) by default so it does not interfere with other developers' + work. @item - Branches in public personal repos are advised as way to - work on issues collaboratively. -@item - You do not have to over-test things. If it works for you and you think it - should work for others, send it to the mailing list for review. - If you have doubt about portability please state it in the submission so - people with specific hardware could test it. + You do not have to over-test things. If it works for you, and you think it + should work for others, then commit. If your code has problems + (portability, triggers compiler bugs, unusual environment etc) they will be + reported and eventually fixed. @item Do not commit unrelated changes together, split them into self-contained pieces. Also do not forget that if part B depends on part A, but A does not @@ -275,37 +231,75 @@ For Emacs, add these roughly equivalent lines to your @file{.emacs.d/init.el}: Keeping changes well split into self-contained parts makes reviewing and understanding them on the commit log mailing list easier. This also helps in case of debugging later on. -@item - Patches that change behavior of the programs (renaming options etc) or - public API or ABI should be discussed in depth and possible few days should - pass between discussion and commit. - Changes to the build system (Makefiles, configure script) which alter - the expected behavior should be considered in the same regard. + Also if you have doubts about splitting or not splitting, do not hesitate to + ask/discuss it on the developer mailing list. +@item + Do not change behavior of the programs (renaming options etc) or public + API or ABI without first discussing it on the ffmpeg-devel mailing list. + Do not remove functionality from the code. Just improve! + + Note: Redundant code can be removed. +@item + Do not commit changes to the build system (Makefiles, configure script) + which change behavior, defaults etc, without asking first. The same + applies to compiler warning fixes, trivial looking fixes and to code + maintained by other developers. We usually have a reason for doing things + the way we do. Send your changes as patches to the ffmpeg-devel mailing + list, and if the code maintainers say OK, you may commit. This does not + apply to files you wrote and/or maintain. +@item + We refuse source indentation and other cosmetic changes if they are mixed + with functional changes, such commits will be rejected and removed. Every + developer has his own indentation style, you should not change it. Of course + if you (re)write something, you can use your own style, even though we would + prefer if the indentation throughout FFmpeg was consistent (Many projects + force a given indentation style - we do not.). If you really need to make + indentation changes (try to avoid this), separate them strictly from real + changes. + + NOTE: If you had to put if()@{ .. @} over a large (> 5 lines) chunk of code, + then either do NOT change the indentation of the inner part within (do not + move it to the right)! or do so in a separate commit +@item + Always fill out the commit log message. Describe in a few lines what you + changed and why. You can refer to mailing list postings if you fix a + particular bug. Comments such as "fixed!" or "Changed it." are unacceptable. + Recommended format: + area changed: Short 1 line description + + details describing what and why and giving references. +@item + Make sure the author of the commit is set correctly. (see git commit --author) + If you apply a patch, send an + answer to ffmpeg-devel (or wherever you got the patch from) saying that + you applied the patch. @item When applying patches that have been discussed (at length) on the mailing list, reference the thread in the log message. @item - Subscribe to the - @uref{https://lists.libav.org/mailman/listinfo/libav-devel, libav-devel} and - @uref{https://lists.libav.org/mailman/listinfo/libav-commits, libav-commits} - mailing lists. - Bugs and possible improvements or general questions regarding commits - are discussed on libav-devel. We expect you to react if problems with - your code are uncovered. + Do NOT commit to code actively maintained by others without permission. + Send a patch to ffmpeg-devel instead. If no one answers within a reasonable + timeframe (12h for build failures and security fixes, 3 days small changes, + 1 week for big patches) then commit your patch if you think it is OK. + Also note, the maintainer can simply ask for more time to review! +@item + Subscribe to the ffmpeg-cvslog mailing list. The diffs of all commits + are sent there and reviewed by all the other developers. Bugs and possible + improvements or general questions regarding commits are discussed there. We + expect you to react if problems with your code are uncovered. @item Update the documentation if you change behavior or add features. If you are - unsure how best to do this, send an [RFC] patch to libav-devel. + unsure how best to do this, send a patch to ffmpeg-devel, the documentation + maintainer(s) will review and commit your stuff. @item - All discussions and decisions should be reported on the public developer - mailing list, so that there is a reference to them. - Other media (e.g. IRC) should be used for coordination and immediate - collaboration. + Try to keep important discussions and requests (also) on the public + developer mailing list, so that all developers can benefit from them. @item Never write to unallocated memory, never write over the end of arrays, always check values read from some untrusted source before using them - as array index or other risky things. Always use valgrind to doublecheck. + as array index or other risky things. @item - Remember to check if you need to bump versions for the specific libav + Remember to check if you need to bump versions for the specific libav* parts (libavutil, libavcodec, libavformat) you are changing. You need to change the version integer. Incrementing the first component means no backward compatibility to @@ -316,12 +310,13 @@ For Emacs, add these roughly equivalent lines to your @file{.emacs.d/init.el}: Incrementing the third component means a noteworthy binary compatible change (e.g. encoder bug fix that matters for the decoder). @item - Compiler warnings indicate potential bugs or code with bad style. + Compiler warnings indicate potential bugs or code with bad style. If a type of + warning always points to correct and clean code, that warning should + be disabled, not the code changed. + Thus the remaining warnings can either be bugs or correct code. If it is a bug, the bug has to be fixed. If it is not, the code should be changed to not generate a warning unless that causes a slowdown or obfuscates the code. - If a type of warning leads to too many false positives, that warning - should be disabled, not the code changed. @item If you add a new file, give it a proper license header. Do not copy and paste it from a random place, use an existing file as template. @@ -329,49 +324,47 @@ For Emacs, add these roughly equivalent lines to your @file{.emacs.d/init.el}: We think our rules are not too hard. If you have comments, contact us. -Note, some rules were borrowed from the MPlayer project. +Note, these rules are mostly borrowed from the MPlayer project. +@anchor{Submitting patches} @section Submitting patches First, read the @ref{Coding Rules} above if you did not yet, in particular the rules regarding patch submission. -As stated already, please do not submit a patch which contains several -unrelated changes. +When you submit your patch, please use @code{git format-patch} or +@code{git send-email}. We cannot read other diffs :-) + +Also please do not submit a patch which contains several unrelated changes. Split it into separate, self-contained pieces. This does not mean splitting file by file. Instead, make the patch as small as possible while still keeping it as a logical unit that contains an individual change, even if it spans multiple files. This makes reviewing your patches much easier for us and greatly increases your chances of getting your patch applied. -Use the patcheck tool of Libav to check your patch. +Use the patcheck tool of FFmpeg to check your patch. The tool is located in the tools directory. -Run the @ref{Regression Tests} before submitting a patch in order to verify +Run the @ref{Regression tests} before submitting a patch in order to verify it does not cause unexpected problems. Patches should be posted as base64 encoded attachments (or any other encoding which ensures that the patch will not be trashed during -transmission) to the -@uref{https://lists.libav.org/mailman/listinfo/libav-devel, libav-devel} -mailing list. +transmission) to the ffmpeg-devel mailing list, see +@url{http://lists.ffmpeg.org/mailman/listinfo/ffmpeg-devel} It also helps quite a bit if you tell us what the patch does (for example 'replaces lrint by lrintf'), and why (for example '*BSD isn't C99 compliant -and has no lrint()'). This kind of explanation should be the body of the -commit message. +and has no lrint()') Also please if you send several patches, send each patch as a separate mail, do not attach several unrelated patches to the same mail. -Use @code{git send-email} when possible since it will properly send patches -without requiring extra care. - Your patch will be reviewed on the mailing list. You will likely be asked to make some changes and are expected to send in an improved version that incorporates the requests from the review. This process may go through -several iterations. Once your patch is deemed good enough, it will be -committed to the official Libav tree. +several iterations. Once your patch is deemed good enough, some developer +will pick it up and commit it to the official FFmpeg tree. Give us a few days to react. But if some time passes without reaction, send a reminder by email. Your patch should eventually be dealt with. @@ -393,12 +386,12 @@ send a reminder by email. Your patch should eventually be dealt with. @item Did you add the CodecID to @file{avcodec.h}? @item - If it has a fourcc, did you add it to @file{libavformat/riff.c}, + If it has a fourCC, did you add it to @file{libavformat/riff.c}, even if it is only a decoder? @item Did you add a rule to compile the appropriate files in the Makefile? - Remember to do this even if you are just adding a format to a file that - is already being compiled by some other rule, like a raw demuxer. + Remember to do this even if you're just adding a format to a file that is + already being compiled by some other rule, like a raw demuxer. @item Did you add an entry to the table of supported formats or codecs in @file{doc/general.texi}? @@ -422,13 +415,18 @@ send a reminder by email. Your patch should eventually be dealt with. @item Does @code{make fate} pass with the patch applied? @item - Does @code{make checkheaders} pass with the patch applied? + Was the patch generated with git format-patch or send-email? @item - Is the patch against latest Libav git master branch? + Did you sign off your patch? (git commit -s) + See @url{http://kerneltrap.org/files/Jeremy/DCO.txt} for the meaning + of sign off. @item - Are you subscribed to the - @uref{https://lists.libav.org/mailman/listinfo/libav-devel, libav-devel} - mailing list? (Only list subscribers are allowed to post.) + Did you provide a clear git commit log message? +@item + Is the patch against latest FFmpeg git master branch? +@item + Are you subscribed to ffmpeg-devel? + (the list is subscribers only due to spam) @item Have you checked that the changes are minimal, so that the same cannot be achieved with a smaller patch and/or simpler final code? @@ -458,7 +456,7 @@ send a reminder by email. Your patch should eventually be dealt with. If the patch fixes a bug, did you provide enough information, including a sample, so the bug can be reproduced and the fix can be verified? Note please do not attach samples >100k to mails but rather provide a - URL, you can upload to ftp://upload.libav.org + URL, you can upload to ftp://upload.ffmpeg.org @item Did you provide a verbose summary about what the patch does change? @item @@ -471,20 +469,22 @@ send a reminder by email. Your patch should eventually be dealt with. patch easily? @item If you added a new file, did you insert a license header? It should be - taken from Libav, not randomly copied and pasted from somewhere else. + taken from FFmpeg, not randomly copied and pasted from somewhere else. @item You should maintain alphabetical order in alphabetically ordered lists as long as doing so does not break API/ABI compatibility. @item Lines with similar content should be aligned vertically when doing so improves readability. +@item + Consider to add a regression test for your code. +@item + If you added YASM code please check that things still work with --disable-yasm @end enumerate @section Patch review process -All patches posted to the -@uref{https://lists.libav.org/mailman/listinfo/libav-devel, libav-devel} -mailing list will be reviewed, unless they contain a +All patches posted to ffmpeg-devel will be reviewed, unless they contain a clear note that the patch is not for the git master branch. Reviews and comments will be posted as replies to the patch on the mailing list. The patch submitter then has to take care of every comment, @@ -498,22 +498,26 @@ After a patch is approved it will be committed to the repository. We will review all submitted patches, but sometimes we are quite busy so especially for large patches this can take several weeks. -When resubmitting patches, if their size grew or during the review different -issues arisen please split the patch so each issue has a specific patch. +If you feel that the review process is too slow and you are willing to try to +take over maintainership of the area of code you change then just clone +git master and maintain the area of code there. We will merge each area from +where its best maintained. -@anchor{Regression Tests} -@section Regression Tests +When resubmitting patches, please do not make any significant changes +not related to the comments received during review. Such patches will +be rejected. Instead, submit significant changes or new features as +separate patches. -Before submitting a patch (or committing to the repository), you should at -least make sure that it does not break anything. +@anchor{Regression tests} +@section Regression tests -If the code changed has already a test present in FATE you should run it, -otherwise it is advised to add it. +Before submitting a patch (or committing to the repository), you should at least +test that you did not break anything. -Improvements to codec or demuxer might change the FATE results. Make sure -to commit the update reference with the change and to explain in the comment -why the expected result changed. +Running 'make fate' accomplishes this, please see @url{fate.html} for details. -Please refer to @url{fate.html}. +[Of course, some patches may change the results of the regression tests. In +this case, the reference results of the regression tests shall be modified +accordingly]. @bye diff --git a/doc/encoders.texi b/doc/encoders.texi index 830981fe8d..65841eda7f 100644 --- a/doc/encoders.texi +++ b/doc/encoders.texi @@ -1,10 +1,10 @@ @chapter Encoders @c man begin ENCODERS -Encoders are configured elements in Libav which allow the encoding of +Encoders are configured elements in FFmpeg which allow the encoding of multimedia streams. -When you configure your Libav build, all the supported native encoders +When you configure your FFmpeg build, all the supported native encoders are enabled by default. Encoders requiring an external library must be enabled manually via the corresponding @code{--enable-lib} option. You can list all available encoders using the configure option @code{--list-encoders}. @@ -369,7 +369,7 @@ is highly recommended that it be left as enabled except for testing purposes. @end table -@subheading Floating-Point-Only AC-3 Encoding Options +@subsection Floating-Point-Only AC-3 Encoding Options These options are only valid for the floating-point encoder and do not exist for the fixed-point encoder due to the corresponding features not being @@ -413,3 +413,176 @@ Selected by Encoder (default) @end table @c man end AUDIO ENCODERS + +@chapter Video Encoders +@c man begin VIDEO ENCODERS + +A description of some of the currently available video encoders +follows. + +@section libvpx + +VP8 format supported through libvpx. + +Requires the presence of the libvpx headers and library during configuration. +You need to explicitly configure the build with @code{--enable-libvpx}. + +@subsection Options + +Mapping from FFmpeg to libvpx options with conversion notes in parentheses. + +@table @option + +@item threads +g_threads + +@item profile +g_profile + +@item vb +rc_target_bitrate + +@item g +kf_max_dist + +@item keyint_min +kf_min_dist + +@item qmin +rc_min_quantizer + +@item qmax +rc_max_quantizer + +@item bufsize, vb +rc_buf_sz +@code{(bufsize * 1000 / vb)} + +rc_buf_optimal_sz +@code{(bufsize * 1000 / vb * 5 / 6)} + +@item rc_init_occupancy, vb +rc_buf_initial_sz +@code{(rc_init_occupancy * 1000 / vb)} + +@item rc_buffer_aggressivity +rc_undershoot_pct + +@item skip_threshold +rc_dropframe_thresh + +@item qcomp +rc_2pass_vbr_bias_pct + +@item maxrate, vb +rc_2pass_vbr_maxsection_pct +@code{(maxrate * 100 / vb)} + +@item minrate, vb +rc_2pass_vbr_minsection_pct +@code{(minrate * 100 / vb)} + +@item minrate, maxrate, vb +@code{VPX_CBR} +@code{(minrate == maxrate == vb)} + +@item crf +@code{VPX_CQ}, @code{VP8E_SET_CQ_LEVEL} + +@item quality +@table @option +@item @var{best} +@code{VPX_DL_BEST_QUALITY} +@item @var{good} +@code{VPX_DL_GOOD_QUALITY} +@item @var{realtime} +@code{VPX_DL_REALTIME} +@end table + +@item speed +@code{VP8E_SET_CPUUSED} + +@item nr +@code{VP8E_SET_NOISE_SENSITIVITY} + +@item mb_threshold +@code{VP8E_SET_STATIC_THRESHOLD} + +@item slices +@code{VP8E_SET_TOKEN_PARTITIONS} + +@item Alternate reference frame related +@table @option +@item vp8flags altref +@code{VP8E_SET_ENABLEAUTOALTREF} +@item @var{arnr_max_frames} +@code{VP8E_SET_ARNR_MAXFRAMES} +@item @var{arnr_type} +@code{VP8E_SET_ARNR_TYPE} +@item @var{arnr_strength} +@code{VP8E_SET_ARNR_STRENGTH} +@item @var{rc_lookahead} +g_lag_in_frames +@end table + +@item vp8flags error_resilient +g_error_resilient + +@end table + +For more information about libvpx see: +@url{http://www.webmproject.org/} + +@section libx264 + +H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10 format supported through +libx264. + +Requires the presence of the libx264 headers and library during +configuration. You need to explicitly configure the build with +@code{--enable-libx264}. + +@subsection Options + +@table @option + +@item preset @var{preset_name} +Set the encoding preset. + +@item tune @var{tune_name} +Tune the encoding params. + +@item fastfirstpass @var{bool} +Use fast settings when encoding first pass, default value is 1. + +@item profile @var{profile_name} +Set profile restrictions. + +@item level @var{level} +Specify level (as defined by Annex A). +Deprecated in favor of @var{x264opts}. + +@item passlogfile @var{filename} +Specify filename for 2 pass stats. +Deprecated in favor of @var{x264opts} (see @var{stats} libx264 option). + +@item wpredp @var{wpred_type} +Specify Weighted prediction for P-frames. +Deprecated in favor of @var{x264opts} (see @var{weightp} libx264 option). + +@item x264opts @var{options} +Allow to set any x264 option, see x264 --fullhelp for a list. + +@var{options} is a list of @var{key}=@var{value} couples separated by +":". +@end table + +For example to specify libx264 encoding options with @command{ffmpeg}: +@example +ffmpeg -i foo.mpg -vcodec libx264 -x264opts keyint=123:min-keyint=20 -an out.mkv +@end example + +For more information about libx264 and the supported options see: +@url{http://www.videolan.org/developers/x264.html} + +@c man end VIDEO ENCODERS diff --git a/doc/errno.txt b/doc/errno.txt new file mode 100644 index 0000000000..31cab26fc2 --- /dev/null +++ b/doc/errno.txt @@ -0,0 +1,174 @@ +The following table lists most error codes found in various operating +systems supported by FFmpeg. + + OS +Code Std F LBMWwb Text (YMMV) + +E2BIG POSIX ++++++ Argument list too long +EACCES POSIX ++++++ Permission denied +EADDRINUSE POSIX +++..+ Address in use +EADDRNOTAVAIL POSIX +++..+ Cannot assign requested address +EADV +..... Advertise error +EAFNOSUPPORT POSIX +++..+ Address family not supported +EAGAIN POSIX + ++++++ Resource temporarily unavailable +EALREADY POSIX +++..+ Operation already in progress +EAUTH .++... Authentication error +EBADARCH ..+... Bad CPU type in executable +EBADE +..... Invalid exchange +EBADEXEC ..+... Bad executable +EBADF POSIX ++++++ Bad file descriptor +EBADFD +..... File descriptor in bad state +EBADMACHO ..+... Malformed Macho file +EBADMSG POSIX ++4... Bad message +EBADR +..... Invalid request descriptor +EBADRPC .++... RPC struct is bad +EBADRQC +..... Invalid request code +EBADSLT +..... Invalid slot +EBFONT +..... Bad font file format +EBUSY POSIX - ++++++ Device or resource busy +ECANCELED POSIX +++... Operation canceled +ECHILD POSIX ++++++ No child processes +ECHRNG +..... Channel number out of range +ECOMM +..... Communication error on send +ECONNABORTED POSIX +++..+ Software caused connection abort +ECONNREFUSED POSIX - +++ss+ Connection refused +ECONNRESET POSIX +++..+ Connection reset +EDEADLK POSIX ++++++ Resource deadlock avoided +EDEADLOCK +..++. File locking deadlock error +EDESTADDRREQ POSIX +++... Destination address required +EDEVERR ..+... Device error +EDOM C89 - ++++++ Numerical argument out of domain +EDOOFUS .F.... Programming error +EDOTDOT +..... RFS specific error +EDQUOT POSIX +++... Disc quota exceeded +EEXIST POSIX ++++++ File exists +EFAULT POSIX - ++++++ Bad address +EFBIG POSIX - ++++++ File too large +EFTYPE .++... Inappropriate file type or format +EHOSTDOWN +++... Host is down +EHOSTUNREACH POSIX +++..+ No route to host +EHWPOISON +..... Memory page has hardware error +EIDRM POSIX +++... Identifier removed +EILSEQ C99 ++++++ Illegal byte sequence +EINPROGRESS POSIX - +++ss+ Operation in progress +EINTR POSIX - ++++++ Interrupted system call +EINVAL POSIX + ++++++ Invalid argument +EIO POSIX + ++++++ I/O error +EISCONN POSIX +++..+ Socket is already connected +EISDIR POSIX ++++++ Is a directory +EISNAM +..... Is a named type file +EKEYEXPIRED +..... Key has expired +EKEYREJECTED +..... Key was rejected by service +EKEYREVOKED +..... Key has been revoked +EL2HLT +..... Level 2 halted +EL2NSYNC +..... Level 2 not synchronized +EL3HLT +..... Level 3 halted +EL3RST +..... Level 3 reset +ELIBACC +..... Can not access a needed shared library +ELIBBAD +..... Accessing a corrupted shared library +ELIBEXEC +..... Cannot exec a shared library directly +ELIBMAX +..... Too many shared libraries +ELIBSCN +..... .lib section in a.out corrupted +ELNRNG +..... Link number out of range +ELOOP POSIX +++..+ Too many levels of symbolic links +EMEDIUMTYPE +..... Wrong medium type +EMFILE POSIX ++++++ Too many open files +EMLINK POSIX ++++++ Too many links +EMSGSIZE POSIX +++..+ Message too long +EMULTIHOP POSIX ++4... Multihop attempted +ENAMETOOLONG POSIX - ++++++ Filen ame too long +ENAVAIL +..... No XENIX semaphores available +ENEEDAUTH .++... Need authenticator +ENETDOWN POSIX +++..+ Network is down +ENETRESET SUSv3 +++..+ Network dropped connection on reset +ENETUNREACH POSIX +++..+ Network unreachable +ENFILE POSIX ++++++ Too many open files in system +ENOANO +..... No anode +ENOATTR .++... Attribute not found +ENOBUFS POSIX - +++..+ No buffer space available +ENOCSI +..... No CSI structure available +ENODATA XSR +N4... No message available +ENODEV POSIX - ++++++ No such device +ENOENT POSIX - ++++++ No such file or directory +ENOEXEC POSIX ++++++ Exec format error +ENOFILE ...++. No such file or directory +ENOKEY +..... Required key not available +ENOLCK POSIX ++++++ No locks available +ENOLINK POSIX ++4... Link has been severed +ENOMEDIUM +..... No medium found +ENOMEM POSIX ++++++ Not enough space +ENOMSG POSIX +++..+ No message of desired type +ENONET +..... Machine is not on the network +ENOPKG +..... Package not installed +ENOPROTOOPT POSIX +++..+ Protocol not available +ENOSPC POSIX ++++++ No space left on device +ENOSR XSR +N4... No STREAM resources +ENOSTR XSR +N4... Not a STREAM +ENOSYS POSIX + ++++++ Function not implemented +ENOTBLK +++... Block device required +ENOTCONN POSIX +++..+ Socket is not connected +ENOTDIR POSIX ++++++ Not a directory +ENOTEMPTY POSIX ++++++ Directory not empty +ENOTNAM +..... Not a XENIX named type file +ENOTRECOVERABLE SUSv4 - +..... State not recoverable +ENOTSOCK POSIX +++..+ Socket operation on non-socket +ENOTSUP POSIX +++... Operation not supported +ENOTTY POSIX ++++++ Inappropriate I/O control operation +ENOTUNIQ +..... Name not unique on network +ENXIO POSIX ++++++ No such device or address +EOPNOTSUPP POSIX +++..+ Operation not supported (on socket) +EOVERFLOW POSIX +++..+ Value too large to be stored in data type +EOWNERDEAD SUSv4 +..... Owner died +EPERM POSIX - ++++++ Operation not permitted +EPFNOSUPPORT +++..+ Protocol family not supported +EPIPE POSIX - ++++++ Broken pipe +EPROCLIM .++... Too many processes +EPROCUNAVAIL .++... Bad procedure for program +EPROGMISMATCH .++... Program version wrong +EPROGUNAVAIL .++... RPC prog. not avail +EPROTO POSIX ++4... Protocol error +EPROTONOSUPPORT POSIX - +++ss+ Protocol not supported +EPROTOTYPE POSIX +++..+ Protocol wrong type for socket +EPWROFF ..+... Device power is off +ERANGE C89 - ++++++ Result too large +EREMCHG +..... Remote address changed +EREMOTE +++... Object is remote +EREMOTEIO +..... Remote I/O error +ERESTART +..... Interrupted system call should be restarted +ERFKILL +..... Operation not possible due to RF-kill +EROFS POSIX ++++++ Read-only file system +ERPCMISMATCH .++... RPC version wrong +ESHLIBVERS ..+... Shared library version mismatch +ESHUTDOWN +++..+ Cannot send after socket shutdown +ESOCKTNOSUPPORT +++... Socket type not supported +ESPIPE POSIX ++++++ Illegal seek +ESRCH POSIX ++++++ No such process +ESRMNT +..... Srmount error +ESTALE POSIX +++..+ Stale NFS file handle +ESTRPIPE +..... Streams pipe error +ETIME XSR +N4... Stream ioctl timeout +ETIMEDOUT POSIX - +++ss+ Connection timed out +ETOOMANYREFS +++... Too many references: cannot splice +ETXTBSY POSIX +++... Text file busy +EUCLEAN +..... Structure needs cleaning +EUNATCH +..... Protocol driver not attached +EUSERS +++... Too many users +EWOULDBLOCK POSIX +++..+ Operation would block +EXDEV POSIX ++++++ Cross-device link +EXFULL +..... Exchange full + +Notations: + +F: used in FFmpeg (-: a few times, +: a lot) + +SUSv3: Single Unix Specification, version 3 +SUSv4: Single Unix Specification, version 4 +XSR: XSI STREAMS (obsolete) + +OS: availability on some supported operating systems +L: GNU/Linux +B: BSD (F: FreeBSD, N: NetBSD) +M: MacOS X +W: Microsoft Windows (s: emulated with winsock, see libavformat/network.h) +w: Mingw32 (3.17) and Mingw64 (2.0.1) +b: BeOS diff --git a/doc/eval.texi b/doc/eval.texi index 7f8f3653b3..b325b37dff 100644 --- a/doc/eval.texi +++ b/doc/eval.texi @@ -1,7 +1,7 @@ @chapter Expression Evaluation @c man begin EXPRESSION EVALUATION -When evaluating an arithmetic expression, Libav uses an internal +When evaluating an arithmetic expression, FFmpeg uses an internal formula evaluator, implemented through the @file{libavutil/eval.h} interface. @@ -50,6 +50,7 @@ Allow to store the value of the expression @var{expr} in an internal variable. @var{var} specifies the number of the variable where to store the value, and it is a value ranging from 0 to 9. The function returns the value stored in the internal variable. +Note, Variables are currently not shared between expressions. @item ld(var) Allow to load the value of the internal variable with number @@ -79,6 +80,34 @@ Compute the square root of @var{expr}. This is equivalent to @item not(expr) Return 1.0 if @var{expr} is zero, 0.0 otherwise. + +@item pow(x, y) +Compute the power of @var{x} elevated @var{y}, it is equivalent to +"(@var{x})^(@var{y})". + +@item random(x) +Return a pseudo random value between 0.0 and 1.0. @var{x} is the index of the +internal variable which will be used to save the seed/state. + +@item hypot(x, y) +This function is similar to the C function with the same name; it returns +"sqrt(@var{x}*@var{x} + @var{y}*@var{y})", the length of the hypotenuse of a +right triangle with sides of length @var{x} and @var{y}, or the distance of the +point (@var{x}, @var{y}) from the origin. + +@item gcd(x, y) +Return the greatest common divisor of @var{x} and @var{y}. If both @var{x} and +@var{y} are 0 or either or both are less than zero then behavior is undefined. +@end table + +The following constants are available: +@table @option +@item PI +area of the unit disc, approximately 3.14 +@item E +exp(1) (Euler's number), approximately 2.718 +@item PHI +golden ratio (1+sqrt(5))/2, approximately 1.618 @end table Note that: diff --git a/doc/examples/Makefile b/doc/examples/Makefile new file mode 100644 index 0000000000..b363590d53 --- /dev/null +++ b/doc/examples/Makefile @@ -0,0 +1,21 @@ +# use pkg-config for getting CFLAGS abd LDFLAGS +FFMPEG_LIBS=libavdevice libavformat libavfilter libavcodec libswscale libavutil +CFLAGS+=$(shell pkg-config --cflags $(FFMPEG_LIBS)) +LDFLAGS+=$(shell pkg-config --libs $(FFMPEG_LIBS)) + +EXAMPLES=decoding_encoding filtering metadata muxing + +OBJS=$(addsuffix .o,$(EXAMPLES)) + +%: %.o + $(CC) $< $(LDFLAGS) -o $@ + +%.o: %.c + $(CC) $< $(CFLAGS) -c -o $@ + +.phony: all clean + +all: $(OBJS) $(EXAMPLES) + +clean: + rm -rf $(EXAMPLES) $(OBJS) diff --git a/doc/examples/decoding_encoding.c b/doc/examples/decoding_encoding.c new file mode 100644 index 0000000000..5271edf34e --- /dev/null +++ b/doc/examples/decoding_encoding.c @@ -0,0 +1,477 @@ +/* + * Copyright (c) 2001 Fabrice Bellard + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL + * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + * THE SOFTWARE. + */ + +/** + * @file + * libavcodec API use example. + * + * Note that libavcodec only handles codecs (mpeg, mpeg4, etc...), + * not file formats (avi, vob, mp4, mov, mkv, mxf, flv, mpegts, mpegps, etc...). See library 'libavformat' for the + * format handling + */ + +#include "libavutil/imgutils.h" +#include "libavutil/opt.h" +#include "libavcodec/avcodec.h" +#include "libavutil/mathematics.h" +#include "libavutil/samplefmt.h" + +#define INBUF_SIZE 4096 +#define AUDIO_INBUF_SIZE 20480 +#define AUDIO_REFILL_THRESH 4096 + +/* + * Audio encoding example + */ +static void audio_encode_example(const char *filename) +{ + AVCodec *codec; + AVCodecContext *c= NULL; + int frame_size, i, j, out_size, outbuf_size; + FILE *f; + short *samples; + float t, tincr; + uint8_t *outbuf; + + printf("Audio encoding\n"); + + /* find the MP2 encoder */ + codec = avcodec_find_encoder(CODEC_ID_MP2); + if (!codec) { + fprintf(stderr, "codec not found\n"); + exit(1); + } + + c = avcodec_alloc_context3(codec); + + /* put sample parameters */ + c->bit_rate = 64000; + c->sample_rate = 44100; + c->channels = 2; + c->sample_fmt = AV_SAMPLE_FMT_S16; + + /* open it */ + if (avcodec_open(c, codec) < 0) { + fprintf(stderr, "could not open codec\n"); + exit(1); + } + + /* the codec gives us the frame size, in samples */ + frame_size = c->frame_size; + samples = malloc(frame_size * 2 * c->channels); + outbuf_size = 10000; + outbuf = malloc(outbuf_size); + + f = fopen(filename, "wb"); + if (!f) { + fprintf(stderr, "could not open %s\n", filename); + exit(1); + } + + /* encode a single tone sound */ + t = 0; + tincr = 2 * M_PI * 440.0 / c->sample_rate; + for(i=0;i<200;i++) { + for(j=0;j<frame_size;j++) { + samples[2*j] = (int)(sin(t) * 10000); + samples[2*j+1] = samples[2*j]; + t += tincr; + } + /* encode the samples */ + out_size = avcodec_encode_audio(c, outbuf, outbuf_size, samples); + fwrite(outbuf, 1, out_size, f); + } + fclose(f); + free(outbuf); + free(samples); + + avcodec_close(c); + av_free(c); +} + +/* + * Audio decoding. + */ +static void audio_decode_example(const char *outfilename, const char *filename) +{ + AVCodec *codec; + AVCodecContext *c= NULL; + int len; + FILE *f, *outfile; + uint8_t inbuf[AUDIO_INBUF_SIZE + FF_INPUT_BUFFER_PADDING_SIZE]; + AVPacket avpkt; + AVFrame *decoded_frame = NULL; + + av_init_packet(&avpkt); + + printf("Audio decoding\n"); + + /* find the mpeg audio decoder */ + codec = avcodec_find_decoder(CODEC_ID_MP2); + if (!codec) { + fprintf(stderr, "codec not found\n"); + exit(1); + } + + c = avcodec_alloc_context3(codec); + + /* open it */ + if (avcodec_open(c, codec) < 0) { + fprintf(stderr, "could not open codec\n"); + exit(1); + } + + f = fopen(filename, "rb"); + if (!f) { + fprintf(stderr, "could not open %s\n", filename); + exit(1); + } + outfile = fopen(outfilename, "wb"); + if (!outfile) { + av_free(c); + exit(1); + } + + /* decode until eof */ + avpkt.data = inbuf; + avpkt.size = fread(inbuf, 1, AUDIO_INBUF_SIZE, f); + + while (avpkt.size > 0) { + int got_frame = 0; + + if (!decoded_frame) { + if (!(decoded_frame = avcodec_alloc_frame())) { + fprintf(stderr, "out of memory\n"); + exit(1); + } + } else + avcodec_get_frame_defaults(decoded_frame); + + len = avcodec_decode_audio4(c, decoded_frame, &got_frame, &avpkt); + if (len < 0) { + fprintf(stderr, "Error while decoding\n"); + exit(1); + } + if (got_frame) { + /* if a frame has been decoded, output it */ + int data_size = av_samples_get_buffer_size(NULL, c->channels, + decoded_frame->nb_samples, + c->sample_fmt, 1); + fwrite(decoded_frame->data[0], 1, data_size, outfile); + } + avpkt.size -= len; + avpkt.data += len; + avpkt.dts = + avpkt.pts = AV_NOPTS_VALUE; + if (avpkt.size < AUDIO_REFILL_THRESH) { + /* Refill the input buffer, to avoid trying to decode + * incomplete frames. Instead of this, one could also use + * a parser, or use a proper container format through + * libavformat. */ + memmove(inbuf, avpkt.data, avpkt.size); + avpkt.data = inbuf; + len = fread(avpkt.data + avpkt.size, 1, + AUDIO_INBUF_SIZE - avpkt.size, f); + if (len > 0) + avpkt.size += len; + } + } + + fclose(outfile); + fclose(f); + + avcodec_close(c); + av_free(c); + av_free(decoded_frame); +} + +/* + * Video encoding example + */ +static void video_encode_example(const char *filename, int codec_id) +{ + AVCodec *codec; + AVCodecContext *c= NULL; + int i, out_size, size, x, y, outbuf_size; + FILE *f; + AVFrame *picture; + uint8_t *outbuf; + + printf("Video encoding\n"); + + /* find the mpeg1 video encoder */ + codec = avcodec_find_encoder(codec_id); + if (!codec) { + fprintf(stderr, "codec not found\n"); + exit(1); + } + + c = avcodec_alloc_context3(codec); + picture= avcodec_alloc_frame(); + + /* put sample parameters */ + c->bit_rate = 400000; + /* resolution must be a multiple of two */ + c->width = 352; + c->height = 288; + /* frames per second */ + c->time_base= (AVRational){1,25}; + c->gop_size = 10; /* emit one intra frame every ten frames */ + c->max_b_frames=1; + c->pix_fmt = PIX_FMT_YUV420P; + + if(codec_id == CODEC_ID_H264) + av_opt_set(c->priv_data, "preset", "slow", 0); + + /* open it */ + if (avcodec_open(c, codec) < 0) { + fprintf(stderr, "could not open codec\n"); + exit(1); + } + + f = fopen(filename, "wb"); + if (!f) { + fprintf(stderr, "could not open %s\n", filename); + exit(1); + } + + /* alloc image and output buffer */ + outbuf_size = 100000; + outbuf = malloc(outbuf_size); + + /* the image can be allocated by any means and av_image_alloc() is + * just the most convenient way if av_malloc() is to be used */ + av_image_alloc(picture->data, picture->linesize, + c->width, c->height, c->pix_fmt, 1); + + /* encode 1 second of video */ + for(i=0;i<25;i++) { + fflush(stdout); + /* prepare a dummy image */ + /* Y */ + for(y=0;y<c->height;y++) { + for(x=0;x<c->width;x++) { + picture->data[0][y * picture->linesize[0] + x] = x + y + i * 3; + } + } + + /* Cb and Cr */ + for(y=0;y<c->height/2;y++) { + for(x=0;x<c->width/2;x++) { + picture->data[1][y * picture->linesize[1] + x] = 128 + y + i * 2; + picture->data[2][y * picture->linesize[2] + x] = 64 + x + i * 5; + } + } + + /* encode the image */ + out_size = avcodec_encode_video(c, outbuf, outbuf_size, picture); + printf("encoding frame %3d (size=%5d)\n", i, out_size); + fwrite(outbuf, 1, out_size, f); + } + + /* get the delayed frames */ + for(; out_size; i++) { + fflush(stdout); + + out_size = avcodec_encode_video(c, outbuf, outbuf_size, NULL); + printf("write frame %3d (size=%5d)\n", i, out_size); + fwrite(outbuf, 1, out_size, f); + } + + /* add sequence end code to have a real mpeg file */ + outbuf[0] = 0x00; + outbuf[1] = 0x00; + outbuf[2] = 0x01; + outbuf[3] = 0xb7; + fwrite(outbuf, 1, 4, f); + fclose(f); + free(outbuf); + + avcodec_close(c); + av_free(c); + av_free(picture->data[0]); + av_free(picture); + printf("\n"); +} + +/* + * Video decoding example + */ + +static void pgm_save(unsigned char *buf, int wrap, int xsize, int ysize, + char *filename) +{ + FILE *f; + int i; + + f=fopen(filename,"w"); + fprintf(f,"P5\n%d %d\n%d\n",xsize,ysize,255); + for(i=0;i<ysize;i++) + fwrite(buf + i * wrap,1,xsize,f); + fclose(f); +} + +static void video_decode_example(const char *outfilename, const char *filename) +{ + AVCodec *codec; + AVCodecContext *c= NULL; + int frame, got_picture, len; + FILE *f; + AVFrame *picture; + uint8_t inbuf[INBUF_SIZE + FF_INPUT_BUFFER_PADDING_SIZE]; + char buf[1024]; + AVPacket avpkt; + + av_init_packet(&avpkt); + + /* set end of buffer to 0 (this ensures that no overreading happens for damaged mpeg streams) */ + memset(inbuf + INBUF_SIZE, 0, FF_INPUT_BUFFER_PADDING_SIZE); + + printf("Video decoding\n"); + + /* find the mpeg1 video decoder */ + codec = avcodec_find_decoder(CODEC_ID_MPEG1VIDEO); + if (!codec) { + fprintf(stderr, "codec not found\n"); + exit(1); + } + + c = avcodec_alloc_context3(codec); + picture= avcodec_alloc_frame(); + + if(codec->capabilities&CODEC_CAP_TRUNCATED) + c->flags|= CODEC_FLAG_TRUNCATED; /* we do not send complete frames */ + + /* For some codecs, such as msmpeg4 and mpeg4, width and height + MUST be initialized there because this information is not + available in the bitstream. */ + + /* open it */ + if (avcodec_open(c, codec) < 0) { + fprintf(stderr, "could not open codec\n"); + exit(1); + } + + /* the codec gives us the frame size, in samples */ + + f = fopen(filename, "rb"); + if (!f) { + fprintf(stderr, "could not open %s\n", filename); + exit(1); + } + + frame = 0; + for(;;) { + avpkt.size = fread(inbuf, 1, INBUF_SIZE, f); + if (avpkt.size == 0) + break; + + /* NOTE1: some codecs are stream based (mpegvideo, mpegaudio) + and this is the only method to use them because you cannot + know the compressed data size before analysing it. + + BUT some other codecs (msmpeg4, mpeg4) are inherently frame + based, so you must call them with all the data for one + frame exactly. You must also initialize 'width' and + 'height' before initializing them. */ + + /* NOTE2: some codecs allow the raw parameters (frame size, + sample rate) to be changed at any frame. We handle this, so + you should also take care of it */ + + /* here, we use a stream based decoder (mpeg1video), so we + feed decoder and see if it could decode a frame */ + avpkt.data = inbuf; + while (avpkt.size > 0) { + len = avcodec_decode_video2(c, picture, &got_picture, &avpkt); + if (len < 0) { + fprintf(stderr, "Error while decoding frame %d\n", frame); + exit(1); + } + if (got_picture) { + printf("saving frame %3d\n", frame); + fflush(stdout); + + /* the picture is allocated by the decoder. no need to + free it */ + snprintf(buf, sizeof(buf), outfilename, frame); + pgm_save(picture->data[0], picture->linesize[0], + c->width, c->height, buf); + frame++; + } + avpkt.size -= len; + avpkt.data += len; + } + } + + /* some codecs, such as MPEG, transmit the I and P frame with a + latency of one frame. You must do the following to have a + chance to get the last frame of the video */ + avpkt.data = NULL; + avpkt.size = 0; + len = avcodec_decode_video2(c, picture, &got_picture, &avpkt); + if (got_picture) { + printf("saving last frame %3d\n", frame); + fflush(stdout); + + /* the picture is allocated by the decoder. no need to + free it */ + snprintf(buf, sizeof(buf), outfilename, frame); + pgm_save(picture->data[0], picture->linesize[0], + c->width, c->height, buf); + frame++; + } + + fclose(f); + + avcodec_close(c); + av_free(c); + av_free(picture); + printf("\n"); +} + +int main(int argc, char **argv) +{ + const char *filename; + + /* must be called before using avcodec lib */ + avcodec_init(); + + /* register all the codecs */ + avcodec_register_all(); + + if (argc <= 1) { + audio_encode_example("/tmp/test.mp2"); + audio_decode_example("/tmp/test.sw", "/tmp/test.mp2"); + + video_encode_example("/tmp/test.h264", CODEC_ID_H264); + video_encode_example("/tmp/test.mpg", CODEC_ID_MPEG1VIDEO); + filename = "/tmp/test.mpg"; + } else { + filename = argv[1]; + } + + // audio_decode_example("/tmp/test.sw", filename); + video_decode_example("/tmp/test%d.pgm", filename); + + return 0; +} diff --git a/doc/examples/filtering.c b/doc/examples/filtering.c new file mode 100644 index 0000000000..06e513026e --- /dev/null +++ b/doc/examples/filtering.c @@ -0,0 +1,229 @@ +/* + * Copyright (c) 2010 Nicolas George + * Copyright (c) 2011 Stefano Sabatini + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL + * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + * THE SOFTWARE. + */ + +/** + * @file + * API example for decoding and filtering + */ + +#define _XOPEN_SOURCE 600 /* for usleep */ + +#include <libavcodec/avcodec.h> +#include <libavformat/avformat.h> +#include <libavfilter/avfiltergraph.h> +#include <libavfilter/vsrc_buffer.h> + +const char *filter_descr = "scale=78:24"; + +static AVFormatContext *fmt_ctx; +static AVCodecContext *dec_ctx; +AVFilterContext *buffersink_ctx; +AVFilterContext *buffersrc_ctx; +AVFilterGraph *filter_graph; +static int video_stream_index = -1; +static int64_t last_pts = AV_NOPTS_VALUE; + +static int open_input_file(const char *filename) +{ + int ret, i; + AVCodec *dec; + + if ((ret = avformat_open_input(&fmt_ctx, filename, NULL, NULL)) < 0) { + av_log(NULL, AV_LOG_ERROR, "Cannot open input file\n"); + return ret; + } + + if ((ret = av_find_stream_info(fmt_ctx)) < 0) { + av_log(NULL, AV_LOG_ERROR, "Cannot find stream information\n"); + return ret; + } + + /* select the video stream */ + ret = av_find_best_stream(fmt_ctx, AVMEDIA_TYPE_VIDEO, -1, -1, &dec, 0); + if (ret < 0) { + av_log(NULL, AV_LOG_ERROR, "Cannot find a video stream in the input file\n"); + return ret; + } + video_stream_index = ret; + dec_ctx = fmt_ctx->streams[video_stream_index]->codec; + + /* init the video decoder */ + if ((ret = avcodec_open(dec_ctx, dec)) < 0) { + av_log(NULL, AV_LOG_ERROR, "Cannot open video decoder\n"); + return ret; + } + + return 0; +} + +static int init_filters(const char *filters_descr) +{ + char args[512]; + int ret; + AVFilter *buffersrc = avfilter_get_by_name("buffer"); + AVFilter *buffersink = avfilter_get_by_name("buffersink"); + AVFilterInOut *outputs = avfilter_inout_alloc(); + AVFilterInOut *inputs = avfilter_inout_alloc(); + enum PixelFormat pix_fmts[] = { PIX_FMT_GRAY8, PIX_FMT_NONE }; + filter_graph = avfilter_graph_alloc(); + + /* buffer video source: the decoded frames from the decoder will be inserted here. */ + snprintf(args, sizeof(args), "%d:%d:%d:%d:%d:%d:%d", + dec_ctx->width, dec_ctx->height, dec_ctx->pix_fmt, + dec_ctx->time_base.num, dec_ctx->time_base.den, + dec_ctx->sample_aspect_ratio.num, dec_ctx->sample_aspect_ratio.den); + ret = avfilter_graph_create_filter(&buffersrc_ctx, buffersrc, "in", + args, NULL, filter_graph); + if (ret < 0) { + av_log(NULL, AV_LOG_ERROR, "Cannot create buffer source\n"); + return ret; + } + + /* buffer video sink: to terminate the filter chain. */ + ret = avfilter_graph_create_filter(&buffersink_ctx, buffersink, "out", + NULL, pix_fmts, filter_graph); + if (ret < 0) { + av_log(NULL, AV_LOG_ERROR, "Cannot create buffer sink\n"); + return ret; + } + + /* Endpoints for the filter graph. */ + outputs->name = av_strdup("in"); + outputs->filter_ctx = buffersrc_ctx; + outputs->pad_idx = 0; + outputs->next = NULL; + + inputs->name = av_strdup("out"); + inputs->filter_ctx = buffersink_ctx; + inputs->pad_idx = 0; + inputs->next = NULL; + + if ((ret = avfilter_graph_parse(filter_graph, filter_descr, + &inputs, &outputs, NULL)) < 0) + return ret; + + if ((ret = avfilter_graph_config(filter_graph, NULL)) < 0) + return ret; +} + +static void display_picref(AVFilterBufferRef *picref, AVRational time_base) +{ + int x, y; + uint8_t *p0, *p; + int64_t delay; + + if (picref->pts != AV_NOPTS_VALUE) { + if (last_pts != AV_NOPTS_VALUE) { + /* sleep roughly the right amount of time; + * usleep is in microseconds, just like AV_TIME_BASE. */ + delay = av_rescale_q(picref->pts - last_pts, + time_base, AV_TIME_BASE_Q); + if (delay > 0 && delay < 1000000) + usleep(delay); + } + last_pts = picref->pts; + } + + /* Trivial ASCII grayscale display. */ + p0 = picref->data[0]; + puts("\033c"); + for (y = 0; y < picref->video->h; y++) { + p = p0; + for (x = 0; x < picref->video->w; x++) + putchar(" .-+#"[*(p++) / 52]); + putchar('\n'); + p0 += picref->linesize[0]; + } + fflush(stdout); +} + +int main(int argc, char **argv) +{ + int ret; + AVPacket packet; + AVFrame frame; + int got_frame; + + if (argc != 2) { + fprintf(stderr, "Usage: %s file\n", argv[0]); + exit(1); + } + + avcodec_register_all(); + av_register_all(); + avfilter_register_all(); + + if ((ret = open_input_file(argv[1])) < 0) + goto end; + if ((ret = init_filters(filter_descr)) < 0) + goto end; + + /* read all packets */ + while (1) { + AVFilterBufferRef *picref; + if ((ret = av_read_frame(fmt_ctx, &packet)) < 0) + break; + + if (packet.stream_index == video_stream_index) { + avcodec_get_frame_defaults(&frame); + got_frame = 0; + ret = avcodec_decode_video2(dec_ctx, &frame, &got_frame, &packet); + av_free_packet(&packet); + if (ret < 0) { + av_log(NULL, AV_LOG_ERROR, "Error decoding video\n"); + break; + } + + if (got_frame) { + if (frame.pts == AV_NOPTS_VALUE) + frame.pts = frame.pkt_dts == AV_NOPTS_VALUE ? + frame.pkt_dts : frame.pkt_pts; + /* push the decoded frame into the filtergraph */ + av_vsrc_buffer_add_frame(buffersrc_ctx, &frame); + + /* pull filtered pictures from the filtergraph */ + while (avfilter_poll_frame(buffersink_ctx->inputs[0])) { + av_vsink_buffer_get_video_buffer_ref(buffersink_ctx, &picref, 0); + if (picref) { + display_picref(picref, buffersink_ctx->inputs[0]->time_base); + avfilter_unref_buffer(picref); + } + } + } + } + } +end: + avfilter_graph_free(&filter_graph); + if (dec_ctx) + avcodec_close(dec_ctx); + av_close_input_file(fmt_ctx); + + if (ret < 0 && ret != AVERROR_EOF) { + char buf[1024]; + av_strerror(ret, buf, sizeof(buf)); + fprintf(stderr, "Error occurred: %s\n", buf); + exit(1); + } + + exit(0); +} diff --git a/doc/examples/metadata.c b/doc/examples/metadata.c new file mode 100644 index 0000000000..7d29be7049 --- /dev/null +++ b/doc/examples/metadata.c @@ -0,0 +1,55 @@ +/* + * Copyright (c) 2011 Reinhard Tartler + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL + * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + * THE SOFTWARE. + */ + +/** + * @file + * Shows how the metadata API can be used in application programs. + */ + +#include <stdio.h> + +#include <libavformat/avformat.h> +#include <libavutil/dict.h> + +int main (int argc, char **argv) +{ + AVFormatContext *fmt_ctx = NULL; + AVDictionaryEntry *tag = NULL; + int ret; + + if (argc != 2) { + printf("usage: %s <input_file>\n" + "example program to demonstrate the use of the libavformat metadata API.\n" + "\n", argv[0]); + return 1; + } + + av_register_all(); + if ((ret = avformat_open_input(&fmt_ctx, argv[1], NULL, NULL))) + return ret; + + while ((tag = av_dict_get(fmt_ctx->metadata, "", tag, AV_DICT_IGNORE_SUFFIX))) + printf("%s=%s\n", tag->key, tag->value); + + avformat_free_context(fmt_ctx); + return 0; +} diff --git a/doc/examples/muxing.c b/doc/examples/muxing.c new file mode 100644 index 0000000000..e72bfacc49 --- /dev/null +++ b/doc/examples/muxing.c @@ -0,0 +1,556 @@ +/* + * Copyright (c) 2003 Fabrice Bellard + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL + * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + * THE SOFTWARE. + */ + +/** + * @file + * libavformat API example. + * + * Output a media file in any supported libavformat format. + * The default codecs are used. + */ + +#include <stdlib.h> +#include <stdio.h> +#include <string.h> +#include <math.h> + +#include "libavutil/mathematics.h" +#include "libavformat/avformat.h" +#include "libswscale/swscale.h" + +#undef exit + +/* 5 seconds stream duration */ +#define STREAM_DURATION 200.0 +#define STREAM_FRAME_RATE 25 /* 25 images/s */ +#define STREAM_NB_FRAMES ((int)(STREAM_DURATION * STREAM_FRAME_RATE)) +#define STREAM_PIX_FMT PIX_FMT_YUV420P /* default pix_fmt */ + +static int sws_flags = SWS_BICUBIC; + +/**************************************************************/ +/* audio output */ + +static float t, tincr, tincr2; +static int16_t *samples; +static uint8_t *audio_outbuf; +static int audio_outbuf_size; +static int audio_input_frame_size; + +/* + * add an audio output stream + */ +static AVStream *add_audio_stream(AVFormatContext *oc, enum CodecID codec_id) +{ + AVCodecContext *c; + AVStream *st; + + st = avformat_new_stream(oc, NULL); + if (!st) { + fprintf(stderr, "Could not alloc stream\n"); + exit(1); + } + st->id = 1; + + c = st->codec; + c->codec_id = codec_id; + c->codec_type = AVMEDIA_TYPE_AUDIO; + + /* put sample parameters */ + c->sample_fmt = AV_SAMPLE_FMT_S16; + c->bit_rate = 64000; + c->sample_rate = 44100; + c->channels = 2; + + // some formats want stream headers to be separate + if (oc->oformat->flags & AVFMT_GLOBALHEADER) + c->flags |= CODEC_FLAG_GLOBAL_HEADER; + + return st; +} + +static void open_audio(AVFormatContext *oc, AVStream *st) +{ + AVCodecContext *c; + AVCodec *codec; + + c = st->codec; + + /* find the audio encoder */ + codec = avcodec_find_encoder(c->codec_id); + if (!codec) { + fprintf(stderr, "codec not found\n"); + exit(1); + } + + /* open it */ + if (avcodec_open(c, codec) < 0) { + fprintf(stderr, "could not open codec\n"); + exit(1); + } + + /* init signal generator */ + t = 0; + tincr = 2 * M_PI * 110.0 / c->sample_rate; + /* increment frequency by 110 Hz per second */ + tincr2 = 2 * M_PI * 110.0 / c->sample_rate / c->sample_rate; + + audio_outbuf_size = 10000; + audio_outbuf = av_malloc(audio_outbuf_size); + + /* ugly hack for PCM codecs (will be removed ASAP with new PCM + support to compute the input frame size in samples */ + if (c->frame_size <= 1) { + audio_input_frame_size = audio_outbuf_size / c->channels; + switch(st->codec->codec_id) { + case CODEC_ID_PCM_S16LE: + case CODEC_ID_PCM_S16BE: + case CODEC_ID_PCM_U16LE: + case CODEC_ID_PCM_U16BE: + audio_input_frame_size >>= 1; + break; + default: + break; + } + } else { + audio_input_frame_size = c->frame_size; + } + samples = av_malloc(audio_input_frame_size * 2 * c->channels); +} + +/* prepare a 16 bit dummy audio frame of 'frame_size' samples and + 'nb_channels' channels */ +static void get_audio_frame(int16_t *samples, int frame_size, int nb_channels) +{ + int j, i, v; + int16_t *q; + + q = samples; + for (j = 0; j < frame_size; j++) { + v = (int)(sin(t) * 10000); + for(i = 0; i < nb_channels; i++) + *q++ = v; + t += tincr; + tincr += tincr2; + } +} + +static void write_audio_frame(AVFormatContext *oc, AVStream *st) +{ + AVCodecContext *c; + AVPacket pkt; + av_init_packet(&pkt); + + c = st->codec; + + get_audio_frame(samples, audio_input_frame_size, c->channels); + + pkt.size = avcodec_encode_audio(c, audio_outbuf, audio_outbuf_size, samples); + + if (c->coded_frame && c->coded_frame->pts != AV_NOPTS_VALUE) + pkt.pts= av_rescale_q(c->coded_frame->pts, c->time_base, st->time_base); + pkt.flags |= AV_PKT_FLAG_KEY; + pkt.stream_index = st->index; + pkt.data = audio_outbuf; + + /* write the compressed frame in the media file */ + if (av_interleaved_write_frame(oc, &pkt) != 0) { + fprintf(stderr, "Error while writing audio frame\n"); + exit(1); + } +} + +static void close_audio(AVFormatContext *oc, AVStream *st) +{ + avcodec_close(st->codec); + + av_free(samples); + av_free(audio_outbuf); +} + +/**************************************************************/ +/* video output */ + +static AVFrame *picture, *tmp_picture; +static uint8_t *video_outbuf; +static int frame_count, video_outbuf_size; + +/* add a video output stream */ +static AVStream *add_video_stream(AVFormatContext *oc, enum CodecID codec_id) +{ + AVCodecContext *c; + AVStream *st; + AVCodec *codec; + + st = avformat_new_stream(oc, NULL); + if (!st) { + fprintf(stderr, "Could not alloc stream\n"); + exit(1); + } + + c = st->codec; + + /* find the video encoder */ + codec = avcodec_find_encoder(codec_id); + if (!codec) { + fprintf(stderr, "codec not found\n"); + exit(1); + } + avcodec_get_context_defaults3(c, codec); + + c->codec_id = codec_id; + + /* put sample parameters */ + c->bit_rate = 400000; + /* resolution must be a multiple of two */ + c->width = 352; + c->height = 288; + /* time base: this is the fundamental unit of time (in seconds) in terms + of which frame timestamps are represented. for fixed-fps content, + timebase should be 1/framerate and timestamp increments should be + identically 1. */ + c->time_base.den = STREAM_FRAME_RATE; + c->time_base.num = 1; + c->gop_size = 12; /* emit one intra frame every twelve frames at most */ + c->pix_fmt = STREAM_PIX_FMT; + if (c->codec_id == CODEC_ID_MPEG2VIDEO) { + /* just for testing, we also add B frames */ + c->max_b_frames = 2; + } + if (c->codec_id == CODEC_ID_MPEG1VIDEO){ + /* Needed to avoid using macroblocks in which some coeffs overflow. + This does not happen with normal video, it just happens here as + the motion of the chroma plane does not match the luma plane. */ + c->mb_decision=2; + } + // some formats want stream headers to be separate + if (oc->oformat->flags & AVFMT_GLOBALHEADER) + c->flags |= CODEC_FLAG_GLOBAL_HEADER; + + return st; +} + +static AVFrame *alloc_picture(enum PixelFormat pix_fmt, int width, int height) +{ + AVFrame *picture; + uint8_t *picture_buf; + int size; + + picture = avcodec_alloc_frame(); + if (!picture) + return NULL; + size = avpicture_get_size(pix_fmt, width, height); + picture_buf = av_malloc(size); + if (!picture_buf) { + av_free(picture); + return NULL; + } + avpicture_fill((AVPicture *)picture, picture_buf, + pix_fmt, width, height); + return picture; +} + +static void open_video(AVFormatContext *oc, AVStream *st) +{ + AVCodec *codec; + AVCodecContext *c; + + c = st->codec; + + /* find the video encoder */ + codec = avcodec_find_encoder(c->codec_id); + if (!codec) { + fprintf(stderr, "codec not found\n"); + exit(1); + } + + /* open the codec */ + if (avcodec_open(c, codec) < 0) { + fprintf(stderr, "could not open codec\n"); + exit(1); + } + + video_outbuf = NULL; + if (!(oc->oformat->flags & AVFMT_RAWPICTURE)) { + /* allocate output buffer */ + /* XXX: API change will be done */ + /* buffers passed into lav* can be allocated any way you prefer, + as long as they're aligned enough for the architecture, and + they're freed appropriately (such as using av_free for buffers + allocated with av_malloc) */ + video_outbuf_size = 200000; + video_outbuf = av_malloc(video_outbuf_size); + } + + /* allocate the encoded raw picture */ + picture = alloc_picture(c->pix_fmt, c->width, c->height); + if (!picture) { + fprintf(stderr, "Could not allocate picture\n"); + exit(1); + } + + /* if the output format is not YUV420P, then a temporary YUV420P + picture is needed too. It is then converted to the required + output format */ + tmp_picture = NULL; + if (c->pix_fmt != PIX_FMT_YUV420P) { + tmp_picture = alloc_picture(PIX_FMT_YUV420P, c->width, c->height); + if (!tmp_picture) { + fprintf(stderr, "Could not allocate temporary picture\n"); + exit(1); + } + } +} + +/* prepare a dummy image */ +static void fill_yuv_image(AVFrame *pict, int frame_index, int width, int height) +{ + int x, y, i; + + i = frame_index; + + /* Y */ + for (y = 0; y < height; y++) { + for (x = 0; x < width; x++) { + pict->data[0][y * pict->linesize[0] + x] = x + y + i * 3; + } + } + + /* Cb and Cr */ + for (y = 0; y < height/2; y++) { + for (x = 0; x < width/2; x++) { + pict->data[1][y * pict->linesize[1] + x] = 128 + y + i * 2; + pict->data[2][y * pict->linesize[2] + x] = 64 + x + i * 5; + } + } +} + +static void write_video_frame(AVFormatContext *oc, AVStream *st) +{ + int out_size, ret; + AVCodecContext *c; + static struct SwsContext *img_convert_ctx; + + c = st->codec; + + if (frame_count >= STREAM_NB_FRAMES) { + /* no more frame to compress. The codec has a latency of a few + frames if using B frames, so we get the last frames by + passing the same picture again */ + } else { + if (c->pix_fmt != PIX_FMT_YUV420P) { + /* as we only generate a YUV420P picture, we must convert it + to the codec pixel format if needed */ + if (img_convert_ctx == NULL) { + img_convert_ctx = sws_getContext(c->width, c->height, + PIX_FMT_YUV420P, + c->width, c->height, + c->pix_fmt, + sws_flags, NULL, NULL, NULL); + if (img_convert_ctx == NULL) { + fprintf(stderr, "Cannot initialize the conversion context\n"); + exit(1); + } + } + fill_yuv_image(tmp_picture, frame_count, c->width, c->height); + sws_scale(img_convert_ctx, tmp_picture->data, tmp_picture->linesize, + 0, c->height, picture->data, picture->linesize); + } else { + fill_yuv_image(picture, frame_count, c->width, c->height); + } + } + + + if (oc->oformat->flags & AVFMT_RAWPICTURE) { + /* raw video case. The API will change slightly in the near + future for that. */ + AVPacket pkt; + av_init_packet(&pkt); + + pkt.flags |= AV_PKT_FLAG_KEY; + pkt.stream_index = st->index; + pkt.data = (uint8_t *)picture; + pkt.size = sizeof(AVPicture); + + ret = av_interleaved_write_frame(oc, &pkt); + } else { + /* encode the image */ + out_size = avcodec_encode_video(c, video_outbuf, video_outbuf_size, picture); + /* if zero size, it means the image was buffered */ + if (out_size > 0) { + AVPacket pkt; + av_init_packet(&pkt); + + if (c->coded_frame->pts != AV_NOPTS_VALUE) + pkt.pts= av_rescale_q(c->coded_frame->pts, c->time_base, st->time_base); + if(c->coded_frame->key_frame) + pkt.flags |= AV_PKT_FLAG_KEY; + pkt.stream_index = st->index; + pkt.data = video_outbuf; + pkt.size = out_size; + + /* write the compressed frame in the media file */ + ret = av_interleaved_write_frame(oc, &pkt); + } else { + ret = 0; + } + } + if (ret != 0) { + fprintf(stderr, "Error while writing video frame\n"); + exit(1); + } + frame_count++; +} + +static void close_video(AVFormatContext *oc, AVStream *st) +{ + avcodec_close(st->codec); + av_free(picture->data[0]); + av_free(picture); + if (tmp_picture) { + av_free(tmp_picture->data[0]); + av_free(tmp_picture); + } + av_free(video_outbuf); +} + +/**************************************************************/ +/* media file output */ + +int main(int argc, char **argv) +{ + const char *filename; + AVOutputFormat *fmt; + AVFormatContext *oc; + AVStream *audio_st, *video_st; + double audio_pts, video_pts; + int i; + + /* initialize libavcodec, and register all codecs and formats */ + av_register_all(); + + if (argc != 2) { + printf("usage: %s output_file\n" + "API example program to output a media file with libavformat.\n" + "The output format is automatically guessed according to the file extension.\n" + "Raw images can also be output by using '%%d' in the filename\n" + "\n", argv[0]); + return 1; + } + + filename = argv[1]; + + /* allocate the output media context */ + avformat_alloc_output_context2(&oc, NULL, NULL, filename); + if (!oc) { + printf("Could not deduce output format from file extension: using MPEG.\n"); + avformat_alloc_output_context2(&oc, NULL, "mpeg", filename); + } + if (!oc) { + return 1; + } + fmt = oc->oformat; + + /* add the audio and video streams using the default format codecs + and initialize the codecs */ + video_st = NULL; + audio_st = NULL; + if (fmt->video_codec != CODEC_ID_NONE) { + video_st = add_video_stream(oc, fmt->video_codec); + } + if (fmt->audio_codec != CODEC_ID_NONE) { + audio_st = add_audio_stream(oc, fmt->audio_codec); + } + + av_dump_format(oc, 0, filename, 1); + + /* now that all the parameters are set, we can open the audio and + video codecs and allocate the necessary encode buffers */ + if (video_st) + open_video(oc, video_st); + if (audio_st) + open_audio(oc, audio_st); + + /* open the output file, if needed */ + if (!(fmt->flags & AVFMT_NOFILE)) { + if (avio_open(&oc->pb, filename, AVIO_FLAG_WRITE) < 0) { + fprintf(stderr, "Could not open '%s'\n", filename); + return 1; + } + } + + /* write the stream header, if any */ + av_write_header(oc); + picture->pts = 0; + for(;;) { + /* compute current audio and video time */ + if (audio_st) + audio_pts = (double)audio_st->pts.val * audio_st->time_base.num / audio_st->time_base.den; + else + audio_pts = 0.0; + + if (video_st) + video_pts = (double)video_st->pts.val * video_st->time_base.num / video_st->time_base.den; + else + video_pts = 0.0; + + if ((!audio_st || audio_pts >= STREAM_DURATION) && + (!video_st || video_pts >= STREAM_DURATION)) + break; + + /* write interleaved audio and video frames */ + if (!video_st || (video_st && audio_st && audio_pts < video_pts)) { + write_audio_frame(oc, audio_st); + } else { + write_video_frame(oc, video_st); + picture->pts++; + } + } + + /* write the trailer, if any. the trailer must be written + * before you close the CodecContexts open when you wrote the + * header; otherwise write_trailer may try to use memory that + * was freed on av_codec_close() */ + av_write_trailer(oc); + + /* close each codec */ + if (video_st) + close_video(oc, video_st); + if (audio_st) + close_audio(oc, audio_st); + + /* free the streams */ + for(i = 0; i < oc->nb_streams; i++) { + av_freep(&oc->streams[i]->codec); + av_freep(&oc->streams[i]); + } + + if (!(fmt->flags & AVFMT_NOFILE)) { + /* close the output file */ + avio_close(oc->pb); + } + + /* free the stream */ + av_free(oc); + + return 0; +} diff --git a/doc/faq.texi b/doc/faq.texi index 7c5373c437..bd88da3568 100644 --- a/doc/faq.texi +++ b/doc/faq.texi @@ -1,8 +1,8 @@ \input texinfo @c -*- texinfo -*- -@settitle Libav FAQ +@settitle FFmpeg FAQ @titlepage -@center @titlefont{Libav FAQ} +@center @titlefont{FFmpeg FAQ} @end titlepage @top @@ -11,23 +11,23 @@ @chapter General Questions -@section Why doesn't Libav support feature [xyz]? +@section Why doesn't FFmpeg support feature [xyz]? -Because no one has taken on that task yet. Libav development is +Because no one has taken on that task yet. FFmpeg development is driven by the tasks that are important to the individual developers. If there is a feature that is important to you, the best way to get it implemented is to undertake the task yourself or sponsor a developer. -@section Libav does not support codec XXX. Can you include a Windows DLL loader to support it? +@section FFmpeg does not support codec XXX. Can you include a Windows DLL loader to support it? No. Windows DLLs are not portable, bloated and often slow. -Moreover Libav strives to support all codecs natively. +Moreover FFmpeg strives to support all codecs natively. A DLL loader is not conducive to that goal. -@section I cannot read this file although this format seems to be supported by avconv. +@section I cannot read this file although this format seems to be supported by ffmpeg. -Even if avconv can read the container format, it may not support all its -codecs. Please consult the supported codec list in the avconv +Even if ffmpeg can read the container format, it may not support all its +codecs. Please consult the supported codec list in the ffmpeg documentation. @section Which codecs are supported by Windows? @@ -81,6 +81,12 @@ problem and an NP-hard problem... @chapter Usage +@section ffmpeg does not work; what is wrong? + +Try a @code{make distclean} in the ffmpeg source directory before the build. +If this does not help see +(@url{http://ffmpeg.org/bugreports.html}). + @section How do I encode single pictures into movies? First, rename your pictures to follow a numerical sequence. @@ -88,7 +94,7 @@ For example, img1.jpg, img2.jpg, img3.jpg,... Then you may run: @example - avconv -f image2 -i img%d.jpg /tmp/a.mpg + ffmpeg -f image2 -i img%d.jpg /tmp/a.mpg @end example Notice that @samp{%d} is replaced by the image number. @@ -111,17 +117,17 @@ If you want to sequence them by oldest modified first, substitute Then run: @example - avconv -f image2 -i /tmp/img%03d.jpg /tmp/a.mpg + ffmpeg -f image2 -i /tmp/img%03d.jpg /tmp/a.mpg @end example -The same logic is used for any image format that avconv reads. +The same logic is used for any image format that ffmpeg reads. @section How do I encode movie to single pictures? Use: @example - avconv -i movie.mpg movie%d.jpg + ffmpeg -i movie.mpg movie%d.jpg @end example The @file{movie.mpg} used as input will be converted to @@ -137,7 +143,7 @@ to force the encoding. Applying that to the previous example: @example - avconv -i movie.mpg -f image2 -c:v mjpeg menu%d.jpg + ffmpeg -i movie.mpg -f image2 -c:v mjpeg menu%d.jpg @end example Beware that there is no "jpeg" codec. Use "mjpeg" instead. @@ -156,12 +162,12 @@ Use @file{-} as file name. Try '-f image2 test%d.jpg'. -@section Why can I not change the framerate? +@section Why can I not change the frame rate? -Some codecs, like MPEG-1/2, only allow a small number of fixed framerates. +Some codecs, like MPEG-1/2, only allow a small number of fixed frame rates. Choose a different codec with the -c:v command line option. -@section How do I encode Xvid or DivX video with avconv? +@section How do I encode Xvid or DivX video with ffmpeg? Both Xvid and DivX (version 4+) are implementations of the ISO MPEG-4 standard (note that there are many other coding formats that use this @@ -182,14 +188,14 @@ things to try: '-bf 2', '-flags qprd', '-flags mv0', '-flags skiprd'. but beware the '-g 100' might cause problems with some decoders. Things to try: '-bf 2', '-flags qprd', '-flags mv0', '-flags skiprd. -@section Interlaced video looks very bad when encoded with avconv, what is wrong? +@section Interlaced video looks very bad when encoded with ffmpeg, what is wrong? You should use '-flags +ilme+ildct' and maybe '-flags +alt' for interlaced material, and try '-top 0/1' if the result looks really messed-up. @section How can I read DirectShow files? -If you have built Libav with @code{./configure --enable-avisynth} +If you have built FFmpeg with @code{./configure --enable-avisynth} (only possible on MinGW/Cygwin platforms), then you may use any file that DirectShow can read as input. @@ -197,9 +203,9 @@ Just create an "input.avs" text file with this single line ... @example DirectShowSource("C:\path to your file\yourfile.asf") @end example -... and then feed that text file to avconv: +... and then feed that text file to ffmpeg: @example - avconv -i input.avs + ffmpeg -i input.avs @end example For ANY other help on Avisynth, please visit the @@ -216,10 +222,10 @@ equally humble @code{copy} under Windows), and finally transcoding back to your format of choice. @example -avconv -i input1.avi -same_quant intermediate1.mpg -avconv -i input2.avi -same_quant intermediate2.mpg +ffmpeg -i input1.avi -same_quant intermediate1.mpg +ffmpeg -i input2.avi -same_quant intermediate2.mpg cat intermediate1.mpg intermediate2.mpg > intermediate_all.mpg -avconv -i intermediate_all.mpg -same_quant output.avi +ffmpeg -i intermediate_all.mpg -same_quant output.avi @end example Notice that you should either use @code{-same_quant} or set a reasonably high @@ -232,10 +238,10 @@ of named pipes, should your platform support it: @example mkfifo intermediate1.mpg mkfifo intermediate2.mpg -avconv -i input1.avi -same_quant -y intermediate1.mpg < /dev/null & -avconv -i input2.avi -same_quant -y intermediate2.mpg < /dev/null & +ffmpeg -i input1.avi -same_quant -y intermediate1.mpg < /dev/null & +ffmpeg -i input2.avi -same_quant -y intermediate2.mpg < /dev/null & cat intermediate1.mpg intermediate2.mpg |\ -avconv -f mpeg -i - -same_quant -c:v mpeg4 -acodec libmp3lame output.avi +ffmpeg -f mpeg -i - -same_quant -c:v mpeg4 -acodec libmp3lame output.avi @end example Similarly, the yuv4mpegpipe format, and the raw video, raw audio codecs also @@ -254,13 +260,13 @@ mkfifo temp2.a mkfifo temp2.v mkfifo all.a mkfifo all.v -avconv -i input1.flv -vn -f u16le -acodec pcm_s16le -ac 2 -ar 44100 - > temp1.a < /dev/null & -avconv -i input2.flv -vn -f u16le -acodec pcm_s16le -ac 2 -ar 44100 - > temp2.a < /dev/null & -avconv -i input1.flv -an -f yuv4mpegpipe - > temp1.v < /dev/null & -@{ avconv -i input2.flv -an -f yuv4mpegpipe - < /dev/null | tail -n +2 > temp2.v ; @} & +ffmpeg -i input1.flv -vn -f u16le -acodec pcm_s16le -ac 2 -ar 44100 - > temp1.a < /dev/null & +ffmpeg -i input2.flv -vn -f u16le -acodec pcm_s16le -ac 2 -ar 44100 - > temp2.a < /dev/null & +ffmpeg -i input1.flv -an -f yuv4mpegpipe - > temp1.v < /dev/null & +@{ ffmpeg -i input2.flv -an -f yuv4mpegpipe - < /dev/null | tail -n +2 > temp2.v ; @} & cat temp1.a temp2.a > all.a & cat temp1.v temp2.v > all.v & -avconv -f u16le -acodec pcm_s16le -ac 2 -ar 44100 -i all.a \ +ffmpeg -f u16le -acodec pcm_s16le -ac 2 -ar 44100 -i all.a \ -f yuv4mpegpipe -i all.v \ -same_quant -y output.flv rm temp[12].[av] all.[av] @@ -268,7 +274,7 @@ rm temp[12].[av] all.[av] @section -profile option fails when encoding H.264 video with AAC audio -@command{avconv} prints an error like +@command{ffmpeg} prints an error like @example Undefined constant or missing '(' in 'baseline' @@ -283,16 +289,16 @@ video and audio. Specifically the AAC encoder also defines some profiles, none of which are named @var{baseline}. The solution is to apply the @option{-profile} option to the video stream only -by using @url{http://libav.org/avconv.html#Stream-specifiers-1, Stream specifiers}. +by using @url{http://ffmpeg.org/ffmpeg.html#Stream-specifiers-1, Stream specifiers}. Appending @code{:v} to it will do exactly that. @chapter Development -@section Are there examples illustrating how to use the Libav libraries, particularly libavcodec and libavformat? +@section Are there examples illustrating how to use the FFmpeg libraries, particularly libavcodec and libavformat? -Yes. Read the Developers Guide of the Libav documentation. Alternatively, +Yes. Read the Developers Guide of the FFmpeg documentation. Alternatively, examine the source code for one of the many open source projects that -already incorporate Libav at (@url{projects.html}). +already incorporate FFmpeg at (@url{projects.html}). @section Can you support my C compiler XXX? @@ -303,14 +309,14 @@ with @code{#ifdef}s related to the compiler. @section Is Microsoft Visual C++ supported? No. Microsoft Visual C++ is not compliant to the C99 standard and does -not - among other things - support the inline assembly used in Libav. +not - among other things - support the inline assembly used in FFmpeg. If you wish to use MSVC++ for your project then you can link the MSVC++ code with libav* as long as you compile the latter with a working C compiler. For more information, see -the @emph{Microsoft Visual C++ compatibility} section in the Libav +the @emph{Microsoft Visual C++ compatibility} section in the FFmpeg documentation. -There have been efforts to make Libav compatible with MSVC++ in the +There have been efforts to make FFmpeg compatible with MSVC++ in the past. However, they have all been rejected as too intrusive, especially since MinGW does the job adequately. None of the core developers work with MSVC++ and thus this item is low priority. Should you find @@ -318,46 +324,78 @@ the silver bullet that solves this problem, feel free to shoot it at us. We strongly recommend you to move over from MSVC++ to MinGW tools. -@section Can I use Libav under Windows? +@section Can I use FFmpeg or libavcodec under Windows? -Yes, but the Cygwin or MinGW tools @emph{must} be used to compile Libav. -Read the @emph{Windows} section in the Libav documentation to find more +Yes, but the Cygwin or MinGW tools @emph{must} be used to compile FFmpeg. +Read the @emph{Windows} section in the FFmpeg documentation to find more information. +To get help and instructions for building FFmpeg under Windows, check out +the FFmpeg Windows Help Forum at +@url{http://ffmpeg.arrozcru.org/}. + @section Can you add automake, libtool or autoconf support? No. These tools are too bloated and they complicate the build. -@section Why not rewrite Libav in object-oriented C++? +@section Why not rewrite FFmpeg in object-oriented C++? -Libav is already organized in a highly modular manner and does not need to +FFmpeg is already organized in a highly modular manner and does not need to be rewritten in a formal object language. Further, many of the developers favor straight C; it works for them. For more arguments on this matter, read @uref{http://www.tux.org/lkml/#s15, "Programming Religion"}. +@section Why are the ffmpeg programs devoid of debugging symbols? + +The build process creates ffmpeg_g, ffplay_g, etc. which contain full debug +information. Those binaries are stripped to create ffmpeg, ffplay, etc. If +you need the debug information, use the *_g versions. + @section I do not like the LGPL, can I contribute code under the GPL instead? Yes, as long as the code is optional and can easily and cleanly be placed -under #if CONFIG_GPL without breaking anything. So for example a new codec +under #if CONFIG_GPL without breaking anything. So, for example, a new codec or filter would be OK under GPL while a bug fix to LGPL code would not. -@section I'm using Libav from within my C++ application but the linker complains about missing symbols which seem to be available. +@section I'm using FFmpeg from within my C++ application but the linker complains about missing symbols which seem to be available. -Libav is a pure C project, so to use the libraries within your C++ application +FFmpeg is a pure C project, so to use the libraries within your C++ application you need to explicitly state that you are using a C library. You can do this by -encompassing your Libav includes using @code{extern "C"}. +encompassing your FFmpeg includes using @code{extern "C"}. See @url{http://www.parashift.com/c++-faq-lite/mixing-c-and-cpp.html#faq-32.3} @section I'm using libavutil from within my C++ application but the compiler complains about 'UINT64_C' was not declared in this scope -Libav is a pure C project using C99 math features, in order to enable C++ +FFmpeg is a pure C project using C99 math features, in order to enable C++ to use them you have to append -D__STDC_CONSTANT_MACROS to your CXXFLAGS @section I have a file in memory / a API different from *open/*read/ libc how do I use it with libavformat? You have to implement a URLProtocol, see @file{libavformat/file.c} in -Libav and @file{libmpdemux/demux_lavf.c} in MPlayer sources. +FFmpeg and @file{libmpdemux/demux_lavf.c} in MPlayer sources. + +@section Where can I find libav* headers for Pascal/Delphi? + +see @url{http://www.iversenit.dk/dev/ffmpeg-headers/} + +@section Where is the documentation about ffv1, msmpeg4, asv1, 4xm? + +see @url{http://www.ffmpeg.org/~michael/} + +@section How do I feed H.263-RTP (and other codecs in RTP) to libavcodec? + +Even if peculiar since it is network oriented, RTP is a container like any +other. You have to @emph{demux} RTP before feeding the payload to libavcodec. +In this specific case please look at RFC 4629 to see how it should be done. + +@section AVStream.r_frame_rate is wrong, it is much larger than the frame rate. + +r_frame_rate is NOT the average frame rate, it is the smallest frame rate +that can accurately represent all timestamps. So no, it is not +wrong if it is larger than the average! +For example, if you have mixed 25 and 30 fps content, then r_frame_rate +will be 150. @section Why is @code{make fate} not running all tests? diff --git a/doc/fate.texi b/doc/fate.texi index 9141eeb543..acb4bfe6a1 100644 --- a/doc/fate.texi +++ b/doc/fate.texi @@ -5,131 +5,170 @@ @center @titlefont{FATE Automated Testing Environment} @end titlepage +@node Top @top @contents @chapter Introduction -FATE provides a regression testsuite embedded within the Libav build system. -It can be run locally and optionally configured to send reports to a web -aggregator and viewer @url{http://fate.libav.org}. + FATE is an extended regression suite on the client-side and a means +for results aggregation and presentation on the server-side. -It is advised to run FATE before submitting patches to the current codebase -and provide new tests when submitting patches to add additional features. + The first part of this document explains how you can use FATE from +your FFmpeg source directory to test your ffmpeg binary. The second +part describes how you can run FATE to submit the results to FFmpeg's +FATE server. -@chapter Running FATE + In any way you can have a look at the publicly viewable FATE results +by visiting this website: -@section Samples and References -In order to run, FATE needs a large amount of data (samples and references) -that is provided separately from the actual source distribution. + @url{http://fate.ffmpeg.org/} -To inform the build system about the testsuite location, pass -@option{--samples=<path to the samples>} to @command{configure} or set the -@var{SAMPLES} Make variable or the @var{FATE_SAMPLES} environment variable -to a suitable value. + This is especially recommended for all people contributing source +code to FFmpeg, as it can be seen if some test on some platform broke +with there recent contribution. This usually happens on the platforms +the developers could not test on. -The dataset is available through @command{rsync}, is possible to fetch -the current sample using the straight rsync command or through a specific -@ref{Makefile target}. + The second part of this document describes how you can run FATE to +submit your results to FFmpeg's FATE server. If you want to submit your +results be sure to check that your combination of CPU, OS and compiler +is not already listed on the above mentioned website. + + In the third part you can find a comprehensive listing of FATE makefile +targets and variables. + + +@chapter Using FATE from your FFmpeg source directory + + If you want to run FATE on your machine you need to have the samples +in place. You can get the samples via the build target fate-rsync. +Use this command from the top-level source directory: + +@example +make fate-rsync SAMPLES=fate-suite/ +make fate SAMPLES=fate-suite/ +@end example + + The above commands set the samples location by passing a makefile +variable via command line. It is also possible to set the samples +location at source configuration time by invoking configure with +`--samples=<path to the samples directory>'. Afterwards you can +invoke the makefile targets without setting the SAMPLES makefile +variable. This is illustrated by the following commands: @example -# rsync -aL rsync://fate-suite.libav.org/fate-suite/ fate-suite +./configure --samples=fate-suite/ +make fate-rsync +make fate @end example + Yet another way to tell FATE about the location of the sample +directory is by making sure the environment variable FATE_SAMPLES +contains the path to your samples directory. This can be achieved +by e.g. putting that variable in your shell profile or by setting +it in your interactive session. + @example -# make fate-rsync SAMPLES=fate-suite +FATE_SAMPLES=fate-suite/ make fate @end example +@float NOTE +Do not put a '~' character in the samples path to indicate a home +directory. Because of shell nuances, this will cause FATE to fail. +@end float + + +@chapter Submitting the results to the FFmpeg result aggregation server + + To submit your results to the server you should run fate through the +shell script tests/fate.sh from the FFmpeg sources. This script needs +to be invoked with a configuration file as its first argument. + +@example +tests/fate.sh /path/to/fate_config +@end example + + A configuration file template with comments describing the individual +configuration variables can be found at @file{tests/fate_config.sh.template}. + +@ifhtml + The mentioned configuration template is also available here: +@verbatiminclude ../tests/fate_config.sh.template +@end ifhtml + + Create a configuration that suits your needs, based on the configuration +template. The `slot' configuration variable can be any string that is not +yet used, but it is suggested that you name it adhering to the following +pattern <arch>-<os>-<compiler>-<compiler version>. The configuration file +itself will be sourced in a shell script, therefore all shell features may +be used. This enables you to setup the environment as you need it for your +build. + + For your first test runs the `fate_recv' variable should be empty or +commented out. This will run everything as normal except that it will omit +the submission of the results to the server. The following files should be +present in $workdir as specified in the configuration file: + +@itemize + @item configure.log + @item compile.log + @item test.log + @item report + @item version +@end itemize + + When you have everything working properly you can create an SSH key and +send its public part to the FATE server administrator. + + Configure your SSH client to use public key authentication with that key +when connecting to the FATE server. Also do not forget to check the identity +of the server and to accept its host key. This can usually be achieved by +running your SSH client manually and killing it after you accepted the key. +The FATE server's fingerprint is: + + b1:31:c8:79:3f:04:1d:f8:f2:23:26:5a:fd:55:fa:92 -@chapter Manual Run -FATE regression test can be run through @command{make}. -Specific Makefile targets and Makefile variables are available: + The only thing left is to automate the execution of the fate.sh script and +the synchronisation of the samples directory. + + +@chapter FATE makefile targets and variables + +@section Makefile targets -@anchor{Makefile target} -@section FATE Makefile targets @table @option -@item fate-list -List all fate/regression test targets. @item fate-rsync -Shortcut to download the fate test samples to the specified testsuite location. + Download/synchronize sample files to the configured samples directory. + +@item fate-list + Will list all fate/regression test targets. + @item fate -Run the FATE test suite (requires the fate-suite dataset). + Run the FATE test suite (requires the fate-suite dataset). @end table -@section Fate Makefile variables +@section Makefile variables + @table @option @item V -Verbosity level, can be set to 0, 1 or 2. -@table @option - @item 0 - show just the test arguments - @item 1 - show just the command used in the test - @item 2 - show everything -@end table + Verbosity level, can be set to 0, 1 or 2. + @itemize + @item 0: show just the test arguments + @item 1: show just the command used in the test + @item 2: show everything + @end itemize + @item SAMPLES -Specify or override the path to the FATE samples at make time, it has a -meaning only while running the regression tests. + Specify or override the path to the FATE samples at make time, it has a + meaning only while running the regression tests. + @item THREADS -Specify how many threads to use while running regression tests, it is -quite useful to detect thread-related regressions. + Specify how many threads to use while running regression tests, it is + quite useful to detect thread-related regressions. @end table +Example: @example - make V=1 SAMPLES=/var/fate/samples THREADS=2 fate +make V=1 SAMPLES=/var/fate/samples THREADS=2 fate @end example - -@chapter Automated Tests -In order to automatically testing specific configurations, e.g. multiple -compilers, @command{tests/fate.sh} is provided. - -This shell script builds Libav, runs the regression tests and prepares a -report that can be sent to @url{fate.libav.org} or directly examined locally. - -@section Testing Profiles -The configuration file passed to @command{fate.sh} is shell scripts as well. - -It must provide at least a @var{slot} identifier, the @var{repo} from -which fetch the sources, the @var{samples} directory, a @var{workdir} with -enough space to build and run all the tests. -Optional submit command @var{fate_recv} and a @var{comment} to describe -the testing profile are available. - -Additional optional parameter to tune the Libav building and reporting process -can be passed. - -@example -slot= # some unique identifier -repo=git://git.libav.org/libav.git # the source repository -samples=/path/to/fate/samples -workdir= # directory in which to do all the work -fate_recv="ssh -T fate@@fate.libav.org" # command to submit report -comment= # optional description - -# the following are optional and map to configure options -arch= -cpu= -cross_prefix= -cc= -target_os= -sysroot= -target_exec= -target_path= -extra_cflags= -extra_ldflags= -extra_libs= -extra_conf= # extra configure options not covered above - -#make= # name of GNU make if not 'make' -makeopts= # extra options passed to 'make' -#tar= # command to create a tar archive from its arguments on - # stdout, defaults to 'tar c' -@end example - -@section Submitting Reports -In order to send reports you need to create an @command{ssh} key and send it -to @email{root@@libav.org}. -The current server fingerprint is @var{a4:99:d7:d3:1c:92:0d:56:d6:d5:61:be:01:ae:7d:e6} - diff --git a/doc/ffmpeg-mt-authorship.txt b/doc/ffmpeg-mt-authorship.txt new file mode 100644 index 0000000000..d8c405f948 --- /dev/null +++ b/doc/ffmpeg-mt-authorship.txt @@ -0,0 +1,4561 @@ +This file lists authorship of commits that have been merged from +ffmpeg-mt. These commits where not classically merged because this +would have pulled in duplicated history of all commits in ffmpeg. +Which a majority of developers opposed. + + +commit 002a0939cdf01faa8270d41b3045c08ac12d8975 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Feb 20 20:24:36 2010 -0500 + + Update todo + +commit 0040d6f2ba7189ca9bab4cf17c0d150416391dec +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jan 24 18:33:16 2010 -0500 + + Remove a malloc() per frame by keeping an array of 32 buffers. + + Requested in original review. Should be slightly faster but does + have a 32-element linear search (since buffers are freed out of order). + + Introducing array_next_nonzero or something would speed up this + and h264 decoding. + +commit 00425e98fba903dceecb89763b57b8f3b7a1abf3 +Merge: 20997d6 e320c22 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jul 2 04:59:42 2009 -0400 + + Merge mainline. + + Having to move the setting of key_frame confused me for far too + long. + +commit 0097d3b01e33d1e0f636a19778a0435a730d4590 +Merge: 9e981c8 44c4fd1 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Sep 9 19:19:34 2010 -0400 + + Merge mainline and libswscale. + + Another one coming after h264 is converted to yasm. + + Conflicts: + libavcodec/avcodec.h + +commit 00bbca77f3fe0960cbf0986ea214ce022204837c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jan 16 02:18:12 2011 -0500 + + h264: Early-exit condition for await_references() + + Saves even more zero checking in refs[][], although it still leaves many + useless checks when nrefs[i]>1, because the array indexes are scattered. + + About ~.8% faster decoding. + +commit 00c4b0bb5a7801d14627015d38762ec314639d3d +Merge: 63d086d feadf1b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Mar 13 23:50:33 2009 -0400 + + Merge mainline. + + Conflicts: + libavcodec/avcodec.h + libavcodec/h263.c + libavcodec/h263dec.c + libavcodec/h264.c + libavcodec/mpeg12.c + libavcodec/mpegvideo.c + libavcodec/options.c + libavutil/log.c + +commit 01006069782b1b8fe0bfe0eabe4876062e057c11 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Jan 13 01:30:01 2009 -0500 + + Fix possibly not allocating obmc_scratchpad with PAFF/weighted prediction + +commit 011a76824f384a315ce4b0474a2811d463b5746b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Sep 1 00:40:40 2008 -0400 + + Whitespace and variable name cosmetics for clarity. + +commit 02376cec6531a931330798af67c62a029a3435a1 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 11 14:40:27 2009 -0700 + + Normalize how decode_postinit() is called. + + Move it next to the hwaccel call to save an if statement. + +commit 031abc50708c616058020dcf7a1b62bc9b895446 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Aug 22 20:43:38 2008 -0400 + + Improve comments in thread.h + +commit 032432ad56fd88a7e9ba6ce9ccd39925854b027a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Feb 20 20:48:10 2010 -0500 + + Remove FF_THREAD_DEFAULT. + + It obviously makes no sense to define the default in a public header. + +commit 03980f22907206b52e64439ebcc4445719801035 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Jul 11 17:22:22 2008 -0400 + + Mark functions inline to avoid unused function warnings. + +commit 0488ed2d9ff609ec4a6be008c81603b62ce67785 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Jun 4 15:55:00 2008 -0400 + + Align the stack in decode_frame_thread. + +commit 0553196aa797d58f0687890c66e1b1cdfa52f419 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed May 28 00:44:13 2008 -0400 + + Add the frame-threading support code. + +commit 056dce6c969acec1224eaa9fc73d930d1e56b299 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Aug 15 16:44:33 2008 -0400 + + h264: Redo finding the output frame during header parsing after merging mainline. + + This works with PAFF and CODEC_FLAG2_CHUNKS, though the second is useless and should be removed. + +commit 05a3af85edd15fef223f0376d3241cc5c7aa3ed5 +Merge: 8ba50a9 fa43cf8 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Apr 19 02:41:54 2010 -0400 + + Merge mainline. + + Conflicts: + libavcodec/avcodec.h + libavcodec/h264.c + +commit 05e37cada02dc1ac58e7ce93418cbf33e3a09ad6 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue May 27 21:00:34 2008 -0400 + + Add the AVCodec/AVCodecContext fields needed for multithreading and increment the API minor version. + +commit 061586a260a564080be8c1ed9af4e83888fe3543 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Sep 4 01:41:53 2008 -0400 + + Remove error check that can never fail. + +commit 06407ff8706c7fe28c5b925c4b1dd52641714cb9 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jun 16 18:21:04 2008 -0400 + + Multithreading support for MPEG-1. + +commit 065ee0d04a6539c08bddfa1edc628906494c22f2 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Nov 1 12:24:37 2010 -0400 + + vp3: Report INT_MAX instead of height at the end of a frame + + This saves having to clip to height in await_reference_row. + +commit 067c30c63499d5cca5613725de936fb70047aec3 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jun 22 03:29:23 2008 -0400 + + Cosmetics: opening function braces on their own line. + +commit 06ac5ac98dbf03889eb7cccf67fe0cb95615613d +Merge: febe154 987789a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jun 20 04:29:03 2010 -0700 + + Merge mainline. + + Document ONLY_IF_THREADS_ENABLED along the way. + + Conflicts: + libavutil/internal.h + +commit 07474003407915e5462ed3582a1dae8baa06f296 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Jun 10 11:25:48 2009 -0700 + + Move frame_thread_init() down to avoid prototyping its callees. + +commit 076bf916d79c39ec055a53f2ee5eadf20c21b988 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Aug 25 14:32:41 2008 -0400 + + Increase max delayed buffers for safety + +commit 079cd64ef92cb1670a420a16e38c645cc8f28caa +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Sep 2 11:38:29 2008 -0400 + + Ignore codecs returning NULL when draining frames. + +commit 090c1f4c99b9c5cefa3bad7698f33516baa87c6e +Author: benoit <benoit@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Tue Nov 6 13:08:04 2007 +0000 + + fix predictor initialization for adpcm-ima encoder not to lose first sample + in block in adpcm-ima decoder + Patch by Timofei V. Bondarenko: tim commit 09bb0dafa746203f98ff478a5121b3b0ffb3f46e +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Jul 22 22:20:47 2008 -0400 + + Switch from MB row to pixel row precision for h264 progress. + + This makes it easier to think about interlacing and the deblock filter, and also fixes decoding entirely. + +commit 0a51c1e9ebf09d302e44daaca3147e7cca2f0457 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Jun 3 16:04:31 2008 -0400 + + Use threading macros in mpeg12.c. + +commit 0ac282b447075a0645036fba56d2881bbcc8f471 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jan 17 03:44:26 2011 -0500 + + Update multithreading.txt for thread_safe_callbacks and pkt_dts + +commit 0b64ceb6b15560313d0a6ac7cffe9270d7b8e0e8 +Merge: 9ec9f08 e220e91 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 10 03:22:51 2010 -0700 + + Merge mainline. + + Conflicts: + libavcodec/avcodec.h + +commit 0b8add0862f841dfc8dbbc8d89dfb3712ce3a698 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Aug 18 16:47:21 2008 -0400 + + Allow avcodec_default_release_buffer to be called after avcodec_default_free_buffers. + +commit 0b8c3d23339b5f646ae702f30141e223596f9ff9 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jul 27 21:55:53 2008 -0400 + + Reindent. + +commit 0be0d5714347f63b0e391ad3e9202f9d5107bb5f +Merge: f550857 8c00628 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Mar 28 03:40:27 2010 -0400 + + Merge mainline. + +commit 0c73945d0cc40a6ade8ca78dfa0d9bea178f4743 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 19 01:07:17 2008 -0400 + + Clarify comment for new AVFrame members + + They are set by libavcodec even if they aren't used for anything useful ATM. + +commit 0cac0f3bd81287db20bbbae5aaff22e381e09663 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jul 13 02:40:22 2008 -0400 + + Add report/await_decode_progress for progressive H264 + Multithreading works with no visible problems for progressive sequences, but there is still some problem causing framecrc differences. + 1 thread - 99% cpu 14s + 2 threads - 183% cpu 8.6s + +commit 0cae6d85e8a33b826611ced69902f2a4d16f0c7a +Author: benoit <benoit@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Fri Jun 1 12:03:33 2007 +0000 + + A bit more clear FAQ 1.2 + Patch by V +�commit 0d25fc9993407335bc98b91296f9f78b634dd8a0 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Jun 24 21:39:39 2008 -0400 + + Remove newly-duplicated memset(). + +commit 0e41f7596f06a758c0f1cb9e48e67ef896c5c05a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Jul 11 18:09:02 2008 -0400 + + Reindent. + +commit 0ef99ed28b24757a30b1e805f2ff1ea6d90b9b71 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jan 25 03:17:46 2010 -0500 + + Remove item from todo + +commit 0fad6cca0a7e34dfa62c3934eb5316e2c9649e66 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Jul 22 01:00:07 2008 -0400 + + Fix height passed to ff_draw_band for interlaced H.264. + + Without this, it passes y 0 h 16, y 32 h 16, etc. + +commit 0fb994fbdbf4f985ec9c0d5a681e7a5bf620a765 +Merge: 5eb0c64 ace7af3 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Jan 20 01:58:15 2010 -0500 + + Merge mainline. + + This was done by hand since git can't track the h264/h263 decoder + splits properly. + + Conflicts: + libavcodec/avcodec.h + libavcodec/h263.c + libavcodec/h263dec.c + libavcodec/h264.c + +commit 0ff629947b15955603cdb7978770ca64c2323262 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 18 05:09:01 2009 -0400 + + Don't call report_field_progress for non-referenced H264 frames. + +commit 111fa56db1bfefc245c499f465783a5abc04f7c2 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jul 19 00:12:00 2008 -0400 + + Set start/end_mb_y properly in MpegEncContext. + +commit 115adc279240b6c7155781b5a16177a140eaad4f +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jun 21 23:10:18 2008 -0400 + + Add an update_context for codecs that just use MpegEncContext. + +commit 116ca147f03ca02b55c2fceef7b82c1b251b32f6 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 16 14:10:31 2008 -0400 + + Merge fallout: move AVCodec additions back to the end of the struct + +commit 11b1a8ee92128524a3259903c28da54ffd9a60fa +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun May 30 10:02:16 2010 -0700 + + Update todo. + + I appear to have fixed the bug (the problem doesn't show in test.sh + anymore). Of course, there might be more. + +commit 120d790a3918f77444eed295aec6d8c34e4b532a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jul 17 18:00:07 2008 -0400 + + Simplify draw_edges changes and handle interlacing properly. + +commit 1239bcba12d0c57005ae59405e8b080ac3c7bd65 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Aug 18 18:59:29 2008 -0400 + + Simplify: store FrameThreadContext in the user's context. + +commit 1292a1840bb5319f1438b63b7be35363ba4fe5b6 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Jan 13 01:33:47 2009 -0500 + + Copy width/height between thread contexts for all codecs. + + This makes it user-visible and fixes compatibility with + bad demuxers that don't set it in avctx. + +commit 12c5de8ead7c7a1b4c03eb095a2db4357aa2538d +Author: benoit <benoit@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Thu Jan 3 08:39:38 2008 +0000 + + Make filterDelimiters and optionDelimiters two static constant array of + characters, should move them to .rodata. + Patch by Diego 'Flameeyes' Petten +� flameeyes commit 1327c17ca423f248dbce8172476dd69208f7d74b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat May 23 21:52:24 2009 -0400 + + Stopgap hack: don't crash with size-changing streams+frame threads + + MPEG1 and H.264 need their own checks, otherwise they immediately + deallocate shared data and crash. Another check is added to get_buffer + to cover remaining codecs (although it may not actually do this). + + This currently involves ugly code duplication, which can hopefully + be eventually removed. Unfortunately this is already not handled + well on mainline (such as in the previous commit). + +commit 138ec8aad228862d58582aa4bbd367b7fa7b8d81 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jul 24 16:06:17 2008 -0400 + + Factor out copying picture pointers in update_context. + +commit 13c48792ac24329c9055f6e98b5e61c278f1aa57 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Mar 9 00:02:20 2010 -0500 + + Fix wrong timestamps with -threads 2 and BBB 1080p Theora + + It was caused by adding thread delay to has_b_frames. + -threads 2 -> has_b_frames 1 -> "delay==1" is true and the + "invalid dts/pts combination" was triggered. Not sure about this fix, + but I think it's harmless. + +commit 141516ca4f2b0008539ceeb70b46ebb6cfe4a1c0 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jun 15 17:44:29 2008 -0400 + + Cosmetics: use USE_ macro. + +commit 14476d56276a77a237834e88b28427fe491ac689 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 16 14:11:41 2008 -0400 + + Correct AVCodec member comments + +commit 14bdf768314413a099fe570891761360733b148c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Mar 9 01:15:03 2010 -0500 + + Update sws. + +commit 14df94ceacecf041d33b8600bc9097d4befd79dd +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Feb 14 23:57:37 2010 -0500 + + Add a convenience function for avoiding deadlocks with decoder errors + +commit 156f6ba4db96f57c3c105b71986acaa9be13d5ab +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Aug 17 00:19:10 2008 -0400 + + Update todo + +commit 16343b25d2ffc7c18a00ec62db8e76d7f8217de5 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Feb 20 22:39:05 2010 -0500 + + Rewrite comments for new codec callbacks + +commit 16b71c003150c3a44135ffa1bbc870ea43c15f7a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Dec 18 14:37:04 2008 -0500 + + Some todo entries I forgot to add + +commit 16bde8c7df438f5283de102e3c872ef309a8d0b5 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 5 00:11:43 2008 -0400 + + Implement avcodec_flush_buffers for multithreaded codecs. + +commit 17b3c2a080f7ec1f548494e0e2b905ad0e2690c0 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Aug 18 20:36:54 2008 -0400 + + Clarify use of is_copy + +commit 17d7a98c7aadc2be1ceadf875ae2ca71b08a5611 +Merge: 0097d3b 981f8d0 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Sep 29 22:55:44 2010 -0400 + + Merge mainline. + + Fix misplaced lowres check from previous merge. (or maybe it was fine?) + + Conflicts: + libavcodec/avcodec.h + libavcodec/utils.c + +commit 17dcbec74c0630e44029dd5e4efd8f9bb2ddee13 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Jul 24 16:51:14 2009 -0400 + + Fix typo in huffyuv, broke mt decoding with newer huffyuv versions. + +commit 17ef916da54e5cbaf2ce97cba565ba4730dcd847 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue May 11 14:39:44 2010 -0400 + + Cosmetics: remove stray spaces in pthread.c + +commit 1846cc0549bf3d45fb2a5a2152b7335c794146e8 +Merge: 5323bc6 cd23ede +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Mar 8 04:30:32 2010 -0500 + + Merge mainline. + + The VP3 decoder has been heavily changed upstream and this commit + removes mt optimizations. They will be readded later. + + Conflicts: + libavcodec/avcodec.h + libavcodec/h264.c + libavcodec/h264.h + libavcodec/h264_direct.c + libavcodec/vp3.c + +commit 1878dce0e65b2fab94612c950fac51e3de741636 +Merge: b7d1826 2b13612 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun May 24 01:37:21 2009 -0400 + + Merge mainline. + +commit 1884de3ffb775bb23cbfbf977ea48841c2b2ae16 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri May 8 00:15:50 2009 -0400 + + Correct comment about decoding delay. + +commit 18893e1423c3d8a65ca753806638ac160fefe342 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Oct 23 18:13:56 2010 -0400 + + Add a -vsync test to test.sh. + + The files x-1-vsync.txt and x-3-vsync.txt should have the same MD5. + Even more ideally, all files should have the same MD5, but it's not our problem if they don't. + + h264 and theora pass, didn't test others. + +commit 18dc6b6010200c45827d14594a5d7b7b2b28d8e0 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Aug 6 20:31:04 2008 -0400 + + Move ff_frame_thread_init above its uses and make it static since it has only one caller. + +commit 190d65b24795208e30c06369e34769ffeb9b5cc8 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Aug 24 01:31:00 2008 -0400 + + Add a longer comment for update_context + +commit 19b159260eb5eddfd296cac179d59ba218f881ac +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Jan 21 01:22:43 2011 -0500 + + Adopt pkt_pts/pkt_dts in lavc clients + + This makes DTS reliable with threads. + +commit 1a0d8d0cd0d7d0dc44d1747b2c8c93c73bc09cd8 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jan 4 03:59:20 2010 -0500 + + Note in todo that 'make test' doesn't pass ATM. + + Also note a harmless warning emitted, which I haven't + though of a good fix for yet. + +commit 1a216093ed2f201814287a32b5d8f22781c6d8d1 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Aug 25 01:02:29 2008 -0400 + + Comment another strange line + +commit 1a4740fed38a69202c762e3cd786dd3c7c23dd40 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jan 15 17:02:46 2011 -0500 + + Make ARM asm #error out, since the offset values are out of date here + +commit 1ac02d2ff0dd39d8baf68cf7e0490de4db9b88cc +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Jul 10 14:24:40 2009 -0400 + + Fix the error in avcodec_thread_init to actually not do anything. + +commit 1b735c493b0fe8c1aaff3d06214c24e8556b111c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Aug 25 14:40:54 2008 -0400 + + Remove some context variable copies which were overwriting user settings + +commit 1b755181905bed35b2edd723c137b8f0af9c31c3 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 23 23:14:20 2008 -0400 + + Add a FIXME for PAFF + +commit 1c187ba01c332b3d99681cfffb90f0247a836303 +Merge: 8022069 0309093 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Nov 15 05:32:06 2010 -0500 + + Merge mainline. + + Conflicts: + doc/APIchanges + libavcodec/avcodec.h + +commit 1c39407876cb6689e313ce27a51d83d77ac0c4e4 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun May 23 03:40:43 2010 -0400 + + Fix crash with ffplay. + + Caused by the buffer functions being changed after codec init. + +commit 1c70dfb14a5e6e322f66d1175045eb13ac96d2f8 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Feb 20 22:10:38 2010 -0500 + + Rewrite thread.h comments for clarity + +commit 1c8037ec029ffe790b39b0cf0e67468db5f8c4a8 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jan 25 03:59:02 2010 -0500 + + Fix references to renamed avail_motion() in the todo. + + Delete the second entry mentioning it, since I don't think it's a + good idea anymore. + +commit 1ca44079c06a2080c2a0deb9cbc8fa757a5be540 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jun 15 20:34:08 2008 -0400 + + Delete unused variables. The frame counters will stay around for now for debugging. + +commit 1d15df4fd2b4583d56159a7938ef3699c7f46261 +Merge: 8f759fa b3b80f1 +Author: Luca Barbato <lu_zero@gentoo.org> +Date: Sat May 31 17:56:44 2008 +0200 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit 1da82befe53bc245ba94cf1012fcd0156040353c +Author: benoit <benoit@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Mon Jan 7 12:40:39 2008 +0000 + + Remove unused symbol. + + Patch by Diego 'Flameeyes' Petten +� flameeyes commit 1e8abec2eecd831c55e34c09fc9a38833d69c180 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Jul 10 14:28:54 2009 -0400 + + Fix default value of thread_count. + + Adding a flag named "threads" somehow disabled the default value + of the option named "threads", which allowed thread_count to be 0 + for non-ffmpeg/ffplay clients (which don't always reset it). + + Not sure why AVOption works this way. + +commit 1eff8ec8e1772334cd74129f8cc068483c757b40 +Author: benoit <benoit@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Fri Aug 10 07:28:18 2007 +0000 + + Prefix with "opt_" the functions ffmpeg.c:show_{version,license,formats}. + patch by Stefano Sabatini [stefano tod sabatini-lala commit 1fae9e952cee3c499313b5a9b5c2e3dda096ee30 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Mar 10 01:44:05 2011 -0500 + + Delete the libswscale submodule for svn->git merge. + +commit 2037d9714bc51ccb57a82aba95a52a5b49bdc401 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Aug 24 21:16:50 2008 -0400 + + Comment this just in case someone doesn't get it + +commit 2063f77f904af3544021e16d6da76acf5d9beaed +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Nov 15 05:40:04 2010 -0500 + + Delete beosthread.c which is gone from mainline + +commit 207f434446b40b29311e81233167bd03de16bf0c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Jul 30 20:14:56 2008 -0400 + + Cosmetics: whitespace adjustments. + +commit 20997d60c8ec84dd0dd68055901e847c4b4e171a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jun 27 22:33:17 2009 -0400 + + Frame threading for VP3 [2/2]. + + The performance with different thread counts is different from + MPEG codecs; trying more or less granular synchronization would + be interesting. + +commit 20a85842c46b547331c5884e015dd781108c6d17 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Oct 11 16:43:39 2008 -0400 + + Save PAFF vs MBAFF information for pictures. + + This already exists differently in mainline, but this way is more useful + since MPEG-2 has field pictures but not MBAFF. + +commit 20d6c336b37a7bf7313865a397f19ef33595adf8 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Dec 23 17:49:51 2008 -0500 + + More todo entries + +commit 210b4a63100e5f4ba5ab23e84460614ca59b7817 +Merge: fc957c7 59b0bd5 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon May 24 22:26:23 2010 -0400 + + Merge mainline. + +commit 21cede4223d4bcfcc0f6a91bbc84354238201fea +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Apr 19 03:30:45 2010 -0400 + + Fix possible overlapping memcpy()+crash at the end of decode + + Increasingly dissatisfied with having to do this. + +commit 22a56df3f22e5c32c5f2fd06db8d644157da1877 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jul 14 23:12:17 2008 -0400 + + Remove dead code. + +commit 22d953bd1ef2b61ec272be03aa8f81587e0ac046 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Jun 25 04:54:34 2008 -0400 + + Remove zeroing mbskip_table + It's unnecessary with the previous commit. + +commit 22e9455a663acc4d34f76130f2603b41b3940b9e +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Aug 22 16:25:45 2008 -0400 + + Comment and rename context variables in pthread.c. + +commit 2331711a5ff0908a37005a0e500804a5a8a61e5d +Author: Michael Niedermayer <michaelni@gmx.at> +Date: Wed Apr 6 00:15:42 2011 +0200 + + Fix ffmpeg-mt fixme in h264 + + Uncommenting this code no longer seems to cause valgrind problems or crashes. + Behavior is unchanged. + +commit 234887b836f9b0306388d20499c8025ac916e11b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 19 21:17:15 2008 -0400 + + Normalize if (err) + +commit 2412ad4778734a19638c997d5567f5d53d135a9a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jan 17 15:57:00 2011 -0500 + + pthread: Document release_delayed_buffers + +commit 24345e509df0b92a3592cfb15db12b1aecd78ffe +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 26 02:26:07 2008 -0400 + + Fix spelling and rewrap multithreading.txt to the right number of columns. + +commit 2485cfd74cf5012fdce8582b7094ddbd09bd70c9 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun May 24 03:38:22 2009 -0400 + + 10l: pred_direct_motion fix missed several mb_type accesses + + I have not proven this correct yet; it's not too hard with some work + (record the last row accessed and waited for, and make sure they + correspond). Therefore, I suspect it still isn't correct, since + framecrc still shows mismatches. It does fix the worst visible + errors, though. + +commit 25a2f117ad6d6dc2592e77369bed23e53241b218 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Jan 21 03:24:41 2011 -0500 + + Cosmetic: shorter line variable declaration + +commit 26151296236e0381c1c40e0d97ead8c5ab26b57c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Nov 2 02:33:12 2010 -0400 + + vp3: Lift up loop-invariant checks and simplify away 'border' which == 1 + +commit 27026500c9a25bf409b55186d9bceada4bf2ba5c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jul 19 02:09:18 2008 -0400 + + Fix mpegvideo crashing without --enable-pthreads due to the number of thread_contexts changing. + + -threads X no longer has any effect since all threading code is now gone without an actual threading library. + I think this is a nice minor size optimization, but if it's necessary to keep regression tests working with frame-threaded encoding I'll have to revisit it. + +commit 2742b2a142ff98e4611f96ddf47ab5a5233f4692 +Author: benoit <benoit@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Thu Jan 10 10:15:07 2008 +0000 + + Reduce the size of the replaceTable entries. + Patch by Diego 'Flameeyes' Petten +� flameeyes commit 287e761820e85514e00eb6c5958496ecb61825cb +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Dec 24 22:21:37 2009 -0500 + + Fix error return being ignored in VP3 allocate_tables(). + + Based on a patch by Yuriy M. Kaminskiy. + +commit 29c2b04f5074e49aa63cf50fb90e3a51e853ad9d +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Apr 4 00:35:28 2009 -0400 + + More todos related to init api + +commit 2a7a86a64f153befafabcbb987e2793fa4bb0e18 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jun 27 22:17:41 2009 -0400 + + Split out error returns in VP3. + +commit 2a9b493a5a0f46f43959ce2466849dd6a6217012 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Feb 2 02:12:29 2011 -0500 + + Fix memory abandonment + unnecessary realloc in mpeg4 + + Fixes Sample1.mkv from ffms running out of address space (and more). + Note the file doesn't display properly in ffplay, so there's still bugs left. + +commit 2ae310bf292c1f34be006e9be7fbceb4c0f1b068 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Jun 3 04:20:42 2008 -0400 + + Comment next_*_index. + +commit 2b74560715c3d4f331156d8745ce801c1de4d467 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Nov 18 14:31:17 2008 -0500 + + Revert accidental warning change + +commit 2b7d2acccb45e89bfc77564bcdaee68fcb4ac4c7 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Feb 1 23:05:43 2011 -0500 + + Revert 99ed04d4d7b7183a4d0a1b8833eee3b506e13ff0 + + Broke big_buck_bunny_720p_stereo.ogg with 2 threads. + +commit 2bbb64dae018cbb09ea47a6bdcb184f551136c26 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Dec 15 16:15:21 2010 -0500 + + Fix definition of CODEC_CAP_FRAME_THREADS to not conflict. + +commit 2bc23e009291d727eed7a4f803a2793f5fa715b0 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 26 03:03:38 2008 -0400 + + Update avcodec.h comments + +commit 2bcbffdbf53bd2918ba6ade66d12fb97021032c7 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jun 15 20:26:59 2008 -0400 + + Combine all the condition variables into one. + +commit 2beb042a202d00dbb2baef3970f058994aeec027 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 23 19:32:56 2008 -0400 + + Split thread_algorithm into two more sanely defined variables. + + Also improves correctness in some ways. + +commit 2c0e016af759adfdc34a6a1b8592ec0a1ef56da9 +Merge: d5ea5fc c2c8552 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu May 7 17:36:13 2009 -0400 + + Merge mainline. + + Uses the minimal changes to get the new AVPacket API working. + + Conflicts: + libavcodec/avcodec.h + libavcodec/h264.c + libavcodec/mimic.c + libavcodec/options.c + libavcodec/utils.c + +commit 2c3cd96bf1cb1757407c973416f7928d492e2156 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Aug 18 22:59:19 2008 -0400 + + Cosmetic rearranging of MPEG update_context functions + +commit 2cb0db5ba7d77ed8180f0551462c836047ea262e +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 18 16:19:33 2009 -0400 + + Fix invalid Mimic stream handling + frame threads + + Releasing a frame after frame_setup_done isn't allowed, and + it must do report_decode_progress as if it was finished. + +commit 2d0370118996148f1c64b9c6b4a2ff632fcaf609 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Aug 31 03:56:04 2008 -0400 + + Add fixme for copying packet data. + +commit 2e121780400cb6630a66a0b7bd3fe84ad539b882 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Jul 11 18:21:08 2008 -0400 + + Increase the released buffer size to 16. H264 can release this many at an IDR, can other codecs have even more? + +commit 2e5a5baf540ae0d1ac16ae52f66254b7233aabf7 +Merge: 5d82241 31f0027 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Mar 29 04:35:46 2011 -0400 + + Merge branch 'master' of git://git.libav.org/libav + + Conflicts: + libavcodec/dsputil.c + libavcodec/mpegvideo.c + libavcodec/snow.c + libavcodec/vp8.c + libavcodec/x86/dsputil_mmx.c + +commit 2e9d8893eac232b782b479378cf13d484ab9cc1e +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed May 28 22:49:33 2008 -0400 + + Add thread.h + +commit 2eeab8f6ad07611e46b3377ddf73e1d7f1f2bb78 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Aug 24 21:16:31 2008 -0400 + + General description and porting guide + +commit 2f1fec650f4bb351fa819fb7e11b4766a43fa30f +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 19 01:20:32 2008 -0400 + + Simplify mimic_decode_end changes + +commit 2f48eac011767ba2d60329c10a22499c228a31d8 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Nov 18 15:27:24 2008 -0500 + + Missed fixing pthread.c in merge. + +commit 2f8f77021011eec5af8cab80ee7bdc574ad3f37b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Jan 21 03:01:42 2011 -0500 + + pthread: Style and comment nitpick for validate_thread_parameters() + +commit 300b5819426ed6b35aaa480502070382e5295111 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Aug 17 14:07:06 2008 -0400 + + Copy aspect ratio info between contexts. + +commit 3029628ce39e37c9ae77cb78f22ab9d4846e6610 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Aug 31 15:15:15 2008 -0400 + + Fix compiler warnings + +commit 303cd6307958792faac1ce8c8c81eea2651b002f +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 19 18:31:17 2008 -0400 + + Use MPV_report_decode_progress in mpeg12, and call it before mb_y++. + +commit 30e540672df8523a47013d92592b744459040904 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Oct 13 15:00:39 2008 -0400 + + Make every thread lock the same buffer_mutex for get_buffer. + + Otherwise it isn't actually protecting anything... + +commit 3106e8ebe7c55eba3e41f3a11cc23eb249a4ff3b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jul 14 23:09:47 2008 -0400 + + Always set thread_context[0] in MpegEncContext. + This fixes mpeg* encoders always crashing, but most of the regression tests are still failing. + +commit 3127a4bd6e36bb2d9cd2fe12a96fa776d94fed94 +Author: michaelni <michaelni@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Sat Nov 2 10:47:44 2002 +0000 + + added BeOS net_server support (R5 network stack), basically the same + problems as with winsock (sockets != fd), and the broken select(). + based on older patch by Andrew Bachmann. + patch by (Fran +commit 314c2b1d2f94be3b6aca3dd1ae0f30c05f10f2ee +Merge: 9816b66 bd8850b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Feb 17 22:41:31 2009 -0500 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + + Conflicts: + + libavcodec/avcodec.h + libavcodec/mimic.c + libavcodec/mpeg12.c + libavcodec/mpegvideo.c + +commit 314e5630e389457319ff2d11e856fab6b1d8b250 +Author: benoit <benoit@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Mon Jan 7 12:47:14 2008 +0000 + + Move wmv1_scantable to .rodata section by making it an array of arrays. + Patch by Diego 'Flameeyes' Petten +� flameeyes commit 31e3f669b598302b2a487dab84e08bf4d1e79983 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu May 7 18:06:52 2009 -0400 + + Fix mplayer patch's calculation of extra delay. + + It's only (num_threads-1) frames with MT on, not num_threads. + +commit 31f1a603dcfe885c41d123832f102a3ccc55c6dd +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Aug 24 00:20:03 2008 -0400 + + Rename threading functions with 'decode' in their name + +commit 333777b56b942a11db5d672433357bcbbf0d6e47 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 19 01:14:48 2008 -0400 + + Cosmetic changes to mimic + +commit 33bc3cc94a5a6e2679306da899afb1e0ce6b78c6 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Aug 14 14:01:15 2008 -0400 + + Reindent. + +commit 3444ffe523dd65b788791dfb2c6cbd7031cfec97 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Aug 6 20:24:44 2008 -0400 + + Cosmetics: rename last_thread to prev_thread to avoid final vs. previous confusion. + +commit 344df336a0b5e70ef9fcea33f612f759bc045552 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Apr 19 03:31:30 2010 -0400 + + Reindent + +commit 3547c7f44108f1080f90de1844c36fb172528994 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Feb 20 19:40:48 2010 -0500 + + API simplification: remove ff_report/await_frame_progress() + + The field variants are enough. + Note that mpegvideo.c thread code doesn't need to support any codecs + with field pictures. + +commit 3630d89a7bd6443f9aeda2f6997fb2ea5da5c97d +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Dec 18 12:36:20 2008 -0500 + + Copy dequant4/8_buffer between H264 decoding threads. + + Fixes at least: + MSG00 ED.mkv + freedom EP1 sample.mkv + made with unknown encoders. + +commit 36977df5243521eaa3ab1b67f3c89d1a1ba4c8f7 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Aug 18 22:03:25 2008 -0400 + + Move copying idct_algo to the right place + +commit 379271216e0d522b675e97189ab5d4e5cf7f5f70 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Apr 19 03:35:28 2010 -0400 + + Update todo. + +commit 37b38ff868fa39f75df9c1bd543fd1c2dc7134ae +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Feb 20 20:31:16 2010 -0500 + + Update the comment for FF_THREAD_FRAME. + +commit 382e06ef4ba568c565b9d67b33b1688a32b2b80e +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue May 11 06:21:06 2010 -0400 + + pthread: Use av_fast_malloc to allocate the frame buffer + + Also delete the FIXME; it's impossible because the AVPacket memory + API doesn't actually work. + +commit 3934d02026fb67b46441176c4160c0f854c12825 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jul 21 18:10:58 2008 -0400 + + Reindent. + +commit 39eee0b91b9b6b75c54ff68d51ecc0ba1816c88f +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jun 22 03:36:24 2008 -0400 + + Multithreading support for MPEG-4 + This requires more parallelism barriers than usual because of the horrible skip MB structure in B-frames. + +commit 3ad85b1741ca6d36126bbf674f5b82d550107bae +Merge: ff4c627 4495490 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Oct 6 16:12:06 2009 -0400 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + + Conflicts: + libavcodec/avcodec.h + libavcodec/mpegvideo_enc.c + libavcodec/snow.c + libavcodec/vp3.c + +commit 3afd3f52b940d0bfa756e1a7496a20d103c5a7f0 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Jul 25 03:25:00 2008 -0400 + + Merge MPV_update_picture_pointers() into its only caller. + +commit 3ba8143c5da92197eb45fa120bfa95b38adfd3bf +Author: michaelni <michaelni@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Sat Nov 2 10:35:07 2002 +0000 + + added BeOS net_server support (R5 network stack), basically the same + problems as with winsock (sockets != fd), and the broken select(). + based on older patch by Andrew Bachmann. + patch by (Fran +commit 3bac11e47a0ec7c6036c53a1173bce276abccfeb +Merge: 53fff22 3d42d49 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Apr 9 21:30:16 2011 -0400 + + Merge mainline. + + Conflicts: + libavcodec/h264.c + +commit 3bef1503e0f23c0f30c2e3b2de64a9b2618807d2 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jun 27 16:18:44 2009 -0400 + + Add debugging hooks to show ff_report/ff_await calls. + +commit 3c3a3648317737830fc863371b455624d093f8e6 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Oct 18 17:39:17 2008 -0400 + + Fix possible null pointer access after seek. + +commit 3c7a8d94b97003b118c2438343d06ad7cf26198a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Mar 9 00:04:51 2010 -0500 + + Reimplement VP3 multithreading. + + Synchronization is now not very fine-grained, because it reuses + vp3_draw_horiz_band which runs every ~64 pixel rows. + +commit 3cfd7b2e788c3d8e31c91ed529f3e3730f836395 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jun 23 23:14:05 2008 -0400 + + Wrong kind of #if. + +commit 3f7521893b9072181763ea176ef8da0c0ad1922a +Merge: ed42183 206c937 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Oct 10 01:47:32 2010 -0400 + + Merge mainline. + + API change: CODEC_CAP_FRAME_THREADS is now defined as 0x800. + + Conflicts: + libavcodec/avcodec.h + +commit 3f858091f8f3cd43f1eed396e85f6956ee5068a0 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 19 02:35:52 2008 -0400 + + Fix losing frames at the end of an encode + +commit 3ffe81697018042b27a31f20c1d30c988b688d60 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 12 18:22:42 2008 -0400 + + Reindent. + +commit 401a6bc7f0fe26963f63778c5092ae96c4262634 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 25 19:07:58 2009 -0400 + + Frame threading for VP3 [1/2] + + update_context function and compatibility fixes. + +commit 40265f10de7698bb2fe23857cf261a0f04fe18a1 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Oct 13 14:19:27 2008 -0400 + + Fix edge drawing for non-mod-16 files. + +commit 4074c8bfba918988029ce106eda3d41486f12966 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jul 12 00:11:35 2008 -0400 + + Copy more MpegEncContext variables. + These are needed for proper DivX/H.264 decoding. + +commit 40ffd3a664e36f44ebdf4d2603e42c7c59502599 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jul 23 21:40:06 2009 -0400 + + 100l, fix compile error introduced by automerge + +commit 4118a72e28be1cee657561a1f45dc3ce160dbf07 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Mar 10 02:46:14 2011 -0500 + + Update todo.txt + +commit 41e0f81a58493a0a15cb18c7ff00920f0fd124a3 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Aug 24 02:52:18 2008 -0400 + + Remove unneeded stubs from thread.h + +commit 4259f9fcf4edc5c92bc02d37d85493b3eb917075 +Merge: 2615129 fb61692 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Nov 2 02:36:20 2010 -0400 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit 4293f5ba301cd751257705bfe6fc8b12337dccab +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jul 14 23:20:17 2008 -0400 + + Disable multithreading for packed B-frames. + The bitstream buffer is updated after decoding, so it has to be changed to find the frame end before starting the actual decode. Assuming that's not too slow. + +commit 42b521db9177ed2d4e62845659fdcd44c59757f9 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri May 8 00:40:57 2009 -0400 + + 10l: dequant_coeff must be copied along with dequant_buffer + + Fixes more Blu-Ray streams which change CQM, including Slumdog + Millionaire. + + Noticed by Haruhiko Yamagata. + +commit 435ace7689e2794ddbb4013de097bdaf487f7365 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Apr 9 21:47:12 2011 -0400 + + Update test scripts to use ffmpeg instead of ffmpeg_g + +commit 435adcd213762869c6a6f806481450216720b364 +Merge: 6ee99a7 11dcccd +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Mar 10 01:25:24 2011 -0500 + + Merge remote-tracking branch 'socrep/last_mainline_point' into last_git_point + +commit 451af22792e7bec6f3b347ba801ba186102a85da +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jul 14 04:13:33 2008 -0400 + + Call draw_edges per-MB-row instead of per-frame when possible. + This is necessary for multithreading, since rows aren't complete until their edges are mirrored. + It should also be somewhat more cache-efficient, but I haven't benchmarked it properly yet. + I don't like adding new MpegEncContext variables, but edge_y lets it do the right thing wrt. error resilience and codecs that don't call ff_draw_horiz_slice. + +commit 452fb04633126605afbb2cd0d6383bb75fe01f38 +Author: michaelni <michaelni@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Fri Nov 8 20:54:44 2002 +0000 + + ringbuffer patch by (Fran +commit 4681ac8f618586d4a3ecb04784b9cf896d070f1b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue May 11 14:43:29 2010 -0400 + + Cosmetics: vertical alignment + +commit 468eba33060aa87117ac6b617d4eae776951cbf6 +Merge: 3c7a8d9 aa86abc +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Mar 9 00:55:42 2010 -0500 + + Merge mainline. + + The error condition in vp3_decode_frame was uglified to make the + diff simpler. + + Conflicts: + libavcodec/vp3.c + +commit 46a45ad599db4037006b335fca2c7b7bed7018ab +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 2 00:22:16 2008 -0400 + + Clear thread variables in avcodec after freeing them. + +commit 46b495ebc4a7fb7662580791e4ed10130b00fead +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 12 17:16:31 2008 -0400 + + Don't allocate duplicate contexts if they're not going to be used. + +commit 46ec6b90e7b2d6b1d83a207025a691c56176d686 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jun 16 18:21:04 2008 -0400 + + Multithreading support for MPEG-1. + +commit 46fc25f5c225e2f33430e31a0d0ad375455e9cef +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Nov 1 12:20:12 2010 -0400 + + Update todo.txt + +commit 473799e0c3b647d73046c3b4de30e85bf57ba610 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 19 21:16:59 2008 -0400 + + Whitespace fix + +commit 47869edb7f0aede0a2bfd178ef9937e28bf8b01f +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Feb 14 23:41:12 2010 -0500 + + Fix buffer leak in VP3 by allowing update_context() with the same context. + + I assumed update_context() would only be used to copy values, so skipped + calling it with duplicate parameters (during flush and free) for optimization. + + But VP3's release_buffer call was moved from the end of decoding to the + end of update_context(), so flushing would skip releasing a frame and + eventually run out of buffers. + + Unfortunately this makes update_context() much uglier in codecs that + already worked, because memcpy doesn't allow src and dst to be the same. + +commit 480a82da7912bc5034a4b0bc2090879920567521 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Sep 30 01:13:43 2010 -0400 + + Update todo. + + ffplay/ffmpeg support for better a/v sync support is in progress. + If Theora uses PTS (I think it does), then once ffmpeg.c i + ready it can be submitted to mainline. + +commit 4845b04ed3d6bc513a272da718629d110bc8186f +Author: benoit <benoit@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Mon Jan 7 12:43:04 2008 +0000 + + Mark the tables in g726.c as constant. + Patch by Diego 'Flameeyes' Petten +� flameeyes commit 485d8e9e3c5de803075c8440922e6e09b10a1e57 +Author: Alexander Strange <astrange@resnet-022-195.spsu.edu> +Date: Sun Sep 14 20:45:58 2008 -0400 + + Fix ff_report_*_progress side of H264 multithreading and merge draw_horiz_band into it. + +commit 4874d258345ec305b0eca78c41491878d42a900d +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue May 11 14:45:39 2010 -0400 + + Cosmetics: reorder variable declarations + +commit 48d2183d902db7cc42c9f84d2bad6eccc35d0221 +Author: Ronald Bultje <rbultje@google.com> +Date: Mon Apr 11 14:58:11 2011 -0400 + + Release unused pictures even when not calling ff_h264_frame_start() + + Unused pictures assigned to the thread can build up and cause it to + run out of buffers if the thread only ever decodes bottom field pictures. + +commit 48d7f5a8f3f14535d74f0e4b0a736e3f5dc336b2 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Aug 18 19:58:18 2008 -0400 + + Factor out freeing delayed released buffers. + +commit 49652059c673eb977e5b69ffb0c8a543c3210e16 +Merge: a2efd25 48e59eb +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jan 15 17:01:41 2011 -0500 + + Merge mainline. + + Conflicts: + doc/APIchanges + libavcodec/avcodec.h + libavcodec/h264.c + libavcodec/utils.c + +commit 4969bb89e592c003a560e321f3cacb412a192db9 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jul 31 14:30:40 2008 -0400 + + Copy avcC variables in H264Context. + +commit 496ec27adcef84278e650b29f4d22aba383d705a +Author: Alexander Strange <astrange@resnet-022-195.spsu.edu> +Date: Sat Sep 13 16:20:03 2008 -0400 + + Correct interlaced draw_edges. + + There is still a race condition when fields are decoded in different threads, + so for now we pretend EMU_EDGE is set instead of using the edges. + +commit 498ddbb3b2d78819540c1b8fff9a2bc495a33346 +Merge: aaa05da 95b6213 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Nov 3 18:34:04 2010 -0400 + + Merge mainline. + + Conflicts: + libavcodec/avcodec.h + +commit 49e377f9f23904ed790e98175b1575bba6ecc6cb +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Jul 15 03:30:28 2008 -0400 + + Add update_context() for H.264. + This seems to lose reference frames for my PAFF sample, which I'll fix after I find out how PAFF works. + +commit 4adb7fbed7dcb12dda0f3919188334a3b96efb0a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Aug 18 20:02:12 2008 -0400 + + Cosmetics: get rid of unhelpful comments, useless braces, and some whitespace/align issues + +commit 4af5480a021156089c193ce2215994cfd170e4e6 +Merge: 2f48eac 1bf5327 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Nov 28 22:48:24 2008 -0500 + + Merge mainline. + + Conflicts: + + libavcodec/h264.c + libavcodec/mpegvideo_enc.c + +commit 4b9ce55576ab27f6a45d542bfda7c1e21fb967f8 +Merge: 1fae9e9 435adcd +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Mar 10 01:54:16 2011 -0500 + + Merge branch 'git_equiv_of_mainline' + +commit 4c726e5e30e1f48619eecbec5442acd63e895318 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed May 28 22:40:30 2008 -0400 + + Rename pthread.c to thread.c + The remaining *thread.c files will be merged into it later. + +commit 4c802e44f13672dd4527f51fc2f07a1e21be4a5c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jun 2 04:31:45 2008 -0400 + + Simplify ff_await_decode_progress. + + Always set and allocate the progress pointer, so ff_await_decode_progress doesn't have to check for threading to be on. + +commit 4cdd15a3cf5dfec32ace278cd445f04130ddbee0 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jan 15 19:26:14 2011 -0500 + + pthread: Call external get_buffer() on the client's thread by default + + This fixes several mplayer VOs that crashed when they were called from decoding + threads. + + Not a complete fix as mplayer still doesn't work right with draw_horiz_band() + being called from decoding threads, but that doesn't crash at least. + +commit 4d2f536b72ec9121b5afe858b69c93d9cc75f20a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 30 04:20:20 2008 -0400 + + Simplify draw_edges changes by removing edge_y (which is useless with slices) + +commit 4d8525ab388d34e128629b08ab88c6a16f3aa406 +Author: michaelni <michaelni@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Sun Jul 21 07:59:17 2002 +0000 + + nanosleep patch by Fran +commit 4edb9a7f780a6eaef36512724e6a34c3f38d67ce +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Feb 15 00:31:31 2010 -0500 + + Disable mpeg1 frame threading. + + Seeking doesn't work (it triggers false error conditions) and it doesn't + pass test.sh (-threads 2-4 match but 1 doesn't somehow). Will be reenabled + when those are fixed. + +commit 4f9364563f388af84b9a02930b375ff52eee1394 +Merge: 3bac11e 347b375 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Apr 9 21:30:47 2011 -0400 + + Merge branch 'master' of git://git.libav.org/libav + +commit 4fb1fdf1ca1a48aff176b8f833ca596d245d6d36 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Jul 15 03:30:50 2008 -0400 + + Reindent. + +commit 4fb33e68ec34cbc135ce4ebb86f7e1399ba97115 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jun 23 22:11:58 2008 -0400 + + Merge statements. + +commit 5022ee29ac6d4b2ee992115c3bf997e7bd1ab7a4 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 5 20:30:27 2008 -0400 + + Add delayed_release_buffer for handling reference frames. + +commit 5066a4656963dd3b4e847a540353bf71d318de14 +Author: michaelni <michaelni@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Tue Nov 5 00:07:05 2002 +0000 + + lrintf detection (based upon a patch by Fran +commit 50d1ce2db57e39b6115642d3c4397e9f67f758e3 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun May 24 00:08:03 2009 -0400 + + Call codec init at a more reasonable time. + + Previously it was delayed until the first decode_video() call, + but it can be moved into avcodec_thread_init(). This makes pix_fmt + available to clients after init again, which should make them happier. + +commit 50eaf4979eb085e2c58c06912bb0c885404d4470 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Aug 28 17:39:28 2008 -0400 + + Simplify changes to non-pthreads and don't call thread_init from open if it was already called. + + This will cause an assert failure if clients call thread_init again after open. + +commit 51428e56c71512a57f81d85acee3ced7cc0d2983 +Merge: 00425e9 03586fd +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jul 4 16:41:31 2009 -0400 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit 517d68c2642aee3c14fc71031c1e44c0803a664e +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Mar 8 04:43:06 2010 -0500 + + h264: change the definition of col_fieldoff to avoid divisions + +commit 5186276ed120294fb6a4f2cf5a40d5019012482f +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jan 16 22:01:18 2011 -0500 + + libavfilter input_get_buffer is thread-safe + + Slightly faster ffplay playback + +commit 51ead6d2c40c5defdd211f435aec49b19f5f6a18 +Author: Ronald Bultje <rbultje@google.com> +Date: Mon Apr 11 10:14:38 2011 -0400 + + h264: Fix decoding race condition with PAFF + + A thread can release a Picture and immediately reuse the same Picture + for a different frame. This is fine, unless the picture released was + a field-picture. In that case, there may be a future thread still decoding + the second field of the picture, and reusing it overwrites the shared fields + in the Picture. + + Fixed by tracking ownership of Pictures and allowing it to be reassigned + to the second thread's context. + + Fixes conformance sample HPCAMAPALQ_BRCM_B.264. + vsync still fails, and therefore FATE does as well. + +commit 521f07e3cf2dfb9b0473027ae2fbb6bd4f203ce4 +Merge: 7d0709e 4a8d06e +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun May 31 00:08:08 2009 -0400 + + Merge mainline. + + Conflicts: + libavcodec/avcodec.h + +commit 52b214211060b56e7aac6b9743fa27bc79f789d1 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed May 28 02:15:47 2008 -0400 + + Enable multithreading for Mimic. + +commit 5323bc6e8adbff2b6849a08e9e071f22241fd807 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Feb 20 22:48:51 2010 -0500 + + Cosmetics: add () to function name + +commit 5340d1ffae10b1545d88b9dd8ca86a5a3aaffca7 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed May 28 02:15:47 2008 -0400 + + Enable multithreading for Mimic. + +commit 534516ac79adc69d8773ff934955532a92db2cf1 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 16 00:01:07 2008 -0400 + + Fix a memory corruption bug in update_context and reenable H264 multithreading. + +commit 535de6d374ab6b06041f5e3cb392327abd2ce054 +Merge: 6abde3d cc8161e +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue May 11 04:08:37 2010 -0400 + + Merge mainline. + +commit 5380fee33a871580fe9f3424767eaf2362c8cde0 +Merge: ef2d866 08c0efd +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jun 13 23:43:37 2010 -0700 + + Merge mainline. + +commit 538a29e12f115390a64ceb3d4909a4a67cad26cd +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 19 15:48:55 2008 -0400 + + Make diff smaller + +commit 53c86e82af6757c12df3a99aede6862a311f050b +Merge: fa8a82e ae2df26 +Author: Luca Barbato <lu_zero@gentoo.org> +Date: Sat May 3 16:13:06 2008 +0200 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit 53cd195c8885125351a03cfb6f1d93e66d433b86 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Nov 15 05:00:01 2010 -0500 + + Rewrite multithreading.txt + +commit 53fff221cdb9f18df2f2f52bd48731ce0fa9e114 +Author: Maksym Veremeyenko <verem@m1.tv> +Date: Wed Mar 30 13:20:23 2011 +0300 + + mingw32 compilation after 'unbreak avcodec_thread_init' + +commit 5402adfa2e9c159e7d13ee07e142cb035a77ef95 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Dec 16 16:54:20 2008 -0500 + + Only write to stderr once for each av_log(). + + This makes logging somewhat easier to read with multiple threads. + +commit 541d79def90226cc9b17e6ccc9eb2ff2549bea46 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri May 15 17:54:20 2009 -0400 + + Remove useless volatile qualifiers + + All such accesses must be protected by a mutex anyway, which is + already a memory barrier, so this doesn't change anything (assuming + a working compiler). + +commit 544c6a6709833f1a449b8faf4478ab529e269240 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Mar 29 02:28:29 2009 -0400 + + Frame threading support for HuffYUV decoding + +commit 54c0c3d2ce69606a5aa508659d3322f48ada77cb +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Sep 3 11:59:59 2008 -0400 + + Call decode_postinit from the right place to avoid race conditions + +commit 552a89508fddc64d4217b9d845e458f504b63593 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jun 27 15:22:52 2009 -0400 + + Print md5s of test output files in test.sh. + +commit 55c511eedb24ffb09aef7072c02e911576c9900b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jan 25 02:47:19 2010 -0500 + + Did a todo item + +commit 574d2e5b942aa1e093bf768cc6321f3b081d3aeb +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jul 5 23:36:08 2008 -0400 + + Merge enum with its only use. + +commit 578f45c15026e778ef54694d98a9ec446810a897 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jun 15 17:42:56 2008 -0400 + + Reindent. + +commit 5918efedbb7928031b6af745acb8b4233c08fb06 +Merge: 7d09b68 c2a400d +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Aug 14 21:37:03 2008 -0400 + + Merge branch 'mainline' + +commit 59d787ffccaf42e992229649c23e624ea7d71635 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Nov 15 05:39:12 2010 -0500 + + Delete os2thread.c which is gone from mainline + +commit 5a7146bf75a2170f33ff25b88b91f667574d2919 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Aug 11 01:33:20 2010 -0700 + + vp3: Fix a crash decoding files with <thread_count frames + +commit 5a75822b584676672fbb887d4b828abc80ffd89c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Apr 1 19:19:34 2011 -0400 + + pthread: validate_thread_parameters() ignored slice-threading being intentionally off + +commit 5b7c668d1f64facfe8b9f86e2491085595fa9bc7 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 12 20:26:26 2008 -0400 + + Document thread-safety requirements for user callbacks in AVCodecContext. + +commit 5bacdcc1a52e2b1d32bad9e9f250ceb6cc37f366 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Oct 11 15:40:47 2008 -0400 + + Fix progressive height values in avail_motion() + +commit 5c46573ed07b092aea0db6560ade77bc299c28cb +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon May 25 22:16:23 2009 -0400 + + Whitespace error + +commit 5c4c8ed51da0be4f141a4de339db77f4a0a6c783 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Sep 1 03:18:55 2008 -0400 + + Remove unused variable + +commit 5d3c2f7512746dd0adf067952ed38d8111d7571d +Merge: 7041a16 5a70b15 +Author: Luca Barbato <lu_zero@gentoo.org> +Date: Sun Jul 6 12:38:18 2008 +0900 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit 5d53ada4cbd323d66b61965b1442d0abd63361b2 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jan 24 17:00:18 2010 -0500 + + Don't load PerThreadContext until it's needed in ff_await/report_*. + + Should avoid crashes if anything calls them without using ff_get_buffer. + +commit 5d7dfbb887f263b036224bf4510db176fa6cff73 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jun 16 18:18:53 2008 -0400 + + Utility functions for mpegvideo threading. + +commit 5d82241b49a1fb1dbecd1b279045cce9f099c775 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Mar 24 03:34:48 2011 -0400 + + Update todo. + +commit 5eb0c649c780e26a77085bd213f945d88761ad00 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jan 4 04:12:44 2010 -0500 + + Make ffplay -drp the default. + + Ignoring reordered/delayed PTS never works with frame threading. + This may be changing behavior too much; I haven't tested this + with non-mt files, but I think the current behavior must cause + A/V desync even there. + +commit 5eb679f0fff432ba2c9e0cdada254dbe4bd4a45d +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Nov 15 02:53:14 2010 -0500 + + Remove width/height changing checks from h264/mpeg12 + + These should be moved to pthread.c update_context_from_thread() if they're needed, + not kept in specific codecs. Hopefully the error return from get_buffer() is + enough to make it not crash anyway. + +commit 5edf2cc5acbb410ba50a3770e8565fb39206f406 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jun 16 18:20:54 2008 -0400 + + Multithreading support for mpegvideo decoding in general. + +commit 5ef4af7de47c3913ddc1e09e43887ac04ecfaba3 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jun 15 01:58:15 2008 -0400 + + Fix ff_delayed_release_buffer crashing with slice-threading. + +commit 604ee5471f21d310f4014011a20c00c28a31995b +Merge: 3792712 7838828 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Apr 21 22:04:21 2010 -0400 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit 607edd221a3b7a300fbaa4a5495ffd30f8dc9fa8 +Author: stefano <stefano@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Mon Jul 26 14:30:47 2010 +0000 + + Define static functions fill_image_linesize() and + fill_image_data_ptr(). ff_fill_linesize() and ff_fill_pointer() now wrap + these functions. + + The new functions are more generic, and are going to be exported in a + future patch. + + Patch by S.N. Hemanth Meenakshisundaram smeenaks # ucsd commit 60be6c15c4d23c5107f14e408043988918a44c76 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jun 20 16:07:58 2009 -0400 + + Add a valgrind script so I don't have to type it all the time. + +commit 614d2308b343ec6af6bf72ada08884684bb66df0 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Sep 3 22:55:22 2008 -0400 + + Update header guard + +commit 62830f5772dd8971032aa9f8d52a8f6c00c92487 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jul 17 19:04:19 2008 -0400 + + Remove next_delayed_pic, it doesn't prevent any race conditions. + + This part is now entirely out of sync with mainline. + +commit 62ba7a4acc98b691ab3152356cf0c21a52f7e03b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jun 15 19:22:41 2008 -0400 + + Fix the main thread hanging if there's an error before all of the frame is decoded. + +commit 63d086d2585d3275a6b9068ee1ca957617ecf902 +Merge: 314c2b1 712afbf +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Feb 18 21:29:44 2009 -0500 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit 63f663f09320851b9ed76f489fdab590da2fc7f0 +Merge: 64df3aa d61efce +Author: Luca Barbato <lu_zero@gentoo.org> +Date: Sat May 10 07:51:22 2008 +0200 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit 63ff6aa525faf65f86dfbc8ec571fd260844100f +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Oct 23 18:07:14 2010 -0400 + + Don't set avctx->thread_count to 0 in avcodec_thread_init. + + h264 crashes during decode init with 0 (instead of 1) threads. + Note that this isn't a regression from -mt, but is actually a bug present in mainline. + + -threads 0 should preferrably set auto threads, but doesn't. + +commit 641f2752c16aaa25c5854d34726b72f226003b87 +Author: Luca Barbato <lu_zero@gentoo.org> +Date: Sat May 3 12:20:42 2008 +0200 + + Ignore stuff + +commit 6446d2b0931c6a9637077b18b98af911d438057f +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu May 7 01:38:16 2009 -0400 + + Update mplayer.diff line numbers to match mplayer r29269 (20090505) + +commit 647f6cf3144934e3c2c22b06601d23a1217a2b86 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat May 23 20:09:07 2009 -0400 + + H264: Print an error instead of failing silently for size changes with slice threads. + +commit 64df3aa6a32a87d96f650b8535c88e1d65b52524 +Merge: 53c86e8 72c8992 +Author: Luca Barbato <lu_zero@gentoo.org> +Date: Sun May 4 22:24:35 2008 +0200 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit 65b3e34fc8a52f4f1a48fce7c8cddd80db8fade9 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Nov 1 12:20:24 2010 -0400 + + Update the test script to show results more clearly + +commit 65e8486a1dd1efbf2750d0bc25c326f8dc836bcd +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Mar 29 03:10:53 2009 -0400 + + Fix nonsense 2am code - left the huffman tables uninited. + + It would be faster to copy the VLCs but it would require more code. + And this could be factored into another function. + +commit 661ca4010c548e135ce1c0c819d0c05a94b66985 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Jul 10 14:32:04 2009 -0400 + + Cosmetics: get rid of pointless parameter. + +commit 66204771dd8e479d30ef71ad85c162e1a34e4104 +Merge: 3f75218 76dd0e7 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Oct 23 17:41:42 2010 -0400 + + Merge mainline. + + Conflicts: + libavcodec/avcodec.h + libavcodec/options.c + +commit 66a34dee4443dd6ccabb53ca09a1c45bc95f4d24 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 12 00:39:28 2008 -0400 + + Don't run the last part of decode_update_context() when the last frame was dropped. + + This fixes mplayer -framedrop crashing. Of course, they're still run in some cases when it wouldn't be without threads, but those are all error conditions. + +commit 66cf3f781d73fed502d80cce01dbd16b25bc3a71 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 2 19:27:12 2008 -0400 + + Correct 6b037a88 for PAFF/MBAFF. + +commit 66d9c0c9f6b2a4309dd4a41f88dd9a1dccb323e3 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 23 19:56:21 2008 -0400 + + Wait for predecode to finish just before calling update_context, instead of as soon as possible. + +commit 66ef4712c357514602f6b47311874e9ebf7376e3 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Jun 4 15:57:36 2008 -0400 + + Handle zero-byte input correctly. (for CODEC_CAP_DELAY) + +commit 68682144289b05c830fd64a651526c4708666874 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 19 04:08:42 2008 -0400 + + Fix accidentally calling execute_ref_pic_marking() while draining delayed_pics at the end. + +commit 686ea24614fded4d7501f71901aae61f5160f018 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jan 16 22:15:28 2011 -0500 + + Update APIchanges to match mainline_patches branch + +commit 68ef172444124e9e6dd2a69df00ae72a64e795cb +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue May 11 05:34:20 2010 -0400 + + Pass the complete AVPacket through pthread.c decoding + + Part of a patch from VLC. + +commit 6913bf9451bdaef16cd7748c93358baeec57d33b +Author: Michael Niedermayer <michaelni@gmx.at> +Date: Wed Apr 6 00:14:56 2011 +0200 + + Fix REBASE_PICTURE with h.264 + + It was possible for last_picture_ptr to point into h.ref_list + instead of h.s.picture, which caused a bad pointer to be set. + Fixes some valgrind warnings, presumably improves behavior but + no changes were found. + +commit 6998f46dec036f2ab39d6389747a95a7f5808f19 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Feb 20 22:32:39 2010 -0500 + + Cosmetics: Rename init_copy and update_context to have 'thread' in the name + +commit 69f085cebf61a64352e623d3c4a5d6032329473d +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Jun 10 11:33:47 2009 -0700 + + Don't change avctx->thread_count if frame_thread_init() fails. + +commit 69f6e77a9a9ddfc386d43f5a350df5c960c0203d +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Aug 24 04:11:52 2008 -0400 + + Remove useless check + +commit 6a26fe72383c0ab088c8d92733221bf2911231ce +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Oct 17 14:45:47 2008 -0400 + + Fix nonsense logic in copy_parameter_set() + +commit 6a3821cf92ef5aaba020a0b7c8d06df5926bd362 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Jun 3 04:13:55 2008 -0400 + + Merge statements in mimic. + +commit 6abde3d9e6ccfb062c6f547334171665386b0d85 +Merge: d8014c6 4448f8c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri May 7 04:42:38 2010 -0400 + + Merge mainline. + + Conflicts: + libavcodec/avcodec.h + libavcodec/options.c + +commit 6ae441be729df8064f1b1244acc82fead9cb1918 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 19 01:27:54 2008 -0400 + + Reduce code duplication in MPV_lowest_referenced_row + +commit 6b037a889a34f8f2dd8ad188cda6f4d09d9f4710 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jul 27 00:58:54 2008 -0400 + + Avoid a deadlock in damaged streams where the current picture ends up in h->ref_list. + +commit 6b5aa5cb4d105c4ed118d5ea07f64bbe1e94d135 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat May 23 23:10:33 2009 -0400 + + Remove inaccurate comment. + + ff_report_frame_setup_done() is called properly for the first field. + +commit 6c575595d9d0e2974e326ad86db61bb61163753a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 19 21:01:51 2008 -0400 + + Add flag for thread algorithm + +commit 6d4679e9d5fedff6aa1eed964aa1449716f02682 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Jan 20 02:17:36 2010 -0500 + + Add a FIXME comment to a commented-out part of h264.c. + +commit 6e508a7ab927ce7280688d822d3529dfbf17ec88 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Sep 4 17:40:59 2008 -0400 + + Fix field progress allocation. + +commit 6fad2f2300fb9e6288d4c9cdf3028d07d3dd63a9 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jan 17 15:41:20 2011 -0500 + + pthread: Fix missing mutex unlock in error condition + + Also remove stray ; + +commit 700a6622f378b5169d8d54ea5bdb4d8b67262a22 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Jun 24 23:29:40 2008 -0400 + + Merge another ++. + +commit 701ddc74e17de9f76eabf00a9e8d16adac7c2954 +Author: michaelni <michaelni@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Tue Nov 5 00:38:06 2002 +0000 + + BeOS Audio ouput patch by (Fran +commit 7041a164baed1c643f0cfa1207fbb2fd06d81f38 +Merge: 84cde2e 483385a +Author: Luca Barbato <lu_zero@gentoo.org> +Date: Sun Jun 29 16:34:45 2008 +0900 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit 70595dcbdbc01bb1f8f331c0998ee11f04577091 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jan 24 17:33:22 2010 -0500 + + unnecessary freep + +commit 706e94d6531daa0b179613dbef51af8ec5bbe1dd +Merge: 7e928f6 e42b282 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jul 17 18:47:45 2010 -0700 + + Merge mainline and swscale. + + One valgrind test currently fails. + + Conflicts: + libavcodec/avcodec.h + libavcodec/beosthread.c + libavcodec/h264.c + libavcodec/options.c + libavcodec/os2thread.c + libavcodec/utils.c + tests/ref/vsynth1/rgb + tests/ref/vsynth1/yuv + tests/ref/vsynth2/rgb + tests/ref/vsynth2/yuv + +commit 70bf5912700d0519f3d607784654c394633effac +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Jun 18 21:58:17 2008 -0400 + + Add an mpegvideo wrapper around ff_report_decode_progress. + +commit 70fb3fdcf2c5f01a555d87f8113efb50286493f7 +Merge: 1d15df4 0b034be +Author: Luca Barbato <lu_zero@gentoo.org> +Date: Mon Jun 9 18:03:54 2008 +0200 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit 71419720215a7ca7d1b1780564f21cb51d9df0a2 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Aug 6 15:45:52 2008 -0400 + + Copy all the MPEG-2 interlacing flags, as well as *_picture, in ff_mpeg_update_context(). + +commit 73608e1fa14434599aab86d2198a05ec4ca21c59 +Merge: a5285ae 6a7ac9c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Sep 16 14:38:47 2009 -0400 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + + The definition of CODEC_CAP_FRAME_THREADS changed, but + clients shouldn't have had to check it for anything. + +commit 73ad08d3b0867db89e5a81b9aec44b053e855ab3 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Mar 24 03:31:14 2011 -0400 + + Draw edges in MPV_frame_end when encoding + + These pictures don't get draw_horiz_band called on them. + I thought I had tried this, but after thinking about it realized I'd made + a typo the first time. + + Fixes make test. + +commit 74f382ae597d9cf69c885bc03c716d18fdbd413c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Mar 16 23:12:44 2009 -0400 + + Disable frame threading for MPEG-4 + + It seems to have problems with packed B-frames in mplayer. + I don't know if any other players work (at least ffplay does). + +commit 753aecc29f8f4727326f0f371fa99fefbc369d0c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Jul 15 02:58:51 2008 -0400 + + Lift H.264 display-order code before decode_slices. + This is needed for multithreading and should get us closer to CODEC_CAP_DRAW_HORIZ_BAND. + +commit 759176e401ebe8911e071f860f59b05d482315d0 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Mar 10 02:36:33 2011 -0500 + + Reorder picture_count in mpegvideo to fix ARM asm + +commit 75d4208c3a6ea4b9973b05ce930258ca8c3db224 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Jun 25 01:06:31 2008 -0400 + + Disable mbskip copy avoidance harder with threads on + Fixes seeking in mpeg4. + +commit 76211d5890819ae687cc73520bcda17115a65697 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 23 23:14:10 2008 -0400 + + Update threading comments in avcodec.h + +commit 776e2fc2d7df09d184caf414cb1d93829fe1c38d +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Mar 9 01:11:58 2010 -0500 + + Fix missed things in previous VP3 commits + + Optimization improvements only, because the pessimizations hid the bugs. + +commit 77f7818ac7b881a5aa024e31147255ed3a413141 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jan 24 19:00:24 2010 -0500 + + Fixed memory leak in todo + +commit 78c5ca40fac2dc13dac72cada9cc4b80551ee94c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jan 16 02:31:44 2011 -0500 + + Update todo.txt + +commit 78feacc6fae50a72dff68e75d0f718bc136dbe7b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jun 21 23:05:45 2008 -0400 + + Copy the other parts of MpegEncContext needed for h263 + I'm not sure if mbskip can be made compatible with frame threads yet, so it's all zeroed for now. + +commit 795b6f2d87b241e98472c8d9771d4327712c6db9 +Merge: 20d6c33 4f24e1c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Jan 13 01:52:27 2009 -0500 + + Merge mainline. + + The conflict fix in h264.c has a strange-looking diff + but probably isn't a problem. + Reverted regression tests to mainline's. + + Conflicts: + + libavcodec/avcodec.h + libavcodec/h264.c + libavcodec/mpegvideo.c + libavcodec/utils.c + tests/seek.regression.ref + +commit 79f3159ebbc55b4f2f885943badc5a847ecd612f +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 26 03:09:09 2008 -0400 + + Split longer lines + +commit 7a08d7653f38851bd950264fa78174616395fd9a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jun 21 22:09:12 2008 -0400 + + Park all the threads in ff_frame_thread_free before ending them. + +commit 7aabc98254731f46d39fb0770b1445fe332797de +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Jan 20 02:38:42 2010 -0500 + + The mplayer patch doesn't need to change vd_ffmpeg anymore. + +commit 7b14ed499f5dab39586f3b75ee03e29425b9383e +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Aug 22 16:25:59 2008 -0400 + + Remove an unused variable. + +commit 7b46b8dc0c04a77108f0150a6fdf58a9b65d4aed +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Jul 11 18:02:57 2008 -0400 + + Use USE_AVCODEC_EXECUTE instead of checking thread_count in h264. + +commit 7c7f43547b0ad8907d097b99a66f0fc3f171c9f3 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jul 31 18:22:55 2008 -0400 + + Rename H264Context got_avcC to got_extradata. + +commit 7d0709ea04d6f2023052506c969d6db9b79f2963 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue May 26 00:39:26 2009 -0400 + + Reindent + +commit 7d09b684e9948bbe0e663e40ff0ce616018c0091 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Aug 14 20:30:42 2008 -0400 + + Revert some h264 multithreading changes to make merging easier. + +commit 7e85791de30c9005ac722afd59c713c7faef5d7e +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 19 15:41:14 2008 -0400 + + Retypeset/fix comments + +commit 7e8d959053b29d975c600eb89eb453496a860961 +Author: stefano <stefano@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Sat May 15 17:34:45 2010 +0000 + + Avoid mixed declaration and code, fix C89 compatibility. + + Patch by Fran +commit 7e928f69148f6c90d35715f4380accb6fc4e88c4 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 24 02:41:43 2010 -0700 + + todo: Add secondary bug not fixed in last commit + +commit 7eac0bccc22daa54db7c40b530cf692af3f41274 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 18 16:55:03 2009 -0400 + + Update todo. + +commit 7ec92357ae09969eb5254ab6954b712d95b4630f +Author: benoit <benoit@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Tue May 22 07:58:22 2007 +0000 + + cosmetic v1/v2 renaming + patch by Andreas +�commit 7f86539559480910beab0ef568571dbe524ecda1 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jan 25 02:46:29 2010 -0500 + + Rename avail_motion() and associated functions to something better. + + What did "avail" mean, anyway? + +commit 7fc3b0d1f996b8a832017095244a3187b8d80f38 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Apr 4 00:23:21 2009 -0400 + + Remove client calls to avcodec_thread_init. + + This function has no effect under ffmpeg-mt, since avcodec_open() + calls it anyway. + +commit 802206985550e6f685e42595f529133186388acc +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Nov 15 05:19:58 2010 -0500 + + Update todo.txt + +commit 8047714299aa3fb377b011cd68858b76a666c7cc +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Aug 25 19:39:24 2008 -0400 + + Whitespace nits + +commit 80a20f0fda854e6c8de05b971164d25425105c82 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 23 21:52:47 2008 -0400 + + Don't call ff_report_decode_progress for h264 B-frames. + +commit 80a7538f955a9cd931d840e1cb4e4c81e9d85165 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Nov 15 04:14:51 2010 -0500 + + Write APIchanges. + + avcodec_thread_init() will not be deprecated in this repository to + avoid generating warnings for users who shouldn't remove it just yet. + +commit 80ab88e74f9864442afca19ecc6ee0428623ff22 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jun 15 17:46:30 2008 -0400 + + Cosmetics: rename context variable. + +commit 8218d5319067aa1ac06c601e5dc530ebdab7c01f +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Aug 18 18:43:02 2008 -0400 + + Properly handle error returns from codec functions. + +commit 821c4d0996689ab27d5ab1b6bca0695503b02670 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jun 21 22:54:52 2008 -0400 + + Add 16x8 and 8x8 MVs to MPV_lowest_referenced_row() + +commit 822ed86c0ac4de7c38d443e23fcabf1b627118ea +Merge: e340cac 17c125c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Nov 18 13:58:23 2008 -0500 + + Merge mainline. + + Conflicts: + + libavcodec/h264.c + libavcodec/mpegvideo_enc.c + +commit 82324906156d303d5f3b3e10a1855bf05614ebfc +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jul 18 02:24:09 2010 -0700 + + Revisit d812c6f8b1d897734d6f7b5f1a5c95d3aa10a3ea + + The sps/pps_buffers logic wasn't correct, considering that SPS/PPS + can be found far before the first working frame. + + Unfortunately this adds more code than it removes. + + Fixes a crash and a memory leak in premiere_paff.ts. + +commit 824ee1ac826b89b84cc93fb77f38ec6530909f2b +Merge: 686ea24 11dcccd +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jan 17 03:39:49 2011 -0500 + + Merge remote branch 'mainline/master' + +commit 83b344d87b97ef6b72e84c145f2185f87ce22e9b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Apr 4 00:27:47 2009 -0400 + + Forbid calling avcodec_thread_init after avcodec_open. + + Although ffplay used to do this, it never worked, since codecs + were free to check thread_count in their init functions. + +commit 83c7cc1ca1afe68b339b8554634a3a1effc76b45 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 19 21:24:03 2008 -0400 + + Add more to todo + +commit 83cbbb1a92d58a850d5b254b5f54e78a7bad8ca5 +Merge: ae7e6bb 7e61a90 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun May 30 09:59:29 2010 -0700 + + Merge mainline. + + Conflicts: + libavcodec/avcodec.h + libavcodec/h264.c + +commit 8414fc85d03776bc622c9451e9b08f047af42676 +Author: Uoti Urpala <uau@glyph.nonexistent.invalid> +Date: Sun Jan 2 11:52:30 2011 +0200 + + pthread: fix failure to initialize frame fields after flush + + Commit b67d7055bf ("Clear returned pictures immediately after copying + them.") moved some code used to (re)initialize per-thread data before + starting to decode a new frame. The commit changed this to be done + after the results of decoding the previous frame had been returned to + the caller. This was buggy: when decoding state is flushed some + decoded frames may never be returned to caller, and thus there would + be no reinitialization before reusing the same thread for another + frame after the flush. In particular, *got_picture_ptr could be + incorrectly set when calling avcodec_decode_video2() after seeking. + + Move the initialization code back to the previous location before + starting to decode a frame, but leave a line setting + PerThreadContext->got_picture to 0 also after returning a frame and + add a comment explaining why it is there. + +commit 846ae640182b4775db5b32cb027d964bf85d54a5 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Jan 21 03:16:03 2011 -0500 + + Longer comments in thread.h + +commit 84a94407509525ffca2e1691a73d186d0d10b1fd +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 19 01:14:36 2008 -0400 + + Remove whitespace change from mainline + +commit 84cde2e4c7d97f3a9b5f9d4a4c722ccf38c82742 +Merge: f139f42 e73c602 +Author: Luca Barbato <lu_zero@gentoo.org> +Date: Tue Jun 24 13:31:01 2008 +0200 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit 854cff1a75a0c4433d6a25517326b2660a56693d +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed May 28 01:05:33 2008 -0400 + + Enable multithreaded MDEC. + +commit 85730bc96115f75524f2780059a26ee6dbd8695e +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 16 01:30:59 2008 -0400 + + H264: Skip filling in the parts of frame num gaps that are bigger than the number of reference frames. + + My sample with a 256 frame or so gap doesn't work with ff_delayed_release_buffer otherwise. + No change on MR3_TANDBERG_B.264. + +commit 8666b987a1df652d830db8bae9c2d56287a8fc88 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 16 14:18:13 2008 -0400 + + Clarify comment for AVCodecContext frame_number + + Number of frames returned vs. decoded isn't the same anymore + +commit 8682f8c0c7396bfe1bf9b4be3293beb4c6a10927 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Aug 22 03:25:03 2008 -0400 + + Rename and update comments for AVCodecContext variables. + +commit 86c6c4cff0bf8a734592f31591ec6fafb456387b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Mar 9 01:46:32 2010 -0500 + + Cosmetics: fix overindent + +commit 878ad7601ad8eddec124877eb9b30b3df4a8c8b8 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Feb 1 21:45:18 2011 -0500 + + Add missing test script. + + Haven't used this one in a while. + +commit 87a9ad1b28ec7a4c9b08b949486010098c06a752 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jul 14 23:17:13 2008 -0400 + + Don't copy padding_bug_score. + This changes during h263 decode so it introduces a race condition. + Having a score for only every 1/n-threads frames is hopefully not too much less inaccurate. + +commit 880990f352fd8d557538535fc0496aec47d1c407 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 19 00:42:56 2008 -0400 + + Cosmetics: rename input and output context members + +commit 8884655418183d2ccde654febc9a88e8398c978a +Merge: 8232490 f991c07 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Aug 1 04:46:21 2010 -0700 + + Merge mainline. + + Conflicts: + libavcodec/avcodec.h + libavcodec/vp8.c + +commit 8919a66d8ff492adc9455fd73f1da05d154281ff +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jan 15 19:27:39 2011 -0500 + + Re-enable multithreaded mpeg4. + + Seems to work in mplayer, and is needed so I can investigate fixing the buffer + age+skip optimization. + +commit 8969edf8b07437e9110db82b7c75e57c00c3e842 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Aug 22 02:53:04 2008 -0400 + + Split a long line further. + +commit 899a30063b23ff008bbea3560c28fa194cfb1d77 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Aug 11 18:04:42 2008 -0400 + + Simple patch to keep the non-pthreads OSes working. + + They ignore thread_algorithm being set by the user for some minor simplicity gain, since I'd still like to see these files gone from mainline. + +commit 8a2e487269389d778ddf517baaff590b0a7b3f46 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jan 24 16:55:35 2010 -0500 + + Don't allocate thread_opaque progress with frame threading off. + + It's not needed for anything and the extra check in ff_await/report_* + isn't slow. + +commit 8aa204a70a7f068f46f00e0983b4617f8030544a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu May 29 00:19:26 2008 -0400 + + Fix comments for new avcodec fields. + +commit 8ae6601b670156b36b227e2a3c0d9cdc72294bd5 +Merge: c91d7a2 cef0309 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun May 23 01:43:27 2010 -0400 + + Merge mainline. + + Conflicts: + libavcodec/avcodec.h + +commit 8ae9683ebce1e42c5bd1a24a2bcdcbf2cbfe6ccb +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jan 16 02:29:08 2011 -0500 + + Update mplayer.diff to work around incompatibility with draw_horiz_band() + +commit 8af63f450185c3b15cc2ca32d2bc1a19f5d2a28e +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Feb 20 20:02:34 2010 -0500 + + Cosmetics: rename thread.h functions for consistency + +commit 8b7a5375ad0956f546c2b614594b79c3ec54de3d +Merge: 3ad85b1 875fcc3 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Oct 28 13:11:58 2009 -0400 + + Merge mainline. + +commit 8ba50a98f87edb2b87df042f09573ea8be4a8696 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Mar 28 03:54:31 2010 -0400 + + h264: Fix ff_h264_execute_ref_pic_marking() not being called with PAFF+threads + + With some PAFF files, field_end() can call ff_h264_execute_ref_pic_marking() + during slice header decoding. This was disabled with threads on, which was wrong. + + This patch fixes it at the cost of making control flow more confusing. + + Partial fix for Chalet-Tire.mp4 from ffdshow. + +commit 8c946d1672281fc997dfb2679e7cbed48dd09216 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jul 14 23:07:07 2008 -0400 + + Set decoding progress as high as possible when multithreading is off. + This avoids possible crashes from trying to lock progress_mutex when it hasn't been created. + +commit 8d466e182aa89ca8cfbe57ce60f2a1e2a7ecebc7 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Oct 13 14:37:22 2008 -0400 + + Fix incorrect frame num gap handling. + + Fixes ORF1HD.Demo-Loop.720p.DD5.1.mkv from x264 samples. + +commit 8d8229014f489e1b2417676d9753f784d995e6c0 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Dec 1 17:21:38 2008 -0500 + + Don't crash if flush_buffers is called after init and before the first decode. + + Fixes mplayer -ss + +commit 8f759fa0e956f8cc33ccd423cefae23e25c16caf +Merge: 9be00ab 1e8ecf7 +Author: Luca Barbato <lu_zero@gentoo.org> +Date: Tue May 20 11:46:04 2008 +0200 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit 9017898687ebedca27e47fdd13e6e5e208a5fbb6 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Aug 28 00:52:29 2008 -0400 + + Pad the frame data properly + +commit 9059683b29cd601361e477289a194e679aa72f8c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 12 16:22:27 2008 -0400 + + Limit ff_find_unused_picture to only part of s->picture. + + Otherwise, a thread may call delayed_release_buffer and then later allocate a picture in the same place, reusing the other Picture variables while they're still in use. + +commit 9077d0ba4ed18e1f106723d155e81461c8951764 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Feb 17 00:55:36 2010 -0500 + + Comment recent change to update_context API. + + Notes: + - It might be possible to revert this by making the vp3 decoder + behave like mpegvideo. Not faster but the code will be simpler. + - I don't like any of the old comments, they're too wordy. + +commit 9153938f1c1f0933ec59cee14cc26b8f99bd9090 +Merge: 661ca40 e48fb07 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jul 23 21:14:58 2009 -0400 + + Merge mainline. + +commit 91a7b18346baf82e0ccf6dfb53ada22299396f17 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 16 16:42:33 2008 -0400 + + Call codec init and free on the first thread context instead of the main context. + + This is needed so we can stop using the main context for decoding threads. + +commit 91a7c2254bb3e82862c4cd916bd9f2ac1dd4c170 +Author: lucabe <lucabe@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Thu Sep 23 09:16:05 2010 +0000 + + Allow to set the frame rate in v4l2 devices + Patch by Jos +� Miguel Gon +commit 91cd95a84759702b85de68047d21a6ef9d32eaca +Merge: 77f7818 f9f7b02 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jan 24 21:39:20 2010 -0500 + + Merge mainline and libswscale. + + Upstream now always calls avcodec_thread_init(). + It's better to do that differently here, so the + current code in ffmpeg.c has been kept. + +commit 92672ea0eee93244cc78e5023f6469c5b21754b5 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Aug 18 19:10:01 2008 -0400 + + Simplify: better use of variable names instead of weird struct accesses + +commit 93ac615ccf788df20279aa613f3fdc78d4bfcf18 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jul 14 23:56:22 2008 -0400 + + Simplify assert. + +commit 9457fb1458998f893b7e1f06f1144f8203cd0025 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon May 25 22:38:36 2009 -0400 + + Don't try to check list1 when it's not filled. + + 9.1s -> 9.0s on 5cm.mp4 + +commit 94985fa9745e2affd0cf3145fa35cb8ae87e7848 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun May 31 00:08:41 2009 -0400 + + Ensure the minor version is higher than mainline. + + Missed this in previous merges, but I think it's important + to avoid confusing anyone reading ffmpeg tool output. + +commit 9576774bbee0215c0ab7bbb868ff35dff00ab900 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Aug 24 03:02:44 2008 -0400 + + Merge ff_*_release_buffer into one function for simplicity and correctness (the non-delayed version was not really ever safe). + +commit 967e65496780c089956f2dc199b541dae3a3d9cb +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Dec 18 14:37:04 2008 -0500 + + Some todo entries I forgot to add + +commit 96d6751af35556785037bdddb500eeb7b47795e6 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jul 14 23:08:45 2008 -0400 + + Call ff_thread_init() before the codec init. + This makes USE_AVCODEC_EXECUTE() properly available during init. + +commit 9816b66fb55fe03fd6f2a4db9390bdaa59eac697 +Merge: 1292a18 918f7b5 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jan 22 03:39:04 2009 -0500 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + + Changed the value of CODEC_CAP_FRAME_THREADS and + adjusted use of config variables to match mainline. + + Conflicts: + + libavcodec/h263.c + libavcodec/h264.c + libavcodec/mpeg12.c + libavcodec/mpegvideo.c + libavcodec/pthread.c + libavutil/common.h + +commit 99ed04d4d7b7183a4d0a1b8833eee3b506e13ff0 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Jan 21 01:34:57 2011 -0500 + + Remove change to compute_pkt_fields which is no longer needed + + May have been fixed by introduction of pkt_dts, but I'm not sure. + Either way, tests pass. + +commit 9a88884c03cd40d1fcbd247f1b004848fb629a11 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Aug 6 20:55:20 2008 -0400 + + Simplify thread init and make more of its functions static. + +commit 9b27ce1e721a021128380e47e83a06f25c52e998 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri May 15 15:53:28 2009 -0400 + + Fix race condition decoding H264 direct prediction + + There may be some code merging possible here. + +commit 9bac2ee137d9b8152e3beb98681b07f665cd58ee +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 5 20:36:38 2008 -0400 + + Cosmetics: rename ff_mt_*_buffer. + +commit 9be00ab6113d71a020eea4fd4483b8483efbb29d +Merge: 63f663f 1531623 +Author: Luca Barbato <lu_zero@gentoo.org> +Date: Sun May 11 08:53:10 2008 +0200 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit 9c241058a255e1da6adec7db81e22d4ff8b2b6b2 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 19 04:09:25 2008 -0400 + + Copy the entire reference list arrays in case they're used. + + And that's it for SoC period commits. + +commit 9cd1083269334de974acdf13dd94451c178a0eca +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Mar 29 04:47:23 2011 -0400 + + Fix mdec + + init_copy rotted due to data structure changes. + +commit 9e0e492fe88ec0c7ec400e9afdbef8356280fc16 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 5 00:21:25 2008 -0400 + + Update the guard clause on avcodec_thread_execute(). + + It already works fine, since all codecs check USE_AVCODEC_EXECUTE themselves before calling it, but the function is for some reason part of the public API. + +commit 9e615b8534c98947cbbe6ada5047e95c36e14cde +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Sep 3 20:40:45 2008 -0400 + + Rename symbols to not mention decoding + +commit 9e981c8d263986e67de6170895125b1de7e62ddd +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Aug 11 02:05:50 2010 -0700 + + vp3: fix mt decode of 4:2:2 and 4:4:4 content + + The threading improvements are poor and looks strange: + real 0m14.337s + user 0m13.200s + sys 0m1.132s + + real 0m13.434s + user 0m19.409s + sys 0m7.091s + + real 0m11.610s + user 0m21.870s + sys 0m7.303s + + real 0m7.976s + user 0m20.681s + sys 0m3.277s + + There may be a bug related to await_reference_row() being called too many times, + as it's in a loop per-chroma superblock and there are 2x as many of those + in 4:2:2, but not 2x as many MVs. + + No idea why 4 threads have less sys overhead. + +commit 9ec47e33af6776b94875c91288db852a333a6f63 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jun 21 22:01:43 2008 -0400 + + Split the code for completing all current frames out of ff_frame_thread_flush. + +commit 9ec9f0868de2df3d3448dec887e7440ebb006b27 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Aug 2 16:14:21 2010 -0700 + + Fix the last commit testing the wrong variable. + + Luckily the idea was still right. + +commit 9ede817a98a263093ca7965f8754a1770ef031de +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Jul 11 23:01:47 2008 -0400 + + Add a new -debug for tracing get_buffer calls. + +commit 9f15b87679392902206264383c16c7440d8c0f06 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jul 6 15:35:10 2008 -0400 + + Extra line snuck in while merging mainline. + +commit 9f6a425684e0fd0ac3f8bbd37ca4e2bc96e05d5b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon May 25 20:30:08 2009 -0400 + + Fix race condition with MBAFF frames. + + mb_linesize is 2*linesize for MB_MBAFF too, which wasn't counted + in mc_dir_part_y, so the part of the MV added to 16*mb_y was 1/2 + the right magnitude. Fix this by halving mb_y too (safe) and + doubling row values for MBAFF later. + +commit 9ff8764a15cce3fcf3f64270d7d4ec52a3ca7d1a +Merge: 94985fa 08bbd7d +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun May 31 01:19:07 2009 -0400 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit a1005396f05f5bc13c6aa6875337dbd0e6c4cd03 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Aug 6 20:45:06 2008 -0400 + + Merge framethread.c into pthread.c. + + Git doesn't track this very well... + +commit a1a5c549efd3a376fd5c8c77d49acfab89f8fdba +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jul 12 02:19:59 2008 -0400 + + Factor out size of delayed_pic. + +commit a210b422361b051ba73c115fe6bf65eaa745b19a +Merge: f9515a4 ec6213f +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Dec 24 22:08:34 2009 -0500 + + Merge mainline and update swscale. + + As a side effect, this fixes Theora/VP3 decode being broken. + + Conflicts: + ffmpeg.c + libavcodec/avcodec.h + libavcodec/h264.c + libavcodec/mpeg12.c + libavcodec/mpegvideo.c + libavcodec/vp3.c + +commit a2371d6c9b8837b472e22539642883979eac2ddf +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Nov 18 14:26:37 2008 -0500 + + Update todo. + +commit a2efd25ba04e0cb61823cbf765651f437b691b09 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jan 6 06:31:45 2011 -0500 + + Update todo.txt and move one issue out of bug fixes that isn't a major issue + +commit a2fb22fb6988742ee28ee61e2e21fa05125517a9 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 30 04:20:03 2008 -0400 + + Don't prefix static function names. + +commit a3a2674e27f8f2641d1603ee9e92e854289a0527 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Feb 1 23:13:49 2011 -0500 + + Fix pkt_pts change to ffmpeg.c + + Caused tons of regressions in make fate. + This needs to be merged to mainline_patches. + +commit a4599a7f4e4a865a0b402297b4f5a11e9ca34a27 +Author: benoit <benoit@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Thu Jan 10 10:16:36 2008 +0000 + + Make pp_help a constant array of characters to move it to .rodata. + Patch by Diego 'Flameeyes' Petten +� flameeyes commit a5285ae4d452abed92f43e2a7a24dd821343a39c +Merge: a7b8cb3 6a3f0e9 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Aug 23 22:31:19 2009 -0400 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit a564fda546ce3bfd04cf8a0e4ec4fb1b6d40e010 +Merge: 287e761 5b4608b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jan 4 03:56:32 2010 -0500 + + Merge mainline and libswscale. + + Auto-merge failed on h263.c for no apparent reason; the patch was + reimplemented by hand. Note that mt isn't enabled for h263 at the moment. + + Conflicts: + ffmpeg.c + ffplay.c + libavcodec/h263.c + +commit a5cdcc9d4efcc043c01019f632dc1e5ad318802a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon May 25 20:16:54 2009 -0400 + + Rewrite mc_dir_part_y(). + + The previous one used a completely wrong value for filter_height + and didn't properly account for MVs extending past the top of the screen. + I'm not sure if MVs can be more than -pic_height, if they can this + may still be wrong. + +commit a61ab604725f647c1bcb46aa8cfb303a5c78a2b0 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 25 16:39:14 2009 -0400 + + Theora: factor out updating last_frame. + +commit a74b85567073a424d5b7fc4bd8cc1e125df170f5 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Sep 1 02:34:59 2008 -0400 + + Comment adjustment + +commit a7b8cb3c942fed6c80111519ba5505f11d61f3af +Merge: 17dcbec 23e6da5 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Aug 20 16:47:50 2009 -0400 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit a903974adc7c8dd33dfb0acc4e2d6d10c09a23c8 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Nov 11 12:45:09 2009 -0500 + + Add a next_outputed_poc to H264Context. + + Doesn't do anything yet, but makes the next merge easier. + +commit aa11b5e0df5dfcaba21552e4864807f7aa65f5c5 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue May 11 06:36:55 2010 -0400 + + pthread: Remove pointless line from frame_worker_thread() + + It was introduced in the first commit, where it probably did something. + +commit aaa05da15fa7710503544d4a94319cb10d49a8f2 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Nov 2 02:59:16 2010 -0400 + + vp3: Remove redundant y*fragment_width+x calculations + +commit aacc74c0e2b047340a1a22f5c28aa03a4294aa03 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jul 14 03:40:15 2008 -0400 + + Reindent. + +commit ab4c84dd28c0375a6ed4f77f37ada3b94b2136a0 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Dec 1 17:20:10 2008 -0500 + + Don't hide the warning about direct rendering in mplayer. + +commit abb53ce0e02d31fb282f55cecb58f9b0c4f5c136 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Feb 6 19:18:31 2011 -0500 + + pthread: Remove useless line + +commit ac2e1b12b5e608b80581d731c4f3a0d6c033e9e0 +Author: benoit <benoit@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Tue May 29 14:35:29 2007 +0000 + + allocate PPS and SPS dynamically + patch by Andreas +�commit ac4539fba6d825d683d4a7d27f0045d068fe4595 +Author: benoit <benoit@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Mon Jan 7 12:48:42 2008 +0000 + + Mark the ff_svq1_frame_size_table as constant. + Patch by Diego 'Flameeyes' Petten +� flameeyes commit ac4c37360b21a14e9b26502a299f831b8448a10b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Nov 15 02:43:15 2010 -0500 + + Cosmetics: remove the COPY() macro + +commit ac7f2102c4249a89144c36944e13bf6be56e9190 +Author: kabi <kabi@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Mon Apr 8 12:32:01 2002 +0000 + + * support for .au .gif .mov .mp4 by Fran +commit adfaa1f86196156e30c54799303269f4a4f84a2d +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jul 26 16:14:00 2008 -0400 + + Cosmetics: split a long line. + +commit ae2790af78a332a6aa836607a14546c5cc1865e5 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Oct 12 18:55:48 2008 -0400 + + Add multithreading for PAFF/MBAFF. + +commit ae4251429ee5e333fc705c61959417c1d9364b9e +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Nov 18 14:15:24 2008 -0500 + + Switch to mphq git module + +commit ae7e6bb9708a0f0dac89295c788266e0f15899d2 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue May 25 03:14:27 2010 -0400 + + H.264: Fix rare race condition. + + h->mb was not cleared when initializing a new decoder thread. + This could cause wrong pixel values in the first macroblock of + the first frame to be decoded by each thread. + + I suspect this is nearly the last visible bug affecting x264 content. + + Fixes [SS]_Angel_Beats!_-_06_(1280x720_H.264)_[A01DDBD8].mkv. + +commit af52a126f36cd6339f9f4a1152103ef88b4b8fee +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jun 27 18:09:49 2009 -0400 + + Call handle_delayed_releases() before update_context(). + + This allows releasing frames in update_context(), which would + previously cause a race condition/deadlock. + +commit af79370b65b396e05c319d29356e456a8f5e8233 +Author: benoit <benoit@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Mon Jan 7 12:44:49 2008 +0000 + + Make the av_class member of PPContext a poiner to constant AVClass. + Patch by Diego 'Flameeyes' Petten +� flameeyes commit afafe7361da5a9373d02dc60d597da8f2185edd3 +Author: michaelni <michaelni@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Sat Nov 2 10:31:37 2002 +0000 + + added perm inheritance from ffmpeg_g (it looks like 'strip' in BeOS doesn't keep them, though the Linux one does !?) + patch by (Fran +commit afc391b7ab5eda271733bbe55ef46118aba75bff +Author: michaelni <michaelni@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Sat Jul 20 20:05:50 2002 +0000 + + beos/mov/adpcm patch by Fran +commit afe0428ae38f68a467b43cc9358b7a1a2f85d36b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 16 18:09:11 2008 -0400 + + Fix memory leak in mpegvideo + +commit b05eb30ba838b981c769217e1d2215777484f25a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Jan 21 02:34:46 2011 -0500 + + Make the src parameter of update_thread_context() const + +commit b07e45974b2772e3a747502f976dc08d0ffcff74 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 18 16:21:03 2009 -0400 + + Indent. + +commit b125b68fe6dc2d0064d45d0cffc3bcb47263f32c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jan 24 18:50:32 2010 -0500 + + Remove fixed entry from the todo. + +commit b18683e3adc997b19cf56f459ce5f8a7428c0909 +Author: diego <diego@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Sun Oct 18 14:34:45 2009 +0000 + + Fix typo that mistakenly slipped into previous commit: + CONFIG_MPEG_XVMC_DECODER was changed to CONFIG_MPEGVIDEO_XVMC_DECODER. + patch by Onur K +� +commit b1c8c18fe11d3155b1df6a19117d14fa633bcd15 +Author: michaelni <michaelni@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Sat Nov 2 10:39:22 2002 +0000 + + added MACE (Macintosh Audio Compression/Expansion) 3:1 & 6:1 support + contribution by Laszlo Torok <torokl@alpha.dfmk.hu> + 4CC 'MAC3' and 'MAC6' in Quicktime. + It works for mono streams, needs to be fixed for stereo when I get my hands on a stereo sample :) + patch by (Fran +commit b3cdfccd2b11e247e0c17e02d0c958888da5585b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Nov 15 04:14:41 2010 -0500 + + avcodec.h: Update comments + +commit b3d5e9333051802b20446076605b404e418323c4 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue May 26 00:34:11 2009 -0400 + + Skip unnecessary lock-wait-unlocks for condition variables. + +commit b3e3f071ca5ad99444bac95e4128c01a8ae7bae3 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 11 11:32:00 2009 -0700 + + Split out if (current_slice == 1) + +commit b4221d5453d6dc893e87b77eecc845da121ddb56 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Aug 18 17:06:32 2008 -0400 + + Reorder ff_frame_thread_free to fix memory errors. + + This fixes using mutexes after they're destroyed and not calling release_buffer on every buffer. + Unfortunately the change to MPV_common_end is exactly the opposite of what's needed for supporting width/height changes. + +commit b483ed4f4af9444cfaa6ff9336645d799d2254dd +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Aug 6 20:33:51 2008 -0400 + + Remove the unused debugging counters from frame threading. + +commit b67d7055bf60313c40b6369f98cfc9d1eae3aefb +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Sep 2 00:52:48 2008 -0400 + + Clear returned pictures immediately after copying them. + + This isn't protected by a mutex but is still safe. + Needed for the next commit. + +commit b68110d079914d16c9fc5d1cc8c6e10d78dbdbca +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 16 15:05:49 2008 -0400 + + H264: Set the decode progress for fake reference frames to the maximum. + + Fixes deadlock in premiere-paff.ts at the expense of some indeterminism on the first frame. + +commit b77accec9077ae8f072091fc7301d661bc9487ba +Merge: 5d3c2f7 392faa1 +Author: Luca Barbato <lu_zero@gentoo.org> +Date: Tue Jul 29 15:11:05 2008 +0200 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit b7d182610b592eef0714c1d2de18c3233a289b69 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun May 24 01:06:33 2009 -0400 + + Update mplayer.diff whitespace + +commit b7e0f1a3bfd00b0256dcdd3efc4b7b77c086e70e +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Aug 24 22:38:42 2008 -0400 + + Rename doxygen group to not conflict with h264 + +commit b88c3baf94247f2687ca0c05b0ce6af7c905e02a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon May 24 22:40:00 2010 -0400 + + Fix more old merge glitches. + +commit b9a8973031be583af53be890ccdef07841394385 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jun 15 22:31:35 2008 -0400 + + Use output_cond for notifying the main thread. + +commit ba073d39f18679835b48b96f20feae96dad1f343 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Apr 11 23:00:19 2011 -0400 + + h264: cosmetic whitespace change + +commit ba8b789143dc6a14c29393e40fb361c1a3e2ccd4 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 16 01:53:10 2008 -0400 + + Update todo + +commit babb66241ae51e2956aa698d425c645ad056936e +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Oct 17 14:52:35 2008 -0400 + + Copy avctx->height/width for mpegvideo. + + Not sure what the difference between the three width variables is, really. + +commit bad2bf8621c04791f0d9a0a2873a3b6042d4ba83 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun May 24 00:48:57 2009 -0400 + + Copy new fields in update_context_from_copy(). + +commit bb67674aa57e23893f2f19bd4ffb4a92b5a01e83 +Merge: 06ac5ac 6051838 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jun 20 17:39:15 2010 -0700 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit bba0e098a75f14af80bfd4fdfdf9edcaf8f3fee5 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jun 20 03:32:19 2009 -0400 + + Factor out vp3 table allocation into new function. + +commit bbc5744117da188c43e00c4f02f6ff0fe984d4f8 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jul 13 15:52:21 2008 -0400 + + Print the AVCodecContext address in av_log instead of AVClass. + This makes logging much easier to read when there's more than one context. + +commit bc1cc6f39a0f6df2cc1d0fecd3eb14efd150763a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Feb 3 01:29:21 2010 -0500 + + Cosmetics: Don't use #if HAVE_PTHREADS in thread.h. + + These two macros will be removed entirely in the future. + +commit bd392934097dc5c909e9b06550ec1d13d92fa134 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Aug 15 23:34:32 2008 -0400 + + Set output_size properly before calling the decoder so it doesn't return nonsense and crash at the end + +commit bd63cf4721466aea490f6f0455a32060d572d5ba +Author: michaelni <michaelni@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Sun Jul 21 07:54:53 2002 +0000 + + YUV410P to YUV420P patch by Fran +commit bdaeaaa58f24393027e112c02896b23fe0b3cc01 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Oct 13 11:23:47 2008 -0400 + + Add buffer padding to the end of bitstream_buffer. + + Fixes a warning in valgrind. + +commit bdef29429d4f488012cb492e61cf20ffe0b858a7 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jul 6 15:48:52 2008 -0400 + + Fix compilation with threads disabled. + +commit be45bc423ba576e1d06df3664cfe91e02d78ffa5 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Feb 15 00:00:35 2010 -0500 + + Fix a deadlock in mpeg1 threaded decoding + + Fake frames need their progress set to INT_MAX. + + This can be triggered by seeking in mpeg1, but this is not the correct fix, + since seeking to keyframes does seem to work properly without threads. + +commit bf806642ab67148d93a4f24e7dbdc8644575c45b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jan 24 18:59:28 2010 -0500 + + When frame_thread_init() fails, free the failed thread context as well. + +commit bffb1c874ec2c9f7ea9c6830d852955a3c2805a0 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Aug 6 20:51:34 2008 -0400 + + Make ff_*_thread_free static. + +commit c01185fe11dd2ce35f798d16faec17fcfc64c7c4 +Author: kabi <kabi@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Fri Mar 8 09:09:57 2002 +0000 + + * BeOS patch by Fran +commit c05a51580b56d1479083b1460dc29492b3fb6b16 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 19 00:53:15 2008 -0400 + + Track allocated buffer size properly. Don't allocate buffer padding since the user already did it. + +commit c1b0bddeaf947ef49c63b412918d73fe7a645ba5 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Nov 15 04:08:01 2010 -0500 + + pthread: Update and sort the fields copied in update_context_from_thread/update_context_from_user + + Changes to pthread.c are finished. + +commit c29d645dfd2c8168e7c9009638ddb88928e706be +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue May 11 06:12:26 2010 -0400 + + Copy time_base between threads. + + Appears to be used by the h263 decoder. + +commit c2a400d3a5da10f8f2a9c2aa89d9396efe428029 +Merge: b77acce e96a4b0 +Author: Luca Barbato <lu_zero@gentoo.org> +Date: Thu Aug 14 22:16:09 2008 +0200 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit c2e19261fe08c2d96d4bf082e97bebcdf12566f2 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Feb 20 21:24:24 2010 -0500 + + Remove USE_FRAME_THREADING and USE_AVCODEC_EXECUTE macros. + + Requested in original review, might help making sure pthread emulation + works for encoding tests. + +commit c2e9a1fc965de63271c7c4ddffd7e938ce1bfd93 +Author: benoit <benoit@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Tue Nov 6 16:28:32 2007 +0000 + + ffplay currently needs special handling for pausing in some protocols. + Patch by Bj +�rn Axelsson: bjorn ; axelsson commit c2eed2a91101a90f2172e81755ca4d655de90443 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Nov 3 22:13:07 2010 -0400 + + vp3: Cosmetic changes + +commit c370b927b6d1f0e092e43d58ee29046e5accad1a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Feb 6 19:18:10 2011 -0500 + + Improve comment in avcodec.h + +commit c378f545f65d536e55ebe1ac85d170a15e7748eb +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Aug 6 20:12:01 2008 -0400 + + Reindent. + +commit c45bb41ec61522dcdb97618a0f6fafd8a32d529b +Author: benoit <benoit@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Mon Jan 7 12:42:02 2008 +0000 + + Make v4l.c's video_formats constant and static. + Patch by Diego 'Flameeyes' Petten +� flameeyes commit c4649d2e370c04c7f5cfcf0b444edc6116ba03f8 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jan 25 03:16:09 2010 -0500 + + Avoid freeing buffers twice when closing mpegvideo. + + This fixes a harmless "unreleased buffers" warning due to the design + of delayed releasing. This is probably a bad way to do it (won't + work if resolution changing is supported) but I can't think of a + better one that's simple. + +commit c5137d0d9e355aecc7e60cef0d2314468b77a147 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jan 15 22:52:30 2011 -0500 + + Update todo.txt + +commit c563b57b187279c1af0f723110bdab815fac6385 +Merge: 65e8486 6a3327b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Apr 3 21:23:47 2009 -0400 + + Merge mainline. + + Conflicts: + libavcodec/avcodec.h + libavcodec/mpegvideo.c + +commit c58218c681e51a1b392ddb0177dcff8fc8e99d1c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 12 00:45:01 2008 -0400 + + Use HAVE_PTHREADS instead of ENABLE_PTHREADS for mplayer compatibility. + +commit c5ca1f6b5227f8f7a26f889c123c4358ee15596e +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jan 15 22:51:43 2011 -0500 + + Pass pkt_dts properly through multithreading + + A/V sync should work in all cases now once guess_correct_pts()/clients + adopt AVFrame.pkt_dts. + +commit c6a59ddd734c7ca92862bce47ec686e16da627ee +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Jun 19 18:32:12 2009 -0400 + + Remove frame_num stuff from todo. + + The current code is actually correct. + +commit c6bbd5d91408d6dd795dfbbdfba2cef62696d765 +Author: michael <michael@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Sun Jan 8 17:06:26 2006 +0000 + + fixing second last time Fran +commit c6f5097967de5ed420cd56a1a77b60a705fcee48 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 16 05:09:03 2008 -0400 + + Disable frame threading if low_delay or randomly truncated frames are used. + +commit c75cec5217fc23206476e2d1c894e8a6ddcd81b9 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Mar 29 02:25:19 2009 -0400 + + Fix missing ff_get/release_buffer calls in mdec. + +commit c83670eeb613b9509555d4ddcac559a37cc1c5bc +Merge: 2063f77 dde06af +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Dec 15 15:20:06 2010 -0500 + + Merge mainline. + + Version wasn't updated this time. + + Conflicts: + doc/APIchanges + libavcodec/avcodec.h + +commit c91d7a205df4dd224461b96749b9ce12e2bf6825 +Merge: 4874d25 04c74fc +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed May 19 16:51:42 2010 -0400 + + Merge mainline. + + Conflicts: + libavcodec/avcodec.h + libavcodec/options.c + libavcodec/utils.c + +commit ca89b49eff34604b1354888cd041f474d988c122 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jun 23 04:16:16 2008 -0400 + + Fix ff_frame_thread_flush() + It should setup the context to be just like decoding starting from scratch. + +commit cac4bca0570a9b9ffdd3b49590fe1e41fd5568b0 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jun 27 15:02:21 2009 -0400 + + Fix conditions for drawing edges. + + They shouldn't be drawn for B-frames/intra only (for speed) + and when hwaccel is on (for correctness). + +commit cba830597c99b7a6de57b3cd2209d22598bb72b1 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Feb 13 22:45:07 2010 -0500 + + Backport VP3 crash/deadlock fix from mainline r21781. + + Previously, if get_buffer() failed when allocating a golden frame, + it would access it in a later frame without checking it first. + r21781 unintentionally fixed this. + + This should be impossible to trigger, but some other bug in -mt + causes this with frequent seeking. + +commit cbaa375d4cb1320093199e8abe1ce7bcf389036d +Author: michaelni <michaelni@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Sat Nov 2 21:05:54 2002 +0000 + + gcc optimization on BeOS (patch by Fran +commit cbc8d8bec42b371522b0724f27454a96881c4164 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Apr 19 02:47:32 2010 -0400 + + Disable multithreading the first field in PAFF. + + At least one PAFF .mp4 file has two fields per packet, which can't + work with -mt - instead it needs to split the fields up like packed + B-frames do. + + Fixes Chalet-Tire.mp4. Pessimizes otherwise working files. + +commit cc33ba7cd7ebbf14b62b0783fb7272e41b484aea +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue May 11 14:41:53 2010 -0400 + + Cosmetics: arbitrary reordering of some pthread struct members + +commit ccd0d039a3d2fd70a9e947cc2faf79ca091dd687 +Author: Luca Barbato <lu_zero@gentoo.org> +Date: Fri Apr 25 21:52:45 2008 +0200 + + Incorporate swscale as submodule + +commit cd71fb4386961bc860c3abc4cf464b580366d57d +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Jan 25 16:33:26 2011 -0500 + + Forgot to git add the test failures list + +commit cdc193d0dbc2f0775d177f46036eca0d813f56ff +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jul 6 15:53:33 2008 -0400 + + Use static functions instead of macros for consistency. + +commit cf2561f8dcc3143f9c479bba1d9be91339f23726 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Jan 21 02:22:56 2011 -0500 + + Write longer comments for callbacks + + Also neglected to update get_buffer to mention thread_safe_callbacks + +commit cf528d74cd7321219880eb06b94a8de0ba5741ff +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Aug 17 16:50:51 2008 -0400 + + Fix another memory leak. + +commit cf56bb126e7c056740e51c6c13304b03260b4b47 +Merge: ccd0d03 08baa31 +Author: Luca Barbato <lu_zero@gentoo.org> +Date: Sat May 3 12:18:40 2008 +0200 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit d0c772c8021702ca79ce2aceeba75902231c0101 +Author: michaelni <michaelni@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Tue Jul 23 22:05:35 2002 +0000 + + patch by Fran +commit d103d4fac41b32915b45534d49d1e6a195b4220b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Feb 3 01:00:14 2010 -0500 + + Simplify thread.h by removing the stub functions. + + They don't really help anything, if (HAVE_PTHREADS && ...) is sufficient. + +commit d15ab0f03a257293c0e13eac8b9b031da73c48f3 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Jun 3 04:41:33 2008 -0400 + + Macroize some threading checks. + +commit d21f769ead6bd4c24d867b7e9beeb8ffcc86b271 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Aug 6 20:36:04 2008 -0400 + + Revert renaming pthread.c. + +commit d2f8287d8526f814bcc88d827775d39ddc5c5f22 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jan 17 14:34:22 2011 -0500 + + Update todo.txt to put important things at the top + +commit d359ab19a25afa7dae20229e62dc0e37b6179ea7 +Author: michaelni <michaelni@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Mon Jul 22 01:44:08 2002 +0000 + + adpcm encoding patch by Fran +commit d419a1c1d30e1b171fba7dc31a909e77a08016ba +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Aug 24 03:51:18 2008 -0400 + + Comment utility functions in pthread.c + +commit d460fd8d253c90f20536dffe69a6ea20dc113106 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 19 15:57:28 2008 -0400 + + Simplify codec close + +commit d4fad7c7f05e6fd7d677eaf1069e04c94b946a0c +Merge: f3f3d11 980ab8d +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Feb 2 21:41:11 2010 -0500 + + Merge mainline and libswscale. + + ffplay's pts reordering is better now, so ffplay.c has been reverted + to mainline. + + Conflicts: + ffplay.c + libavcodec/avcodec.h + libavcodec/h264.c + +commit d5227efafd855f028338480f937b6ad4a86ef7ac +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 12 18:24:28 2008 -0400 + + Don't check MAX_THREADS unless slice threading is on. + +commit d5c16c23327d84373fca125b884254550b79c8d7 +Author: mmu_man <mmu_man@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Sun Jan 23 09:59:36 2005 +0000 + + Revert the fixed-size-sample patch as it brokes and others + WTF I thought I had commited this yesterday... was probably too asleep :commit d5ea5fc7342e3a1b082659bccd5ffd90a911b780 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu May 7 01:19:55 2009 -0400 + + Replace the number of frames option with a number of frames to skip. + + The old option wasn't really useful (ffmpeg -t saves more time) + and this is needed to deal with broken stream clips, which are + common and tend to decode differently under mt anyway, which I + don't really care about. + +commit d611b2bcb3ce231242f566cee08a61798a36abc8 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 18 05:03:36 2009 -0400 + + Fix race condition upon return from decode_init(). + + We can't call report_frame_progress on every returned frame, + because they may be returned while a past thread is still decoding + them. Instead ensure frames always have this called on them after + their decode is done. + + Should fix all bugs for valid H.264 streams without frame num gaps. + +commit d62b7c03b163c3dc067f122ab9fec44de87b37ae +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Mar 9 01:54:27 2010 -0500 + + VP3: Only call await_reference_row() for luma + + 4.3% -> 2.1% cpu on big_buck_bunny_1080p_stereo.ogg. + It should be further reducable since VP3 has limited MV range. + +commit d6bb0443c9b316b8cf29720524b4819fb2e6b6a1 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Sep 4 01:50:20 2008 -0400 + + Don't mention nonexistant variables in comments + +commit d71a7eef9e540b00b0f91d840116e43206390645 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon May 24 16:45:27 2010 -0400 + + h264: Delete lines accidentally left behind during a merge + +commit d7cfe6d5cbffa42e178d88d7c647d37431e21861 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Feb 1 22:20:19 2011 -0500 + + Fix dropped frames at the beginning of h264 decoding, fixes FATE tests + + Patch by Ronald Bultje (rsbultje@gmail.com) + +commit d8014c67ff1ef20ca05302dea9e262a3089d996e +Merge: 604ee54 4ce0d81 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat May 1 04:03:03 2010 -0400 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit d812c6f8b1d897734d6f7b5f1a5c95d3aa10a3ea +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 24 02:25:25 2010 -0700 + + Fix crash on close when decoding a single-frame h264 file with 3+ threads + + Problematic code path: + 1. sps_buffers[0] is allocated in the first thread's codec context when the + decoder is opened. + 2. The first thread context is memcpy'd to the other threads by frame_thread_init(). + 3. The first thread is closed and its sps_buffers[0] is freed. + 4. The third thread is closed. + Because it never got to decode a frame, update_thread_context was never called, + and sps_buffers[0] still contained the first thread's pointer. + + Fixed by not trying to free sps/pps buffers if the thread wasn't initialized. + I didn't properly consider this when designing it but this seems to be the + best approach anyway. + + Fixes still2.mp4 crash from Chromium + +commit d84fc3dfd3e051c782d063ccba4cc8cadba38797 +Author: michaelni <michaelni@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Tue Nov 5 00:56:08 2002 +0000 + + MIN/MAX sys/param.h patch by (Fran +commit d93fe0ea6b1b8121fdb9521fa7eeac0dc494deeb +Author: benoit <benoit@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Tue Nov 6 16:19:09 2007 +0000 + + Allow propagation of stream selection through the ASF demuxer to the + MMSH protocol handler. + Patch by Bj +�rn Axelsson: bjorn ; axelsson commit d955ab0dfa73578eaa6a9d1dcb821ce9db409738 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Mar 29 04:53:11 2011 -0400 + + Update todo. More items appeared... + +commit da70ded7141aa191b92672c343cd29a0014d861f +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Dec 18 13:27:51 2008 -0500 + + Update todo + +commit da7bdb1273da15a90bfe08ead91e397247916d11 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Jun 24 03:24:17 2008 -0400 + + Get rid of tabs + +commit da86d2da9f6a76238a9d788ecd77f714981e666d +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Sep 4 01:40:51 2008 -0400 + + Reindent. + +commit da95175e7ce1f911db992fef213322345200feaf +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jul 14 01:52:37 2008 -0400 + + Add a parameter to not draw top/bottom in draw_edges. + +commit db2a99d28931128c8598067ae06444ab79f579f8 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Jun 9 17:29:47 2009 -0700 + + Fix typo in comment. + +commit dbfbadaa095b65a724ac848d551cfa2aa33e2f6a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue May 11 05:16:14 2010 -0400 + + Update todo. + + Got another h264 bug report with the same cause as before. + +commit dc53861aadac1d43391b28e4e9793393b26394b9 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Jun 18 20:52:34 2008 -0400 + + Always set decode progress to the maximum at the end of decoding + This saves doing it for frames with AC partitioning and such. + We can't do it if the codec didn't return a frame, so there is still an opportunity for deadlocks here, maybe. + +commit dc7c4d436681e43a9f351dd18f70d0dc008aa55e +Author: benoit <benoit@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Thu Jan 10 10:18:00 2008 +0000 + + Make MMX vectors constants. + Patch by Diego 'Flameeyes' Petten +� flameeyes commit dd9e04497937b7fffdcc65a2b41e36089412d975 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Mar 29 17:18:21 2011 -0400 + + Remove unnecessary parameter from ff_thread_init() and fix behavior + + thread_count passed to ff_thread_init() is only used to set AVCodecContext. + thread_count, and can be removed. Instead move it to the legacy implementation + of avcodec_thread_init(). + + This also fixes the problem that calling avcodec_thread_init() with pthreads + enabled did not set it since ff1efc524cb3c60f2f746e3b4550bb1a86c65316. + +commit ddc8310d2a9300139d1821954dfa2d0b775edaa1 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Feb 11 22:12:03 2010 -0500 + + Fix mutex leak introduced in 0040d6f2ba. + + If allocate_progress() failed, the error condition returned before + unlocking its mutex. + +commit de365823ec9546a3bd688690e79fc15281a68f1f +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Jun 23 01:26:42 2010 -0700 + + todo: fix ugly word wrapping + +commit de736aacd945d66109197a6f04baf915d458f5ac +Merge: 7eac0bc 780a37c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 18 17:53:09 2009 -0400 + + Merge mainline. + +commit de8abf54671555bb166bb1d44a34fe14e360e2a5 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jan 24 16:37:24 2010 -0500 + + Rename and document MAX_DELAYED_RELEASED_BUFFERS. + +commit dedc2982f2f845357f28dff401fe5df8510c6a8f +Author: benoit <benoit@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Tue May 22 08:28:32 2007 +0000 + + id3v2 writer + patch by Andreas +�commit df444fadf045bf70058da9b074b8f848fc2209b1 +Merge: 14bdf76 1476e6a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Mar 9 02:04:43 2010 -0500 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit df5d7acdcd0dcbfca6f8fd4f76c9369cb1674435 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 16 17:32:24 2008 -0400 + + Don't reuse the user's AVCodecContext for the first decoding thread, and copy more values between them as needed. + + This fixes a large class of race conditions (coded_frame works again) and should improve frame dropping. + +commit dfb8be0a60b9562cf7bb6e54dd67088ff51f83b0 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Jun 24 21:35:14 2008 -0400 + + Call avcodec_get_frame_defaults() before decoding. + +commit e0285f04bed7fefba5f75d05c81b145f44fc49f5 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jul 31 18:40:46 2008 -0400 + + Use got_extradata instead of frame_number to guard against rereading extradata. + + frame_number is no longer valid internally, since I don't want to change its definition from the user's perspective. + mpeg12 does the same thing, but I can't find or create any mpeg1+extradata samples to check it. + +commit e044d5c79ab340cf52842ba8452d670959eb37c0 +Merge: 3c3a364 5115473 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Nov 7 04:54:47 2008 -0500 + + Merge mainline into ffmpeg-mt + + - Handle reordered_opaque properly + - Picture.field_picture is a duplicate of Picture.mbaff, + but is necessary, since interlaced_frame can't be trusted + and mbaff can't be interpreted without it. + +commit e0dc361e0f0aa315320a549a4fda3424226c556f +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Sep 1 03:35:23 2008 -0400 + + Update todo + +commit e174657cbb973abf5de9085d00d85ac04d29a475 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Aug 28 17:11:09 2008 -0400 + + Move avcodec_thread_init call before avcodec_open in ffplay. + + It makes no sense to have it after, since a decoder is not forbidden from reading it during init. + Encoders already do. + +commit e1f49541b976cdd091aa41f116e7c9fd0c740cf3 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Jun 17 23:35:55 2008 -0400 + + Fix rounding for mpeg1 MVs. + +commit e23b687201a076161384fbc7a2f76bd0092dd34c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Jan 20 02:36:18 2010 -0500 + + Include the delay from frame threads in has_b_frames. + + This is an API change, but anything that already counted thread_count + just has an incorrectly high max delay size, which shouldn't be a + problem. + +commit e2b9383929e2c703eabd1df8afcb9fa5ad7106ec +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jun 15 17:36:59 2008 -0400 + + Add choice of threading algorithm to AVCodecContext. + + Use it to simplify USE_* macros. + FF_THREAD_AUTO needs to be handled better - even if a codec can handle frame-threads, we still don't want to use them if there are enough slices available. + +commit e2ecdd48d664f2660bfd661f1cef6276b986743b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Jul 25 03:12:58 2008 -0400 + + Simplify mpeg_decode_update_context. + +commit e303003362829a7f2f1dcbc45d6abc9ac7a59b6a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Aug 14 22:59:01 2008 -0400 + + Reindent. + +commit e340cacc56545c5fc3a903c68fec99e8921d579e +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Nov 8 06:13:23 2008 -0500 + + Disable r15412 for now to avoid crashes. + + update_context can't handle picture pts not pointing to picture and I couldn't think of a better way to do it at 5 am. + May not actually fix anything. + +commit e345a54e5f86d9777e4c3ccb04aad84f9cd77ff0 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Mar 8 04:55:43 2010 -0500 + + Add optimization note to todo. + +commit e39c3828e02fe71ce627170bc8c26a558f29f4b8 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Feb 15 00:39:39 2010 -0500 + + Update todo + +commit e3f13a4f70b1310309ebb462b1011721cb3692fe +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Sep 4 14:05:31 2008 -0400 + + Rename new symbols to be shorter + +commit e4565c5731bfcd8808d02f47f115e21dc6fc8b35 +Merge: 4b9ce55 fb61a7c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Mar 10 02:25:55 2011 -0500 + + Merge branch 'master' of git://git.ffmpeg.org/ffmpeg + + Conflicts: + .gitignore + doc/APIchanges + ffplay.c + libavcodec/arm/asm-offsets.h + libavcodec/avcodec.h + libavcodec/h264.c + libavcodec/mpegvideo.h + libavcodec/options.c + libavcodec/pthread.c + libavcodec/thread.h + libavcodec/utils.c + libavcodec/vp3.c + libavcodec/vp8.c + libavformat/utils.c + +commit e45cf6d46cb45e6edcf9e4ac368b2a013ba30158 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Aug 14 04:01:08 2008 -0400 + + Add todo and some other files. + + Trailing whitespace in mplayer isn't my fault. + +commit e4df986f3d2d3e1be9b0f4eeda463fa854910b8f +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Aug 28 00:41:52 2008 -0400 + + Revert unnecessary setting of the wrong variable + +commit e53d020b37ca26ffa4cdb22d2b40321897f52ba9 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 23 20:39:06 2008 -0400 + + Warn if users try to use frame threading without pthreads. + +commit e717770ee8437c296e012e908b772ba2eaeb2ed3 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Jul 15 03:16:22 2008 -0400 + + Create next_delayed_pic for multithreading purposes + unreference_pic is intentionally unchanged. + +commit e71a2b5017728022fa1f992a8b541260615016b2 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Jun 18 23:22:01 2008 -0400 + + Use USE_FRAME_THREADING instead of checking for thread_opaque, since it might be the wrong type. + +commit e74ef89858732b9fc4a90c8ec8fbb701407eb987 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed May 28 22:50:22 2008 -0400 + + Split setting avctx->thread_count from the rest of pthread init. + Make sure it's called from whichever of avcodec_open and avcodec_thread_init comes later. + +commit e7519b6532409e332fc9727ea5a57e148e6655a6 +Author: benoit <benoit@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Thu May 15 01:03:48 2008 +0000 + + Make av_set_string() fail when number could not be set. + Patch by Stefano Sabatini stefanocommit e8bc7da9d69234ebbcbde371c5a0e20f8b5cfccc +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jan 25 02:59:00 2010 -0500 + + Remove accidental extra variable declaration + +commit e95251807c0ae66ffef1e4ad113b9773a287fa5a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jun 27 22:14:45 2009 -0400 + + Get rid of static variables in VP3. + + These are pointless and might behave wrong with thread-local + statics. + +commit e9a0e5eaf5207321baf90160b1094300f3810ecf +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jun 23 21:21:44 2008 -0400 + + Use FF_INPUT_BUFFER_PADDING_SIZE for the buffer. + +commit ea396d38059476a54c5855e0bd81955c60238b22 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Nov 3 22:50:02 2010 -0400 + + Rewrite comments in thread.h and fix parameter names in ff_thread_decode_frame + +commit ebce21c15f3aaf1b4512436ed8fc2e71a504bb11 +Merge: 3630d89 5570afd +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Dec 18 12:49:54 2008 -0500 + + Merge mainline. + + Conflicts: + + libavcodec/avcodec.h + libavcodec/mpegvideo.c + libavcodec/utils.c + +commit ed3e2ae1277cc425ef133f10700ace86629381ef +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jul 13 16:05:09 2008 -0400 + + Remove useless variable. + +commit ed42183540e2a886a7368b8220e0b50aaf363551 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Sep 30 16:53:03 2010 -0400 + + Fix hang decoding VP3/Theora. + + draw_horiz_band changed to only draw the displayed height instead of the + decoded height. This meant that we never reported progress for the last few + decoded pixels, but still awaited them, which deadlocked. + + This shouldn't cause any race conditions, because it always decodes the last + few pixels along with the last decoded pixels. + + Patch by Yuriy Kaminsky (yumkam mail ru). + +commit ed5e8392e2fce8e6b0468de4ae1a4310d338ee46 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Aug 28 02:29:08 2008 -0400 + + Simplify(?) threaded avcodec_flush_buffers + +commit ed728b0a05c2154b07cc3d8330d5900dbc45f1d7 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue May 27 23:25:47 2008 -0400 + + Guard against avcodec_thread_execute() being called without being setup. + +commit edb60439feb2c5d39cda314178686eea151185b3 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Nov 1 12:54:47 2010 -0400 + + vp3: Assume MVs are their maximum length of 16 pixels + + This makes it worse (although slightly simpler) in preparation for further + optimization. + +commit ee8430539ec7cc23b7cf6332e26751f539315d5b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jul 6 15:56:28 2008 -0400 + + Don't include the codecs' threading support functions without some kind of threading enabled. + As a side effect this makes non-pthreads threading even more problematic. + +commit eed4b9708287066ccc1b3042110f7c3379f63ee2 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Aug 28 01:44:44 2008 -0400 + + Simplify disabling MB skipping + +commit ef26f878e0e581cb61f1e9b376bec4f7ff07397a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Mar 9 01:48:18 2010 -0500 + + Cosmetics: fix outdated comment + +commit ef2d8664f1eff56e969801ecd1c5b7c729902819 +Merge: 11b1a8e 9c7037f +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Jun 8 14:29:22 2010 -0700 + + Merge mainline and libswscale + +commit efd1fb08db3e7964357dc00fd514cfb156b4ee69 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 11 11:33:09 2009 -0700 + + Reindent. + +commit f139f42301a5ee861f1a91cdfcceb2a85349fa29 +Merge: 70fb3fd 7210b4e +Author: Luca Barbato <lu_zero@gentoo.org> +Date: Sun Jun 22 12:08:59 2008 +0200 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit f143b66d9bf8b23985bf8ec6acf8273c3e9ccd1d +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Aug 19 21:12:32 2008 -0400 + + Handle NULL threads if they aren't started because of an init error. + +commit f1936d87290c7444090d6cb101b0d7c9270f0a81 +Author: benoit <benoit@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Thu Jun 24 15:22:33 2010 +0000 + + Set an opaque alpha value when decoding rgba ffv1. + Patch by Thad Ward coderjoe69commit f1fe312cb47cbc540da764cbab3582739a20a8d2 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 5 20:30:58 2008 -0400 + + Cosmetics: make thread.h look like other prototypes. + +commit f374d2ee585d7f6c98ffd3a7803223552497904e +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Jan 21 04:13:06 2011 -0500 + + Simplify change to avcodec_close() and fix a merge glitch in avcodec_open() + +commit f3c88f32b8c806b352cf6e00d6ac80fd32e9f54c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Sep 3 11:45:09 2008 -0400 + + Field picture API support + +commit f3f3d1189de648862ca204676dd7591262f590df +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Jan 25 04:12:34 2010 -0500 + + Add todo note about a change to thread.h I mean to do. + +commit f4d4d43f3a596941b2214ac1e71bb818eb230d6b +Author: Alexander Strange <astrange@ithinksw.com> +Date: Fri Jan 21 02:43:30 2011 -0500 + + Minor update to thread.h comment + +commit f4fb456b114eafc22b8ab9bb0bb3e7f13a4fbd9a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Nov 2 02:56:12 2010 -0400 + + vp3: Revert motion_y removal + + Although it doesn't have much of an effect on speed either way, I reconsidered + the simplification I wanted to do, and now I'd rather keep this as an example + of proper multithreading structure. + +commit f52df8ebae0ad1db15c5e804a458ca81e04c6156 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Aug 25 14:33:09 2008 -0400 + + Fix whitespace mistake + +commit f550857de3ffcb6b2980c4c952b7e84db478d399 +Merge: d62b7c0 a175a04 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Mar 27 02:01:59 2010 -0400 + + Merge mainline. + + Conflicts: + libavcodec/avcodec.h + libavcodec/h264.c + libavcodec/options.c + libavcodec/vp3.c + +commit f5596f046c05bc7d8afda7658f891d69587934f0 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon Nov 15 01:38:36 2010 -0500 + + Rewrite comments and cosmetic changes to pthread.c + + Some small code changes, but there shouldn't be any behavior change. + +commit f695698a78e07a45f4cc9d24ae95fd73f25600e7 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Jan 26 12:43:05 2011 -0500 + + Update todo.txt with review feedback + +commit f6d7d0c03c8d7c91a39c9374d9cee83e32627681 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Feb 6 19:04:21 2011 -0500 + + pthread: Cosmetic changes and renaming + + Rename frame->packet, picture->frame. + Use /**< to point to the right field in doxygen. + Fix some typos. + +commit f71e7068faabecc32abc798a09b9df403f85e33f +Merge: 2bbb64d a4f892e +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jan 6 05:45:03 2011 -0500 + + Merge mainline. + + Conflicts: + doc/APIchanges + +commit f7cc4441b7046a542ef655575ce3e8684ff12e02 +Merge: bba0e09 9eac0a6 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jun 20 15:58:38 2009 -0400 + + Merge mainline. + +commit f9515a4e57356bce4d652451fbaccd071d91dbe9 +Merge: a903974 0c28ee7 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Nov 11 15:38:20 2009 -0500 + + Merge mainline. + + In h264, next_outputed_poc is now used in decode_postinit() + where mainline uses outputed_poc. + + Conflicts: + libavcodec/avcodec.h + libavcodec/h263dec.c + libavcodec/h264.c + libavcodec/utils.c + +commit f9b01bbf85d68f23a81ec5325fae81c8518cc385 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon May 25 20:06:00 2009 -0400 + + Remove unnecessary check from mc_dir_part_y(). + + This was already remove from mc_dir_part(). I hope it's unnecessary + here too. + +commit fa3f68f39f4a96a1170eadfe6ba4677d5d25017f +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 16 04:23:20 2008 -0400 + + Document functions in thread.h + +commit fa8a82e991280b7ccac89ed2a29b332e609bc370 +Author: Luca Barbato <lu_zero@gentoo.org> +Date: Sat May 3 15:18:01 2008 +0200 + + Switch to the gitorius mirror of libswscale + +commit fafaae289235b361b6786745dcbdf6fa938c3c2e +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Dec 4 01:46:22 2008 -0500 + + Don't compare pthread_t to NULL + + It's not required to be a pointer, and it doesn't + need to be validated since pthread_join will just + return an error if it doesn't exist. + + Reverts f143b66d9bf8b23985bf8ec6acf8273c3e9ccd1d + +commit fb1afd9eba5fe2752b83c4b3de24ed88e14b534a +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Mar 14 00:56:54 2009 -0400 + + Rewrite todo (again...) split up so other people should be able to understand it. + Add yuvcmp, though maybe it should go somewhere else. + +commit fb1f31ff6cbcbbde72920e731223fd0fb8f05d02 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Aug 30 04:26:47 2008 -0400 + + Update multithreading doc + +commit fb7dfc0e9e9ff8a5030cde46e28d49d6ce73e453 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Jan 24 22:15:56 2010 -0500 + + Always call avcodec_thread_init() in avcodec_open(). + + This matches upstream behavior, but neither of them have any effect. + It allows implementing automatic thread counts, though. + +commit fbb871069bd106bfd47d215216be01d1ef30aec8 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Feb 14 23:47:42 2010 -0500 + + Reindent vp3.c. + +commit fc957c71da6c9a7e5c769e15f256652352f7b4a4 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon May 24 17:31:38 2010 -0400 + + Fix compile with --disable-optimizations. + + gcc can't remove dead code like: + int threaded = HAVE_PTHREADS; + if (threaded) ... + +commit fd1b8587a4186b30c5922e3053c869726cca23df +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Nov 4 03:55:19 2010 -0400 + + Remove ff_thread_finish_frame() as it seems not useful enough + +commit fd9ae0065aa268c4b3e46706d775cf4ba1df8ed3 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed May 28 01:34:30 2008 -0400 + + Obfusticate the decoder to make the context copyable earlier. + +commit fda3e64cd474b5886457c6a1ffff8906f76a9bbc +Author: Alexander Strange <astrange@ithinksw.com> +Date: Thu Jun 18 16:11:26 2009 -0400 + + Mimic: move up a line changing buf_ptrs. + + No effect on decoding, but it breaks the rule about changing + things after frame_setup_done. + +commit fdb381e68a3828dcc7eb1c93cf174b702cc78d2c +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Feb 17 00:39:42 2010 -0500 + + Cosmetics: rename function parameters + +commit fe4e238f573bab53760408b3376dbba0255e5b51 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon May 25 20:00:50 2009 -0400 + + Fix unnecessarily long wait for direct+progressive MBs. + +commit fe529c93b41f2d7406b76e7e5943b82acd789cb4 +Author: benoit <benoit@9553f0bf-9b14-0410-a0b8-cfaf0461ba5b> +Date: Tue May 22 08:23:45 2007 +0000 + + id3v2 reader + patch by Andreas +�commit febe154099b8f31817e8c047cb3c8dee51b52117 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Wed Jun 16 14:54:00 2010 -0700 + + Fix merge glitch: pix_fmts should have been deleted + +commit feca6e0009da2b344b2c1be8f30a55c23623d77e +Merge: 2485cfd feaafaa +Author: Alexander Strange <astrange@ithinksw.com> +Date: Mon May 25 19:58:17 2009 -0400 + + Merge branch 'master' of git://git.mplayerhq.hu/ffmpeg + +commit ff08d3a1629ab442f78a1d2fde496b727a1a9deb +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sat Jul 12 22:26:43 2008 -0400 + + Fix MPV_lowest_referenced_row to not be completely wrong. + The not handling qpel and emu_edge bugs were masked by the other bugs preventing almost all parallelism. + +commit ff4c627baab555a4ea6275c919d9f4259adc0e58 +Author: Alexander Strange <astrange@ithinksw.com> +Date: Tue Oct 6 15:41:35 2009 -0400 + + Word-wrap todo.txt. + + Try to make some of it cleaner + so other people can actually + use it. + +commit ff69da3564ab912f7e7331f8c8389a96a254e16f +Author: Alexander Strange <astrange@ithinksw.com> +Date: Sun Aug 1 20:33:57 2010 -0700 + + Fix the decoder not returning any frames if the frame count is less than the number of threads + + Fixes ./mt-work/test.sh with still2.mp4 + diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi index 968d4f68b7..83a45a8db6 100644 --- a/doc/ffmpeg.texi +++ b/doc/ffmpeg.texi @@ -15,7 +15,7 @@ The generic syntax is: @example @c man begin SYNOPSIS -ffmpeg [[infile options][@option{-i} @var{infile}]]... @{[outfile options] @var{outfile}@}... +ffmpeg [global options] [[infile options][@option{-i} @var{infile}]]... @{[outfile options] @var{outfile}@}... @c man end @end example @@ -26,21 +26,39 @@ ffmpeg is a very fast video and audio converter that can also grab from a live audio/video source. It can also convert between arbitrary sample rates and resize video on the fly with a high quality polyphase filter. -The command line interface is designed to be intuitive, in the sense -that ffmpeg tries to figure out all parameters that can possibly be -derived automatically. You usually only have to specify the target -bitrate you want. +ffmpeg reads from an arbitrary number of input "files" (which can be regular +files, pipes, network streams, grabbing devices, etc.), specified by the +@code{-i} option, and writes to an arbitrary number of output "files", which are +specified by a plain output filename. Anything found on the commandline which +cannot be interpreted as an option is considered to be an output filename. + +Each input or output file can in principle contain any number of streams of +different types (video/audio/subtitle/attachment/data). Allowed number and/or +types of streams can be limited by the container format. Selecting, which +streams from which inputs go into output, is done either automatically or with +the @code{-map} option (see the Stream selection chapter). + +To refer to input files in options, you must use their indices (0-based). E.g. +the first input file is @code{0}, the second is @code{1} etc. Similarly, streams +within a file are referred to by their indices. E.g. @code{2:3} refers to the +fourth stream in the third input file. See also the Stream specifiers chapter. As a general rule, options are applied to the next specified file. Therefore, order is important, and you can have the same option on the command line multiple times. Each occurrence is then applied to the next input or output file. +Exceptions from this rule are the global options (e.g. verbosity level), +which should be specified first. + +Do not mix input and output files -- first specify all input files, then all +output files. Also do not mix options which belong to different files. All +options apply ONLY to the next input or output file and are reset between files. @itemize @item To set the video bitrate of the output file to 64kbit/s: @example -ffmpeg -i input.avi -b 64k output.avi +ffmpeg -i input.avi -b:v 64k output.avi @end example @item @@ -59,12 +77,24 @@ ffmpeg -r 1 -i input.m2v -r 24 output.avi The format option may be needed for raw input files. -By default ffmpeg tries to convert as losslessly as possible: It -uses the same audio and video parameters for the outputs as the one -specified for the inputs. - @c man end DESCRIPTION +@chapter Stream selection +@c man begin STREAM SELECTION + +By default ffmpeg includes only one stream of each type (video, audio, subtitle) +present in the input files and adds them to each output file. It picks the +"best" of each based upon the following criteria; for video it is the stream +with the highest resolution, for audio the stream with the most channels, for +subtitle it's the first subtitle stream. In the case where several streams of +the same type rate equally, the lowest numbered stream is chosen. + +You can disable some of those defaults by using @code{-vn/-an/-sn} options. For +full manual control, use the @code{-map} option, which disables the defaults just +described. + +@c man end STREAM SELECTION + @chapter Options @c man begin OPTIONS @@ -74,36 +104,63 @@ specified for the inputs. @table @option -@item -f @var{fmt} -Force format. +@item -f @var{fmt} (@emph{input/output}) +Force input or output file format. The format is normally auto detected for input +files and guessed from file extension for output files, so this option is not +needed in most cases. -@item -i @var{filename} +@item -i @var{filename} (@emph{input}) input file name -@item -y -Overwrite output files. +@item -y (@emph{global}) +Overwrite output files without asking. + +@item -n (@emph{global}) +Do not overwrite output files but exit if file exists. -@item -t @var{duration} -Restrict the transcoded/captured video sequence -to the duration specified in seconds. -@code{hh:mm:ss[.xxx]} syntax is also supported. +@item -c[:@var{stream_specifier}] @var{codec} (@emph{input/output,per-stream}) +@itemx -codec[:@var{stream_specifier}] @var{codec} (@emph{input/output,per-stream}) +Select an encoder (when used before an output file) or a decoder (when used +before an input file) for one or more streams. @var{codec} is the name of a +decoder/encoder or a special value @code{copy} (output only) to indicate that +the stream is not to be re-encoded. -@item -fs @var{limit_size} +For example +@example +ffmpeg -i INPUT -map 0 -c:v libx264 -c:a copy OUTPUT +@end example +encodes all video streams with libx264 and copies all audio streams. + +For each stream, the last matching @code{c} option is applied, so +@example +ffmpeg -i INPUT -map 0 -c copy -c:v:1 libx264 -c:a:137 libvorbis OUTPUT +@end example +will copy all the streams except the second video, which will be encoded with +libx264, and the 138th audio, which will be encoded with libvorbis. + +@item -t @var{duration} (@emph{output}) +Stop writing the output after its duration reaches @var{duration}. +@var{duration} may be a number in seconds, or in @code{hh:mm:ss[.xxx]} form. + +@item -fs @var{limit_size} (@emph{output}) Set the file size limit. -@item -ss @var{position} -Seek to given time position in seconds. -@code{hh:mm:ss[.xxx]} syntax is also supported. +@item -ss @var{position} (@emph{input/output}) +When used as an input option (before @code{-i}), seeks in this input file to +@var{position}. When used as an output option (before an output filename), +decodes but discards input until the timestamps reach @var{position}. This is +slower, but more accurate. -@item -itsoffset @var{offset} +@var{position} may be either in seconds or in @code{hh:mm:ss[.xxx]} form. + +@item -itsoffset @var{offset} (@emph{input}) Set the input time offset in seconds. @code{[-]hh:mm:ss[.xxx]} syntax is also supported. -This option affects all the input files that follow it. The offset is added to the timestamps of the input files. Specifying a positive offset means that the corresponding -streams are delayed by 'offset' seconds. +streams are delayed by @var{offset} seconds. -@item -timestamp @var{time} +@item -timestamp @var{time} (@emph{output}) Set the recording timestamp in the container. The syntax for @var{time} is: @example @@ -115,21 +172,31 @@ interpreted as UTC. If the year-month-day part is not specified it takes the current year-month-day. -@item -metadata @var{key}=@var{value} +@item -metadata[:metadata_specifier] @var{key}=@var{value} (@emph{output,per-metadata}) Set a metadata key/value pair. +An optional @var{metadata_specifier} may be given to set metadata +on streams or chapters. See @code{-map_metadata} documentation for +details. + +This option overrides metadata set with @code{-map_metadata}. It is +also possible to delete metadata by using an empty value. + For example, for setting the title in the output file: @example ffmpeg -i in.avi -metadata title="my title" out.flv @end example -@item -v @var{number} -Set the logging verbosity level. +To set the language of the second stream: +@example +ffmpeg -i INPUT -metadata:s:1 language=eng OUTPUT +@end example -@item -target @var{type} -Specify target file type ("vcd", "svcd", "dvd", "dv", "dv50", "pal-vcd", -"ntsc-svcd", ... ). All the format options (bitrate, codecs, -buffer sizes) are then set automatically. You can just type: +@item -target @var{type} (@emph{output}) +Specify target file type (@code{vcd}, @code{svcd}, @code{dvd}, @code{dv}, +@code{dv50}). @var{type} may be prefixed with @code{pal-}, @code{ntsc-} or +@code{film-} to use the corresponding standard. All the format options +(bitrate, codecs, buffer sizes) are then set automatically. You can just type: @example ffmpeg -i myfile.avi -target vcd /tmp/vcd.mpg @@ -142,29 +209,71 @@ they do not conflict with the standard, as in: ffmpeg -i myfile.avi -target vcd -bf 2 /tmp/vcd.mpg @end example -@item -dframes @var{number} -Set the number of data frames to record. +@item -dframes @var{number} (@emph{output}) +Set the number of data frames to record. This is an alias for @code{-frames:d}. -@item -scodec @var{codec} -Force subtitle codec ('copy' to copy stream). +@item -frames[:@var{stream_specifier}] @var{framecount} (@emph{output,per-stream}) +Stop writing to the stream after @var{framecount} frames. -@item -newsubtitle -Add a new subtitle stream to the current output stream. +@item -q[:@var{stream_specifier}] @var{q} (@emph{output,per-stream}) +@itemx -qscale[:@var{stream_specifier}] @var{q} (@emph{output,per-stream}) +Use fixed quality scale (VBR). The meaning of @var{q} is +codec-dependent. -@item -slang @var{code} -Set the ISO 639 language code (3 letters) of the current subtitle stream. +@item -filter[:@var{stream_specifier}] @var{filter_graph} (@emph{output,per-stream}) +@var{filter_graph} is a description of the filter graph to apply to +the stream. Use @code{-filters} to show all the available filters +(including also sources and sinks). +@item -pre[:@var{stream_specifier}] @var{preset_name} (@emph{output,per-stream}) +Specify the preset for matching stream(s). + +@item -stats (@emph{global}) +Print encoding progress/statistics. On by default. + +@item -attach @var{filename} (@emph{output}) +Add an attachment to the output file. This is supported by a few formats +like Matroska for e.g. fonts used in rendering subtitles. Attachments +are implemented as a specific type of stream, so this option will add +a new stream to the file. It is then possible to use per-stream options +on this stream in the usual way. Attachment streams created with this +option will be created after all the other streams (i.e. those created +with @code{-map} or automatic mappings). + +Note that for Matroska you also have to set the mimetype metadata tag: +@example +ffmpeg -i INPUT -attach DejaVuSans.ttf -metadata:s:2 mimetype=application/x-truetype-font out.mkv +@end example +(assuming that the attachment stream will be third in the output file). + +@item -dump_attachment[:@var{stream_specifier}] @var{filename} (@emph{input,per-stream}) +Extract the matching attachment stream into a file named @var{filename}. If +@var{filename} is empty, then the value of the @code{filename} metadata tag +will be used. + +E.g. to extract the first attachment to a file named 'out.ttf': +@example +ffmpeg -dump_attachment:t:0 out.ttf INPUT +@end example +To extract all attachments to files determined by the @code{filename} tag: +@example +ffmpeg -dump_attachment:t "" INPUT +@end example + +Technical note -- attachments are implemented as codec extradata, so this +option can actually be used to extract extradata from any stream, not just +attachments. @end table @section Video Options @table @option -@item -vframes @var{number} -Set the number of video frames to record. -@item -r @var{fps} +@item -vframes @var{number} (@emph{output}) +Set the number of video frames to record. This is an alias for @code{-frames:v}. +@item -r[:@var{stream_specifier}] @var{fps} (@emph{input/output,per-stream}) Set frame rate (Hz value, fraction or abbreviation), (default = 25). -@item -s @var{size} -Set frame size. The format is @samp{wxh} (avserver default = 160x128, ffmpeg default = same as source). +@item -s[:@var{stream_specifier}] @var{size} (@emph{input/output,per-stream}) +Set frame size. The format is @samp{wxh} (default - same as source). The following abbreviations are recognized: @table @samp @item sqcif @@ -227,7 +336,7 @@ The following abbreviations are recognized: 1920x1080 @end table -@item -aspect @var{aspect} +@item -aspect[:@var{stream_specifier}] @var{aspect} (@emph{output,per-stream}) Set the video display aspect ratio specified by @var{aspect}. @var{aspect} can be a floating point number string, or a string of the @@ -249,7 +358,8 @@ crop=width:height:x:y instead. @item -padcolor @var{hex_color} All the pad options have been removed. Use -vf pad=width:height:x:y:color instead. -@item -vn + +@item -vn (@emph{output}) Disable video recording. @item -bt @var{tolerance} Set video bitrate tolerance (in bits, default 4000k). @@ -265,17 +375,19 @@ Requires -bufsize to be set. Set min video bitrate (in bit/s). Most useful in setting up a CBR encode: @example -ffmpeg -i myfile.avi -b 4000k -minrate 4000k -maxrate 4000k -bufsize 1835k out.m2v +ffmpeg -i myfile.avi -b:v 4000k -minrate 4000k -maxrate 4000k -bufsize 1835k out.m2v @end example It is of little use elsewise. @item -bufsize @var{size} Set video buffer verifier buffer size (in bits). -@item -vcodec @var{codec} -Force video codec to @var{codec}. Use the @code{copy} special value to -tell that the raw codec data must be copied as is. -@item -sameq +@item -vcodec @var{codec} (@emph{output}) +Set the video codec. This is an alias for @code{-codec:v}. +@item -same_quant Use same quantizer as source (implies VBR). +Note that this is NOT SAME QUALITY. Do not use this option unless you know you +need it. + @item -pass @var{n} Select the pass number (1 or 2). It is used to do two-pass video encoding. The statistics of the video are recorded in the first @@ -285,46 +397,41 @@ at the exact requested bitrate. On pass 1, you may just deactivate audio and set output to null, examples for Windows and Unix: @example -ffmpeg -i foo.mov -vcodec libxvid -pass 1 -an -f rawvideo -y NUL -ffmpeg -i foo.mov -vcodec libxvid -pass 1 -an -f rawvideo -y /dev/null +ffmpeg -i foo.mov -c:v libxvid -pass 1 -an -f rawvideo -y NUL +ffmpeg -i foo.mov -c:v libxvid -pass 1 -an -f rawvideo -y /dev/null @end example -@item -passlogfile @var{prefix} +@item -passlogfile @var{prefix} (@emph{global}) Set two-pass log file name prefix to @var{prefix}, the default file name prefix is ``ffmpeg2pass''. The complete file name will be @file{PREFIX-N.log}, where N is a number specific to the output -stream. - -@item -newvideo -Add a new video stream to the current output stream. +stream @item -vlang @var{code} Set the ISO 639 language code (3 letters) of the current video stream. -@item -vf @var{filter_graph} +@item -vf @var{filter_graph} (@emph{output}) @var{filter_graph} is a description of the filter graph to apply to the input video. Use the option "-filters" to show all the available filters (including -also sources and sinks). +also sources and sinks). This is an alias for @code{-filter:v}. @end table @section Advanced Video Options @table @option -@item -pix_fmt @var{format} -Set pixel format. Use 'list' as parameter to show all the supported +@item -pix_fmt[:@var{stream_specifier}] @var{format} (@emph{input/output,per-stream}) +Set pixel format. Use @code{-pix_fmts} to show all the supported pixel formats. -@item -sws_flags @var{flags} +@item -sws_flags @var{flags} (@emph{input/output}) Set SwScaler flags. @item -g @var{gop_size} Set the group of pictures size. @item -intra -Use only intra frames. +deprecated, use -g 1 @item -vdt @var{n} Discard threshold. -@item -qscale @var{q} -Use fixed video quantizer scale (VBR). @item -qmin @var{q} minimum video quantizer scale (VBR) @item -qmax @var{q} @@ -396,8 +503,11 @@ and the following constants are available: @item avgTex @end table -@item -rc_override @var{override} -rate control override for specific intervals +@item -rc_override[:@var{stream_specifier}] @var{override} (@emph{output,per-stream}) +Rate control override for specific intervals, formatted as "int,int,int" +list separated with slashes. Two first values are the beginning and +end frame numbers, last one is quantizer to use if positive, or quality +factor if negative. @item -me_method @var{method} Set motion estimation method to @var{method}. Available methods are (from lowest to best quality): @@ -469,7 +579,7 @@ FF_ER_COMPLIANT @item 3 FF_ER_AGGRESSIVE @item 4 -FF_ER_EXPLODE +FF_ER_VERY_AGGRESSIVE @end table @item -ec @var{bit_mask} @@ -522,70 +632,59 @@ Calculate PSNR of compressed frames. Dump video coding statistics to @file{vstats_HHMMSS.log}. @item -vstats_file @var{file} Dump video coding statistics to @var{file}. -@item -top @var{n} +@item -top[:@var{stream_specifier}] @var{n} (@emph{output,per-stream}) top=1/bottom=0/auto=-1 field first @item -dc @var{precision} Intra_dc_precision. -@item -vtag @var{fourcc/tag} -Force video tag/fourcc. -@item -qphist -Show QP histogram. +@item -vtag @var{fourcc/tag} (@emph{output}) +Force video tag/fourcc. This is an alias for @code{-tag:v}. +@item -qphist (@emph{global}) +Show QP histogram @item -vbsf @var{bitstream_filter} -Bitstream filters available are "dump_extra", "remove_extra", "noise", "h264_mp4toannexb", "imxdump", "mjpegadump", "mjpeg2jpeg". -@example -ffmpeg -i h264.mp4 -vcodec copy -vbsf h264_mp4toannexb -an out.h264 -@end example -@item -force_key_frames @var{time}[,@var{time}...] +Deprecated see -bsf +@item -force_key_frames[:@var{stream_specifier}] @var{time}[,@var{time}...] (@emph{output,per-stream}) Force key frames at the specified timestamps, more precisely at the first frames after each specified time. This option can be useful to ensure that a seek point is present at a chapter mark or any other designated place in the output file. The timestamps must be specified in ascending order. + +@item -copyinkf[:@var{stream_specifier}] (@emph{output,per-stream}) +When doing stream copy, copy also non-key frames found at the +beginning. @end table @section Audio Options @table @option -@item -aframes @var{number} -Set the number of audio frames to record. -@item -ar @var{freq} +@item -aframes @var{number} (@emph{output}) +Set the number of audio frames to record. This is an alias for @code{-frames:a}. +@item -ar[:@var{stream_specifier}] @var{freq} (@emph{input/output,per-stream}) Set the audio sampling frequency. For output streams it is set by default to the frequency of the corresponding input stream. For input streams this option only makes sense for audio grabbing devices and raw demuxers and is mapped to the corresponding demuxer options. -@item -aq @var{q} -Set the audio quality (codec-specific, VBR). -@item -ac @var{channels} +@item -aq @var{q} (@emph{output}) +Set the audio quality (codec-specific, VBR). This is an alias for -q:a. +@item -ac[:@var{stream_specifier}] @var{channels} (@emph{input/output,per-stream}) Set the number of audio channels. For output streams it is set by default to the number of input audio channels. For input streams this option only makes sense for audio grabbing devices and raw demuxers and is mapped to the corresponding demuxer options. -@item -an +@item -an (@emph{output}) Disable audio recording. -@item -acodec @var{codec} -Force audio codec to @var{codec}. Use the @code{copy} special value to -specify that the raw codec data must be copied as is. -@item -newaudio -Add a new audio track to the output file. If you want to specify parameters, -do so before @code{-newaudio} (@code{-acodec}, @code{-ab}, etc..). - -Mapping will be done automatically, if the number of output streams is equal to -the number of input streams, else it will pick the first one that matches. You -can override the mapping using @code{-map} as usual. - -Example: -@example -ffmpeg -i file.mpg -vcodec copy -acodec ac3 -ab 384k test.mpg -acodec mp2 -ab 192k -newaudio -@end example -@item -alang @var{code} -Set the ISO 639 language code (3 letters) of the current audio stream. +@item -acodec @var{codec} (@emph{input/output}) +Set the audio codec. This is an alias for @code{-codec:a}. +@item -sample_fmt[:@var{stream_specifier}] @var{sample_fmt} (@emph{output,per-stream}) +Set the audio sample format. Use @code{-sample_fmts} to get a list +of supported sample formats. @end table @section Advanced Audio options: @table @option -@item -atag @var{fourcc/tag} -Force audio tag/fourcc. +@item -atag @var{fourcc/tag} (@emph{output}) +Force audio tag/fourcc. This is an alias for @code{-tag:a}. @item -audio_service_type @var{type} Set the type of service that the audio stream contains. @table @option @@ -609,91 +708,141 @@ Voice Over Karaoke @end table @item -absf @var{bitstream_filter} -Bitstream filters available are "dump_extra", "remove_extra", "noise", "mp3comp", "mp3decomp". +Deprecated, see -bsf @end table @section Subtitle options: @table @option -@item -scodec @var{codec} -Force subtitle codec ('copy' to copy stream). -@item -newsubtitle -Add a new subtitle stream to the current output stream. @item -slang @var{code} Set the ISO 639 language code (3 letters) of the current subtitle stream. -@item -sn +@item -scodec @var{codec} (@emph{input/output}) +Set the subtitle codec. This is an alias for @code{-codec:s}. +@item -sn (@emph{output}) Disable subtitle recording. @item -sbsf @var{bitstream_filter} -Bitstream filters available are "mov2textsub", "text2movsub". -@example -ffmpeg -i file.mov -an -vn -sbsf mov2textsub -scodec copy -f rawvideo sub.txt -@end example +Deprecated, see -bsf @end table @section Audio/Video grab options @table @option -@item -vc @var{channel} -Set video grab channel (DV1394 only). -@item -tvstd @var{standard} -Set television standard (NTSC, PAL (SECAM)). -@item -isync +@item -isync (@emph{global}) Synchronize read on input. @end table @section Advanced options @table @option -@item -map @var{input_file_id}.@var{input_stream_id}[:@var{sync_file_id}.@var{sync_stream_id}] +@item -map [-]@var{input_file_id}[:@var{stream_specifier}][,@var{sync_file_id}[:@var{stream_specifier}]] (@emph{output}) -Designate an input stream as a source for the output file. Each input +Designate one or more input streams as a source for the output file. Each input stream is identified by the input file index @var{input_file_id} and the input stream index @var{input_stream_id} within the input -file. Both indexes start at 0. If specified, -@var{sync_file_id}.@var{sync_stream_id} sets which input stream +file. Both indices start at 0. If specified, +@var{sync_file_id}:@var{stream_specifier} sets which input stream is used as a presentation sync reference. -The @code{-map} options must be specified just after the output file. -If any @code{-map} options are used, the number of @code{-map} options -on the command line must match the number of streams in the output -file. The first @code{-map} option on the command line specifies the +The first @code{-map} option on the command line specifies the source for output stream 0, the second @code{-map} option specifies the source for output stream 1, etc. +A @code{-} character before the stream identifier creates a "negative" mapping. +It disables matching streams from already created mappings. + +For example, to map ALL streams from the first input file to output +@example +ffmpeg -i INPUT -map 0 output +@end example + For example, if you have two audio streams in the first input file, -these streams are identified by "0.0" and "0.1". You can use -@code{-map} to select which stream to place in an output file. For +these streams are identified by "0:0" and "0:1". You can use +@code{-map} to select which streams to place in an output file. For example: @example -ffmpeg -i INPUT out.wav -map 0.1 +ffmpeg -i INPUT -map 0:1 out.wav @end example -will map the input stream in @file{INPUT} identified by "0.1" to +will map the input stream in @file{INPUT} identified by "0:1" to the (single) output stream in @file{out.wav}. For example, to select the stream with index 2 from input file -@file{a.mov} (specified by the identifier "0.2"), and stream with -index 6 from input @file{b.mov} (specified by the identifier "1.6"), +@file{a.mov} (specified by the identifier "0:2"), and stream with +index 6 from input @file{b.mov} (specified by the identifier "1:6"), and copy them to the output file @file{out.mov}: @example -ffmpeg -i a.mov -i b.mov -vcodec copy -acodec copy out.mov -map 0.2 -map 1.6 +ffmpeg -i a.mov -i b.mov -c copy -map 0:2 -map 1:6 out.mov @end example -To add more streams to the output file, you can use the -@code{-newaudio}, @code{-newvideo}, @code{-newsubtitle} options. +To select all video and the third audio stream from an input file: +@example +ffmpeg -i INPUT -map 0:v -map 0:a:2 OUTPUT +@end example + +To map all the streams except the second audio, use negative mappings +@example +ffmpeg -i INPUT -map 0 -map -0:a:1 OUTPUT +@end example + +Note that using this option disables the default mappings for this output file. + +@item -map_channel [@var{input_file_id}.@var{stream_specifier}.@var{channel_id}|-1][:@var{output_file_id}.@var{stream_specifier}] +Map an audio channel from a given input to an output. If +@var{output_file_id}.@var{stream_specifier} are not set, the audio channel will +be mapped on all the audio streams. -@item -map_meta_data @var{outfile}[,@var{metadata}]:@var{infile}[,@var{metadata}] -Deprecated, use @var{-map_metadata} instead. +Using "-1" instead of +@var{input_file_id}.@var{stream_specifier}.@var{channel_id} will map a muted +channel. -@item -map_metadata @var{outfile}[,@var{metadata}]:@var{infile}[,@var{metadata}] -Set metadata information of @var{outfile} from @var{infile}. Note that those -are file indices (zero-based), not filenames. -Optional @var{metadata} parameters specify, which metadata to copy - (g)lobal +For example, assuming @var{INPUT} is a stereo audio file, you can switch the +two audio channels with the following command: +@example +ffmpeg -i INPUT -map_channel 0.0.1 -map_channel 0.0.0 OUTPUT +@end example + +If you want to mute the first channel and keep the second: +@example +ffmpeg -i INPUT -map_channel -1 -map_channel 0.0.1 OUTPUT +@end example + +The order of the "-map_channel" option specifies the order of the channels in +the output stream. The output channel layout is guessed from the number of +channels mapped (mono if one "-map_channel", stereo if two, etc.). Using "-ac" +in combination of "-map_channel" makes the channel gain levels to be updated if +channel layouts don't match (for instance two "-map_channel" options and "-ac +6"). + +You can also extract each channel of an @var{INPUT} to specific outputs; the +following command extract each channel of the audio stream (file 0, stream 0) +to the respective @var{OUTPUT_CH0} and @var{OUTPUT_CH1}: +@example +ffmpeg -i INPUT -map_channel 0.0.0 OUTPUT_CH0 -map_channel 0.0.1 OUTPUT_CH1 +@end example + +The following example split the channels of a stereo input into streams: + +@example +ffmpeg -i stereo.wav -map 0:0 -map 0:0 -map_channel 0.0.0:0.0 -map_channel 0.0.1:0.1 -y out.ogg +@end example + +Note that currently each output stream can only contain channels from a single +input stream; you can't for example use "-map_channel" to pick multiple input +audio channels contained in different streams (from the same or different files) +and merge them into a single output stream. It is therefore not currently +possible, for example, to turn two separate mono streams into a single stereo +stream. However spliting a stereo stream into two single channel mono streams +is possible. + +@item -map_metadata[:@var{metadata_type}][:@var{index}] @var{infile}[:@var{metadata_type}][:@var{index}] (@emph{output,per-metadata}) +Set metadata information of the next output file from @var{infile}. Note that +those are file indices (zero-based), not filenames. +Optional @var{metadata_type} parameters specify, which metadata to copy - (g)lobal (i.e. metadata that applies to the whole file), per-(s)tream, per-(c)hapter or per-(p)rogram. All metadata specifiers other than global must be followed by the -stream/chapter/program number. If metadata specifier is omitted, it defaults to +stream/chapter/program index. If metadata specifier is omitted, it defaults to global. -By default, global metadata is copied from the first input file to all output files, +By default, global metadata is copied from the first input file, per-stream and per-chapter metadata is copied along with streams/chapters. These default mappings are disabled by creating any mapping of the relevant type. A negative file index can be used to create a dummy mapping that just disables automatic copying. @@ -701,33 +850,65 @@ file index can be used to create a dummy mapping that just disables automatic co For example to copy metadata from the first stream of the input file to global metadata of the output file: @example -ffmpeg -i in.ogg -map_metadata 0:0,s0 out.mp3 +ffmpeg -i in.ogg -map_metadata 0:s:0 out.mp3 @end example -@item -map_chapters @var{outfile}:@var{infile} -Copy chapters from @var{infile} to @var{outfile}. If no chapter mapping is specified, -then chapters are copied from the first input file with at least one chapter to all -output files. Use a negative file index to disable any chapter copying. -@item -debug +@item -map_chapters @var{input_file_index} (@emph{output}) +Copy chapters from input file with index @var{input_file_index} to the next +output file. If no chapter mapping is specified, then chapters are copied from +the first input file with at least one chapter. Use a negative file index to +disable any chapter copying. +@item -debug @var{category} Print specific debug info. -@item -benchmark +@var{category} is a number or a string containing one of the following values: +@table @samp +@item bitstream +@item buffers +picture buffer allocations +@item bugs +@item dct_coeff +@item er +error recognition +@item mb_type +macroblock (MB) type +@item mmco +memory management control operations (H.264) +@item mv +motion vector +@item pict +picture info +@item pts +@item qp +per-block quantization parameter (QP) +@item rc +rate control +@item skip +@item startcode +@item thread_ops +threading operations +@item vis_mb_type +visualize block types +@item vis_qp +visualize quantization parameter (QP), lower QP are tinted greener +@end table +@item -benchmark (@emph{global}) Show benchmarking information at the end of an encode. Shows CPU time used and maximum memory consumption. Maximum memory consumption is not supported on all systems, it will usually display as 0 if not supported. -@item -dump -Dump each input packet. -@item -hex +@item -timelimit @var{duration} (@emph{global}) +Exit after ffmpeg has been running for @var{duration} seconds. +@item -dump (@emph{global}) +Dump each input packet to stderr. +@item -hex (@emph{global}) When dumping packets, also dump the payload. -@item -bitexact -Only use bit exact algorithms (for codec testing). @item -ps @var{size} Set RTP payload size in bytes. -@item -re +@item -re (@emph{input}) Read input at native frame rate. Mainly used to simulate a grab device. @item -loop_input Loop over the input stream. Currently it works only for image -streams. This option is used for automatic AVserver testing. -This option is deprecated, use -loop. +streams. This option is used for automatic FFserver testing. +This option is deprecated, use -loop 1. @item -loop_output @var{number_of_times} Repeatedly loop output for formats that support looping such as animated GIF (0 will loop the output infinitely). @@ -768,11 +949,11 @@ Copy input stream time base from input to output when stream copying. Finish encoding when the shortest input stream ends. @item -dts_delta_threshold Timestamp discontinuity delta threshold. -@item -muxdelay @var{seconds} +@item -muxdelay @var{seconds} (@emph{input}) Set the maximum demux-decode delay. -@item -muxpreload @var{seconds} +@item -muxpreload @var{seconds} (@emph{input}) Set the initial demux-decode delay. -@item -streamid @var{output-stream-index}:@var{new-value} +@item -streamid @var{output-stream-index}:@var{new-value} (@emph{output}) Assign a new stream-id value to an output stream. This option should be specified prior to the output filename to which it applies. For the situation where multiple output files exist, a streamid @@ -783,15 +964,28 @@ an output mpegts file: @example ffmpeg -i infile -streamid 0:33 -streamid 1:36 out.ts @end example + +@item -bsf[:@var{stream_specifier}] @var{bitstream_filters} (@emph{output,per-stream}) +Set bitstream filters for matching streams. @var{bistream_filters} is +a comma-separated list of bitstream filters. Use the @code{-bsfs} option +to get the list of bitstream filters. +@example +ffmpeg -i h264.mp4 -c:v copy -vbsf h264_mp4toannexb -an out.h264 +@end example +@example +ffmpeg -i file.mov -an -vn -sbsf mov2textsub -c:s copy -f rawvideo sub.txt +@end example + +@item -tag[:@var{stream_specifier}] @var{codec_tag} (@emph{per-stream}) +Force a tag/fourcc for matching streams. @end table @section Preset files - A preset file contains a sequence of @var{option}=@var{value} pairs, one for each line, specifying a sequence of options which would be awkward to specify on the command line. Lines starting with the hash ('#') character are ignored and are used to provide comments. Check -the @file{presets} directory in the Libav source tree for examples. +the @file{presets} directory in the FFmpeg source tree for examples. Preset files are specified with the @code{vpre}, @code{apre}, @code{spre}, and @code{fpre} options. The @code{fpre} option takes the @@ -806,8 +1000,9 @@ preset options identifies the preset file to use according to the following rules: First ffmpeg searches for a file named @var{arg}.ffpreset in the -directories @file{$AVCONV_DATADIR} (if set), and @file{$HOME/.avconv}, and in -the datadir defined at configuration time (usually @file{PREFIX/share/avconv}) +directories @file{$FFMPEG_DATADIR} (if set), and @file{$HOME/.ffmpeg}, and in +the datadir defined at configuration time (usually @file{PREFIX/share/ffmpeg}) +or in a @file{ffpresets} folder along the executable on win32, in that order. For example, if the argument is @code{libx264-max}, it will search for the file @file{libx264-max.ffpreset}. @@ -817,7 +1012,7 @@ directories, where @var{codec_name} is the name of the codec to which the preset file options will be applied. For example, if you select the video codec with @code{-vcodec libx264} and use @code{-vpre max}, then it will search for the file @file{libx264-max.ffpreset}. -@c man end +@c man end OPTIONS @chapter Tips @c man begin TIPS @@ -830,7 +1025,7 @@ the Linux player does not seem to be very fast, so it can miss frames. An example is: @example -ffmpeg -g 3 -r 3 -t 10 -b 50k -s qcif -f rv10 /tmp/b.rm +ffmpeg -g 3 -r 3 -t 10 -b:v 50k -s qcif -f rv10 /tmp/b.rm @end example @item @@ -857,17 +1052,27 @@ To have a constant quality (but a variable bitrate), use the option '-qscale n' when 'n' is between 1 (excellent quality) and 31 (worst quality). -@item -When converting video files, you can use the '-sameq' option which -uses the same quality factor in the encoder as in the decoder. -It allows almost lossless encoding. - @end itemize @c man end TIPS @chapter Examples @c man begin EXAMPLES +@section Preset files + +A preset file contains a sequence of @var{option=value} pairs, one for +each line, specifying a sequence of options which can be specified also on +the command line. Lines starting with the hash ('#') character are ignored and +are used to provide comments. Empty lines are also ignored. Check the +@file{presets} directory in the FFmpeg source tree for examples. + +Preset files are specified with the @code{pre} option, this option takes a +preset name as input. FFmpeg searches for a file named @var{preset_name}.avpreset in +the directories @file{$AVCONV_DATADIR} (if set), and @file{$HOME/.ffmpeg}, and in +the data directory defined at configuration time (usually @file{$PREFIX/share/ffmpeg}) +in that order. For example, if the argument is @code{libx264-max}, it will +search for the file @file{libx264-max.avpreset}. + @section Video and Audio grabbing If you specify the input format and device then ffmpeg can grab video @@ -877,6 +1082,11 @@ and audio directly. ffmpeg -f oss -i /dev/dsp -f video4linux2 -i /dev/video0 /tmp/out.mpg @end example +Or with an ALSA audio source (mono input, card id 1) instead of OSS: +@example +ffmpeg -f alsa -ac 1 -i hw:1 -f video4linux2 -i /dev/video0 /tmp/out.mpg +@end example + Note that you must activate the right video source and channel before launching ffmpeg with any TV viewer such as @uref{http://linux.bytesex.org/xawtv/, xawtv} by Gerd Knorr. You also @@ -898,34 +1108,8 @@ the DISPLAY environment variable. ffmpeg -f x11grab -s cif -r 25 -i :0.0+10,20 /tmp/out.mpg @end example -10 is the x-offset and 20 the y-offset for the grabbing. - -@example -ffmpeg -f x11grab -follow_mouse centered -s cif -r 25 -i :0.0 /tmp/out.mpg -@end example - -The grabbing region follows the mouse pointer, which stays at the center of -region. - -@example -ffmpeg -f x11grab -follow_mouse 100 -s cif -r 25 -i :0.0 /tmp/out.mpg -@end example - -Only follows when mouse pointer reaches within 100 pixels to the edge of -region. - -@example -ffmpeg -f x11grab -show_region 1 -s cif -r 25 -i :0.0+10,20 /tmp/out.mpg -@end example - -The grabbing region will be indicated on screen. - -@example -ffmpeg -f x11grab -follow_mouse centered -show_region 1 -s cif -r 25 -i :0.0 /tmp/out.mpg -@end example - -The grabbing region indication will follow the mouse pointer. - +0.0 is display.screen number of your X11 server, same as the DISPLAY environment +variable. 10 is the x-offset and 20 the y-offset for the grabbing. @section Video and Audio file format conversion @@ -993,7 +1177,7 @@ You can encode to several formats at the same time and define a mapping from input stream to output streams: @example -ffmpeg -i /tmp/a.wav -ab 64k /tmp/a.mp2 -ab 128k /tmp/b.mp2 -map 0:0 -map 0:0 +ffmpeg -i /tmp/a.wav -map 0:a -b:a 64k /tmp/a.mp2 -map 0:a -b:a 128k /tmp/b.mp2 @end example Converts a.wav to a.mp2 at 64 kbits and to b.mp2 at 128 kbits. '-map @@ -1004,7 +1188,7 @@ stream, in the order of the definition of output streams. You can transcode decrypted VOBs: @example -ffmpeg -i snatch_1.vob -f avi -vcodec mpeg4 -b 800k -g 300 -bf 2 -acodec libmp3lame -ab 128k snatch.avi +ffmpeg -i snatch_1.vob -f avi -c:v mpeg4 -b:v 800k -g 300 -bf 2 -c:a libmp3lame -b:a 128k snatch.avi @end example This is a typical DVD ripping example; the input is a VOB file, the @@ -1048,21 +1232,17 @@ only formats accepting a normal integer are suitable. You can put many streams of the same type in the output: @example -ffmpeg -i test1.avi -i test2.avi -vcodec copy -acodec copy -vcodec copy -acodec copy test12.avi -newvideo -newaudio +ffmpeg -i test1.avi -i test2.avi -map 0.3 -map 0.2 -map 0.1 -map 0.0 -c copy test12.nut @end example -In addition to the first video and audio streams, the resulting -output file @file{test12.avi} will contain the second video -and the second audio stream found in the input streams list. - -The @code{-newvideo}, @code{-newaudio} and @code{-newsubtitle} -options have to be specified immediately after the name of the output -file to which you want to add them. +The resulting output file @file{test12.avi} will contain first four streams from +the input file in reverse order. @end itemize @c man end EXAMPLES @include eval.texi +@include decoders.texi @include encoders.texi @include demuxers.texi @include muxers.texi @@ -1079,11 +1259,11 @@ file to which you want to add them. @settitle ffmpeg video converter @c man begin SEEALSO -avplay(1), avprobe(1), avserver(1) and the Libav HTML documentation +ffplay(1), ffprobe(1), ffserver(1) and the FFmpeg HTML documentation @c man end @c man begin AUTHORS -The Libav developers +See git history @c man end @end ignore diff --git a/doc/ffmpeg.txt b/doc/ffmpeg.txt new file mode 100644 index 0000000000..1fa42e78ee --- /dev/null +++ b/doc/ffmpeg.txt @@ -0,0 +1,47 @@ + : + ffmpeg.c : libav* + ======== : ====== + : + : + --------------------------------:---> AVStream... + InputStream input_streams[] / : + / : + InputFile input_files[] +==========================+ / ^ : + ------> 0 | : st ---:-----------:--/ : : + ^ +------+-----------+-----+ / +--------------------------+ : : + : | :ist_index--:-----:---------/ 1 | : st : | : : + : +------+-----------+-----+ +==========================+ : : + nb_input_files : | :ist_index--:-----:------------------> 2 | : st : | : : + : +------+-----------+-----+ +--------------------------+ : nb_input_streams : + : | :ist_index : | 3 | ... | : : + v +------+-----------+-----+ +--------------------------+ : : + --> 4 | | : : + | +--------------------------+ : : + | 5 | | : : + | +==========================+ v : + | : + | : + | : + | : + --------- --------------------------------:---> AVStream... + \ / : + OutputStream output_streams[] / : + \ / : + +======\======================/======+ ^ : + ------> 0 | : source_index : st-:--- | : : + OuputFile output_files[] / +------------------------------------+ : : + / 1 | : : : | : : + ^ +------+------------+-----+ / +------------------------------------+ : : + : | : ost_index -:-----:------/ 2 | : : : | : : + nb_output_files : +------+------------+-----+ +====================================+ : : + : | : ost_index -:-----|-----------------> 3 | : : : | : : + : +------+------------+-----+ +------------------------------------+ : nb_output_streams : + : | : : | 4 | | : : + : +------+------------+-----+ +------------------------------------+ : : + : | : : | 5 | | : : + v +------+------------+-----+ +------------------------------------+ : : + 6 | | : : + +------------------------------------+ : : + 7 | | : : + +====================================+ v : + : diff --git a/doc/avplay.texi b/doc/ffplay.texi index 8fc33081de..06666f6e59 100644 --- a/doc/avplay.texi +++ b/doc/ffplay.texi @@ -1,8 +1,8 @@ \input texinfo @c -*- texinfo -*- -@settitle avplay Documentation +@settitle ffplay Documentation @titlepage -@center @titlefont{avplay Documentation} +@center @titlefont{ffplay Documentation} @end titlepage @top @@ -13,16 +13,16 @@ @example @c man begin SYNOPSIS -avplay [options] @file{input_file} +ffplay [options] [@file{input_file}] @c man end @end example @chapter Description @c man begin DESCRIPTION -AVplay is a very simple and portable media player using the Libav +FFplay is a very simple and portable media player using the FFmpeg libraries and the SDL library. It is mostly used as a testbed for the -various Libav APIs. +various FFmpeg APIs. @c man end @chapter Options @@ -38,9 +38,9 @@ Force displayed width. @item -y @var{height} Force displayed height. @item -s @var{size} -This option has been removed. Use private format options for specifying the -input video size. For example with the rawvideo demuxer you need to specify the -option @var{video_size}. +Set frame size (WxH or abbreviation), needed for videos which do +not contain a header with the frame size like raw YUV. This option +has been deprecated in favor of private options, try -video_size. @item -an Disable audio. @item -vn @@ -59,29 +59,44 @@ Force format. Set window title (default is the input filename). @item -loop @var{number} Loops movie playback <number> times. 0 means forever. +@item -showmode @var{mode} +Set the show mode to use. +Available values for @var{mode} are: +@table @samp +@item 0, video +show video +@item 1, waves +show audio waves +@item 2, rdft +show audio frequency band using RDFT ((Inverse) Real Discrete Fourier Transform) +@end table + +Default value is "video", if video is not present or cannot be played +"rdft" is automatically selected. + +You can interactively cycle through the available show modes by +pressing the key @key{w}. + @item -vf @var{filter_graph} @var{filter_graph} is a description of the filter graph to apply to the input video. Use the option "-filters" to show all the available filters (including also sources and sinks). +@item -i @var{input_file} +Read @var{input_file}. @end table @section Advanced options @table @option @item -pix_fmt @var{format} -This option has been removed. Use private options for specifying the -input pixel format. For example with the rawvideo demuxer you need to specify -the option @var{pixel_format}. +Set pixel format. +This option has been deprecated in favor of private options, try -pixel_format. @item -stats Show the stream duration, the codec parameters, the current position in the stream and the audio/video synchronisation drift. -@item -debug -Print specific debug info. @item -bug Work around bugs. -@item -vismv -Visualize motion vectors. @item -fast Non-spec-compliant optimizations. @item -genpts @@ -119,6 +134,8 @@ Exit when video is done playing. Exit if any key is pressed. @item -exitonmousedown Exit if any mouse button is pressed. +@item -codec:@var{stream_type} +Force a specific decoder implementation @end table @section While playing @@ -151,6 +168,9 @@ Seek backward/forward 10 seconds. @item down/up Seek backward/forward 1 minute. +@item page down/page up +Seek backward/forward 10 minutes. + @item mouse click Seek to percentage in file corresponding to fraction of width. @@ -159,6 +179,7 @@ Seek to percentage in file corresponding to fraction of width. @c man end @include eval.texi +@include decoders.texi @include demuxers.texi @include muxers.texi @include indevs.texi @@ -168,15 +189,15 @@ Seek to percentage in file corresponding to fraction of width. @ignore -@setfilename avplay -@settitle AVplay media player +@setfilename ffplay +@settitle FFplay media player @c man begin SEEALSO -avconv(1), avprobe(1) and the Libav HTML documentation +ffmpeg(1), ffprobe(1), ffserver(1) and the FFmpeg HTML documentation @c man end @c man begin AUTHORS -The Libav developers +The FFmpeg developers @c man end @end ignore diff --git a/doc/ffprobe.texi b/doc/ffprobe.texi new file mode 100644 index 0000000000..5c591b1258 --- /dev/null +++ b/doc/ffprobe.texi @@ -0,0 +1,317 @@ +\input texinfo @c -*- texinfo -*- + +@settitle ffprobe Documentation +@titlepage +@center @titlefont{ffprobe Documentation} +@end titlepage + +@top + +@contents + +@chapter Synopsis + +The generic syntax is: + +@example +@c man begin SYNOPSIS +ffprobe [options] [@file{input_file}] +@c man end +@end example + +@chapter Description +@c man begin DESCRIPTION + +ffprobe gathers information from multimedia streams and prints it in +human- and machine-readable fashion. + +For example it can be used to check the format of the container used +by a multimedia stream and the format and type of each media stream +contained in it. + +If a filename is specified in input, ffprobe will try to open and +probe the file content. If the file cannot be opened or recognized as +a multimedia file, a positive exit code is returned. + +ffprobe may be employed both as a standalone application or in +combination with a textual filter, which may perform more +sophisticated processing, e.g. statistical processing or plotting. + +Options are used to list some of the formats supported by ffprobe or +for specifying which information to display, and for setting how +ffprobe will show it. + +ffprobe output is designed to be easily parsable by a textual filter, +and consists of one or more sections of a form defined by the selected +writer, which is specified by the @option{print_format} option. + +Metadata tags stored in the container or in the streams are recognized +and printed in the corresponding "FORMAT" or "STREAM" section. + +@c man end + +@chapter Options +@c man begin OPTIONS + +@include avtools-common-opts.texi + +@section Main options + +@table @option + +@item -f @var{format} +Force format to use. + +@item -unit +Show the unit of the displayed values. + +@item -prefix +Use SI prefixes for the displayed values. +Unless the "-byte_binary_prefix" option is used all the prefixes +are decimal. + +@item -byte_binary_prefix +Force the use of binary prefixes for byte values. + +@item -sexagesimal +Use sexagesimal format HH:MM:SS.MICROSECONDS for time values. + +@item -pretty +Prettify the format of the displayed values, it corresponds to the +options "-unit -prefix -byte_binary_prefix -sexagesimal". + +@item -print_format @var{writer_name}[=@var{writer_options}] +Set the output printing format. + +@var{writer_name} specifies the name of the writer, and +@var{writer_options} specifies the options to be passed to the writer. + +For example for printing the output in JSON format, specify: +@example +-print_format json +@end example + +For more details on the available output printing formats, see the +Writers section below. + +@item -show_error +Show information about the error found when trying to probe the input. + +The error information is printed within a section with name "ERROR". + +@item -show_format +Show information about the container format of the input multimedia +stream. + +All the container format information is printed within a section with +name "FORMAT". + +@item -show_packets +Show information about each packet contained in the input multimedia +stream. + +The information for each single packet is printed within a dedicated +section with name "PACKET". + +@item -show_frames +Show information about each video frame contained in the input multimedia +stream. + +The information for each single frame is printed within a dedicated +section with name "FRAME". + +@item -show_streams +Show information about each media stream contained in the input +multimedia stream. + +Each media stream information is printed within a dedicated section +with name "STREAM". + +@item -show_private_data, -private +Show private data, that is data depending on the format of the +particular shown element. +This option is enabled by default, but you may need to disable it +for specific uses, for example when creating XSD-compliant XML output. + +@item -show_program_version +Show information related to program version. + +Version information is printed within a section with name +"PROGRAM_VERSION". + +@item -show_library_versions +Show information related to library versions. + +Version information for each library is printed within a section with +name "LIBRARY_VERSION". + +@item -show_versions +Show information related to program and library versions. This is the +equivalent of setting both @option{-show_program_version} and +@option{-show_library_versions} options. + +@item -i @var{input_file} +Read @var{input_file}. + +@end table +@c man end + +@chapter Writers +@c man begin WRITERS + +A writer defines the output format adopted by @command{ffprobe}, and will be +used for printing all the parts of the output. + +A writer may accept one or more arguments, which specify the options to +adopt. + +A description of the currently available writers follows. + +@section default +Default format. + +Print each section in the form: +@example +[SECTION] +key1=val1 +... +keyN=valN +[/SECTION] +@end example + +Metadata tags are printed as a line in the corresponding FORMAT or +STREAM section, and are prefixed by the string "TAG:". + +@section compact +Compact format. + +Each section is printed on a single line. +If no option is specifid, the output has the form: +@example +section|key1=val1| ... |keyN=valN +@end example + +Metadata tags are printed in the corresponding "format" or "stream" +section. A metadata tag key, if printed, is prefixed by the string +"tag:". + +This writer accepts options as a list of @var{key}=@var{value} pairs, +separated by ":". + +The description of the accepted options follows. + +@table @option + +@item item_sep, s +Specify the character to use for separating fields in the output line. +It must be a single printable character, it is "|" by default. + +@item nokey, nk +If set to 1 specify not to print the key of each field. Its default +value is 0. + +@item escape, e +Set the escape mode to use, default to "c". + +It can assume one of the following values: +@table @option +@item c +Perform C-like escaping. Strings containing a newline ('\n') or +carriage return ('\r'), the escaping character ('\') or the item +separator character @var{SEP} are escaped using C-like fashioned +escaping, so that a newline is converted to the sequence "\n", a +carriage return to "\r", '\' to "\\" and the separator @var{SEP} is +converted to "\@var{SEP}". + +@item csv +Perform CSV-like escaping, as described in RFC4180. Strings +containing a newline ('\n'), a carriage return ('\r'), a double quote +('"'), or @var{SEP} are enclosed in double-quotes. + +@item none +Perform no escaping. +@end table + +@end table + +@section csv +CSV format. + +This writer is equivalent to +@code{compact=item_sep=,:nokey=1:escape=csv}. + +@section json +JSON based format. + +Each section is printed using JSON notation. + +This writer accepts options as a list of @var{key}=@var{value} pairs, +separated by ":". + +The description of the accepted options follows. + +@table @option + +@item compact, c +If set to 1 enable compact output, that is each section will be +printed on a single line. Default value is 0. +@end table + +For more information about JSON, see @url{http://www.json.org/}. + +@section xml +XML based format. + +The XML output is described in the XML schema description file +@file{ffprobe.xsd} installed in the FFmpeg datadir. + +Note that the output issued will be compliant to the +@file{ffprobe.xsd} schema only when no special global output options +(@option{unit}, @option{prefix}, @option{byte_binary_prefix}, +@option{sexagesimal} etc.) are specified. + +This writer accepts options as a list of @var{key}=@var{value} pairs, +separated by ":". + +The description of the accepted options follows. + +@table @option + +@item fully_qualified, q +If set to 1 specify if the output should be fully qualified. Default +value is 0. +This is required for generating an XML file which can be validated +through an XSD file. + +@item xsd_compliant, x +If set to 1 perform more checks for ensuring that the output is XSD +compliant. Default value is 0. +This option automatically sets @option{fully_qualified} to 1. +@end table + +For more information about the XML format, see +@url{http://www.w3.org/XML/}. + +@c man end WRITERS + +@include decoders.texi +@include demuxers.texi +@include protocols.texi +@include indevs.texi + +@ignore + +@setfilename ffprobe +@settitle ffprobe media prober + +@c man begin SEEALSO +ffmpeg(1), ffplay(1), ffserver(1) and the FFmpeg HTML documentation +@c man end + +@c man begin AUTHORS +The FFmpeg developers +@c man end + +@end ignore + +@bye diff --git a/doc/ffprobe.xsd b/doc/ffprobe.xsd new file mode 100644 index 0000000000..e8269de333 --- /dev/null +++ b/doc/ffprobe.xsd @@ -0,0 +1,160 @@ +<?xml version="1.0" encoding="UTF-8"?> + +<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" + targetNamespace="http://www.ffmpeg.org/schema/ffprobe" + xmlns:ffprobe="http://www.ffmpeg.org/schema/ffprobe"> + + <xsd:element name="ffprobe" type="ffprobe:ffprobeType"/> + + <xsd:complexType name="ffprobeType"> + <xsd:sequence> + <xsd:element name="packets" type="ffprobe:packetsType" minOccurs="0" maxOccurs="1" /> + <xsd:element name="frames" type="ffprobe:framesType" minOccurs="0" maxOccurs="1" /> + <xsd:element name="streams" type="ffprobe:streamsType" minOccurs="0" maxOccurs="1" /> + <xsd:element name="format" type="ffprobe:formatType" minOccurs="0" maxOccurs="1" /> + <xsd:element name="error" type="ffprobe:errorType" minOccurs="0" maxOccurs="1" /> + <xsd:element name="program_version" type="ffprobe:programVersionType" minOccurs="0" maxOccurs="1" /> + <xsd:element name="library_versions" type="ffprobe:libraryVersionsType" minOccurs="0" maxOccurs="1" /> + </xsd:sequence> + </xsd:complexType> + + <xsd:complexType name="packetsType"> + <xsd:sequence> + <xsd:element name="packet" type="ffprobe:packetType" minOccurs="0" maxOccurs="unbounded"/> + </xsd:sequence> + </xsd:complexType> + + <xsd:complexType name="framesType"> + <xsd:sequence> + <xsd:element name="frame" type="ffprobe:frameType" minOccurs="0" maxOccurs="unbounded"/> + </xsd:sequence> + </xsd:complexType> + + <xsd:complexType name="packetType"> + <xsd:attribute name="codec_type" type="xsd:string" use="required" /> + <xsd:attribute name="stream_index" type="xsd:int" use="required" /> + <xsd:attribute name="pts" type="xsd:long" /> + <xsd:attribute name="pts_time" type="xsd:float" /> + <xsd:attribute name="dts" type="xsd:long" /> + <xsd:attribute name="dts_time" type="xsd:float" /> + <xsd:attribute name="duration" type="xsd:long" /> + <xsd:attribute name="duration_time" type="xsd:float" /> + <xsd:attribute name="size" type="xsd:long" use="required" /> + <xsd:attribute name="pos" type="xsd:long" /> + <xsd:attribute name="flags" type="xsd:string" use="required" /> + </xsd:complexType> + + <xsd:complexType name="frameType"> + <xsd:attribute name="media_type" type="xsd:string" use="required"/> + <xsd:attribute name="key_frame" type="xsd:int" use="required"/> + <xsd:attribute name="pts" type="xsd:long" /> + <xsd:attribute name="pts_time" type="xsd:float"/> + <xsd:attribute name="pkt_pts" type="xsd:long" /> + <xsd:attribute name="pkt_pts_time" type="xsd:float"/> + <xsd:attribute name="pkt_dts" type="xsd:long" /> + <xsd:attribute name="pkt_dts_time" type="xsd:float"/> + <xsd:attribute name="pkt_pos" type="xsd:long" /> + + <!-- video attributes --> + <xsd:attribute name="width" type="xsd:long" /> + <xsd:attribute name="height" type="xsd:long" /> + <xsd:attribute name="pix_fmt" type="xsd:string"/> + <xsd:attribute name="sample_aspect_ratio" type="xsd:string"/> + <xsd:attribute name="pict_type" type="xsd:string"/> + <xsd:attribute name="coded_picture_number" type="xsd:long" /> + <xsd:attribute name="display_picture_number" type="xsd:long" /> + <xsd:attribute name="interlaced_frame" type="xsd:int" /> + <xsd:attribute name="top_field_first" type="xsd:int" /> + <xsd:attribute name="repeat_pict" type="xsd:int" /> + <xsd:attribute name="reference" type="xsd:int" /> + </xsd:complexType> + + <xsd:complexType name="streamsType"> + <xsd:sequence> + <xsd:element name="stream" type="ffprobe:streamType" minOccurs="0" maxOccurs="unbounded"/> + </xsd:sequence> + </xsd:complexType> + + <xsd:complexType name="streamType"> + <xsd:attribute name="index" type="xsd:int" use="required"/> + <xsd:attribute name="codec_name" type="xsd:string" /> + <xsd:attribute name="codec_long_name" type="xsd:string" /> + <xsd:attribute name="codec_type" type="xsd:string" /> + <xsd:attribute name="codec_time_base" type="xsd:string" use="required"/> + <xsd:attribute name="codec_tag" type="xsd:string" use="required"/> + <xsd:attribute name="codec_tag_string" type="xsd:string" use="required"/> + + <!-- video attributes --> + <xsd:attribute name="width" type="xsd:int"/> + <xsd:attribute name="height" type="xsd:int"/> + <xsd:attribute name="has_b_frames" type="xsd:int"/> + <xsd:attribute name="sample_aspect_ratio" type="xsd:string"/> + <xsd:attribute name="display_aspect_ratio" type="xsd:string"/> + <xsd:attribute name="pix_fmt" type="xsd:string"/> + <xsd:attribute name="level" type="xsd:int"/> + <xsd:attribute name="timecode" type="xsd:string"/> + + <!-- audio attributes --> + <xsd:attribute name="sample_fmt" type="xsd:string"/> + <xsd:attribute name="sample_rate" type="xsd:int"/> + <xsd:attribute name="channels" type="xsd:int"/> + <xsd:attribute name="bits_per_sample" type="xsd:int"/> + + <xsd:attribute name="id" type="xsd:string"/> + <xsd:attribute name="r_frame_rate" type="xsd:string" use="required"/> + <xsd:attribute name="avg_frame_rate" type="xsd:string" use="required"/> + <xsd:attribute name="time_base" type="xsd:string" use="required"/> + <xsd:attribute name="start_time" type="xsd:float"/> + <xsd:attribute name="duration" type="xsd:float"/> + <xsd:attribute name="nb_frames" type="xsd:int"/> + </xsd:complexType> + + <xsd:complexType name="formatType"> + <xsd:sequence> + <xsd:element name="tag" type="ffprobe:tagType" minOccurs="0" maxOccurs="unbounded"/> + </xsd:sequence> + + <xsd:attribute name="filename" type="xsd:string" use="required"/> + <xsd:attribute name="nb_streams" type="xsd:int" use="required"/> + <xsd:attribute name="format_name" type="xsd:string" use="required"/> + <xsd:attribute name="format_long_name" type="xsd:string" use="required"/> + <xsd:attribute name="start_time" type="xsd:float"/> + <xsd:attribute name="duration" type="xsd:float"/> + <xsd:attribute name="size" type="xsd:long"/> + <xsd:attribute name="bit_rate" type="xsd:long"/> + </xsd:complexType> + + <xsd:complexType name="tagType"> + <xsd:attribute name="key" type="xsd:string" use="required"/> + <xsd:attribute name="value" type="xsd:string" use="required"/> + </xsd:complexType> + + <xsd:complexType name="errorType"> + <xsd:attribute name="code" type="xsd:int" use="required"/> + <xsd:attribute name="string" type="xsd:string" use="required"/> + </xsd:complexType> + + <xsd:complexType name="programVersionType"> + <xsd:attribute name="version" type="xsd:string" use="required"/> + <xsd:attribute name="copyright" type="xsd:string" use="required"/> + <xsd:attribute name="build_date" type="xsd:string" use="required"/> + <xsd:attribute name="build_time" type="xsd:string" use="required"/> + <xsd:attribute name="compiler_type" type="xsd:string" use="required"/> + <xsd:attribute name="compiler_version" type="xsd:string" use="required"/> + <xsd:attribute name="configuration" type="xsd:string" use="required"/> + </xsd:complexType> + + <xsd:complexType name="libraryVersionType"> + <xsd:attribute name="name" type="xsd:string" use="required"/> + <xsd:attribute name="major" type="xsd:int" use="required"/> + <xsd:attribute name="minor" type="xsd:int" use="required"/> + <xsd:attribute name="micro" type="xsd:int" use="required"/> + <xsd:attribute name="version" type="xsd:int" use="required"/> + </xsd:complexType> + + <xsd:complexType name="libraryVersionsType"> + <xsd:sequence> + <xsd:element name="library_version" type="ffprobe:libraryVersionType" minOccurs="0" maxOccurs="unbounded"/> + </xsd:sequence> + </xsd:complexType> +</xsd:schema> diff --git a/doc/avserver.conf b/doc/ffserver.conf index 1f21f4d002..217117005c 100644 --- a/doc/avserver.conf +++ b/doc/ffserver.conf @@ -12,7 +12,7 @@ BindAddress 0.0.0.0 # MaxClients maximum limit. MaxHTTPConnections 2000 -# Number of simultaneous requests that can be handled. Since AVServer +# Number of simultaneous requests that can be handled. Since FFServer # is very fast, it is more likely that you will want to leave this high # and use MaxBandwidth, below. MaxClients 1000 @@ -25,24 +25,24 @@ MaxBandwidth 1000 # '-' is the standard output. CustomLog - -# Suppress that if you want to launch avserver as a daemon. +# Suppress that if you want to launch ffserver as a daemon. NoDaemon ################################################################## # Definition of the live feeds. Each live feed contains one video -# and/or audio sequence coming from an avconv encoder or another -# avserver. This sequence may be encoded simultaneously with several +# and/or audio sequence coming from an ffmpeg encoder or another +# ffserver. This sequence may be encoded simultaneously with several # codecs at several resolutions. <Feed feed1.ffm> -# You must use 'avconv' to send a live feed to avserver. In this +# You must use 'ffmpeg' to send a live feed to ffserver. In this # example, you can type: # -# avconv http://localhost:8090/feed1.ffm +# ffmpeg http://localhost:8090/feed1.ffm -# avserver can also do time shifting. It means that it can stream any +# ffserver can also do time shifting. It means that it can stream any # previously recorded live stream. The request should contain: # "http://xxxx?date=[YYYY-MM-DDT][[HH:]MM:]SS[.m...]".You must specify # a path where the feed is stored on disk. You also specify the @@ -55,10 +55,10 @@ FileMaxSize 200K # ReadOnlyFile /saved/specialvideo.ffm # This marks the file as readonly and it will not be deleted or updated. -# Specify launch in order to start avconv automatically. -# First avconv must be defined with an appropriate path if needed, +# Specify launch in order to start ffmpeg automatically. +# First ffmpeg must be defined with an appropriate path if needed, # after that options can follow, but avoid adding the http:// field -#Launch avconv +#Launch ffmpeg # Only allow connections from localhost to the feed. ACL allow 127.0.0.1 @@ -69,7 +69,7 @@ ACL allow 127.0.0.1 ################################################################## # Now you can define each stream which will be generated from the # original audio and video stream. Each format has a filename (here -# 'test1.mpg'). AVServer will send this stream when answering a +# 'test1.mpg'). FFServer will send this stream when answering a # request containing this filename. <Stream test1.mpg> @@ -334,7 +334,7 @@ StartSendOnKey # multicast address with MulticastAddress. The port and the TTL can # also be set. # -# An SDP file is automatically generated by avserver by adding the +# An SDP file is automatically generated by ffserver by adding the # 'sdp' extension to the stream name (here # http://localhost:8090/test1-sdp.sdp). You should usually give this # file to your player to play the stream. @@ -371,7 +371,7 @@ ACL allow 192.168.0.0 192.168.255.255 # Redirect index.html to the appropriate site <Redirect index.html> -URL http://www.libav.org/ +URL http://www.ffmpeg.org/ </Redirect> diff --git a/doc/avserver.texi b/doc/ffserver.texi index c023814e08..074c075f0b 100644 --- a/doc/avserver.texi +++ b/doc/ffserver.texi @@ -1,8 +1,8 @@ \input texinfo @c -*- texinfo -*- -@settitle avserver Documentation +@settitle ffserver Documentation @titlepage -@center @titlefont{avserver Documentation} +@center @titlefont{ffserver Documentation} @end titlepage @top @@ -15,41 +15,38 @@ The generic syntax is: @example @c man begin SYNOPSIS -avserver [options] +ffserver [options] @c man end @end example @chapter Description @c man begin DESCRIPTION -WARNING: avserver is unmaintained, largely broken and in need of a -complete rewrite. It probably won't work for you. Use at your own -risk. +ffserver is a streaming server for both audio and video. It supports -avserver is a streaming server for both audio and video. It supports several live feeds, streaming from files and time shifting on live feeds (you can seek to positions in the past on each live feed, provided you -specify a big enough feed storage in avserver.conf). +specify a big enough feed storage in ffserver.conf). -avserver runs in daemon mode by default; that is, it puts itself in +ffserver runs in daemon mode by default; that is, it puts itself in the background and detaches from its TTY, unless it is launched in debug mode or a NoDaemon option is specified in the configuration file. -This documentation covers only the streaming aspects of avserver / -avconv. All questions about parameters for avconv, codec questions, -etc. are not covered here. Read @file{avconv.html} for more +This documentation covers only the streaming aspects of ffserver / +ffmpeg. All questions about parameters for ffmpeg, codec questions, +etc. are not covered here. Read @file{ffmpeg.html} for more information. @section How does it work? -avserver receives prerecorded files or FFM streams from some avconv +ffserver receives prerecorded files or FFM streams from some ffmpeg instance as input, then streams them over RTP/RTSP/HTTP. -An avserver instance will listen on some port as specified in the -configuration file. You can launch one or more instances of avconv and -send one or more FFM streams to the port where avserver is expecting -to receive them. Alternately, you can make avserver launch such avconv +An ffserver instance will listen on some port as specified in the +configuration file. You can launch one or more instances of ffmpeg and +send one or more FFM streams to the port where ffserver is expecting +to receive them. Alternately, you can make ffserver launch such ffmpeg instances at startup. Input streams are called feeds, and each one is specified by a <Feed> @@ -61,7 +58,7 @@ file. @section Status stream -avserver supports an HTTP interface which exposes the current status +ffserver supports an HTTP interface which exposes the current status of the server. Simply point your browser to the address of the special status stream @@ -104,18 +101,18 @@ I understand that FreeBSD systems work just fine as well. @section How do I make it work? First, build the kit. It *really* helps to have installed LAME first. Then when -you run the avserver ./configure, make sure that you have the +you run the ffserver ./configure, make sure that you have the @code{--enable-libmp3lame} flag turned on. LAME is important as it allows for streaming audio to Windows Media Player. Don't ask why the other audio types do not work. As a simple test, just run the following two command lines where INPUTFILE -is some file which you can decode with avconv: +is some file which you can decode with ffmpeg: @example -./avserver -f doc/avserver.conf & -./avconv -i INPUTFILE http://localhost:8090/feed1.ffm +ffserver -f doc/ffserver.conf & +ffmpeg -i INPUTFILE http://localhost:8090/feed1.ffm @end example At this point you should be able to go to your Windows machine and fire up @@ -133,8 +130,8 @@ The same is true of AVI files. @section What happens next? -You should edit the avserver.conf file to suit your needs (in terms of -frame rates etc). Then install avserver and avconv, write a script to start +You should edit the ffserver.conf file to suit your needs (in terms of +frame rates etc). Then install ffserver and ffmpeg, write a script to start them up, and off you go. @section Troubleshooting @@ -142,13 +139,13 @@ them up, and off you go. @subsection I don't hear any audio, but video is fine. Maybe you didn't install LAME, or got your ./configure statement wrong. Check -the avconv output to see if a line referring to MP3 is present. If not, then +the ffmpeg output to see if a line referring to MP3 is present. If not, then your configuration was incorrect. If it is, then maybe your wiring is not set up correctly. Maybe the sound card is not getting data from the right input source. Maybe you have a really awful audio interface (like I do) that only captures in stereo and also requires that one channel be flipped. If you are one of these people, then export 'AUDIO_FLIP_LEFT=1' before -starting avconv. +starting ffmpeg. @subsection The audio and video lose sync after a while. @@ -170,14 +167,14 @@ I suspect that the new one is not available unless you have installed WMP 7]. You can replay video from .ffm files that was recorded earlier. However, there are a number of caveats, including the fact that the -avserver parameters must match the original parameters used to record the -file. If they do not, then avserver deletes the file before recording into it. +ffserver parameters must match the original parameters used to record the +file. If they do not, then ffserver deletes the file before recording into it. (Now that I write this, it seems broken). You can fiddle with many of the codec choices and encoding parameters, and there are a bunch more parameters that you cannot control. Post a message to the mailing list if there are some 'must have' parameters. Look in -avserver.conf for a list of the currently available controls. +ffserver.conf for a list of the currently available controls. It will automatically generate the ASX or RAM files that are often used in browsers. These files are actually redirections to the underlying ASF @@ -191,7 +188,7 @@ finishes.] * When you connect to a live stream, most players (WMP, RA, etc) want to buffer a certain number of seconds of material so that they can display the -signal continuously. However, avserver (by default) starts sending data +signal continuously. However, ffserver (by default) starts sending data in realtime. This means that there is a pause of a few seconds while the buffering is being done by the player. The good news is that this can be cured by adding a '?buffer=5' to the end of the URL. This means that the @@ -199,13 +196,13 @@ stream should start 5 seconds in the past -- and so the first 5 seconds of the stream are sent as fast as the network will allow. It will then slow down to real time. This noticeably improves the startup experience. -You can also add a 'Preroll 15' statement into the avserver.conf that will +You can also add a 'Preroll 15' statement into the ffserver.conf that will add the 15 second prebuffering on all requests that do not otherwise -specify a time. In addition, avserver will skip frames until a key_frame +specify a time. In addition, ffserver will skip frames until a key_frame is found. This further reduces the startup delay by not transferring data that will be discarded. -* You may want to adjust the MaxBandwidth in the avserver.conf to limit +* You may want to adjust the MaxBandwidth in the ffserver.conf to limit the amount of bandwidth consumed by live streams. @section Why does the ?buffer / Preroll stop working after a time? @@ -222,7 +219,7 @@ handled. @section Does the @code{?date=} stuff work. Yes (subject to the limitation outlined above). Also note that whenever you -start avserver, it deletes the ffm file (if any parameters have changed), +start ffserver, it deletes the ffm file (if any parameters have changed), thus wiping out what you had recorded before. The format of the @code{?date=xxxxxx} is fairly flexible. You should use one @@ -250,31 +247,31 @@ For example: @samp{http://localhost:8080/test.asf?date=2002-07-26T23:05:00}. @table @option @item -f @var{configfile} -Use @file{configfile} instead of @file{/etc/avserver.conf}. +Use @file{configfile} instead of @file{/etc/ffserver.conf}. @item -n Enable no-launch mode. This option disables all the Launch directives -within the various <Stream> sections. Since avserver will not launch -any avconv instances, you will have to launch them manually. +within the various <Stream> sections. Since ffserver will not launch +any ffmpeg instances, you will have to launch them manually. @item -d Enable debug mode. This option increases log verbosity, directs log -messages to stdout and causes avserver to run in the foreground +messages to stdout and causes ffserver to run in the foreground rather than as a daemon. @end table @c man end @ignore -@setfilename avserver -@settitle avserver video server +@setfilename ffserver +@settitle ffserver video server @c man begin SEEALSO -avconv(1), avplay(1), avprobe(1), the @file{avserver.conf} -example and the Libav HTML documentation +ffmpeg(1), ffplay(1), ffprobe(1), the @file{ffserver.conf} +example and the FFmpeg HTML documentation @c man end @c man begin AUTHORS -The Libav developers +The FFmpeg developers @c man end @end ignore diff --git a/doc/filters.texi b/doc/filters.texi index 4e7ede23a4..d0075f2453 100644 --- a/doc/filters.texi +++ b/doc/filters.texi @@ -17,9 +17,9 @@ output pads is called a "sink". @section Filtergraph syntax A filtergraph can be represented using a textual representation, which -is recognized by the @code{-vf} and @code{-af} options in @command{avconv} -and @command{avplay}, and by the @code{av_parse_graph()} function defined in -@file{libavfilter/avfiltergraph}. +is recognized by the @code{-vf} option of the ff* +tools, and by the @code{avfilter_graph_parse()} function defined in +@file{libavfilter/avfiltergraph.h}. A filterchain consists of a sequence of connected filters, each one connected to the previous one in the sequence. A filterchain is @@ -92,17 +92,352 @@ Follows a BNF description for the filtergraph syntax: @chapter Audio Filters @c man begin AUDIO FILTERS -When you configure your Libav build, you can disable any of the -existing filters using --disable-filters. +When you configure your FFmpeg build, you can disable any of the +existing filters using @code{--disable-filters}. The configure output will show the audio filters included in your build. Below is a description of the currently available audio filters. +@section aconvert + +Convert the input audio format to the specified formats. + +The filter accepts a string of the form: +"@var{sample_format}:@var{channel_layout}:@var{packing_format}". + +@var{sample_format} specifies the sample format, and can be a string or +the corresponding numeric value defined in @file{libavutil/samplefmt.h}. + +@var{channel_layout} specifies the channel layout, and can be a string +or the corresponding number value defined in @file{libavutil/audioconvert.h}. + +@var{packing_format} specifies the type of packing in output, can be one +of "planar" or "packed", or the corresponding numeric values "0" or "1". + +The special parameter "auto", signifies that the filter will +automatically select the output format depending on the output filter. + +Some examples follow. + +@itemize +@item +Convert input to unsigned 8-bit, stereo, packed: +@example +aconvert=u8:stereo:packed +@end example + +@item +Convert input to unsigned 8-bit, automatically select out channel layout +and packing format: +@example +aconvert=u8:auto:auto +@end example +@end itemize + +@section aformat + +Convert the input audio to one of the specified formats. The framework will +negotiate the most appropriate format to minimize conversions. + +The filter accepts three lists of formats, separated by ":", in the form: +"@var{sample_formats}:@var{channel_layouts}:@var{packing_formats}". + +Elements in each list are separated by "," which has to be escaped in the +filtergraph specification. + +The special parameter "all", in place of a list of elements, signifies all +supported formats. + +Some examples follow: +@example +aformat=u8\\,s16:mono:packed + +aformat=s16:mono\\,stereo:all +@end example + +@section amerge + +Merge two audio streams into a single multi-channel stream. + +This filter does not need any argument. + +If the channel layouts of the inputs are disjoint, and therefore compatible, +the channel layout of the output will be set accordingly and the channels +will be reordered as necessary. If the channel layouts of the inputs are not +disjoint, the output will have all the channels of the first input then all +the channels of the second input, in that order, and the channel layout of +the output will be the default value corresponding to the total number of +channels. + +For example, if the first input is in 2.1 (FL+FR+LF) and the second input +is FC+BL+BR, then the output will be in 5.1, with the channels in the +following order: a1, a2, b1, a3, b2, b3 (a1 is the first channel of the +first input, b1 is the first channel of the second input). + +On the other hand, if both input are in stereo, the output channels will be +in the default order: a1, a2, b1, b2, and the channel layout will be +arbitrarily set to 4.0, which may or may not be the expected value. + +Both inputs must have the same sample rate, format and packing. + +If inputs do not have the same duration, the output will stop with the +shortest. + +Example: merge two mono files into a stereo stream: +@example +amovie=left.wav [l] ; amovie=right.mp3 [r] ; [l] [r] amerge +@end example + @section anull Pass the audio source unchanged to the output. +@section aresample + +Resample the input audio to the specified sample rate. + +The filter accepts exactly one parameter, the output sample rate. If not +specified then the filter will automatically convert between its input +and output sample rates. + +For example, to resample the input audio to 44100Hz: +@example +aresample=44100 +@end example + +@section ashowinfo + +Show a line containing various information for each input audio frame. +The input audio is not modified. + +The shown line contains a sequence of key/value pairs of the form +@var{key}:@var{value}. + +A description of each shown parameter follows: + +@table @option +@item n +sequential number of the input frame, starting from 0 + +@item pts +presentation TimeStamp of the input frame, expressed as a number of +time base units. The time base unit depends on the filter input pad, and +is usually 1/@var{sample_rate}. + +@item pts_time +presentation TimeStamp of the input frame, expressed as a number of +seconds + +@item pos +position of the frame in the input stream, -1 if this information in +unavailable and/or meaningless (for example in case of synthetic audio) + +@item fmt +sample format name + +@item chlayout +channel layout description + +@item nb_samples +number of samples (per each channel) contained in the filtered frame + +@item rate +sample rate for the audio frame + +@item planar +if the packing format is planar, 0 if packed + +@item checksum +Adler-32 checksum (printed in hexadecimal) of all the planes of the input frame + +@item plane_checksum +Adler-32 checksum (printed in hexadecimal) for each input frame plane, +expressed in the form "[@var{c0} @var{c1} @var{c2} @var{c3} @var{c4} @var{c5} +@var{c6} @var{c7}]" +@end table + +@section asplit + +Pass on the input audio to two outputs. Both outputs are identical to +the input audio. + +For example: +@example +[in] asplit[out0], showaudio[out1] +@end example + +will create two separate outputs from the same input, one cropped and +one padded. + +@section astreamsync + +Forward two audio streams and control the order the buffers are forwarded. + +The argument to the filter is an expression deciding which stream should be +forwarded next: if the result is negative, the first stream is forwarded; if +the result is positive or zero, the second stream is forwarded. It can use +the following variables: + +@table @var +@item b1 b2 +number of buffers forwarded so far on each stream +@item s1 s2 +number of samples forwarded so far on each stream +@item t1 t2 +current timestamp of each stream +@end table + +The default value is @code{t1-t2}, which means to always forward the stream +that has a smaller timestamp. + +Example: stress-test @code{amerge} by randomly sending buffers on the wrong +input, while avoiding too much of a desynchronization: +@example +amovie=file.ogg [a] ; amovie=file.mp3 [b] ; +[a] [b] astreamsync=(2*random(1))-1+tanh(5*(t1-t2)) [a2] [b2] ; +[a2] [b2] amerge +@end example + +@section earwax + +Make audio easier to listen to on headphones. + +This filter adds `cues' to 44.1kHz stereo (i.e. audio CD format) audio +so that when listened to on headphones the stereo image is moved from +inside your head (standard for headphones) to outside and in front of +the listener (standard for speakers). + +Ported from SoX. + +@section pan + +Mix channels with specific gain levels. The filter accepts the output +channel layout followed by a set of channels definitions. + +The filter accepts parameters of the form: +"@var{l}:@var{outdef}:@var{outdef}:..." + +@table @option +@item l +output channel layout or number of channels + +@item outdef +output channel specification, of the form: +"@var{out_name}=[@var{gain}*]@var{in_name}[+[@var{gain}*]@var{in_name}...]" + +@item out_name +output channel to define, either a channel name (FL, FR, etc.) or a channel +number (c0, c1, etc.) + +@item gain +multiplicative coefficient for the channel, 1 leaving the volume unchanged + +@item in_name +input channel to use, see out_name for details; it is not possible to mix +named and numbered input channels +@end table + +If the `=' in a channel specification is replaced by `<', then the gains for +that specification will be renormalized so that the total is 1, thus +avoiding clipping noise. + +For example, if you want to down-mix from stereo to mono, but with a bigger +factor for the left channel: +@example +pan=1:c0=0.9*c0+0.1*c1 +@end example + +A customized down-mix to stereo that works automatically for 3-, 4-, 5- and +7-channels surround: +@example +pan=stereo: FL < FL + 0.5*FC + 0.6*BL + 0.6*SL : FR < FR + 0.5*FC + 0.6*BR + 0.6*SR +@end example + +Note that @command{ffmpeg} integrates a default down-mix (and up-mix) system +that should be preferred (see "-ac" option) unless you have very specific +needs. + +@section silencedetect + +Detect silence in an audio stream. + +This filter logs a message when it detects that the input audio volume is less +or equal to a noise tolerance value for a duration greater or equal to the +minimum detected noise duration. + +The printed times and duration are expressed in seconds. + +@table @option +@item duration, d +Set silence duration until notification (default is 2 seconds). + +@item noise, n +Set noise tolerance. Can be specified in dB (in case "dB" is appended to the +specified value) or amplitude ratio. Default is -60dB, or 0.001. +@end table + +Detect 5 seconds of silence with -50dB noise tolerance: +@example +silencedetect=n=-50dB:d=5 +@end example + +Complete example with @command{ffmpeg} to detect silence with 0.0001 noise +tolerance in @file{silence.mp3}: +@example +ffmpeg -f lavfi -i amovie=silence.mp3,silencedetect=noise=0.0001 -f null - +@end example + +@section volume + +Adjust the input audio volume. + +The filter accepts exactly one parameter @var{vol}, which expresses +how the audio volume will be increased or decreased. + +Output values are clipped to the maximum value. + +If @var{vol} is expressed as a decimal number, the output audio +volume is given by the relation: +@example +@var{output_volume} = @var{vol} * @var{input_volume} +@end example + +If @var{vol} is expressed as a decimal number followed by the string +"dB", the value represents the requested change in decibels of the +input audio power, and the output audio volume is given by the +relation: +@example +@var{output_volume} = 10^(@var{vol}/20) * @var{input_volume} +@end example + +Otherwise @var{vol} is considered an expression and its evaluated +value is used for computing the output audio volume according to the +first relation. + +Default value for @var{vol} is 1.0. + +@subsection Examples + +@itemize +@item +Half the input audio volume: +@example +volume=0.5 +@end example + +The above example is equivalent to: +@example +volume=1/2 +@end example + +@item +Decrease input audio power by 12 decibels: +@example +volume=-12dB +@end example +@end itemize + @c man end AUDIO FILTERS @chapter Audio Sources @@ -110,31 +445,212 @@ Pass the audio source unchanged to the output. Below is a description of the currently available audio sources. +@section abuffer + +Buffer audio frames, and make them available to the filter chain. + +This source is mainly intended for a programmatic use, in particular +through the interface defined in @file{libavfilter/asrc_abuffer.h}. + +It accepts the following mandatory parameters: +@var{sample_rate}:@var{sample_fmt}:@var{channel_layout}:@var{packing} + +@table @option + +@item sample_rate +The sample rate of the incoming audio buffers. + +@item sample_fmt +The sample format of the incoming audio buffers. +Either a sample format name or its corresponging integer representation from +the enum AVSampleFormat in @file{libavutil/samplefmt.h} + +@item channel_layout +The channel layout of the incoming audio buffers. +Either a channel layout name from channel_layout_map in +@file{libavutil/audioconvert.c} or its corresponding integer representation +from the AV_CH_LAYOUT_* macros in @file{libavutil/audioconvert.h} + +@item packing +Either "packed" or "planar", or their integer representation: 0 or 1 +respectively. + +@end table + +For example: +@example +abuffer=44100:s16:stereo:planar +@end example + +will instruct the source to accept planar 16bit signed stereo at 44100Hz. +Since the sample format with name "s16" corresponds to the number +1 and the "stereo" channel layout corresponds to the value 3, this is +equivalent to: +@example +abuffer=44100:1:3:1 +@end example + +@section aevalsrc + +Generate an audio signal specified by an expression. + +This source accepts in input one or more expressions (one for each +channel), which are evaluated and used to generate a corresponding +audio signal. + +It accepts the syntax: @var{exprs}[::@var{options}]. +@var{exprs} is a list of expressions separated by ":", one for each +separate channel. The output channel layout depends on the number of +provided expressions, up to 8 channels are supported. + +@var{options} is an optional sequence of @var{key}=@var{value} pairs, +separated by ":". + +The description of the accepted options follows. + +@table @option + +@item duration, d +Set the minimum duration of the sourced audio. See the function +@code{av_parse_time()} for the accepted format. +Note that the resulting duration may be greater than the specified +duration, as the generated audio is always cut at the end of a +complete frame. + +If not specified, or the expressed duration is negative, the audio is +supposed to be generated forever. + +@item nb_samples, n +Set the number of samples per channel per each output frame, +default to 1024. + +@item sample_rate, s +Specify the sample rate, default to 44100. +@end table + +Each expression in @var{exprs} can contain the following constants: + +@table @option +@item n +number of the evaluated sample, starting from 0 + +@item t +time of the evaluated sample expressed in seconds, starting from 0 + +@item s +sample rate + +@end table + +@subsection Examples + +@itemize + +@item +Generate silence: +@example +aevalsrc=0 +@end example + +@item + +Generate a sin signal with frequency of 440 Hz, set sample rate to +8000 Hz: +@example +aevalsrc="sin(440*2*PI*t)::s=8000" +@end example + +@item +Generate white noise: +@example +aevalsrc="-2+random(0)" +@end example + +@item +Generate an amplitude modulated signal: +@example +aevalsrc="sin(10*2*PI*t)*sin(880*2*PI*t)" +@end example + +@item +Generate 2.5 Hz binaural beats on a 360 Hz carrier: +@example +aevalsrc="0.1*sin(2*PI*(360-2.5/2)*t) : 0.1*sin(2*PI*(360+2.5/2)*t)" +@end example + +@end itemize + +@section amovie + +Read an audio stream from a movie container. + +It accepts the syntax: @var{movie_name}[:@var{options}] where +@var{movie_name} is the name of the resource to read (not necessarily +a file but also a device or a stream accessed through some protocol), +and @var{options} is an optional sequence of @var{key}=@var{value} +pairs, separated by ":". + +The description of the accepted options follows. + +@table @option + +@item format_name, f +Specify the format assumed for the movie to read, and can be either +the name of a container or an input device. If not specified the +format is guessed from @var{movie_name} or by probing. + +@item seek_point, sp +Specify the seek point in seconds, the frames will be output +starting from this seek point, the parameter is evaluated with +@code{av_strtod} so the numerical value may be suffixed by an IS +postfix. Default value is "0". + +@item stream_index, si +Specify the index of the audio stream to read. If the value is -1, +the best suited audio stream will be automatically selected. Default +value is "-1". + +@end table + @section anullsrc -Null audio source, never return audio frames. It is mainly useful as a -template and to be employed in analysis / debugging tools. +Null audio source, return unprocessed audio frames. It is mainly useful +as a template and to be employed in analysis / debugging tools, or as +the source for filters which ignore the input data (for example the sox +synth filter). + +It accepts an optional sequence of @var{key}=@var{value} pairs, +separated by ":". + +The description of the accepted options follows. -It accepts as optional parameter a string of the form -@var{sample_rate}:@var{channel_layout}. +@table @option -@var{sample_rate} specify the sample rate, and defaults to 44100. +@item sample_rate, s +Specify the sample rate, and defaults to 44100. -@var{channel_layout} specify the channel layout, and can be either an -integer or a string representing a channel layout. The default value -of @var{channel_layout} is 3, which corresponds to CH_LAYOUT_STEREO. +@item channel_layout, cl + +Specify the channel layout, and can be either an integer or a string +representing a channel layout. The default value of @var{channel_layout} +is "stereo". Check the channel_layout_map definition in @file{libavcodec/audioconvert.c} for the mapping between strings and channel layout values. +@item nb_samples, n +Set the number of samples per requested frames. + +@end table + Follow some examples: @example -# set the sample rate to 48000 Hz and the channel layout to CH_LAYOUT_MONO. -anullsrc=48000:4 +# set the sample rate to 48000 Hz and the channel layout to AV_CH_LAYOUT_MONO. +anullsrc=r=48000:cl=4 # same as -anullsrc=48000:mono +anullsrc=r=48000:cl=mono @end example @c man end AUDIO SOURCES @@ -144,6 +660,17 @@ anullsrc=48000:mono Below is a description of the currently available audio sinks. +@section abuffersink + +Buffer audio frames, and make them available to the end of filter chain. + +This sink is mainly intended for programmatic use, in particular +through the interface defined in @file{libavfilter/buffersink.h}. + +It requires a pointer to an AVABufferSinkContext structure, which +defines the incoming buffers' formats, to be passed as the opaque +parameter to @code{avfilter_init_filter} for initialization. + @section anullsink Null audio sink, do absolutely nothing with the input audio. It is @@ -155,13 +682,29 @@ tools. @chapter Video Filters @c man begin VIDEO FILTERS -When you configure your Libav build, you can disable any of the -existing filters using --disable-filters. +When you configure your FFmpeg build, you can disable any of the +existing filters using @code{--disable-filters}. The configure output will show the video filters included in your build. Below is a description of the currently available video filters. +@section ass + +Draw ASS (Advanced Substation Alpha) subtitles on top of input video +using the libass library. + +To enable compilation of this filter you need to configure FFmpeg with +@code{--enable-libass}. + +This filter accepts in input the name of the ass file to render. + +For example, to render the file @file{sub.ass} on top of the input +video, use the command: +@example +ass=sub.ass +@end example + @section blackframe Detect frames that are (almost) completely black. Can be useful to @@ -188,7 +731,7 @@ considered black, and defaults to 32. Apply boxblur algorithm to the input video. This filter accepts the parameters: -@var{luma_power}:@var{luma_radius}:@var{chroma_radius}:@var{chroma_power}:@var{alpha_radius}:@var{alpha_power} +@var{luma_radius}:@var{luma_power}:@var{chroma_radius}:@var{chroma_power}:@var{alpha_radius}:@var{alpha_power} Chroma and alpha parameters are optional, if not specified they default to the corresponding values set for @var{luma_radius} and @@ -255,10 +798,6 @@ Crop the input video to @var{out_w}:@var{out_h}:@var{x}:@var{y}. The parameters are expressions containing the following constants: @table @option -@item E, PI, PHI -the corresponding mathematical approximated values for e -(euler number), pi (greek PI), PHI (golden ratio) - @item x, y the computed values for @var{x} and @var{y}. They are evaluated for each new frame. @@ -275,6 +814,19 @@ the output (cropped) width and height @item ow, oh same as @var{out_w} and @var{out_h} +@item a +same as @var{iw} / @var{ih} + +@item sar +input sample aspect ratio + +@item dar +input display aspect ratio, it is the same as (@var{iw} / @var{ih}) * @var{sar} + +@item hsub, vsub +horizontal and vertical chroma subsample values. For example for the +pixel format "yuv422p" @var{hsub} is 2 and @var{vsub} is 1. + @item n the number of input frame, starting from 0 @@ -433,6 +985,76 @@ delogo=x=0:y=0:w=100:h=77:band=10 @end itemize +@section deshake + +Attempt to fix small changes in horizontal and/or vertical shift. This +filter helps remove camera shake from hand-holding a camera, bumping a +tripod, moving on a vehicle, etc. + +The filter accepts parameters as a string of the form +"@var{x}:@var{y}:@var{w}:@var{h}:@var{rx}:@var{ry}:@var{edge}:@var{blocksize}:@var{contrast}:@var{search}:@var{filename}" + +A description of the accepted parameters follows. + +@table @option + +@item x, y, w, h +Specify a rectangular area where to limit the search for motion +vectors. +If desired the search for motion vectors can be limited to a +rectangular area of the frame defined by its top left corner, width +and height. These parameters have the same meaning as the drawbox +filter which can be used to visualise the position of the bounding +box. + +This is useful when simultaneous movement of subjects within the frame +might be confused for camera motion by the motion vector search. + +If any or all of @var{x}, @var{y}, @var{w} and @var{h} are set to -1 +then the full frame is used. This allows later options to be set +without specifying the bounding box for the motion vector search. + +Default - search the whole frame. + +@item rx, ry +Specify the maximum extent of movement in x and y directions in the +range 0-64 pixels. Default 16. + +@item edge +Specify how to generate pixels to fill blanks at the edge of the +frame. An integer from 0 to 3 as follows: +@table @option +@item 0 +Fill zeroes at blank locations +@item 1 +Original image at blank locations +@item 2 +Extruded edge value at blank locations +@item 3 +Mirrored edge at blank locations +@end table + +The default setting is mirror edge at blank locations. + +@item blocksize +Specify the blocksize to use for motion search. Range 4-128 pixels, +default 8. + +@item contrast +Specify the contrast threshold for blocks. Only blocks with more than +the specified contrast (difference between darkest and lightest +pixels) will be considered. Range 1-255, default 125. + +@item search +Specify the search strategy 0 = exhaustive search, 1 = less exhaustive +search. Default - exhaustive search. + +@item filename +If set then a detailed log of the motion search is written to the +specified file. + +@end table + @section drawbox Draw a colored box on the input image. @@ -470,7 +1092,7 @@ drawbox=10:20:200:60:red@@0.5" Draw text string or text from specified file on top of video using the libfreetype library. -To enable compilation of this filter you need to configure Libav with +To enable compilation of this filter you need to configure FFmpeg with @code{--enable-libfreetype}. The filter also recognizes strftime() sequences in the provided text @@ -503,36 +1125,13 @@ parameter @var{text}. If both text and textfile are specified, an error is thrown. @item x, y -The offsets where text will be drawn within the video frame. -Relative to the top/left border of the output image. -They accept expressions similar to the @ref{overlay} filter: -@table @option - -@item x, y -the computed values for @var{x} and @var{y}. They are evaluated for -each new frame. - -@item main_w, main_h -main input width and height - -@item W, H -same as @var{main_w} and @var{main_h} - -@item text_w, text_h -rendered text width and height +The expressions which specify the offsets where text will be drawn +within the video frame. They are relative to the top/left border of the +output image. -@item w, h -same as @var{text_w} and @var{text_h} - -@item n -the number of frames processed, starting from 0 +The default value of @var{x} and @var{y} is "0". -@item t -timestamp expressed in seconds, NAN if the input timestamp is unknown - -@end table - -The default value of @var{x} and @var{y} is 0. +See below for the list of accepted constants. @item fontsize The font size to be used for drawing text. @@ -600,28 +1199,126 @@ The size in number of spaces to use for rendering the tab. Default value is 4. @end table -For example the command: +The parameters for @var{x} and @var{y} are expressions containing the +following constants: + +@table @option +@item W, H +the input width and height + +@item tw, text_w +the width of the rendered text + +@item th, text_h +the height of the rendered text + +@item lh, line_h +the height of each text line + +@item sar +input sample aspect ratio + +@item dar +input display aspect ratio, it is the same as (@var{w} / @var{h}) * @var{sar} + +@item hsub, vsub +horizontal and vertical chroma subsample values. For example for the +pixel format "yuv422p" @var{hsub} is 2 and @var{vsub} is 1. + +@item max_glyph_w +maximum glyph width, that is the maximum width for all the glyphs +contained in the rendered text + +@item max_glyph_h +maximum glyph height, that is the maximum height for all the glyphs +contained in the rendered text, it is equivalent to @var{ascent} - +@var{descent}. + +@item max_glyph_a, ascent + +the maximum distance from the baseline to the highest/upper grid +coordinate used to place a glyph outline point, for all the rendered +glyphs. +It is a positive value, due to the grid's orientation with the Y axis +upwards. + +@item max_glyph_d, descent +the maximum distance from the baseline to the lowest grid coordinate +used to place a glyph outline point, for all the rendered glyphs. +This is a negative value, due to the grid's orientation, with the Y axis +upwards. + +@item n +the number of input frame, starting from 0 + +@item t +timestamp expressed in seconds, NAN if the input timestamp is unknown + +@item timecode +initial timecode representation in "hh:mm:ss[:;.]ff" format. It can be used +with or without text parameter. @var{rate} option must be specified. +Note that timecode options are @emph{not} effective if FFmpeg is build with +@code{--disable-avcodec}. + +@item r, rate +frame rate (timecode only) +@end table + +Some examples follow. + +@itemize + +@item +Draw "Test Text" with font FreeSerif, using the default values for the +optional parameters. + @example drawtext="fontfile=/usr/share/fonts/truetype/freefont/FreeSerif.ttf: text='Test Text'" @end example -will draw "Test Text" with font FreeSerif, using the default values -for the optional parameters. +@item +Draw 'Test Text' with font FreeSerif of size 24 at position x=100 +and y=50 (counting from the top-left corner of the screen), text is +yellow with a red box around it. Both the text and the box have an +opacity of 20%. -The command: @example drawtext="fontfile=/usr/share/fonts/truetype/freefont/FreeSerif.ttf: text='Test Text':\ x=100: y=50: fontsize=24: fontcolor=yellow@@0.2: box=1: boxcolor=red@@0.2" @end example -will draw 'Test Text' with font FreeSerif of size 24 at position x=100 -and y=50 (counting from the top-left corner of the screen), text is -yellow with a red box around it. Both the text and the box have an -opacity of 20%. - Note that the double quotes are not necessary if spaces are not used within the parameter list. +@item +Show the text at the center of the video frame: +@example +drawtext=fontsize=30:fontfile=FreeSerif.ttf:text='hello world':x=(w-text_w)/2:y=(h-text_h-line_h)/2" +@end example + +@item +Show a text line sliding from right to left in the last row of the video +frame. The file @file{LONG_LINE} is assumed to contain a single line +with no newlines. +@example +drawtext=fontsize=15:fontfile=FreeSerif.ttf:text=LONG_LINE:y=h-line_h:x=-50*t +@end example + +@item +Show the content of file @file{CREDITS} off the bottom of the frame and scroll up. +@example +drawtext=fontsize=20:fontfile=FreeSerif.ttf:textfile=CREDITS:y=h-20*t" +@end example + +@item +Draw a single green letter "g", at the center of the input video. +The glyph baseline is placed at half screen height. +@example +drawtext=fontsize=60:fontfile=FreeSerif.ttf:fontcolor=green:text=g:x=(w-max_glyph_w)/2:y=h/2-ascent +@end example + +@end itemize + For more information about libfreetype, check: @url{http://www.freetype.org/}. @@ -630,7 +1327,7 @@ For more information about libfreetype, check: Apply fade-in/out effect to input video. It accepts the parameters: -@var{type}:@var{start_frame}:@var{nb_frames} +@var{type}:@var{start_frame}:@var{nb_frames}[:@var{options}] @var{type} specifies if the effect type, can be either "in" for fade-in, or "out" for a fade-out effect. @@ -643,6 +1340,25 @@ effect has to last. At the end of the fade-in effect the output video will have the same intensity as the input video, at the end of the fade-out transition the output video will be completely black. +@var{options} is an optional sequence of @var{key}=@var{value} pairs, +separated by ":". The description of the accepted options follows. + +@table @option + +@item type, t +See @var{type}. + +@item start_frame, s +See @var{start_frame}. + +@item nb_frames, n +See @var{nb_frames}. + +@item alpha +If set to 1, fade only alpha channel, if one exists on the input. +Default value is 0. +@end table + A few usage examples follow, usable too as test scenarios. @example # fade in first 30 frames of video @@ -656,6 +1372,9 @@ fade=in:0:25, fade=out:975:25 # make first 5 frames black, then fade in from frame 5-24 fade=in:5:20 + +# fade in alpha over first 25 frames of video +fade=in:0:25:alpha=1 @end example @section fieldorder @@ -688,7 +1407,7 @@ which is bottom field first. For example: @example -./avconv -i in.vob -vf "fieldorder=bff" out.dv +ffmpeg -i in.vob -vf "fieldorder=bff" out.dv @end example @section fifo @@ -724,7 +1443,7 @@ format=yuv420p:yuv444p:yuv410p Apply a frei0r effect to the input video. To enable compilation of this filter you need to install the frei0r -header and configure Libav with --enable-frei0r. +header and configure FFmpeg with @code{--enable-frei0r}. The filter supports the syntax: @example @@ -772,7 +1491,7 @@ For more information see: @section gradfun Fix the banding artifacts that are sometimes introduced into nearly flat -regions by truncation to 8bit colordepth. +regions by truncation to 8bit color depth. Interpolate the gradients that should go where the bands are, and dither them. @@ -806,9 +1525,9 @@ gradfun=1.2 Flip the input video horizontally. -For example to horizontally flip the input video with @command{avconv}: +For example to horizontally flip the input video with @command{ffmpeg}: @example -avconv -i in.avi -vf "hflip" out.avi +ffmpeg -i in.avi -vf "hflip" out.avi @end example @section hqdn3d @@ -853,10 +1572,14 @@ corresponding pixel component values. The @var{lut} filter requires either YUV or RGB pixel formats in input, and accepts the options: @table @option -@var{c0} (first pixel component) -@var{c1} (second pixel component) -@var{c2} (third pixel component) -@var{c3} (fourth pixel component, corresponds to the alpha component) +@item c0 +first pixel component +@item c1 +second pixel component +@item c2 +third pixel component +@item c3 +fourth pixel component, corresponds to the alpha component @end table The exact component associated to each option depends on the format in @@ -865,28 +1588,32 @@ input. The @var{lutrgb} filter requires RGB pixel formats in input, and accepts the options: @table @option -@var{r} (red component) -@var{g} (green component) -@var{b} (blue component) -@var{a} (alpha component) +@item r +red component +@item g +green component +@item b +blue component +@item a +alpha component @end table The @var{lutyuv} filter requires YUV pixel formats in input, and accepts the options: @table @option -@var{y} (Y/luminance component) -@var{u} (U/Cb component) -@var{v} (V/Cr component) -@var{a} (alpha component) +@item y +Y/luminance component +@item u +U/Cb component +@item v +V/Cr component +@item a +alpha component @end table The expressions can contain the following constants and functions: @table @option -@item E, PI, PHI -the corresponding mathematical approximated values for e -(euler number), pi (greek PI), PHI (golden ratio) - @item w, h the input width and height @@ -932,7 +1659,7 @@ lutrgb="r=negval:g=negval:b=negval" lutyuv="y=negval:u=negval:v=negval" # negate luminance -lutyuv=negval +lutyuv=y=negval # remove chroma components, turns the video into a graytone image lutyuv="u=128:v=128" @@ -950,6 +1677,97 @@ format=rgba,lutrgb=a="maxval-minval/2" lutyuv=y=gammaval(0.5) @end example +@section mp + +Apply an MPlayer filter to the input video. + +This filter provides a wrapper around most of the filters of +MPlayer/MEncoder. + +This wrapper is considered experimental. Some of the wrapped filters +may not work properly and we may drop support for them, as they will +be implemented natively into FFmpeg. Thus you should avoid +depending on them when writing portable scripts. + +The filters accepts the parameters: +@var{filter_name}[:=]@var{filter_params} + +@var{filter_name} is the name of a supported MPlayer filter, +@var{filter_params} is a string containing the parameters accepted by +the named filter. + +The list of the currently supported filters follows: +@table @var +@item 2xsai +@item decimate +@item denoise3d +@item detc +@item dint +@item divtc +@item down3dright +@item dsize +@item eq2 +@item eq +@item field +@item fil +@item fixpts +@item framestep +@item fspp +@item geq +@item harddup +@item hqdn3d +@item hue +@item il +@item ilpack +@item ivtc +@item kerndeint +@item mcdeint +@item mirror +@item noise +@item ow +@item palette +@item perspective +@item phase +@item pp7 +@item pullup +@item qp +@item rectangle +@item remove-logo +@item rotate +@item sab +@item screenshot +@item smartblur +@item softpulldown +@item softskip +@item spp +@item swapuv +@item telecine +@item tile +@item tinterlace +@item unsharp +@item uspp +@item yuvcsp +@item yvu9 +@end table + +The parameter syntax and behavior for the listed filters are the same +of the corresponding MPlayer filters. For detailed instructions check +the "VIDEO FILTERS" section in the MPlayer manual. + +Some examples follow: +@example +# remove a logo by interpolating the surrounding pixels +mp=delogo=200:200:80:20:1 + +# adjust gamma, brightness, contrast +mp=eq2=1.0:2:0.5 + +# tweak hue and saturation +mp=hue=100:-10 +@end example + +See also mplayer(1), @url{http://www.mplayerhq.hu/}. + @section negate Negate input video. @@ -957,6 +1775,8 @@ Negate input video. This filter accepts an integer in input, if non-zero it negates the alpha component (if available). The default value in input is 0. +@section noformat + Force libavfilter not to use any of the specified pixel formats for the input to the next filter. @@ -982,7 +1802,7 @@ Pass the video source unchanged to the output. Apply video transform using libopencv. To enable this filter install libopencv library and headers and -configure Libav with --enable-libopencv. +configure FFmpeg with @code{--enable-libopencv}. The filter takes the parameters: @var{filter_name}@{:=@}@var{filter_params}. @@ -1082,10 +1902,10 @@ Overlay one video on top of another. It takes two inputs and one output, the first input is the "main" video on which the second input is overlayed. -It accepts the parameters: @var{x}:@var{y}. +It accepts the parameters: @var{x}:@var{y}[:@var{options}]. @var{x} is the x coordinate of the overlayed video on the main video, -@var{y} is the y coordinate. The parameters are expressions containing +@var{y} is the y coordinate. @var{x} and @var{y} are expressions containing the following parameters: @table @option @@ -1102,6 +1922,17 @@ overlay input width and height same as @var{overlay_w} and @var{overlay_h} @end table +@var{options} is an optional list of @var{key}=@var{value} pairs, +separated by ":". + +The description of the accepted options follows. + +@table @option +@item rgb +If set to 1, force the filter to accept inputs in the RGB +color space. Default value is 0. +@end table + Be aware that frames are taken from each input video in timestamp order, hence, if their initial timestamps differ, it is a a good idea to pass the two inputs through a @var{setpts=PTS-STARTPTS} filter to @@ -1145,10 +1976,6 @@ The parameters @var{width}, @var{height}, @var{x}, and @var{y} are expressions containing the following constants: @table @option -@item E, PI, PHI -the corresponding mathematical approximated values for e -(euler number), pi (greek PI), phi (golden ratio) - @item in_w, in_h the input video width and height @@ -1167,7 +1994,13 @@ x and y offsets as specified by the @var{x} and @var{y} expressions, or NAN if not yet specified @item a -input display aspect ratio, same as @var{iw} / @var{ih} +same as @var{iw} / @var{ih} + +@item sar +input sample aspect ratio + +@item dar +input display aspect ratio, it is the same as (@var{iw} / @var{ih}) * @var{sar} @item hsub, vsub horizontal and vertical chroma subsample values. For example for the @@ -1227,6 +2060,12 @@ pad="max(iw\,ih):ow:(ow-iw)/2:(oh-ih)/2" # pad the input to get a final w/h ratio of 16:9 pad="ih*16/9:ih:(ow-iw)/2:(oh-ih)/2" +# for anamorphic video, in order to set the output display aspect ratio, +# it is necessary to use sar in the expression, according to the relation: +# (ih * X / ih) * sar = output_dar +# X = output_dar / sar +pad="ih*16/9/sar:ih:(ow-iw)/2:(oh-ih)/2" + # double output size and put the input video in the bottom-right # corner of the output padded area pad="2*iw:2*ih:ow-iw:oh-ih" @@ -1246,16 +2085,12 @@ can be used to test the monowhite pixel format descriptor definition. @section scale -Scale the input video to @var{width}:@var{height} and/or convert the image format. +Scale the input video to @var{width}:@var{height}[:@var{interl}=@{1|-1@}] and/or convert the image format. The parameters @var{width} and @var{height} are expressions containing the following constants: @table @option -@item E, PI, PHI -the corresponding mathematical approximated values for e -(euler number), pi (greek PI), phi (golden ratio) - @item in_w, in_h the input width and height @@ -1268,8 +2103,14 @@ the output (cropped) width and height @item ow, oh same as @var{out_w} and @var{out_h} -@item dar, a -input display aspect ratio, same as @var{iw} / @var{ih} +@item a +same as @var{iw} / @var{ih} + +@item sar +input sample aspect ratio + +@item dar +input display aspect ratio, it is the same as (@var{iw} / @var{ih}) * @var{sar} @item sar input sample aspect ratio @@ -1292,6 +2133,17 @@ ratio of the input image. The default value of @var{width} and @var{height} is 0. +Valid values for the optional parameter @var{interl} are: + +@table @option +@item 1 +force interlaced aware scaling + +@item -1 +select interlaced aware scaling depending on whether the source frames +are flagged as interlaced or not +@end table + Some examples follow: @example # scale the input video to a size of 200x100. @@ -1332,15 +2184,6 @@ is selected and passed to the output, otherwise it is discarded. The expression can contain the following constants: @table @option -@item PI -Greek PI - -@item PHI -golden ratio - -@item E -Euler number - @item n the sequential number of the filtered frame, starting from 0 @@ -1479,15 +2322,6 @@ can contain the following constants: @item PTS the presentation timestamp in input -@item PI -Greek PI - -@item PHI -golden ratio - -@item E -Euler number - @item N the count of the input frame, starting from 0. @@ -1560,7 +2394,7 @@ Set the timebase to use for the output frames timestamps. It is mainly useful for testing timebase configuration. It accepts in input an arithmetic expression representing a rational. -The expression can contain the constants "PI", "E", "PHI", "AVTB" (the +The expression can contain the constants "AVTB" (the default timebase), and "intb" (the input timebase). The default value for the input is "intb". @@ -1636,11 +2470,11 @@ the @code{av_get_picture_type_char} function defined in @file{libavutil/avutil.h}. @item checksum -Adler-32 checksum of all the planes of the input frame +Adler-32 checksum (printed in hexadecimal) of all the planes of the input frame @item plane_checksum -Adler-32 checksum of each plane of the input frame, expressed in the form -"[@var{c0} @var{c1} @var{c2} @var{c3}]" +Adler-32 checksum (printed in hexadecimal) of each plane of the input frame, +expressed in the form "[@var{c0} @var{c1} @var{c2} @var{c3}]" @end table @section slicify @@ -1649,7 +2483,7 @@ Pass the images of input video on to next video filter as multiple slices. @example -./avconv -i in.avi -vf "slicify=32" out.avi +ffmpeg -i in.avi -vf "slicify=32" out.avi @end example The filter accepts the slice height as parameter. If the parameter is @@ -1658,6 +2492,79 @@ not specified it will use the default value of 16. Adding this in the beginning of filter chains should make filtering faster due to better use of the memory cache. +@section split + +Pass on the input video to two outputs. Both outputs are identical to +the input video. + +For example: +@example +[in] split [splitout1][splitout2]; +[splitout1] crop=100:100:0:0 [cropout]; +[splitout2] pad=200:200:100:100 [padout]; +@end example + +will create two separate outputs from the same input, one cropped and +one padded. + +@section thumbnail +Select the most representative frame in a given sequence of consecutive frames. + +It accepts as argument the frames batch size to analyze (default @var{N}=100); +in a set of @var{N} frames, the filter will pick one of them, and then handle +the next batch of @var{N} frames until the end. + +Since the filter keeps track of the whole frames sequence, a bigger @var{N} +value will result in a higher memory usage, so a high value is not recommended. + +The following example extract one picture each 50 frames: +@example +thumbnail=50 +@end example + +Complete example of a thumbnail creation with @command{ffmpeg}: +@example +ffmpeg -i in.avi -vf thumbnail,scale=300:200 -frames:v 1 out.png +@end example + +@section tinterlace + +Perform various types of temporal field interlacing. + +Frames are counted starting from 1, so the first input frame is +considered odd. + +This filter accepts a single parameter specifying the mode. Available +modes are: + +@table @samp +@item 0 +Move odd frames into the upper field, even into the lower field, +generating a double height frame at half framerate. + +@item 1 +Only output even frames, odd frames are dropped, generating a frame with +unchanged height at half framerate. + +@item 2 +Only output odd frames, even frames are dropped, generating a frame with +unchanged height at half framerate. + +@item 3 +Expand each frame to full height, but pad alternate lines with black, +generating a frame with double height at the same input framerate. + +@item 4 +Interleave the upper field from odd frames with the lower field from +even frames, generating a frame with unchanged height at half framerate. + +@item 5 +Interleave the lower field from odd frames with the upper field from +even frames, generating a frame with unchanged height at half framerate. +@end table + +Default mode is 0. + @section transpose Transpose rows with columns in the input video and optionally flip it. @@ -1732,7 +2639,7 @@ and 13, default value is 5. Set the chroma matrix vertical size. It can be an integer between 3 and 13, default value is 5. -@item luma_amount +@item chroma_amount Set the chroma effect strength. It can be a float number between -2.0 and 5.0, default value is 0.0. @@ -1745,8 +2652,8 @@ unsharp=7:7:2.5 # Strong blur of both luma and chroma parameters unsharp=7:7:-2:7:7:-2 -# Use the default values with @command{avconv} -./avconv -i in.avi -vf "unsharp" out.mp4 +# Use the default values with @command{ffmpeg} +ffmpeg -i in.avi -vf "unsharp" out.mp4 @end example @section vflip @@ -1754,7 +2661,7 @@ unsharp=7:7:-2:7:7:-2 Flip the input video vertically. @example -./avconv -i in.avi -vf "vflip" out.avi +ffmpeg -i in.avi -vf "vflip" out.avi @end example @section yadif @@ -1823,9 +2730,10 @@ This source is mainly intended for a programmatic use, in particular through the interface defined in @file{libavfilter/vsrc_buffer.h}. It accepts the following parameters: -@var{width}:@var{height}:@var{pix_fmt_string}:@var{timebase_num}:@var{timebase_den}:@var{sample_aspect_ratio_num}:@var{sample_aspect_ratio.den} +@var{width}:@var{height}:@var{pix_fmt_string}:@var{timebase_num}:@var{timebase_den}:@var{sample_aspect_ratio_num}:@var{sample_aspect_ratio.den}:@var{scale_params} -All the parameters need to be explicitly defined. +All the parameters but @var{scale_params} need to be explicitly +defined. Follows the list of the accepted parameters. @@ -1846,6 +2754,11 @@ timestamps of the buffered frames. @item sample_aspect_ratio.num, sample_aspect_ratio.den Specify numerator and denominator of the sample aspect ratio assumed by the video frames. + +@item scale_params +Specify the optional parameters to be used for the scale filter which +is automatically inserted when an input change is detected in the +input size or format. @end table For example: @@ -1860,9 +2773,124 @@ Since the pixel format with name "yuv410p" corresponds to the number 6 (check the enum PixelFormat definition in @file{libavutil/pixfmt.h}), this example corresponds to: @example -buffer=320:240:6:1:24 +buffer=320:240:6:1:24:1:1 @end example +@section cellauto + +Create a pattern generated by an elementary cellular automaton. + +The initial state of the cellular automaton can be defined through the +@option{filename}, and @option{pattern} options. If such options are +not specified an initial state is created randomly. + +At each new frame a new row in the video is filled with the result of +the cellular automaton next generation. The behavior when the whole +frame is filled is defined by the @option{scroll} option. + +This source accepts a list of options in the form of +@var{key}=@var{value} pairs separated by ":". A description of the +accepted options follows. + +@table @option +@item filename, f +Read the initial cellular automaton state, i.e. the starting row, from +the specified file. +In the file, each non-whitespace character is considered an alive +cell, a newline will terminate the row, and further characters in the +file will be ignored. + +@item pattern, p +Read the initial cellular automaton state, i.e. the starting row, from +the specified string. + +Each non-whitespace character in the string is considered an alive +cell, a newline will terminate the row, and further characters in the +string will be ignored. + +@item rate, r +Set the video rate, that is the number of frames generated per second. +Default is 25. + +@item random_fill_ratio, ratio +Set the random fill ratio for the initial cellular automaton row. It +is a floating point number value ranging from 0 to 1, defaults to +1/PHI. + +This option is ignored when a file or a pattern is specified. + +@item random_seed, seed +Set the seed for filling randomly the initial row, must be an integer +included between 0 and UINT32_MAX. If not specified, or if explicitly +set to -1, the filter will try to use a good random seed on a best +effort basis. + +@item rule +Set the cellular automaton rule, it is a number ranging from 0 to 255. +Default value is 110. + +@item size, s +Set the size of the output video. + +If @option{filename} or @option{pattern} is specified, the size is set +by default to the width of the specified initial state row, and the +height is set to @var{width} * PHI. + +If @option{size} is set, it must contain the width of the specified +pattern string, and the specified pattern will be centered in the +larger row. + +If a filename or a pattern string is not specified, the size value +defaults to "320x518" (used for a randomly generated initial state). + +@item scroll +If set to 1, scroll the output upward when all the rows in the output +have been already filled. If set to 0, the new generated row will be +written over the top row just after the bottom row is filled. +Defaults to 1. + +@item start_full, full +If set to 1, completely fill the output with generated rows before +outputting the first frame. +This is the default behavior, for disabling set the value to 0. + +@item stitch +If set to 1, stitch the left and right row edges together. +This is the default behavior, for disabling set the value to 0. +@end table + +@subsection Examples + +@itemize +@item +Read the initial state from @file{pattern}, and specify an output of +size 200x400. +@example +cellauto=f=pattern:s=200x400 +@end example + +@item +Generate a random initial row with a width of 200 cells, with a fill +ratio of 2/3: +@example +cellauto=ratio=2/3:s=200x200 +@end example + +@item +Create a pattern generated by rule 18 starting by a single alive cell +centered on an initial row with width 100: +@example +cellauto=p=@@:s=100x400:full=0:rule=18 +@end example + +@item +Specify a more elaborated initial pattern: +@example +cellauto=p='@@@@ @@ @@@@':s=100x400:full=0:rule=18 +@end example + +@end itemize + @section color Provide an uniformly colored input. @@ -1957,28 +2985,69 @@ movie=/dev/video0:f=video4linux2, scale=180:-1, setpts=PTS-STARTPTS [movie]; @end example -@section nullsrc +@section mptestsrc -Null video source, never return images. It is mainly useful as a -template and to be employed in analysis / debugging tools. +Generate various test patterns, as generated by the MPlayer test filter. -It accepts as optional parameter a string of the form -@var{width}:@var{height}:@var{timebase}. +The size of the generated video is fixed, and is 256x256. +This source is useful in particular for testing encoding features. -@var{width} and @var{height} specify the size of the configured -source. The default values of @var{width} and @var{height} are -respectively 352 and 288 (corresponding to the CIF size format). +This source accepts an optional sequence of @var{key}=@var{value} pairs, +separated by ":". The description of the accepted options follows. -@var{timebase} specifies an arithmetic expression representing a -timebase. The expression can contain the constants "PI", "E", "PHI", -"AVTB" (the default timebase), and defaults to the value "AVTB". +@table @option + +@item rate, r +Specify the frame rate of the sourced video, as the number of frames +generated per second. It has to be a string in the format +@var{frame_rate_num}/@var{frame_rate_den}, an integer number, a float +number or a valid video frame rate abbreviation. The default value is +"25". + +@item duration, d +Set the video duration of the sourced video. The accepted syntax is: +@example +[-]HH[:MM[:SS[.m...]]] +[-]S+[.m...] +@end example +See also the function @code{av_parse_time()}. + +If not specified, or the expressed duration is negative, the video is +supposed to be generated forever. + +@item test, t + +Set the number or the name of the test to perform. Supported tests are: +@table @option +@item dc_luma +@item dc_chroma +@item freq_luma +@item freq_chroma +@item amp_luma +@item amp_chroma +@item cbp +@item mv +@item ring1 +@item ring2 +@item all +@end table + +Default value is "all", which will cycle through the list of all tests. +@end table + +For example the following: +@example +testsrc=t=dc_luma +@end example + +will generate a "dc_luma" test pattern. @section frei0r_src Provide a frei0r source. To enable compilation of this filter you need to install the frei0r -header and configure Libav with --enable-frei0r. +header and configure FFmpeg with @code{--enable-frei0r}. The source supports the syntax: @example @@ -1995,12 +3064,143 @@ section @ref{frei0r} in the description of the video filters. Some examples follow: @example -# generate a frei0r partik0l source with size 200x200 and framerate 10 +# generate a frei0r partik0l source with size 200x200 and frame rate 10 # which is overlayed on the overlay filter main input frei0r_src=200x200:10:partik0l=1234 [overlay]; [in][overlay] overlay @end example -@section rgbtestsrc, testsrc +@section life + +Generate a life pattern. + +This source is based on a generalization of John Conway's life game. + +The sourced input represents a life grid, each pixel represents a cell +which can be in one of two possible states, alive or dead. Every cell +interacts with its eight neighbours, which are the cells that are +horizontally, vertically, or diagonally adjacent. + +At each interaction the grid evolves according to the adopted rule, +which specifies the number of neighbor alive cells which will make a +cell stay alive or born. The @option{rule} option allows to specify +the rule to adopt. + +This source accepts a list of options in the form of +@var{key}=@var{value} pairs separated by ":". A description of the +accepted options follows. + +@table @option +@item filename, f +Set the file from which to read the initial grid state. In the file, +each non-whitespace character is considered an alive cell, and newline +is used to delimit the end of each row. + +If this option is not specified, the initial grid is generated +randomly. + +@item rate, r +Set the video rate, that is the number of frames generated per second. +Default is 25. + +@item random_fill_ratio, ratio +Set the random fill ratio for the initial random grid. It is a +floating point number value ranging from 0 to 1, defaults to 1/PHI. +It is ignored when a file is specified. + +@item random_seed, seed +Set the seed for filling the initial random grid, must be an integer +included between 0 and UINT32_MAX. If not specified, or if explicitly +set to -1, the filter will try to use a good random seed on a best +effort basis. + +@item rule +Set the life rule. + +A rule can be specified with a code of the kind "S@var{NS}/B@var{NB}", +where @var{NS} and @var{NB} are sequences of numbers in the range 0-8, +@var{NS} specifies the number of alive neighbor cells which make a +live cell stay alive, and @var{NB} the number of alive neighbor cells +which make a dead cell to become alive (i.e. to "born"). +"s" and "b" can be used in place of "S" and "B", respectively. + +Alternatively a rule can be specified by an 18-bits integer. The 9 +high order bits are used to encode the next cell state if it is alive +for each number of neighbor alive cells, the low order bits specify +the rule for "borning" new cells. Higher order bits encode for an +higher number of neighbor cells. +For example the number 6153 = @code{(12<<9)+9} specifies a stay alive +rule of 12 and a born rule of 9, which corresponds to "S23/B03". + +Default value is "S23/B3", which is the original Conway's game of life +rule, and will keep a cell alive if it has 2 or 3 neighbor alive +cells, and will born a new cell if there are three alive cells around +a dead cell. + +@item size, s +Set the size of the output video. + +If @option{filename} is specified, the size is set by default to the +same size of the input file. If @option{size} is set, it must contain +the size specified in the input file, and the initial grid defined in +that file is centered in the larger resulting area. + +If a filename is not specified, the size value defaults to "320x240" +(used for a randomly generated initial grid). + +@item stitch +If set to 1, stitch the left and right grid edges together, and the +top and bottom edges also. Defaults to 1. + +@item mold +Set cell mold speed. If set, a dead cell will go from @option{death_color} to +@option{mold_color} with a step of @option{mold}. @option{mold} can have a +value from 0 to 255. + +@item life_color +Set the color of living (or new born) cells. + +@item death_color +Set the color of dead cells. If @option{mold} is set, this is the first color +used to represent a dead cell. + +@item mold_color +Set mold color, for definitely dead and moldy cells. +@end table + +@subsection Examples + +@itemize +@item +Read a grid from @file{pattern}, and center it on a grid of size +300x300 pixels: +@example +life=f=pattern:s=300x300 +@end example + +@item +Generate a random grid of size 200x200, with a fill ratio of 2/3: +@example +life=ratio=2/3:s=200x200 +@end example + +@item +Specify a custom rule for evolving a randomly generated grid: +@example +life=rule=S14/B34 +@end example + +@item +Full example with slow death effect (mold) using @command{ffplay}: +@example +ffplay -f lavfi life=s=300x200:mold=10:r=60:ratio=0.1:death_color=#C83232:life_color=#00ff00,scale=1200:800:flags=16 +@end example +@end itemize + +@section nullsrc, rgbtestsrc, testsrc + +The @code{nullsrc} source returns unprocessed video frames. It is +mainly useful to be employed in analysis / debugging tools, or as the +source for filters which ignore the input data. The @code{rgbtestsrc} source generates an RGB test pattern useful for detecting RGB vs BGR issues. You should see a red, green and blue @@ -2010,7 +3210,7 @@ The @code{testsrc} source generates a test video pattern, showing a color pattern, a scrolling gradient and a timestamp. This is mainly intended for testing purposes. -Both sources accept an optional sequence of @var{key}=@var{value} pairs, +These sources accept an optional sequence of @var{key}=@var{value} pairs, separated by ":". The description of the accepted options follows. @table @option @@ -2048,7 +3248,14 @@ testsrc=duration=5.3:size=qcif:rate=10 @end example will generate a video with a duration of 5.3 seconds, with size -176x144 and a framerate of 10 frames per second. +176x144 and a frame rate of 10 frames per second. + +If the input content is to be ignored, @code{nullsrc} can be used. The +following command generates noise in the luminance plane by employing +the @code{mp=geq} filter: +@example +nullsrc=s=256x256, mp=geq=random(1)*255:128:128 +@end example @c man end VIDEO SOURCES @@ -2057,6 +3264,19 @@ will generate a video with a duration of 5.3 seconds, with size Below is a description of the currently available video sinks. +@section buffersink + +Buffer video frames, and make them available to the end of the filter +graph. + +This sink is mainly intended for a programmatic use, in particular +through the interface defined in @file{libavfilter/buffersink.h}. + +It does not require a string parameter in input, but you need to +specify a pointer to a list of supported pixel formats terminated by +-1 in the opaque parameter provided to @code{avfilter_init_filter} +when initializing this sink. + @section nullsink Null video sink, do absolutely nothing with the input video. It is diff --git a/doc/general.texi b/doc/general.texi index 65d65bb26b..2f18e4c126 100644 --- a/doc/general.texi +++ b/doc/general.texi @@ -11,10 +11,18 @@ @chapter External libraries -Libav can be hooked up with a number of external libraries to add support +FFmpeg can be hooked up with a number of external libraries to add support for more formats. None of them are used by default, their use has to be explicitly requested by passing the appropriate flags to @file{./configure}. +@section OpenJPEG + +FFmpeg can use the OpenJPEG libraries for encoding/decoding J2K videos. Go to +@url{http://www.openjpeg.org/} to get the libraries and follow the installation +instructions. To enable using OpenJPEG in FFmpeg, pass @code{--enable-libopenjpeg} to +@file{./configure}. + + @section OpenCORE and VisualOn libraries Spun off Google Android sources, OpenCore and VisualOn libraries provide @@ -24,13 +32,13 @@ encoders for a number of audio codecs. OpenCORE and VisualOn libraries are under the Apache License 2.0 (see @url{http://www.apache.org/licenses/LICENSE-2.0} for details), which is incompatible with the LGPL version 2.1 and GPL version 2. You have to -upgrade Libav's license to LGPL version 3 (or if you have enabled +upgrade FFmpeg's license to LGPL version 3 (or if you have enabled GPL components, GPL version 3) to use it. @end float @subsection OpenCORE AMR -Libav can make use of the OpenCORE libraries for AMR-NB +FFmpeg can make use of the OpenCORE libraries for AMR-NB decoding/encoding and AMR-WB decoding. Go to @url{http://sourceforge.net/projects/opencore-amr/} and follow the @@ -40,7 +48,7 @@ Then pass @code{--enable-libopencore-amrnb} and/or @subsection VisualOn AAC encoder library -Libav can make use of the VisualOn AACenc library for AAC encoding. +FFmpeg can make use of the VisualOn AACenc library for AAC encoding. Go to @url{http://sourceforge.net/projects/opencore-amr/} and follow the instructions for installing the library. @@ -48,7 +56,7 @@ Then pass @code{--enable-libvo-aacenc} to configure to enable it. @subsection VisualOn AMR-WB encoder library -Libav can make use of the VisualOn AMR-WBenc library for AMR-WB encoding. +FFmpeg can make use of the VisualOn AMR-WBenc library for AMR-WB encoding. Go to @url{http://sourceforge.net/projects/opencore-amr/} and follow the instructions for installing the library. @@ -56,7 +64,7 @@ Then pass @code{--enable-libvo-amrwbenc} to configure to enable it. @section LAME -Libav can make use of the LAME library for MP3 encoding. +FFmpeg can make use of the LAME library for MP3 encoding. Go to @url{http://lame.sourceforge.net/} and follow the instructions for installing the library. @@ -64,7 +72,7 @@ Then pass @code{--enable-libmp3lame} to configure to enable it. @section libvpx -Libav can make use of the libvpx library for VP8 encoding. +FFmpeg can make use of the libvpx library for VP8 encoding. Go to @url{http://www.webmproject.org/} and follow the instructions for installing the library. Then pass @code{--enable-libvpx} to configure to @@ -72,7 +80,7 @@ enable it. @section x264 -Libav can make use of the x264 library for H.264 encoding. +FFmpeg can make use of the x264 library for H.264 encoding. Go to @url{http://www.videolan.org/developers/x264.html} and follow the instructions for installing the library. Then pass @code{--enable-libx264} to @@ -81,7 +89,7 @@ configure to enable it. @float NOTE x264 is under the GNU Public License Version 2 or later (see @url{http://www.gnu.org/licenses/old-licenses/gpl-2.0.html} for -details), you must upgrade Libav's license to GPL in order to use it. +details), you must upgrade FFmpeg's license to GPL in order to use it. @end float @@ -92,7 +100,7 @@ You can use the @code{-formats} and @code{-codecs} options to have an exhaustive @section File Formats -Libav supports the following file formats through the @code{libavformat} +FFmpeg supports the following file formats through the @code{libavformat} library: @multitable @columnfractions .4 .1 .1 .4 @@ -100,12 +108,15 @@ library: @item 4xm @tab @tab X @tab 4X Technologies format, used in some games. @item 8088flex TMV @tab @tab X +@item ACT Voice @tab @tab X + @tab contains G.729 audio @item Adobe Filmstrip @tab X @tab X @item Audio IFF (AIFF) @tab X @tab X @item American Laser Games MM @tab @tab X @tab Multimedia format used in games like Mad Dog McCree. @item 3GPP AMR @tab X @tab X @item Apple HTTP Live Streaming @tab @tab X +@item Artworx Data Format @tab @tab X @item ASF @tab X @tab X @item AVI @tab X @tab X @item AVISynth @tab @tab X @@ -115,6 +126,7 @@ library: @tab Audio and video format used in some games by Beam Software. @item Bethesda Softworks VID @tab @tab X @tab Used in some games from Bethesda Softworks. +@item Binary text @tab @tab X @item Bink @tab @tab X @tab Multimedia format used by many games. @item Bitmap Brothers JV @tab @tab X @@ -131,7 +143,7 @@ library: @tab Multimedia format used by Delphine Software games. @item CD+G @tab @tab X @tab Video format used by CD+G karaoke disks -@item Core Audio Format @tab @tab X +@item Core Audio Format @tab X @tab X @tab Apple Core Audio Format @item CRC testing format @tab X @tab @item Creative Voice @tab X @tab X @@ -149,7 +161,7 @@ library: @item Electronic Arts cdata @tab @tab X @item Electronic Arts Multimedia @tab @tab X @tab Used in various EA games; files have extensions like WVE and UV2. -@item FFM (AVserver live feed) @tab X @tab X +@item FFM (FFserver live feed) @tab X @tab X @item Flash (SWF) @tab X @tab X @item Flash 9 (AVM2) @tab X @tab X @tab Only embedded audio is decoded. @@ -160,13 +172,19 @@ library: @item framecrc testing format @tab X @tab @item FunCom ISS @tab @tab X @tab Audio format used in various games from FunCom like The Longest Journey. +@item G.723.1 @tab X @tab X +@item G.729 BIT @tab X @tab X +@item G.729 raw @tab @tab X @item GIF Animation @tab X @tab @item GXF @tab X @tab X @tab General eXchange Format SMPTE 360M, used by Thomson Grass Valley playout servers. +@item iCEDraw File @tab @tab X +@item ICO @tab @tab X + @tab Microsoft Windows ICO @item id Quake II CIN video @tab @tab X @item id RoQ @tab X @tab X - @tab Used in Quake III, Jedi Knight 2, other computer games. + @tab Used in Quake III, Jedi Knight 2 and other computer games. @item IEC61937 encapsulation @tab X @tab X @item IFF @tab @tab X @tab Interchange File Format @@ -179,6 +197,8 @@ library: @item LATM @tab X @tab X @item LMLM4 @tab @tab X @tab Used by Linux Media Labs MPEG-4 PCI boards +@item LOAS @tab @tab X + @tab contains LATM multiplexed AAC audio @item LXF @tab @tab X @tab VR native stream format, used by Leitch/Harris' video servers. @item Matroska @tab X @tab X @@ -287,6 +307,7 @@ library: @item RTP @tab X @tab X @item RTSP @tab X @tab X @item SAP @tab X @tab X +@item SBG @tab @tab X @item SDP @tab @tab X @item Sega FILM/CPK @tab @tab X @tab Used in many Sega Saturn console games. @@ -314,7 +335,7 @@ library: @item WAV @tab X @tab X @item WavPack @tab @tab X @item WebM @tab X @tab X -@item Windows Televison (WTV) @tab @tab X +@item Windows Televison (WTV) @tab X @tab X @item Wing Commander III movie @tab @tab X @tab Multimedia format used in Origin's Wing Commander III computer game. @item Westwood Studios audio @tab @tab X @@ -325,6 +346,7 @@ library: @tab Microsoft video container used in Xbox games. @item xWMA @tab @tab X @tab Microsoft audio container used by XAudio 2. +@item eXtended BINary text (XBIN) @tab @tab X @item YUV4MPEG pipe @tab X @tab X @item Psygnosis YOP @tab @tab X @end multitable @@ -333,7 +355,7 @@ library: @section Image Formats -Libav can read and write images for each frame of a video sequence. The +FFmpeg can read and write images for each frame of a video sequence. The following image formats are supported: @multitable @columnfractions .4 .1 .1 .4 @@ -348,8 +370,7 @@ following image formats are supported: @tab Digital Picture Exchange @item JPEG @tab X @tab X @tab Progressive JPEG is not supported. -@item JPEG 2000 @tab @tab E - @tab decoding supported through external library libopenjpeg +@item JPEG 2000 @tab X @tab X @item JPEG-LS @tab X @tab X @item LJPEG @tab X @tab @tab Lossless JPEG @@ -366,7 +387,6 @@ following image formats are supported: @item PIC @tab @tab X @tab Pictor/PC Paint @item PNG @tab X @tab X - @tab 2/4 bpp not supported yet @item PPM @tab X @tab X @tab Portable PixelMap image @item PTX @tab @tab X @@ -398,11 +418,11 @@ following image formats are supported: @tab Creates video suitable to be played on a commodore 64 (multicolor mode). @item American Laser Games MM @tab @tab X @tab Used in games like Mad Dog McCree. -@item AMV Video @tab @tab X +@item AMV Video @tab X @tab X @tab Used in Chinese MP3 players. @item ANSI/ASCII art @tab @tab X @item Apple MJPEG-B @tab @tab X -@item Apple ProRes @tab @tab X +@item Apple ProRes @tab X @tab X @item Apple QuickDraw @tab @tab X @tab fourcc: qdrw @item Asus v1 @tab X @tab X @@ -418,6 +438,8 @@ following image formats are supported: @item Autodesk Animator Flic video @tab @tab X @item Autodesk RLE @tab @tab X @tab fourcc: AASC +@item Avid 1:1 10-bit RGB Packer @tab @tab X + @tab fourcc: AVrp @item AVS (Audio Video Standard) video @tab @tab X @tab Video encoding used by the Creature Shock game. @item Beam Software VB @tab @tab X @@ -425,6 +447,7 @@ following image formats are supported: @tab Used in some games from Bethesda Softworks. @item Bink Video @tab @tab X @item Bitmap Brothers JV video @tab @tab X +@item y41p Brooktree uncompressed 4:1:1 12-bit @tab X @tab X @item Brute Force & Ignorance @tab @tab X @tab Used in the game Flash Traffic: City of Angels. @item C93 video @tab @tab X @@ -444,7 +467,7 @@ following image formats are supported: @item Creative YUV (CYUV) @tab @tab X @item DFA @tab @tab X @tab Codec used in Chronomaster game. -@item Dirac @tab E @tab E +@item Dirac @tab E @tab X @tab supported through external libdirac/libschroedinger libraries @item Deluxe Paint Animation @tab @tab X @item DNxHD @tab X @tab X @@ -464,11 +487,12 @@ following image formats are supported: @item Electronic Arts TGQ video @tab @tab X @item Electronic Arts TQI video @tab @tab X @item Escape 124 @tab @tab X +@item Escape 130 @tab @tab X @item FFmpeg video codec #1 @tab X @tab X @tab experimental lossless codec (fourcc: FFV1) @item Flash Screen Video v1 @tab X @tab X @tab fourcc: FSV1 -@item Flash Screen Video v2 @tab @tab X +@item Flash Screen Video v2 @tab X @tab X @item Flash Video (FLV) @tab X @tab X @tab Sorenson H.263 used in Flash @item Fraps @tab @tab X @@ -499,6 +523,7 @@ following image formats are supported: @tab Used in the game Cyberia from Interplay. @item Interplay MVE video @tab @tab X @tab Used in Interplay .MVE files. +@item J2K @tab X @tab X @item Karl Morton's video codec @tab @tab X @tab Codec used in Worms games. @item Kega Game Video (KGV1) @tab @tab X @@ -522,7 +547,7 @@ following image formats are supported: @item MPEG-1/2 video (VDPAU acceleration) @tab @tab X @item MPEG-2 video @tab X @tab X @item MPEG-4 part 2 @tab X @tab X - @ libxvidcore can be used alternatively for encoding. + @tab libxvidcore can be used alternatively for encoding. @item MPEG-4 part 2 Microsoft variant version 1 @tab @tab X @item MPEG-4 part 2 Microsoft variant version 2 @tab X @tab X @item MPEG-4 part 2 Microsoft variant version 3 @tab X @tab X @@ -539,6 +564,8 @@ following image formats are supported: @tab fourcc: VP80, encoding supported through external library libvpx @item planar RGB @tab @tab X @tab fourcc: 8BPS +@item Prores @tab @tab X + @tab fourcc: apch,apcn,apcs,apco @item Q-team QPEG @tab @tab X @tab fourccs: QPEG, Q1.0, Q1.1 @item QuickTime 8BPS video @tab @tab X @@ -582,6 +609,7 @@ following image formats are supported: @tab Codec used in DOS CD-ROM FlashBack game. @item Ut Video @tab @tab X @item v210 QuickTime uncompressed 4:2:2 10-bit @tab X @tab X +@item v308 QuickTime uncompressed 4:4:4 @tab X @tab X @item v410 QuickTime uncompressed 4:4:4 10-bit @tab X @tab X @item VBLE Lossless Codec @tab @tab X @item VMware Screen Codec / VMware Video @tab @tab X @@ -600,6 +628,8 @@ following image formats are supported: @item WMV7 @tab X @tab X @item YAMAHA SMAF @tab X @tab X @item Psygnosis YOP Video @tab @tab X +@item yuv4 @tab X @tab X + @tab libquicktime uncompressed packed 4:2:0 @item ZLIB @tab X @tab X @tab part of LCL, encoder experimental @item Zip Motion Blocks Video @tab X @tab X @@ -615,6 +645,8 @@ following image formats are supported: @multitable @columnfractions .4 .1 .1 .4 @item Name @tab Encoding @tab Decoding @tab Comments @item 8SVX audio @tab @tab X +@item AAC+ @tab E @tab X + @tab encoding supported through external library libaacplus @item AAC @tab E @tab X @tab encoding supported through external library libfaac and libvo-aacenc @item AC-3 @tab IX @tab X @@ -672,14 +704,16 @@ following image formats are supported: @item Atrac 3 @tab @tab X @item Bink Audio @tab @tab X @tab Used in Bink and Smacker files in many games. +@item CELT @tab @tab E + @tab decoding supported through external library libcelt @item Delphine Software International CIN audio @tab @tab X @tab Codec used in Delphine Software International games. @item Discworld II BMV Audio @tab @tab X @item COOK @tab @tab X @tab All versions except 5.1 are supported. -@item DCA (DTS Coherent Acoustics) @tab @tab X +@item DCA (DTS Coherent Acoustics) @tab X @tab X @item DPCM id RoQ @tab X @tab X - @tab Used in Quake III, Jedi Knight 2, other computer games. + @tab Used in Quake III, Jedi Knight 2 and other computer games. @item DPCM Interplay @tab @tab X @tab Used in various Interplay computer games. @item DPCM Sierra Online @tab @tab X @@ -691,6 +725,8 @@ following image formats are supported: @item DV audio @tab @tab X @item Enhanced AC-3 @tab X @tab X @item FLAC (Free Lossless Audio Codec) @tab X @tab IX +@item G.723.1 @tab X @tab X +@item G.729 @tab @tab X @item GSM @tab E @tab X @tab encoding supported through external library libgsm @item GSM Microsoft variant @tab E @tab X @@ -749,6 +785,10 @@ following image formats are supported: @tab Used in Sierra VMD files. @item Smacker audio @tab @tab X @item SMPTE 302M AES3 audio @tab @tab X +@item Sonic @tab X @tab X + @tab experimental codec +@item Sonic lossless @tab X @tab X + @tab experimental codec @item Speex @tab E @tab E @tab supported through external library libspeex @item True Audio (TTA) @tab @tab X @@ -779,8 +819,9 @@ performance on systems without hardware floating point support). @item SSA/ASS @tab X @tab X @tab X @tab X @item DVB @tab X @tab X @tab X @tab X @item DVD @tab X @tab X @tab X @tab X +@item MicroDVD @tab X @tab X @tab @tab @item PGS @tab @tab @tab @tab X -@item SubRip (SRT) @tab X @tab X @tab @tab X +@item SubRip (SRT) @tab X @tab X @tab X @tab X @item XSUB @tab @tab @tab X @tab X @end multitable diff --git a/doc/git-howto.texi b/doc/git-howto.texi index b01981e05e..f15c1cefba 100644 --- a/doc/git-howto.texi +++ b/doc/git-howto.texi @@ -1,9 +1,9 @@ \input texinfo @c -*- texinfo -*- -@settitle Using git to develop Libav +@settitle Using git to develop FFmpeg @titlepage -@center @titlefont{Using git to develop Libav} +@center @titlefont{Using git to develop FFmpeg} @end titlepage @top @@ -39,7 +39,7 @@ For more information about the Git project, visit the Consult these resources whenever you have problems, they are quite exhaustive. -What follows now is a basic introduction to Git and some Libav-specific +What follows now is a basic introduction to Git and some FFmpeg-specific guidelines to ease the contribution to the project @chapter Basics Usage @@ -53,16 +53,16 @@ Most distribution and operating system provide a package for it. @section Cloning the source tree @example -git clone git://git.libav.org/libav.git <target> +git clone git://source.ffmpeg.org/ffmpeg <target> @end example -This will put the Libav sources into the directory @var{<target>}. +This will put the FFmpeg sources into the directory @var{<target>}. @example -git clone git@@git.libav.org:libav.git <target> +git clone git@@source.ffmpeg.org:ffmpeg <target> @end example -This will put the Libav sources into the directory @var{<target>} and let +This will put the FFmpeg sources into the directory @var{<target>} and let you push back your changes to the remote repository. @@ -77,7 +77,7 @@ can be remote. By default the master branch tracks the branch master in the remote origin. @float IMPORTANT -Since merge commits are forbidden @command{--rebase} (see below) is recommended. +@command{--rebase} (see below) is recommended. @end float @section Rebasing your local branches @@ -88,7 +88,7 @@ git pull --rebase fetches the changes from the main repository and replays your local commits over it. This is required to keep all your local changes at the top of -Libav's master tree. The master tree will reject pushes with merge commits. +FFmpeg's master tree. The master tree will reject pushes with merge commits. @section Adding/removing files/directories @@ -119,7 +119,7 @@ git log <filename(s)> @end example You may also use the graphical tools like gitview or gitk or the web -interface available at http://git.libav.org/ +interface available at http://source.ffmpeg.org/ @section Checking source tree status @@ -250,7 +250,7 @@ git commit @end example -@chapter Libav specific +@chapter FFmpeg specific @section Reverting broken commits @@ -340,5 +340,5 @@ where @var{$SHA1} is the commit hash from the @command{git log} output. @chapter Server Issues -Contact the project admins @email{git@@libav.org} if you have technical +Contact the project admins @email{root@@ffmpeg.org} if you have technical problems with the GIT server. diff --git a/doc/git-howto.txt b/doc/git-howto.txt index 036b567084..5ba72eeeb9 100644 --- a/doc/git-howto.txt +++ b/doc/git-howto.txt @@ -28,9 +28,9 @@ Consult these resources whenever you have problems, they are quite exhaustive. You do not need a special username or password. All you need is to provide a ssh public key to the Git server admin. -What follows now is a basic introduction to Git and some Libav-specific +What follows now is a basic introduction to Git and some FFmpeg-specific guidelines. Read it at least once, if you are granted commit privileges to the -Libav project you are expected to be familiar with these rules. +FFmpeg project you are expected to be familiar with these rules. @@ -39,18 +39,19 @@ I. BASICS: 0. Get GIT: + Most distributions have a git package, if not You can get git from http://git-scm.com/ 1. Cloning the source tree: - git clone git://git.libav.org/libav.git <target> + git clone git://source.ffmpeg.org/ffmpeg <target> - This will put the Libav sources into the directory <target>. + This will put the FFmpeg sources into the directory <target>. - git clone git@git.libav.org:libav.git <target> + git clone git@source.ffmpeg.org:ffmpeg <target> - This will put the Libav sources into the directory <target> and let + This will put the FFmpeg sources into the directory <target> and let you push back your changes to the remote repository. @@ -72,7 +73,7 @@ I. BASICS: fetches the changes from the main repository and replays your local commits over it. This is required to keep all your local changes at the top of - Libav's master tree. The master tree will reject pushes with merge commits. + FFmpeg's master tree. The master tree will reject pushes with merge commits. 3. Adding/removing files/directories: @@ -97,7 +98,7 @@ I. BASICS: git log <filename(s)> You may also use the graphical tools like gitview or gitk or the web - interface available at http://git.libav.org/ + interface available at http://source.ffmpeg.org 6. Checking source tree status: @@ -268,5 +269,5 @@ I. BASICS: where $SHA1 is the commit SHA1 from the 'git log' output. -Contact the project admins <git at libav dot org> if you have technical +Contact the project admins <root at ffmpeg dot org> if you have technical problems with the GIT server. diff --git a/doc/indevs.texi b/doc/indevs.texi index e1b4dddbc5..3b2c86290c 100644 --- a/doc/indevs.texi +++ b/doc/indevs.texi @@ -1,10 +1,10 @@ @chapter Input Devices @c man begin INPUT DEVICES -Input devices are configured elements in Libav which allow to access +Input devices are configured elements in FFmpeg which allow to access the data coming from a multimedia device attached to your system. -When you configure your Libav build, all the supported input devices +When you configure your FFmpeg build, all the supported input devices are enabled by default. You can list all available ones using the configure option "--list-indevs". @@ -42,10 +42,10 @@ specify card number or identifier, device number and subdevice number To see the list of cards currently recognized by your system check the files @file{/proc/asound/cards} and @file{/proc/asound/devices}. -For example to capture with @command{avconv} from an ALSA device with +For example to capture with @command{ffmpeg} from an ALSA device with card id 0, you may run the command: @example -avconv -f alsa -i hw:0 alsaout.wav +ffmpeg -f alsa -i hw:0 alsaout.wav @end example For more information see: @@ -55,6 +55,101 @@ For more information see: BSD video input device. +@section dshow + +Windows DirectShow input device. + +DirectShow support is enabled when FFmpeg is built with mingw-w64. +Currently only audio and video devices are supported. + +Multiple devices may be opened as separate inputs, but they may also be +opened on the same input, which should improve synchronism between them. + +The input name should be in the format: + +@example +@var{TYPE}=@var{NAME}[:@var{TYPE}=@var{NAME}] +@end example + +where @var{TYPE} can be either @var{audio} or @var{video}, +and @var{NAME} is the device's name. + +@subsection Options + +If no options are specified, the device's defaults are used. +If the device does not support the requested options, it will +fail to open. + +@table @option + +@item video_size +Set the video size in the captured video. + +@item framerate +Set the framerate in the captured video. + +@item sample_rate +Set the sample rate (in Hz) of the captured audio. + +@item sample_size +Set the sample size (in bits) of the captured audio. + +@item channels +Set the number of channels in the captured audio. + +@item list_devices +If set to @option{true}, print a list of devices and exit. + +@item list_options +If set to @option{true}, print a list of selected device's options +and exit. + +@item video_device_number +Set video device number for devices with same name (starts at 0, +defaults to 0). + +@item audio_device_number +Set audio device number for devices with same name (starts at 0, +defaults to 0). + +@end table + +@subsection Examples + +@itemize + +@item +Print the list of DirectShow supported devices and exit: +@example +$ ffmpeg -list_devices true -f dshow -i dummy +@end example + +@item +Open video device @var{Camera}: +@example +$ ffmpeg -f dshow -i video="Camera" +@end example + +@item +Open second video device with name @var{Camera}: +@example +$ ffmpeg -f dshow -video_device_number 1 -i video="Camera" +@end example + +@item +Open video device @var{Camera} and audio device @var{Microphone}: +@example +$ ffmpeg -f dshow -i video="Camera":audio="Microphone" +@end example + +@item +Print the list of supported options in selected device and exit: +@example +$ ffmpeg -list_options true -f dshow -i video="Camera" +@end example + +@end itemize + @section dv1394 Linux DV 1394 input device. @@ -72,14 +167,14 @@ For more detailed information read the file Documentation/fb/framebuffer.txt included in the Linux source tree. To record from the framebuffer device @file{/dev/fb0} with -@command{avconv}: +@command{ffmpeg}: @example -avconv -f fbdev -r 10 -i /dev/fb0 out.avi +ffmpeg -f fbdev -r 10 -i /dev/fb0 out.avi @end example You can take a single screenshot image with the command: @example -avconv -f fbdev -frames:v 1 -r 1 -i /dev/fb0 screenshot.jpeg +ffmpeg -f fbdev -frames:v 1 -r 1 -i /dev/fb0 screenshot.jpeg @end example See also @url{http://linux-fbdev.sourceforge.net/}, and fbset(1). @@ -95,24 +190,24 @@ A JACK input device creates one or more JACK writable clients, one for each audio channel, with name @var{client_name}:input_@var{N}, where @var{client_name} is the name provided by the application, and @var{N} is a number which identifies the channel. -Each writable client will send the acquired data to the Libav input +Each writable client will send the acquired data to the FFmpeg input device. Once you have created one or more JACK readable clients, you need to connect them to one or more JACK writable clients. -To connect or disconnect JACK clients you can use the -@file{jack_connect} and @file{jack_disconnect} programs, or do it -through a graphical interface, for example with @file{qjackctl}. +To connect or disconnect JACK clients you can use the @command{jack_connect} +and @command{jack_disconnect} programs, or do it through a graphical interface, +for example with @command{qjackctl}. To list the JACK clients and their properties you can invoke the command -@file{jack_lsp}. +@command{jack_lsp}. Follows an example which shows how to capture a JACK readable client -with @command{avconv}. +with @command{ffmpeg}. @example -# Create a JACK writable client with name "libav". -$ avconv -f jack -i libav -y out.wav +# Create a JACK writable client with name "ffmpeg". +$ ffmpeg -f jack -i ffmpeg -y out.wav # Start the sample jack_metro readable client. $ jack_metro -b 120 -d 0.2 -f 4000 @@ -123,20 +218,175 @@ system:capture_1 system:capture_2 system:playback_1 system:playback_2 -libav:input_1 +ffmpeg:input_1 metro:120_bpm -# Connect metro to the avconv writable client. -$ jack_connect metro:120_bpm libav:input_1 +# Connect metro to the ffmpeg writable client. +$ jack_connect metro:120_bpm ffmpeg:input_1 @end example For more information read: @url{http://jackaudio.org/} +@section lavfi + +Libavfilter input virtual device. + +This input device reads data from the open output pads of a libavfilter +filtergraph. + +For each filtergraph open output, the input device will create a +corresponding stream which is mapped to the generated output. Currently +only video data is supported. The filtergraph is specified through the +option @option{graph}. + +@subsection Options + +@table @option + +@item graph +Specify the filtergraph to use as input. Each video open output must be +labelled by a unique string of the form "out@var{N}", where @var{N} is a +number starting from 0 corresponding to the mapped input stream +generated by the device. +The first unlabelled output is automatically assigned to the "out0" +label, but all the others need to be specified explicitly. + +If not specified defaults to the filename specified for the input +device. +@end table + +@subsection Examples + +@itemize +@item +Create a color video stream and play it back with @command{ffplay}: +@example +ffplay -f lavfi -graph "color=pink [out0]" dummy +@end example + +@item +As the previous example, but use filename for specifying the graph +description, and omit the "out0" label: +@example +ffplay -f lavfi color=pink +@end example + +@item +Create three different video test filtered sources and play them: +@example +ffplay -f lavfi -graph "testsrc [out0]; testsrc,hflip [out1]; testsrc,negate [out2]" test3 +@end example + +@item +Read an audio stream from a file using the amovie source and play it +back with @command{ffplay}: +@example +ffplay -f lavfi "amovie=test.wav" +@end example + +@item +Read an audio stream and a video stream and play it back with +@command{ffplay}: +@example +ffplay -f lavfi "movie=test.avi[out0];amovie=test.wav[out1]" +@end example + +@end itemize + @section libdc1394 IIDC1394 input device, based on libdc1394 and libraw1394. +@section openal + +The OpenAL input device provides audio capture on all systems with a +working OpenAL 1.1 implementation. + +To enable this input device during configuration, you need OpenAL +headers and libraries installed on your system, and need to configure +FFmpeg with @code{--enable-openal}. + +OpenAL headers and libraries should be provided as part of your OpenAL +implementation, or as an additional download (an SDK). Depending on your +installation you may need to specify additional flags via the +@code{--extra-cflags} and @code{--extra-ldflags} for allowing the build +system to locate the OpenAL headers and libraries. + +An incomplete list of OpenAL implementations follows: + +@table @strong +@item Creative +The official Windows implementation, providing hardware acceleration +with supported devices and software fallback. +See @url{http://openal.org/}. +@item OpenAL Soft +Portable, open source (LGPL) software implementation. Includes +backends for the most common sound APIs on the Windows, Linux, +Solaris, and BSD operating systems. +See @url{http://kcat.strangesoft.net/openal.html}. +@item Apple +OpenAL is part of Core Audio, the official Mac OS X Audio interface. +See @url{http://developer.apple.com/technologies/mac/audio-and-video.html} +@end table + +This device allows to capture from an audio input device handled +through OpenAL. + +You need to specify the name of the device to capture in the provided +filename. If the empty string is provided, the device will +automatically select the default device. You can get the list of the +supported devices by using the option @var{list_devices}. + +@subsection Options + +@table @option + +@item channels +Set the number of channels in the captured audio. Only the values +@option{1} (monaural) and @option{2} (stereo) are currently supported. +Defaults to @option{2}. + +@item sample_size +Set the sample size (in bits) of the captured audio. Only the values +@option{8} and @option{16} are currently supported. Defaults to +@option{16}. + +@item sample_rate +Set the sample rate (in Hz) of the captured audio. +Defaults to @option{44.1k}. + +@item list_devices +If set to @option{true}, print a list of devices and exit. +Defaults to @option{false}. + +@end table + +@subsection Examples + +Print the list of OpenAL supported devices and exit: +@example +$ ffmpeg -list_devices true -f openal -i dummy out.ogg +@end example + +Capture from the OpenAL device @file{DR-BT101 via PulseAudio}: +@example +$ ffmpeg -f openal -i 'DR-BT101 via PulseAudio' out.ogg +@end example + +Capture from the default device (note the empty string '' as filename): +@example +$ ffmpeg -f openal -i '' out.ogg +@end example + +Capture from two devices simultaneously, writing to two different files, +within the same @command{ffmpeg} command: +@example +$ ffmpeg -f openal -i 'DR-BT101 via PulseAudio' out1.ogg -f openal -i 'ALSA Default' out2.ogg +@end example +Note: not all OpenAL implementations support multiple simultaneous capture - +try the latest OpenAL Soft if the above does not work. + @section oss Open Sound System input device. @@ -145,10 +395,10 @@ The filename to provide to the input device is the device node representing the OSS input device, and is usually set to @file{/dev/dsp}. -For example to grab from @file{/dev/dsp} using @command{avconv} use the +For example to grab from @file{/dev/dsp} using @command{ffmpeg} use the command: @example -avconv -f oss -i /dev/dsp /tmp/oss.wav +ffmpeg -f oss -i /dev/dsp /tmp/oss.wav @end example For more information about OSS see: @@ -165,10 +415,10 @@ The filename to provide to the input device is a source device or the string "default" To list the pulse source devices and their properties you can invoke -the command @file{pactl list sources}. +the command @command{pactl list sources}. @example -avconv -f pulse -i default /tmp/pulse.wav +ffmpeg -f pulse -i default /tmp/pulse.wav @end example @subsection @var{server} AVOption @@ -188,7 +438,7 @@ The syntax is: @end example Specify the application name pulse will use when showing active clients, -by default it is "libav" +by default it is the LIBAVFORMAT_IDENT string @subsection @var{stream_name} AVOption @@ -248,10 +498,10 @@ The filename to provide to the input device is the device node representing the sndio input device, and is usually set to @file{/dev/audio0}. -For example to grab from @file{/dev/audio0} using @command{avconv} use the +For example to grab from @file{/dev/audio0} using @command{ffmpeg} use the command: @example -avconv -f sndio -i /dev/audio0 /tmp/oss.wav +ffmpeg -f sndio -i /dev/audio0 /tmp/oss.wav @end example @section video4linux and video4linux2 @@ -266,33 +516,39 @@ the device. Video4Linux and Video4Linux2 devices only support a limited set of @var{width}x@var{height} sizes and framerates. You can check which are -supported for example with the command @file{dov4l} for Video4Linux +supported for example with the command @command{dov4l} for Video4Linux devices and using @command{-list_formats all} for Video4Linux2 devices. If the size for the device is set to 0x0, the input device will -try to autodetect the size to use. +try to auto-detect the size to use. Only for the video4linux2 device, if the frame rate is set to 0/0 the input device will use the frame rate value already set in the driver. Video4Linux support is deprecated since Linux 2.6.30, and will be dropped in later versions. +Note that if FFmpeg is build with v4l-utils support ("--enable-libv4l2" +option), it will always be used. + Follow some usage examples of the video4linux devices with the ff* tools. @example # Grab and show the input of a video4linux device, frame rate is set # to the default of 25/1. -avplay -s 320x240 -f video4linux /dev/video0 +ffplay -s 320x240 -f video4linux /dev/video0 -# Grab and show the input of a video4linux2 device, autoadjust size. -avplay -f video4linux2 /dev/video0 +# Grab and show the input of a video4linux2 device, auto-adjust size. +ffplay -f video4linux2 /dev/video0 -# Grab and record the input of a video4linux2 device, autoadjust size, +# Grab and record the input of a video4linux2 device, auto-adjust size, # frame rate value defaults to 0/0 so it is read from the video4linux2 # driver. -avconv -f video4linux2 -i /dev/video0 out.mpeg +ffmpeg -f video4linux2 -i /dev/video0 out.mpeg @end example +"v4l" and "v4l2" can be used as aliases for the respective "video4linux" and +"video4linux2". + @section vfwcap VfW (Video for Windows) capture input device. @@ -314,7 +570,7 @@ The filename passed as input has the syntax: @var{hostname}:@var{display_number}.@var{screen_number} specifies the X11 display name of the screen to grab from. @var{hostname} can be -ommitted, and defaults to "localhost". The environment variable +omitted, and defaults to "localhost". The environment variable @env{DISPLAY} contains the default display name. @var{x_offset} and @var{y_offset} specify the offsets of the grabbed @@ -323,15 +579,15 @@ default to 0. Check the X11 documentation (e.g. man X) for more detailed information. -Use the @file{dpyinfo} program for getting basic information about the +Use the @command{dpyinfo} program for getting basic information about the properties of your X11 display (e.g. grep for "name" or "dimensions"). -For example to grab from @file{:0.0} using @command{avconv}: +For example to grab from @file{:0.0} using @command{ffmpeg}: @example -avconv -f x11grab -r 25 -s cif -i :0.0 out.mpg +ffmpeg -f x11grab -r 25 -s cif -i :0.0 out.mpg # Grab at position 10,20. -avconv -f x11grab -r 25 -s cif -i :0.0+10,20 out.mpg +ffmpeg -f x11grab -r 25 -s cif -i :0.0+10,20 out.mpg @end example @subsection @var{follow_mouse} AVOption @@ -348,10 +604,10 @@ zero) to the edge of region. For example: @example -avconv -f x11grab -follow_mouse centered -r 25 -s cif -i :0.0 out.mpg +ffmpeg -f x11grab -follow_mouse centered -r 25 -s cif -i :0.0 out.mpg # Follows only when the mouse pointer reaches within 100 pixels to edge -avconv -f x11grab -follow_mouse 100 -r 25 -s cif -i :0.0 out.mpg +ffmpeg -f x11grab -follow_mouse 100 -r 25 -s cif -i :0.0 out.mpg @end example @subsection @var{show_region} AVOption @@ -367,10 +623,10 @@ being grabbed if only a portion of the screen is grabbed. For example: @example -avconv -f x11grab -show_region 1 -r 25 -s cif -i :0.0+10,20 out.mpg +ffmpeg -f x11grab -show_region 1 -r 25 -s cif -i :0.0+10,20 out.mpg # With follow_mouse -avconv -f x11grab -follow_mouse centered -show_region 1 -r 25 -s cif -i :0.0 out.mpg +ffmpeg -f x11grab -follow_mouse centered -show_region 1 -r 25 -s cif -i :0.0 out.mpg @end example @c man end INPUT DEVICES diff --git a/doc/issue_tracker.txt b/doc/issue_tracker.txt new file mode 100644 index 0000000000..d487f66830 --- /dev/null +++ b/doc/issue_tracker.txt @@ -0,0 +1,213 @@ +FFmpeg's bug/patch/feature request tracker manual +================================================= + +NOTE: This is a draft. + +Overview: +--------- + +FFmpeg uses Trac for tracking issues, new issues and changes to +existing issues can be done through a web interface. + +Issues can be different kinds of things we want to keep track of +but that do not belong into the source tree itself. This includes +bug reports, patches, feature requests and license violations. We +might add more items to this list in the future, so feel free to +propose a new `type of issue' on the ffmpeg-devel mailing list if +you feel it is worth tracking. + +It is possible to subscribe to individual issues by adding yourself to the +Cc list or to subscribe to the ffmpeg-trac mailing list which receives +a mail for every change to every issue. +(the above does all work already after light testing) + +The subscription URL for the ffmpeg-trac list is: +http(s)://ffmpeg.org/mailman/listinfo/ffmpeg-trac +The URL of the webinterface of the tracker is: +http(s)://ffmpeg.org/trac/ffmpeg + +Type: +----- +bug / defect + An error, flaw, mistake, failure, or fault in FFmpeg or libav* that + prevents it from behaving as intended. + +feature request / enhancement + Request of support for encoding or decoding of a new codec, container + or variant. + Request of support for more, less or plain different output or behavior + where the current implementation cannot be considered wrong. + +license violation + ticket to keep track of (L)GPL violations of ffmpeg by others + +patch + A patch as generated by diff which conforms to the patch submission and + development policy. + + +Priority: +--------- +critical + Bugs and patches which deal with data loss and security issues. + No feature request can be critical. + +important + Bugs which make FFmpeg unusable for a significant number of users, and + patches fixing them. + Examples here might be completely broken MPEG-4 decoding or a build issue + on Linux. + While broken 4xm decoding or a broken OS/2 build would not be important, + the separation to normal is somewhat fuzzy. + For feature requests this priority would be used for things many people + want. + Regressions also should be marked as important, regressions are bugs that + don't exist in a past revision or another branch. + +normal + + +minor + Bugs and patches about things like spelling errors, "mp2" instead of + "mp3" being shown and such. + Feature requests about things few people want or which do not make a big + difference. + +wish + Something that is desirable to have but that there is no urgency at + all to implement, e.g. something completely cosmetic like a website + restyle or a personalized doxy template or the FFmpeg logo. + This priority is not valid for bugs. + + +Status: +------- +new + initial state + +open + intermediate states + +closed + final state + + +Analyzed flag: +-------------- +Bugs which have been analyzed and where it is understood what causes them +and which exact chain of events triggers them. This analysis should be +available as a message in the bug report. +Note, do not change the status to analyzed without also providing a clear +and understandable analysis. +This state implicates that the bug either has been reproduced or that +reproduction is not needed as the bug is already understood. + + +Type/Status/Substatus: +---------- +*/new/new + Initial state of new bugs, patches and feature requests submitted by + users. + +*/open/open + Issues which have been briefly looked at and which did not look outright + invalid. + This implicates that no real more detailed state applies yet. Conversely, + the more detailed states below implicate that the issue has been briefly + looked at. + +*/closed/duplicate + Bugs, patches or feature requests which are duplicates. + Note that patches dealing with the same thing in a different way are not + duplicates. + Note, if you mark something as duplicate, do not forget setting the + superseder so bug reports are properly linked. + +*/closed/invalid + Bugs caused by user errors, random ineligible or otherwise nonsense stuff. + +*/closed/needs_more_info + Issues for which some information has been requested by the developers, + but which has not been provided by anyone within reasonable time. + + +bug/closed/fixed + Bugs which have to the best of our knowledge been fixed. + +bug/closed/wont_fix + Bugs which we will not fix. Possible reasons include legality, high + complexity for the sake of supporting obscure corner cases, speed loss + for similarly esoteric purposes, et cetera. + This also means that we would reject a patch. + If we are just too lazy to fix a bug then the correct state is open + and unassigned. Closed means that the case is closed which is not + the case if we are just waiting for a patch. + +bug/closed/works_for_me + Bugs for which sufficient information was provided to reproduce but + reproduction failed - that is the code seems to work correctly to the + best of our knowledge. + +patch/open/approved + Patches which have been reviewed and approved by a developer. + Such patches can be applied anytime by any other developer after some + reasonable testing (compile + regression tests + does the patch do + what the author claimed). + +patch/open/needs_changes + Patches which have been reviewed and need changes to be accepted. + +patch/closed/applied + Patches which have been applied. + +patch/closed/rejected + Patches which have been rejected. + +feature_request/closed/implemented + Feature requests which have been implemented. + +feature_request/closed/wont_implement + Feature requests which will not be implemented. The reasons here could + be legal, philosophical or others. + +Note, please do not use type-status-substatus combinations other than the +above without asking on ffmpeg-dev first! + +Note2, if you provide the requested info do not forget to remove the +needs_more_info substatus. + +Component: +---------- + +avcodec + issues in libavcodec/* + +avformat + issues in libavformat/* + +avutil + issues in libavutil/* + +regression test + issues in tests/* + +ffmpeg + issues in or related to ffmpeg.c + +ffplay + issues in or related to ffplay.c + +ffprobe + issues in or related to ffprobe.c + +ffserver + issues in or related to ffserver.c + +build system + issues in or related to configure/Makefile + +regression + bugs which were not present in a past revision + +trac + issues related to our issue tracker diff --git a/doc/libavfilter.texi b/doc/libavfilter.texi index b452294a5f..06d9f13324 100644 --- a/doc/libavfilter.texi +++ b/doc/libavfilter.texi @@ -11,11 +11,11 @@ @chapter Introduction -Libavfilter is the filtering API of Libav. It is the substitute of the +Libavfilter is the filtering API of FFmpeg. It is the substitute of the now deprecated 'vhooks' and started as a Google Summer of Code project. -But note that there may still be serious bugs in the code and its API -and ABI should not be considered stable yet! +Audio filtering integration into the main FFmpeg repository is a work in +progress, so audio API and ABI should not be considered stable yet. @chapter Tutorial @@ -36,20 +36,20 @@ and the vflip filter before merging it back with the other stream by overlaying it on top. You can use the following command to achieve this: @example -./avconv -i input -vf "[in] split [T1], fifo, [T2] overlay=0:H/2 [out]; [T1] fifo, crop=iw:ih/2:0:ih/2, vflip [T2]" output +ffmpeg -i input -vf "[in] split [T1], fifo, [T2] overlay=0:H/2 [out]; [T1] fifo, crop=iw:ih/2:0:ih/2, vflip [T2]" output @end example The result will be that in output the top half of the video is mirrored onto the bottom half. Video filters are loaded using the @var{-vf} option passed to -avconv or to avplay. Filters in the same linear chain are separated by -commas. In our example, @var{split, fifo, overlay} are in one linear -chain, and @var{fifo, crop, vflip} are in another. The points where -the linear chains join are labeled by names enclosed in square -brackets. In our example, that is @var{[T1]} and @var{[T2]}. The magic -labels @var{[in]} and @var{[out]} are the points where video is input -and output. +@command{ffmpeg} or to @command{ffplay}. Filters in the same linear +chain are separated by commas. In our example, @var{split, fifo, +overlay} are in one linear chain, and @var{fifo, crop, vflip} are in +another. The points where the linear chains join are labeled by names +enclosed in square brackets. In our example, that is @var{[T1]} and +@var{[T2]}. The magic labels @var{[in]} and @var{[out]} are the points +where video is input and output. Some filters take in input a list of parameters: they are specified after the filter name and an equal sign, and are separated each other @@ -61,7 +61,7 @@ not have video output. @chapter graph2dot -The @file{graph2dot} program included in the Libav @file{tools} +The @file{graph2dot} program included in the FFmpeg @file{tools} directory can be used to parse a filter graph description and issue a corresponding textual representation in the dot language. diff --git a/doc/metadata.texi b/doc/metadata.texi index cfaf491c2d..2a285757cc 100644 --- a/doc/metadata.texi +++ b/doc/metadata.texi @@ -1,7 +1,7 @@ @chapter Metadata @c man begin METADATA -Libav is able to dump metadata from media files into a simple UTF-8-encoded +FFmpeg is able to dump metadata from media files into a simple UTF-8-encoded INI-like text file and then load it back using the metadata muxer/demuxer. The file format is as follows: @@ -53,7 +53,7 @@ A ffmetadata file might look like this: ;FFMETADATA1 title=bike\\shed ;this is a comment -artist=Libav troll team +artist=FFmpeg troll team [CHAPTER] TIMEBASE=1/1000 diff --git a/doc/multithreading.txt b/doc/multithreading.txt index b72bc16079..a1068425cd 100644 --- a/doc/multithreading.txt +++ b/doc/multithreading.txt @@ -1,7 +1,7 @@ -Libav multithreading methods +FFmpeg multithreading methods ============================================== -Libav provides two methods for multithreading codecs. +FFmpeg provides two methods for multithreading codecs. Slice threading decodes multiple parts of a frame at the same time, using AVCodecContext execute() and execute2(). diff --git a/doc/muxers.texi b/doc/muxers.texi index 5a609c8b9a..d2aa75e818 100644 --- a/doc/muxers.texi +++ b/doc/muxers.texi @@ -1,10 +1,10 @@ @chapter Muxers @c man begin MUXERS -Muxers are configured elements in Libav which allow writing +Muxers are configured elements in FFmpeg which allow writing multimedia streams to a particular type of file. -When you configure your Libav build, all the supported muxers +When you configure your FFmpeg build, all the supported muxers are enabled by default. You can list all available muxers using the configure option @code{--list-muxers}. @@ -35,20 +35,20 @@ CRC=0x@var{CRC}, where @var{CRC} is a hexadecimal number 0-padded to For example to compute the CRC of the input, and store it in the file @file{out.crc}: @example -avconv -i INPUT -f crc out.crc +ffmpeg -i INPUT -f crc out.crc @end example You can print the CRC to stdout with the command: @example -avconv -i INPUT -f crc - +ffmpeg -i INPUT -f crc - @end example -You can select the output format of each frame with @command{avconv} by +You can select the output format of each frame with @command{ffmpeg} by specifying the audio and video codec and format. For example to compute the CRC of the input audio converted to PCM unsigned 8-bit and the input video converted to MPEG-2 video, use the command: @example -avconv -i INPUT -c:a pcm_u8 -c:v mpeg2video -f crc - +ffmpeg -i INPUT -c:a pcm_u8 -c:v mpeg2video -f crc - @end example See also the @ref{framecrc} muxer. @@ -71,21 +71,21 @@ number 0-padded to 8 digits containing the CRC of the decoded frame. For example to compute the CRC of each decoded frame in the input, and store it in the file @file{out.crc}: @example -avconv -i INPUT -f framecrc out.crc +ffmpeg -i INPUT -f framecrc out.crc @end example You can print the CRC of each decoded frame to stdout with the command: @example -avconv -i INPUT -f framecrc - +ffmpeg -i INPUT -f framecrc - @end example -You can select the output format of each frame with @command{avconv} by +You can select the output format of each frame with @command{ffmpeg} by specifying the audio and video codec and format. For example, to compute the CRC of each decoded input audio frame converted to PCM unsigned 8-bit and of each decoded input video frame converted to MPEG-2 video, use the command: @example -avconv -i INPUT -c:a pcm_u8 -c:v mpeg2video -f framecrc - +ffmpeg -i INPUT -c:a pcm_u8 -c:v mpeg2video -f framecrc - @end example See also the @ref{crc} muxer. @@ -120,28 +120,46 @@ The pattern "img%%-%d.jpg" will specify a sequence of filenames of the form @file{img%-1.jpg}, @file{img%-2.jpg}, ..., @file{img%-10.jpg}, etc. -The following example shows how to use @command{avconv} for creating a +The following example shows how to use @command{ffmpeg} for creating a sequence of files @file{img-001.jpeg}, @file{img-002.jpeg}, ..., taking one image every second from the input video: @example -avconv -i in.avi -vsync 1 -r 1 -f image2 'img-%03d.jpeg' +ffmpeg -i in.avi -vsync 1 -r 1 -f image2 'img-%03d.jpeg' @end example -Note that with @command{avconv}, if the format is not specified with the +Note that with @command{ffmpeg}, if the format is not specified with the @code{-f} option and the output filename specifies an image file format, the image2 muxer is automatically selected, so the previous command can be written as: @example -avconv -i in.avi -vsync 1 -r 1 'img-%03d.jpeg' +ffmpeg -i in.avi -vsync 1 -r 1 'img-%03d.jpeg' @end example Note also that the pattern must not necessarily contain "%d" or "%0@var{N}d", for example to create a single image file @file{img.jpeg} from the input video you can employ the command: @example -avconv -i in.avi -f image2 -frames:v 1 img.jpeg +ffmpeg -i in.avi -f image2 -frames:v 1 img.jpeg @end example +The image muxer supports the .Y.U.V image file format. This format is +special in that that each image frame consists of three files, for +each of the YUV420P components. To read or write this image file format, +specify the name of the '.Y' file. The muxer will automatically open the +'.U' and '.V' files as required. + +@section mov + +MOV / MP4 muxer + +The muxer options are: + +@table @option +@item -moov_size @var{bytes} +Reserves space for the moov atom at the beginning of the file instead of placing the +moov atom at the end. If the space reserved is insufficient, muxing will fail. +@end table + @section mpegts MPEG transport stream muxer. @@ -168,11 +186,11 @@ Set the first PID for data packets (default 0x0100, max 0x0f00). The recognized metadata settings in mpegts muxer are @code{service_provider} and @code{service_name}. If they are not set the default for -@code{service_provider} is "Libav" and the default for +@code{service_provider} is "FFmpeg" and the default for @code{service_name} is "Service01". @example -avconv -i file.mpg -c copy \ +ffmpeg -i file.mpg -c copy \ -mpegts_original_network_id 0x1122 \ -mpegts_transport_stream_id 0x3344 \ -mpegts_service_id 0x5566 \ @@ -190,19 +208,19 @@ Null muxer. This muxer does not generate any output file, it is mainly useful for testing or benchmarking purposes. -For example to benchmark decoding with @command{avconv} you can use the +For example to benchmark decoding with @command{ffmpeg} you can use the command: @example -avconv -benchmark -i INPUT -f null out.null +ffmpeg -benchmark -i INPUT -f null out.null @end example Note that the above command does not read or write the @file{out.null} -file, but specifying the output file is required by the @command{avconv} +file, but specifying the output file is required by the @command{ffmpeg} syntax. Alternatively you can write the command as: @example -avconv -benchmark -i INPUT -f null - +ffmpeg -benchmark -i INPUT -f null - @end example @section matroska @@ -227,7 +245,7 @@ Specifies the language of the track in the Matroska languages form @table @option -@item STEREO_MODE=@var{mode} +@item stereo_mode=@var{mode} Stereo 3D video layout of two views in a single video track @table @option @item mono @@ -265,7 +283,7 @@ Both eyes laced in one Block, Right-eye view is first For example a 3D WebM clip can be created using the following command line: @example -avconv -i sample_left_right_clip.mpg -an -c:v libvpx -metadata STEREO_MODE=left_right -y stereo_clip.webm +ffmpeg -i sample_left_right_clip.mpg -an -c:v libvpx -metadata stereo_mode=left_right -y stereo_clip.webm @end example @section segment @@ -295,7 +313,7 @@ Overwrite the listfile once it reaches @var{size} entries. @end table @example -avconv -i in.mkv -c copy -map 0 -f segment -list out.list out%03d.nut +ffmpeg -i in.mkv -c copy -map 0 -f segment -list out.list out%03d.nut @end example diff --git a/doc/optimization.txt b/doc/optimization.txt index 78e0077e30..b027efef2f 100644 --- a/doc/optimization.txt +++ b/doc/optimization.txt @@ -17,15 +17,15 @@ Understanding these overoptimized functions: As many functions tend to be a bit difficult to understand because of optimizations, it can be hard to optimize them further, or write architecture-specific versions. It is recommended to look at older -revisions of the interesting files (web frontends for the various Libav -branches are listed at http://libav.org/download.html). +revisions of the interesting files (web frontends for the various FFmpeg +branches are listed at http://ffmpeg.org/download.html). Alternatively, look into the other architecture-specific versions in the x86/, ppc/, alpha/ subdirectories. Even if you don't exactly comprehend the instructions, it could help understanding the functions and how they can be optimized. NOTE: If you still don't understand some function, ask at our mailing list!!! -(https://lists.libav.org/mailman/listinfo/libav-devel) +(http://lists.ffmpeg.org/mailman/listinfo/ffmpeg-devel) When is an optimization justified? @@ -201,7 +201,7 @@ Inline asm vs. external asm --------------------------- Both inline asm (__asm__("..") in a .c file, handled by a compiler such as gcc) and external asm (.s or .asm files, handled by an assembler such as yasm/nasm) -are accepted in Libav. Which one to use differs per specific case. +are accepted in FFmpeg. Which one to use differs per specific case. - if your code is intended to be inlined in a C function, inline asm is always better, because external asm cannot be inlined diff --git a/doc/outdevs.texi b/doc/outdevs.texi index 938909c784..8de4fe6ec4 100644 --- a/doc/outdevs.texi +++ b/doc/outdevs.texi @@ -1,10 +1,10 @@ @chapter Output Devices @c man begin OUTPUT DEVICES -Output devices are configured elements in Libav which allow to write +Output devices are configured elements in FFmpeg which allow to write multimedia data to an output device attached to your system. -When you configure your Libav build, all the supported output devices +When you configure your FFmpeg build, all the supported output devices are enabled by default. You can list all available ones using the configure option "--list-outdevs". @@ -26,6 +26,46 @@ ALSA (Advanced Linux Sound Architecture) output device. OSS (Open Sound System) output device. +@section sdl + +SDL (Simple DirectMedia Layer) output device. + +This output devices allows 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. + +To enable this output device you need libsdl installed on your system +when configuring your build. + +For more information about SDL, check: +@url{http://www.libsdl.org/} + +@subsection Options + +@table @option + +@item window_title +Set the SDL window title, if not specified default to the filename +specified for the output device. + +@item icon_title +Set the name of the iconified SDL window, if not specified it is set +to the same value of @var{window_title}. + +@item window_size +Set the SDL window size, can be a string of the form +@var{width}x@var{height} or a video size abbreviation. +If not specified it defaults to the size of the input video. +@end table + +@subsection Examples + +The following command shows the @command{ffmpeg} output is an +SDL window, forcing its size to the qcif format: +@example +ffmpeg -i INPUT -vcodec rawvideo -pix_fmt yuv420p -window_size qcif -f sdl "SDL output" +@end example + @section sndio sndio audio output device. diff --git a/doc/platform.texi b/doc/platform.texi index 7ec7cb3dd0..b52e13a94d 100644 --- a/doc/platform.texi +++ b/doc/platform.texi @@ -11,7 +11,7 @@ @chapter Unix-like -Some parts of Libav cannot be built with version 2.15 of the GNU +Some parts of FFmpeg cannot be built with version 2.15 of the GNU assembler which is still provided by a few AMD64 distributions. To make sure your compiler really uses the required version of gas after a binutils upgrade, run: @@ -26,12 +26,12 @@ to configure. @section BSD -BSD make will not build Libav, you need to install and use GNU Make +BSD make will not build FFmpeg, you need to install and use GNU Make (@file{gmake}). @section (Open)Solaris -GNU Make is required to build Libav, so you have to invoke (@file{gmake}), +GNU Make is required to build FFmpeg, so you have to invoke (@file{gmake}), standard Solaris Make will not work. When building with a non-c99 front-end (gcc, generic suncc) add either @code{--extra-libs=/usr/lib/values-xpg6.o} or @code{--extra-libs=/usr/lib/64/values-xpg6.o} to the configure options @@ -45,20 +45,21 @@ bash ./configure @end example @anchor{Darwin} -@section Darwin (OS X, iPhone) +@section Darwin (Mac OS X, iPhone) The toolchain provided with Xcode is sufficient to build the basic unacelerated code. -OS X on PowerPC or ARM (iPhone) requires a preprocessor from +Mac OS X on PowerPC or ARM (iPhone) requires a preprocessor from @url{http://github.com/yuvi/gas-preprocessor} to build the optimized assembler functions. Just download the Perl script and put it somewhere -in your PATH, Libav's configure will pick it up automatically. +in your PATH, FFmpeg's configure will pick it up automatically. -OS X on AMD64 and x86 requires @command{yasm} to build most of the -optimized assembler functions @url{http://mxcl.github.com/homebrew/, Homebrew}, -@url{http://www.gentoo.org/proj/en/gentoo-alt/prefix/bootstrap-macos.xml, Gentoo Prefix} -or @url{http://www.macports.org, MacPorts} can easily provide it. +Mac OS X on amd64 and x86 requires @command{yasm} to build most of the +optimized assembler functions. @uref{http://www.finkproject.org/, Fink}, +@uref{http://www.gentoo.org/proj/en/gentoo-alt/prefix/bootstrap-macos.xml, Gentoo Prefix}, +@uref{http://mxcl.github.com/homebrew/, Homebrew} +or @uref{http://www.macports.org, MacPorts} can easily provide it. @chapter DOS @@ -69,20 +70,24 @@ Using a cross-compiler is preferred for various reasons. @chapter OS/2 -For information about compiling Libav on OS/2 see +For information about compiling FFmpeg on OS/2 see @url{http://www.edm2.com/index.php/FFmpeg}. @chapter Windows +To get help and instructions for building FFmpeg under Windows, check out +the FFmpeg Windows Help Forum at +@url{http://ffmpeg.arrozcru.org/}. + @section Native Windows compilation -Libav can be built to run natively on Windows using the MinGW tools. Install +FFmpeg can be built to run natively on Windows using the MinGW tools. Install the latest versions of MSYS and MinGW from @url{http://www.mingw.org/}. -You can find detailed installation -instructions in the download section and the FAQ. +You can find detailed installation instructions in the download +section and the FAQ. -Libav does not build out-of-the-box with the packages the automated MinGW +FFmpeg does not build out-of-the-box with the packages the automated MinGW installer provides. It also requires coreutils to be installed and many other packages updated to the latest version. The minimum version for some packages are listed below: @@ -94,7 +99,7 @@ are listed below: @item mingw-runtime 3.15 @end itemize -Libav automatically passes @code{-fno-common} to the compiler to work around +FFmpeg automatically passes @code{-fno-common} to the compiler to work around a GCC bug (see @url{http://gcc.gnu.org/bugzilla/show_bug.cgi?id=37216}). Notes: @@ -107,20 +112,21 @@ speed up is close to non-existent for normal one-off builds and is only noticeable when running make for a second time (for example in @code{make install}). -@item In order to compile AVplay, you must have the MinGW development library +@item In order to compile FFplay, you must have the MinGW development library of @uref{http://www.libsdl.org/, SDL}. Edit the @file{bin/sdl-config} script so that it points to the correct prefix where SDL was installed. Verify that @file{sdl-config} can be launched from the MSYS command line. -@item By using @code{./configure --enable-shared} when configuring Libav, -you can build libavutil, libavcodec and libavformat as DLLs. +@item By using @code{./configure --enable-shared} when configuring FFmpeg, +you can build the FFmpeg libraries (e.g. libavutil, libavcodec, +libavformat) as DLLs. @end itemize @section Microsoft Visual C++ compatibility -As stated in the FAQ, Libav will not compile under MSVC++. However, if you +As stated in the FAQ, FFmpeg will not compile under MSVC++. However, if you want to use the libav* libraries in your own applications, you can still compile those applications using MSVC++. But the libav* libraries you link to @emph{must} be built with MinGW. However, you will not be able to debug @@ -128,13 +134,13 @@ inside the libav* libraries, since MSVC++ does not recognize the debug symbols generated by GCC. We strongly recommend you to move over from MSVC++ to MinGW tools. -This description of how to use the Libav libraries with MSVC++ is based on +This description of how to use the FFmpeg libraries with MSVC++ is based on Microsoft Visual C++ 2005 Express Edition. If you have a different version, you might have to modify the procedures slightly. @subsection Using static libraries -Assuming you have just built and installed Libav in @file{/usr/local}. +Assuming you have just built and installed FFmpeg in @file{/usr/local}. @enumerate @@ -145,13 +151,13 @@ Application Wizard, uncheck the "Precompiled headers" option. @item Write the source code for your application, or, for testing, just copy the code from an existing sample application into the source file that MSVC++ has already created for you. For example, you can copy -@file{libavformat/output-example.c} from the Libav distribution. +@file{libavformat/output-example.c} from the FFmpeg distribution. @item Open the "Project / Properties" dialog box. In the "Configuration" combo box, select "All Configurations" so that the changes you make will affect both debug and release builds. In the tree view on the left hand side, select "C/C++ / General", then edit the "Additional Include -Directories" setting to contain the path where the Libav includes were +Directories" setting to contain the path where the FFmpeg includes were installed (i.e. @file{c:\msys\1.0\local\include}). Do not add MinGW's include directory here, or the include files will conflict with MSVC's. @@ -159,7 +165,7 @@ conflict with MSVC's. @item Still in the "Project / Properties" dialog box, select "Linker / General" from the tree view and edit the "Additional Library Directories" setting to contain the @file{lib} -directory where Libav was installed (i.e. @file{c:\msys\1.0\local\lib}), +directory where FFmpeg was installed (i.e. @file{c:\msys\1.0\local\lib}), the directory where MinGW libs are installed (i.e. @file{c:\mingw\lib}), and the directory where MinGW's GCC libs are installed (i.e. @file{C:\mingw\lib\gcc\mingw32\4.2.1-sjlj}). Then select @@ -176,13 +182,13 @@ set to "Multi-threaded DLL". @item Click "OK" to close the "Project / Properties" dialog box. -@item MSVC++ lacks some C99 header files that are fundamental for Libav. +@item MSVC++ lacks some C99 header files that are fundamental for FFmpeg. Get msinttypes from @url{http://code.google.com/p/msinttypes/downloads/list} and install it in MSVC++'s include directory (i.e. @file{C:\Program Files\Microsoft Visual Studio 8\VC\include}). @item MSVC++ also does not understand the @code{inline} keyword used by -Libav, so you must add this line before @code{#include}ing libav*: +FFmpeg, so you must add this line before @code{#include}ing libav*: @example #define inline _inline @end example @@ -195,7 +201,30 @@ Libav, so you must add this line before @code{#include}ing libav*: This is how to create DLL and LIB files that are compatible with MSVC++: -Within the MSYS shell, build Libav with +@enumerate + +@item Add a call to @file{vcvars32.bat} (which sets up the environment +variables for the Visual C++ tools) as the first line of @file{msys.bat}. +The standard location for @file{vcvars32.bat} is +@file{C:\Program Files\Microsoft Visual Studio 8\VC\bin\vcvars32.bat}, +and the standard location for @file{msys.bat} is @file{C:\msys\1.0\msys.bat}. +If this corresponds to your setup, add the following line as the first line +of @file{msys.bat}: + +@example +call "C:\Program Files\Microsoft Visual Studio 8\VC\bin\vcvars32.bat" +@end example + +Alternatively, you may start the @file{Visual Studio 2005 Command Prompt}, +and run @file{c:\msys\1.0\msys.bat} from there. + +@item Within the MSYS shell, run @code{lib.exe}. If you get a help message +from @file{Microsoft (R) Library Manager}, this means your environment +variables are set up correctly, the @file{Microsoft (R) Library Manager} +is on the path and will be used by FFmpeg to create +MSVC++-compatible import libraries. + +@item Build FFmpeg with @example ./configure --enable-shared @@ -206,6 +235,8 @@ make install Your install path (@file{/usr/local/} by default) should now have the necessary DLL and LIB files under the @file{bin} directory. +@end enumerate + Alternatively, build the libraries with a cross compiler, according to the instructions below in @ref{Cross compilation for Windows with Linux}. @@ -222,7 +253,7 @@ reference errors. There should be no need for @file{libmingwex.a}, @file{libgcc.a}, and @file{wsock32.lib}, nor any other external library statically linked into the DLLs. -Libav headers do not declare global data for Windows DLLs through the usual +FFmpeg headers do not declare global data for Windows DLLs through the usual dllexport/dllimport interface. Such data will be exported properly while building, but to use them in your MSVC++ code you will have to edit the appropriate headers and mark the data as dllimport. For example, in @@ -273,14 +304,14 @@ lib /machine:i386 /def:..\lib\swscale-2.def /out:swscale.lib You must use the MinGW cross compilation tools available at @url{http://www.mingw.org/}. -Then configure Libav with the following options: +Then configure FFmpeg with the following options: @example ./configure --target-os=mingw32 --cross-prefix=i386-mingw32msvc- @end example (you can change the cross-prefix according to the prefix chosen for the MinGW tools). -Then you can easily test Libav with @uref{http://www.winehq.com/, Wine}. +Then you can easily test FFmpeg with @uref{http://www.winehq.com/, Wine}. @section Compilation under Cygwin @@ -313,7 +344,7 @@ shared libraries: ./configure --enable-shared --disable-static --extra-cflags=-fno-reorder-functions @end example -If you want to build Libav with additional libraries, download Cygwin +If you want to build FFmpeg with additional libraries, download Cygwin "Devel" packages for Ogg and Vorbis from any Cygwin packages repository: @example libogg-devel, libvorbis-devel @@ -323,7 +354,7 @@ These library packages are only available from @uref{http://sourceware.org/cygwinports/, Cygwin Ports}: @example -yasm, libSDL-devel, libdirac-devel, libfaac-devel, libgsm-devel, +yasm, libSDL-devel, libdirac-devel, libfaac-devel, libaacplus-devel, libgsm-devel, libmp3lame-devel, libschroedinger1.0-devel, speex-devel, libtheora-devel, libxvidcore-devel @end example diff --git a/doc/protocols.texi b/doc/protocols.texi index f5bb5324be..da0e39f56c 100644 --- a/doc/protocols.texi +++ b/doc/protocols.texi @@ -1,10 +1,10 @@ @chapter Protocols @c man begin PROTOCOLS -Protocols are configured elements in Libav which allow to access +Protocols are configured elements in FFmpeg which allow to access resources which require the use of a particular protocol. -When you configure your Libav build, all the supported protocols are +When you configure your FFmpeg build, all the supported protocols are enabled by default. You can list all available ones using the configure option "--list-protocols". @@ -52,10 +52,10 @@ resource to be concatenated, each one possibly specifying a distinct protocol. For example to read a sequence of files @file{split1.mpeg}, -@file{split2.mpeg}, @file{split3.mpeg} with @file{avplay} use the +@file{split2.mpeg}, @file{split3.mpeg} with @command{ffplay} use the command: @example -avplay concat:split1.mpeg\|split2.mpeg\|split3.mpeg +ffplay concat:split1.mpeg\|split2.mpeg\|split3.mpeg @end example Note that you may need to escape the character "|" which is special for @@ -67,10 +67,10 @@ File access protocol. Allow to read from or read to a file. -For example to read from a file @file{input.mpeg} with @command{avconv} +For example to read from a file @file{input.mpeg} with @command{ffmpeg} use the command: @example -avconv -i file:input.mpeg output.mpeg +ffmpeg -i file:input.mpeg output.mpeg @end example The ff* tools default to the file protocol, that is a resource @@ -109,10 +109,10 @@ be used to test muxers without writing an actual file. Some examples follow. @example # Write the MD5 hash of the encoded AVI file to the file output.avi.md5. -avconv -i input.flv -f avi -y md5:output.avi.md5 +ffmpeg -i input.flv -f avi -y md5:output.avi.md5 # Write the MD5 hash of the encoded AVI file to stdout. -avconv -i input.flv -f avi -y md5: +ffmpeg -i input.flv -f avi -y md5: @end example Note that some formats (typically MOV) require the output protocol to @@ -134,18 +134,18 @@ pipe (e.g. 0 for stdin, 1 for stdout, 2 for stderr). If @var{number} is not specified, by default the stdout file descriptor will be used for writing, stdin for reading. -For example to read from stdin with @command{avconv}: +For example to read from stdin with @command{ffmpeg}: @example -cat test.wav | avconv -i pipe:0 +cat test.wav | ffmpeg -i pipe:0 # ...this is the same as... -cat test.wav | avconv -i pipe: +cat test.wav | ffmpeg -i pipe: @end example -For writing to stdout with @command{avconv}: +For writing to stdout with @command{ffmpeg}: @example -avconv -i test.wav -f avi pipe:1 | cat > test.avi +ffmpeg -i test.wav -f avi pipe:1 | cat > test.avi # ...this is the same as... -avconv -i test.wav -f avi pipe: | cat > test.avi +ffmpeg -i test.wav -f avi pipe: | cat > test.avi @end example Note that some formats (typically MOV), require the output protocol to @@ -183,10 +183,10 @@ application specified in @var{app}, may be prefixed by "mp4:". @end table -For example to read with @file{avplay} a multimedia resource named +For example to read with @command{ffplay} a multimedia resource named "sample" from the application "vod" from an RTMP server "myserver": @example -avplay rtmp://myserver/vod/sample +ffplay rtmp://myserver/vod/sample @end example @section rtmp, rtmpe, rtmps, rtmpt, rtmpte @@ -219,14 +219,14 @@ meaning as specified for the RTMP native protocol. See the librtmp manual page (man 3 librtmp) for more information. For example, to stream a file in real-time to an RTMP server using -@command{avconv}: +@command{ffmpeg}: @example -avconv -re -i myfile -f flv rtmp://myserver/live/mystream +ffmpeg -re -i myfile -f flv rtmp://myserver/live/mystream @end example -To play the same stream using @file{avplay}: +To play the same stream using @command{ffplay}: @example -avplay "rtmp://myserver/live/mystream live=1" +ffplay "rtmp://myserver/live/mystream live=1" @end example @section rtp @@ -249,7 +249,7 @@ The required syntax for a RTSP url is: rtsp://@var{hostname}[:@var{port}]/@var{path} @end example -The following options (set on the @command{avconv}/@file{avplay} command +The following options (set on the @command{ffmpeg}/@command{ffplay} command line, or set in code via @code{AVOption}s or in @code{avformat_open_input}), are supported: @@ -288,7 +288,7 @@ When receiving data over UDP, the demuxer tries to reorder received packets order for this to be enabled, a maximum delay must be specified in the @code{max_delay} field of AVFormatContext. -When watching multi-bitrate Real-RTSP streams with @file{avplay}, the +When watching multi-bitrate Real-RTSP streams with @command{ffplay}, the streams to display can be chosen with @code{-vst} @var{n} and @code{-ast} @var{n} for video and audio respectively, and can be switched on the fly by pressing @code{v} and @code{a}. @@ -298,19 +298,19 @@ Example command lines: To watch a stream over UDP, with a max reordering delay of 0.5 seconds: @example -avplay -max_delay 500000 -rtsp_transport udp rtsp://server/video.mp4 +ffplay -max_delay 500000 -rtsp_transport udp rtsp://server/video.mp4 @end example To watch a stream tunneled over HTTP: @example -avplay -rtsp_transport http rtsp://server/video.mp4 +ffplay -rtsp_transport http rtsp://server/video.mp4 @end example To send a stream in realtime to a RTSP server, for others to watch: @example -avconv -re -i @var{input} -f rtsp -muxdelay 0.1 rtsp://server/live.sdp +ffmpeg -re -i @var{input} -f rtsp -muxdelay 0.1 rtsp://server/live.sdp @end example @section sap @@ -362,19 +362,19 @@ Example command lines follow. To broadcast a stream on the local subnet, for watching in VLC: @example -avconv -re -i @var{input} -f sap sap://224.0.0.255?same_port=1 +ffmpeg -re -i @var{input} -f sap sap://224.0.0.255?same_port=1 @end example -Similarly, for watching in avplay: +Similarly, for watching in @command{ffplay}: @example -avconv -re -i @var{input} -f sap sap://224.0.0.255 +ffmpeg -re -i @var{input} -f sap sap://224.0.0.255 @end example -And for watching in avplay, over IPv6: +And for watching in @command{ffplay}, over IPv6: @example -avconv -re -i @var{input} -f sap sap://[ff0e::1:2:3:4] +ffmpeg -re -i @var{input} -f sap sap://[ff0e::1:2:3:4] @end example @subsection Demuxer @@ -396,13 +396,13 @@ Example command lines follow. To play back the first stream announced on the normal SAP multicast address: @example -avplay sap:// +ffplay sap:// @end example To play back the first stream announced on one the default IPv6 SAP multicast address: @example -avplay sap://[ff0e::2:7ffe] +ffplay sap://[ff0e::2:7ffe] @end example @section tcp @@ -420,8 +420,8 @@ tcp://@var{hostname}:@var{port}[?@var{options}] Listen for an incoming connection @example -avconv -i @var{input} -f @var{format} tcp://@var{hostname}:@var{port}?listen -avplay tcp://@var{hostname}:@var{port} +ffmpeg -i @var{input} -f @var{format} tcp://@var{hostname}:@var{port}?listen +ffplay tcp://@var{hostname}:@var{port} @end example @end table @@ -472,21 +472,21 @@ For receiving, this gives the benefit of only receiving packets from the specified peer address/port. @end table -Some usage examples of the udp protocol with @command{avconv} follow. +Some usage examples of the udp protocol with @command{ffmpeg} follow. To stream over UDP to a remote endpoint: @example -avconv -i @var{input} -f @var{format} udp://@var{hostname}:@var{port} +ffmpeg -i @var{input} -f @var{format} udp://@var{hostname}:@var{port} @end example To stream in mpegts format over UDP using 188 sized UDP packets, using a large input buffer: @example -avconv -i @var{input} -f mpegts udp://@var{hostname}:@var{port}?pkt_size=188&buffer_size=65535 +ffmpeg -i @var{input} -f mpegts udp://@var{hostname}:@var{port}?pkt_size=188&buffer_size=65535 @end example To receive over UDP from a remote endpoint: @example -avconv -i udp://[@var{multicast-address}]:@var{port} +ffmpeg -i udp://[@var{multicast-address}]:@var{port} @end example @c man end PROTOCOLS diff --git a/doc/soc.txt b/doc/soc.txt index 89728b5201..2504dba553 100644 --- a/doc/soc.txt +++ b/doc/soc.txt @@ -8,9 +8,9 @@ it's a little late for this year's soc (2006). The Goal: Our goal in respect to soc is and must be of course exactly one thing and -that is to improve Libav, to reach this goal, code must +that is to improve FFmpeg, to reach this goal, code must * conform to the development policy and patch submission guidelines -* must improve Libav somehow (faster, smaller, "better", +* must improve FFmpeg somehow (faster, smaller, "better", more codecs supported, fewer bugs, cleaner, ...) for mentors and other developers to help students to reach that goal it is @@ -20,5 +20,5 @@ easy reviewable that again leads us to: * separation of cosmetic from non-cosmetic changes (this is almost entirely ignored by mentors and students in soc 2006 which might lead to a surprise when the code will be reviewed at the end before a possible inclusion in - Libav, individual changes were generally not reviewable due to cosmetics). + FFmpeg, individual changes were generally not reviewable due to cosmetics). * frequent commits, so that comments can be provided early diff --git a/doc/swresample.txt b/doc/swresample.txt new file mode 100644 index 0000000000..4daa181b0e --- /dev/null +++ b/doc/swresample.txt @@ -0,0 +1,46 @@ + The official guide to swresample for confused developers. + ========================================================= + +Current (simplified) Architecture: +--------------------------------- + Input + v + __________________/|\___________ + / | \ + / input sample format convert v + / | ___________/ + | |/ + | v + | ___________/|\___________ _____________ + | / | \ | | + | Rematrix | resample <---->| Buffers | + | \___________ | ___________/ |_____________| + v \|/ +Special Converter v + v ___________/|\___________ _____________ + | / | \ | | + | Rematrix | resample <---->| Buffers | + | \___________ | ___________/ |_____________| + | \|/ + | v + | |\___________ + \ | \ + \ output sample format convert v + \_________________ | ___________/ + \|/ + v + Output + +Planar/Packed convertion is done when needed during sample format convertion +Every step can be skiped without memcpy when its not needed. +Either Resampling and Rematrixing can be performed first depending on which +way its faster. +The Buffers are needed for resampling due to resamplng being a process that +requires future and past data, it thus also introduces inevitably a delay when +used. +Internally 32bit float and 16bit int is supported currently, other formats can +easily be added +Externally all sample formats in packed and planar configuration are supported +Its also trivial to add special converters for common cases +If only sample format and or packed/planar convertion is needed it +is performed from input to output directly in a single pass with no intermediates. diff --git a/doc/t2h.init b/doc/t2h.init index d91d7b6bff..db5536bd88 100644 --- a/doc/t2h.init +++ b/doc/t2h.init @@ -1,6 +1,6 @@ # no horiz rules between sections -$end_section = \&Libav_end_section; -sub Libav_end_section($$) +$end_section = \&FFmpeg_end_section; +sub FFmpeg_end_section($$) { } @@ -67,11 +67,11 @@ h3 { </style> EOT -my $LIBAV_NAVBAR = $ENV{"LIBAV_NAVBAR"} || ''; +my $FFMPEG_NAVBAR = $ENV{"FFMPEG_NAVBAR"} || ''; $AFTER_BODY_OPEN = '<div id="container">' . -"\n$LIBAV_NAVBAR\n" . +"\n$FFMPEG_NAVBAR\n" . '<div id="body">'; $PRE_BODY_CLOSE = '</div></div>'; @@ -79,8 +79,8 @@ $PRE_BODY_CLOSE = '</div></div>'; $SMALL_RULE = ''; $BODYTEXT = ''; -$print_page_foot = \&Libav_print_page_foot; -sub Libav_print_page_foot($$) +$print_page_foot = \&FFmpeg_print_page_foot; +sub FFmpeg_print_page_foot($$) { my $fh = shift; print $fh '<div id="footer">' . "\n"; @@ -88,9 +88,9 @@ sub Libav_print_page_foot($$) print $fh "</div>\n"; } -$float = \&Libav_float; +$float = \&FFmpeg_float; -sub Libav_float($$$$) +sub FFmpeg_float($$$$) { my $text = shift; my $float = shift; @@ -117,8 +117,8 @@ sub Libav_float($$$$) return '<div class="float ' . $class . '">' . "$label\n" . $text . '</div>'; } -$print_page_head = \&Libav_print_page_head; -sub Libav_print_page_head($$) +$print_page_head = \&FFmpeg_print_page_head; +sub FFmpeg_print_page_head($$) { my $fh = shift; my $longtitle = "$Texi2HTML::THISDOC{'title_no_texi'}"; @@ -131,7 +131,7 @@ sub Libav_print_page_head($$) my $encoding = ''; $encoding = "<meta http-equiv=\"Content-Type\" content=\"text/html; charset=$ENCODING\">" if (defined($ENCODING) and ($ENCODING ne '')); $longtitle =~ s/Documentation.*//g; - $longtitle = "Libav documentation : " . $longtitle; + $longtitle = "FFmpeg documentation : " . $longtitle; print $fh <<EOT; $DOCTYPE |