MLT Release Notes
-----------------
-Version 0.3.2
+Version 0.9.0 - June 2, 2013
+
+This is a significant enhancement release.
+
+Build (especially interesting for Linux packagers)
+ * Added --rename-melt and --enable-extra-versioning configure options.
+ * Added symbol versioning on Linux.
+
+Framework
+ * Improved pause behavior when using buffered rendering in mlt_consumer.
+ * Added mlt_animation API (exposed via Mlt::Properties in C++).
+ * Added mlt_rect and mlt_color types.
+ * Deprecated mlt_geometry API.
+
+Modules
+ * Support for the latest versions of FFmpeg and Libav (but dropping support
+ for 0.5 and 0.6 versions).
+ * Added alpha channel output to avformat consumer.
+ * Added reconnect and exit_on_disconnect properties to avformat producer.
+ * Added opengl module that uses Movit for GLSL image processing.
+ * Added qglsl consumer to use opengl with avformat, sdi, and decklink.
+ * Added avsync module with blipflash producer and consumer for testing.
+ * Added new "count" producer to gtk2 module.
+ * Changed frei0r to use index-based property names making it impervious to
+ param name changes (param name still accepted for compatibility).
+ * Added default parameter values to frei0r metadata.
+
+Other
+ * Added more python example web services.
+ * Added the beginnings of unit test suite.
+
+
+Version 0.8.8 - January 20, 2013
+
+This is purely a bugfix release. See the ChangeLog or git log.
+
+
+Version 0.8.6 - November 14, 2012
+
+This is a re-issue of the 0.8.4 release with a fix for a performance
+regression on videos that use full-range colorspaces such as yuv420p.
+
+Version 0.8.4 - November 13, 2012
+
+This is a bugfix and minor enhancement release.
+
+* Added playlist-next event and PlaylistNextListener to Ruby binding
+* FFmpeg 1.0 and libAV master compatibility
+* Improvements to motion_est filter to generate keyframes for apps
+* Added audiolevel (measurement) filter
+
+
+Version 0.8.2 - August 28, 2012
+
+This is a bugfix and minor enhancement release.
+
+* Overhaul of A/V sync with libavformat-based inputs.
+* Fix a major memory leak introduced in previous release.
+* Fixes to problems revealed by Coverity Scan static analysis.
+* Improved encoding presets.
+* melt can now be built without SDL with define MELT_NOSDL, which is handy
+ for running it as a child process on Windows and OS X.
+* melt can now be signaled to quit, which also makes it more useful as a
+ child process.
+
+Special thanks to Mikko Rapeli who provided many of the Coverity fixes.
+
+
+Version 0.8.0 - June 1, 2012
+
+The minor version is increased due to the addition of time properties!
+The soname version increased in the process because some mlt_property
+functions changed; however, very few if any apps actually directly use
+mlt_property preferring to use mlt_properties instead. In addition:
+
+* improve seek speed on AVCHD when using FFmpeg v0.9.1+ (NOT Libav!)
+* composite and dissolve speed improvements on x86-64
+* improve performance of caching in image producers
+* add device enumeration to decklink producer and consumer
+
+Special thanks go to contributors Maksym Veremeyenko and Ed Rogalsky.
+
+
+Version 0.7.8 - February 13, 2012
+
+This is a bugfix and minor enhancement release.
+
+* Improved support for v53 of libavcodec/libavformat
+* Added "multi" consumer - multiple, simultanous outputs
+* Added framerate adaption to "consumer" producer and "multi" consumer
+* Can now use YADIF deinterlacer with decklink producer
+* Added "rtaudio" consumer for native audio support on multiple platforms
+* Added ability to request image format closest to source (mlt_image_none)
+* Added more audio formats
+* Added vqm (video quality measurement) transition
+
+
+Version 0.7.6 - October 31, 2011
+
+This is a bugfix and minor enhancement release.
+
+ * Improved support for v53 of libavcodec/libavformat (0.7 and 0.8 releases)
+ * Major DeckLink consumer improvements
+ * Much more metadata
+ * Added audio-only JACK consumer
+ * Added video stabilization filters
+ * Added dual pass audio normalization to sox filter
+ * Added VITC and VANC capture to DeckLink producer
+ * Added support for writing timecode tracks
+ * Added MLT, frei0r, and SoX version to xml serialization
+ * Added D-10, XDCAM, DNxHD, and Sony-PSP encoding presets
+ * Can now use rotoscoping for masking filters
+ * Added dynamictext filter makes burned-in timecode and similar easier
+ * Added support for consumer element in MLT XML
+ * Added outlining, padding, and alignment to pango filter
+
+Special thanks go to contributors Maksym Veremeyenko, Brian Matherly, and
+Marco Gittler.
+
+
+Version 0.7.4 - July 16, 2011
+
+This is a bugfix and minor enhancement release.
+
+Framework
+ * Important: change consumer property profile to mlt_profile.
+ * Improve frame-dropping and drop_max property to mlt_consumer.
+ * Added support for presets for any service through special property named
+ "properties"
+ * Added mlt_profile_from_producer() for auto-profile.
+ * Added mlt_properties_set_lcnumeric() and mlt_properties_get_lcnumeric().
+ * Added LC_NUMERIC to YAML Tiny metadata schema and parser.
+
+Modules
+ * Added support for more than 2 channels of greater than 16-bit audio.
+ * Added discrete filters for each SoX effect.
+ * Added discrete filters for each LADSPA audio plugin.
+ * Added automatic service metadata for SoX and LADSPA plugins.
+ * Added at least basic metadata for nearly every service.
+ * Added support for decklink on Windows (tested) and Mac OS X (untested).
+ * Added support for JACK transport synchronization.
+ * Added blacklist.txt to jackrack plugin (contains dssi-vst).
+ * Rewrite of decklink consumer.
+ * Added support for live network, multi-stream device, and pipe/fifo sources
+ in avformat producer.
+ * Added LC_NUMERIC attribute to root XML element.
+
+Melt
+ * Added '-query presets' option.
+ * Added -jack option for transport synchronization.
+ * Send -help and -query output to stdout to make it convenient for pagers.
+
+Other
+ * Added mlt.Frame.get_image() for Python.
+ * Removed configure option --avformat-svn.
+ * Fixes for locales that use comma for decimal point.
+ * Added presets for DVD, DV, x264, and WebM encoding.
+
+Since FFmpeg forked and there were a few releases, there is no recommended
+version at this time. With that said, there were changes to accomodate the
+API changes with some moderate testing of the 0.6, 0.7, and 0.8 series
+releases of both FFmpeg and Libav.
+
+
+Version 0.7.2 - May 1, 2011
+
+This is a minor release to fix a few things between the 0.7.0 release
+and the release of Kdenlive 0.8. I recommend Kdenlive v0.8 users to
+upgrade to this version of Mlt. Beyond that there are some exciting
+additions to the Blackmagic Design DeckLink plugin!
+
+Framework
+ * Added mlt_profile_list().
+
+Modules
+ * Added decklink producer (i.e. capture, live encoding).
+ * Added keyer output for decklink consumer.
+ * Added AVOptions to the avformat service metadata.
+ * Added support for new major API versions (53) of FFmpeg.
+
+Melt
+ * Added '-query profile' option.
+ * Added '-query formats', '-query audio_codecs' and '-query video_codecs'.
+
+The recommended version of FFmpeg for use with this release is 0.6.1.
+
+
+Version 0.7.0 - March 27, 2011
+
+This is a major new release due to signficant additions to API, framework,
+and build.
+
+Build
+ * Added support for Windows via MinGW.
+ * Enabled linsys module by default.
+ * Disabled VDPAU by default and added --avformat-vdpau to enable it.
+ * Added support for swfdec 0.7.
+
+Framework:
+ * Added parallelism to mlt_consumer when 'real_time' > 1 or < -1.
+ * Added mlt_deque_insert() and mlt_deque_peek().
+ * Added mlt_profile parameter to mlt_producer_new().
+ * Let transitions with no out point run forever.
+ * Added mlt_frame_unique_properties().
+ * Added mlt_frame_set_image() and mlt_frame_set_alpha().
+ * Added mlt_image_format_size() and mlt_audio_format_size().
+ * Added mlt_filter_get_length() and mlt_transition_get_length().
+ * Added mlt_filter_get_progress(), mlt_transition_get_progress(),
+ and mlt_transition_get_progress_delta().
+ * Added mlt_filter_get_position() and mlt_transition_get_position().
+ * Added mlt_properties_lock() and mlt_properties_unlock().
+
+Modules
+ * Added rotoscoping filter.
+ * Improve libavdevice support (V4L2, ALSA, libdc1394).
+ * Added support for new FFmpeg metadata API.
+ * Various fixes, refactoring, and improvements.
+
+The recommended version of FFmpeg for use with this release is 0.6.1.
+
+
+Version 0.6.2 - January 23, 2011
+
+This is just a minor release to address a few things prior to introducing
+major changes from other branches.
+
+ * Added force_aspect_ratio property to pixbuf and qimage producers.
+ * Added opacity handling in geometry property of the affine filter and
+ transition.
+ * Added use_normalised property to affine filter.
+ * Added always_active property to affine transition.
+ * Fix building on NetBSD.
+
+The recommended version of FFmpeg for use with this release is 0.6.1.
+
+
+Version 0.6.0 - January 1, 2011
+
+The recommended version of FFmpeg for use with this release is 0.6.1.
+There were quite a few enhancements and changes including a minor interface
+change. Therefore, this release gets a jump in the versioning.
+
+Framework
+ * mlt_profile
+ - Added (Y'CbCr) colorspace attribute.
+ - Added mlt_profile_clone().
+ * Added mlt_consumer_position() and Mlt::Consumer::position().
+ * Added Mlt::Properties::wait_for(string).
+ * Added a version API: mlt_version_get_int() and others.
+ * Added Mlt::Producer::pause().
+ * Added mlt_frame_write_ppm() for debugging.
+
+Melt
+ * Added automatic detection of profile from first input when profile
+ not specified.
+ * Now exits with error result when consumer fails fatally.
+
+Modules
+ * Added swfdec producer for Flash files including variables support.
+ (Does not support audio.)
+ * Added consumer for Blackmagic Design DeckLink SDI and Intensity HDMI.
+ * Added Y'CbCr colorspace conversion and option to use full luma range.
+ * Added (de)serialization of profile to XML.
+ * Added support for #frame# variable to the data_show filter.
+ * Added support for frei0r string parameters.
+ * Make FFmpeg formats and codecs available as properties (not just stderr).
+ * Try to load .xml file as MLT XML.
+ * Added a consumer-sdl-paused event to sdl_preview.
+ * Added a consumer-fatal-error event to avformat.
+ * Change composite transition to default to progressive rendering; field-
+ based rendering available only explicitly.
+
+
+Version 0.5.10 - September 13, 2010
+
+This is a quick followup to the 0.5.8 release to address an issue I want to
+address immediately. I noticed an extra unconditional colorspace conversion
+to and from RGB was added for all YCbCr (YUV) video sources. In addition, I
+have enabled the avcolor_space filter on OS X since it works now.
+
+
+Version 0.5.8 - September 12, 2010
+
+The recommended version of FFmpeg for use with this release is 0.6.
+This is a maintenance release to address some bugs that appeared
+thus far in the 0.5.x series. Beyond that is a few enhancements:
+
+* Added EXIF-based auto-rotation of images to pixbuf and qimage producers.
+* Improved quality of libswscale-based image conversion and scaling.
+* Added channelswap and panner audio filters; panner also does balance.
+* Improve audio waveform and add audiowave video filter.
+* Enhanced luma filter to work with animated filters such as affine.
+* Automatically crop 8 bottom lines of 1088 source in a 16:9 project
+ (common in Canon EOS digital cameras).
+* Added support for inline images in kdenlivetitler.
+
+
+Version 0.5.6 - June 20, 2010
+
+The recommended version of FFmpeg for use with this release is 0.6.
+This is a maintenance release to address some bugs that appeared
+this far in the 0.5.x series. Beyond that it a few enhancements:
+
+* Added interpolation to the affine transition and filter.
+* Added multi-track audio encoding to avformat consumer.
+* Added interlaced field rendering to kdenlivetitle producer.
+
+
+Version 0.5.4 - April 19, 2010
+
+The recommended version of FFmpeg for use with this release is SVN r21322.
+This is another maintenance release to address some bugs that appeared
+this far in the 0.5.x series. Beyond that it adds two things that only
+very specific users will see:
+
+* Added C# (ECMA CLR) binding (not enabled by default).
+* Linsys SDI consumer now configures itself from MLT profile.
+
+
+Version 0.5.2 - March 10, 2010
+
+The recommended version of FFmpeg for use with this release is SVN r21322.
+This is a minor maintenance release, but it is interesting because it now
+enables usage of libswscale as the default choice for image scaling,
+image format conversion, and color space conversion. That gives better
+quality and performance. In addition, there are some improvements in the
+sdl_preview consumer to make it suitable for use in OpenShot 1.1. Other
+things:
+
+* Fixed mlt++/MltFilteredProducer
+* Fixed playing to the end in Kdenlive (mantis bug 1207)
+* Fixed crash load uncompressed video
+* Fixed compiling yadif for non-sse2 builds
+
+
+Version 0.5.0 - February 15, 2010
+
+The recommended version of FFmpeg for use with this release is SVN r21322.
+This is an enhancement release, confined mainly to the modules rather than
+the framework. In particular, this adds support for VDPAU, YADIF, and HD-SDI
+technologies!
+
+configure: added --disable-sse2
+
+framework:
+* mlt_cache: added mlt_cache_set_size()
+* mlt_filter: added data property "service" - set when attached
+* mlt_frame:
+ - added Doxygen docs
+ - added "previous frame" and "next frame" data properties - available
+ when its producer has _need_previous_next=1
+* mlt_playlist: added support for negative out point same as length-1
+* mlt_service:
+ - added mlt_service_cache_purge()
+ - added "_need_previous_next" handling in mlt_service_get_frame()
+ - added firing event "service-changed" in mlt_service_attach()
+
+modules:
+* avformat producer:
+ - added decoding H.264 with NVIDIA VDPAU
+ Requires FFmpeg built with vdpau.
+ This is automatically detected and enabled. You can disable this by
+ setting environment variable MLT_NO_VDPAU=1 or property novdpau=1.
+ - added caching of FFmpeg contexts and decoded images
+ This allows large numbers of clips in a project avoiding limitations
+ with number of threads and file descriptors permitted per process.
+ You can disable image caching with property noimagecache=1.
+ - added variant of producer named avformat-novalidate
+ - restored support for video4linux(2)
+* avformat consumer: added apre, fpre, and vpre preset properties
+* crop filter: added center_bias integer property
+* deinterlace filter: added the excellent YADIF as a method
+* kdenlivetitle producer: added text outlining
+* linsys/sdi consumer:
+ - added support for HD-SDI
+ - changed name from "linsys_sdi" to just "sdi"
+* oldfilm filter: added "uneven development" effect
+* xml producer: add support for unspecified out points
+
+profiles:
+* added several missing ATSC (HD) profiles
+* change descriptions from using Hz to fps
+
+
+Version 0.4.10 - December 8, 2009
+
+The recommended version of FFmpeg for use with this release is SVN r19873.
+This is "hotfix" for the 0.4.8 release that fixes a couple of regression
+bugs introduced just before the release.
+
+
+Version 0.4.8 - December 7, 2009
+
+The recommended version of FFmpeg for use with this release is SVN r19873.
+This is mainly a maintenance release. Besides bug fixes here are other
+notable changes.
+
+modules:
+* avformat producer:
+ - refactored producer to use much less properties
+ - added support for audio_index=all for linsys_sdi consumer
+ - added force_fps property (does yet not adjust duration)
+* core/crop: added "center" property to crop filter
+* linsys_sdi:
+ - added support for >2 audio channels
+ - added property meta.map.audio.<N>.channels=<integer>
+ - added property meta.map.audio.<N>.start=<integer>
+* qimage/kdenlivetitle: add typewriter effect
+
+
+Version 0.4.6 - October 7, 2009
+
+The recommended version of FFmpeg for use with this release is SVN r19873.
+This release is an enhancement release along with numerous build, A/V synch,
+concurrency, and other bug fixes.
+
+configure: new option --avformat-svn-version
+
+modules:
+* avformat: much improved seeking on H.264/MPEG2-TS (AVCHD) (Ivan Schreter)
+* core: new imageconvert and audioconvert filters (framework refactorization)
+* linsys: new SDI consumer (Broadcast Centre Europe)
+* qimage: new kdenlivetitle producer (J.B. Mardelle and Marco Gittler)
+* sdl: new audio_only consumer for OS X
+
+mlt++ and swig: update bindings
+
+framework:
+* refactored image format conversion
+ mlt_frame.h:
+ - added convert_image() virtual function
+ - added mlt_image_format_name()
+ - removed many mlt_convert_ and scaling/padding functions
+* refactored audio format conversion
+ mlt_frame.h:
+ - mlt_get_audio() virtual function parameters changed
+ - added convert_audio() virtual function
+ - mlt_frame_get_audio() parameters changed
+ - added mlt_frame_set_audio()
+ - added mlt_audio_format_name()
+ mlt_types.h:
+ - deprecated mlt_audio_pcm
+ - added mlt_audio_s16
+ - added mlt_audio_s32
+ - added mlt_audio_float
+
+
+Version 0.4.4 - June 30, 2009
+
+The recommended version of FFmpeg for use with this release is 0.5.0.
+This release is a minor maintenance update to the 0.4.2 - just build and
+bug fixes.
+
+* new configure script options:
+ --swig-languages
+ --rename-melt
+ --mandir
+ --datadir
+* added man page for melt (not installed)
+* added invert property to composite transition
+* added frei0r plugin blacklist, currently only contains facedetect
+* added Lua binding via SWIG
+
+
+Version 0.4.2 - May 30, 2009
+
+The recommended version of FFmpeg for use with this release is 0.5.0.
+This release is a minor maintenance update to the 0.4.0 - just build and
+bug fixes.
+
+
+Version 0.4.0 - May 17, 2009
+
+The recommended version of FFmpeg for use with this release is 0.5.0.
+
+This release is primarily a reorganization of the mlt and mlt++ projects.
+In brief:
+* "inigo" was renamed "melt"
+* "westley" is no longer the XML file extension and root element - they are
+ simply "mlt" now
+* mlt++ is included with mlt and no longer a separate project
+* miracle, valerie, and humperdink were moved to a new, separate project
+For details: http://www.mltframework.org/twiki/bin/view/MLT/ExtremeMakeover
+
+avformat producer improvements:
+* improve audio synchronization
+* improve reliability of video playback with FFmpeg newer than v0.5.0
+* improve seeking performance of DNxHD and HuffYUV
+
+
+Version 0.3.8 - April 15, 2009
+
+The recommended version of FFmpeg for use with this release is SVN r17923.
+
+This almost entirely a bugfix release to coincide with the Kdenlive 0.7.3
+release. See the ChangeLog (SVN log) for details.
+
+framework:
+* added mlt_cache API
+* improved doxygen documentation comments
+* added some 15 fps profiles
+* improved color property handling (support web-style '#' color value)
+* add const qualifier to many string parameters
+
+modules:
+* core: improved brightness filter
+* core: added image crop filter
+* frei0r: added support for producer/source plugins
+* frei0r: added support for color parameters
+* sdl: added window_background color property
+
+
+Version 0.3.6 - February 2, 2009
+
+The recommended version of FFmpeg for use with this release is SVN r16849.
+
+This almost entirely a bugfix release to coincide with the Kdenlive 0.7.2
+release. See the ChangeLog (SVN log) for details.
+
+framework:
+* added mlt_log logging API
+* improved doxygen documentation comments
+
+avformat module:
+* consumer: report list of muxers when f=list and codecs when acodec=list or
+ vcodec=list
+* consumer: added support for an=1 or acodec=none and vn=1 or vcodec=none
+* producer: list available demuxers and decoders when constructor arg is like
+ f-list[[,]acodec-list][[,]vcodec-list]
+
+
+Version 0.3.4 - December 29, 2008
+
+The recommended version of FFmpeg for use with this release is SVN r16313.
+
+This almost entirely a bugfix release. See the ChangeLog (SVN log) for details.
+There are a few notes:
+
+framework:
+* improved doxygen documentation comments (work in progress)
+ published docs are at http://mltframework.org/doxygen/
+
+avformat module:
+* added support for AVOption parsing to producer
+* added filter_swscale as alternative rescaler
+* added recommended FFmpeg revision to configure option --help
+* use recommended FFmpeg revision with --avformat-svn on release versions
+* added configure option --avformat-no-codecs
+* added configure option --avformat-no-filters
+
+misc:
+* new profile atsc_1080i_50
+* added --disable-sse option to configure script
+* improved build for OS X and x86-64 and improved handling of mmx/sse
+
+
+Version 0.3.2 - November 10, 2008
In addition to bug fixes detailed in the ChangeLog, here is a list of
enhancements.
* removed realtime process scheduling
-Version 0.3.0
+Version 0.3.0 - August 5, 2008
framework:
* fix bugs with introduction of mlt_profile in v0.2.4
* added -profile option and support for progress=1 for kdenlive
-Version 0.2.4
+Version 0.2.4 - August 4, 2007
* framework: new extensible profiles system to replace MLT_NORMALISATION
* module avformat: interlaced coding support for ffmpeg/libavcodec
* numerous bugfixes
-Version 0.2.3
+Version 0.2.3 - April 9, 2007
* Addition of kdenlive module
* Support for ffmpeg from subversion
* Copyright and license cleanup
-Version 0.2.2
+Version 0.2.2 - May 27, 2006
* Prepared specifically for the kdenlive 0.3 release.
* Contains some patches to support rgb24a output for the gdk-pixbuf and qimage
producers as well as some minor bugfixes.
-Version 0.2.1
+Version 0.2.1 - December 5, 2005
* Many improvements since initial releases due to development of Shotcut and
Jahshaka editing interfaces.
-Version 0.1.1
+Version 0.1.1 - June 9, 2004
* Minor modifications and bug fixes from the previous release. Better
ffmpeg/avformat integration and more reliable playback.
-Version 0.1.0
+Version 0.1.0 - May 6, 2004
* First official release
projects / mlt / blobdiff