summaryrefslogtreecommitdiff
path: root/doc/classes/RootMotionView.xml
blob: e31ea9265e5fb06e1232d32a9ff997c225e2b7f8 (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
<?xml version="1.0" encoding="UTF-8" ?>
<class name="RootMotionView" inherits="VisualInstance3D" version="4.0">
	<brief_description>
		Editor-only helper for setting up root motion in [AnimationTree].
	</brief_description>
	<description>
		[i]Root motion[/i] refers to an animation technique where a mesh's skeleton is used to give impulse to a character. When working with 3D animations, a popular technique is for animators to use the root skeleton bone to give motion to the rest of the skeleton. This allows animating characters in a way where steps actually match the floor below. It also allows precise interaction with objects during cinematics. See also [AnimationTree].
		[b]Note:[/b] [RootMotionView] is only visible in the editor. It will be hidden automatically in the running project, and will also be converted to a plain [Node] in the running project. This means a script attached to a [RootMotionView] node [i]must[/i] have [code]extends Node[/code] instead of [code]extends RootMotionView[/code]. Additionally, it must not be a [code]@tool[/code] script.
	</description>
	<tutorials>
		<link title="Using AnimationTree - Root motion">https://docs.godotengine.org/en/latest/tutorials/animation/animation_tree.html#root-motion</link>
	</tutorials>
	<methods>
	</methods>
	<members>
		<member name="animation_path" type="NodePath" setter="set_animation_path" getter="get_animation_path">
			Path to an [AnimationTree] node to use as a basis for root motion.
		</member>
		<member name="cell_size" type="float" setter="set_cell_size" getter="get_cell_size">
			The grid's cell size in 3D units.
		</member>
		<member name="color" type="Color" setter="set_color" getter="get_color">
			The grid's color.
		</member>
		<member name="radius" type="float" setter="set_radius" getter="get_radius">
			The grid's radius in 3D units. The grid's opacity will fade gradually as the distance from the origin increases until this [member radius] is reached.
		</member>
		<member name="zero_y" type="bool" setter="set_zero_y" getter="get_zero_y">
			If [code]true[/code], the grid's points will all be on the same Y coordinate ([i]local[/i] Y = 0). If [code]false[/code], the points' original Y coordinate is preserved.
		</member>
	</members>
	<constants>
	</constants>
</class>