add release notes for v0.8.2

[mlt] / NEWS

MLT Release Notes
-----------------

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.

framework:
* deprecated mlt-config; use pkg-config instead
* added more HD profiles

modules:
* sdl: added fullscreen property
* sox: sox v14.1.0 compatibility
* gtk: added force_reload property to producer_pixbuf
* frei0r: added support for YAML Tiny metadata
* frei0r: added keyframe support on double and boolean parameters
* oldfilm: added keyframe support for filter_vignette
* kdenlive: added filter_freeze

inigo:
* added -version, -silent, and -progress options
* improved output of usage information
* removed realtime process scheduling


Version 0.3.0 - August 5, 2008

framework:
* fix bugs with introduction of mlt_profile in v0.2.4
* added versioning to libs
* remove module registry and add dynamic module loading:
  added mlt_repository_register, mlt_repository_consumers,
  mlt_repository_filters, mlt_repository_producers, mlt_repository_transitions
* new module metadata system based on YAML Tiny:
  added mlt_repository_register_metadata, mlt_repository_metadata,
  mlt_repository_languages, mlt_properties_is_sequence,
  mlt_properties_parse_yaml, mlt_properties_serialise_yaml, and
  added metaschema.yaml Kwalify schema file
* mlt_consumer: added threaded, non-lossy processing when real_time=-1
* added autoclose property to mlt_playlist for sequential processing
  of very large playlists (prevents resource exhaustion)
* mlt_factory_init now returns the global mlt_repository
* change mlt_repository_fetch to mlt_repository_create
* change mlt_factory_prefix to mlt_factory_directory
* added mlt_field_disconnect_service

modules:
* move all modules from $datadir to $libdir
* new oldfilm module by Marco Gittler
* new frei0r module by Marco Gittler
* new dgraft module by Dan Dennedy for inverse telecine (not ready yet)
* avformat: added support for multi-threaded encoding and decoding
* consumer_avformat: added support for AVOption to support all ffmpeg options
  using ffmpeg-style property names
* consumer_avformat: added support for dual pass encoding
* qimage: added support for Qt4
* sox: added support for sox v14.0.0
* transition_composite: added animatable geometry-type "pan" property to crop
  and pan instead of automatic down-scale

inigo:
* added -query option to lookup module metadata
* added -profile option and support for progress=1 for kdenlive


Version 0.2.4 - August 4, 2007

* framework: new extensible profiles system to replace MLT_NORMALISATION
* module avformat: interlaced coding support for ffmpeg/libavcodec
* module avformat: build improvements for --avformat-svn
* new effectv module with BurningTV video filter
* module qimage: added support for psd, xcf and exr images
* numerous bugfixes


Version 0.2.3 - April 9, 2007

* Addition of kdenlive module
* Support for ffmpeg from subversion
* Support for ffmpeg libswscale
* Copyright and license cleanup


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 - December 5, 2005

* Many improvements since initial releases due to development of Shotcut and
  Jahshaka editing interfaces.


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 - May 6, 2004

* First official release