by Deluxe Laboratories, Doremi Labs, CineCert LLC, Avica
Technology and others.
-**The asdcplib project was housed on SourceForge. The project
-has moved to http://www.cinecert.com/asdcplib/
+**The asdcplib project was originally housed on SourceForge.
+The project has moved to http://www.cinecert.com/asdcplib/
The project formerly depended upon the mxflib project. Because
of its focus on covering the whole of the MXF specifications,
library) to prevent malicious in-field replacement of
critical system modules. This recommendation should be
considered wherever Open Source or Free software is being
-used for applications having non-trivial security
-requirements.
+used in conjunction with critical security parameters, such
+as cryptographic keys.
-The author strives mightily to provide an API that is
-completely independent of operating system and other
-library dependencies, and which allows selective replacement
-of some modules for local needs. Specifically, the essence
-parsers and OpenSSL crypto functions can be replaced by
-linking to alternative implementations of the ASDCP::
-objects which provide those services.
+The author strives mightily to provide an API that is completely
+independent of operating system and other library dependencies,
+and which allows selective replacement of some modules for
+local needs. Specifically, the essence parsers and OpenSSL
+crypto functions can be replaced by linking to alternative
+implementations of the ASDCP:: objects which provide those
+services.
AS_DCP.h contains the entire API. You do not need to read
any of the other files, except maybe asdcp-test.cpp which
drwxr-xr-x 1 jhurst None 0 Feb 3 16:37 asdcplib
drwxr-xr-x 56 jhurst None 0 Feb 2 16:35 openssl
+Expat is optionally required for writing Timed Text Track Files. See
+http://expat.sourceforge.net/
+
To build, type 'make'. There are several test targets but you
need to assemble a set of test files to use them.
Change History
-2007.06.xx - Timed Text and Bug fixes v.1.1.15
- o Added support for draft SMPTE 429-5 Timed Text Track File. See
- AS_DCP_TimedText.h for the API. This is *very* experimental, so
- do not use for shipping products. Timed Text support is NOT part
- of the default build, run `make WITH_TIMED_TEXT=1` to enable
- this part of the library. AS_DCP_TimedText.h will be combined
- with AS_DCP.h when it becomes stable. Because we need an XML
- parser to create the Track File, expat is now part of the Timed
- Text build. Follow the XML_PARSER macro in the makefile and KM_xml
- to see how you can support your favorite parser. See also
- S429-5-cgi.cpp for an example that shows how to serve plaintext
- MXF file elements directly via HTTP.
+2007.10.22 - Timed Text, Stereoscopic Picture and Bug fixes v.1.2.16
+ o Significant API changes have been made. Please read all entries
+ in this changelog to be sure you understand the changes. Also
+ note that some changes have been made to LS_MXF_SMPTE files that
+ are incompatible with earlier releases (e.g., EKLV HMAC). If
+ you are looking for a stable interop release, use v.1.1.14.
+ o Fixed RFC 2104 HMAC implementation for LS_MXF_SMPTE only. The
+ broken implementation has been maintained for Interop mode.
+ o Added support for draft SMPTE 429-5 Timed Text Track File. This
+ is still waiting for official SMPTE ULs, so do not use it for
+ shipping products. An XML parser is needed to create a Timed
+ Text Track File; Expat is now an optional part of the build.
+ Make with WITH_XML_PARSER=1 to link with Expat. If you do not
+ link with expat, you will get an error when using the TimedText::
+ DCSubtitleParser class. See also S429-5-cgi.cpp for an example
+ that shows how to serve plaintext MXF file elements directly via
+ HTTP.
+ o Added support for draft SMPTE 429-10 Stereoscopic Picture Track
+ File, including the JPEG Interop version. This is still waiting
+ for official SMPTE ULs, so do not use it with LS_MXF_SMPTE for
+ shipping products.
o Refactored the following files as a side-effect of the above
work: AS_DCP_JP2K.cpp AS_DCP_MPEG2.cpp AS_DCP_PCM.cpp
AS_DCP_MXF.cpp AS_DCP_internal.h MXF.[h|cpp] MXFTypes.[h|cpp]
Metadata.[h|cpp] h__Reader.cpp h__Writer.cpp klvwalk.cpp.
WARNING: While significant effort has been extended to make sure
- that this work does not affect existing stable file support,
+ that these changes do not affect existing stable file support,
users are cautioned to test this release thouroughly.
- o Added a large set of path manglers to KM_fileio.h. See
+ o Added a large set of filesystem path manglers to KM_fileio.h. See
path-test.cpp for example usage. The path manglers have not yet
been tested on win32 platforms (they are currently used only by
- the Timed Text module. The PathIsFile(), PathIsDirectory() and
- FileSize() subroutines have been modified to accept const
- std::string& instead of const char*.
+ the Timed Text module.
+ o The PathIsFile(), PathIsDirectory() and FileSize() subroutines
+ have been modified to accept const std::string& instead of
+ const char*.
o Added namespace and parsing support (Expat) to Kumu::XMLElement
(currently used only for Timed Text support). Also added some
new accessors.
- o ...
+ o Altered MXF::UTF16String to use mbtowc() and wctomb().
2007.03.31 - Bug fixes v.1.1.14