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
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
|
.. _bpy.types.AnimVizMotionPaths:
.. _bpy.types.MotionPath:
************
Motion Paths
************
.. reference::
:Editor: 3D Viewport, Properties
:Mode: Object Mode
:Panel: :menuselection:`Properties --> Object Properties --> Motion Paths`
.. reference::
:Editor: 3D Viewport, Properties
:Mode: Pose Mode
:Panel: :menuselection:`Properties --> Armature --> Motion Paths`
:Menu: :menuselection:`Pose --> Motion Paths`
.. figure:: /images/animation_motion-paths_example-object.png
:width: 400px
An animated cube with its motion path displayed.
The Motion Paths tool allows you to visualize the motion of points as paths over a series of frames.
These points can be object origins and bone joints.
To create or remove motion paths, it is necessary to first select the bones. Then:
#. To show the paths (or update them, if needed), click on the *Calculate Path* button.
#. To hide the paths, click on the *Clear Paths* button.
.. note::
Remember that only selected bones and their paths are affected by these actions!
The paths are shown in red for the section in the past and green for the section in the future.
These colors follow the user preference options "Before Current Frame" and "After Current Frame",
which can be found in the 3D Viewport section.
Each frame is displayed by a small dot on the paths.
The paths are automatically updated when you edit your poses/keyframes,
and they are also active during animation playback. Playing the animation
affects the paths only when using the *Around Frame* type.
Options
=======
.. figure:: /images/animation_motion-paths_panel.png
The Motion Paths panel in the Armature tab.
.. _bpy.types.AnimVizMotionPaths.type:
Paths Type
Type of range to show for Motion Paths.
:Around Frame:
Display paths of points within a fixed number of frames around the current frame.
When you enable this button, you get paths for a given number of frames before and after the current one
:In Range:
Display paths of points within specified range.
.. _bpy.ops.pose.paths_range_update:
.. _bpy.types.AnimVizMotionPaths.range:
Calculation Range
The range of the motion path. Only active when *Paths Type* is set to
*In Range*. Changing this option only takes effect when updating the path, via
the *Update Path* or *Update All Paths* buttons.
:All Keys:
Generate a motion path ranging from the first keyframe to the last. Only
the keys of the active object / bone are considered.
:Selected Keys:
Same as *All Keys* except that it ranges from the first to the last
*selected* keyframe.
:Scene Frame Range:
Use the start & end frames of the scene, or the
:ref:`preview range <graph-preview-range>` if active.
:Manual Range:
Manually set the start and end frame.
.. _bpy.types.AnimVizMotionPaths.frame_start:
.. _bpy.types.AnimVizMotionPaths.frame_end:
Frame Range Start, End
Starting and Ending frame of range of paths to display/calculate
(not for the *Around Frame* type).
Although the start and end frame are always editable, updating the motion
path will change these according to the *Calculation Range* setting. To
ensure your chosen frame range is maintained, choose *Manual Range* there.
.. _bpy.types.AnimVizMotionPaths.frame_before:
.. _bpy.types.AnimVizMotionPaths.frame_after:
Frame Range Before, After
Number of frames to show before and after the current frame
(only for the *Around Frame* type).
.. _bpy.types.AnimVizMotionPaths.frame_step:
Step
Allows displaying one point for every *n* frames on the path.
Mostly useful when you enable the frame number display (see below), to avoid cluttering the 3D Viewport.
.. _bpy.types.AnimVizMotionPaths.use_camera_space_bake:
Bake to Active Camera
When enabled the motion path is calculated in screen space for the active scene camera.
Note that the resulting motion path will only be useful for that single camera.
Switching cameras using markers is not supported. It will only bake to the camera
that is active when the bake was started.
.. _bpy.types.MotionPath.frame_start:
.. _bpy.types.MotionPath.frame_end:
Cache/Bone Cache From, To
These are the start/end frames of the range in which motion paths are shown.
You cannot modify this range without deleting the motion path first.
.. _bpy.ops.pose.paths_calculate:
.. _bpy.ops.object.paths_calculate:
Calculate
If no paths have been calculated, Calculate Paths will create a new motion path in cache based on
the options specified in the pop-up menu or the :ref:`bpy.ops.screen.redo_last` panel.
Note, if the current context is an Armature calculating the objects motion paths, and not the bones,
this operator will calculate the motion paths for all the bones within the armature as well.
Start, End
These are the start/end frames of the range in which motion paths are shown.
The start frame is *inclusive*, so if you set *Start* to 1,
you will really see the frame 1 as starting point of the paths...
Bake Location
Which point on the bones is used when calculating paths.
Only available for bones while in Pose Mode.
:Heads: Calculates the path position of the bone's heads.
:Tails: Calculates the path position of the bone's heads.
.. _bpy.ops.pose.paths_update:
.. _bpy.ops.object.paths_update:
Update Paths
In the case a path has already been calculated, this operator will update the path shape to the current animation.
To change the frame range of the calculated path, you need to delete the path and calculate it again.
.. _bpy.ops.pose.paths_clear:
.. _bpy.ops.object.paths_clear:
:bl-icon:`x` (Clear Paths)
Clears paths on all objects/bones or just the selected ones when holding :kbd:`Shift`.
.. _bpy.ops.object.paths_update_visible:
Update All Paths
Recalculates the motion paths for all visible objects and poses.
Display
-------
.. _bpy.types.AnimVizMotionPaths.show_frame_numbers:
Frame Numbers
When enabled, a small number appears next to each frame dot on the path,
which is of course the number of the corresponding frame.
.. _bpy.types.AnimVizMotionPaths.show_keyframe_highlight:
Keyframes
When enabled, big yellow square dots are displayed on motion paths, showing the keyframes of their bones
(i.e. only the paths of keyed bones at a given frame get a yellow dot at this frame).
.. _bpy.types.AnimVizMotionPaths.show_keyframe_action_all:
\+ Non-Grouped Keyframes
For bone motion paths, it searches the whole Action for keyframes instead of
in groups with matching name only (this is slower).
.. _bpy.types.AnimVizMotionPaths.show_keyframe_numbers:
Keyframe Numbers
When enabled, you will see the numbers of the displayed keyframes,
so this option is obviously only valid when *Show Keys* is enabled.
.. _bpy.types.MotionPath.lines:
Lines
Toggles whether the lines between the points are shown.
.. _bpy.types.MotionPath.line_thickness:
Thickness
Line thickness for motion path.
.. _bpy.types.MotionPath.use_custom_color:
.. _bpy.types.MotionPath.color:
Custom Color
Use custom color for this motion path. The custom color can be modified for time
before and after the current frame.
Example
=======
.. figure:: /images/animation_motion-paths_example-armature.png
An example of a motion path of an armature.
|
