Programming
Fundamentals
Setting Up Development Environment
UnigineScript
High-Level Systems
C++
C#
UUSL (Unified UNIGINE Shader Language)
File Formats
Rebuilding the Engine and Tools
GUI
Double Precision Coordinates
API
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
Rendering-Related Classes

Setting Up Physics

The Physics settings panel allows you to adjust global physics-related settings: values set via this panel will be applied to all physical objects in the scene. The panel can be invoked by pressing the P key or via the Menu bar by clicking Windows -> Physics Settings.

For more information on how to add physical properties to objects and set up physical interactions, see the articles in the Physics section.

Physics editor Settings

Global physics settings window

The panel contains the following settings:

FPS Fixed framerate used to simulate physics. Physics framerate is independent of the rendering one.
Notice
Too high physics framerate can cause rendering lags. If physics takes more than 40  ms, further calculations are skipped.
Game Scale factor to speed up or slow down the game time. That includes both rendering rate (for example, particles spawn rate and material offsets) and physics ticks.
Sound Scale factor to speed up or slow down the sound play.
Physics scale Scale factor to speed up or slow down the physics simulation time, i.e how frequently physics is simulated (for example, slowing down of body's velocity). Only physics ticks are affected, while everything else is rendered at a normal speed.
Iterations The number of iterations for physics during one physics tick. Each iteration the full cycle of physics simulation is performed:
  • flush() from the world script is called
  • collision detection is calculated
  • joints are solved
Notice
High number of iterations increase stability, but also result in a higher load. If physics takes more than 40  ms, next iterations are automatically skipped.
Linear damp Damping of objects' linear velocities. This value is added to the linear damping set individually for each object.
  • The higher the value, the faster objects stop moving along the straight line.
Angular damp Damping of objects' angular velocities. This value is added to the angular damping set individually for each object.
  • The higher the value, the faster objects stop their rotation.
Max linear velocity The maximum possible linear velocity.
  • This value is compared to the maximum linear velocity set for each body, and the lowest value serves as a threshold to clip the actual linear velocity, if necessary.
Max angular velocity The maximum possible angular velocity.
  • This value is compared to the maximum angular velocity set for each body, and the lowest value serves as a threshold to clip the actual angular velocity, if necessary.
Frozen linear velocity Linear velocity at which the object becomes frozen, if it keeps both of its velocities (angular and linear) lower than the freeze velocities.
  • This value is compared to the Frozen linear velocity set for each body, and the highest value serves as a threshold to compare actual velocity with.
Frozen angular velocity Angular velocity at which the object becomes frozen, if it keeps both of its velocities (angular and linear) lower than the freeze velocities.
  • This value is compared to the Frozen angular velocity set for each body, and the highest value serves as a threshold to compare actual velocity with.
Frozen frames The number of frames, during which an object should keep both its angular and linear velocities under the specified level to become frozen.
Penetration factor The factor used to define the reverse force of extrusion by unwanted objects tunneling.
  • The minimum value of 0 means there is no extrusion by contact penetration.
  • The maximum value of 1 means objects are extruded with the maximum possible impulse.
Penetration tolerance Distance in units indicating how deeply one object can penetrate another to be extruded.
Gravity Three coordinates of the vector used to define a gravity. It creates a world-wide uniform force field. Gravity is applied at the center of mass of each body (except for dummy body) to calculate its acceleration.
  • Normally gravity vector should point downwards, i.e. have negative value along the Z axis.
  • The higher the value along one of the axes, the stronger gravity presses in the specified direction.
Last update: 2017-07-03