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
|
/****************************************************************************
**
** Copyright (C) 1993-2009 NVIDIA Corporation.
** Copyright (C) 2017 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 Studio: Project Palette
\page studio-project-palette.html
\ingroup qt3dstudio-studio
The project palette displays the files and folders on disk for your project.
Only files usable by Studio are displayed in the palette.
\section1 Importing Assets
You can import assets to your project in the following ways:
\list
\li
\list 1
\li From the menu bar, select \uicontrol{File > Import Assets}.
\li Select desired files to import, then press \uicontrol{Open}.
\endlist
\li
\list 1
\li In the bottom of the project palette, click the \inlineimage import-assets-icon.png
.
\li Select desired files to import, then press \uicontrol{Open}.
\endlist
\li
\list 1
\li In the project palette, right-click and select \uicontrol{Import Assets} from the
context menu.
\li Select desired files to import, then press \uicontrol{Open}.
\note If a folder is selected in the project palette, only files of corresponding file types
will be visible in the file dialogue. If you for example have selected the \e{models} folder
before importing, only files of \e{.fbx} and \e{.dae} will be shown.
\endlist
\li
\list 1
\li From the file system, drag and drop desired files to the project palette. If the files
are not dropped in a specific folder they will be automatically imported to the
corresponding folder. For example, image files will be imported to the \e maps folder.
\image import-assetes-dnd.png
\endlist
\endlist
When importing files to your project, a \e copy of the file is imported. The original file will
always remain untouched.
\section2 Importing Assets from the Asset Library
Qt 3D Studio ships with a variety of sample assets to help you
experiment and to speed common development needs. To import these assets to your project, use the
assets library icons in the bottom part of the project palette.
\image sampleAssets.png
Clicking on one of these icons will open the corresponding assets library folder. Select the
desired files and press open to import them to your project, this will \e{copy} the sample asset
into your project. Once you have a copy you are free to edit it without fear of damaging the
pristine original.
\section1 Managing Assets
If you wish to rename or delete items from your project, simply do so
via the file system. Right-click the folder (or an asset in the folder) in the project
palette and select \uicontrol{Show Containing Folder} to open the folder in the file
system.
\section1 Using Assets
To use an item from the project palette in your presentation, drag the
item into the \l{studio-scene-view-and-matte.html}{scene view}
or \l{studio-timeline-palette.html}{timeline palette}. A new element
will be created in your scene tied to that asset.
For convenience, dragging an image from the project palette into your
scene will automatically create a rectangular model scaled to the aspect
ratio of your image, with the image used as the diffuse map on the
material. Dragging out a font file will create a text element with the
font set correctly.
Changes to the asset on disk (for example, editing an image in Photoshop),
will automatically update inside Studio.
The one caveat to the above are 3D model assets. When you import a 3D
model (in Collada or FBX format) into your project, it is converted into
a \c{.import} file that references one or more \c{.mesh}
assets. Changes to the original 3D model file will \b{not}
automatically update inside of Studio. To update a changed model,
right-click on the \c{.import} file in the project palette and
choose \uicontrol{Refresh Import}. In the subsequent file dialog,
select the model file on disk that you wish to re-import. Your model in Studio will
be updated. For more details, read the section
\l{best-practices-importing-3d-content.html}{Working with 3D Content}.
\omit
\section1 Locating Missing Assets
\image Studio-Project-MissingAsset.png
If you open a presentation that references other files, and one or more
those files cannot be found, Studio will present you with a dialog
listing all assets that could not be found. Additionally, each missing
asset will be shown in the Project palette with a caution icon next to
the file.
If you click on this icon, a context menu with the option \b {Locate
File} will be shown. Choosing this option will show a standard file
open dialog, allowing you to supply a new location for a moved asset.
\b {Warning}: If the missing assets expose custom properties to the
artist - such as a presentation behavior, layer effect, or custom
material - any custom values or animations you have specified for these
assets will be lost if you relocate the file. Until
\l{known-limitations.html#i9208}{this issue} is resolved,
the only safe way to move or rename such referenced assets is by
hand-editing the \c{.uip} presentation file.
\endomit
*/
|
