File: tools.rst

package info (click to toggle)
blender-doc 4.3-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 253,604 kB
  • sloc: python: 13,030; javascript: 322; makefile: 113; sh: 107
file content (196 lines) | stat: -rw-r--r-- 5,830 bytes parent folder | download
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

***************
Animation Tools
***************

.. _bpy.ops.grease_pencil.insert_blank_frame:

Insert Blank Keyframe (Active Layer)
====================================

.. reference::

   :Mode:      Draw Mode, Edit Mode, Sculpt Mode
   :Menu:      :menuselection:`Stroke --> Animation --> Insert Blank Keyframe (Active Layer)`
   :Shortcut:  :kbd:`Shift-I`

Add a new blank keyframe to the active layer at the current frame.
If there is already a keyframe at the current frame,
a new blank keyframe will be added on the next frame.

All Layers
   When enabled, Blank keyframe will be created on all layers, not only the active one.

Duration
   The number of blank frames to insert.


Insert Blank Keyframe (All Layers)
==================================

.. reference::

   :Mode:      Draw Mode, Edit Mode, Sculpt Mode
   :Menu:      :menuselection:`Stroke --> Animation --> Insert Blank Keyframe (All Layers)`

Same as :ref:`bpy.ops.grease_pencil.insert_blank_frame` but *All Layers* is enabled by default.


.. _bpy.ops.grease_pencil.frame_duplicate:

Duplicate Active Keyframe (Active Layer)
========================================

.. reference::

   :Mode:      Draw Mode, Edit Mode, Sculpt Mode
   :Menu:      :menuselection:`Stroke --> Animation --> Duplicate Active Keyframe (Active Layer)`

Duplicates the strokes on the last keyframe by copying them to the current frame.

Mode
   Pick which layers to duplicate.

   :Active: Duplicate only the active layer.
   :All: Duplicate all the layers.


Duplicate Active Keyframe (All Layers)
======================================

.. reference::

   :Mode:      Draw Mode, Edit Mode, Sculpt Mode
   :Menu:      :menuselection:`Stroke --> Animation --> Duplicate Active Keyframe (All Layers)`

Same as :ref:`bpy.ops.grease_pencil.frame_duplicate` but the *Mode* is set to *All* by default.


.. _bpy.ops.grease_pencil.delete_frame:

Delete Active Keyframe (Active Layer)
=====================================

.. reference::

   :Mode:      Draw Mode, Edit Mode, Sculpt Mode
   :Menu:      :menuselection:`Stroke --> Animation --> Delete Active Keyframe (Active Layer)`
   :Shortcut:  :kbd:`Alt-I`

Deletes the last keyframe in the Dope Sheet or the current keyframe if you are on one.

Type
   Pick which layer to delete keyframes.

   :Active Frame: Deletes current frame in the active layer.
   :All Active Frames: Delete active frames for all layers.


Delete Active Keyframe (All Layers)
===================================

.. reference::

   :Mode:      Draw Mode, Edit Mode, Sculpt Mode
   :Menu:      :menuselection:`Stroke --> Animation --> Delete Active Keyframes (All Layers)`
   :Shortcut:  :kbd:`Shift-Delete`

Same as :ref:`bpy.ops.grease_pencil.frame_duplicate` but the *Type* is set to *All Active Frames* by default.


.. _bpy.ops.grease_pencil.interpolate_sequence:

Interpolate Sequence
====================

.. reference::

   :Mode:      Draw Mode, Edit Mode
   :Menu:      :menuselection:`Grease Pencil --> Interpolate Sequence`
   :Shortcut:  :kbd:`Shift-Ctrl-E`

Interpolate strokes between the previous and next keyframe by adding *multiple* keyframes.
A breakdown keyframe will be added on every frame between the previous and next keyframe.


Step
   umber of frames between generated interpolated frames.
Layer
    Layers included in the interpolation.
Exclude Break Downs
   Exclude existing Breakdowns keyframes as interpolation extremes.
Flip Mode
   Invert destination stroke to match start and end with source stroke.
Smooth
   Amount of smoothing to apply to interpolated strokes, to reduce jitter/noise.
Iterations
   Number of times to smooth newly created strokes.
Type
   Interpolation method to use the next time *Interpolate Sequence* is run.


.. _bpy.ops.gpencil.bake_mesh_animation:

Bake Mesh to Grease Pencil
==========================

.. reference::

   :Editor:    3D Viewport
   :Mode:      Object Mode
   :Menu:      :menuselection:`Object --> Animation --> Bake Mesh to Grease Pencil...`

Converts each frame of a mesh animation within a selected frame range to
a Grease Pencil object keyframed strokes. The *Bake Action* operator computes the final animation of
the selected objects with all those modifiers, drivers, and constraints applied, and keyframes the result.

Target Object
   Determines if the image empty is kept or replaced.

   New Object: Creates a new grease pencil object and keeps the image empty
   Selected Object: Replaces the image empty with the grease pencil object.
Start Frame, End Frame
   Start/End frame for the baking process.
Step
   Frame steps for the baking process
Thickness
   Strokes thickness.
Threshold Angle
   Threshold value that determine the strokes end.
Stroke Offset
   Sets offset to separate strokes from filled strokes.
Only Seam Edges
   Convert only edges marked as seam.
Export Faces
   Convert faces as filled strokes.
Only Selected Keyframes
   Convert only the selected keyframes.
Target Frame
   Target destination frame for the baked animation.
Projection Type
   Sets the projection type to use for the converted strokes.


.. _bpy.ops.grease_pencil.bake_grease_pencil_animation:

Bake Object Transform to Grease Pencil
======================================

.. reference::

   :Editor:    3D Viewport
   :Mode:      Object Mode
   :Menu:      :menuselection:`Object --> Animation --> Bake Object Transform to Grease Pencil`

Applies all transform animation at Object level within a selected frame range to Grease Pencil object keyframes.

Start Frame, End Frame
   Start/End frame for the baking process.
Step
   Frame steps for the baking process.
Only Selected Keyframes
   Convert only the selected keyframes.
Target Frame
   Target destination frame for the baked animation.
Projection Type
   Sets the projection type to use for the converted strokes.