diff --git a/doc/qtdesignstudio/images/studio-3d-properties-type.png b/doc/qtdesignstudio/images/studio-3d-properties-type.png index 7589d8dc176..1bdcadf4f91 100644 Binary files a/doc/qtdesignstudio/images/studio-3d-properties-type.png and b/doc/qtdesignstudio/images/studio-3d-properties-type.png differ diff --git a/doc/qtdesignstudio/images/studio-navigator-view3d.png b/doc/qtdesignstudio/images/studio-navigator-view3d.png index a3bce1238bc..9c5bab7f8c6 100644 Binary files a/doc/qtdesignstudio/images/studio-navigator-view3d.png and b/doc/qtdesignstudio/images/studio-navigator-view3d.png differ diff --git a/doc/qtdesignstudio/images/studio-qtquick-3d-components.png b/doc/qtdesignstudio/images/studio-qtquick-3d-components.png index 07ca30b5509..c256af07b5a 100644 Binary files a/doc/qtdesignstudio/images/studio-qtquick-3d-components.png and b/doc/qtdesignstudio/images/studio-qtquick-3d-components.png differ diff --git a/doc/qtdesignstudio/images/studio-qtquick-3d-view.png b/doc/qtdesignstudio/images/studio-qtquick-3d-view.png index 77a130d8cdc..6e96bd5bf6f 100644 Binary files a/doc/qtdesignstudio/images/studio-qtquick-3d-view.png and b/doc/qtdesignstudio/images/studio-qtquick-3d-view.png differ diff --git a/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-view.qdoc b/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-view.qdoc index 3cc6c92d2f9..7886acbfcd1 100644 --- a/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-view.qdoc +++ b/doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-view.qdoc @@ -30,37 +30,61 @@ \title Adding 3D Views - You can use a wizard to create a Qt Quick 3D UI project that imports - the \l{Qt Quick 3D} QML types to the \uicontrol {QML Types} tab in - \uicontrol Library and contains a 3D view, scene light, camera, and - model. A default material is attached to the model. You can attach - textures to materials. For more information about creating projects, - see \l{Creating Projects}. + To create a Qt Quick 3D UI project, we recommend using a \uicontrol + {Qt Quick 3D Application Template} wizard template that imports the + \l{Qt Quick 3D} QML types to the \uicontrol {QML Types} tab in + \uicontrol Library and contains a 3D view. A 3D view type includes a + \l {Setting Scene Environment}{scene environment} as well as a scene + \l {Using Lights}{light}, \l {Using Scene Camera}{camera}, and \l {Adding + Models}{model}. A default \l {Using Materials and Shaders}{material} is + attached to the model. You can attach \l {Attaching Textures to Materials} + {textures} to materials. For more information about creating projects, see + \l{Creating Projects}. To add a 3D view to some other kind of project and to display the Qt Quick 3D QML types in \uicontrol Library, select \uicontrol Library > \uicontrol {QML Imports} > \uicontrol {Add Import} > \uicontrol QtQuick3D. - \image studio-qtquick-3d-components.png + \image studio-qtquick-3d-components.png "Qt Quick 3D components in Library" - To add components to the scene, drag and drop them to \uicontrol Navigator - or \uicontrol {Form Editor}. + After importing the Qt Quick 3D QML types, drag and drop a \uicontrol + View3D type to \uicontrol Navigator or to \uicontrol {Form Editor}. - \image studio-navigator-view3d.png "View 3D component in the Navigator" + \image studio-navigator-view3d.png "A 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 \uicontrol Properties. For example, - to use a point light, enter \e {PointLight}. + By default, a directional light and a perspective camera are used in a 3D + scene created by using the wizard template mentioned above. To use other + light and camera types, select the component in \uicontrol {3D Editor} or + \uicontrol Navigator and change the type of the component in the \uicontrol + Type field in \uicontrol Properties. 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 - \uicontrol {Form Editor} or \uicontrol Navigator and - modify the property values in \uicontrol Properties. + Similarly to other components, you can select a 3D view in \uicontrol + Navigator or \uicontrol {3D Editor} and modify its property values in the + \uicontrol Properties view. Use the properties in the \uicontrol View3D + tab to set some properties specific to a 3D view component. \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}. + The \uicontrol Camera property defines which camera is used to render the + scene to \uicontrol {Form Editor}. If this property is not defined, the + first enabled camera in the scene will be used. + + The \uicontrol Environment property specifies the \uicontrol + {Scene Environment} used to render the scene. By default, the first + \uicontrol {Scene Environment} in the scene is set as the property value. + + The \uicontrol {Import Scene} property defines the ID of the component to + render to \uicontrol {Form Editor}. The component does not have to be a + child of a 3D view type. This referenced component becomes a sibling to + child items of a 3D view, if there are any. You can use this property, for + example, to create a split screen view showing your scene from multiple + cameras. For more information on how to to use a 3D view to show a scene + from multiple cameras, see \l {Qt Quick 3D - View3D Example}. + + \note The \uicontrol {Import Scene} property can only be set once. + Subsequent changes will have no effect. + */