Blast 1.1.3. See docs/release_notes.txt.v1.1.3_rc1

1 files changed, 373 insertions, 373 deletions

diff --git a/sdk/extensions/import/apexmodules/nvparutils/nvparameterized/NvParameterizedTraits.h b/sdk/extensions/import/apexmodules/nvparutils/nvparameterized/NvParameterizedTraits.h
index ba97ebc..a05d0d0 100644..100755
--- a/sdk/extensions/import/apexmodules/nvparutils/nvparameterized/NvParameterizedTraits.h
+++ b/sdk/extensions/import/apexmodules/nvparutils/nvparameterized/NvParameterizedTraits.h
@@ -1,373 +1,373 @@
-// This code contains NVIDIA Confidential Information and is disclosed to you
-// under a form of NVIDIA software license agreement provided separately to you.
-//
-// Notice
-// NVIDIA Corporation and its licensors retain all intellectual property and
-// proprietary rights in and to this software and related documentation and
-// any modifications thereto. Any use, reproduction, disclosure, or
-// distribution of this software and related documentation without an express
-// license agreement from NVIDIA Corporation is strictly prohibited.
-//
-// ALL NVIDIA DESIGN SPECIFICATIONS, CODE ARE PROVIDED "AS IS.". NVIDIA MAKES
-// NO WARRANTIES, EXPRESSED, IMPLIED, STATUTORY, OR OTHERWISE WITH RESPECT TO
-// THE MATERIALS, AND EXPRESSLY DISCLAIMS ALL IMPLIED WARRANTIES OF NONINFRINGEMENT,
-// MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE.
-//
-// Information and code furnished is believed to be accurate and reliable.
-// However, NVIDIA Corporation assumes no responsibility for the consequences of use of such
-// information or for any infringement of patents or other rights of third parties that may
-// result from its use. No license is granted by implication or otherwise under any patent
-// or patent rights of NVIDIA Corporation. Details are subject to change without notice.
-// This code supersedes and replaces all information previously supplied.
-// NVIDIA Corporation products are not authorized for use as critical
-// components in life support devices or systems without express written approval of
-// NVIDIA Corporation.
-//
-// Copyright (c) 2008-2013 NVIDIA Corporation. All rights reserved.
-
-#ifndef NV_PARAMETERIZED_TRAITS_H
-#define NV_PARAMETERIZED_TRAITS_H
-
-/*!
-\file
-\brief NvParameterized traits class
-*/
-
-#include <string.h>
-#include "foundation/PxAssert.h"
-
-namespace NvParameterized
-{
-
-PX_PUSH_PACK_DEFAULT
-
-class Traits;
-class Interface;
-
-/**
-\brief Interface class for NvParameterized factories
-*/
-class Factory
-{
-public:
-
-	/**
-	\brief Creates NvParameterized object of class
-	*/
-	virtual ::NvParameterized::Interface *create( Traits *paramTraits ) = 0;
-
-	/**
-	\brief Finishes initialization of inplace-deserialized objects (vptr and stuff)
-	*/
-	virtual ::NvParameterized::Interface *finish( Traits *paramTraits, void *obj, void *buf, int32_t *refCount ) = 0;
-
-	/**
-	\brief Returns name of class whose objects are created by factory
-	*/
-	virtual const char * getClassName() = 0;
-
-	/**
-	\brief Returns version of class whose objects are created by factory
-	*/
-	virtual uint32_t getVersion() = 0;
-
-	/**
-	\brief Returns memory alignment required for objects of class
-	*/
-	virtual uint32_t getAlignment() = 0;
-
-	/**
-	\brief Returns checksum of class whose objects are created by factory
-	*/
-	virtual const uint32_t * getChecksum( uint32_t &bits ) = 0;
-
-	/**
-	\brief Destructor
-	*/
-	virtual ~Factory() {}
-
-	/**
-	\brief Clean reflection definition table. Call it if you don't have any instances of classes.
-	*/	
-	virtual void freeParameterDefinitionTable(NvParameterized::Traits* traits) = 0;
-};
-
-/**
-\brief Interface class for legacy object conversions
-*/
-class Conversion
-{
-public:
-	virtual ~Conversion() {}
-
-	/**
-	\brief Initialize object using data from legacy object
-	\param [in] legacyObj legacy object to be converter
-	\param [in] obj destination object
-	\return true if conversion succeeded, false otherwise
-	\warning You may assume that all nested references were already converted.
-	*/
-	virtual bool operator()(::NvParameterized::Interface &legacyObj, ::NvParameterized::Interface &obj) = 0;
-
-	/**
-	\brief Release converter and any memory allocations associated with it
-	*/
-	virtual void release() = 0;
-};
-
-/**
-\brief Interface class for user traits
-
-This class is a collection of loosely-related functions provided by application or framework
-and used by NvParameterized library to do memory allocation, object creation, user notification, etc.
-*/
-class Traits
-{
-public:
-	virtual ~Traits() {}
-
-	/**
-	\brief Register NvParameterized class factory
-	*/
-	virtual void registerFactory( ::NvParameterized::Factory & factory ) = 0;
-
-	/**
-	\brief Remove NvParameterized class factory for current version of class
-	\return Removed factory or NULL if it is not found
-	*/
-	virtual ::NvParameterized::Factory *removeFactory( const char * className ) = 0;
-
-	/**
-	\brief Remove NvParameterized class factory for given version of class
-	\return Removed factory or NULL if it is not found
-	*/
-	virtual ::NvParameterized::Factory *removeFactory( const char * className, uint32_t version ) = 0;
-
-	/**
-	\brief Checks whether any class factory is registered
-	*/
-	virtual bool doesFactoryExist(const char* className) = 0;
-
-	/**
-	\brief Checks whether class factory for given version is registered
-	*/
-	virtual bool doesFactoryExist(const char* className, uint32_t version) = 0;
-
-	/**
-	\brief Create object of NvParameterized class using its staticClassName()
-	
-	\param [in] name static class name of the instance to create
-	
-	Most probably this just calls Factory::create on appropriate factory.
-	*/
-	virtual ::NvParameterized::Interface * createNvParameterized( const char * name ) = 0;
-
-	/**
-	\brief Create object of NvParameterized class using its staticClassName()
-	
-	\param [in] name static class name of the instance to create
-	\param [in] ver version of the class	
-
-	Most probably this just calls Factory::create on appropriate factory.
-	*/
-	virtual ::NvParameterized::Interface * createNvParameterized( const char * name, uint32_t ver ) = 0;
-
-	/**
-	\brief Finish construction of inplace object of NvParameterized class
-	
-	Most probably this just calls Factory::finish using appropriate factory.
-	*/
-	virtual ::NvParameterized::Interface * finishNvParameterized( const char * name, void *obj, void *buf, int32_t *refCount ) = 0;
-
-	/**
-	\brief Finish construction of inplace object of NvParameterized class
-	
-	Most probably this just calls Factory::finish using appropriate factory.
-	*/
-	virtual ::NvParameterized::Interface * finishNvParameterized( const char * name, uint32_t ver, void *obj, void *buf, int32_t *refCount ) = 0;
-
-	/**
-	\brief Get version of class which is currently used
-	*/
-	virtual uint32_t getCurrentVersion(const char *className) const = 0;
-
-	/**
-	\brief Get memory alignment required for objects of class
-	*/
-	virtual uint32_t getAlignment(const char *className, uint32_t classVersion) const = 0;
-
-	/**
-	\brief Register converter for legacy version of class
-	*/
-	virtual void registerConversion(const char * /*className*/, uint32_t /*from*/, uint32_t /*to*/, Conversion & /*conv*/) {}
-
-	/**
-	\brief Remove converter for legacy version of class
-	*/
-	virtual ::NvParameterized::Conversion *removeConversion(const char * /*className*/, uint32_t /*from*/, uint32_t /*to*/) { return 0; }
-
-	/**
-	\brief Update legacy object (most probably using appropriate registered converter)
-	\param [in] legacyObj legacy object to be converted
-	\param [in] obj destination object
-	\return True if conversion was successful, false otherwise
-	\warning Note that update is intrusive - legacyObj may be modified as a result of update
-	*/
-	virtual bool updateLegacyNvParameterized(::NvParameterized::Interface &legacyObj, ::NvParameterized::Interface &obj)
-	{
-		PX_UNUSED(&legacyObj);
-		PX_UNUSED(&obj);
-
-		return false;
-	}
-
-	/**
-	\brief Get a list of the NvParameterized class type names
-
-	\param [in] names buffer for names
-	\param [out] outCount minimal required length of buffer
-	\param [in] inCount length of buffer
-	\return False if 'inCount' is not large enough to contain all of the names, true otherwise
-	
-	\warning The memory for the strings returned is owned by the traits class
-	         and should only be read, not written or freed.
-	*/
-	virtual bool getNvParameterizedNames( const char ** names, uint32_t &outCount, uint32_t inCount) const = 0;
-
-		/**
-	\brief Get a list of versions of particular NvParameterized class
-
-	\param [in] className Name of the class
-	\param [in] versions buffer for versions
-	\param [out] outCount minimal required length of buffer
-	\param [in] inCount length of buffer
-	\return False if 'inCount' is not large enough to contain all of version names, true otherwise
-	
-	\warning The memory for the strings returned is owned by the traits class
-	         and should only be read, not written or freed.
-	*/
-	virtual bool getNvParameterizedVersions(const char* className, uint32_t* versions, uint32_t &outCount, uint32_t inCount) const = 0;
-
-	/**
-	\brief Increment reference counter
-	*/
-	virtual int32_t incRefCount(int32_t *refCount) = 0;
-
-	/**
-	\brief Decrement reference counter
-	*/
-	virtual int32_t decRefCount(int32_t *refCount) = 0;
-
-	/**
-	\brief Called when inplace object is destroyed
-	*/
-	virtual void onInplaceObjectDestroyed(void * /*buf*/, ::NvParameterized::Interface * /*obj*/) {}
-
-	/**
-	\brief Called when all inplace objects are destroyed
-	*/
-	virtual void onAllInplaceObjectsDestroyed(void *buf) { free(buf); }
-
-	/**
-	\brief Allocate memory with default alignment of 8
-	*/
-	virtual void *alloc(uint32_t nbytes) = 0;
-
-	/**
-	\brief Allocate aligned memory
-	*/
-	virtual void *alloc(uint32_t nbytes, uint32_t align) = 0;
-
-	/**
-	\brief Deallocate memory
-	*/
-	virtual void free(void *buf) = 0;
-
-	/**
-	\brief Copy string
-	*/
-	virtual char *strdup(const char *str)
-	{
-		if( !str )
-			return NULL;
-
-		uint32_t strLen = (uint32_t)strlen(str) + 1;
-		char *retStr = (char *)this->alloc(strLen, 1);
-		
-		PX_ASSERT( retStr );
-		
-		if( NULL != retStr )
-#if PX_WINDOWS_FAMILY || PX_XBOXONE
-			strcpy_s( retStr, strLen, str );
-#else
-			strncpy(retStr, str, strLen);
-#endif
-		return retStr;
-	}
-
- 	/**
-	\brief Release copied string
-	*/
-	virtual void strfree(char *str)
-	{
-		if( NULL != str )
-			this->free( str );
-	}
-
- 	/**
-	\brief Warns user
-	*/
-	virtual void traitsWarn(const char * /*msg*/) const {}
-
-	/**
-	\brief Release Traits
-	*/
-	virtual void release(void) = 0;
-
-	/**
-	\brief Adapter for allocator classes in PxAlloctor.h
-	*/
-	class Allocator
-	{
-		::NvParameterized::Traits *mTraits;
-
-	public:
-
-		/**
-		\brief Constructor
-		*/
-		Allocator(Traits *traits): mTraits(traits) {}
-
-		/**
-		\brief Allocate memory
-		*/
-		void *allocate(size_t size)
-		{
-			return allocate(size, __FILE__, __LINE__);
-		}
-
-		/**
-		\brief Allocate memory
-		*/
-		void *allocate(size_t size, const char * /*filename*/, int /*line*/)
-		{
-			PX_ASSERT( static_cast<uint32_t>(size) == size );
-			return mTraits->alloc(static_cast<uint32_t>(size));
-		}
-
-		/**
-		\brief Release memory
-		*/
-		void deallocate(void *ptr)
-		{
-			return mTraits->free(ptr);
-		}
-	};
-};
-
-
-PX_POP_PACK
-
-} // namespace NvParameterized
-
-#endif // NV_PARAMETERIZED_TRAITS_H
+// This code contains NVIDIA Confidential Information and is disclosed to you

+// under a form of NVIDIA software license agreement provided separately to you.

+//

+// Notice

+// NVIDIA Corporation and its licensors retain all intellectual property and

+// proprietary rights in and to this software and related documentation and

+// any modifications thereto. Any use, reproduction, disclosure, or

+// distribution of this software and related documentation without an express

+// license agreement from NVIDIA Corporation is strictly prohibited.

+//

+// ALL NVIDIA DESIGN SPECIFICATIONS, CODE ARE PROVIDED "AS IS.". NVIDIA MAKES

+// NO WARRANTIES, EXPRESSED, IMPLIED, STATUTORY, OR OTHERWISE WITH RESPECT TO

+// THE MATERIALS, AND EXPRESSLY DISCLAIMS ALL IMPLIED WARRANTIES OF NONINFRINGEMENT,

+// MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE.

+//

+// Information and code furnished is believed to be accurate and reliable.

+// However, NVIDIA Corporation assumes no responsibility for the consequences of use of such

+// information or for any infringement of patents or other rights of third parties that may

+// result from its use. No license is granted by implication or otherwise under any patent

+// or patent rights of NVIDIA Corporation. Details are subject to change without notice.

+// This code supersedes and replaces all information previously supplied.

+// NVIDIA Corporation products are not authorized for use as critical

+// components in life support devices or systems without express written approval of

+// NVIDIA Corporation.

+//

+// Copyright (c) 2008-2013 NVIDIA Corporation. All rights reserved.

+

+#ifndef NV_PARAMETERIZED_TRAITS_H

+#define NV_PARAMETERIZED_TRAITS_H

+

+/*!

+\file

+\brief NvParameterized traits class

+*/

+

+#include <string.h>

+#include "foundation/PxAssert.h"

+

+namespace NvParameterized

+{

+

+PX_PUSH_PACK_DEFAULT

+

+class Traits;

+class Interface;

+

+/**

+\brief Interface class for NvParameterized factories

+*/

+class Factory

+{

+public:

+

+	/**

+	\brief Creates NvParameterized object of class

+	*/

+	virtual ::NvParameterized::Interface *create( Traits *paramTraits ) = 0;

+

+	/**

+	\brief Finishes initialization of inplace-deserialized objects (vptr and stuff)

+	*/

+	virtual ::NvParameterized::Interface *finish( Traits *paramTraits, void *obj, void *buf, int32_t *refCount ) = 0;

+

+	/**

+	\brief Returns name of class whose objects are created by factory

+	*/

+	virtual const char * getClassName() = 0;

+

+	/**

+	\brief Returns version of class whose objects are created by factory

+	*/

+	virtual uint32_t getVersion() = 0;

+

+	/**

+	\brief Returns memory alignment required for objects of class

+	*/

+	virtual uint32_t getAlignment() = 0;

+

+	/**

+	\brief Returns checksum of class whose objects are created by factory

+	*/

+	virtual const uint32_t * getChecksum( uint32_t &bits ) = 0;

+

+	/**

+	\brief Destructor

+	*/

+	virtual ~Factory() {}

+

+	/**

+	\brief Clean reflection definition table. Call it if you don't have any instances of classes.

+	*/	

+	virtual void freeParameterDefinitionTable(NvParameterized::Traits* traits) = 0;

+};

+

+/**

+\brief Interface class for legacy object conversions

+*/

+class Conversion

+{

+public:

+	virtual ~Conversion() {}

+

+	/**

+	\brief Initialize object using data from legacy object

+	\param [in] legacyObj legacy object to be converter

+	\param [in] obj destination object

+	\return true if conversion succeeded, false otherwise

+	\warning You may assume that all nested references were already converted.

+	*/

+	virtual bool operator()(::NvParameterized::Interface &legacyObj, ::NvParameterized::Interface &obj) = 0;

+

+	/**

+	\brief Release converter and any memory allocations associated with it

+	*/

+	virtual void release() = 0;

+};

+

+/**

+\brief Interface class for user traits

+

+This class is a collection of loosely-related functions provided by application or framework

+and used by NvParameterized library to do memory allocation, object creation, user notification, etc.

+*/

+class Traits

+{

+public:

+	virtual ~Traits() {}

+

+	/**

+	\brief Register NvParameterized class factory

+	*/

+	virtual void registerFactory( ::NvParameterized::Factory & factory ) = 0;

+

+	/**

+	\brief Remove NvParameterized class factory for current version of class

+	\return Removed factory or NULL if it is not found

+	*/

+	virtual ::NvParameterized::Factory *removeFactory( const char * className ) = 0;

+

+	/**

+	\brief Remove NvParameterized class factory for given version of class

+	\return Removed factory or NULL if it is not found

+	*/

+	virtual ::NvParameterized::Factory *removeFactory( const char * className, uint32_t version ) = 0;

+

+	/**

+	\brief Checks whether any class factory is registered

+	*/

+	virtual bool doesFactoryExist(const char* className) = 0;

+

+	/**

+	\brief Checks whether class factory for given version is registered

+	*/

+	virtual bool doesFactoryExist(const char* className, uint32_t version) = 0;

+

+	/**

+	\brief Create object of NvParameterized class using its staticClassName()

+	

+	\param [in] name static class name of the instance to create

+	

+	Most probably this just calls Factory::create on appropriate factory.

+	*/

+	virtual ::NvParameterized::Interface * createNvParameterized( const char * name ) = 0;

+

+	/**

+	\brief Create object of NvParameterized class using its staticClassName()

+	

+	\param [in] name static class name of the instance to create

+	\param [in] ver version of the class	

+

+	Most probably this just calls Factory::create on appropriate factory.

+	*/

+	virtual ::NvParameterized::Interface * createNvParameterized( const char * name, uint32_t ver ) = 0;

+

+	/**

+	\brief Finish construction of inplace object of NvParameterized class

+	

+	Most probably this just calls Factory::finish using appropriate factory.

+	*/

+	virtual ::NvParameterized::Interface * finishNvParameterized( const char * name, void *obj, void *buf, int32_t *refCount ) = 0;

+

+	/**

+	\brief Finish construction of inplace object of NvParameterized class

+	

+	Most probably this just calls Factory::finish using appropriate factory.

+	*/

+	virtual ::NvParameterized::Interface * finishNvParameterized( const char * name, uint32_t ver, void *obj, void *buf, int32_t *refCount ) = 0;

+

+	/**

+	\brief Get version of class which is currently used

+	*/

+	virtual uint32_t getCurrentVersion(const char *className) const = 0;

+

+	/**

+	\brief Get memory alignment required for objects of class

+	*/

+	virtual uint32_t getAlignment(const char *className, uint32_t classVersion) const = 0;

+

+	/**

+	\brief Register converter for legacy version of class

+	*/

+	virtual void registerConversion(const char * /*className*/, uint32_t /*from*/, uint32_t /*to*/, Conversion & /*conv*/) {}

+

+	/**

+	\brief Remove converter for legacy version of class

+	*/

+	virtual ::NvParameterized::Conversion *removeConversion(const char * /*className*/, uint32_t /*from*/, uint32_t /*to*/) { return 0; }

+

+	/**

+	\brief Update legacy object (most probably using appropriate registered converter)

+	\param [in] legacyObj legacy object to be converted

+	\param [in] obj destination object

+	\return True if conversion was successful, false otherwise

+	\warning Note that update is intrusive - legacyObj may be modified as a result of update

+	*/

+	virtual bool updateLegacyNvParameterized(::NvParameterized::Interface &legacyObj, ::NvParameterized::Interface &obj)

+	{

+		PX_UNUSED(&legacyObj);

+		PX_UNUSED(&obj);

+

+		return false;

+	}

+

+	/**

+	\brief Get a list of the NvParameterized class type names

+

+	\param [in] names buffer for names

+	\param [out] outCount minimal required length of buffer

+	\param [in] inCount length of buffer

+	\return False if 'inCount' is not large enough to contain all of the names, true otherwise

+	

+	\warning The memory for the strings returned is owned by the traits class

+	         and should only be read, not written or freed.

+	*/

+	virtual bool getNvParameterizedNames( const char ** names, uint32_t &outCount, uint32_t inCount) const = 0;

+

+		/**

+	\brief Get a list of versions of particular NvParameterized class

+

+	\param [in] className Name of the class

+	\param [in] versions buffer for versions

+	\param [out] outCount minimal required length of buffer

+	\param [in] inCount length of buffer

+	\return False if 'inCount' is not large enough to contain all of version names, true otherwise

+	

+	\warning The memory for the strings returned is owned by the traits class

+	         and should only be read, not written or freed.

+	*/

+	virtual bool getNvParameterizedVersions(const char* className, uint32_t* versions, uint32_t &outCount, uint32_t inCount) const = 0;

+

+	/**

+	\brief Increment reference counter

+	*/

+	virtual int32_t incRefCount(int32_t *refCount) = 0;

+

+	/**

+	\brief Decrement reference counter

+	*/

+	virtual int32_t decRefCount(int32_t *refCount) = 0;

+

+	/**

+	\brief Called when inplace object is destroyed

+	*/

+	virtual void onInplaceObjectDestroyed(void * /*buf*/, ::NvParameterized::Interface * /*obj*/) {}

+

+	/**

+	\brief Called when all inplace objects are destroyed

+	*/

+	virtual void onAllInplaceObjectsDestroyed(void *buf) { free(buf); }

+

+	/**

+	\brief Allocate memory with default alignment of 8

+	*/

+	virtual void *alloc(uint32_t nbytes) = 0;

+

+	/**

+	\brief Allocate aligned memory

+	*/

+	virtual void *alloc(uint32_t nbytes, uint32_t align) = 0;

+

+	/**

+	\brief Deallocate memory

+	*/

+	virtual void free(void *buf) = 0;

+

+	/**

+	\brief Copy string

+	*/

+	virtual char *strdup(const char *str)

+	{

+		if( !str )

+			return NULL;

+

+		uint32_t strLen = (uint32_t)strlen(str) + 1;

+		char *retStr = (char *)this->alloc(strLen, 1);

+		

+		PX_ASSERT( retStr );

+		

+		if( NULL != retStr )

+#if PX_WINDOWS_FAMILY || PX_XBOXONE

+			strcpy_s( retStr, strLen, str );

+#else

+			strncpy(retStr, str, strLen);

+#endif

+		return retStr;

+	}

+

+ 	/**

+	\brief Release copied string

+	*/

+	virtual void strfree(char *str)

+	{

+		if( NULL != str )

+			this->free( str );

+	}

+

+ 	/**

+	\brief Warns user

+	*/

+	virtual void traitsWarn(const char * /*msg*/) const {}

+

+	/**

+	\brief Release Traits

+	*/

+	virtual void release(void) = 0;

+

+	/**

+	\brief Adapter for allocator classes in PxAlloctor.h

+	*/

+	class Allocator

+	{

+		::NvParameterized::Traits *mTraits;

+

+	public:

+

+		/**

+		\brief Constructor

+		*/

+		Allocator(Traits *traits): mTraits(traits) {}

+

+		/**

+		\brief Allocate memory

+		*/

+		void *allocate(size_t size)

+		{

+			return allocate(size, __FILE__, __LINE__);

+		}

+

+		/**

+		\brief Allocate memory

+		*/

+		void *allocate(size_t size, const char * /*filename*/, int /*line*/)

+		{

+			PX_ASSERT( static_cast<uint32_t>(size) == size );

+			return mTraits->alloc(static_cast<uint32_t>(size));

+		}

+

+		/**

+		\brief Release memory

+		*/

+		void deallocate(void *ptr)

+		{

+			return mTraits->free(ptr);

+		}

+	};

+};

+

+

+PX_POP_PACK

+

+} // namespace NvParameterized

+

+#endif // NV_PARAMETERIZED_TRAITS_H