GPUParticlesCollisionSDF3D

Inherits: GPUParticlesCollision3D < VisualInstance3D < Node3D < Node < Object

Baked signed distance field 3D particle attractor affecting GPUParticles3D nodes.

Description

Baked signed distance field 3D particle attractor affecting GPUParticles3D nodes.

Signed distance fields (SDF) allow for efficiently representing approximate collision shapes for convex and concave objects of any shape. This is more flexible than GPUParticlesCollisionHeightField3D, but it requires a baking step.

Baking: The signed distance field texture can be baked by selecting the GPUParticlesCollisionSDF3D node in the editor, then clicking Bake SDF at the top of the 3D viewport. Any visible MeshInstance3Ds touching the extents will be taken into account for baking, regardless of their GeometryInstance3D.gi_mode.

Note: Baking a GPUParticlesCollisionSDF3D's texture is only possible within the editor, as there is no bake method exposed for use in exported projects. However, it's still possible to load pre-baked Texture3Ds into its texture property in an exported project.

Note: ParticleProcessMaterial.collision_mode must be ParticleProcessMaterial.COLLISION_RIGID or ParticleProcessMaterial.COLLISION_HIDE_ON_CONTACT on the GPUParticles3D's process material for collision to work.

Note: Particle collision only affects GPUParticles3D, not CPUParticles3D.

Properties

int

bake_mask

4294967295

Vector3

extents

Vector3(1, 1, 1)

Resolution

resolution

2

Texture3D

texture

float

thickness

1.0

Methods

bool

get_bake_mask_value ( int layer_number ) const

void

set_bake_mask_value ( int layer_number, bool value )

Enumerations

enum Resolution:

  • RESOLUTION_16 = 0 --- Bake a 16×16×16 signed distance field. This is the fastest option, but also the least precise.

  • RESOLUTION_32 = 1 --- Bake a 32×32×32 signed distance field.

  • RESOLUTION_64 = 2 --- Bake a 64×64×64 signed distance field.

  • RESOLUTION_128 = 3 --- Bake a 128×128×128 signed distance field.

  • RESOLUTION_256 = 4 --- Bake a 256×256×256 signed distance field.

  • RESOLUTION_512 = 5 --- Bake a 512×512×512 signed distance field. This is the slowest option, but also the most precise.

  • RESOLUTION_MAX = 6 --- Represents the size of the Resolution enum.

Property Descriptions

  • int bake_mask

Default

4294967295

Setter

set_bake_mask(value)

Getter

get_bake_mask()

The visual layers to account for when baking the particle collision SDF. Only MeshInstance3Ds whose VisualInstance3D.layers match with this bake_mask will be included in the generated particle collision SDF. By default, all objects are taken into account for the particle collision SDF baking.


Default

Vector3(1, 1, 1)

Setter

set_extents(value)

Getter

get_extents()

The collision SDF's extents in 3D units. To improve SDF quality, the extents should be set as small as possible while covering the parts of the scene you need.


Default

2

Setter

set_resolution(value)

Getter

get_resolution()

The bake resolution to use for the signed distance field texture. The texture must be baked again for changes to the resolution property to be effective. Higher resolutions have a greater performance cost and take more time to bake. Higher resolutions also result in larger baked textures, leading to increased VRAM and storage space requirements. To improve performance and reduce bake times, use the lowest resolution possible for the object you're representing the collision of.


Setter

set_texture(value)

Getter

get_texture()

The 3D texture representing the signed distance field.


Default

1.0

Setter

set_thickness(value)

Getter

get_thickness()

The collision shape's thickness. Unlike other particle colliders, GPUParticlesCollisionSDF3D is actually hollow on the inside. thickness can be increased to prevent particles from tunneling through the collision shape at high speeds, or when the GPUParticlesCollisionSDF3D is moved.

Method Descriptions

  • bool get_bake_mask_value ( int layer_number ) const

Returns whether or not the specified layer of the bake_mask is enabled, given a layer_number between 1 and 32.


  • void set_bake_mask_value ( int layer_number, bool value )

Based on value, enables or disables the specified layer in the bake_mask, given a layer_number between 1 and 32.