GPUParticlesCollisionHeightField3D

GPUParticlesCollisionHeightField3D

继承： GPUParticlesCollision3D < VisualInstance3D < Node3D < Node < Object

影响 GPUParticles3D 节点的实时高度图形状 3D 粒子碰撞形状。

描述

影响 GPUParticles3D 节点的实时高度图形状的 3D 粒子碰撞形状。

高度图形状允许有效地表示凸面和凹面对象与单个“地板”（例如地形）的碰撞。它不如 GPUParticlesCollisionSDF3D 灵活，但不需要烘焙步骤。

也可以在移动时、相机移动时、甚至连续时，实时重新生成 GPUParticlesCollisionHeightField3D。这对雨雪等天气效果、以及具有高度动态几何体的游戏来说，GPUParticlesCollisionHeightField3D 是一个不错的选择。但是，该类有限制，因为高度图无法表示悬垂（例如室内或洞穴）。

注意：在 GPUParticles3D 的处理材质上，ParticleProcessMaterial.collision_mode 必须为 true，才能使碰撞生效。

注意：粒子碰撞只影响 GPUParticles3D，不影响 CPUParticles3D。

属性

bool	follow_camera_enabled	`false`
Resolution	resolution	`2`
Vector3	size	`Vector3(2, 2, 2)`
UpdateMode	update_mode	`0`

枚举

enum Resolution: 🔗

Resolution RESOLUTION_256 = 0

生成 256×256 的高度图。适用于小规模场景，或没有远景粒子的较大场景。

Resolution RESOLUTION_512 = 1

生成 512×512 的高度图。适用于中等规模的场景，或没有远景粒子的较大场景。

Resolution RESOLUTION_1024 = 2

生成 1024×1024 的高度图。适用于具有远景粒子的大型场景。

Resolution RESOLUTION_2048 = 3

生成 2048×2048 的高度图。适用于具有远景粒子的非常大的场景。

Resolution RESOLUTION_4096 = 4

生成 4096×4096 的高度图。适用于具有远景粒子的巨大场景。

Resolution RESOLUTION_8192 = 5

生成 8192×8192 的高度图。适用于具有远景粒子的巨大场景。

Resolution RESOLUTION_MAX = 6

代表 Resolution 枚举的大小。

enum UpdateMode: 🔗

UpdateMode UPDATE_MODE_WHEN_MOVED = 0

仅在 GPUParticlesCollisionHeightField3D 节点移动时，或者当 follow_camera_enabled 为 true 且相机移动时，更新高度图。可以通过向任意方向稍微移动 GPUParticlesCollisionHeightField3D 或者调用 RenderingServer.particles_collision_height_field_update 来强制更新。

UpdateMode UPDATE_MODE_ALWAYS = 1

每帧更新高度图。这具有显著的性能成本。只有当粒子可以碰撞的几何体在游戏过程中发生显著变化时，才应使用该更新选项。