SpringArm
继承
简要描述
一个辅助节点，主要用于第三人称摄影机。
描述
SpringArm节点是一个沿其z轴投射射线（或碰撞形状）并将其所有直接子级移到碰撞点（减去边距）的节点。
最常见的使用场景是制作一个对环境中的碰撞有反应的第三人称相机。
SpringArm将投射射线，或者如果给出了形状，它将沿其z轴方向投射形状。
如果将SpringArm用作角色的摄像机控制器，则可能需要从SpringArm的碰撞检查中排除角色的对撞机。
成员
| 类型 | 属性名 | 默认值 |
|---|---|---|
| int | collision_mask | 1 |
| float | margin | 0.01 |
| Shape | shape | |
| float | spring_length | 1.0 |
方法
| 返回值类型 | 方法名称 |
|---|---|
| void | add_excluded_object(RID: RID) |
| void | clear_excluded_objects() |
| float | get_hit_length() |
| bool | remove_excluded_object(RID: RID) |
常量
成员说明
- int collision_mask
| Default | 1 |
|---|---|
| setter | set_collision_mask(value) |
| getter | get_collision_mask |
- float margin
| Default | 0.01 |
|---|---|
| setter | set_margin(value) |
| getter | get_margin |
- Shape shape
| setter | set_shape(value) |
|---|---|
| getter | get_shape |
- float spring_length
| Default | 1.0 |
|---|---|
| setter | set_length(value) |
| getter | get_length |
方法说明
- add_excluded_object add_excluded_object(RID: RID)
将具有给定RID的PhysicsBody对象添加到从冲突检查中排除的PhysicsBody对象的列表中。
- clear_excluded_objects clear_excluded_objects()
清除冲突检查中排除的PhysicsBody对象的列表。
- get_hit_length get_hit_length()
返回当前手臂长度（检查碰撞后）与spring_length的比例。范围从0到1。
- remove_excluded_object remove_excluded_object(RID: RID)
从冲突检查中排除的PhysicsBody对象列表中删除给定的RID。