GPUParticlesAttractor3D

繼承： VisualInstance3D < Node3D < Node < Object

被繼承： GPUParticlesAttractorBox3D, GPUParticlesAttractorSphere3D, GPUParticlesAttractorVectorField3D

分隔線的抽象基底類別。

說明

粒子吸引器可以將粒子朝吸引器的原點吸，也可以將粒子推離吸引器的原點。

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

臨時禁用吸引器的方法是將其隱藏，也可以將 strength 設定為 0.0。

注意：粒子吸引器只會影響 GPUParticles3D，不影響 CPUParticles3D。

屬性

float	attenuation	1.0
int	cull_mask	4294967295
float	directionality	0.0
float	strength	1.0

---

屬性說明

float attenuation = 1.0 🔗

• void set_attenuation(value: float)

• float get_attenuation()

粒子吸引器的衰減。較高的值會導致粒子在靠近吸引器的原點時逐漸被推動。零值或負值將導致粒子一接觸吸引器的邊緣就會被快速推動。

---

int cull_mask = 4294967295 🔗

• void set_cull_mask(value: int)

• int get_cull_mask()

將受吸引器影響的粒子算繪層（VisualInstance3D.layers）。預設情況下，所有粒子都受吸引子器影響。

相應地配置粒子節點後，可以取消勾選特定層，以防止某些粒子受到吸引器的影響。例如，如果將吸引器用作法術效果的一部分，但不希望吸引器影響同一位置的不相關天氣粒子，則可以使用該屬性。

通過在 GPUParticles3D 節點上設定 ParticleProcessMaterial.attractor_interaction_enabled，也可以在每個程序材質的基上禁用粒子吸引。

---

float directionality = 0.0 🔗

• void set_directionality(value: float)

• float get_directionality()

調整吸引器的方向。在 0.0 處，吸引器完全沒有方向性：它會將粒子吸引到其中心。在 1.0 中，吸引器是完全定向的：粒子將始終被推向局部 -Z（如果 strength 為負數，則推向 +Z）。

注意：如果 directionality 大於 0.0，則可以通過旋轉 GPUParticlesAttractor3D 節點，來改變粒子推送的方向。

---

float strength = 1.0 🔗

• void set_strength(value: float)

• float get_strength()

如果 strength 為負，則粒子將被反向推動。如果 directionality 為 0.0，則粒子將被推離吸引器的原點，如果 directionality 大於 0.0，則粒子將被推向局部 +Z。