PhysX2.8教程：SDK，及两个关键参数

from: 

PhysX Documentation(The PhysX SDK/Guide/Basics/SDK Initialization)

PhysX Documentation(The PhysX SDK/Guide/Basics/Memory Management)

PhysX Documentation(The PhysX SDK/Guide/Basics/Error Reporting)

   SDK Initialization   

1.包含NxPhysics.h头文件，如果要引用windows.h，必须define一个NONIMMAX。

#inlucde "NxPhysics.h"

#define NOMINMAX

#include <windows.h>

2.创建SDK对象

// 成功的话会返回一个NxPhysicsSDK指针

// NxPhysicsSDK是单件模式的，也就是说多次create返回的都是同一实例

gPhysicsSDK = NxCreatePhysicsSDK(NX_PHYSICS_SDK_VERSION, &myAllocator, &myOutputStream);

if(!gPhysicsSDK)

Error("Wrong SDK DLL version?");

参数1NX_PHYSICS_SDK_VERSION，是SDK头文件中定义的版本宏。

参数2，可选参数，默认NULL。是用户实现的NxUserAllocator接口，内存管理的东东。

参数3，可选参数，默认NULL。是用户实现的NxUserOutputStream接口。错误报告的东东。

3.释放SDK对象

gPhysicsSDK->release();

虽然NxPhysicsSDK对象是单件模式的，但它有一个引用计数的东东，每create一次都需要有一次release来释放。

另外，多次NxCreatePhysicsSDK时，后续allocator参数会被忽略，始终使用第一次用的那个；output stream参数正常。

  参数2相关：  Memory Management   

创建SDK对象时，可以指定一个自定义的内存管理类。对PC用户来说这不是特别有用，但在对内存管理有特殊要求的系统上就很管用。不管杂说，它允许用户监控SDK的内存使用情况，这才是重点。

要让SDK使用自定义的内存管理方式，需要实现NxUserAllocator接口中的所有纯虚方法(它们和标准C的内存管理方法malloc/realloc/free是对应的，感觉就是重写了标准C的方法)。

但SDK并不保证在每个需要内存分配的地方都是真的调用了自定义的allocator，很可能是在开始的时候通过你自定义的allocator分配了一大块内存，然后在需要的时候SDK内部用自己的方法来分配或干点别的这块内存。

这也就意味着，如果要使用自定义的内存管理方式，就必须在SDK创建之初传入。SDK创建之后，这个allocator参数不能修改和移除。

需要注意：allocator就是一个纯粹独立的内存管理类，不要它里面调用任何SDK的方法。

一个实现的allocator

    class MyAllocator : public NxUserAllocator

    {

    public:

        void * malloc(NxU32 size)

        {

            return ::malloc(size);

        }

        void * mallocDEBUG(NxU32 size,const char *fileName, int line)

        {

            return ::_malloc_dbg(size,_NORMAL_BLOCK, fileName, line);

        }

        void * realloc(void * memory, NxU32 size)

        {

            return ::realloc(memory,size);

        }

        void free(void * memory)

        {

            ::free(memory);

        }

    } myAllocator;

    gPhysicsSDK = NxCreatePhysicsSDK(NX_PHYSICS_SDK_VERSION, &myAllocator, 0);

还需要保证allocator是线程安全的，因为在SDK内部它肯定是多线程调用这些内存管理方法的。

通常操作系统提供的都是线程安全的，除非链接了单线程CRT。

  参数3相关：  Error Reporting    

SDK也允许用户通过实现NxUserOutputStream接口类自定义错误日志的读写类。

(注：2.8.4该接口需要实现3个接口方法，3.0只需1个方法。)

同allocator一样，在这个实现的用于错误报告的stream类中，也不能调用SDK的任何方法。

和allocator不同，不需保证线程安全。

    class MyOutputStream : public NxUserOutputStream

    {

        void reportError (NxErrorCode code, const char *message, const char* file, int line)

        {

            //this should be routed to the application

            //specific error handling. If this gets hit

            //then you are in most cases using the SDK

            //wrong and you need to debug your code!

            //however, code may  just be a warning or

            //information.

        

            if (code < NXE_DB_INFO)

            {

                MessageBox(NULL, message, "SDK Error", MB_OK),

                exit(1);

            }

        }

                

        NxAssertResponse reportAssertViolation (const char *message, const char *file,int line)

        {

            //this should not get hit by

            // a properly debugged SDK!

            assert(0);

            return NX_AR_CONTINUE;

        }

                

        void print (const char *message)

        {

            printf("SDK says: %s\n", message);

        }

    } myOutputStream;