aboutsummaryrefslogtreecommitdiffstats
path: root/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-view.qdoc
blob: 8a3930a3f15e118c3a5c326c5334ef406e26af4d (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
55
56
57
58
59
60
61
62
63
64
65
/****************************************************************************
**
** Copyright (C) 2020 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the Qt Design Studio documentation.
**
** 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.
**
****************************************************************************/

/*!
    \contentspage index.html
    \previouspage studio-3d-editor.html
    \page studio-3d-view.html
    \nextpage studio-3d-components.html

    \title Adding 3D Views

    To display \l {Qt Quick 3D} types in the \uicontrol Library, select
    \uicontrol Library > \uicontrol {QML Imports} > \uicontrol {Add Import} >
    \uicontrol QtQuick3D. The types are displayed in the \uicontrol {QML Types}
    tab.

    \image studio-qtquick-3d-components.png

    To add a 3D view to the scene, drag and drop a \uicontrol {View 3D}
    component from \uicontrol Library > \uicontrol {QML Types} >
    \uicontrol {Qt Quick 3D} to the 3D editor or to the \uicontrol Navigator.
    A 3D view contains a reference node that specifies a scene light, camera,
    and model. A default material is attached to the model. You can attach
    textures to materials.

    \image studio-navigator-view3d.png "View 3D component in the Navigator"

    By default, a directional light and a perspective camera are used.
    To use other light and camera types, change the type of the component in
    the \uicontrol Type field in the \uicontrol Properties view. For example,
    to use a point light, enter \e {PointLight}.

    \image studio-3d-properties-type.png "Type field in Properties view"

    To edit component properties, select the component in the 3D editor
    or in the \uicontrol Navigator and modify the property values in the
    \uicontrol Properties view.

    \image studio-qtquick-3d-view.png "View 3D component properties"

    For more information about the available components and their properties,
    see \l{Using 3D Components}.
*/