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
|
/****************************************************************************
**
** Copyright (C) 2020 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of Qt Design 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$
**
****************************************************************************/
/*!
\page studio-3d-texture.html
\previouspage studio-3d-materials.html
\nextpage studio-3d-materials-types.html
\title Attaching Textures to Materials
You can use the Texture 3D QML type to attach textures to materials.
You specify an image and how it is mapped to meshes in a 3D scene.
\image studio-qtquick-3d-texture.png "Texture attached to a material in Design mode"
\section1 Selecting the Mapping Method
To specify the method of mapping to use when sampling a texture, select
\uicontrol UV, \uicontrol Environment, or \uicontrol LightProbe in the
\uicontrol {Texture mapping} field.
UV mapping is the process of projecting 2D images to the surface of a
3D model for texture mapping. The letters \e U and \e V denote the axes
of the 2D texture, because x, y, and z are already used to denote the
axes of the 3D object in the model space. You can paint the polygons that
make up a 3D object with color and other surface attributes from a UV
texture map. Pixels in the image are assigned to surface mappings on the
polygon. Usually this is done by programmatically copying a triangular
piece of the image map and pasting it onto a triangle on the object.
UV mapping is used by default for diffuse and opacity maps. It sticks the
image to the mesh, so that a particular same portion of the image always
appears on a particular vertex, unless you animate the UV properties.
Environment mapping is used by default for specular reflection. It
\e projects the image onto the material as though it is being reflected
from the material. Using Environmental mapping for diffuse maps provides a
mirror effect.
Light probe mapping is used by default for HDRI sphere maps of
light probes. For more information about light probes, see
\l {Using Highlights and Reflections}.
To use image data from a file, specify the path to the file in the
\uicontrol Source field. To use a 2D Qt Quick QML type as the source,
specify the type in the \uicontrol {Source item} field. The type is
rendered as an offscreen layer. If you specify the source item, any
image you might specify as a source is ignored.
\note Currently, there is no way to forward input events to the Item
used as a texture source.
\section1 UV Scaling
The \uicontrol {U scale} and \uicontrol {V scale} properties define how
to scale the U and V texture coordinates when mapping to a mesh's UV
coordinates.
Scaling the U value when using horizontal tiling specifies how many times
the texture is repeated from left to right, while scaling the V value when
using vertical tiling specifies the repetition from bottom to top.
To control how the texture is mapped when the U scaling value is greater
than 1, set the horizontal tiling mode in the \uicontrol {U tiling} field.
To control how the texture is mapped when the V scaling value is greater
than 1, set the vertical tiling mode in the \uicontrol {V tiling} field.
To specify that the texture is not tiled, but the value on the edge is used
instead, select \uicontrol ClampToEdge. To repeat the texture and mirrored
it over the x or y axis, select \uicontrol MirroredRepeat. To repeat the
texture over the x or y axis, select \uicontrol Repeat.
\section1 Setting UV Transform Properties
To offset the U coordinate mapping from left to right, set the position of
the component in the \uicontrol {U position} field. To offset the mapping
from bottom to top, set it in the \uicontrol {V position} field.
Specify the U and V pivot point in the \uicontrol {U pivot} and
\uicontrol {V pivot} fields.
To rotate the texture around the pivot point, specify rotation as degrees
in the \uicontrol {UV rotation} field. A positive value indicates clockwise
rotation.
For more information about rotating and pivoting components in the local
coordinate space, see \l {Setting Transform Properties}.
\section1 Applying Textures to Materials
Drag and drop an image from \uicontrol Library > \uicontrol Assets
on a material to create and set the texture automatically, or use
a Texture component. For a default material the created \uicontrol Texture
is assigned to the \uicontrol {Diffuse Map} property and for a principled
material to the \uicontrol {Base Color Map}. For a custom material, you
must assign the texture to a map.
To use Texture components to apply textures to materials:
\list 1
\li Drag and drop a Texture component from the \uicontrol Library to a
material component in the \uicontrol Navigator.
\li In the \uicontrol Properties view, specify the image to use in the
\uicontrol Source field.
\image studio-qtquick-3d-texture-properties.png "Texture properties"
\li Select the material component and specify the id of the texture to
use in the \uicontrol Properties view, \uicontrol {Diffuse map}
field.
\image studio-qtquick-3d-material-texture.png "Material properties"
\endlist
*/
|
