summaryrefslogtreecommitdiff
path: root/doc/classes/StaticBody.xml
blob: a008f0b99c4ad0d79ab424fd1ed33d2e1440746c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
<?xml version="1.0" encoding="UTF-8" ?>
<class name="StaticBody" inherits="PhysicsBody" category="Core" version="3.0-alpha">
	<brief_description>
		Static body for 3D Physics.
	</brief_description>
	<description>
		Static body for 3D Physics. A static body is a simple body that is not intended to move. They don't consume any CPU resources in contrast to a [RigidBody3D] so they are great for scenario collision.
		A static body can also be animated by using simulated motion mode. This is useful for implementing functionalities such as moving platforms. When this mode is active the body can be animated and automatically computes linear and angular velocity to apply in that frame and to influence other bodies.
		Alternatively, a constant linear or angular velocity can be set for the static body, so even if it doesn't move, it affects other bodies as if it was moving (this is useful for simulating conveyor belts or conveyor wheels).
	</description>
	<tutorials>
	</tutorials>
	<demos>
	</demos>
	<methods>
		<method name="get_bounce" qualifiers="const">
			<return type="float">
			</return>
			<description>
				Return the body bounciness.
			</description>
		</method>
		<method name="get_constant_angular_velocity" qualifiers="const">
			<return type="Vector3">
			</return>
			<description>
				Return the constant angular velocity for the body.
			</description>
		</method>
		<method name="get_constant_linear_velocity" qualifiers="const">
			<return type="Vector3">
			</return>
			<description>
				Return the constant linear velocity for the body.
			</description>
		</method>
		<method name="get_friction" qualifiers="const">
			<return type="float">
			</return>
			<description>
				Return the body friction.
			</description>
		</method>
		<method name="set_bounce">
			<return type="void">
			</return>
			<argument index="0" name="bounce" type="float">
			</argument>
			<description>
				Set the body bounciness, from 0 (not bouncy) to 1 (bouncy).
			</description>
		</method>
		<method name="set_constant_angular_velocity">
			<return type="void">
			</return>
			<argument index="0" name="vel" type="Vector3">
			</argument>
			<description>
				Set a constant angular velocity for the body. This does not rotate the body, but affects other bodies touching it, as if it was rotating.
			</description>
		</method>
		<method name="set_constant_linear_velocity">
			<return type="void">
			</return>
			<argument index="0" name="vel" type="Vector3">
			</argument>
			<description>
				Set a constant linear velocity for the body. This does not move the body, but affects other bodies touching it, as if it was moving.
			</description>
		</method>
		<method name="set_friction">
			<return type="void">
			</return>
			<argument index="0" name="friction" type="float">
			</argument>
			<description>
				Set the body friction, from 0 (frictionless) to 1 (full friction).
			</description>
		</method>
	</methods>
	<members>
		<member name="bounce" type="float" setter="set_bounce" getter="get_bounce">
			The body bounciness.
		</member>
		<member name="constant_angular_velocity" type="Vector3" setter="set_constant_angular_velocity" getter="get_constant_angular_velocity">
			The constant angular velocity for the body. This does not rotate the body, but affects other bodies that touch it, as if it was in a state of rotation.
		</member>
		<member name="constant_linear_velocity" type="Vector3" setter="set_constant_linear_velocity" getter="get_constant_linear_velocity">
			The constant linear velocity for the body. This does not move the body, but affects other bodies that touch it, as if it was in a state of movement.
		</member>
		<member name="friction" type="float" setter="set_friction" getter="get_friction">
			The body friction, from 0 (frictionless) to 1 (full friction).
		</member>
	</members>
	<constants>
	</constants>
</class>