generic-library/ffmpeg
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
e260c8180e
ffmpeg/libavformat/version.h

89 lines
3.1 KiB
C
Raw Normal View History

lavf: move the version macros to a new header Signed-off-by: Mans Rullgard <mans@mansr.com> (cherry picked from commit 50196a982bf7c8be9b41053fa0975473c217e709)
2011-01-21 20:18:06 +01:00
/*
* Version macros.
*
* This file is part of FFmpeg.
*
* FFmpeg is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* FFmpeg is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with FFmpeg; if not, write to the Free Software
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*/
#ifndef AVFORMAT_VERSION_H
#define AVFORMAT_VERSION_H
lavf doxy: add installed headers to groups.
2011-12-10 20:16:57 +01:00
/**
* @file
* @ingroup libavf
* Libavformat version macros
*/
avutil: Move library version related macros to version.h This is a more sensible place for these macros.
2013-12-25 17:16:05 +01:00
#include "libavutil/version.h"
lavf: move the version macros to a new header Signed-off-by: Mans Rullgard <mans@mansr.com> (cherry picked from commit 50196a982bf7c8be9b41053fa0975473c217e709)
2011-01-21 20:18:06 +01:00
Bump major versions of all libraries.
2014-08-06 21:57:14 +02:00
#define LIBAVFORMAT_VERSION_MAJOR 56
lavf: add AVFormatContext/AVStream fields for signaling to the user when events happen. The only flags, for now, indicate if metadata was updated and are set after each call to av_read_frame(). This comes with the caveat that, on stream start, it might not be set properly as packets might be buffered in AVFormatContext.packet_buffer before being given to the user in av_read_frame(). Signed-off-by: Anton Khirnov <anton@khirnov.net>
2014-08-08 19:09:23 +02:00
#define LIBAVFORMAT_VERSION_MINOR 1
lavf/mpegts: rename ff_mpegts_parse_*() to avpriv_mpegts_parse_*() The were wrongly being exported and used by libavdevice Signed-off-by: James Almer <jamrial@gmail.com> Signed-off-by: Michael Niedermayer <michaelni@gmx.at>
2014-08-07 01:59:56 +02:00
#define LIBAVFORMAT_VERSION_MICRO 100
lavf: move the version macros to a new header Signed-off-by: Mans Rullgard <mans@mansr.com> (cherry picked from commit 50196a982bf7c8be9b41053fa0975473c217e709)
2011-01-21 20:18:06 +01:00
#define LIBAVFORMAT_VERSION_INT AV_VERSION_INT(LIBAVFORMAT_VERSION_MAJOR, \
LIBAVFORMAT_VERSION_MINOR, \
LIBAVFORMAT_VERSION_MICRO)
#define LIBAVFORMAT_VERSION AV_VERSION(LIBAVFORMAT_VERSION_MAJOR, \
LIBAVFORMAT_VERSION_MINOR, \
LIBAVFORMAT_VERSION_MICRO)
#define LIBAVFORMAT_BUILD LIBAVFORMAT_VERSION_INT
#define LIBAVFORMAT_IDENT "Lavf" AV_STRINGIFY(LIBAVFORMAT_VERSION)
/**
Clarify Doxygen comment for FF_API_* #defines.
2012-07-03 22:42:42 +02:00
* FF_API_* defines may be placed below to indicate public API that will be
* dropped at a future version bump. The defines themselves are not part of
* the public API and may change, break or disappear at any time.
lavf: move the version macros to a new header Signed-off-by: Mans Rullgard <mans@mansr.com> (cherry picked from commit 50196a982bf7c8be9b41053fa0975473c217e709)
2011-01-21 20:18:06 +01:00
*/
lavf: add AVFMT_FLAG_BITEXACT. Use it instead of checking CODEC_FLAG_BITEXACT in the first stream's codec context. Using codec options inside lavf is fragile and can easily break when the muxing codec context is not the encoding context.
2014-05-01 10:43:10 +02:00
#ifndef FF_API_LAVF_BITEXACT
Postpone API-incompatible changes until the next bump.
2014-08-06 21:47:54 +02:00
#define FF_API_LAVF_BITEXACT (LIBAVFORMAT_VERSION_MAJOR < 57)
lavf: add AVFMT_FLAG_BITEXACT. Use it instead of checking CODEC_FLAG_BITEXACT in the first stream's codec context. Using codec options inside lavf is fragile and can easily break when the muxing codec context is not the encoding context.
2014-05-01 10:43:10 +02:00
#endif
lavf: deprecate now unused AVStream.pts
2014-05-18 12:36:00 +02:00
#ifndef FF_API_LAVF_FRAC
#define FF_API_LAVF_FRAC (LIBAVFORMAT_VERSION_MAJOR < 57)
#endif
lavf: switch to AVStream.time_base as the hint for the muxer timebase Previously, AVStream.codec.time_base was used for that purpose, which was quite confusing for the callers. This change also opens the path for removing AVStream.codec. The change in the lavf-mkv test is due to the native timebase (1/1000) being used instead of the default one (1/90000), so the packets are now sent to the crc muxer in the same order in which they are demuxed (previously some of them got reordered because of inexact timestamp conversion).
2014-05-18 12:12:59 +02:00
#ifndef FF_API_LAVF_CODEC_TB
#define FF_API_LAVF_CODEC_TB (LIBAVFORMAT_VERSION_MAJOR < 57)
lavf/avio: rename url_feof() to avio_feof() It's a public function and should use the avio_ namespace Signed-off-by: James Almer <jamrial@gmail.com> Signed-off-by: Michael Niedermayer <michaelni@gmx.at>
2014-08-07 22:12:40 +02:00
#endif
#ifndef FF_API_URL_FEOF
#define FF_API_URL_FEOF (LIBAVFORMAT_VERSION_MAJOR < 57)
lavf: switch to AVStream.time_base as the hint for the muxer timebase Previously, AVStream.codec.time_base was used for that purpose, which was quite confusing for the callers. This change also opens the path for removing AVStream.codec. The change in the lavf-mkv test is due to the native timebase (1/1000) being used instead of the default one (1/90000), so the packets are now sent to the crc muxer in the same order in which they are demuxed (previously some of them got reordered because of inexact timestamp conversion).
2014-05-18 12:12:59 +02:00
#endif
Clarify Doxygen comment for FF_API_* #defines.
2012-07-03 22:42:42 +02:00
lavf: deprecate avformat_alloc_output_context() in favor of avformat_alloc_output_context2() The new function accepts a slightly more intuitive order of paramters, and returns an error code, thus allowing applications to report a meaningful error message.
2011-05-19 22:09:34 +02:00
#ifndef FF_API_ALLOC_OUTPUT_CONTEXT
avformat: postpone API removials where the functions are trivial wrapers Signed-off-by: Michael Niedermayer <michaelni@gmx.at>
2013-03-13 12:43:02 +01:00
#define FF_API_ALLOC_OUTPUT_CONTEXT (LIBAVFORMAT_VERSION_MAJOR < 56)
lavf: deprecate avformat_alloc_output_context() in favor of avformat_alloc_output_context2() The new function accepts a slightly more intuitive order of paramters, and returns an error code, thus allowing applications to report a meaningful error message.
2011-05-19 22:09:34 +02:00
#endif
mpegts: add compute_pcr option. Deprecate the corresponding AVFormatParameters field.
2011-04-30 13:42:55 +02:00
#ifndef FF_API_FORMAT_PARAMETERS
avformat: postpone API removials where the functions are trivial wrapers Signed-off-by: Michael Niedermayer <michaelni@gmx.at>
2013-03-13 12:43:02 +01:00
#define FF_API_FORMAT_PARAMETERS (LIBAVFORMAT_VERSION_MAJOR < 56)
rtsp: Accept options via private avoptions instead of URL options Eventually, the old way of passing options by adding stuff to the URL can be dropped. This avoids having to tamper with the user-specified URL to pass options on the transport mode. This also works better with redirects, since the options don't need to be parsed out from the URL. Signed-off-by: Martin Storsjö <martin@martin.st>
2011-06-24 00:49:09 +02:00
#endif
lavf: add avformat_new_stream as a replacement for av_new_stream. It takes a codec parameter, thus enabling codec-specific defaults.
2011-06-18 11:19:27 +02:00
#ifndef FF_API_NEW_STREAM
avformat: postpone API removials where the functions are trivial wrapers Signed-off-by: Michael Niedermayer <michaelni@gmx.at>
2013-03-13 12:43:02 +01:00
#define FF_API_NEW_STREAM (LIBAVFORMAT_VERSION_MAJOR < 56)
avio: Mark the old interrupt callback mechanism as deprecated Prepare for removing it at an upcoming major bump.
2011-11-07 11:17:50 +01:00
#endif
lavf: make av_set_pts_info private. It's supposed to be called only from (de)muxers.
2011-11-29 19:28:15 +01:00
#ifndef FF_API_SET_PTS_INFO
avformat: postpone API removials where the functions are trivial wrapers Signed-off-by: Michael Niedermayer <michaelni@gmx.at>
2013-03-13 12:43:02 +01:00
#define FF_API_SET_PTS_INFO (LIBAVFORMAT_VERSION_MAJOR < 56)
lavf: make av_set_pts_info private. It's supposed to be called only from (de)muxers.
2011-11-29 19:28:15 +01:00
#endif
lavf: add avformat_close_input(). It sets the supplied AVFormatContext pointer to NULL after freeing it, which is safer and its name is consistent with other lavf functions. Also deprecate av_close_input_file().
2011-12-11 10:34:08 +01:00
#ifndef FF_API_CLOSE_INPUT_FILE
Merge commit '0a7c4daf469d4ac447fb822fe78337f62f4c04e6' * commit '0a7c4daf469d4ac447fb822fe78337f62f4c04e6': lavf: remove disabled FF_API_CLOSE_INPUT_FILE cruft Conflicts: libavformat/version.h removial postponed as the wraper code is trivial Merged-by: Michael Niedermayer <michaelni@gmx.at>
2013-03-13 12:12:06 +01:00
#define FF_API_CLOSE_INPUT_FILE (LIBAVFORMAT_VERSION_MAJOR < 56)
lavf: add avformat_close_input(). It sets the supplied AVFormatContext pointer to NULL after freeing it, which is safer and its name is consistent with other lavf functions. Also deprecate av_close_input_file().
2011-12-11 10:34:08 +01:00
#endif
lavf: deprecate av_read_packet(). The caller can achieve the same effect (i.e. getting raw unparsed/mangled packets) with av_read_frame() and AVFMT_FLAG_NOPARSE | AVFMT_FLAG_NOFILLIN
2012-03-04 21:41:59 +01:00
#ifndef FF_API_READ_PACKET
Merge commit '435c2a31ad5eead20eda1152097f60c3bfa22847' * commit '435c2a31ad5eead20eda1152097f60c3bfa22847': lavf: remove disabled FF_API_READ_PACKET cruft Conflicts: libavformat/version.h Removial postponed as wraper is trivial Merged-by: Michael Niedermayer <michaelni@gmx.at>
2013-03-13 12:29:26 +01:00
#define FF_API_READ_PACKET (LIBAVFORMAT_VERSION_MAJOR < 56)
lavf: deprecate av_read_packet(). The caller can achieve the same effect (i.e. getting raw unparsed/mangled packets) with av_read_frame() and AVFMT_FLAG_NOPARSE | AVFMT_FLAG_NOFILLIN
2012-03-04 21:41:59 +01:00
#endif
subtitles: introduce ASS codec id and use it. Currently, we have a AV_CODEC_ID_SSA, which matches the way the ASS/SSA markup is muxed in a standalone .ass/.ssa file. This means the AVPacket data starts with a "Dialogue:" string, followed by a timing information (start and end of the event as string) and a trailing CRLF after each line. One packet can contain several lines. We'll refer to this layout as "SSA" or "SSA lines". In matroska, this markup is not stored as such: it has no "Dialogue:" prefix, it contains a ReadOrder field, the timing information is not in the payload, and it doesn't contain the trailing CRLF. See [1] for more info. We'll refer to this layout as "ASS". Since we have only one common codec for both formats, the matroska demuxer is constructing an AVPacket following the "SSA lines" format. This causes several problems, so it was decided to change this into clean ASS packets. Some insight about what is changed or unchanged in this commit: CODECS ------ - the decoding process still writes "SSA lines" markup inside the ass fields of the subtitles rectangles (sub->rects[n]->ass), which is still the current common way of representing decoded subtitles markup. It is meant to change later. - new ASS codec id: AV_CODEC_ID_ASS (which is different from the legacy AV_CODEC_ID_SSA) - lavc/assdec: the "ass" decoder is renamed into "ssa" (instead of "ass") for consistency with the codec id and allows to add a real ass decoder. This ass decoder receives clean ASS lines (so it starts with a ReadOrder, is followed by the Layer, etc). We make sure this is decoded properly in a new ass-line rectangle of the decoded subtitles (the ssa decoder OTOH is doing a simple straightforward copy). Using the packet timing instead of data string makes sure the ass-line now contains the appropriate timing. - lavc/assenc: just like the ass decoder, the "ssa" encoder is renamed into "ssa" (instead of "ass") for consistency with the codec id, and allows to add a real "ass" encoder. One important thing about this encoder is that it only supports one ass rectangle: we could have put several dialogue events in the AVPacket (separated by a \0 for instance) but this would have cause trouble for the muxer which needs not only the start time, but also the duration: typically, you have merged events with the same start time (stored in the AVPacket->pts) but a different duration. At the moment, only the matroska do the merge with the SSA-line codec. We will need to make sure all the decoders in the future can't add more than one rectangle (and only one Dialogue line in it obviously). FORMATS ------- - lavf/assenc: the .ass/.ssa muxer can take both SSA and ASS packets. In the case of ASS packets as input, it adds the timing based on the AVPacket pts and duration, and mux it with "Dialogue:", trailing CRLF, etc. - lavf/assdec: unchanged; it currently still only outputs SSA-lines packets. - lavf/mkv: the demuxer can now output ASS packets without the need of any "SSA-lines" reconstruction hack. It will become the default at next libavformat bump, and the SSA support will be dropped from the demuxer. The muxer can take ASS packets since it's muxed normally, and still supports the old SSA packets. All the SSA support and hacks in Matroska code will be dropped at next lavf bump. [1]: http://www.matroska.org/technical/specs/subtitles/ssa.html
2013-01-03 03:06:43 +01:00
#ifndef FF_API_ASS_SSA
#define FF_API_ASS_SSA (LIBAVFORMAT_VERSION_MAJOR < 56)
#endif
lavf: deprecate r_frame_rate. According to its description, it is supposed to be the LCM of all the frame durations. The usability of such a thing is vanishingly small, especially since we cannot determine it with any amount of reliability. Therefore get rid of it after the next bump. Replace it with the average framerate where it makes sense. FATE results for the wtv and xmv demux tests change. In the wtv case this is caused by the file being corrupted (or possibly badly cut) and containing invalid timestamps. This results in lavf estimating the framerate wrong and making up wrong frame durations. In the xmv case the file contains pts jumps, so again the estimated framerate is far from anything sane and lavf again makes up different frame durations. In some other tests lavf starts making up frame durations from different frame.
2012-06-26 13:10:01 +02:00
#ifndef FF_API_R_FRAME_RATE
Merge commit 'd8b31be6caebd8d1321ecb754b6e7daaf81dc111' * commit 'd8b31be6caebd8d1321ecb754b6e7daaf81dc111': Add the bumps and APIchanges entries for reference counted buffers changes. Conflicts: Changelog doc/APIchanges libavcodec/version.h libavdevice/version.h libavfilter/version.h libavformat/version.h Merged-by: Michael Niedermayer <michaelni@gmx.at>
2013-03-12 15:29:20 +01:00
#define FF_API_R_FRAME_RATE 1
lavf: deprecate r_frame_rate. According to its description, it is supposed to be the LCM of all the frame durations. The usability of such a thing is vanishingly small, especially since we cannot determine it with any amount of reliability. Therefore get rid of it after the next bump. Replace it with the average framerate where it makes sense. FATE results for the wtv and xmv demux tests change. In the wtv case this is caused by the file being corrupted (or possibly badly cut) and containing invalid timestamps. This results in lavf estimating the framerate wrong and making up wrong frame durations. In the xmv case the file contains pts jumps, so again the estimated framerate is far from anything sane and lavf again makes up different frame durations. In some other tests lavf starts making up frame durations from different frame.
2012-06-26 13:10:01 +02:00
#endif
multiple inclusion guard cleanup Add missing multiple inclusion guards; clean up #endif comments; add missing library prefixes; keep guard names consistent.
2011-05-17 16:58:04 +02:00
#endif /* AVFORMAT_VERSION_H */
Reference in New Issue Copy Permalink