DVDBuilder for .NET  3.4
DVD Authoring Software Development Kit
Release Notes
DVDBuilder SDK for .NET Release Notes

-----------------------
OS / CLR Requirements
-----------------------

* DVDBuilder.clr4 - Windows 7 SP1 and above / CLR4 (.NET Framework 4.0/4.5)
* DVDBuilder.clr2 - Windows 7 SP1 and above / CLR2 (.NET Framework 2.0/3.0/3.5)

------------
Dependencies
------------
DVDBuilder.NET does not depend on the C/C++ runtime libraries.
However it uses DVDBuilder SDK for C++: either DVDBuilder.dll (x86) or DVDBuilder64.dll (x64).


-----------------
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-12] - Integrate the new licensing into DVDB
    * [DVDB-39] - .NET: Strong name assemblies

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


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

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


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

** 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


** Improvement
    * [OLDDVDB-30] - Update PrimoMpeg to 1.1.3
    * [OLDDVDB-31] - Update PrimoBurner to 3.6.10


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

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

* When an optical device is created (VRDevicePlugin.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.

* DVDBuilder.NET.2.0.dll, DVDBuilder.NET.3.0.dll and DVDBuilder.NET.3.5.dll are replaced by DVDBuilder.clr2.dll.
  You have to update your project references.

* The Video recorder plugins (VRPBDevice and VRFSDevice) are renamed: the 'U' suffix is dropped from the filename.
  You have to update the plugin names passed to VideoRecorder.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 VRDevicePlugin.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 VideoRecorder.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
----

* 2070: VideoDVDCreator fails to decode multiple bitrate (MBR) WMV files
* 2100: Cannot transcode H264 stream contained in MPEG2-PS
* 2157: VideoRecorder Sample: Invalid cross-thread operation (RecorderForm).

-------------
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: Added 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: VideoRecorder.Write could fail with multiplexer error on a valid MPEG-2 stream.


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

Fixed
-----

* 1545	Ambiguous system error returned by DVDBuilder
* 1534	Show system error message in DVDAuthorCmd.NET sample
* 1519	Handle bitmap color table for 8-bit bitmaps
* 1517	Support MPEG2 files without sequence end code
* 1509  Show the error hint in DVDAuthorCmd.NET

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

New
---

* 1496: DVDBuilder output successfully passes DVD-Video compatibility tests
* 1495: Added AllowMuxBufferUnderflow property to VideoRecorder
* 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 to optical disc (DVD-R, DVD+R, DVD-RW, DVD+RW, DVD-RAM) in real time.
* The DVDBuilder 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 ready video object data from a stream provided by the application. To use this functionality your application must implement the DataStream and InputDataStreamFactory interfaces.