Mp7Jrs  2.7.1
The Mp7Jrs library

Introduction

MPEG-7 library, version 2004 V2

About this API documentation

This set of HTML pages is an automatically generated API documentation of the Mp7Jrs classes. It is intended as a reference for a developer using Mp7Jrs. If you are looking for an overview description of the library, instructions on how to setup a project using Mp7Jrs and some commented examples, please look at the document located in the /doc subdirectory of the Mp7Jrs distribution.
This API documentation contains the following:

  • class descriptions, including the extension base type and the schema file and line number where they are defined
  • descriptions of methods, including a reference to the class from which they are inherited
  • if the type of parameters or return values is abstract, a list of allowed types is provided
  • for collections, a reference to the local type which is the default type of collection elements

Extensions

Currently there are no extensions created with this version of Mp7Jrs. All you need to extend types of the core library, is an XML schema, which must be - of course - an extension of the core schema and the extented types must have their own namespace(s). Then an additional library can easily be created along with the core lib.

For more information about this, please contact DIGITAL-AVM (formerly IIS) at JOANNEUM RESEARCH.

Whats new?

Version 2.5:
Links against bugfixed XercesC 3.3.1 now.
Builds on 64 bit platforms (Win64 VC9, LINUX 64 bit, MacOS 10.5 64 bit).
With adjusted CMAKE file to build and install libs and doc on LINUX the more natural way.
Example: cmake -G "Unix Makefiles" . , make, make doc, sudo make install.

Version 2.4:
Switched to MPEG-7 standard 2004 (using namespace xmlns:mpeg7="urn:mpeg:mpeg7:schema:2004") Fixed a lot of bugs - mostly concerning extension libraries.

Version 2.3:
Full XML namespace support. Mp7Jrs serialises XML with full namespace declaration in the root element. If you define a default namespace, no prefix is used. Xerces V.2.7 does not allow both - a default namespace beeing declared the second time with a prefix as well. So you can either choose between the default namespace or the prefixed version of your (default) namespace. Having all namespaces prefixed is very handy for XSLTs. To do so, use myArchive.SetUsePrefixForDefaultNS(true);

On the contrary, if you generate MPEG-7 fragments with your own or other third-party tools, and read them with Mp7Jrs library, you must provide a proper namespace declaration in the fragment root
e.g.: <mpeg7:MyFragment xmlns:mpeg7="urn:mpeg:mpeg7:schema:2004" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">My_Data</mpeg7:MyFragment> to read it properly. If you don't use XSI types, you can suppress the declaration of XSI namepace via myArchive.SetForceNamespaceDeclaration(false);

Version 2.2:
ATTENTION: A stunning new method for accessing nodes has been introduced. Instead of dealing with difficult intermediate types (and a huge #include section), it is strongly recommended to use GetFromXPath() or GetOrCreateFromXPath() methods now. So one single call retrieves a list of desired nodes or creates a complete path with one or more nodes.

Example:
root.GetFromXPath("A/B/C[last()]/D[3]/E[@xsi:type="Desired"] to get all desired nodes with this type. or:
rootnode.GetOrCreateFromXPath("A/B/C[last()]/D[3]/E[@xsi:type="Desired"] creates a node with this type (if there was none before).

For a detailed list of supported XPath expressions please read the class documentation.
These two methods should be sufficient to handle your requests properly.

ATTENTION: The methods Archive::ToWBuffer() and Archive::ToBuffer() are using Xerces heap now. You MUST call the appropriate Archive::DeleteBuffer() methods now , otherwise memory errors will occur!

ATTENTION: The macros for GetObjectType and GetTypeId have been removed, in order to get rid of nasty library problems with existing MS libs! If you need these definitions, redefine them in your source code.

ATTENTION: The macro GetClassType has been removed. Use the correspondend GetTypeName() method instead. If you need this definition, please do it in your source code.

ATTENTION: The method GetNextSibling() was renamed to GetNextAkin() because of interferences with a macro from MS XML library... If you need this definition, please do it in your source code.

Other changes:

  • Subelements of type string are now created automatically (as empty string) if they are mandatory.
  • Abstract classes automatically handle the UseTypeAttribute flag, needed for correct serialisation.
  • Interface setter methods additionally create VS7 IntelliSense comments for mandatory elements.
  • Library version string can be queried with GetVersion() method.