|
Mp7Jrs
2.7.1
|
MPEG-7 library, version 2004 V2
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:
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.
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:
UseTypeAttribute flag, needed for correct serialisation. GetVersion() method.