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.

CapsuleShape2D

繼承: Shape2D < Resource < RefCounted < Object

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

說明

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

性能:CapsuleShape2D 可以快速檢查碰撞,但比 RectangleShape2DCircleShape2D 慢。

屬性

float

height

30.0

float

mid_height

float

radius

10.0


屬性說明

float height = 30.0 🔗

  • void set_height(value: float)

  • float get_height()

The capsule's full height, including the semicircles.

Note: The height of a capsule must be at least twice its radius. Otherwise, the capsule becomes a circle. 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 semicircles. This is the height of the central rectangular part in the middle of the capsule, and is the distance between the centers of the two semicircles. This is a wrapper for height.


float radius = 10.0 🔗

  • 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 circle. If the radius is greater than half of the height, the properties adjust to a valid value.