2017-09-12 22:42:36 +02:00
<?xml version="1.0" encoding="UTF-8" ?>
2018-07-31 20:13:10 +02:00
<class name= "CollisionObject" inherits= "Spatial" category= "Core" version= "3.0.7" >
2017-09-12 22:42:36 +02:00
<brief_description >
2017-09-24 04:47:13 +02:00
Base node for collision objects.
2017-09-12 22:42:36 +02:00
</brief_description>
<description >
2017-10-21 12:33:50 +02:00
CollisionObject is the base class for physics objects. It can hold any number of collision [Shape]s. Each shape must be assigned to a [i]shape owner[/i]. The CollisionObject can have any number of shape owners. Shape owners are not nodes and do not appear in the editor, but are accessible through code using the [code]shape_owner_*[/code] methods.
2017-09-12 22:42:36 +02:00
</description>
<tutorials >
</tutorials>
<demos >
</demos>
<methods >
<method name= "_input_event" qualifiers= "virtual" >
<return type= "void" >
</return>
<argument index= "0" name= "camera" type= "Object" >
</argument>
<argument index= "1" name= "event" type= "InputEvent" >
</argument>
2017-09-10 15:37:49 +02:00
<argument index= "2" name= "click_position" type= "Vector3" >
2017-09-12 22:42:36 +02:00
</argument>
<argument index= "3" name= "click_normal" type= "Vector3" >
</argument>
<argument index= "4" name= "shape_idx" type= "int" >
</argument>
<description >
2017-12-07 20:17:08 +01:00
Accepts unhandled [InputEvent]s. [code]click_position[/code] is the clicked location in world space and [code]click_normal[/code] is the normal vector extending from the clicked surface of the [Shape] at [code]shape_idx[/code]. Connect to the [code]input_event[/code] signal to easily pick up these events.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "create_shape_owner" >
<return type= "int" >
</return>
<argument index= "0" name= "owner" type= "Object" >
</argument>
<description >
2017-09-24 04:47:13 +02:00
Creates a new shape owner for the given object. Returns [code]owner_id[/code] of the new owner for future reference.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_rid" qualifiers= "const" >
<return type= "RID" >
</return>
<description >
2017-09-24 04:47:13 +02:00
Returns the object's [RID].
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "get_shape_owners" >
<return type= "Array" >
</return>
<description >
2017-09-24 04:47:13 +02:00
Returns an [Array] of [code]owner_id[/code] identifiers. You can use these ids in other methods that take [code]owner_id[/code] as an argument.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "is_shape_owner_disabled" qualifiers= "const" >
<return type= "bool" >
</return>
<argument index= "0" name= "owner_id" type= "int" >
</argument>
<description >
2017-09-24 04:47:13 +02:00
If [code]true[/code] the shape owner and its shapes are disabled.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "remove_shape_owner" >
<return type= "void" >
</return>
<argument index= "0" name= "owner_id" type= "int" >
</argument>
<description >
2017-09-24 04:47:13 +02:00
Removes the given shape owner.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "shape_find_owner" qualifiers= "const" >
<return type= "int" >
</return>
<argument index= "0" name= "shape_index" type= "int" >
</argument>
<description >
2017-09-24 04:47:13 +02:00
Returns the [code]owner_id[/code] of the given shape.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "shape_owner_add_shape" >
<return type= "void" >
</return>
<argument index= "0" name= "owner_id" type= "int" >
</argument>
<argument index= "1" name= "shape" type= "Shape" >
</argument>
<description >
2017-09-24 04:47:13 +02:00
Adds a [Shape] to the shape owner.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "shape_owner_clear_shapes" >
<return type= "void" >
</return>
<argument index= "0" name= "owner_id" type= "int" >
</argument>
<description >
2017-09-24 04:47:13 +02:00
Removes all shapes from the shape owner.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "shape_owner_get_owner" qualifiers= "const" >
<return type= "Object" >
</return>
<argument index= "0" name= "owner_id" type= "int" >
</argument>
<description >
2017-09-24 04:47:13 +02:00
Returns the parent object of the given shape owner.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "shape_owner_get_shape" qualifiers= "const" >
<return type= "Shape" >
</return>
<argument index= "0" name= "owner_id" type= "int" >
</argument>
<argument index= "1" name= "shape_id" type= "int" >
</argument>
<description >
2017-09-24 04:47:13 +02:00
Returns the [Shape] with the given id from the given shape owner.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "shape_owner_get_shape_count" qualifiers= "const" >
<return type= "int" >
</return>
<argument index= "0" name= "owner_id" type= "int" >
</argument>
<description >
2017-09-24 04:47:13 +02:00
Returns the number of shapes the given shape owner contains.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "shape_owner_get_shape_index" qualifiers= "const" >
<return type= "int" >
</return>
<argument index= "0" name= "owner_id" type= "int" >
</argument>
<argument index= "1" name= "shape_id" type= "int" >
</argument>
<description >
2017-12-07 20:17:08 +01:00
Returns the child index of the [Shape] with the given id from the given shape owner.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "shape_owner_get_transform" qualifiers= "const" >
<return type= "Transform" >
</return>
<argument index= "0" name= "owner_id" type= "int" >
</argument>
<description >
2017-09-24 04:47:13 +02:00
Returns the shape owner's [Transform].
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "shape_owner_remove_shape" >
<return type= "void" >
</return>
<argument index= "0" name= "owner_id" type= "int" >
</argument>
<argument index= "1" name= "shape_id" type= "int" >
</argument>
<description >
2017-09-24 04:47:13 +02:00
Removes a shape from the given shape owner.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "shape_owner_set_disabled" >
<return type= "void" >
</return>
<argument index= "0" name= "owner_id" type= "int" >
</argument>
<argument index= "1" name= "disabled" type= "bool" >
</argument>
<description >
2017-09-24 04:47:13 +02:00
If [code]true[/code] disables the given shape owner.
2017-09-12 22:42:36 +02:00
</description>
</method>
<method name= "shape_owner_set_transform" >
<return type= "void" >
</return>
<argument index= "0" name= "owner_id" type= "int" >
</argument>
<argument index= "1" name= "transform" type= "Transform" >
</argument>
<description >
2017-09-24 04:47:13 +02:00
Sets the [Transform] of the given shape owner.
2017-09-12 22:42:36 +02:00
</description>
</method>
</methods>
<members >
2017-09-13 08:49:40 +02:00
<member name= "input_capture_on_drag" type= "bool" setter= "set_capture_input_on_drag" getter= "get_capture_input_on_drag" >
2017-12-07 20:17:08 +01:00
If [code]true[/code] the [code]CollisionObject[/code] will continue to receive input events as the mouse is dragged across its shapes. Default value: [code]false[/code].
2017-09-12 22:42:36 +02:00
</member>
2017-09-13 08:49:40 +02:00
<member name= "input_ray_pickable" type= "bool" setter= "set_ray_pickable" getter= "is_ray_pickable" >
2017-12-07 20:17:08 +01:00
If [code]true[/code] the [CollisionObject]'s shapes will respond to [RayCast]s. Default value: [code]true[/code].
2017-09-12 22:42:36 +02:00
</member>
</members>
<signals >
<signal name= "input_event" >
<argument index= "0" name= "camera" type= "Object" >
</argument>
<argument index= "1" name= "event" type= "Object" >
</argument>
2017-09-10 15:37:49 +02:00
<argument index= "2" name= "click_position" type= "Vector3" >
2017-09-12 22:42:36 +02:00
</argument>
<argument index= "3" name= "click_normal" type= "Vector3" >
</argument>
<argument index= "4" name= "shape_idx" type= "int" >
</argument>
<description >
2017-12-07 20:17:08 +01:00
Emitted when [method _input_event] receives an event. See its description for details.
2017-09-12 22:42:36 +02:00
</description>
</signal>
<signal name= "mouse_entered" >
<description >
2017-09-24 04:47:13 +02:00
Emitted when the mouse pointer enters any of this object's shapes.
2017-09-12 22:42:36 +02:00
</description>
</signal>
<signal name= "mouse_exited" >
<description >
2017-09-24 04:47:13 +02:00
Emitted when the mouse pointer exits all this object's shapes.
2017-09-12 22:42:36 +02:00
</description>
</signal>
</signals>
<constants >
</constants>
</class>