aboutsummaryrefslogtreecommitdiffstats
path: root/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-morph-target.qdoc
blob: 7eb852ecb3017223e3607ad668344fcc6a3b5a82 (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
// Copyright (C) 2021 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only

/*!
    \page studio-3d-morph-target.html
    \previouspage studio-3d-scene-environment.html
    \nextpage studio-3d-repeater-3d.html

    \title Morph Target

    The \uicontrol {Morph Target} component can be used to define morph targets
    for vertex animation. Morph targets are the objects we bind to control
    the morphing of a model. Usually, morphing is controlled by using
    \l {Timeline}{timeline} animation or \l {Applying Animation}{property animation}.
    The degree of morphing is controlled by defining the \uicontrol Weight
    property of the \uicontrol {Morph Target} component.

    The normal workflow is to use an external content creation tool to create
    a mesh, which also contains morph targets, and import it to \QDS.

    To add a morph target for a model in \QDS, drag-and-drop a
    \uicontrol {Morph Target} component from \uicontrol Components
    > \uicontrol {Qt Quick 3D} > \uicontrol {Qt Quick 3D} to \uicontrol Scene in
    \l Navigator. Then select the model in \uicontrol Navigator, and in
    \l Properties > \uicontrol Model > \uicontrol {Morph Targets}, select the
    name of the \uicontrol {Morph Target} component.

    \section1 Morph Target Properties

    To define attributes and weight for a \uicontrol {Morph Target}, select it
    in \uicontrol Navigator and specify its properties in the
    \uicontrol Properties view.

    \image studio-3d-morph-target-properties.png "Morph Target Properties"

    Use the \uicontrol Weight property to specify the weight of the
    \uicontrol {Morph Target}. The value of \uicontrol Weight functions as the
    multiplication factor used by the linear interpolation.
    If the value is set to 1, the target is fully applied.
    If the \uicontrol Weight property value is set to 0, it has no influence.

    Use the \uicontrol Attributes property to specify a set of attributes for the
    selected \uicontrol {Morph Target}. In order to animate vertex attributes
    in morphing, the mesh must contain those target attributes and the
    \uicontrol {Morph Target} must have the attributes enabled.

    Click the dropdown menu to select one of the following attributes:
        \list
            \li \uicontrol Position animates the vertex positions.
            \li \uicontrol Normal animates the normal vectors.
            \li \uicontrol Tangent animates the tangent vectors.
            \li \uicontrol Binormal animates the binormal vectors.
        \endlist
*/