Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

GPUParticlesCollision3D

繼承: VisualInstance3D < Node3D < Node < Object

被繼承: GPUParticlesCollisionBox3D, GPUParticlesCollisionHeightField3D, GPUParticlesCollisionSDF3D, GPUParticlesCollisionSphere3D

影響 GPUParticles3D 節點的 3D 粒子碰撞形狀的抽象類別。

說明

粒子碰撞形狀可用於使粒子停止或對其反彈。

粒子碰撞形狀是即時的,在遊戲過程中可以移動、旋轉和縮放。與吸引器不同,碰撞形狀的非均勻縮放不受支援。

粒子碰撞形狀可以通過隱藏而暫時停用。

注意:在 GPUParticles3D 的處理材質上,ParticleProcessMaterial.collision_mode 必須是 ParticleProcessMaterial.COLLISION_RIGID 或 ParticleProcessMaterial.COLLISION_HIDE_ON_CONTACT,才能使碰撞生效。

注意:粒子碰撞只影響 GPUParticles3D,不影響 CPUParticles3D。

注意:由正在移動的碰撞器推動的粒子不會被插值,這可能會導致可見的卡頓。這可以通過將 GPUParticles3D.fixed_fps 設定為 0 或一個符合或超過目標畫面播放速率的值來緩解。

屬性

int

cull_mask

4294967295


屬性說明

int cull_mask = 4294967295 🔗

  • void set_cull_mask(value: int)

  • int get_cull_mask()

將受碰撞形狀影響的粒子渲染層(VisualInstance3D.layers)。預設情況下,所有 ParticleProcessMaterial.collision_mode 設定為 ParticleProcessMaterial.COLLISION_RIGID 或 ParticleProcessMaterial.COLLISION_HIDE_ON_CONTACT 的粒子都將受到碰撞形狀的影響。

相應地設定粒子節點後,可以取消選中特定層,防止某些粒子受到碰撞體的影響。例如,如果你將碰撞體用作法術效果的一部分但不希望碰撞體影響同一位置的不相關天氣粒子,則可以使用該選項。

通過在 GPUParticles3D 節點上設定 ParticleProcessMaterial.collision_mode,也可以在每個處理程序材質的基礎上停用粒子碰撞。