1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
|
<html>
<head>
<title>NVIDIA(R) PhysX(R) SDK 3.4 API Reference: PxSceneFlag Struct Reference</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<LINK HREF="NVIDIA.css" REL="stylesheet" TYPE="text/css">
</head>
<body bgcolor="#FFFFFF">
<div id="header">
<hr class="first">
<img alt="" src="images/PhysXlogo.png" align="middle"> <br>
<center>
<a class="qindex" href="main.html">Main Page</a>
<a class="qindex" href="hierarchy.html">Class Hierarchy</a>
<a class="qindex" href="annotated.html">Compound List</a>
<a class="qindex" href="functions.html">Compound Members</a>
</center>
<hr class="second">
</div>
<!-- Generated by Doxygen 1.5.8 -->
<div class="contents">
<h1>PxSceneFlag Struct Reference<br>
<small>
[<a class="el" href="group__physics.html">Physics</a>]</small>
</h1><!-- doxytag: class="PxSceneFlag" -->flags for configuring properties of the scene
<a href="#_details">More...</a>
<p>
<code>#include <<a class="el" href="PxSceneDesc_8h-source.html">PxSceneDesc.h</a>></code>
<p>
<p>
<a href="structPxSceneFlag-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Public Types</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c53">Enum</a> { <br>
<a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c53b864a8d54af8c7baaedba117977a523f">eENABLE_ACTIVE_ACTORS</a> = (1<<0),
<br>
<a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c5338481fa715039972c2047d15094a1060">PX_DEPRECATED</a> = (1<<1),
<br>
<a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c5305d1e69880f10fb3de7d26c2e2e7eca3">eENABLE_CCD</a> = (1<<2),
<br>
<a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c53e5e231832542525c2c1faedcc4a49d11">eDISABLE_CCD_RESWEEP</a> = (1<<3),
<br>
<a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c53f41a174026200b36d385fbe91a67eac0">eADAPTIVE_FORCE</a> = (1<<4),
<br>
<a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c5338481fa715039972c2047d15094a1060">PX_DEPRECATED</a> = (1<<1),
<br>
<a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c5338481fa715039972c2047d15094a1060">PX_DEPRECATED</a> = (1<<1),
<br>
<a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c5329717fa631812cc31261d73055762e03">eENABLE_PCM</a> = (1 << 9),
<br>
<a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c538644817a9a2916453433702614672565">eDISABLE_CONTACT_REPORT_BUFFER_RESIZE</a> = (1 << 10),
<br>
<a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c539f72bafbe1387992429615ab5842b07a">eDISABLE_CONTACT_CACHE</a> = (1 << 11),
<br>
<a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c5397a4bafb1db3bba4b8ff373e16d67c5b">eREQUIRE_RW_LOCK</a> = (1 << 12),
<br>
<a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c53909e1cb63ea9c0394e2c2b3a526f47fe">eENABLE_STABILIZATION</a> = (1 << 14),
<br>
<a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c53641b016fe61d501e8cb5cdadd1b412ed">eENABLE_AVERAGE_POINT</a> = (1 << 15),
<br>
<a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c531d29a32a585c1463b30332ee8e328cad">eDEPRECATED_TRIGGER_TRIGGER_REPORTS</a> = (1 << 16),
<br>
<a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c53a645ccb938b901ce501b50ce55c15886">eEXCLUDE_KINEMATICS_FROM_ACTIVE_ACTORS</a> = (1 << 17),
<br>
<a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c5338481fa715039972c2047d15094a1060">PX_DEPRECATED</a> = (1<<1),
<br>
<a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c53fb55a7dd55b07e2ae234072e88d0b607">eENABLE_GPU_DYNAMICS</a> = (1 << 19),
<br>
<a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c53fc106b84674b04718dd78ea4640daf86">eENABLE_ENHANCED_DETERMINISM</a> = (1<<20),
<br>
<a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c5344d457656c5ac42d8318bfa2df7aee82">eMUTABLE_FLAGS</a> = eENABLE_ACTIVE_ACTORS|eENABLE_ACTIVETRANSFORMS|eEXCLUDE_KINEMATICS_FROM_ACTIVE_ACTORS
<br>
}</td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
flags for configuring properties of the scene
<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classPxScene.html" title="A scene is a collection of bodies, particle systems and constraints which can interact...">PxScene</a> </dd></dl>
<hr><h2>Member Enumeration Documentation</h2>
<a class="anchor" name="b4c347372b4433d34d983da780916c53"></a><!-- doxytag: member="PxSceneFlag::Enum" ref="b4c347372b4433d34d983da780916c53" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c53">PxSceneFlag::Enum</a> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<dl compact><dt><b>Enumerator: </b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"><em><a class="anchor" name="b4c347372b4433d34d983da780916c53b864a8d54af8c7baaedba117977a523f"></a><!-- doxytag: member="eENABLE_ACTIVE_ACTORS" ref="b4c347372b4433d34d983da780916c53b864a8d54af8c7baaedba117977a523f" args="" -->eENABLE_ACTIVE_ACTORS</em> </td><td>
Enable Active Actors Notification.
<p>
This flag enables the Active Actor Notification feature for a scene. This feature defaults to disabled. When disabled, the function <a class="el" href="classPxScene.html#c556f41a6fb051bae49765e3cbdbe3f8" title="Queries the PxScene for a list of the PxActors whose transforms have been updated...">PxScene::getActiveActors()</a> will always return a NULL list.<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>There may be a performance penalty for enabling the Active Actor Notification, hence this flag should only be enabled if the application intends to use the feature.</dd></dl>
<b>Default:</b> False </td></tr>
<tr><td valign="top"><em><a class="anchor" name="b4c347372b4433d34d983da780916c5338481fa715039972c2047d15094a1060"></a><!-- doxytag: member="PX_DEPRECATED" ref="b4c347372b4433d34d983da780916c5338481fa715039972c2047d15094a1060" args="" -->PX_DEPRECATED</em> </td><td>
Enable Active Transform Notification.
<p>
Lazily refit the dynamic scene query tree, instead of eagerly refitting in fetchResults.<p>
Enable contact pair filtering between kinematic rigid bodies.<p>
Enable contact pair filtering between kinematic and static rigid bodies.<p>
This flag enables the Active Transform Notification feature for a scene. This feature defaults to disabled. When disabled, the function <a class="el" href="classPxScene.html#5fdec7976b853ad4af5573bb13197426" title="Queries the PxScene for a list of the PxActors whose transforms have been updated...">PxScene::getActiveTransforms()</a> will always return a NULL list.<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>There may be a performance penalty for enabling the Active Transform Notification, hence this flag should only be enabled if the application intends to use the feature.</dd></dl>
<b>Default:</b> False<p>
By default contacts between kinematic and static rigid bodies are suppressed (see <a class="el" href="structPxFilterFlag.html#8de424e04d86b5772436423b0dc58083823b175755a63b3e8ad474528f5e1bf6" title="Ignore the collision pair as long as the bounding volumes of the pair objects overlap...">PxFilterFlag::eSUPPRESS</a>) and don't get reported to the filter mechanism. Raise this flag if these pairs should go through the filtering pipeline nonetheless.<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>This flag is not mutable, and must be set in <a class="el" href="classPxSceneDesc.html" title="Descriptor class for scenes. See PxScene.">PxSceneDesc</a> at scene creation.</dd></dl>
<b>Default:</b> false<p>
By default contacts between kinematic bodies are suppressed (see <a class="el" href="structPxFilterFlag.html#8de424e04d86b5772436423b0dc58083823b175755a63b3e8ad474528f5e1bf6" title="Ignore the collision pair as long as the bounding volumes of the pair objects overlap...">PxFilterFlag::eSUPPRESS</a>) and don't get reported to the filter mechanism. Raise this flag if these pairs should go through the filtering pipeline nonetheless.<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>This flag is not mutable, and must be set in <a class="el" href="classPxSceneDesc.html" title="Descriptor class for scenes. See PxScene.">PxSceneDesc</a> at scene creation.</dd></dl>
<b>Default:</b> false<p>
By default PhysX refits the dynamic scene query tree during fetchResults. Setting this flag during scene creation suppresses this behavior. Refit will then occur during the first scene query following fetchResults, or may be forced by the method PxScene::flushSceneQueryUpdates()<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Deprecated, will be replaced with an enum in next releases. <p>
This flag will be ignored if <a class="el" href="classPxSceneDesc.html#466c85f090678a01f2c6ee85b9584e7a" title="Defines the scene query update mode.">PxSceneDesc::sceneQueryUpdateMode</a> is set. <p>
This flag is not used anymore, please use <a class="el" href="structPxSceneQueryUpdateMode.html#04e575a313bce592e2b404eedf89a9d4">PxSceneQueryUpdateMode::Enum</a> instead</dd></dl>
<dl class="see" compact><dt><b>See also:</b></dt><dd>PxScene::flushSceneQueryUpdates()</dd></dl>
<b>Default:</b> false </td></tr>
<tr><td valign="top"><em><a class="anchor" name="b4c347372b4433d34d983da780916c5305d1e69880f10fb3de7d26c2e2e7eca3"></a><!-- doxytag: member="eENABLE_CCD" ref="b4c347372b4433d34d983da780916c5305d1e69880f10fb3de7d26c2e2e7eca3" args="" -->eENABLE_CCD</em> </td><td>
Enables a second broad phase check after integration that makes it possible to prevent objects from tunneling through eachother.
<p>
<a class="el" href="structPxPairFlag.html#60e71a2948b030140f840766a3f7ac2fc41a9f8b9326480403c023ad20cdc2f1" title="This flag is used to indicate whether this pair generates CCD contacts.">PxPairFlag::eDETECT_CCD_CONTACT</a> requires this flag to be specified.<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>For this feature to be effective for bodies that can move at a significant velocity, the user should raise the flag <a class="el" href="structPxRigidBodyFlag.html#5fd4878ae66a98c030a9d976e8ba8596686cdd889652a435c19d8c663d809d9e" title="Enables swept integration for the actor.">PxRigidBodyFlag::eENABLE_CCD</a> for them. <p>
This flag is not mutable, and must be set in <a class="el" href="classPxSceneDesc.html" title="Descriptor class for scenes. See PxScene.">PxSceneDesc</a> at scene creation.</dd></dl>
<b>Default:</b> False<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="structPxRigidBodyFlag.html#5fd4878ae66a98c030a9d976e8ba8596686cdd889652a435c19d8c663d809d9e" title="Enables swept integration for the actor.">PxRigidBodyFlag::eENABLE_CCD</a>, <a class="el" href="structPxPairFlag.html#60e71a2948b030140f840766a3f7ac2fc41a9f8b9326480403c023ad20cdc2f1" title="This flag is used to indicate whether this pair generates CCD contacts.">PxPairFlag::eDETECT_CCD_CONTACT</a>, <a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c53e5e231832542525c2c1faedcc4a49d11" title="Enables a simplified swept integration strategy, which sacrifices some accuracy for...">eDISABLE_CCD_RESWEEP</a> </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" name="b4c347372b4433d34d983da780916c53e5e231832542525c2c1faedcc4a49d11"></a><!-- doxytag: member="eDISABLE_CCD_RESWEEP" ref="b4c347372b4433d34d983da780916c53e5e231832542525c2c1faedcc4a49d11" args="" -->eDISABLE_CCD_RESWEEP</em> </td><td>
Enables a simplified swept integration strategy, which sacrifices some accuracy for improved performance.
<p>
This simplified swept integration approach makes certain assumptions about the motion of objects that are not made when using a full swept integration. These assumptions usually hold but there are cases where they could result in incorrect behavior between a set of fast-moving rigid bodies. A key issue is that fast-moving dynamic objects may tunnel through each-other after a rebound. This will not happen if this mode is disabled. However, this approach will be potentially faster than a full swept integration because it will perform significantly fewer sweeps in non-trivial scenes involving many fast-moving objects. This approach should successfully resist objects passing through the static environment.<p>
<a class="el" href="structPxPairFlag.html#60e71a2948b030140f840766a3f7ac2fc41a9f8b9326480403c023ad20cdc2f1" title="This flag is used to indicate whether this pair generates CCD contacts.">PxPairFlag::eDETECT_CCD_CONTACT</a> requires this flag to be specified.<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>This scene flag requires eENABLE_CCD to be enabled as well. If it is not, this scene flag will do nothing. <p>
For this feature to be effective for bodies that can move at a significant velocity, the user should raise the flag <a class="el" href="structPxRigidBodyFlag.html#5fd4878ae66a98c030a9d976e8ba8596686cdd889652a435c19d8c663d809d9e" title="Enables swept integration for the actor.">PxRigidBodyFlag::eENABLE_CCD</a> for them. <p>
This flag is not mutable, and must be set in <a class="el" href="classPxSceneDesc.html" title="Descriptor class for scenes. See PxScene.">PxSceneDesc</a> at scene creation.</dd></dl>
<b>Default:</b> False<p>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="structPxRigidBodyFlag.html#5fd4878ae66a98c030a9d976e8ba8596686cdd889652a435c19d8c663d809d9e" title="Enables swept integration for the actor.">PxRigidBodyFlag::eENABLE_CCD</a>, <a class="el" href="structPxPairFlag.html#60e71a2948b030140f840766a3f7ac2fc41a9f8b9326480403c023ad20cdc2f1" title="This flag is used to indicate whether this pair generates CCD contacts.">PxPairFlag::eDETECT_CCD_CONTACT</a>, <a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c5305d1e69880f10fb3de7d26c2e2e7eca3" title="Enables a second broad phase check after integration that makes it possible to prevent...">eENABLE_CCD</a> </dd></dl>
</td></tr>
<tr><td valign="top"><em><a class="anchor" name="b4c347372b4433d34d983da780916c53f41a174026200b36d385fbe91a67eac0"></a><!-- doxytag: member="eADAPTIVE_FORCE" ref="b4c347372b4433d34d983da780916c53f41a174026200b36d385fbe91a67eac0" args="" -->eADAPTIVE_FORCE</em> </td><td>
Enable adaptive forces to accelerate convergence of the solver.
<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>This flag is not mutable, and must be set in <a class="el" href="classPxSceneDesc.html" title="Descriptor class for scenes. See PxScene.">PxSceneDesc</a> at scene creation.</dd></dl>
<b>Default:</b> false </td></tr>
<tr><td valign="top"><em><a class="anchor" name="b4c347372b4433d34d983da780916c5338481fa715039972c2047d15094a1060"></a><!-- doxytag: member="PX_DEPRECATED" ref="b4c347372b4433d34d983da780916c5338481fa715039972c2047d15094a1060" args="" -->PX_DEPRECATED</em> </td><td>
Enable Active Transform Notification.
<p>
Lazily refit the dynamic scene query tree, instead of eagerly refitting in fetchResults.<p>
Enable contact pair filtering between kinematic rigid bodies.<p>
Enable contact pair filtering between kinematic and static rigid bodies.<p>
This flag enables the Active Transform Notification feature for a scene. This feature defaults to disabled. When disabled, the function <a class="el" href="classPxScene.html#5fdec7976b853ad4af5573bb13197426" title="Queries the PxScene for a list of the PxActors whose transforms have been updated...">PxScene::getActiveTransforms()</a> will always return a NULL list.<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>There may be a performance penalty for enabling the Active Transform Notification, hence this flag should only be enabled if the application intends to use the feature.</dd></dl>
<b>Default:</b> False<p>
By default contacts between kinematic and static rigid bodies are suppressed (see <a class="el" href="structPxFilterFlag.html#8de424e04d86b5772436423b0dc58083823b175755a63b3e8ad474528f5e1bf6" title="Ignore the collision pair as long as the bounding volumes of the pair objects overlap...">PxFilterFlag::eSUPPRESS</a>) and don't get reported to the filter mechanism. Raise this flag if these pairs should go through the filtering pipeline nonetheless.<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>This flag is not mutable, and must be set in <a class="el" href="classPxSceneDesc.html" title="Descriptor class for scenes. See PxScene.">PxSceneDesc</a> at scene creation.</dd></dl>
<b>Default:</b> false<p>
By default contacts between kinematic bodies are suppressed (see <a class="el" href="structPxFilterFlag.html#8de424e04d86b5772436423b0dc58083823b175755a63b3e8ad474528f5e1bf6" title="Ignore the collision pair as long as the bounding volumes of the pair objects overlap...">PxFilterFlag::eSUPPRESS</a>) and don't get reported to the filter mechanism. Raise this flag if these pairs should go through the filtering pipeline nonetheless.<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>This flag is not mutable, and must be set in <a class="el" href="classPxSceneDesc.html" title="Descriptor class for scenes. See PxScene.">PxSceneDesc</a> at scene creation.</dd></dl>
<b>Default:</b> false<p>
By default PhysX refits the dynamic scene query tree during fetchResults. Setting this flag during scene creation suppresses this behavior. Refit will then occur during the first scene query following fetchResults, or may be forced by the method PxScene::flushSceneQueryUpdates()<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Deprecated, will be replaced with an enum in next releases. <p>
This flag will be ignored if <a class="el" href="classPxSceneDesc.html#466c85f090678a01f2c6ee85b9584e7a" title="Defines the scene query update mode.">PxSceneDesc::sceneQueryUpdateMode</a> is set. <p>
This flag is not used anymore, please use <a class="el" href="structPxSceneQueryUpdateMode.html#04e575a313bce592e2b404eedf89a9d4">PxSceneQueryUpdateMode::Enum</a> instead</dd></dl>
<dl class="see" compact><dt><b>See also:</b></dt><dd>PxScene::flushSceneQueryUpdates()</dd></dl>
<b>Default:</b> false </td></tr>
<tr><td valign="top"><em><a class="anchor" name="b4c347372b4433d34d983da780916c5338481fa715039972c2047d15094a1060"></a><!-- doxytag: member="PX_DEPRECATED" ref="b4c347372b4433d34d983da780916c5338481fa715039972c2047d15094a1060" args="" -->PX_DEPRECATED</em> </td><td>
Enable Active Transform Notification.
<p>
Lazily refit the dynamic scene query tree, instead of eagerly refitting in fetchResults.<p>
Enable contact pair filtering between kinematic rigid bodies.<p>
Enable contact pair filtering between kinematic and static rigid bodies.<p>
This flag enables the Active Transform Notification feature for a scene. This feature defaults to disabled. When disabled, the function <a class="el" href="classPxScene.html#5fdec7976b853ad4af5573bb13197426" title="Queries the PxScene for a list of the PxActors whose transforms have been updated...">PxScene::getActiveTransforms()</a> will always return a NULL list.<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>There may be a performance penalty for enabling the Active Transform Notification, hence this flag should only be enabled if the application intends to use the feature.</dd></dl>
<b>Default:</b> False<p>
By default contacts between kinematic and static rigid bodies are suppressed (see <a class="el" href="structPxFilterFlag.html#8de424e04d86b5772436423b0dc58083823b175755a63b3e8ad474528f5e1bf6" title="Ignore the collision pair as long as the bounding volumes of the pair objects overlap...">PxFilterFlag::eSUPPRESS</a>) and don't get reported to the filter mechanism. Raise this flag if these pairs should go through the filtering pipeline nonetheless.<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>This flag is not mutable, and must be set in <a class="el" href="classPxSceneDesc.html" title="Descriptor class for scenes. See PxScene.">PxSceneDesc</a> at scene creation.</dd></dl>
<b>Default:</b> false<p>
By default contacts between kinematic bodies are suppressed (see <a class="el" href="structPxFilterFlag.html#8de424e04d86b5772436423b0dc58083823b175755a63b3e8ad474528f5e1bf6" title="Ignore the collision pair as long as the bounding volumes of the pair objects overlap...">PxFilterFlag::eSUPPRESS</a>) and don't get reported to the filter mechanism. Raise this flag if these pairs should go through the filtering pipeline nonetheless.<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>This flag is not mutable, and must be set in <a class="el" href="classPxSceneDesc.html" title="Descriptor class for scenes. See PxScene.">PxSceneDesc</a> at scene creation.</dd></dl>
<b>Default:</b> false<p>
By default PhysX refits the dynamic scene query tree during fetchResults. Setting this flag during scene creation suppresses this behavior. Refit will then occur during the first scene query following fetchResults, or may be forced by the method PxScene::flushSceneQueryUpdates()<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Deprecated, will be replaced with an enum in next releases. <p>
This flag will be ignored if <a class="el" href="classPxSceneDesc.html#466c85f090678a01f2c6ee85b9584e7a" title="Defines the scene query update mode.">PxSceneDesc::sceneQueryUpdateMode</a> is set. <p>
This flag is not used anymore, please use <a class="el" href="structPxSceneQueryUpdateMode.html#04e575a313bce592e2b404eedf89a9d4">PxSceneQueryUpdateMode::Enum</a> instead</dd></dl>
<dl class="see" compact><dt><b>See also:</b></dt><dd>PxScene::flushSceneQueryUpdates()</dd></dl>
<b>Default:</b> false </td></tr>
<tr><td valign="top"><em><a class="anchor" name="b4c347372b4433d34d983da780916c5329717fa631812cc31261d73055762e03"></a><!-- doxytag: member="eENABLE_PCM" ref="b4c347372b4433d34d983da780916c5329717fa631812cc31261d73055762e03" args="" -->eENABLE_PCM</em> </td><td>
Enable GJK-based distance collision detection system.
<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>This flag is not mutable, and must be set in <a class="el" href="classPxSceneDesc.html" title="Descriptor class for scenes. See PxScene.">PxSceneDesc</a> at scene creation.</dd></dl>
<b>Default:</b> true </td></tr>
<tr><td valign="top"><em><a class="anchor" name="b4c347372b4433d34d983da780916c538644817a9a2916453433702614672565"></a><!-- doxytag: member="eDISABLE_CONTACT_REPORT_BUFFER_RESIZE" ref="b4c347372b4433d34d983da780916c538644817a9a2916453433702614672565" args="" -->eDISABLE_CONTACT_REPORT_BUFFER_RESIZE</em> </td><td>
Disable contact report buffer resize. Once the contact buffer is full, the rest of the contact reports will not be buffered and sent.
<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>This flag is not mutable, and must be set in <a class="el" href="classPxSceneDesc.html" title="Descriptor class for scenes. See PxScene.">PxSceneDesc</a> at scene creation.</dd></dl>
<b>Default:</b> false </td></tr>
<tr><td valign="top"><em><a class="anchor" name="b4c347372b4433d34d983da780916c539f72bafbe1387992429615ab5842b07a"></a><!-- doxytag: member="eDISABLE_CONTACT_CACHE" ref="b4c347372b4433d34d983da780916c539f72bafbe1387992429615ab5842b07a" args="" -->eDISABLE_CONTACT_CACHE</em> </td><td>
Disable contact cache.
<p>
Contact caches are used internally to provide faster contact generation. You can disable all contact caches if memory usage for this feature becomes too high.<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>This flag is not mutable, and must be set in <a class="el" href="classPxSceneDesc.html" title="Descriptor class for scenes. See PxScene.">PxSceneDesc</a> at scene creation.</dd></dl>
<b>Default:</b> false </td></tr>
<tr><td valign="top"><em><a class="anchor" name="b4c347372b4433d34d983da780916c5397a4bafb1db3bba4b8ff373e16d67c5b"></a><!-- doxytag: member="eREQUIRE_RW_LOCK" ref="b4c347372b4433d34d983da780916c5397a4bafb1db3bba4b8ff373e16d67c5b" args="" -->eREQUIRE_RW_LOCK</em> </td><td>
Require scene-level locking.
<p>
When set to true this requires that threads accessing the <a class="el" href="classPxScene.html" title="A scene is a collection of bodies, particle systems and constraints which can interact...">PxScene</a> use the multi-threaded lock methods.<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>This flag is not mutable, and must be set in <a class="el" href="classPxSceneDesc.html" title="Descriptor class for scenes. See PxScene.">PxSceneDesc</a> at scene creation.</dd></dl>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classPxScene.html#088a9978be5b160b79665d4fb471ec81" title="Lock the scene for reading from the calling thread.">PxScene::lockRead</a> <p>
<a class="el" href="classPxScene.html#ca7f8e7bc71ad39645b787bc41ab8c13" title="Unlock the scene from reading.">PxScene::unlockRead</a> <p>
<a class="el" href="classPxScene.html#89d45878685fa31bb2684c096d2c6918" title="Lock the scene for writing from this thread.">PxScene::lockWrite</a> <p>
<a class="el" href="classPxScene.html#f2fa25d740641e78ae934c0488f17a4d" title="Unlock the scene from writing.">PxScene::unlockWrite</a></dd></dl>
<b>Default:</b> false </td></tr>
<tr><td valign="top"><em><a class="anchor" name="b4c347372b4433d34d983da780916c53909e1cb63ea9c0394e2c2b3a526f47fe"></a><!-- doxytag: member="eENABLE_STABILIZATION" ref="b4c347372b4433d34d983da780916c53909e1cb63ea9c0394e2c2b3a526f47fe" args="" -->eENABLE_STABILIZATION</em> </td><td>
Enables additional stabilization pass in solver.
<p>
When set to true, this enables additional stabilization processing to improve that stability of complex interactions between large numbers of bodies.<p>
Note that this flag is not mutable and must be set in <a class="el" href="classPxSceneDesc.html" title="Descriptor class for scenes. See PxScene.">PxSceneDesc</a> at scene creation. Also, this is an experimental feature which does result in some loss of momentum. </td></tr>
<tr><td valign="top"><em><a class="anchor" name="b4c347372b4433d34d983da780916c53641b016fe61d501e8cb5cdadd1b412ed"></a><!-- doxytag: member="eENABLE_AVERAGE_POINT" ref="b4c347372b4433d34d983da780916c53641b016fe61d501e8cb5cdadd1b412ed" args="" -->eENABLE_AVERAGE_POINT</em> </td><td>
Enables average points in contact manifolds.
<p>
When set to true, this enables additional contacts to be generated per manifold to represent the average point in a manifold. This can stabilize stacking when only a small number of solver iterations is used.<p>
Note that this flag is not mutable and must be set in <a class="el" href="classPxSceneDesc.html" title="Descriptor class for scenes. See PxScene.">PxSceneDesc</a> at scene creation. </td></tr>
<tr><td valign="top"><em><a class="anchor" name="b4c347372b4433d34d983da780916c531d29a32a585c1463b30332ee8e328cad"></a><!-- doxytag: member="eDEPRECATED_TRIGGER_TRIGGER_REPORTS" ref="b4c347372b4433d34d983da780916c531d29a32a585c1463b30332ee8e328cad" args="" -->eDEPRECATED_TRIGGER_TRIGGER_REPORTS</em> </td><td>
Enable legacy behavior to get trigger reports for interactions between two trigger shapes.
<p>
By default PhysX does not report trigger interactions between two trigger shapes any longer. Raise this flag to still get the corresponding reports.<p>
Note that this flag is not mutable and must be set in <a class="el" href="classPxSceneDesc.html" title="Descriptor class for scenes. See PxScene.">PxSceneDesc</a> at scene creation.<p>
<dl compact><dt><b><a class="el" href="deprecated.html#_deprecated000046">Deprecated:</a></b></dt><dd>This flag is deprecated and will be removed in PhysX 3.5.</dd></dl>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="classPxSimulationEventCallback.html#768b2ee9fe28736da3fcdc6a0eae9733" title="This is called with the current trigger pair events.">PxSimulationEventCallback::onTrigger()</a></dd></dl>
<b>Default:</b> false </td></tr>
<tr><td valign="top"><em><a class="anchor" name="b4c347372b4433d34d983da780916c53a645ccb938b901ce501b50ce55c15886"></a><!-- doxytag: member="eEXCLUDE_KINEMATICS_FROM_ACTIVE_ACTORS" ref="b4c347372b4433d34d983da780916c53a645ccb938b901ce501b50ce55c15886" args="" -->eEXCLUDE_KINEMATICS_FROM_ACTIVE_ACTORS</em> </td><td>
Do not report kinematics in list of active actors/transforms.
<p>
Since the target pose for kinematics is set by the user, an application can track the activity state directly and use this flag to avoid that kinematics get added to the list of active actors/transforms.<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>This flag has only an effect in combination with eENABLE_ACTIVE_ACTORS or eENABLE_ACTIVETRANSFORMS.</dd></dl>
<dl class="see" compact><dt><b>See also:</b></dt><dd><a class="el" href="structPxSceneFlag.html#b4c347372b4433d34d983da780916c53b864a8d54af8c7baaedba117977a523f" title="Enable Active Actors Notification.">eENABLE_ACTIVE_ACTORS</a> eENABLE_ACTIVETRANSFORMS</dd></dl>
<b>Default:</b> false </td></tr>
<tr><td valign="top"><em><a class="anchor" name="b4c347372b4433d34d983da780916c5338481fa715039972c2047d15094a1060"></a><!-- doxytag: member="PX_DEPRECATED" ref="b4c347372b4433d34d983da780916c5338481fa715039972c2047d15094a1060" args="" -->PX_DEPRECATED</em> </td><td>
Enable Active Transform Notification.
<p>
Lazily refit the dynamic scene query tree, instead of eagerly refitting in fetchResults.<p>
Enable contact pair filtering between kinematic rigid bodies.<p>
Enable contact pair filtering between kinematic and static rigid bodies.<p>
This flag enables the Active Transform Notification feature for a scene. This feature defaults to disabled. When disabled, the function <a class="el" href="classPxScene.html#5fdec7976b853ad4af5573bb13197426" title="Queries the PxScene for a list of the PxActors whose transforms have been updated...">PxScene::getActiveTransforms()</a> will always return a NULL list.<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>There may be a performance penalty for enabling the Active Transform Notification, hence this flag should only be enabled if the application intends to use the feature.</dd></dl>
<b>Default:</b> False<p>
By default contacts between kinematic and static rigid bodies are suppressed (see <a class="el" href="structPxFilterFlag.html#8de424e04d86b5772436423b0dc58083823b175755a63b3e8ad474528f5e1bf6" title="Ignore the collision pair as long as the bounding volumes of the pair objects overlap...">PxFilterFlag::eSUPPRESS</a>) and don't get reported to the filter mechanism. Raise this flag if these pairs should go through the filtering pipeline nonetheless.<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>This flag is not mutable, and must be set in <a class="el" href="classPxSceneDesc.html" title="Descriptor class for scenes. See PxScene.">PxSceneDesc</a> at scene creation.</dd></dl>
<b>Default:</b> false<p>
By default contacts between kinematic bodies are suppressed (see <a class="el" href="structPxFilterFlag.html#8de424e04d86b5772436423b0dc58083823b175755a63b3e8ad474528f5e1bf6" title="Ignore the collision pair as long as the bounding volumes of the pair objects overlap...">PxFilterFlag::eSUPPRESS</a>) and don't get reported to the filter mechanism. Raise this flag if these pairs should go through the filtering pipeline nonetheless.<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>This flag is not mutable, and must be set in <a class="el" href="classPxSceneDesc.html" title="Descriptor class for scenes. See PxScene.">PxSceneDesc</a> at scene creation.</dd></dl>
<b>Default:</b> false<p>
By default PhysX refits the dynamic scene query tree during fetchResults. Setting this flag during scene creation suppresses this behavior. Refit will then occur during the first scene query following fetchResults, or may be forced by the method PxScene::flushSceneQueryUpdates()<p>
<dl class="note" compact><dt><b>Note:</b></dt><dd>Deprecated, will be replaced with an enum in next releases. <p>
This flag will be ignored if <a class="el" href="classPxSceneDesc.html#466c85f090678a01f2c6ee85b9584e7a" title="Defines the scene query update mode.">PxSceneDesc::sceneQueryUpdateMode</a> is set. <p>
This flag is not used anymore, please use <a class="el" href="structPxSceneQueryUpdateMode.html#04e575a313bce592e2b404eedf89a9d4">PxSceneQueryUpdateMode::Enum</a> instead</dd></dl>
<dl class="see" compact><dt><b>See also:</b></dt><dd>PxScene::flushSceneQueryUpdates()</dd></dl>
<b>Default:</b> false </td></tr>
<tr><td valign="top"><em><a class="anchor" name="b4c347372b4433d34d983da780916c53fb55a7dd55b07e2ae234072e88d0b607"></a><!-- doxytag: member="eENABLE_GPU_DYNAMICS" ref="b4c347372b4433d34d983da780916c53fb55a7dd55b07e2ae234072e88d0b607" args="" -->eENABLE_GPU_DYNAMICS</em> </td><td>
</td></tr>
<tr><td valign="top"><em><a class="anchor" name="b4c347372b4433d34d983da780916c53fc106b84674b04718dd78ea4640daf86"></a><!-- doxytag: member="eENABLE_ENHANCED_DETERMINISM" ref="b4c347372b4433d34d983da780916c53fc106b84674b04718dd78ea4640daf86" args="" -->eENABLE_ENHANCED_DETERMINISM</em> </td><td>
Provides improved determinism at the expense of performance.
<p>
By default, PhysX provides limited determinism guarantees. Specifically, PhysX guarantees that the exact scene (same actors created in the same order) and simulated using the same time-stepping scheme should provide the exact same behaviour.<p>
However, if additional actors are added to the simulation, this can affect the behaviour of the existing actors in the simulation, even if the set of new actors do not interact with the existing actors.<p>
This flag provides an additional level of determinism that guarantees that the simulation will not change if additional actors are added to the simulation, provided those actors do not interfere with the existing actors in the scene. Determinism is only guaranteed if the actors are inserted in a consistent order each run in a newly-created scene and simulated using a consistent time-stepping scheme.<p>
Note that this flag is not mutable and must be set at scene creation.<p>
Note that enabling this flag can have a negative impact on performance.<p>
Note that this feature is not currently supported on GPU.<p>
<b>Default</b> false </td></tr>
<tr><td valign="top"><em><a class="anchor" name="b4c347372b4433d34d983da780916c5344d457656c5ac42d8318bfa2df7aee82"></a><!-- doxytag: member="eMUTABLE_FLAGS" ref="b4c347372b4433d34d983da780916c5344d457656c5ac42d8318bfa2df7aee82" args="" -->eMUTABLE_FLAGS</em> </td><td>
</td></tr>
</table>
</dl>
</div>
</div><p>
<hr>The documentation for this struct was generated from the following file:<ul>
<li><a class="el" href="PxSceneDesc_8h-source.html">PxSceneDesc.h</a></ul>
</div>
<hr style="width: 100%; height: 2px;"><br>
Copyright © 2008-2018 NVIDIA Corporation, 2701 San Tomas Expressway, Santa Clara, CA 95050 U.S.A. All rights reserved. <a href="http://www.nvidia.com ">www.nvidia.com</a>
</body>
</html>
|