CollisionObject3D

继承： Node3D < Node < Object

派生： Area3D, PhysicsBody3D

3D 物理对象的抽象基类。

描述

3D 物理对象的抽象基类。CollisionObject3D 能够容纳任意数量的 Shape3D 用作碰撞形状。每个形状必须分配给一个形状所有者。形状所有者不是节点，也不会出现在编辑器中，但可以通过代码使用 shape_owner_* 方法访问。

警告：如果使用非均匀缩放，则该节点可能无法按预期工作。建议让所有轴上的缩放保持一致，可以用对碰撞形状的调整来代替非均匀缩放。

属性

方法

信号

input_event ( Node camera, InputEvent event, Vector3 position, Vector3 normal, int shape_idx )

当对象收到未处理的 InputEvent 时发出。position 是鼠标指针在索引为 shape_idx 的形状表面上的世界空间位置，normal 是表面在该点的法向量。

mouse_entered ( )

当鼠标指针进入该对象的任何形状时发出。要求 input_ray_pickable 为 true 并且至少设置了一个 collision_layer 位。

注意：由于缺少连续的碰撞检测，如果鼠标移动得足够快并且 CollisionObject3D 的区域很小，则该信号可能不会按预期的顺序发出。如果另一个 CollisionObject3D 与所讨论的 CollisionObject3D 重叠，则也可能不会发出该信号。

mouse_exited ( )

当鼠标指针离开该对象的所有形状时发出。要求 input_ray_pickable 为 true 并且至少设置了一个 collision_layer 位。

注意：由于缺少连续的碰撞检测，如果鼠标移动得足够快并且 CollisionObject3D 的区域很小，则该信号可能不会按预期的顺序发出。如果另一个 CollisionObject3D 与所讨论的 CollisionObject3D 重叠，则也可能不会发出该信号。

枚举

enum DisableMode:

DisableMode DISABLE_MODE_REMOVE = 0

当 Node.process_mode 被设置为 Node.PROCESS_MODE_DISABLED 时，从物理仿真中移除，停止与此 CollisionObject3D 的所有物理交互。

当该 Node 再次被处理时，会自动重新加入到物理仿真中。

DisableMode DISABLE_MODE_MAKE_STATIC = 1

当 Node.process_mode 被设置为 Node.PROCESS_MODE_DISABLED 时，使实体静态化。不影响 Area3D。PhysicsBody3D 在静态时不会受到力或其他实体的影响。

当该 Node 再次被处理时，自动将 PhysicsBody3D 设置回其原始模式。

DisableMode DISABLE_MODE_KEEP_ACTIVE = 2

当 Node.process_mode 被设置为 Node.PROCESS_MODE_DISABLED 时，不影响物理仿真。

属性说明

int collision_layer = 1

• void set_collision_layer ( int value )

• int get_collision_layer ( )

该 CollisionObject3D 所在的物理层。碰撞对象可以存在于 32 个不同层中的一层或多层。另见 collision_mask。

注意：只有当对象 B 位于对象 A 扫描的任何层中时，对象 A 才能检测到与对象 B 的接触。有关更多信息，请参阅文档中的《碰撞层和掩码》。

int collision_mask = 1

• void set_collision_mask ( int value )

• int get_collision_mask ( )

该 CollisionObject3D 扫描的物理层。碰撞对象可以扫描 32 个不同层中的一层或多层。另见 collision_layer。

注意：只有当对象 B 位于对象 A 扫描的任何层中时，对象 A 才能检测到与对象 B 的接触。有关更多信息，请参阅文档中的《碰撞层和掩码》。

float collision_priority = 1.0

• void set_collision_priority ( float value )

• float get_collision_priority ( )

发生穿透时用于解决碰撞的优先级。优先级越高，对物体的穿透度就越低。例如，可以用来防止玩家突破关卡的边界。

DisableMode disable_mode = 0

• void set_disable_mode ( DisableMode value )

• DisableMode get_disable_mode ( )

当 Node.process_mode 被设置为 Node.PROCESS_MODE_DISABLED 时，定义物理行为。有关不同模式的更多详细信息，请参阅 DisableMode。

bool input_capture_on_drag = false

• void set_capture_input_on_drag ( bool value )

• bool get_capture_input_on_drag ( )

如果为 true，则当鼠标拖过其形状时，CollisionObject3D 将继续接收输入事件。

bool input_ray_pickable = true

• void set_ray_pickable ( bool value )

• bool is_ray_pickable ( )

如果为 true，则该对象是可拾取的。可拾取的对象可以检测鼠标指针的进入/离开，鼠标位于其中时，就会报告输入事件。要求至少设置一个 collision_layer 位。

方法说明

void _input_event ( Camera3D camera, InputEvent event, Vector3 position, Vector3 normal, int shape_idx ) virtual

接收未处理的 InputEvent。position 是鼠标指针在索引为 shape_idx 的形状表面上的世界空间位置，normal 是该点表面的法向量。连接到 input_event 信号即可轻松获取这些事件。

注意：_input_event 要求 input_ray_pickable 为 true，并且至少要设置一个 collision_layer 位。

void _mouse_enter ( ) virtual

当鼠标指针进入该实体的任何形状时调用。要求 input_ray_pickable 为 true 并且至少设置一个 collision_layer 位。请注意，在单个 CollisionObject3D 中的不同形状之间移动，不会导致该函数被调用。

void _mouse_exit ( ) virtual

当鼠标指针离开该实体的所有形状时调用。要求 input_ray_pickable 为 true 并且至少设置一个 collision_layer 位。请注意，在单个 CollisionObject3D 中的不同形状之间移动，不会导致该函数被调用。

int create_shape_owner ( Object owner )

为给定对象创建一个新的形状所有者。返回 owner_id的新所有者，供将来引用。

bool get_collision_layer_value ( int layer_number ) const

返回 collision_layer 中是否启用了指定的层，给定的 layer_number 应在 1 和 32 之间。

bool get_collision_mask_value ( int layer_number ) const

返回 collision_mask 中是否启用了指定的层，给定的 layer_number 应在 1 和 32 之间。

RID get_rid ( ) const

返回对象的 RID。

PackedInt32Array get_shape_owners ( )

返回一个 owner_id 标识符的 Array。你可以在其他使用 owner_id 作为参数的方法中使用这些 ID。

bool is_shape_owner_disabled ( int owner_id ) const

如果为 true，则禁用形状所有者及其形状。

void remove_shape_owner ( int owner_id )

移除给定形状的所有者。

void set_collision_layer_value ( int layer_number, bool value )

根据 value，启用或禁用 collision_layer 中指定的层，给定的 layer_number 应在 1 和 32 之间。

void set_collision_mask_value ( int layer_number, bool value )

根据 value，启用或禁用 collision_mask 中指定的层，给定的 layer_number 应在 1 和 32 之间。

int shape_find_owner ( int shape_index ) const

返回指定形状的 owner_id。

void shape_owner_add_shape ( int owner_id, Shape3D shape )

向形状拥有者添加 Shape3D。

void shape_owner_clear_shapes ( int owner_id )

移除形状所有者的所有形状。

Object shape_owner_get_owner ( int owner_id ) const

返回给定形状所有者的父对象。

Shape3D shape_owner_get_shape ( int owner_id, int shape_id ) const

返回形状所有者中具有给定 ID 的 Shape3D。

int shape_owner_get_shape_count ( int owner_id ) const

返回给定形状所有者包含的形状数量。

int shape_owner_get_shape_index ( int owner_id, int shape_id ) const

返回形状所有者中具有给定 ID 的 Shape3D 的子索引。

Transform3D shape_owner_get_transform ( int owner_id ) const

返回形状所有者的 Transform3D。

void shape_owner_remove_shape ( int owner_id, int shape_id )

从给定的形状所有者中移除一个形状。

void shape_owner_set_disabled ( int owner_id, bool disabled )

如果为 true，则禁用给定的形状所有者。

void shape_owner_set_transform ( int owner_id, Transform3D transform )

设置给定形状所有者的 Transform3D。

Previous Next

© 版权所有 2014-present Juan Linietsky, Ariel Manzur and the Godot community (CC BY 3.0). Revision b1c660f7.

Built with Sphinx using a theme provided by Read the Docs.