xmp_toolkit_ruby 0.0.2

data/ext/xmp_toolkit_ruby/XMP-Toolkit-SDK/public/include/XMP.hpp

@@ -0,0 +1,98 @@
+#ifndef __XMP_hpp__
+#define __XMP_hpp__ 1
+
+// =================================================================================================
+// Copyright 2002 Adobe
+// All Rights Reserved.
+//
+// NOTICE:  Adobe permits you to use, modify, and distribute this file in accordance with the terms
+// of the Adobe license agreement accompanying it. 
+// =================================================================================================
+
+//  ================================================================================================
+/// \file XMP.hpp
+/// \brief Overall header file for the XMP Toolkit
+///
+/// This is an overall header file, the only one that C++ clients should include.
+///
+/// The full client API is in the \c TXMPMeta.hpp, \c TXMPIterator.hpp, \c TXMPUtils.hpp headers.
+/// Read these for information, but do not include them directly. The \c TXMP... classes are C++
+/// template classes that must be instantiated with a string class such as \c std::string. The
+/// string class is used to return text strings for property values, serialized XMP, and so on.
+/// Clients must also compile \c XMP.incl_cpp to ensure that all client-side glue code is generated.
+/// This should be done by including it in exactly one client source file.
+///
+/// There are two C preprocessor macros that simplify use of the templates:
+///
+/// \li \c TXMP_STRING_TYPE - Define this as the string class to use with the template. You will get
+/// the template headers included and typedefs (\c SXMPMeta, and so on) to use in your code.
+///
+/// \li \c TXMP_EXPAND_INLINE - Define this as 1 if you want to have the template functions expanded
+/// inline in your code. Leave it undefined, or defined as 0, to use out-of-line instantiations of
+/// the template functions. Compiling \c XMP.incl_cpp generates explicit out-of-line
+/// instantiations if \c TXMP_EXPAND_INLINE is off.
+///
+/// The template parameter, class \c tStringObj, must have the following member functions (which
+/// match those for \c std::string):
+///
+/// <pre>
+///  tStringObj& assign ( const char * str, size_t len )
+///  size_t size() const
+///  const char * c_str() const
+/// </pre>
+///
+/// The string class must be suitable for at least UTF-8. This is the encoding used for all general
+/// values, and is the default encoding for serialized XMP. The string type must also be suitable
+/// for UTF-16 or UTF-32 if those serialization encodings are used. This mainly means tolerating
+/// embedded 0 bytes, which \c std::string does.
+//  ================================================================================================
+
+/// /c XMP_Environment.h must be the first included header.
+#include "XMP_Environment.h"
+
+#include "XMP_Version.h"
+#include "XMP_Const.h"
+
+#if XMP_WinBuild
+    #if XMP_DebugBuild
+        #pragma warning ( push, 4 )
+    #else
+        #pragma warning ( push, 3 )
+    #endif
+    #pragma warning ( disable : 4702 ) // unreachable code
+    #pragma warning ( disable : 4800 ) // forcing value to bool 'true' or 'false' (performance warning)
+#endif
+
+#if defined ( TXMP_STRING_TYPE )
+
+    #include "TXMPMeta.hpp"
+    #include "TXMPIterator.hpp"
+    #include "TXMPUtils.hpp"
+    typedef class TXMPMeta <TXMP_STRING_TYPE>     SXMPMeta;       // For client convenience.
+    typedef class TXMPIterator <TXMP_STRING_TYPE> SXMPIterator;
+    typedef class TXMPUtils <TXMP_STRING_TYPE>    SXMPUtils;
+    #if TXMP_EXPAND_INLINE
+    	#error "TXMP_EXPAND_INLINE is not working at present. Please don't use it."
+        #include "client-glue/TXMPMeta.incl_cpp"
+        #include "client-glue/TXMPIterator.incl_cpp"
+        #include "client-glue/TXMPUtils.incl_cpp"
+        #include "client-glue/TXMPFiles.incl_cpp"
+    #endif
+
+	#if XMP_INCLUDE_XMPFILES
+		#include "TXMPFiles.hpp"	// ! Needs typedef for SXMPMeta.
+		typedef class TXMPFiles <TXMP_STRING_TYPE>    SXMPFiles;
+		#if TXMP_EXPAND_INLINE
+			#include "client-glue/TXMPFiles.incl_cpp"
+		#endif
+	#endif
+
+#endif  // TXMP_STRING_TYPE
+
+#if XMP_WinBuild
+    #pragma warning ( pop )
+#endif
+
+// =================================================================================================
+
+#endif  // __XMP_hpp__

data/ext/xmp_toolkit_ruby/XMP-Toolkit-SDK/public/include/XMP.incl_cpp

@@ -0,0 +1,69 @@
+#ifndef __XMP_incl_cpp__
+#define __XMP_incl_cpp__ 1
+
+// =================================================================================================
+// ADOBE SYSTEMS INCORPORATED
+// Copyright 2002 Adobe Systems Incorporated
+// All Rights Reserved
+//
+// NOTICE: Adobe permits you to use, modify, and distribute this file in accordance with the terms
+// of the Adobe license agreement accompanying it.
+// =================================================================================================
+
+//  ================================================================================================
+/// \file XMP.incl_cpp
+/// \brief Overall client glue file for the XMP toolkit.
+///
+/// This is an overall client source file of XMP toolkit glue, the only XMP-specific one that
+/// clients should build in projects. This ensures that all of the client-side glue code for the
+/// XMP toolkit gets compiled.
+///
+/// You cannot compile this file directly, because the template's string type must be declared and 
+/// only the client can do that. Instead, include this in some other source file. For example, 
+/// to use <tt>std::string</tt> you only need these two lines:
+///
+/// \code
+///  #include <string>
+///  #include "XMP.incl_cpp"
+/// \endcode
+
+
+#include "XMP.hpp" // ! This must be the first include!
+
+#define XMP_ClientBuild 1
+
+#if XMP_WinBuild
+    #if XMP_DebugBuild
+        #pragma warning ( push, 4 )
+    #else
+        #pragma warning ( push, 3 )
+    #endif
+
+   	#pragma warning ( disable : 4127 ) // conditional expression is constant
+    #pragma warning ( disable : 4189 ) // local variable is initialized but not referenced
+    #pragma warning ( disable : 4702 ) // unreachable code
+    #pragma warning ( disable : 4800 ) // forcing value to bool 'true' or 'false' (performance warning)
+#endif
+
+#if defined ( TXMP_STRING_TYPE ) && (! TXMP_EXPAND_INLINE)
+
+    // We're using a single out of line instantiation. Do it here.
+
+    #include "client-glue/TXMPMeta.incl_cpp"
+    #include "client-glue/TXMPIterator.incl_cpp"
+    #include "client-glue/TXMPUtils.incl_cpp"
+    template class TXMPMeta <TXMP_STRING_TYPE>;
+    template class TXMPIterator <TXMP_STRING_TYPE>;
+    template class TXMPUtils <TXMP_STRING_TYPE>;
+	#if XMP_INCLUDE_XMPFILES
+	    #include "client-glue/TXMPFiles.incl_cpp"
+	    template class TXMPFiles <TXMP_STRING_TYPE>;
+   #endif
+
+#endif
+
+#if XMP_WinBuild
+    #pragma warning ( pop )
+#endif
+
+#endif // __XMP_incl_cpp__

data/ext/xmp_toolkit_ruby/XMP-Toolkit-SDK/public/include/XMPCommon/Interfaces/BaseInterfaces/IConfigurable.h

@@ -0,0 +1,225 @@
+//!
+//! @file IConfigurable.h
+//!
+
+#ifndef IConfigurable_h__
+#define IConfigurable_h__ 1
+
+// =================================================================================================
+// Copyright Adobe
+// Copyright 2014 Adobe
+// All Rights Reserved
+//
+// NOTICE:  Adobe permits you to use, modify, and distribute this file in accordance with the terms
+// of the Adobe license agreement accompanying it. 
+// =================================================================================================
+
+#include "XMPCommon/XMPCommonFwdDeclarations.h"
+
+namespace AdobeXMPCommon {
+
+	//!
+	//! \brief Interface that allows to attach various key-value parameters to the underlying object.
+	//!
+	//! \details Key is an unsigned 64-bit integer value which can be a char buffer of eight characters also.
+	//! \note For all value types except user data ( const void * ) or char buffer ( const char * ) a copy is made
+	//!  and is stored, so the scope is maintained internally. But for user data ( const void * ) or char buffer
+	//!  ( const char * ) its clients responsibility to make sure these pointers remain valid through out the life
+	//!  span of the object or objects derived from it.
+	//!
+	class XMP_PUBLIC IConfigurable
+	{
+	public:
+
+		//!
+		//! @brief Indicates various types of parameter values.
+		//!
+		typedef enum {
+			//!< Data type is none.
+			kDTNone					= 0,
+			//!< Data type is boolean.
+			kDTBool					= 1 << 0,
+			//!< Data type is unsigned 64 bit integer.
+			kDTUint64				= 1 << 1,
+			//!< Data type is signed 64 bit integer.
+			kDTInt64				= 1 << 2,
+			//!< Data type is character.
+			kDTChar					= 1 << 3,
+			//!< Data type is double.
+			kDTDouble				= 1 << 4,
+			//!< Data type is char buffer.
+			kDTConstCharBuffer		= 1 << 5,
+			//!< Data type is user data ( pointer to const void ).
+			kDTConstVoidPtr			= 1 << 6,
+
+			//!< Maximum value this enum can hold.
+			kDTAll					= 0xFFFFFFFF
+		} eDataType;
+
+		//!
+		//! @{
+		//! @brief Add/Change a value of a parameter.
+		//! \param[in] key An unsigned 64 bit integer value indicating the key.
+		//! \param[in] value New value of the parameter.
+		//! \attention Error is thrown in case
+		//!		- the previous type of value associated with key is of different type.
+		//!		- the type of value associated with key is not as expected.
+		//!
+		virtual void APICALL SetParameter( const uint64 & key, bool value ) = 0;
+		virtual void APICALL SetParameter( const uint64 & key, uint64 value ) = 0;
+		virtual void APICALL SetParameter( const uint64 & key, int64 value ) = 0;
+		virtual void APICALL SetParameter( const uint64 & key, double value ) = 0;
+		virtual void APICALL SetParameter( const uint64 & key, char value ) = 0;
+		virtual void APICALL SetParameter( const uint64 & key, const char * value ) = 0;
+		virtual void APICALL SetParameter( const uint64 & key, const void * value ) = 0;
+		//! @}
+
+		//!
+		//! @brief Removes a particular parameter if present.
+		//! \param[in] key An unsigned 64 bit integer value indicating the key.
+		//! \return True in case key was present and is deleted.
+		//! \attention Error is thrown in case
+		//!		- key is a must have for the underlying object.
+		//!
+		virtual bool APICALL RemoveParameter( const uint64 & key ) = 0;
+
+		//!
+		//! @{
+		//! @brief Get the value of a parameter if present.
+		//! \param[in] key An unsigned 64 bit integer value indicating the key.
+		//! \param[out] value The value of the parameter.
+		//! \return false if no such parameter is present, otherwise true.
+		//! \attention Error is thrown in case the type of the parameter is not
+		//!  the one client is asking for.
+		//!
+		virtual bool APICALL GetParameter( const uint64 & key, bool & value ) const = 0;
+		virtual bool APICALL GetParameter( const uint64 & key, uint64 & value ) const = 0;
+		virtual bool APICALL GetParameter( const uint64 & key, int64 & value ) const = 0;
+		virtual bool APICALL GetParameter( const uint64 & key, double & value ) const = 0;
+		virtual bool APICALL GetParameter( const uint64 & key, char & value ) const = 0;
+		virtual bool APICALL GetParameter( const uint64 & key, const char * & value ) const = 0;
+		virtual bool APICALL GetParameter( const uint64 & key, const void * & value ) const = 0;
+		//! @}
+
+		//!
+		//! @brief Get all the keys of the parameters associated with the object.
+		//! \details Provide a std::vector containing the keys of all the parameters associated with the object.
+		//! \return A std::vector of unsigned 64 bit integers.
+		//!
+		virtual std::vector< uint64 > APICALL GetAllParameters() const = 0;
+
+		//!
+		//! @brief Get the number of parameters associated with the object.
+		//!
+		virtual sizet APICALL Size() const __NOTHROW__ = 0;
+
+		//!
+		//! @brief Get the value type of a particular parameter.
+		//! \param[in] key An unsigned 64 bit integer value indicating the key.
+		//! \return A value of type eDataType indicating the type of value the parameter is supposed to hold.
+		//! \note return kDTNone in case no such key is associated with the object.
+		//!
+		virtual eDataType APICALL GetDataType( const uint64 & key ) const = 0;
+
+		//!
+		//! @brief Utility function to convert character buffer ( maximum of 8 characters ) to uint64 representation.
+		//! \param[in] key A pointer to const char buffer, maximum characters used are 8 provided there is no
+		//!  null character present in the buffer between 1st to 8 characters, otherwise characters upto NULL
+		//!  character (excluding NULL) are read.
+		//! \return A 64-bit unsigned integer representing the first 8 characters of the character buffer.
+		//! \note Return 0 in case key is NULL.
+		//!
+		static uint64 ConvertCharBufferToUint64( const char * key ) {
+			uint64 keyAsuint64 = 0;
+			if ( key ) {
+				for ( int i = 0; i < 8 && key[ i ] != '\0'; i++ ) {
+					keyAsuint64 = keyAsuint64 << 8;
+					keyAsuint64 += ( unsigned char ) key[ i ];
+				}
+			}
+			return keyAsuint64;
+		}
+
+		//!
+		//! @brief A union data type to store all kind of values.
+		//!
+		union CombinedDataValue {
+			bool			boolValue;
+			uint32			uint32Value;
+			uint64			uint64Value;
+			int64			int64Value;
+			double			doubleValue;
+			char			charValue;
+			const char *	constCharPtrValue;
+			const void *	constVoidPtrValue;
+		};
+
+	protected:
+		//! \cond XMP_INTERNAL_DOCUMENTATION
+		// all safe functions
+		virtual void APICALL setParameter( const uint64 & key, uint32 dataType, const CombinedDataValue & dataValue, pcIError_base & error ) __NOTHROW__ = 0;
+		virtual uint32 APICALL removeParameter( const uint64 & key, pcIError_base & error ) __NOTHROW__ = 0;
+		virtual uint32 APICALL getParameter( const uint64 & key, uint32 dataType, CombinedDataValue & value, pcIError_base & error ) const __NOTHROW__ = 0;
+		virtual void APICALL getAllParameters( uint64 * array, sizet count ) const __NOTHROW__ = 0;
+		virtual uint32 APICALL getDataType( const uint64 & key, pcIError_base & error ) const __NOTHROW__ = 0;
+		//! \endcond
+
+	protected:
+		//!
+		//! protected Virtual Destructor
+		//!
+		virtual ~IConfigurable() __NOTHROW__ {};
+
+		friend class IConfigurableProxy;
+	#ifdef FRIEND_CLASS_DECLARATION
+		FRIEND_CLASS_DECLARATION();
+	#endif
+		REQ_FRIEND_CLASS_DECLARATION();
+	};
+
+//! \cond XMP_INTERNAL_DOCUMENTATION
+#if !BUILDING_XMPCOMMON_LIB && !SOURCE_COMPILING_XMP_ALL
+
+	class IConfigurableProxy
+		: public virtual IConfigurable {
+	public:
+		IConfigurableProxy( pIConfigurable configurable );
+		virtual void APICALL SetParameter( const uint64 & key, bool value );
+		virtual void APICALL SetParameter( const uint64 & key, uint64 value );
+		virtual void APICALL SetParameter( const uint64 & key, int64 value );
+		virtual void APICALL SetParameter( const uint64 & key, double value );
+		virtual void APICALL SetParameter( const uint64 & key, char value );
+		virtual void APICALL SetParameter( const uint64 & key, const char * value );
+		virtual void APICALL SetParameter( const uint64 & key, const void * value );
+		virtual void APICALL setParameter( const uint64 & key, uint32 dataType, const CombinedDataValue & dataValue, pcIError_base & error ) __NOTHROW__;
+
+		virtual bool APICALL RemoveParameter( const uint64 & key );
+		virtual uint32 APICALL removeParameter( const uint64 & key, pcIError_base & error ) __NOTHROW__;
+
+		virtual bool APICALL GetParameter( const uint64 & key, bool & value ) const;
+		virtual bool APICALL GetParameter( const uint64 & key, uint64 & value ) const;
+		virtual bool APICALL GetParameter( const uint64 & key, int64 & value ) const;
+		virtual bool APICALL GetParameter( const uint64 & key, double & value ) const;
+		virtual bool APICALL GetParameter( const uint64 & key, char & value ) const;
+		virtual bool APICALL GetParameter( const uint64 & key, const char * & value ) const;
+		virtual bool APICALL GetParameter( const uint64 & key, const void * & value ) const;
+		virtual uint32 APICALL getParameter( const uint64 & key, uint32 dataType, CombinedDataValue & value, pcIError_base & error ) const __NOTHROW__;
+
+		virtual std::vector< uint64 > APICALL GetAllParameters() const;
+		virtual void APICALL getAllParameters( uint64 * array, sizet count ) const __NOTHROW__;
+
+		virtual sizet APICALL Size() const __NOTHROW__;
+
+		virtual eDataType APICALL GetDataType( const uint64 & key ) const;
+		virtual uint32 APICALL getDataType( const uint64 & key, pcIError_base & error ) const __NOTHROW__;
+
+	protected:
+		pIConfigurable		mConfigurableRawPtr;
+	};
+
+#endif  // !BUILDING_XMPCOMMON_LIB && !SOURCE_COMPILING_XMP_ALL
+//! \endcond
+
+}
+
+#endif  // IConfigurable_h__

data/ext/xmp_toolkit_ruby/XMP-Toolkit-SDK/public/include/XMPCommon/Interfaces/BaseInterfaces/ISharedObject.h

@@ -0,0 +1,71 @@
+#ifndef __ISharedObject_h__
+#define __ISharedObject_h__ 1
+
+// =================================================================================================
+// Copyright 2014 Adobe
+// All Rights Reserved.
+//
+// NOTICE:  Adobe permits you to use, modify, and distribute this file in accordance with the terms
+// of the Adobe license agreement accompanying it. 
+// =================================================================================================
+
+#include "XMPCommon/XMPCommonFwdDeclarations.h"
+
+namespace AdobeXMPCommon {
+
+	//!
+	//! \brief Interface that serves as the base interface of all the externally exposed interfaces.
+	//! \details This allows all interfaces to be used as shared pointers so as to reduce the burden of
+	//! scope management from the client or library code. It makes the heap allocated object to be self manged in
+	//! in terms of memory and life. This provides functions so as to inform the actual object when a shared pointer
+	//! is created or destroyed and appropriately release the memory during the last call to Release.
+	//! \attention Supports Multi-threading at object level through use of Atomic Variables.
+	//! \note Any interface which inherits from this needs to make sure that its destructor is declared protected
+	//!  so that unknowingly also client of this object cannot call delete on the object.
+	//!
+
+	class XMP_PUBLIC ISharedObject {
+	public:
+
+		//!
+		//! @brief Called by the clients of the object to indicate that he has acquired the shared ownership of the object.
+		//!
+		virtual void APICALL Acquire() const __NOTHROW__ = 0;
+
+		//!
+		//! @brief Called by the clients of the object to indicate he has released his shared ownership of the object.
+		//! If this being the last client than this function should call Destroy to delete and release the memory.
+		//!
+		virtual void APICALL Release() const __NOTHROW__ = 0;
+
+		//! @{
+		//! \cond XMP_INTERNAL_DOCUMENTATION
+		//! Return the pointer to the internal Shared Object interface
+		//! \return either a const or non const pointer to internal ISharedObject_I interface.
+		virtual AdobeXMPCommon_Int::pISharedObject_I APICALL GetISharedObject_I() __NOTHROW__ = 0;
+
+		XMP_PRIVATE AdobeXMPCommon_Int::pcISharedObject_I GetISharedObject_I() const __NOTHROW__ {
+			return const_cast< ISharedObject * >( this )->GetISharedObject_I();
+		}
+		//! \endcond
+		//! @}
+
+	protected:
+
+		//!
+		//! protected virtual destructor.
+		//!
+		virtual ~ISharedObject() __NOTHROW__ = 0;
+
+	#ifdef FRIEND_CLASS_DECLARATION
+		FRIEND_CLASS_DECLARATION();
+	#endif
+
+		REQ_FRIEND_CLASS_DECLARATION();
+	};
+
+	inline ISharedObject::~ISharedObject() __NOTHROW__ { }
+
+};
+
+#endif  // __ISharedObject_h__

data/ext/xmp_toolkit_ruby/XMP-Toolkit-SDK/public/include/XMPCommon/Interfaces/BaseInterfaces/IThreadSafe.h

@@ -0,0 +1,76 @@
+//! @file IThreadSafe.h
+#ifndef IThreadSafe_h__
+#define IThreadSafe_h__ 1
+
+//
+// =================================================================================================
+// Copyright Adobe
+// Copyright 2015 Adobe
+// All Rights Reserved
+//
+// NOTICE:  Adobe permits you to use, modify, and distribute this file in accordance with the terms
+// of the Adobe license agreement accompanying it. 
+// =================================================================================================
+//
+
+#include "XMPCommon/XMPCommonFwdDeclarations.h"
+
+namespace AdobeXMPCommon {
+	
+	//!
+	//! \brief Interface that serves as the base interface for all the externally exposed interfaces which needs to provide client configurable thread safety.
+	//!          
+	//! \attention In case client has disabled thread safety at the module level these functions will
+	//!  have no use.
+	//! \note By default all the objects created are not thread safe.
+	//!
+	class XMP_PUBLIC IThreadSafe
+	{
+	public:
+
+		//!
+		//! @brief Enables the thread safety on an object.
+		//! @details After calling this function the object can be used across multiple threads.
+		//!
+		virtual void APICALL EnableThreadSafety() const __NOTHROW__ = 0;
+
+		//!
+		//! @brief Disables the thread safety on an object.
+		//! @details After calling this function the object should not be used across multiple threads.
+		//!
+		virtual void APICALL DisableThreadSafety() const __NOTHROW__ = 0;
+
+		//!
+		//! @brief Informs whether object can be used across multiple threads or not.
+		//! \returns bool value; true in case object can be used across multiple threads, false
+		//!  otherwise.
+		//!
+		virtual bool APICALL IsThreadSafe() const = 0;
+
+		//! @{
+		//! \cond XMP_INTERNAL_DOCUMENTATION
+		//!  @brief Return the pointer to the internal Thread Safe interface
+		//! \return either a const or non const pointer to internal IThreadSafe_I interface.
+		virtual AdobeXMPCommon_Int::pIThreadSafe_I APICALL GetIThreadSafe_I() __NOTHROW__ = 0;
+
+		XMP_PRIVATE AdobeXMPCommon_Int::pcIThreadSafe_I GetIThreadSafe_I() const __NOTHROW__ {
+			return const_cast< IThreadSafe * >( this )->GetIThreadSafe_I();
+		}
+        virtual ~IThreadSafe(){}
+		//! \endcond
+		//! @}
+
+	protected:
+		//! \cond XMP_INTERNAL_DOCUMENTATION
+		//! @brief all safe functions
+		virtual uint32 APICALL isThreadSafe() const __NOTHROW__ = 0;
+		//! \endcond
+
+	#ifdef FRIEND_CLASS_DECLARATION
+		FRIEND_CLASS_DECLARATION();
+	#endif
+		REQ_FRIEND_CLASS_DECLARATION();
+	};
+
+}
+#endif  // IThreadSafe_h__

data/ext/xmp_toolkit_ruby/XMP-Toolkit-SDK/public/include/XMPCommon/Interfaces/BaseInterfaces/IVersionable.h

@@ -0,0 +1,71 @@
+#ifndef IVersionable_h__
+#define IVersionable_h__ 1
+
+// =================================================================================================
+// Copyright Adobe
+// Copyright 2015 Adobe
+// All Rights Reserved
+//
+// NOTICE:  Adobe permits you to use, modify, and distribute this file in accordance with the terms
+// of the Adobe license agreement accompanying it. 
+// =================================================================================================
+
+#include "XMPCommon/XMPCommonFwdDeclarations.h"
+
+namespace AdobeXMPCommon {
+
+	//!
+	//! \brief Interface that serves as the base interface for all the externally exposed interfaces
+	//! which needs to provide evolving versions of the interface.
+	//!	@details Provide pointer to interface requested by client.
+	//! Requirements on the class type
+	//!		-# Need to implement a function GetInterfaceID() returning a unique id for the
+	//!		interface. Only required to be implemented in first version of the interface.
+	//!		-# Need to implement a function GetVersionNumber() returning the version of the
+	//!		interface. Required to implemented by each version of the interface.
+	//!
+
+	class XMP_PUBLIC IVersionable {
+	public:
+
+		//!
+		//! @brief Get the raw pointer to an interface object implementing the requested version.
+		//! \return a raw pointer to an interface object implementing the requested version.
+		//! \attention In case a particular version number is not supported than an error is
+		//!            thrown.
+		//!
+		template< typename requestedInterface >
+		XMP_PRIVATE requestedInterface * GetInterfacePointer() {
+			pvoid ptr = GetInterfacePointer( requestedInterface::GetInterfaceID(),
+				requestedInterface::GetInterfaceVersion() );
+			return static_cast< requestedInterface * >( ptr );
+		}
+
+		//!
+		//! @brief Get the raw pointer to a const interface object implementing the requested version.
+		//! \return a raw pointer to a const interface object implementing the requested version.
+		//! \attention In case a particular version number is not supported than an error is
+		//!            thrown.
+		//!
+		template< typename requestedInterface >
+		XMP_PRIVATE const requestedInterface * GetInterfacePointer() const {
+			return const_cast< IVersionable * >( this )->GetInterfacePointer< requestedInterface >();
+		}
+
+	protected:
+		virtual ~IVersionable() {}
+		//! \cond XMP_INTERNAL_DOCUMENTATION
+		virtual pvoid APICALL GetInterfacePointer( uint64 interfaceID, uint32 interfaceVersion ) = 0;
+		// all safe functions
+		virtual pvoid APICALL getInterfacePointer( uint64 interfaceID, uint32 interfaceVersion, pcIError_base & error ) __NOTHROW__ = 0;
+		//! \endcond
+
+		#ifdef FRIEND_CLASS_DECLARATION
+			FRIEND_CLASS_DECLARATION();
+		#endif
+		REQ_FRIEND_CLASS_DECLARATION();
+	};
+
+}
+
+#endif // IVersionable_h__