Recent changes to Home

Home modified by Philip de Nier

Philip de Nier — Fri, 04 Nov 2022 10:25:42 -0000

--- v11
+++ v12
@@ -1 +1,6 @@
-See the bmx [README.md](https://sourceforge.net/p/bmxlib/bmx/ci/master/tree/README.md) for the latest overview of the bmx library and utilities.
+bmx, libMXF and libMXF++ have moved to GitHub:
+- https://github.com/bbc/bmx
+- https://github.com/bbc/libMXF
+- https://github.com/bbc/libMXFpp
+
+See the bmx [README](https://github.com/bbc/bmx) for the latest overview of the bmx library and utilities.

Home modified by Philip de Nier

Philip de Nier — Wed, 12 May 2021 11:01:34 -0000

--- v10
+++ v11
@@ -1,121 +1 @@
-Overview
------
-
-bmx is a library and set of utilities to read and write broadcasting media files. It primarily supports the MXF file format.
-
-bmx is made up of 3 libraries:
-
-* libMXF - low-level MXF library written in C
-* libMXF++ - C++ wrapper for libMXF, providing simpler and more manageable processing of header metadata
-* bmx - C++ classes and utilities to read and write various flavours of MXF and WAVE
-
-bmx contains these applications and tools:
-
-* bmxtranswrap - re-wrap from one format to another
-* mxf2raw - display MXF file metadata, extract raw essence, calculate MD5 etc.
-* raw2bmx - wrap raw essence in various output formats
-* h264dump - text dump for raw h.264 bitstreams
-* movdump - text dump for Quicktime files
-* MXFDump - [AAF SDK](http://sourceforge.net/projects/aaf/) utility to extract a detailed text dump of MXF files
-
-The following input and output formats are supported:
-
-* [AMWA AS-02](http://www.amwa.tv/projects/AS-02.shtml) 'MXF Versioning'
-* [AMWA AS-11](http://www.amwa.tv/projects/AS-11.shtml) 'MXF for Contribution'
-* Avid MXF OP-Atom
-* MXF D-10 (MPEG IMX)
-* MXF OP-1A
-* WAVE
-* Raw essence
-
-The following essence formats are supported:
-
-* AVC-Intra 50/100
-* D-10 30/40/50
-* DV 25/50/100
-* Avid MJPEG
-* MPEG-2 Long GOP 422P@HL, MP@HL (1920 and 1440) and MP@H14
-* Uncompressed UYVY / v210 / Avid 10-bit / Avid Alpha
-* VC-3 (Avid DNxHD)
-* WAVE PCM
-
-The libraries have been built and tested on the following platforms:
-
-* OpenSUSE 12.1, 64-bit, gcc 4.6.2
-* Ubuntu 12.04, 64-bit, gcc 4.6.3
-* Fedora 17, 64-bit, gcc 4.7.0
-* Mac OS X 10.6.8, 64-bit, gcc 4.2.1
-* Windows XP SP3, Microsoft Visual C++ 2005 Express Edition
-
-
-Linux and Mac OS X Build
-----
-
-The build requires the usual C/C++ build utilities such as gcc, make, etc. The [pkg-config](http://www.freedesktop.org/wiki/Software/pkg-config) utility is used to get the compiler flags for dependency libraries.
-
-The following external libraries are required (the Ubuntu package names are shown in brackets):
-
-* libuuid (uuid-dev)
-* [uriparser](https://github.com/uriparser/uriparser) >= v0.7.2, **<= 0.8** (liburiparser-dev)
-* [expat](https://github.com/libexpat/libexpat) >= 2.1 (libexpat1-dev)
-
-[Homebrew](http://mxcl.github.com/homebrew/) can be used to on Mac OS X to install git, pkg-config and uriparser.
-
-Using the latest code from the git repositories is recommended. Alternatively, [download](https://sourceforge.net/projects/bmxlib/files/) the latest release or snapshot.
-
-
-1) libMXF
-> cd libMXF
-> ./configure --disable-examples
-> make
-> make check
-> sudo make install
-> sudo /sbin/ldconfig
-
-2) libMXF++
-> cd libMXF++
-> ./configure --disable-examples
-> make
-> make check
-> sudo make install
-> sudo /sbin/ldconfig
-
-3) bmx
-> cd bmx
-> ./configure
-> make
-> make check
-> sudo make install
-> sudo /sbin/ldconfig
-
-
-*Note: run ./autogen.sh first when using the code from the git repositories for the first time. On Mac OS X the pkg-config m4 files may be installed in a location that is not in the search path of aclocal. To add it to the search path edit or create /usr/share/aclocal/dirlist and add a line to the location of the pkg-config m4 files, e.g. '/usr/local/share/aclocal'*
-
-*Note: the '--disable-examples' configure option can be used to avoid building and installing example applications that have been replaced by code in bmx.*
-
-*Note: pkg-config on Fedora and Mac OS X may not include /usr/local/lib/pkgconfig in the search path. This results in a failure in the libMXF++ and bmx configure steps to find the libMXF and libMXF++ pkg-config files. In that case the pkg-config environment variable can be set as part of the configure command, ./configure PKG_CONFIG_PATH=/usr/local/lib/pkgconfig ...*
-
-*Note: the sudo /sbin/ldconfig line ensures that the runtime linker cache is updated and avoids the library link error *...error while loading shared libraries...*
-
-
-
-Windows Build
------
-
-Microsoft Visual C++ 2005 solution and project files are provided in the msvc_build/vs8 directories in the source trees.
-
-The bmx/msvc_build/vs8/bmx.sln solution file includes all the necessary project files to compile the bmx library and applications. The solution files in the libMXF and libMXF++ source trees also include project files for legacy applications such as writeavidmxf.
-
-The bmx library depends on the [uriparser](http://uriparser.sourceforge.net/) library. Download the latest version (>= v0.7.2) from [here](https://sourceforge.net/projects/uriparser/files/), unzip and rename the directory to uriparser/
-
-The project files assume the following directories are present: libMXF/, libMXF++/, bmx/ and uriparser/.
-
-The project files depend on a header file (mxf_scm_version.h, mxfpp_scm_version.h and bmx_scm_version.h) to provide the most recent git commit identifier. This file is generated automatically using the gen_scm_version.sh script on Linux and is included in the source distribution package. If you are using the source code directly from the git repository then you are likely missing this file and you need to create it manually.
-
-
-
-License
--------
-
-The libMXF, libMXF++ and bmx libraries are provided under the [BSD 3-clause
-license](http://www.opensource.org/licenses/BSD-3-Clause). See the COPYING file provided with each library for more details.
+See the bmx [README.md](https://sourceforge.net/p/bmxlib/bmx/ci/master/tree/README.md) for the latest overview of the bmx library and utilities.

Home modified by Philip de Nier

Philip de Nier — Tue, 06 Aug 2019 11:43:31 -0000

--- v9
+++ v10
@@ -53,10 +53,11 @@

 The build requires the usual C/C++ build utilities such as gcc, make, etc. The [pkg-config](http://www.freedesktop.org/wiki/Software/pkg-config) utility is used to get the compiler flags for dependency libraries.

-The following external libraries are required (the OpenSUSE package names are shown in brackets):
+The following external libraries are required (the Ubuntu package names are shown in brackets):

-* libuuid (libuuid-devel)
-* [uriparser](http://uriparser.sourceforge.net/) >= v0.7.2 (liburiparser-devel)
+* libuuid (uuid-dev)
+* [uriparser](https://github.com/uriparser/uriparser) >= v0.7.2, **<= 0.8** (liburiparser-dev)
+* [expat](https://github.com/libexpat/libexpat) >= 2.1 (libexpat1-dev)

 [Homebrew](http://mxcl.github.com/homebrew/) can be used to on Mac OS X to install git, pkg-config and uriparser.

WikiPage Home modified by Philip de Nier

Philip de Nier — Sun, 15 Jul 2012 14:50:14 -0000

--- v8
+++ v9
@@ -7,15 +7,26 @@
 
 * libMXF - low-level MXF library written in C
 * libMXF++ - C++ wrapper for libMXF, providing simpler and more manageable processing of header metadata
-* bmx - C++ classes and utilities to write various flavours of MXF and also includes an MXF reader
+* bmx - C++ classes and utilities to read and write various flavours of MXF and WAVE
 
-The following MXF flavours are currently included:
+bmx contains these applications and tools:
+
+* bmxtranswrap - re-wrap from one format to another
+* mxf2raw - display MXF file metadata, extract raw essence, calculate MD5 etc.
+* raw2bmx - wrap raw essence in various output formats
+* h264dump - text dump for raw h.264 bitstreams
+* movdump - text dump for Quicktime files
+* MXFDump - [AAF SDK](http://sourceforge.net/projects/aaf/) utility to extract a detailed text dump of MXF files
+
+The following input and output formats are supported:
 
 * [AMWA AS-02](http://www.amwa.tv/projects/AS-02.shtml) 'MXF Versioning'
 * [AMWA AS-11](http://www.amwa.tv/projects/AS-11.shtml) 'MXF for Contribution'
-* Avid MXF OP-Atom (a rewrite of libMXF's writeavidmxf)
+* Avid MXF OP-Atom
 * MXF D-10 (MPEG IMX)
 * MXF OP-1A
+* WAVE
+* Raw essence
 
 The following essence formats are supported:
 
@@ -23,86 +34,82 @@
 * D-10 30/40/50
 * DV 25/50/100
 * Avid MJPEG
-* MPEG-2 Long GOP 422P@HL, MP@HL and MP@H14
-* Uncompressed UYVY / v210
+* MPEG-2 Long GOP 422P@HL, MP@HL (1920 and 1440) and MP@H14
+* Uncompressed UYVY / v210 / Avid 10-bit / Avid Alpha
 * VC-3 (Avid DNxHD)
 * WAVE PCM
 
-
-Build
------
-
 The libraries have been built and tested on the following platforms:
 
-* OpenSUSE 11.1, 64-bit and 32-bit, gcc 4.3.2
-* OpenSUSE 11.4, 64-bit, gcc 4.5.1
-* Ubuntu 10.10, 64-bit, gcc 4.4.5
-* Fedora 14, 32-bit, gcc 4.5.1
-* Mac OSX 10.6.6 (Intel), 64-bit build, gcc 4.2.1
-
-The libraries have also been built on Windows (32-bit) using Microsoft Visual C++ 2010. However, project files are currently only included in libMXF and libMXF++.
+* OpenSUSE 12.1, 64-bit, gcc 4.6.2
+* Ubuntu 12.04, 64-bit, gcc 4.6.3
+* Fedora 17, 64-bit, gcc 4.7.0
+* Mac OS X 10.6.8, 64-bit, gcc 4.2.1
+* Windows XP SP3, Microsoft Visual C++ 2005 Express Edition
 
 
-The build requires the usual C/C++ build utilities such as gcc, make, etc. The [pkg-config](http://www.freedesktop.org/wiki/Software/pkg-config) utility is used to determine compiler flags for dependencies.
+Linux and Mac OS X Build
+----
 
-The following external libraries are required (the OpenSUSE 11.1 package names are shown in brackets):
+The build requires the usual C/C++ build utilities such as gcc, make, etc. The [pkg-config](http://www.freedesktop.org/wiki/Software/pkg-config) utility is used to get the compiler flags for dependency libraries.
+
+The following external libraries are required (the OpenSUSE package names are shown in brackets):
 
 * libuuid (libuuid-devel)
-* [xerces-c](http://xerces.apache.org/xerces-c/) v2.8 or v3.x (libXerces-c-devel)
 * [uriparser](http://uriparser.sourceforge.net/) >= v0.7.2 (liburiparser-devel)
 
+[Homebrew](http://mxcl.github.com/homebrew/) can be used to on Mac OS X to install git, pkg-config and uriparser.
 
-Install the external library dependencies, [download](https://sourceforge.net/projects/bmxlib/files/) the tarballs, unpack and build following the steps detailed below.
+Using the latest code from the git repositories is recommended. Alternatively, [download](https://sourceforge.net/projects/bmxlib/files/) the latest release or snapshot.
 
-Alternatively, the latest code is available in the git repositories. Run *./autogen.sh* to prepare the build system.
-
-*Note: the '--disable-examples' configure option can be used to avoid building and installing example applications that have been replaced by code in bmx.*
-
-*Note: pkg-config on Fedora and Mac OSX may not include /usr/local/lib/pkgconfig in the search path. This results in a failure in the libMXF++ configure step to find libMXF. In that case the pkg-config environment variable can be set as part of the configure command, ./configure PKG_CONFIG_PATH=/usr/local/lib/pkgconfig ...*
 
 1) libMXF
-> cd libmxf-1.0.1
+> cd libMXF
 > ./configure --disable-examples
 > make
 > make check
 > sudo make install
+> sudo /sbin/ldconfig
 
 2) libMXF++
-> cd libmxf++-1.0.1
+> cd libMXF++
 > ./configure --disable-examples
 > make
 > make check
 > sudo make install
+> sudo /sbin/ldconfig
 
 3) bmx
-> cd bmx-0.1.1
+> cd bmx
 > ./configure
 > make
 > make check
 > sudo make install
-
-You should now see a usage message after running
-> raw2as11
-
-If you see a library link error *...error while loading shared libraries...* then run the following command to update the runtime linker cache:
 > sudo /sbin/ldconfig
 
 
-Usage
+*Note: run ./autogen.sh first when using the code from the git repositories for the first time. On Mac OS X the pkg-config m4 files may be installed in a location that is not in the search path of aclocal. To add it to the search path edit or create /usr/share/aclocal/dirlist and add a line to the location of the pkg-config m4 files, e.g. '/usr/local/share/aclocal'*
+
+*Note: the '--disable-examples' configure option can be used to avoid building and installing example applications that have been replaced by code in bmx.*
+
+*Note: pkg-config on Fedora and Mac OS X may not include /usr/local/lib/pkgconfig in the search path. This results in a failure in the libMXF++ and bmx configure steps to find the libMXF and libMXF++ pkg-config files. In that case the pkg-config environment variable can be set as part of the configure command, ./configure PKG_CONFIG_PATH=/usr/local/lib/pkgconfig ...*
+
+*Note: the sudo /sbin/ldconfig line ensures that the runtime linker cache is updated and avoids the library link error *...error while loading shared libraries...*
+
+
+
+Windows Build
 -----
 
-The list of commandline applications provided with bmx are: raw2as11, raw2as02, raw2d10mxf, raw2mxfop1a, raw2avidmxf and mxf2raw. The applications provide a means to wrap and extract raw essence data and metadata. They are also used for regression testing.
+Microsoft Visual C++ 2005 solution and project files are provided in the msvc_build/vs8 directories in the source trees.
 
+The bmx/msvc_build/vs8/bmx.sln solution file includes all the necessary project files to compile the bmx library and applications. The solution files in the libMXF and libMXF++ source trees also include project files for legacy applications such as writeavidmxf.
 
-The raw2xxx applications all have a similar commandline usage. Run the command without options to see the usage message. The commands are basically structured as follows: 
-> raw2xxx \ \ \
+The bmx library depends on the [uriparser](http://uriparser.sourceforge.net/) library. Download the latest version (>= v0.7.2) from [here](https://sourceforge.net/projects/uriparser/files/), unzip and rename the directory to uriparser/
 
-The raw2as02 application doesn't have an \, but instead has a global option to set the bundle directory name.
+The project files assume the following directories are present: libMXF/, libMXF++/, bmx/ and uriparser/.
 
-Some essence format parameters (essence type, frame rate and aspect ratio) are extracted from the raw essence data for the DV, D10 and MPEG-2 Long GOP formats. The AVC-Intra essence parser is only partially implemented and therefore the essence format parameters must be set manually.
-
-
-The mxf2raw application can be used to display information about an MXF file, extract essence data and calculate 'essence only' MD5 checksums.
+The project files depend on a header file (mxf_scm_version.h, mxfpp_scm_version.h and bmx_scm_version.h) to provide the most recent git commit identifier. This file is generated automatically using the gen_scm_version.sh script on Linux and is included in the source distribution package. If you are using the source code directly from the git repository then you are likely missing this file and you need to create it manually.

WikiPage Home modified by Philip de Nier

Philip de Nier — Sun, 20 Nov 2011 12:16:35 -0000

--- v7 
+++ v8 
@@ -52,7 +52,7 @@
 * [uriparser](http://uriparser.sourceforge.net/) >= v0.7.2 (liburiparser-devel)
 
 
-[Download](https://sourceforge.net/projects/bmxlib/files/) and unpack the tarballs, install the dependencies and build using the steps detailed below.
+Install the external library dependencies, [download](https://sourceforge.net/projects/bmxlib/files/) the tarballs, unpack and build following the steps detailed below.
 
 Alternatively, the latest code is available in the git repositories. Run *./autogen.sh* to prepare the build system.

WikiPage Home modified by Philip de Nier

Philip de Nier — Sun, 20 Nov 2011 12:13:50 -0000

--- v6 
+++ v7 
@@ -52,7 +52,9 @@
 * [uriparser](http://uriparser.sourceforge.net/) >= v0.7.2 (liburiparser-devel)
 
 
-[Download](https://sourceforge.net/projects/bmxlib/files/) and unpack the tarballs and build as follows after installing the dependencies:
+[Download](https://sourceforge.net/projects/bmxlib/files/) and unpack the tarballs, install the dependencies and build using the steps detailed below.
+
+Alternatively, the latest code is available in the git repositories. Run *./autogen.sh* to prepare the build system.
 
 *Note: the '--disable-examples' configure option can be used to avoid building and installing example applications that have been replaced by code in bmx.*

WikiPage Home modified by Philip de Nier

Philip de Nier — Sun, 20 Nov 2011 12:01:31 -0000

--- v5 
+++ v6 
@@ -23,7 +23,7 @@
 * D-10 30/40/50
 * DV 25/50/100
 * Avid MJPEG
-* Sony MPEG-2 Long GOP 422P@HL, MP@HL and MP@H14
+* MPEG-2 Long GOP 422P@HL, MP@HL and MP@H14
 * Uncompressed UYVY / v210
 * VC-3 (Avid DNxHD)
 * WAVE PCM

WikiPage Home modified by Philip de Nier

Philip de Nier — Sun, 20 Nov 2011 12:00:26 -0000

--- v4 
+++ v5 
@@ -14,80 +14,76 @@
 * [AMWA AS-02](http://www.amwa.tv/projects/AS-02.shtml) 'MXF Versioning'
 * [AMWA AS-11](http://www.amwa.tv/projects/AS-11.shtml) 'MXF for Contribution'
 * Avid MXF OP-Atom (a rewrite of libMXF's writeavidmxf)
-* MXF D-10 (IMX)
+* MXF D-10 (MPEG IMX)
 * MXF OP-1A
 
 The following essence formats are supported:
 
 * AVC-Intra 50/100
 * D-10 30/40/50
 * DV 25/50/100
 * Avid MJPEG
-* MPEG-2 Long GOP (Sony XDCAM)
-* Uncompressed
+* Sony MPEG-2 Long GOP 422P@HL, MP@HL and MP@H14
+* Uncompressed UYVY / v210
 * VC-3 (Avid DNxHD)
 * WAVE PCM
 
 
 Build
 -----
 
 The libraries have been built and tested on the following platforms:
 
 * OpenSUSE 11.1, 64-bit and 32-bit, gcc 4.3.2
 * OpenSUSE 11.4, 64-bit, gcc 4.5.1
 * Ubuntu 10.10, 64-bit, gcc 4.4.5
 * Fedora 14, 32-bit, gcc 4.5.1
 * Mac OSX 10.6.6 (Intel), 64-bit build, gcc 4.2.1
 
 The libraries have also been built on Windows (32-bit) using Microsoft Visual C++ 2010. However, project files are currently only included in libMXF and libMXF++.
 
 
 The build requires the usual C/C++ build utilities such as gcc, make, etc. The [pkg-config](http://www.freedesktop.org/wiki/Software/pkg-config) utility is used to determine compiler flags for dependencies.
 
 The following external libraries are required (the OpenSUSE 11.1 package names are shown in brackets):
 
 * libuuid (libuuid-devel)
 * [xerces-c](http://xerces.apache.org/xerces-c/) v2.8 or v3.x (libXerces-c-devel)
 * [uriparser](http://uriparser.sourceforge.net/) >= v0.7.2 (liburiparser-devel)
 
 
 [Download](https://sourceforge.net/projects/bmxlib/files/) and unpack the tarballs and build as follows after installing the dependencies:
 
-*The '--disable-examples' configure option can be added to avoid building and installing example applications that have been replaced by code in bmx.*
+*Note: the '--disable-examples' configure option can be used to avoid building and installing example applications that have been replaced by code in bmx.*
+
+*Note: pkg-config on Fedora and Mac OSX may not include /usr/local/lib/pkgconfig in the search path. This results in a failure in the libMXF++ configure step to find libMXF. In that case the pkg-config environment variable can be set as part of the configure command, ./configure PKG_CONFIG_PATH=/usr/local/lib/pkgconfig ...*
 
 1) libMXF
 > cd libmxf-1.0.1
 > ./configure --disable-examples
 > make
 > make check
 > sudo make install
 
 2) libMXF++
 > cd libmxf++-1.0.1
 > ./configure --disable-examples
 > make
 > make check
 > sudo make install
 
 3) bmx
 > cd bmx-0.1.1
 > ./configure
 > make
 > make check
 > sudo make install
 
-
-It was found that pkg-config on Fedora and Mac OSX didn't include /usr/local/lib/pkgconfig in the search path. This resulted in a failure in the libMXF++ configure step to find libMXF. The pkg-config environment variable can be set as part of the configure command:
-> ./configure PKG_CONFIG_PATH=/usr/local/lib/pkgconfig ...
-
-
 You should now see a usage message after running
 > raw2as11
 
-If you see a library link error ("...error while loading shared libraries...") then run the following command to update the runtime linker cache:
+If you see a library link error *...error while loading shared libraries...* then run the following command to update the runtime linker cache:
 > sudo /sbin/ldconfig
-
 
 
 Usage

WikiPage Home modified by Philip de Nier

Philip de Nier — Tue, 18 Oct 2011 14:59:05 -0000

--- v3 
+++ v4 
@@ -99,7 +99,7 @@
 The raw2xxx applications all have a similar commandline usage. Run the command without options to see the usage message. The commands are basically structured as follows: 
 > raw2xxx \ \ \
 
-The raw2as02 application doesn't have an , but instead has a global option to set the bundle directory name.
+The raw2as02 application doesn't have an \, but instead has a global option to set the bundle directory name.
 
 Some essence format parameters (essence type, frame rate and aspect ratio) are extracted from the raw essence data for the DV, D10 and MPEG-2 Long GOP formats. The AVC-Intra essence parser is only partially implemented and therefore the essence format parameters must be set manually.

WikiPage Home modified by Philip de Nier

Philip de Nier — Tue, 18 Oct 2011 14:18:24 -0000

--- v2 
+++ v3 
@@ -1,1 +1,115 @@
-Library and utilities to read and write broadcasting media files. Primarily supports the MXF file format.
+Overview
+-----
+
+bmx is a library and set of utilities to read and write broadcasting media files. It primarily supports the MXF file format.
+
+bmx is made up of 3 libraries:
+
+* libMXF - low-level MXF library written in C
+* libMXF++ - C++ wrapper for libMXF, providing simpler and more manageable processing of header metadata
+* bmx - C++ classes and utilities to write various flavours of MXF and also includes an MXF reader
+
+The following MXF flavours are currently included:
+
+* [AMWA AS-02](http://www.amwa.tv/projects/AS-02.shtml) 'MXF Versioning'
+* [AMWA AS-11](http://www.amwa.tv/projects/AS-11.shtml) 'MXF for Contribution'
+* Avid MXF OP-Atom (a rewrite of libMXF's writeavidmxf)
+* MXF D-10 (IMX)
+* MXF OP-1A
+
+The following essence formats are supported:
+
+* AVC-Intra 50/100
+* D-10 30/40/50
+* DV 25/50/100
+* Avid MJPEG
+* MPEG-2 Long GOP (Sony XDCAM)
+* Uncompressed
+* VC-3 (Avid DNxHD)
+* WAVE PCM
+
+
+Build
+-----
+
+The libraries have been built and tested on the following platforms:
+
+* OpenSUSE 11.1, 64-bit and 32-bit, gcc 4.3.2
+* OpenSUSE 11.4, 64-bit, gcc 4.5.1
+* Ubuntu 10.10, 64-bit, gcc 4.4.5
+* Fedora 14, 32-bit, gcc 4.5.1
+* Mac OSX 10.6.6 (Intel), 64-bit build, gcc 4.2.1
+
+The libraries have also been built on Windows (32-bit) using Microsoft Visual C++ 2010. However, project files are currently only included in libMXF and libMXF++.
+
+
+The build requires the usual C/C++ build utilities such as gcc, make, etc. The [pkg-config](http://www.freedesktop.org/wiki/Software/pkg-config) utility is used to determine compiler flags for dependencies.
+
+The following external libraries are required (the OpenSUSE 11.1 package names are shown in brackets):
+
+* libuuid (libuuid-devel)
+* [xerces-c](http://xerces.apache.org/xerces-c/) v2.8 or v3.x (libXerces-c-devel)
+* [uriparser](http://uriparser.sourceforge.net/) >= v0.7.2 (liburiparser-devel)
+
+
+[Download](https://sourceforge.net/projects/bmxlib/files/) and unpack the tarballs and build as follows after installing the dependencies:
+
+*The '--disable-examples' configure option can be added to avoid building and installing example applications that have been replaced by code in bmx.*
+
+1) libMXF
+> cd libmxf-1.0.1
+> ./configure --disable-examples
+> make
+> make check
+> sudo make install
+
+2) libMXF++
+> cd libmxf++-1.0.1
+> ./configure --disable-examples
+> make
+> make check
+> sudo make install
+
+3) bmx
+> cd bmx-0.1.1
+> ./configure
+> make
+> make check
+> sudo make install
+
+
+It was found that pkg-config on Fedora and Mac OSX didn't include /usr/local/lib/pkgconfig in the search path. This resulted in a failure in the libMXF++ configure step to find libMXF. The pkg-config environment variable can be set as part of the configure command:
+> ./configure PKG_CONFIG_PATH=/usr/local/lib/pkgconfig ...
+
+
+You should now see a usage message after running
+> raw2as11
+
+If you see a library link error ("...error while loading shared libraries...") then run the following command to update the runtime linker cache:
+> sudo /sbin/ldconfig
+
+
+
+Usage
+-----
+
+The list of commandline applications provided with bmx are: raw2as11, raw2as02, raw2d10mxf, raw2mxfop1a, raw2avidmxf and mxf2raw. The applications provide a means to wrap and extract raw essence data and metadata. They are also used for regression testing.
+
+
+The raw2xxx applications all have a similar commandline usage. Run the command without options to see the usage message. The commands are basically structured as follows: 
+> raw2xxx \ \ \
+
+The raw2as02 application doesn't have an , but instead has a global option to set the bundle directory name.
+
+Some essence format parameters (essence type, frame rate and aspect ratio) are extracted from the raw essence data for the DV, D10 and MPEG-2 Long GOP formats. The AVC-Intra essence parser is only partially implemented and therefore the essence format parameters must be set manually.
+
+
+The mxf2raw application can be used to display information about an MXF file, extract essence data and calculate 'essence only' MD5 checksums.
+
+
+
+License
+-------
+
+The libMXF, libMXF++ and bmx libraries are provided under the [BSD 3-clause
+license](http://www.opensource.org/licenses/BSD-3-Clause). See the COPYING file provided with each library for more details.