NEWS

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

Version 0.6.2

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

* 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

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


Version 0.2.2

* 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

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


Version 0.1.1

* Minor modifications and bug fixes from the previous release. Better
  ffmpeg/avformat integration and more reliable playback.


Version 0.1.0

* First official release