physxDebugHelper.h

// protect multiple inclusion
#ifndef _PHYSXDEBUGHELPER_H_INCLUDED_
#define _PHYSXDEBUGHELPER_H_INCLUDED_


#include "NXU_helper.h"



// used by irrlichtWrapper update()
// set by controler onKeyEvent()
void switchPhysxDebugRenderingEnabled();
bool getPhysxDebugRenderingEnabled();



// an object of this class is given to NxCreatePhysicsSDK() to output physX errors
class NxDebugOutput : public NxUserOutputStream
{
public:
    virtual void reportError(NxErrorCode code, const char* message, const char* file, int line);
    virtual NxAssertResponse reportAssertViolation(const char* message, const char* file, int line);    
    virtual void print(const char* message);
};


// an object of this class uses irrlicht to render debug data (triangles), given from physX debug visualization
class NxDebugRenderer
{
public:
        NxDebugRenderer();
        ~NxDebugRenderer();

        // must be called from irrlicht update()
        // i.e. "within beginScene() and endScene()"
        // because irrlicht must be in proper render state to draw below lines
        ERR_TYPE update( f32 timeMS );
};


// an object of this class is set in the NXU_helper (the XML data driven PhysX loader), to output physX errors
class NxuDebugOutput : public NXU_errorReport
{
public:
    virtual     void NXU_errorMessage(bool isError, const char* str);
};


// an object of this class is set in the NXU_helper (the XML data driven PhysX loader), to output physX create notifications
class NxuUserNotify : public NXU_userNotify
{
public:

        // Notifies the application that a new scene has been created.
        virtual void    NXU_notifyScene(NxU32 sno, NxScene* scene, const char* userProperties);

        // Notifies the application that a new actor has been created.
        virtual void    NXU_notifyActor(NxActor* actor, const char* userProperties);

        // Notifies the application that a new TriangleMesh that has been created.
        virtual void    NXU_notifyTriangleMesh(NxTriangleMesh *t, const char* userProperties);

        // Pre-notification event before a new scene is about to be created.
        // return a NULL pointer to have the instantiator create the scene.  A non-null pointer is the NxScene the application wants the data to be loaded into.
        virtual NxScene *NXU_preNotifyScene(unsigned int sno, NxSceneDesc& scene, const char* userProperties);

        // Pre-notification event before an actor is created.
        // return true to create the actor or false to skip it.
        virtual bool    NXU_preNotifyActor(NxActorDesc& actor, const char* userProperties);

        // Pre-notification event before a triangle mesh is created.
        // return true to create the triangle mesh or false to skip it.
        virtual bool    NXU_preNotifyTriangleMesh(NxTriangleMeshDesc& t, const char* userProperties);

        // Pre-notification event before a SceneInstance is executed.
        // return true to execute the scene instance.
        virtual bool    NXU_preNotifySceneInstance(const char* name, const char* sceneName, const char* userProperties, NxMat34& rootNode, NxU32 depth);

        // Notification event because a scene failed to be created.
        virtual void    NXU_notifySceneFailed(unsigned int sno, NxSceneDesc& scene, const char* userProperties);

        // Notification event that an actor failed to be created.
        virtual void    NXU_notifyActorFailed(NxActorDesc& actor, const char* userProperties);

        // Notification event that a triangle mesh failed to be created.
        virtual void    NXU_notifyTriangleMeshFailed(NxTriangleMeshDesc& t,const char* userProperties);
};


#endif // #ifndef _PHYSXDEBUGHELPER_H_INCLUDED_

---