DVDBuilder for C++  3.4
DVD Authoring Software Development Kit
Release Notes 
DVDBuilder SDK for C++ Release Notes

---------------
OS Requirements
---------------

* Windows 7 SP1 and above

--------------------
Runtime Dependencies
--------------------
None

-----------------
Demo Restrictions
-----------------

The following restrictions exist when operating in demo mode:

* Title length is limited to 5 minutes.

These restrictions are removed when a valid license is passed to the Library.


Release Notes - DVDBuilder - Version 3.4 (12 Nov 2017)
======================================================

** User Story
    * [DVDB-113] - subpicturePalette color indexes should be zero based
    * [DVDB-114] - Update AVBlocks to 2.3.0
    * [DVDB-115] - Update PrimoBurner to 4.7.1


Release Notes - DVDBuilder - Version 3.3.1 (14 Mar 2016)
========================================================

** Technical Story
    * [DVDB-112] - Update bundled AVBlocks to 1.26 and PrimoBurner to 4.6.1


Release Notes - DVDBuilder - Version 3.3.0 (23 Jan 2016)
========================================================

** Improvement
    * [DVDB-108] - Samples: Windows: Upgrade sample projects to Visual Studio 2015
    * [DVDB-109] - Samples: Windows: Deprecate the CLR2 .NET projects
    * [DVDB-110] - Update AVBlocks to 1.25
    * [DVDB-111] - Update PrimoBurner to 4.6


Release Notes - DVDBuilder - Version 3.2.1 (30 May 2015)
========================================================

** Improvement
    * [DVDB-81] - Samples: C++: Put the AVBlocks and PrimoBurner headers in the `include` directory
    * [DVDB-82] - Samples: Add the Slideshow sample to the .NET package
    * [DVDB-83] - Samples: Add README.md for all samples
    * [DVDB-85] - Update AVBlocks to 1.18
    * [DVDB-86] - Update PrimoBurner to 4.4.2
    * [DVDB-94] - Docs: Clarify the documentation of UnexpectedBitmapColor error
    * [DVDB-96] - Docs: Improve the documentation of the <menu> element
    * [DVDB-99] - Samples: Rename the DVDAuthorCmd sample to BuildDvd
    * [DVDB-100] - Samples: Rename the VideoDVDCreator sample to VideoToDvd
    * [DVDB-102] - Samples: Rename the VideoRecorder sample to CameraToDVD
    * [DVDB-103] - Docs: Update the <display> element documentation

** Bug
    * [DVDB-87] - Unable to find an entry point named 'DVDBuilder_setProject' in DLL 'DVDBuilder64.dll'.
    * [DVDB-90] - Docs: DVD Project: The Description, Remarks, and Example sections are not visible for some XML elements
    * [DVDB-91] - Hang when using callback and InputDataStreamFactory, and Stream.Read returns -1
    * [DVDB-93] - Docs: The <menu> docs suggest that hex numbers can be used for xyzContrast attribute values.


Release Notes - DVDBuilder - Version 3.2.0 (10 Feb 2015)
========================================================

** New Feature
    * [DVDB-68] - Ability to specify a file, or audio and video streams per <chapter> element

** Improvement
    * [DVDB-67] - Docs: Document the way DVDBuilder rounds and handles chapter times
    * [DVDB-72] - Samples: VideoDVDCreator: Accept all file types that AVBlocks can handle as input
    * [DVDB-75] - Update AVBlocks to version 1.16
    * [DVDB-76] - Update PrimoBurner to version 4.4.1

** Bug
    * [DVDB-78] - .NET: ErrorFacility enum has the wrong values for Mac and POSIX subsystems


Release Notes - DVDBuilder - Version 3.1.0 (22 Nov 2014)
========================================================

** Improvement
    * [DVDB-50] - Allow to set chapter pauses in the DVD project
    * [DVDB-57] - C++, Replace DataStream with primo::Stream

** Bug
    * [DVDB-47] - VideoRecorder sample threads race condition
    * [DVDB-48] - Audio / Video sync issues when converting from 30fps to 25fps


Release Notes - DVDBuilder - Version 3.0.1
==========================================

** New Feature
    * [DVDB-3] - New C++ API
    * [DVDB-12] - Integrate the new licensing into DVDB

** Improvement
    * [DVDB-38] - C++: Windows: Digitally sign DLLs

** Bug
    * [DVDB-32] - The relative audio/video delay is not preserved in the output.


Release Notes - DVDBuilder 2 - Version 2.2.3
============================================

** Bug
    * [OLDDVDB-32] - Windows: C++: Binaries are not signed with Microsoft Authenticode.

** Improvement
    * [OLDDVDB-33] - Update PrimoBurner to 3.6.12


Release Notes - DVDBuilder 2 - Version 2.2.2
============================================

** Improvement
    * [OLDDVDB-29] - C++: Deprecate Visual Studio 2008
    * [OLDDVDB-30] - Update PrimoMpeg to 1.1.3
    * [OLDDVDB-31] - Update PrimoBurner to 3.6.10

** Bug
    * [OLDDVDB-21] - The sample VideoDVDCreator does not work with paths containing XML special chars.
    * [OLDDVDB-24] - The relative audio/video delay is not preserved in the output.
    * [OLDDVDB-26] - Audio / Video sync issues when converting from 30fps to 25fps


-------------
Version 2.2.1
-------------

Breaking Changes
----------------

* When an optical device is created (IVRDevicePlugin::CreateOpticalDiscDevice) it must be explicitly specified whether an exclusive access is required.
Prior to v2.2.1 an exclusive access was always assumed. It is recommended to use exclusive access when a device is used for recording.
Otherwise, when a device is simply queried non-exclusive access is preferred.

* ANSI support is dropped, only Unicode (UTF-16) is supported.

* DVDBuilderU.dll and DVDBuilder64U.dll are renamed to DVDBuilder.dll and DVDBuilder64.dll respectively (the 'U' suffix is dropped).
  Similarly PrimoMpegU.dll and PrimoMpeg64U.dll are renamed to PrimoMpeg.dll and PrimoMpeg64.dll in the helper PrimoMpeg SDK.
  You have to link against the renamed libs.

* The Video recorder plugins (VRPBDevice and VRFSDevice) are renamed in the same way - the 'U' suffix is dropped.
  You have to update the plugin names passed to IVideoRecorder::LoadDevicePlugin.

New
----

* OLDDVDB-7: Online Documentation. Local help files are no longer distributed.
* OLDDVDB-8: Add functionality to turn on/off the trace log in the VideoRecorder optical device plugin (VRPBDevice). See IVRDevicePlugin::EnableTraceLog.
* OLDDVDB-9: Allow to create a device with non-exclusive access from the VideoRecorder optical device plugin (VRPBDevice).

Fixed
-----

* OLDDVDB-6: Video recording fails on HL-DT-ST, DVD-RAM GH15L when IVideoRecorder::Stop is called.
* OLDDVDB-10: Make sure that VideoRecorder writes only to aligned addresses when recording to optical device.


-------------
Version 2.1.3
-------------

New
----

* 1925: Letterbox and PanScan display mode support (16:9 menus on 4:3 screen)
* 1926: 23.976fps videos with 3:2 pulldown support

Fixed
-----

* 2069: VideoDVDCreator fails to decode WMV files on some machines
* 2070: VideoDVDCreator fails to decode multiple bitrate (MBR) WMV files
* 2100: Cannot transcode H264 stream contained in MPEG2-PS


-------------
Version 2.1.2
-------------

New
----

* 1775: Added VM commands support.


-------------
Version 2.1.1
-------------

New
----

* 1761: Added support for subpicture encoding from STL files.
* 1762: Elementary audio/video streams can be used as input to DVDBuilder


-------------
Version 2.0.8
-------------

New
---

* 1683: Added VideoDVDCreator sample


-------------
Version 2.0.7
-------------

New
---

* 1615: Add DVDB version to IFO developer ID string
* 1610: Update DVDBuilder to use PrimoMpeg 1.0.6

Fixed
-----

* 1612: VideoRecorder x64 sample does not start
* 1611: IVideoRecorder::Write could fail with multiplexer error on a valid MPEG-2 stream.


-------------
Version 2.0.6
-------------

Fixed
-----

* 1545	Ambiguous system error returned by DVDBuilder
* 1519	Handle bitmap color table for 8-bit bitmaps
* 1517	Support MPEG2 files without sequence end code

-------------
Version 2.0.5
-------------

Breaking Changes
----------------

As of 2.0.5 you will need to reference the primo::dvdbuilder namespace explicitly in your code. To do that insert a "using namespace primo::dvdbuilder;" statement immediately after the inclusion of DVDBuilder.h, e.g.

#include "DVDBuilder.h"
using namespace primo::dvdbuilder;

New
---

* 1496: DVDBuilder output successfully passes DVD-Video compatibility tests
* 1495: Added AllowMuxBufferUnderflow property to IVideoRecorder
* 1461: VideoRecorder can now record DVD-video to Blu-ray Disc
* 1439: VideoRecorder optical plug-in now uses PrimoBurner 3.0.4


-------------
Version 2.0.4
-------------

New
---

* Ability to record MPEG-2 PS stream to optical disc (DVD-R, DVD+R, DVD-RW, DVD+RW, DVD-RAM) in real-time.

* The IDVDBuilder interface provides detailed error codes and hints when a DVD authoring project fails to build.


--------------
Version 1.14.0
--------------

New
---

* <videoObject> XML Element: Added 'aspectRatio', 'resolution' and 'frameRate' attributes. This feature should be used with caution. It was added to allow input from encoders which generate wrong MPEG-2 headers.

* <title> XML Element: The 'postNavigate' attribute is now able to reference titles from different title sets. This allows navigation across title sets.

* Ability to map MPEG audio and subtitle streams to DVD language codes.

* Ability to read video object data from a stream provided by the application. To use this functionality your application must implement the IDataStream and IInputDataStreamFactory interfaces.