PhysX SDK 3.2 API Reference: PxSceneFlag Struct Reference

PhysX SDK 3.2 API

PxSceneFlag Struct Reference
[Physics]

flags for configuring properties of the scene More...

#include <PxSceneDesc.h>

List of all members.


Public Types

enum  Enum {
  eDISABLE_SSE = (1<<0),
  eENABLE_ACTIVETRANSFORMS = (1<<1),
  eENABLE_SWEPT_INTEGRATION = (1<<2),
  eADAPTIVE_FORCE = (1<<3),
  eENABLE_KINEMATIC_STATIC_PAIRS = (1<<4),
  eENABLE_KINEMATIC_PAIRS = (1<<5),
  eENABLE_ONE_DIRECTIONAL_FRICTION = (1<<6),
  eENABLE_TWO_DIRECTIONAL_FRICTION = (1<<7),
  eENABLE_PCM = (1 << 8),
  eDISABLE_CONTACT_REPORT_BUFFER_RESIZE = (1 << 9),
  eDISABLE_CONTACT_CACHE = (1 << 10)
}

Detailed Description

flags for configuring properties of the scene

See also:
PxScene

Member Enumeration Documentation

Enumerator:
eDISABLE_SSE  Used to disable use of SSE in the solver.

SSE is detected at runtime(on appropriate platforms) and used if present by default.

However use of SSE can be disabled, even if present, using this flag.

Platform:

  • PC SW: Yes
  • PS3 : N/A
  • XB360: N/A

eENABLE_ACTIVETRANSFORMS  Enable Active Transform Notification.

This flag enables the the Active Transform Notification feature for a scene. This feature defaults to disabled. When disabled, the function PxScene::getActiveTransforms() will always return a NULL list.

Note:
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.
Default: False

eENABLE_SWEPT_INTEGRATION  Enables a second broad phase check after integration that makes it possible to prevent objects from tunneling through eachother.

PxPairFlag::eSWEPT_INTEGRATION_LINEAR requires this flag to be specified.

Note:
For this feature to be effective for shapes that can move at a significant velocity, the user should raise the flag PxShapeFlag::eUSE_SWEPT_BOUNDS for them.
See also:
PxShapeFlag::eUSE_SWEPT_BOUNDS, PxPairFlag::eSWEPT_INTEGRATION_LINEAR

eADAPTIVE_FORCE  Enable adaptive forces to accelerate convergence of the solver.

Note that this flag is not mutable, and must be set in PxSceneDesc at scene creation.

Default: true

eENABLE_KINEMATIC_STATIC_PAIRS  Enable contact pair filtering between kinematic and static rigid bodies.

By default contacts between kinematic and static rigid bodies are suppressed (see PxFilterFlag::eSUPPRESS) and don't get reported to the filter mechanism. Raise this flag if these pairs should go through the filtering pipeline nonetheless.

Note that this flag is not mutable, and must be set in PxSceneDesc at scene creation.

Default: false

eENABLE_KINEMATIC_PAIRS  Enable contact pair filtering between kinematic rigid bodies.

By default contacts between kinematic bodies are suppressed (see PxFilterFlag::eSUPPRESS) and don't get reported to the filter mechanism. Raise this flag if these pairs should go through the filtering pipeline nonetheless.

Note that this flag is not mutable, and must be set in PxSceneDesc at scene creation.

Default: false

eENABLE_ONE_DIRECTIONAL_FRICTION  Enable one directional per-contact friction model.

Note that this flag is not mutable, and must be set in PxSceneDesc at scene creation.

Default: false

eENABLE_TWO_DIRECTIONAL_FRICTION  Enable two directional per-contact friction model.

Note that this flag is not mutable, and must be set in PxSceneDesc at scene creation.

Default: false

eENABLE_PCM  Enable GJK-based distance collision detection system.

Note that this flag is not mutable, and must be set in PxSceneDesc at scene creation.

In order to use this system, we need to register the system in the PxCreatePhysics

Default: false

eDISABLE_CONTACT_REPORT_BUFFER_RESIZE  Disable contact report buffer resize. Once the contact buffer is full, the rest of the contact reports will not be buffered and sent.

Note that this flag is not mutable, and must be set in PxSceneDesc at scene creation.

Default: false

eDISABLE_CONTACT_CACHE  Disable contact cache.

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.

Note that this flag is not mutable, and must be set in PxSceneDesc at scene creation.

Default: false


The documentation for this struct was generated from the following file:



Copyright © 2008-2012 NVIDIA Corporation, 2701 San Tomas Expressway, Santa Clara, CA 95050 U.S.A. All rights reserved. www.nvidia.com