1 | #ifndef NX_PHYSICS_NXUSERNOTIFY
|
---|
2 | #define NX_PHYSICS_NXUSERNOTIFY
|
---|
3 | /*----------------------------------------------------------------------------*\
|
---|
4 | |
|
---|
5 | | Public Interface to NovodeX Technology
|
---|
6 | |
|
---|
7 | | www.novodex.com
|
---|
8 | |
|
---|
9 | \*----------------------------------------------------------------------------*/
|
---|
10 | /** \addtogroup physics
|
---|
11 | @{
|
---|
12 | */
|
---|
13 |
|
---|
14 | #include "Nxp.h"
|
---|
15 |
|
---|
16 | class NxJoint;
|
---|
17 | /**
|
---|
18 | \brief An interface class that the user can implement in order to receive simulation events.
|
---|
19 |
|
---|
20 | <b>Threading:</b> It is not necessary to make this class thread safe as it will only be called in the context of the
|
---|
21 | user thread.
|
---|
22 |
|
---|
23 | <h3>Example</h3>
|
---|
24 |
|
---|
25 | \include NxUserNotify_Example.cpp
|
---|
26 |
|
---|
27 | @see NxScene.setUserNotify() NxScene.getUserNotify()
|
---|
28 | */
|
---|
29 | class NxUserNotify
|
---|
30 | {
|
---|
31 | public:
|
---|
32 | /**
|
---|
33 | \brief This is called when a breakable joint breaks.
|
---|
34 |
|
---|
35 | The user should not release the joint inside this call!
|
---|
36 | Instead, if the user would like to have the joint
|
---|
37 | released and no longer holds any referenced to it, he should return true.
|
---|
38 | In this case the joint will be released by the system. Otherwise the user should return false.
|
---|
39 |
|
---|
40 | \param[in] breakingForce The force which caused the joint to break.
|
---|
41 | \param[in] brokenJoint The joint which has been broken.
|
---|
42 | \return \return True to have the system release the joint. False to keep the joint.
|
---|
43 |
|
---|
44 | <b>Platform:</b>
|
---|
45 | \li PC SW: Yes
|
---|
46 | \li PPU : No
|
---|
47 | \li PS3 : Yes
|
---|
48 | \li XB360: Yes
|
---|
49 |
|
---|
50 | @see NxJoint.setBreakable() NxJointDesc.maxForce NxJointDesc.maxTorque
|
---|
51 | */
|
---|
52 | virtual bool onJointBreak(NxReal breakingForce, NxJoint & brokenJoint) = 0;
|
---|
53 | };
|
---|
54 |
|
---|
55 | /** @} */
|
---|
56 | #endif
|
---|
57 |
|
---|
58 |
|
---|
59 | //AGCOPYRIGHTBEGIN
|
---|
60 | ///////////////////////////////////////////////////////////////////////////
|
---|
61 | // Copyright © 2005 AGEIA Technologies.
|
---|
62 | // All rights reserved. www.ageia.com
|
---|
63 | ///////////////////////////////////////////////////////////////////////////
|
---|
64 | //AGCOPYRIGHTEND
|
---|
65 |
|
---|