Global Configuration

On the Global Configuration tab, you can configure world settings and editor settings.

PhysX Global Configuration tab

System Configuration

The following table describes the settings for System Configuration.


PropertyDescription
Max Time Step m_maxTimeStepSpecifies the largest time step that the simulation can process. This setting prevents instability in the simulation if m_fixedTimeStep is not set. It also prevents the simulation from taking too long. If the time between frames is greater than m_maxTimeStep, the time is limited to this value. Specify small increments. The default is 0.05 (1/20th of a second).
Fixed Time Step m_fixedTimeStepControls the frequency of the interval at which O3DE does the simulation. The default is 0.017 (1/60th of a second). A lower value results in a more accurate simulation, but at a higher runtime cost. Higher values can cause results that are less stable. If this value is set to 0, the simulation does not use the fixed time and uses the time between frames, which can vary. If the frame time is greater than this value, O3DE splits the time to the number of steps yielded by the following calculation:
frame_time/m_fixedTimeStep
Raycast Buffer SizeMaximum number of hits that can be returned from a raycast query. The default is 32.
Shapecast Buffer SizeMaximum number of hits that can be returned from a shapecast query. The default is 32.
Overlap Query Buffer SizeMaximum number of hits that can be returned from an overlap query. The default is 32.

Physics Materials

The following table describes the settings for Physics Materials.


PropertyDescription
Default Physics MaterialProperties of the default physics material used for this project. See Physics material properties for a detail description of each property.
Physics Material LibraryThe physics material library to use for this project.

Scene Configuration

The following table describes the settings for Scene Configuration.


PropertyDescription
GravityGravity vector in the world. The default X, Y, and Z values are 0.0, 0.0, and -9.81.
Continuous Collision DetectionIf set, enables continuous collision detection in the world. Disabled by default.
Persistent Contact ManifoldIf set, attempts to improve the calculation of the entities that are colliding and preserves this data between frames. Enabled by default, which is the recommended setting. Persistent manifolds store the contact data created in one frame for potential reuse in subsequent frames. For example, if the corner of box A collides with the side of box B, the contact data is stored and the manifold stores the collision point. If box A’s corner no longer collides in approximately in the same location in the next frame, the data is disregarded. If box A moves too far (for example, if it rotates so far that the corner no longer touches), that data is discarded. Otherwise, the manifold provides faster collision results by using the data from the previous frame to calculate the collision. Although persistent manifolds require more memory, they improve performance and the accuracy of the simulation by reducing jitter and other unwanted physics artifacts.
Bounce Threshold VelocityRelative velocity below which colliding objects will not bounce. The default is 2.0.

Editor Configuration

The following options relate to the Debug Draw COM (center of mass) option of the PhysX Rigid Body component.


PropertyDescription
Debug Draw Center of Mass SizeThe size of the debug draw circle that represents the center of the mass. Possible values are from 0.1 to 5.0 meters. The default value is 0.1.
Debug Draw Center of Mass ColorThe color of the debug draw circle that represents the center of mass. To specify a color, enter its RGB values in the text box. The color of the icon next to the text box shows the color that you entered. The default values are 255, 0, 0 (red).
Global Collision DebugSet up global collision debug draw.
Enable all colliders Displays all PhysX collider shapes, including colliders previously set as hidden.
Disable all colliders Hides all PhysX collider shapes, including colliders previously set as visible.
Set manually You can update PhysX colliders on each entity. This is the default.
Global Collision Debug Color ModeSet up debug color mode.
Material Color Mode Uses material’s debug color specified in material library.
Error Mode Shows glowing red error colors for cases like meshes with too many triangles.
Display Joints HierarchyFlag to switch on and off the display of joint lead-follower connections in the viewport. The default is on.
Joints Hierarchy Lead ColorColor of the lead half of a lead-follower joint connection line.
Joints Hierarchy Follower ColorColor of the follower half of a lead-follower joint connection line.
Joints Hierarchy Distance ThresholdMinimum distance required to draw from follower to joint. Distances shorter than this threshold will result in the line drawn from the joint to the lead. The default is 1.0.
Note:
These options are part of the PhysX gem and are not related to the Debug Draw gem or the PhysX Debug gem.

Wind Configuration

The following table describes the settings for Wind Configuration. See Create global or localized wind forces with PhysX for more details.


PropertyDescription
Global wind tagTag used by PhysX wind system to detect entities that provide global wind data.
Local wind tagTag used by PhysX wind system to detect entities that provide wind data localized to a collider volume.

Copyright © 2022 Open 3D Engine Contributors

Documentation Distributed under CC BY 4.0.
For our trademark, privacy and antitrust policies, code of conduct, and terms of use, please click the applicable link below or see https://www.lfprojects.org.


The Linux Foundation has registered trademarks and uses trademarks. For a list of trademarks of The Linux Foundation, please see our Trademark Policy page.