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
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
|
/****************************************************************************
**
** Copyright (C) 2018 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of Qt 3D Studio.
**
** $QT_BEGIN_LICENSE:FDL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU Free Documentation License Usage
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of
** this file. Please review the following information to ensure
** the GNU Free Documentation License version 1.3 requirements
** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
** $QT_END_LICENSE$
**
****************************************************************************/
/*!
\title Animations
\page animations.html
In Studio, it is easy to create keyframe animations to object and material properties. It is also
possible to import animations from 3D creation tools such as Maya, 3D Studio Max, or Blender.
A keyframe is a a time marker that stores the value of a property. A keyframe can for example
define the X position for an element. To create an animation, add another keyframe for the X
position of the same element but in another position on the timeline. Studio will determine the
correct X position for all frames between the two keyframes.
You can animate almost any object or material property. Animatable properties have the
\inlineimage animationIconInactive.png
icon next to their name in the inspector palette.
\image light-properties.png
\section1 Create Animations
To animate a property, follow the steps below:
\list 1
\li
Ensure that \l{studio-toolbar.html#keyframing}{autoset keyframes} is toggled on.
\li
Select the element in the timeline palette, and set the desire starting value for the
animated property.
\li
Move the playhead to the position in the timeline where you want the animation to start.
\li
Enable animation for the property by clicking the \inlineimage animationIconInactive.png
icon next to the property name in the inspector palette.
\li
Move the playhead to a new position, then change the value for the animated property.
\endlist
\image Studio-Timeline-Breadcrumb.png
Now that you have two keyframes in the timeline, you can preview the animation by dragging the
playhead in the timeline palette, or by running the presentation in the Studio or the Viewer.
Moving the playhead to a new position, and then changing the value of a property with animation
enabled will create a new keyframe.
You can click the arrow icon next to the object with animated properties to expand it, this will
display all animated properties and keyframes.
\image object-animated-properties.png
Furthermore, double-click one of the properties to display the property graph. The property graph
displays the property animation curves and allows you to edit them.
\image object-animation-channels.png
You can toggle channel visibility by clicking the channel icon on the left side of the scene graph
(Ctrl + left mouse click to multi select). This function is only available if the animated
property has more than one channel.
\section1 Edit Animations
\section2 Insert Keyframes
As mentioned above, changing the value of an animated property will create a new keyframe if there
isn't already a keyframe in the same position. This requires that \uicontrol {Autoset Keyframes}
is toggled on.
To manually insert a keyframe, first place the playhead in the position where you want to create the
keyframe. Next, do one of the following:
\list
\li
Right-click the timebar of the animated element, next select \uicontrol {Insert Keyframe}
from the context menu.
\li
Left-click the timebar of the animated element, next press \uicontrol {S}.
\endlist
Keyframes will be created for all animated properties for the selected element.
\section2 Delete Keyframes
To delete a keyframe, first select it (\uicontrol {Ctrl + left mouse click} to multi select). Next,
do one of the following:
\list
\li
Press \uicontrol {Del}.
\li Right-click the keyframe and select \uicontrol{Delete Selected Keyframe} from the
context menu.
\endlist
To delete all keyframes of an element, do one of the following:
\list
\li
Right-click the timebar and select \uicontrol {Delete All Channel Keyframes}.
\li
Left-click the timebar, next press \uicontrol {Ctrl + Alt + K}.
\endlist
\section2 Move Keyframes
To move a keyframe to a desired position in the timeline, do one of the following:
\list
\li
With the left mouse button, drag and drop it.
\note Hold \uicontrol {Shift} while dragging to snap to timeline markers.
\li
Double-click the keyframe and enter the desired timeline position in the dialog window.
\li
Right-click the keyframe and select \uicontrol {Set Keyframe Time}. Next, enter the desired
timeline position in the dialog window.
\endlist
\section2 Change Property Values
To change a property value for a keyframe, follow the steps below:
\list 1
\li
Move the playhead to the keyframe, hold \c {Shift} to snap the playhead to the keyframe.
\li
Select the desired element in the timeline palette.
\li
In the inspector palette, change the value of the desired animated property.
\endlist
\section2 Copy Keyframes
To copy keyframes from one element to another, follow the steps below:
\list 1
\li
Select the keyframe(s) to copy on an element.
\li
Right-click on one of the selected keyframes and select \uicontrol{Copy Selected Keyframes} from
the context menu.
\li
Position the playhead at the time where the first keyframe should be placed.
\li
Right click on the time bar for the element and select \uicontrol {Paste Keyframes} from.
the context menu.
\endlist
\section1 Animation Types
There are three different types of animations in Studio. These are described below.
To change animation type, right-click the property row in the timeline and select
\uicontrol{Animation Type}.
\image select-animation-type.png
\section2 Linear
With linear interpolation the value changes at the same rate from one value to the next.
\section2 Ease In/Out
As the playhead moves from one keyframe to the next, the Qt 3D Studio
Runtime can perform \e {linear interpolation}, \e {smooth
interpolation}, or a custom blending somewhere in-between. With linear
interpolation the value changes at the same rate from one value to the
next. With smooth interpolation the value starts off holding the
previous keyframe value, accelerates towards the next keyframe value,
and then decelerates to stop at the new value.
To set the interpolation, first select the keyframe(s) that you want to
adjust, then right-click one of the selected keyframes, and from the
context menu choose \uicontrol {Set Interpolation}. The \uicontrol {Ease In} setting
controls how the value behaves as it approaches the keyframe and the
\uicontrol {Ease Out} setting controls how the value behaves when leaving the
keyframe.
\image Studio-Timeline-Interpolation.png
\note You can set the default interpolation values for ease in/out animations
in the \l{studio-menu.html#edit}{studio preferences}.
\section2 Bezier
Bezier animations are using a bezier curve to define the animation. This gives you much more control
of the animation and interpolation.
Two or more end points define a bezier curve. Each end point represents the channel value
of a keyframe. These end points have two control points (handles), or if they are located in the
beginning or end of the timeline, one control point.
\image bezier-curves.png
\section3 Control Points
Once you have created your animation, you can adjust it by moving the control points. To display
the control points, first select the end point. Then, to move the control point, drag it with the
left mouse button. If the end point has two control points, both will move simultaneously. To
move just one, hold down the Ctrl key while dragging. You cannot move control points past previous
or next keyframe.
\section3 End Points
To move an end point horizontally, you will need to move the actual keyframe on the timeline bar. To
move it vertically, grab it with the mouse and drag it up/down.
\section1 Import Animations
You can import transform (scale/rotation/location) animations from 3D creation tools
such as Maya, Blender, 3D Studio Max and Modo.
Read more in the \l{3D Assets} section.
\section1 Further Topics
\list
\li
\l{Studio: Timeline Palette}{The Timeline}
The timeline palette provides direct access to all elements in your scene, and also gives you
control over the animation and timing within a slide.
\li
\l{Dynamic Keyframes}
Dynamic keyframes are a powerful feature that allow you to smoothly interpolate between different
animated values on different slides.
\endlist
*/
|
