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.

CapsuleShape3D

繼承: Shape3D < Resource < RefCounted < Object

用於物理碰撞的 3D 膠囊形狀。

說明

3D 膠囊形狀,旨在用於物理學。通常用於為 CollisionShape3D 提供形狀。

性能:CapsuleShape3D 可以快速檢查碰撞。比 CylinderShape3D 快,但比 SphereShape3DBoxShape3D 慢。

教學

屬性

float

height

2.0

float

mid_height

float

radius

0.5


屬性說明

float height = 2.0 🔗

  • void set_height(value: float)

  • float get_height()

The capsule's full height, including the hemispheres.

Note: The height of a capsule must be at least twice its radius. Otherwise, the capsule becomes a sphere. If the height is less than twice the radius, the properties adjust to a valid value.


float mid_height 🔗

  • void set_mid_height(value: float)

  • float get_mid_height()

The capsule's height, excluding the hemispheres. This is the height of the central cylindrical part in the middle of the capsule, and is the distance between the centers of the two hemispheres. This is a wrapper for height.


float radius = 0.5 🔗

  • void set_radius(value: float)

  • float get_radius()

The capsule's radius.

Note: The radius of a capsule cannot be greater than half of its height. Otherwise, the capsule becomes a sphere. If the radius is greater than half of the height, the properties adjust to a valid value.