User's Guide

Built November 02, 2015

Contents:

• Welcome to PhysX
  • About this User Guide
  • Physics vs. PhysX
  • World and Objects
• Distro Package Contents
  • Release Layout
    • Core Installer
    • Source Installer adds the following to the above:
  • Snippets versus Samples
  • Building and Running the Samples on Windows
• Snippets
  • What are PhysX Snippets?
  • HelloWorld: PhysX Basics
  • Using PhysX Visual Debugger with SnippetHelloWorld
• Building with PhysX
  • Build Settings
  • Build Configurations
  • Header Files
  • Libraries
  • Redistribution
• The PhysX API
  • Introduction
  • Memory Management
  • Error Reporting
  • Math Classes
  • Connecting PhysX Objects with User Application Objects
  • Type Casting
  • Reference Counting
  • Using Different Units
  • Assertions
• Startup and Shutdown
  • Introduction
  • Foundation and Physics
  • Cooking
  • Extensions
  • Optional SDK Components
  • Delay-Loading DLLs
    • PhysXCommon DLL load
    • PxDelayLoadHook
    • PhysXCommon Secure Load
  • Shutting Down
• Threading
  • Introduction
  • Data Access from Multiple Threads
    • Scene Locking
    • Locking Semantics
    • Locking Best Practices
  • Asynchronous Simulation
    • Double Buffering
    • Events involving removed objects
    • Support
    • Memory Considerations
  • Multithreaded Simulation
    • PxTaskManager
    • PxCpuDispatcher
    • PxCpuDispatcher Implementation Guidelines
    • PxBaseTask
    • PxTask
    • PxLightCpuTask
• Geometry
  • Introduction
  • Geometry Types
    • Spheres
    • Capsules
    • Boxes
    • Planes
    • Convex Meshes
    • Convex Mesh cooking
    • Triangle Meshes
    • Height Fields
  • Mesh Scaling
  • PxGeometryHolder
  • Vertex and Face Data
    • Convex Meshes
    • Triangle Meshes
    • Height Fields
    • Heightfield Modification
• Rigid Body Overview
  • Introduction
  • Rigid Body Object Model
  • The Simulation Loop
• Rigid Body Collision
  • Introduction
  • Shapes
  • Simulation Shapes and Scene Query Shapes
  • Kinematic Triangle Meshes (Planes, Heighfields)
  • Broad-phase Algorithms
  • Regions of Interest
  • Broad-phase Callback
  • Collision Filtering
  • Aggregates
  • Creating an Aggregate
  • Populating an Aggregate
  • Releasing an Aggregate
  • Amortizing Insertion
  • Trigger Shapes
  • Interactions
• Rigid Body Dynamics
  • Velocity
  • Mass Properties
  • Applying Forces and Torques
  • Gravity
  • Friction and Restitution
  • Sleeping
    • Sleep state change events
  • Kinematic Actors
  • Active Transforms
  • Dominance
  • Solver Iterations
• Simulation
  • Callback Sequence
  • Simulation memory
    • Scene Limits
    • 16K Data Blocks
    • Scratch Buffer
    • In-place Serialization
    • PVD Integration
  • Completion Tasks
  • Synchronizing with Other Threads
  • Substepping
• Advanced Collision Detection
  • Tuning Shape Collision Behavior
  • Contact Modification
  • Contact reporting
    • Contact Reports and CCD
  • Extracting Contact information
    • Extra Contact Data
  • Continuous Collision Detection
    • Contact Notification and Modification
    • Triggers
    • Tuning CCD
    • Performance Implications
    • Limitations
  • Persistent Contact Manifold (PCM)
• Joints
  • Joint Basics
    • Visualization
    • Force Reporting
    • Breakage
    • Projection
    • Limits
    • Actuation
    • Mass Scaling
  • Fixed Joint
  • Spherical Joint
  • Revolute Joint
  • Prismatic Joint
  • Distance Joint
  • D6 Joint
    • Locking and Unlocking Axes
    • Limits
    • Drives
    • Configuring Joints for Best Behavior
  • Custom Constraints
    • Defining Constraint Behavior
    • The Constraint Shader Table
    • Data Management
• Articulations
  • Creating an Articulation
  • Articulation Joints
  • Driving an Articulation
  • Articulation Projection
  • Articulations and Sleeping
• Scene Origin
  • Shifting The Scene Origin
• Geometry Queries
  • Introduction
  • Raycasts
    • Raycasts against Spheres, Capsules, Boxes and Convex Meshes
    • Raycasts against Planes
    • Raycasts against Triangle Meshes
    • Raycasts against Heightfields
  • Overlaps
  • Penetration Depth
  • Sweeps
    • Initial Overlaps
    • Precise Sweeps
    • Sweeps against Height Fields
    • Pitfalls
  • Additional PxGeometryQuery functions
  • PxMeshQuery
    • Mesh Overlaps
    • Sweeps against Triangles
• Spatial Queries
  • PxSpatialIndex
• Scene Queries
  • Introduction
  • Basic queries
    • Raycasts
    • Sweeps
    • Overlaps
  • Touching and blocking hits
  • Query modes
    • Closest hit
    • Any hit
    • Multiple hits
    • Multiple hits with blocking hit
  • Filtering
    • PxQueryFlag::eSTATIC, PxQueryFlag::eDYNAMIC
    • PxQueryFlag::ePREFILTER, PxQueryFlag::ePOSTFILTER
    • PxQueryFlag::eANY_HIT
    • PxQueryFlag::eNO_BLOCK
    • PxFilterData fixed function filtering
  • User defined hit callbacks for unbounded results
  • Batched queries
  • Volume Caching
    • Filling the Cache
    • Querying the Cache
  • Single Object Caching
  • PxPruningStructure
    • Generalities
    • PxPruningStructure::eNONE
    • PxPruningStructure::eSTATIC_AABB_TREE
    • PxPruningStructure::eDYNAMIC_AABB_TREE
• Vehicles
  • Introduction
  • Algorithm
  • First Code
    • Vehicle SDK Initialization
    • Introduction To Vehicle Creation
    • Introduction To Vehicle Update
  • Snippets
    • SnippetVehicle4W
    • SnippetVehicleTank
    • SnippetVehicleScale
    • SnippetVehicleMultiThreading
  • Advanced Concepts
    • Vehicle Creation
    • Filtering
    • Tire Friction on Drivable Surfaces
    • Vehicle Controls
    • Vehicle Update
  • More Advanced Concepts
    • Vehicle Telemetry
    • Vehicle Update Multi-Threaded
    • Tire Shaders
    • Vehicle Types
    • SI Units
    • Level of Detail
  • Tuning Guide
    • PxVehicleWheelData
    • PxVehicleWheelsSimData
    • PxVehicleSuspensionData
    • PxVehicleTireData
    • PxVehicleEngineData
    • PxVehicleGearsData
    • PxVehicleAutoBoxData
    • PxVehicleClutchData
    • PxVehicleAckermannGeometryData
    • PxVehicleTireLoadFilterData
    • PxVehicleDifferential4WData
    • PxRigidDynamic
  • Troubleshooting
    • Jittery Vehicles
    • The Engine Rotation Refuses To Spin Quickly
    • The Engine Spins But the Wheels Refuse To Spin
    • The Wheels Are Spinning But The Vehicle Does Not Move Forwards
    • The Vehicle Does Not Steer/Turn
    • The Acceleration Feels Sluggish
    • The Vehicle Does Not Slow Down When Not Accelerating
    • The Vehicle Turns Too Quickly/Too Slowly
    • The Wheels Spin Too Much Under Acceleration
    • The Wheels Spin Too Much When Cornering
    • The Vehicle Never Goes Beyond First Gear
    • The Vehicle Under-steers Then Over-steers
    • The Vehicle Slows Down Unnaturally
    • The Vehicle Climbs Too Steep Slopes
  • References
    • Tire Modeling
    • Engine Torque Curves
    • Differentials
    • Clutch
    • Ackermann Steer Correction
    • Tanks
    • General
• Character Controllers
  • Introduction
  • Kinematic Character Controller
  • Creating a character controller
  • Overlap Recovery Module
  • Character Volume
  • Volume Update
  • Moving a Character Controller
  • Graphics Update
  • Auto Stepping
  • Climbing Mode
  • Up Vector
  • Walkable Parts & Invisible Walls
  • Obstacle Objects
  • Hit Callback
  • Behavior Callback
  • Character Interactions: CCT-vs-dynamic actors
  • Character Interactions: CCT-vs-CCT
  • Hidden Kinematic Actors
  • Time Stepping
  • Invalidating Internal Geometry Caches
  • Runtime Tessellation
  • Troubleshooting
    • Character goes through walls in rare cases
    • Tessellation performance issue
    • The capsule controller manages to climb over obstacles higher than the step offset value
• Particles
  • Introduction
  • Creating Particle Systems
  • Particle Management
    • Creating Particles
    • Releasing Particles
    • Index Pool Extension
    • Updating Particles
    • Reading Particles
  • Parameter Guide
    • Particle Dynamics
    • Collision with Rigid Actors
    • Fluid (PxParticleFluid)
  • Collision Handling
    • Collision Filtering
    • Per-particle Rest Offsets
    • Particle Drains
  • Best Practices / Troubleshooting
    • Particle Grid and Spatial Data Structure Overflow
  • GPU/CUDA Acceleration
  • Sample Discussion
  • References
• Cloth
  • Introduction
  • Simulation Algorithm
    • Solver Frequency
    • Particle Integration
    • Local Space Simulation and Inertia Scale
    • Constraints
    • Distance Constraints
    • Tether Constraints
    • Motion Constraints
    • Separation Constraints
    • Collision Detection
    • Continuous Collision Detection
    • Virtual Particle Collision
    • Friction and Mass Scaling
    • Self-Collision of a Single Cloth Actor
    • Inter-Collision between Multiple Cloth Actors
  • Best Practices / Troubleshooting
    • Performance Tips
    • Using GPU Cloth
    • Fast-Moving Characters
    • Avoiding Stretching
    • Avoiding Jitter
    • PVD Support
  • Snippet Discussion
    • Filling in PxClothMeshDesc
    • Creating Fabric
    • Creating Cloth
    • Specifying Collision Shapes
    • Adding Virtual Particles
    • Accessing Particle Data
  • References
• ProfileZoneManager and ProfileZone
  • Introduction
  • Basic Concepts
    • Overview
    • PxProfileZoneManager
    • PxProfileZone
  • Shutdown
  • Extracting PhysX SDK Event Data
    • Overview
    • PxDefaultBufferedProfiler
    • PxBufferedProfilerCallback
  • Adding Custom Profile Zones
    • Introduction
    • PxProfileNameProvider And Customization of PxProfileZone
    • Profiling
  • Advanced
    • Extracting PhysX SDK Event Data Using The PxProfileZoneManager Interface
• Debug Visualization
  • Introduction
  • Usage
• PhysX Visual Debugger (PVD)
  • PVD
  • Basic Setup (SDK Side)
    • Network Setup
    • File Setup
  • Advanced Setup
    • Connection Flags
    • Visualizing Externals and Extended Data
    • Visualizing SceneQuery
    • Connection Handler
    • PVD Error Stream
• Simulation Statistics
  • Interface
  • Usage
• Serialization
  • Introduction
  • First Code
  • In-depth Discussion
    • Collections
    • Serializing Complete Collections
    • Serializing Incomplete Collections
    • Reference Counting of Deserialized Objects
    • Reconnecting PhysX and Game-Objects
    • Serializing Everything
    • Serializability
    • Binary Serialization Specifics
    • API-level Serialization (RepX) Specifics
  • Common Use Cases
  • Snippet Discussion
    • SnippetSerialization
    • SnippetConvert
    • SnippetLoadCollection
  • Best practices / Troubleshooting
  • PVD
• Extending Serialization
  • Introduction
  • Overview
  • Binary Serialization of Custom Classes
  • RepX Serialization of Custom Classes
    • PhysX API Metadata System
  • Snippet Discussion
• Best Practices Guide
  • Introduction
  • Performance Issues
    • The "Well of Despair"
    • Pruner Performance for Streamed Environments
    • Performance Implications for Multi-Threading
  • Limiting coordinates
  • Character Controller Systems using Scene Queries and Penetration Depth Computation
  • Quantizing HeightField Samples
• Migrating From PhysX SDK 2.x to 3.x
  • Removed Features
    • Compartments
    • Deformables
    • NxUtilLib
    • Anisotropic Friction
  • Basics
    • SDK Header
    • SDK Redistribution
    • API Conventions
    • Callback Classes
    • Memory Management
    • Debug Rendering
    • Error Reporting
    • Type Casting
    • Multithreading
    • Startup and Shutdown
    • Extensions
    • Heightfields
    • Cooking
    • Serialization
  • API Design Changes
    • Changed Actor Hierarchy
    • Actor Creation
  • Material Indexes
  • Continuous Collision Detection
  • Pose Description
  • Shape Description
    • Skin Width
  • Joints
  • Time Stepping
    • Simulation Parameters
  • Collision Filtering
  • Scene Queries
    • Raycasts
    • Overlaps
    • Sweep Tests
• Migrating From PhysX SDK 3.2 to 3.3
  • Math Classes
  • Scene Query API
  • SPU batch queries
  • Core PhysX
  • PhysX Extensions
  • PhysX Character Controller
  • PhysX Vehicles
  • CCD
  • PhysX Visual Debugger
  • PhysX Cloth
  • RepX Serialization
  • Binary Serialization
  • PhysX TaskManager