Merge "Merge remote-tracking branch 'origin/master' into 11.0" into 11.0

This commit is contained in:
The Qt Project
2023-05-23 09:20:01 +00:00
835 changed files with 28126 additions and 11223 deletions

View File

@@ -6,6 +6,7 @@ include(Utils)
env_with_default("QTC_BUILD_WITH_PCH" ENV_QTC_BUILD_WITH_PCH ON) env_with_default("QTC_BUILD_WITH_PCH" ENV_QTC_BUILD_WITH_PCH ON)
env_with_default("QTC_WITH_TESTS" ENV_QTC_WITH_TESTS OFF) env_with_default("QTC_WITH_TESTS" ENV_QTC_WITH_TESTS OFF)
env_with_default("QTC_WITH_QMLDESIGNER" ENV_QTC_WITH_QMLDESIGNER ON)
option(BUILD_WITH_PCH "Build with precompiled headers" "${ENV_QTC_BUILD_WITH_PCH}") option(BUILD_WITH_PCH "Build with precompiled headers" "${ENV_QTC_BUILD_WITH_PCH}")
@@ -35,6 +36,8 @@ qtc_link_with_qt()
option(WITH_TESTS "Build Tests" ${ENV_QTC_WITH_TESTS}) option(WITH_TESTS "Build Tests" ${ENV_QTC_WITH_TESTS})
add_feature_info("Build tests" ${WITH_TESTS} "") add_feature_info("Build tests" ${WITH_TESTS} "")
option(WITH_QMLDESIGNER "Build QmlDesigner" ${ENV_QTC_WITH_QMLDESIGNER})
add_feature_info("Build QmlDesigner and related code" ${WITH_QMLDESIGNER} "")
option(WITH_DEBUG_CMAKE "Enabled CMake project debugging functionality" OFF) option(WITH_DEBUG_CMAKE "Enabled CMake project debugging functionality" OFF)
option(SHOW_BUILD_DATE "Show build date in about dialog" OFF) option(SHOW_BUILD_DATE "Show build date in about dialog" OFF)
option(WITH_SANITIZE "Build with sanitizer enabled" OFF) option(WITH_SANITIZE "Build with sanitizer enabled" OFF)

View File

@@ -7,7 +7,8 @@
"generator": "Ninja", "generator": "Ninja",
"cacheVariables": { "cacheVariables": {
"BUILD_PLUGINS": "Core;Designer;DiffEditor;TextEditor;ProjectExplorer;CppEditor;CodePaster;Docker;Git;Help;QmakeProjectManager;CMakeProjectManager;ClangCodeModel;ClangTools;ClangFormat;Debugger;QtSupport;ResourceEditor;VcsBase;Welcome;LanguageClient;RemoteLinux", "BUILD_PLUGINS": "Core;Designer;DiffEditor;TextEditor;ProjectExplorer;CppEditor;CodePaster;Docker;Git;Help;QmakeProjectManager;CMakeProjectManager;ClangCodeModel;ClangTools;ClangFormat;Debugger;QtSupport;ResourceEditor;VcsBase;Welcome;LanguageClient;RemoteLinux",
"BUILD_EXECUTABLES": "QtCreator;qtcreator_ctrlc_stub;qtcreator_process_stub;win64interrupt;qtcreator_processlauncher" "BUILD_EXECUTABLES": "QtCreator;qtcreator_ctrlc_stub;qtcreator_process_stub;win64interrupt;qtcreator_processlauncher",
"WITH_QMLDESIGNER": "OFF"
} }
} }
] ]

View File

@@ -18,7 +18,7 @@ The standalone binary packages support the following platforms:
* Windows 10 (64-bit) or later * Windows 10 (64-bit) or later
* (K)Ubuntu Linux 20.04 (64-bit) or later * (K)Ubuntu Linux 20.04 (64-bit) or later
* macOS 10.14 or later * macOS 10.15 or later
## Contributing ## Contributing
@@ -37,7 +37,7 @@ Prerequisites:
* Qt 6.2 or later. The Qt version that you use to build Qt Creator defines the * Qt 6.2 or later. The Qt version that you use to build Qt Creator defines the
minimum platform versions that the result supports minimum platform versions that the result supports
(Windows 10, RHEL/CentOS 8.4, Ubuntu 20.04, macOS 10.14 for Qt 6.2). (Windows 10, RHEL/CentOS 8.4, Ubuntu 20.04, macOS 10.15 for Qt 6.2).
* Qt WebEngine module for QtWebEngine based help viewer * Qt WebEngine module for QtWebEngine based help viewer
* On Windows: * On Windows:
* MinGW with GCC 9 or Visual Studio 2019 or later * MinGW with GCC 9 or Visual Studio 2019 or later

View File

@@ -0,0 +1 @@
install(DIRECTORY QtProject DESTINATION "${IDE_DATA_PATH}")

View File

@@ -0,0 +1,18 @@
set(IDE_VERSION "4.2.0") # The IDE version.
set(IDE_VERSION_COMPAT "4.2.0") # The IDE Compatibility version.
set(IDE_VERSION_DISPLAY "4.2.0") # The IDE display version.
set(IDE_COPYRIGHT_YEAR "2023") # The IDE current copyright year.
set(IDE_SETTINGSVARIANT "QtProject") # The IDE settings variation.
set(IDE_COPY_SETTINGSVARIANT "Nokia") # The IDE settings to initially import.
set(IDE_DISPLAY_NAME "Qt Design Studio") # The IDE display name.
set(IDE_ID "qtdesignstudio") # The IDE id (no spaces, lowercase!)
set(IDE_CASED_ID "QtDesignStudio") # The cased IDE id (no spaces!)
set(IDE_BUNDLE_IDENTIFIER "org.qt-project.${IDE_ID}") # The macOS application bundle identifier.
set(PROJECT_USER_FILE_EXTENSION .qtds)
set(IDE_DOC_FILE "qtdesignstudio/qtdesignstudio.qdocconf")
set(IDE_DOC_FILE_ONLINE "qtdesignstudio/qtdesignstudio-online.qdocconf")
set(IDE_ICON_PATH "${CMAKE_CURRENT_LIST_DIR}")
set(IDE_LOGO_PATH "${CMAKE_CURRENT_LIST_DIR}")

View File

@@ -0,0 +1,64 @@
[Plugins]
Ignored=AutoTest, Bazaar, ClangCodeModel, ClangTools, CMakeProjectManager, CVS, ClassView, CodePaster, CppEditor, CtfVisualizer, Designer, FakeVim, GLSLEditor, GenericProjectManager, IncrediBuild, Ios, Macros, Mercurial, ModelEditor, Perforce, PerfProfiler, ScxmlEditor, QbsProjectManager, Qnx, Subversion, Valgrind, VcsBase, Welcome, WinRt, Python
ForceEnabled=Boot2Qt, StudioWelcome, QmlDesigner, ModuleTools, McuSupport
[Core]
NewDialog\LastCategory=H.StudioProject
NewDialog\LastPlatform=Desktop
NewDialog\ShowPlatformFilter=false
NewDialog\AllowAllTemplates=false
NewDialog\BlacklistedCategories=U.Java, R.Qt, T.Import, H.Project, U.General
NewDialog\AlternativeWizardStyle=true
CreatorTheme=design
[Menu]
HideBuild=true
HideDebug=true
HideAnalyze=true
HideTools=true
[QML]
Designer\StandAloneMode=true
Designer\EnableTimelineView=true
Designer\DisableItemLibraryUpdateTimer=false
Designer\NewWelcomePage=true
Designer\EnableWelcomePageDownload=true
Designer\OldStatesEditor=false
Designer\TopToolBar=true
[Bauhaus]
LeftSideBar\Views=Library, Navigator
LeftSideBar\Visible=true
RightSideBar\VerticalPosition=@ByteArray(\0\0\0\xff\0\0\0\x1\0\0\0\x2\0\0\x2\xdf\0\0\0n\0\0\0\0\x1\x1\0\0\0\x2\0)
RightSideBar\Views=Properties, ConnectionView
RightSideBar\Visible=true
[MainWindow]
ModeSelectorLayout=2
[OutputPanePlaceHolder]
CurrentIndex=2
[OutputPaneVisibility]
size=1
1\id=QtCreator.Pane.CompileOutput
1\visible=false
[Boot2Qt]
adbStartEnabled=false
flashActionDisabled=true
[%General]
OverrideLanguage=C
[General]
HideOptionCategories=C++, Debug, Designer, Kits, BuildAndRun, CPaster, LanguageClient, Version Control
[Help]
ContextHelpOption=3
HomePage=qthelp://org.qt-project.qtdesignstudio.200/doc/studio-getting-started.html
[ProjectExplorer]
Settings\ShowRunOutput=0
[KeyboardShortcutsV2]
QtCreator.ReturnToEditor=

File diff suppressed because one or more lines are too long

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.2 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 482 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 529 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 10 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 735 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 24 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.6 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 118 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 509 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 12 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 29 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.1 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.4 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 29 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 65 KiB

View File

@@ -0,0 +1,68 @@
{
"images" : [
{
"size" : "16x16",
"idiom" : "mac",
"filename" : "icon_16x16.png",
"scale" : "1x"
},
{
"size" : "16x16",
"idiom" : "mac",
"filename" : "icon_16x16@2x.png",
"scale" : "2x"
},
{
"size" : "32x32",
"idiom" : "mac",
"filename" : "icon_32x32.png",
"scale" : "1x"
},
{
"size" : "32x32",
"idiom" : "mac",
"filename" : "icon_32x32@2x.png",
"scale" : "2x"
},
{
"size" : "128x128",
"idiom" : "mac",
"filename" : "icon_128x128.png",
"scale" : "1x"
},
{
"size" : "128x128",
"idiom" : "mac",
"filename" : "icon_128x128@2x.png",
"scale" : "2x"
},
{
"size" : "256x256",
"idiom" : "mac",
"filename" : "icon_256x256.png",
"scale" : "1x"
},
{
"size" : "256x256",
"idiom" : "mac",
"filename" : "icon_256x256@2x.png",
"scale" : "2x"
},
{
"size" : "512x512",
"idiom" : "mac",
"filename" : "icon_512x512.png",
"scale" : "1x"
},
{
"size" : "512x512",
"idiom" : "mac",
"filename" : "icon_512x512@2x.png",
"scale" : "2x"
}
],
"info" : {
"version" : 1,
"author" : "xcode"
}
}

Binary file not shown.

After

Width:  |  Height:  |  Size: 5.2 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 10 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 482 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 735 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 10 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 24 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 735 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.6 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 24 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 54 KiB

View File

@@ -27,11 +27,14 @@ macro.QC = "$IDE_DISPLAY_NAME"
macro.QCE = "$IDE_DISPLAY_NAME Enterprise" macro.QCE = "$IDE_DISPLAY_NAME Enterprise"
macro.QD = "Qt Designer" macro.QD = "Qt Designer"
macro.QDS = "Qt Design Studio" macro.QDS = "Qt Design Studio"
macro.QQEM = "Qt Quick Effect Maker"
macro.QDV = "Qt Design Viewer" macro.QDV = "Qt Design Viewer"
macro.QL = "Qt Linguist" macro.QL = "Qt Linguist"
macro.QMCU = "Qt for MCUs"
macro.QMLD = "Qt Quick Designer" macro.QMLD = "Qt Quick Designer"
macro.QQV = "Qt QML Viewer" macro.QQV = "Qt QML Viewer"
macro.QSDK = "Qt" macro.QSDK = "Qt"
macro.QUL = "Qt Quick Ultralite"
macro.qtcversion = $QTC_VERSION macro.qtcversion = $QTC_VERSION
macro.param = "\\e" macro.param = "\\e"
macro.raisedaster.HTML = "<sup>*</sup>" macro.raisedaster.HTML = "<sup>*</sup>"

View File

@@ -17,3 +17,43 @@
\externalpage https://doc.qt.io/qtdesignstudio/studio-optimized-3d-scenes.html \externalpage https://doc.qt.io/qtdesignstudio/studio-optimized-3d-scenes.html
\title Creating Optimized 3D Scenes \title Creating Optimized 3D Scenes
*/ */
/*!
\externalpage https://doc.qt.io/QtForMCUs/
\title \QMCU documentation
*/
/*!
\externalpage https://doc.qt.io/QtForMCUs/qtul-qsg-traveoii-designui.html
\title Designing a UI for Infineon Traveo II
*/
/*!
\externalpage https://doc.qt.io/QtForMCUs/qtul-qsg-miimxrt1170-designui.html
\title Designing a UI for NXP i.MX RT1170
*/
/*!
\externalpage https://doc.qt.io/QtForMCUs/qtul-qsg-ra6m3g-designui.html
\title Designing a UI for Renesas RA6M3G
*/
/*!
\externalpage https://doc.qt.io/QtForMCUs/qtul-qsg-rh850-designui.html
\title Designing a UI for Renesas RH850-D1M1A
*/
/*!
\externalpage https://doc.qt.io/qtcreator/creator-developing-mcu.html
\title Connecting MCUs
*/
/*!
\externalpage https://doc.qt.io/QtForMCUs/qtul-infineon-traevoii-qsg.html
\title Infineon Traveo II quick start guide
*/
/*!
\externalpage https://doc.qt.io/QtForMCUs/qtul-nxp-rt1170-qsg.html
\title NXP i.MX RT1170 quick start guide
*/
/*!
\externalpage https://doc.qt.io/QtForMCUs/qtul-renesas-ra6-qsg.html
\title Renesas EK-RA6M3G quick start guide
*/
/*!
\externalpage https://doc.qt.io/QtForMCUs/qtul-renesas-rh850-qsg.html
\title Renesas RH850-D1M1A quick start guide
*/

View File

@@ -3,15 +3,15 @@
/*! /*!
\externalpage https://doc.qt.io/QtForMCUs/index.html \externalpage https://doc.qt.io/QtForMCUs/index.html
\title Qt for MCUs \title \QMCU
*/ */
/*! /*!
\externalpage https://doc.qt.io/QtForMCUs/qtul-qmltypes.html \externalpage https://doc.qt.io/QtForMCUs/qtul-qmltypes.html
\title Qt for MCUs - All QML Types \title \QMCU - All QML Types
*/ */
/*! /*!
\externalpage https://doc.qt.io/QtForMCUs/qtul-supported-platforms.html \externalpage https://doc.qt.io/QtForMCUs/qtul-supported-platforms.html
\title Qt for MCUs - Supported Target Platforms \title \QMCU - Supported Target Platforms
*/ */
/*! /*!
\externalpage https://doc.qt.io/QtForMCUs/qtul-getting-started-renesas.html \externalpage https://doc.qt.io/QtForMCUs/qtul-getting-started-renesas.html

View File

@@ -11,7 +11,7 @@
\page creator-editor-external.html \page creator-editor-external.html
\if defined(qtdesignstudio) \if defined(qtdesignstudio)
\previouspage quick-converting-ui-projects.html \previouspage quick-converting-ui-projects.html
\nextpage studio-help.html \nextpage studio-on-mcus.html
\else \else
\previouspage creator-keyboard-shortcuts.html \previouspage creator-keyboard-shortcuts.html
\nextpage creator-task-lists.html \nextpage creator-task-lists.html

View File

@@ -90,7 +90,7 @@
\list \list
\li \l{Connecting MCUs} \li \l{Connecting MCUs}
\li \l{Running Applications on MCUs} \li \l{Running Applications on MCUs}
\li \l{https://doc.qt.io/QtForMCUs/index.html}{Qt for MCUs} \li \l{https://doc.qt.io/QtForMCUs/index.html}{\QMCU}
\endlist \endlist
\section1 QNX \section1 QNX

View File

@@ -8,7 +8,7 @@
\title Connecting MCUs \title Connecting MCUs
Qt for MCU enables you to use subsets of QML and Qt Quick Controls \QMCU enables you to use subsets of QML and Qt Quick Controls
to create user interfaces for devices that are powered by microcontroller to create user interfaces for devices that are powered by microcontroller
units (MCU). It includes a new graphics rendering engine that has a low units (MCU). It includes a new graphics rendering engine that has a low
memory footprint and is optimized for MCUs and other resource-constrained memory footprint and is optimized for MCUs and other resource-constrained
@@ -21,18 +21,18 @@
debug them using \QC. debug them using \QC.
The toolchains are available for cross-compilation on Microsoft Windows, The toolchains are available for cross-compilation on Microsoft Windows,
Linux, and macOS. However, the Qt for MCU SDK is currently only available Linux, and macOS. However, the Qt for \QMCU SDK is currently only available
for Windows and Linux. for Windows and Linux.
For a list of Qt for MCU reference implementations, see the For a list of \QMCU reference implementations, see the
\l{Qt for MCUs - Supported Target Platforms}{Qt for MCUs} documentation. \l{\QMCU - Supported Target Platforms}{\QMCU} documentation.
\section1 Requirements \section1 Requirements
To use \QC to develop QML applications for MCUs, you need the following: To use \QC to develop QML applications for MCUs, you need the following:
\list \list
\li Qt for MCU SDK (only available for Windows and Linux) \li \QMCU SDK (only available for Windows and Linux)
\li \l{https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm} \li \l{https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm}
{GNU ARM Embedded Toolchain} {GNU ARM Embedded Toolchain}
\endlist \endlist
@@ -55,7 +55,7 @@
To be able to develop applications for MCUs, you need the MCU plugin. To be able to develop applications for MCUs, you need the MCU plugin.
This plugin is enabled automatically by the Qt Installer when you This plugin is enabled automatically by the Qt Installer when you
install Qt for MCUs. install \QMCU.
\section2 Specifying MCU Settings \section2 Specifying MCU Settings
@@ -66,9 +66,9 @@
\image qtcreator-mcu-options.png "MCU preferences" \image qtcreator-mcu-options.png "MCU preferences"
\list 1 \list 1
\li In the \uicontrol {Qt for MCUs SDK} field, specify the path \li In the \uicontrol {\QMCU SDK} field, specify the path
to the directory where you installed Qt for MCUs SDK. to the directory where you installed \QMCU SDK.
\li In the \uicontrol {Targets supported by the Qt for MCUs SDK} \li In the \uicontrol {Targets supported by the \QMCU SDK}
field, select your MCU board. field, select your MCU board.
\li In the \uicontrol Requirements section, ensure that the \li In the \uicontrol Requirements section, ensure that the
platform-specific requirements are met. This varies depending platform-specific requirements are met. This varies depending
@@ -105,7 +105,7 @@
\li Select \uicontrol Apply to save the settings. \li Select \uicontrol Apply to save the settings.
\endlist \endlist
\note When updating to other versions of the Qt for MCUs SDK, \QC will \note When updating to other versions of the \QMCU SDK, \QC will
ask you if you want to replace the existing kits, or create new ones ask you if you want to replace the existing kits, or create new ones
alongside. This can also be done manually, for each individual target, alongside. This can also be done manually, for each individual target,
via \uicontrol {Update Kit} and \uicontrol {Create Kit}, respectively. via \uicontrol {Update Kit} and \uicontrol {Create Kit}, respectively.
@@ -145,7 +145,7 @@
\uicontrol Preferences > \uicontrol Kits. \uicontrol Preferences > \uicontrol Kits.
However, for adding new kits you should use the \uicontrol {Create Kit} However, for adding new kits you should use the \uicontrol {Create Kit}
button in the {Qt for MCUs} settings tab. This method adds the paths to button in the {\QMCU} settings tab. This method adds the paths to
the kit's toolkits and SDKs, and keeps them synchronized when selecting the kit's toolkits and SDKs, and keeps them synchronized when selecting
\uicontrol Apply or \uicontrol OK. \uicontrol Apply or \uicontrol OK.
@@ -156,14 +156,14 @@
You can use a wizard to set up a project for developing an application that You can use a wizard to set up a project for developing an application that
you can run on MCUs. The project uses a subset of QML and Qt Quick Controls you can run on MCUs. The project uses a subset of QML and Qt Quick Controls
that are supported by Qt for MCU. For more information about developing that are supported by \QMCU. For more information about developing
applications for MCUs, see the Qt for MCU documentation. applications for MCUs, see the \QMCU documentation.
To create an application and run it on a MCU board: To create an application and run it on a MCU board:
\list 1 \list 1
\li Select \uicontrol File > \uicontrol {New Project} > \li Select \uicontrol File > \uicontrol {New Project} >
\uicontrol {Application (Qt for MCU)} > \uicontrol {Application (\QMCU)} >
\uicontrol {MCU Support Application} > \uicontrol Choose. \uicontrol {MCU Support Application} > \uicontrol Choose.
\li Follow the instructions of the wizard to create the project. \li Follow the instructions of the wizard to create the project.
\li Select \uicontrol Projects > \uicontrol {Build & Run}, and then \li Select \uicontrol Projects > \uicontrol {Build & Run}, and then
@@ -173,17 +173,17 @@
Usually, you can use the default settings. Usually, you can use the default settings.
\endlist \endlist
\section1 Supported Qt for MCUs SDKs \section1 Supported \QMCU SDKs
\note The Qt for MCUs SDK 2.3 requires \QC 9.0.0, or later. \note The \QMCU SDK 2.3 requires \QC 9.0.0, or later.
The following table lists the \QC versions you can use to develop The following table lists the \QC versions you can use to develop
applications with particular Qt for MCUs SDK versions. applications with particular \QMCU SDK versions.
\table \table
\header \header
\li \QC version \li \QC version
\li Qt for MCUs SDK version \li \QMCU SDK version
\row \row
\li 9.0.0 or later \li 9.0.0 or later
\li 2.0 or later \li 2.0 or later

View File

@@ -47,7 +47,7 @@
\section1 macOS \section1 macOS
\macos 10.14 or later is supported with the Xcode tools for your \macos \macos 10.15 or later is supported with the Xcode tools for your \macos
version available in the Mac App Store. version available in the Mac App Store.
\section1 Windows \section1 Windows

View File

@@ -33,15 +33,15 @@
In addition, all screens contain a small clock component that displays In addition, all screens contain a small clock component that displays
the current time. We implement a \e TimeDate JavaScript object to the current time. We implement a \e TimeDate JavaScript object to
support this feature on \l{https://doc.qt.io/QtForMCUs/qtul-qmltypes.html} support this feature on \l{https://doc.qt.io/QtForMCUs/qtul-qmltypes.html}
{Qt for MCUs}, which does not support the \l Date component at the time of {\QMCU}, which does not support the \l Date component at the time of
writing. writing.
\section1 Creating an Application for MCUs \section1 Creating an Application for MCUs
We use the \uicontrol {Qt for MCUs Application} project template to create We use the \uicontrol {\QMCU Application} project template to create
an application for MCUs, which support only a subset of the preset an application for MCUs, which support only a subset of the preset
\l{glossary-component}{components}. We select \uicontrol File > \l{glossary-component}{components}. We select \uicontrol File >
\uicontrol {New Project} > \uicontrol {Qt for MCUs Application} > \uicontrol {New Project} > \uicontrol {\QMCU Application} >
\uicontrol Choose, and follow the instructions of the wizard to create our \uicontrol Choose, and follow the instructions of the wizard to create our
project. project.
@@ -54,16 +54,16 @@
that we can use to configure and build our example application for running that we can use to configure and build our example application for running
it on MCUs. it on MCUs.
\note This example has been tested to run using Qt for MCUs versions since \note This example has been tested to run using \QMCU versions since
1.6. You cannot run it on older versions. Also, at the time of writing, 1.6. You cannot run it on older versions. Also, at the time of writing,
Qt for MCUs only supports Qt 5. \QMCU only supports Qt 5.
\section1 Creating Screens \section1 Creating Screens
For this example, we used an external tool to design the UI and then For this example, we used an external tool to design the UI and then
exported and imported our design into \QDS as assets and components exported and imported our design into \QDS as assets and components
using \QB, as instructed in \l{Exporting from Design Tools}. While using \QB, as instructed in \l{Exporting from Design Tools}. While
exporting, we only picked components supported by Qt for MCUs to use exporting, we only picked components supported by \QMCU to use
for our components. For the button components, we mostly use the for our components. For the button components, we mostly use the
\l {basic-image}{Image}, \l Text, and \l {Mouse Area} components. For the \l {basic-image}{Image}, \l Text, and \l {Mouse Area} components. For the
screen background, we use the \l {basic-rectangle}{Rectangle} component. screen background, we use the \l {basic-rectangle}{Rectangle} component.
@@ -171,7 +171,7 @@
\image washingmachineui-states.png "States view" \image washingmachineui-states.png "States view"
In Qt for MCU, states work differently from Qt Quick, and therefore we In \QMCU, states work differently from Qt Quick, and therefore we
sometimes use \c when conditions to determine the state to apply, and sometimes use \c when conditions to determine the state to apply, and
sometimes switch states using signals and JavaScript expressions. sometimes switch states using signals and JavaScript expressions.
@@ -217,7 +217,7 @@
\section1 Showing the Current Time \section1 Showing the Current Time
The \l Date component is not supported on Qt for MCUs, and the The \l Date component is not supported on \QMCU, and the
\l{https://doc.qt.io/QtForMCUs/qtul-javascript-environment.html} \l{https://doc.qt.io/QtForMCUs/qtul-javascript-environment.html}
{implementation of the JavaScript \c Date()} object returns elapsed {implementation of the JavaScript \c Date()} object returns elapsed
time since when the application was started instead of the current time since when the application was started instead of the current

Binary file not shown.

After

Width:  |  Height:  |  Size: 6.1 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 10 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.6 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 25 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 24 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 7.3 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

View File

@@ -3,11 +3,8 @@
/*! /*!
\page quick-animations.html \page quick-animations.html
\if defined(qtdesignstudio)
\previouspage quick-logic-helpers.html \previouspage quick-logic-helpers.html
\else
\previouspage quick-data-models.html
\endif
\nextpage studio-3d-view.html \nextpage studio-3d-view.html
\title Animations \title Animations
@@ -72,10 +69,8 @@
\image qtquick-number-animation.gif "Number animation" \image qtquick-number-animation.gif "Number animation"
\if defined(qtdesignstudio)
For an example of using property animation to animate the scale and opacity For an example of using property animation to animate the scale and opacity
of components, see the \l{Coffee Machine} example. of components, see the \l{Coffee Machine} example.
\endif
\section2 Setting Non-Animated Properties \section2 Setting Non-Animated Properties

View File

@@ -19,11 +19,7 @@
\list 1 \list 1
\li Select \uicontrol File > \uicontrol {New File} > \li Select \uicontrol File > \uicontrol {New File} >
\if defined(qtcreator)
\uicontrol Qt > \uicontrol {Qt Quick UI File} >
\else
\uicontrol {Qt Quick Files} > \uicontrol {Qt Quick UI File} > \uicontrol {Qt Quick Files} > \uicontrol {Qt Quick UI File} >
\endif
\uicontrol Choose to create a \l{UI Files}{UI file} called \uicontrol Choose to create a \l{UI Files}{UI file} called
Button.ui.qml (for example). Button.ui.qml (for example).
@@ -105,11 +101,7 @@
/*! /*!
\previouspage quick-buttons.html \previouspage quick-buttons.html
\page quick-scalable-image.html \page quick-scalable-image.html
\if defined(qtdesignstudio)
\nextpage qtquick-properties.html \nextpage qtquick-properties.html
\else
\nextpage studio-optimized-3d-scenes.html
\endif
\title Creating Scalable Buttons and Borders \title Creating Scalable Buttons and Borders
@@ -136,11 +128,8 @@
To create a button component, select \uicontrol File > To create a button component, select \uicontrol File >
\uicontrol {New File} > \uicontrol {New File} >
\if defined(qtcreator)
\uicontrol Qt > \uicontrol {Qt Quick UI File} >
\else
\uicontrol {Qt Quick Files} > \uicontrol {Qt Quick UI File} > \uicontrol {Qt Quick Files} > \uicontrol {Qt Quick UI File} >
\endif
\uicontrol Choose to create a \l{UI Files}{UI file} called Button.ui.qml \uicontrol Choose to create a \l{UI Files}{UI file} called Button.ui.qml
(for example). (for example).

View File

@@ -22,11 +22,9 @@
\row \row
\li Anchors \li Anchors
\li \l{Setting Anchors and Margins} \li \l{Setting Anchors and Margins}
\if defined(qtdesignstudio)
\row \row
\li Group \li Group
\li \l{Organizing Components} \li \l{Organizing Components}
\endif
\row \row
\li Position \li Position
\li \l{Using Positioners} \li \l{Using Positioners}
@@ -39,11 +37,9 @@
\row \row
\li Timeline \li Timeline
\li \l{Creating a Timeline} \li \l{Creating a Timeline}
\if defined(qtdesignstudio)
\row \row
\li Event List \li Event List
\li \l{Simulating Events} \li \l{Simulating Events}
\endif
\row \row
\li Edit Color \li Edit Color
\li \l{Editing Properties Inline} \li \l{Editing Properties Inline}

View File

@@ -26,11 +26,7 @@
\list 1 \list 1
\li Select \uicontrol File > \uicontrol {New File} > \li Select \uicontrol File > \uicontrol {New File} >
\if defined(qtcreator)
\uicontrol Qt > \uicontrol {Qt Quick UI File} >
\else
\uicontrol {Qt Quick Files} > \uicontrol {Qt Quick UI File} > \uicontrol {Qt Quick Files} > \uicontrol {Qt Quick UI File} >
\endif
\uicontrol Choose to create a new \c .ui.qml file. \uicontrol Choose to create a new \c .ui.qml file.
\note Components are listed in \uicontrol Components > \note Components are listed in \uicontrol Components >
\uicontrol {My Components} only if the filename begins with a \uicontrol {My Components} only if the filename begins with a
@@ -80,9 +76,7 @@
that screen. For example, \e myButton_myMenu_home, \e myButton_myMenu_profile, that screen. For example, \e myButton_myMenu_home, \e myButton_myMenu_profile,
and \e myButton_myMenu_settings and \e myButton_myMenu_settings
\if defined(qtdesignstudio)
\include qtdesignstudio-components.qdocinc creating studio components \include qtdesignstudio-components.qdocinc creating studio components
\endif
\section1 Turning Component Instances into Custom Components \section1 Turning Component Instances into Custom Components
@@ -107,11 +101,7 @@
additional ways of opening base components, see \l{Moving Within Components}. additional ways of opening base components, see \l{Moving Within Components}.
For an example of creating a reusable custom component, see For an example of creating a reusable custom component, see
\if defined(qtcreator)
\l{Creating a Mobile Application}.
\else
\l{Progress Bar}. \l{Progress Bar}.
\endif
Custom components are listed in \uicontrol Components Custom components are listed in \uicontrol Components
> \uicontrol {My Components}, and you can use instances of them to build > \uicontrol {My Components}, and you can use instances of them to build

View File

@@ -3,11 +3,7 @@
/*! /*!
\page quick-components.html \page quick-components.html
\if defined(qtdesignstudio)
\previouspage studio-flow-external-events.html \previouspage studio-flow-external-events.html
\else
\previouspage creator-using-qt-quick-designer.html
\endif
\nextpage quick-preset-components.html \nextpage quick-preset-components.html
\title Using Components \title Using Components

View File

@@ -94,12 +94,10 @@
\image qtquickcontrols2-button.gif "Qt Quick Controls - Button" \image qtquickcontrols2-button.gif "Qt Quick Controls - Button"
\if defined(qtdesignstudio)
Alternatively, you can use a wizard to create a \l{Creating Custom Controls} Alternatively, you can use a wizard to create a \l{Creating Custom Controls}
{custom button}: {custom button}:
\image studio-custom-button.gif "Custom button" \image studio-custom-button.gif "Custom button"
\endif
A button can be pushed or clicked by users. Typically, buttons A button can be pushed or clicked by users. Typically, buttons
are used to perform an action or to answer a question. For example, \e OK, are used to perform an action or to answer a question. For example, \e OK,
@@ -133,14 +131,12 @@
\image qtquickcontrols2-button-flat.gif "Flat button" \image qtquickcontrols2-button-flat.gif "Flat button"
\if defined(qtdesignstudio)
\section3 Icon Buttons \section3 Icon Buttons
To create a button that contains an icon, use the wizard template to To create a button that contains an icon, use the wizard template to
\l{Creating Custom Controls}{create a custom button} and drag-and-drop \l{Creating Custom Controls}{create a custom button} and drag-and-drop
the icon to the button background component. For an example of using the the icon to the button background component. For an example of using the
wizard template, see \l{Creating a Push Button}. wizard template, see \l{Creating a Push Button}.
\endif
\section2 Delay Button \section2 Delay Button
@@ -162,12 +158,10 @@
\image qtquickcontrols2-checkbox.gif "Check boxes" \image qtquickcontrols2-checkbox.gif "Check boxes"
\if defined(qtdesignstudio)
Alternatively, you can use a wizard to create \l{Creating Custom Controls} Alternatively, you can use a wizard to create \l{Creating Custom Controls}
{custom check boxes}: {custom check boxes}:
\image studio-custom-check-box.gif "Custom check boxes" \image studio-custom-check-box.gif "Custom check boxes"
\endif
A check box presents an option button that can be toggled on A check box presents an option button that can be toggled on
(checked) or off (unchecked). Check boxes are typically used to select (checked) or off (unchecked). Check boxes are typically used to select
@@ -255,12 +249,10 @@
\image qtquickcontrols2-switch.gif "Switch" \image qtquickcontrols2-switch.gif "Switch"
\if defined(qtdesignstudio)
Alternatively, you can use a wizard to create a \l{Creating Custom Controls} Alternatively, you can use a wizard to create a \l{Creating Custom Controls}
{custom switch}: {custom switch}:
\image studio-custom-switch.gif "Custom switch" \image studio-custom-switch.gif "Custom switch"
\endif
A switch is an option button that can be dragged or toggled on A switch is an option button that can be dragged or toggled on
(checked) or off (unchecked). Switches are typically used to select between (checked) or off (unchecked). Switches are typically used to select between
@@ -441,12 +433,10 @@
\image qtquickcontrols2-slider.gif "Slider" \image qtquickcontrols2-slider.gif "Slider"
\if defined(qtdesignstudio)
Alternatively, you can use a wizard to create a \l{Creating Custom Controls} Alternatively, you can use a wizard to create a \l{Creating Custom Controls}
{custom slider}: {custom slider}:
\image studio-custom-slider.gif "Custom slider" \image studio-custom-slider.gif "Custom slider"
\endif
A slider is used to select a value by sliding a handle along a A slider is used to select a value by sliding a handle along a
track, whereas \uicontrol {Range Slider} is used to select a range track, whereas \uicontrol {Range Slider} is used to select a range
@@ -463,12 +453,10 @@
\image qtquickcontrols2-dial-no-wrap.gif "Dial" \image qtquickcontrols2-dial-no-wrap.gif "Dial"
\if defined(qtdesignstudio)
Alternatively, you can use a wizard to create a \l{Creating Custom Controls} Alternatively, you can use a wizard to create a \l{Creating Custom Controls}
{custom dial}: {custom dial}:
\image studio-custom-dial.gif "Custom dial" \image studio-custom-dial.gif "Custom dial"
\endif
In the \uicontrol From and \uicontrol To fields, set the range of the In the \uicontrol From and \uicontrol To fields, set the range of the
slider or dial. Set the value of the slide handle or dial in the slider or dial. Set the value of the slide handle or dial in the
@@ -514,12 +502,10 @@
\image qtquickcontrols2-spinbox.png "Spin Box" \image qtquickcontrols2-spinbox.png "Spin Box"
\if defined(qtdesignstudio)
Alternatively, you can use a wizard to create a \l{Creating Custom Controls} Alternatively, you can use a wizard to create a \l{Creating Custom Controls}
{custom spin box}: {custom spin box}:
\image studio-custom-spinbox.gif "Custom spin box" \image studio-custom-spinbox.gif "Custom spin box"
\endif
A spin box enables users to choose an integer value by clicking A spin box enables users to choose an integer value by clicking
the up or down indicator buttons, or by pressing up or down on the keyboard. the up or down indicator buttons, or by pressing up or down on the keyboard.
@@ -661,31 +647,6 @@
For more information about how to customize a particular control, see For more information about how to customize a particular control, see
\l{Customization Reference}. \l{Customization Reference}.
\if defined(qtcreator)
\section1 History of Qt Quick Controls
In Qt 4, ready-made Qt Quick 1 Components were provided for creating
UIs with a native look and feel for a particular target platform.
In Qt 5.1, Qt Quick Controls, Dialogs, and Layouts were added for
creating classic desktop-style user interfaces using Qt Quick 2.1. The
Qt Quick Controls Styles could be used to customize Qt Quick Controls.
Since Qt 5.7, \l {Qt Quick Controls 2} replace Qt Quick Controls 1 and
Qt Labs Controls. They provide lightweight components for creating performant
user interfaces for \l{glossary-device}{devices}.
Qt Quick Controls 2 work in conjunction with Qt Quick and Qt Quick Layouts.
The \QC project wizards create Qt Quick applications that use Qt Quick
2 types or Qt Quick Controls 2 types.
Even if you use Qt Quick Controls 2, you can still write cross-platform
applications, by using different sets of QML files for each platform.
Some ready-made controls, such as a gauge, dial, status indicator, and
tumbler, are provided by the \l {Qt Quick Extras} module.
\endif
\section1 Summary of UI Controls \section1 Summary of UI Controls
The following table lists preset UI controls with links to their developer The following table lists preset UI controls with links to their developer

View File

@@ -4,11 +4,7 @@
/*! /*!
\page quick-data-models.html \page quick-data-models.html
\previouspage quick-controls.html \previouspage quick-controls.html
\if defined(qtdesignstudio)
\nextpage quick-2d-effects.html \nextpage quick-2d-effects.html
\else
\nextpage quick-animations.html
\endif
\title Lists and Other Data Models \title Lists and Other Data Models
@@ -167,9 +163,7 @@
> \uicontrol {Qt Quick Controls}. > \uicontrol {Qt Quick Controls}.
\include qtquick-pathview-editor.qdocinc pathview \include qtquick-pathview-editor.qdocinc pathview
\if defined(qtdesignstudio)
\include qtquick-pathview-editor.qdocinc svgpath \include qtquick-pathview-editor.qdocinc svgpath
\endif
\section1 Summary of Model Components \section1 Summary of Model Components
@@ -223,14 +217,12 @@
\li Qt Quick Controls \li Qt Quick Controls
\li \li
\li A stack-based navigation model. \li A stack-based navigation model.
\if defined(qtdesignstudio)
\row \row
\li \inlineimage icons/item-svg-16px.png \li \inlineimage icons/item-svg-16px.png
\li \l{SVG Path Item} \li \l{SVG Path Item}
\li Qt Quick Studio Components \li Qt Quick Studio Components
\li \li
\li An SVG path data string that is used to draw a path as a line. \li An SVG path data string that is used to draw a path as a line.
\endif
\row \row
\li \inlineimage icons/itemdelegate-icon16.png \li \inlineimage icons/itemdelegate-icon16.png
\li \l{SwipeDelegate}{Swipe Delegate} \li \l{SwipeDelegate}{Swipe Delegate}

View File

@@ -187,7 +187,6 @@
\youtube DVWd_xMMgvg \youtube DVWd_xMMgvg
\if defined(qtdesignstudio)
\section1 Iso Icon \section1 Iso Icon
\note The Iso Icon component is not available if you selected \note The Iso Icon component is not available if you selected
@@ -207,7 +206,6 @@
set the value of \uicontrol {Icon color}. set the value of \uicontrol {Icon color}.
\image iso-icon-browser.png \image iso-icon-browser.png
\endif
\section1 Summary of Images \section1 Summary of Images
@@ -243,7 +241,6 @@
\li \inlineimage ok.png \li \inlineimage ok.png
\li An image in one of the supported formats, including bitmap formats \li An image in one of the supported formats, including bitmap formats
such as PNG and JPEG and vector graphics formats such as SVG. such as PNG and JPEG and vector graphics formats such as SVG.
\if defined(qtdesignstudio)
\row \row
\li \inlineimage icons/iso-icons-16px.png \li \inlineimage icons/iso-icons-16px.png
\li \l{Iso Icon} \li \l{Iso Icon}
@@ -253,6 +250,5 @@
component. You can select the icon to use and its color. component. You can select the icon to use and its color.
\note This component is not supported on Qt 6. \note This component is not supported on Qt 6.
\endif
\endtable \endtable
*/ */

View File

@@ -6,9 +6,9 @@
\section1 Creating UIs for MCUs \section1 Creating UIs for MCUs
\l{Qt for MCUs} enables you to use subsets of components to create UIs for \l{\QMCU} enables you to use subsets of components to create UIs for
devices that are powered by microcontroller units (MCU). The subset of devices that are powered by microcontroller units (MCU). The subset of
supported components depends on the Qt for MCUs version that you use for supported components depends on the \QMCU version that you use for
development. In this manual, we indicate which components are supported at development. In this manual, we indicate which components are supported at
the time of writing. the time of writing.
@@ -21,7 +21,7 @@
\image qmldesigner-mcu-support.png "Components and Text properties supported for MCUs" \image qmldesigner-mcu-support.png "Components and Text properties supported for MCUs"
For more information about the supported components and their properties, For more information about the supported components and their properties,
see \l{Qt for MCUs - All QML Types}. see \l{\QMCU - All QML Types}.
//! [mcu qtquick components] //! [mcu qtquick components]
*/ */

View File

@@ -49,10 +49,8 @@
In the \uicontrol {Path View Highlight} section, you can specify properties In the \uicontrol {Path View Highlight} section, you can specify properties
for \l{View Highlight}{highlighting} path objects. for \l{View Highlight}{highlighting} path objects.
\if defined(qtdesignstudio)
\note You can also use the \l {SVG Path Item} Studio Component to specify an \note You can also use the \l {SVG Path Item} Studio Component to specify an
SVG path data string that draws a path. SVG path data string that draws a path.
\endif
//! [pathview] //! [pathview]

View File

@@ -4,11 +4,7 @@
/*! /*!
\page qtquick-positioning.html \page qtquick-positioning.html
\previouspage qtquick-properties.html \previouspage qtquick-properties.html
\if defined(qtdesignstudio)
\nextpage qtquick-annotations.html \nextpage qtquick-annotations.html
\else
\nextpage qtquick-fonts.html
\endif
\title Scalable Layouts \title Scalable Layouts
@@ -386,13 +382,9 @@
\section2 Using Layouts \section2 Using Layouts
\if defined(qtcreator)
Since Qt 5.1, you can use QML types in the \l{qtquicklayouts-index.html}
{Qt Quick Layouts} module to arrange components in UIs.
\else
You can use the components available in \uicontrol Components You can use the components available in \uicontrol Components
> \uicontrol {Qt Quick Layouts} to arrange components in UIs. > \uicontrol {Qt Quick Layouts} to arrange components in UIs.
\endif
Unlike positioners, layouts manage both the positions and sizes of their Unlike positioners, layouts manage both the positions and sizes of their
child components, and are therefore well suited for dynamic and resizable child components, and are therefore well suited for dynamic and resizable
UIs. However, this means that you should not specify fixed positions and UIs. However, this means that you should not specify fixed positions and
@@ -502,10 +494,8 @@
You can use the \uicontrol Frame and \uicontrol {Group Box} controls to You can use the \uicontrol Frame and \uicontrol {Group Box} controls to
draw frames around groups of controls. draw frames around groups of controls.
\if defined(qtdesignstudio)
If you don't want a frame, use the \uicontrol Group component instead.
\endif
If you don't want a frame, use the \uicontrol Group component instead.
The following table lists the UI controls that you can use to organize The following table lists the UI controls that you can use to organize
components in UIs (since Qt 5.7). The \e Location column indicates the components in UIs (since Qt 5.7). The \e Location column indicates the
@@ -522,13 +512,11 @@
\li \l [QtQuickControls]{Frame} \li \l [QtQuickControls]{Frame}
\li Qt Quick Controls \li Qt Quick Controls
\li A visual frame around a group of controls. \li A visual frame around a group of controls.
\if defined(qtdesignstudio)
\row \row
\li \inlineimage icons/group-16px.png \li \inlineimage icons/group-16px.png
\li Group \li Group
\li Qt Quick Studio Components \li Qt Quick Studio Components
\li Enables handling the selected components as a group. \li Enables handling the selected components as a group.
\endif
\row \row
\li \inlineimage icons/groupbox-icon16.png \li \inlineimage icons/groupbox-icon16.png
\li \l [QtQuickControls]{GroupBox}{Group Box} \li \l [QtQuickControls]{GroupBox}{Group Box}

View File

@@ -30,10 +30,8 @@
\li \l {User Interaction Methods} \li \l {User Interaction Methods}
\li \l {UI Controls} \li \l {UI Controls}
\li \l {Lists and Other Data Models} \li \l {Lists and Other Data Models}
\if defined(qtdesignstudio)
\li \l {2D Effects} \li \l {2D Effects}
\li \l {Logic Helpers} \li \l {Logic Helpers}
\endif
\li \l Animations \li \l Animations
\endlist \endlist

View File

@@ -8,7 +8,6 @@
\title Shapes \title Shapes
\if defined(qtdesignstudio)
\QDS is a UI design tool rather than a generic drawing tool, and therefore, \QDS is a UI design tool rather than a generic drawing tool, and therefore,
the focus is on providing ready-made UI controls that you can modify the focus is on providing ready-made UI controls that you can modify
according to your needs. The values of some properties of the controls are according to your needs. The values of some properties of the controls are
@@ -22,12 +21,6 @@
\image studio-shapes.png "Shapes in the 2D view" \image studio-shapes.png "Shapes in the 2D view"
\else
You can use the Rectangle component to draw basic shapes in
the \l {2D} view.
\image qml-shapes.png "Shapes in the 2D view"
\endif
Most visual components in \uicontrol Components are based on the \l [QtQuick] Most visual components in \uicontrol Components are based on the \l [QtQuick]
{Item} component. Even though it has no visual appearance itself (similarly {Item} component. Even though it has no visual appearance itself (similarly
to a mouse area, for example), it defines all the properties that are to a mouse area, for example), it defines all the properties that are
@@ -48,9 +41,7 @@
The basic \l [QtQuick] {Rectangle} component is used for drawing shapes The basic \l [QtQuick] {Rectangle} component is used for drawing shapes
with four sides and corners, as well as a solid border. with four sides and corners, as well as a solid border.
\if defined(qtdesignstudio)
\image qml-shapes-rectangle.png "A rectangle and its properties" \image qml-shapes-rectangle.png "A rectangle and its properties"
\endif
Rectangles can be filled either with a solid fill color or a linear Rectangles can be filled either with a solid fill color or a linear
gradient that you set in the \uicontrol {Fill color} field. You can gradient that you set in the \uicontrol {Fill color} field. You can
@@ -74,7 +65,6 @@
check box in the \uicontrol Advanced section to improve the appearance of check box in the \uicontrol Advanced section to improve the appearance of
your shape. your shape.
\if defined(qtdesignstudio)
\target studio-rectangle \target studio-rectangle
\section2 Studio Rectangle \section2 Studio Rectangle
@@ -279,5 +269,4 @@
\li A triangle with different dimensions and shapes that is \li A triangle with different dimensions and shapes that is
enclosed in an invisible rectangle. enclosed in an invisible rectangle.
\endtable \endtable
\endif
*/ */

View File

@@ -79,12 +79,6 @@
For more information, see For more information, see
\l {Internationalization and Localization with Qt Quick}. \l {Internationalization and Localization with Qt Quick}.
\if defined(qtcreator)
When you \l{Creating Qt Quick Projects}{create a new project}, you can
automatically generate a translation source file (TS) for one language.
You can add other languages later by editing the project file.
\endif
\section1 Character Properties \section1 Character Properties
You can set font properties in the \uicontrol Character section You can set font properties in the \uicontrol Character section

View File

@@ -59,11 +59,6 @@
\li \c released() \li \c released()
\endlist \endlist
\if defined(qtcreator)
A more modern way of handling events from all pointing devices, including
mouse and touchscreen, is via \l {Qt Quick Input Handlers}.
\endif
\section2 Mouse Area Properties \section2 Mouse Area Properties
A \uicontrol {Mouse Area} is an invisible component that is typically used A \uicontrol {Mouse Area} is an invisible component that is typically used

View File

@@ -0,0 +1,29 @@
// Copyright (C) 2023 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
/*!
\previouspage studio-on-mcus.html
\page studio-compatibility-with-mcu-sdks.html
\nextpage studio-help.html
\title \QDS Version Compatibility with \QMCU SDKs
The following table lists the \QDS versions you can use to develop
applications with particular \QMCU SDK versions.
\table
\header
\li \QDS Version
\li \QMCU SDK Version
\row
\li 4.0 or later
\li 2.4 or later
\row
\li 3.8 up to 3.9
\li 2.3
\row
\li 3.4 up to 3.7
\li 2.2 (LTS)
\endtable
*/

View File

@@ -0,0 +1,92 @@
// Copyright (C) 2023 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
/*!
\previouspage creator-editor-external.html
\page studio-on-mcus.html
\nextpage studio-compatibility-with-mcu-sdks.html
\title \QDS on MCUs
\QMCU is a comprehensive framework that supports various hardware ecosystems
and platforms. One of the most important libraries provided by the \QMCU
framework is \QUL (QUL), a lightweight implementation of the Qt Quick
framework. \QUL provides a QML API and an efficient graphics rendering engine
that has a low memory footprint and is optimized for MCUs and other
resource-constrained devices.
In addition to a lightweight graphics framework, \QMCU offers a toolkit that
enables you to design, develop, and deploy graphical user interfaces (GUI)
on microcontrollers (MCU). Also, it lets you run the applications either
on BareMetal or a real-time operating system (RTOS).
For more information on \QMCU, see \l {\QMCU documentation}.
\section1 Designing application UIs for MCU devices with \QDS
As a technical artist or a designer you can use specialized UI design tools,
such as Adobe Photoshop, Sketch, Figma, Blender, or Maya to create the
original UI design files for your MCU application. After the initial design
work, export your design from the design tools, and import your 2D and 3D UI
design assets into \QDS, which can convert them into code for developers.
For more information on managing the original assets created with
specialized UI design tools, see \l {Asset Creation with Other Tools}.
Once your UI design assets are in \QDS, use it to \l {Wireframing} {wireframe}
your MCU application, to visualize its structure. To modify the look and feel
of your UI further, utilize the preset UI components available in \QDS.
For an example on how to create a UI that runs both on the desktop and
on MCUs, see \l {Washing Machine UI}. For step-by-step instructions on how
to use \QDS to design a UI for a specific MCU target device, see:
\list
\li \l {Designing a UI for Infineon Traveo II}
\li \l {Designing a UI for NXP i.MX RT1170}
\li \l {Designing a UI for Renesas RA6M3G}
\li \l {Designing a UI for Renesas RH850-D1M1A}
\endlist
\section1 Developing applications for MCU devices with \QDS
As a GUI/application developer, use \QDS to bring your designs to life. Add
further functionality to your applications and utilize the \l {Prototyping}
{prototyping} features of \QDS to simulate and validate interactions and
their dynamic behavior.
You can also test, preview, and fine-tune your designs to pixel-perfection
live on the desktop or on an actual MCU target device. For more information,
see \l {Validating with Target Hardware}.
\image qds-mcu-target-deployment.png
\QDS enables designers and developers to work together on common projects to
develop applications. Designers can use the views in the Design mode to modify
UI files (.ui.qml), whereas developers can use Qt Creator to work on the Qt
Quick (.qml) and other files that are needed to implement the application
logic and to prepare the application for production. For more information,
see \l {Implementing Applications}.
\section1 Connecting MCUs with Qt Creator
\l {Connecting MCUs} {Connect MCU boards} to a development host to
build applications for them using the GNU Arm Embedded GCC compiler, libraries,
and other GNU tools necessary for BareMetal software development on devices
based on the Arm Cortex-M processors. Deploy the applications on MCUs to run
and debug them using Qt Creator.
The toolchains are available for cross-compilation on Microsoft Windows,
Linux, and macOS. However, the \QMCU SDK is currently only available for
Windows and Linux.
For more information on how to manage the complete cycle of developing \QMCU
applications using Qt tools, see:
\list
\li \l {Infineon Traveo II quick start guide}
\li \l {NXP i.MX RT1170 quick start guide}
\li \l {Renesas EK-RA6M3G quick start guide}
\li \l {Renesas RH850-D1M1A quick start guide}
\endlist
*/

View File

@@ -87,12 +87,10 @@
\header \header
\li Technique \li Technique
\li Use Case \li Use Case
\if defined(qtdesignstudio)
\row \row
\li \l{Designing Application Flows}{Application flows} \li \l{Designing Application Flows}{Application flows}
\li An interactive prototype that can be clicked through to simulate \li An interactive prototype that can be clicked through to simulate
the user experience of the application. the user experience of the application.
\endif
\row \row
\li \l{Transitions}{Transitions between states} \li \l{Transitions}{Transitions between states}
\li Transitions between different states of the UI using a transition \li Transitions between different states of the UI using a transition
@@ -100,7 +98,6 @@
to the keyframes. to the keyframes.
\endtable \endtable
\if defined(qtdesignstudio)
\section2 Application Flows \section2 Application Flows
You can design an application in the form of a \e {schematic diagram} You can design an application in the form of a \e {schematic diagram}
@@ -111,7 +108,6 @@
as the base of the production version of the application. as the base of the production version of the application.
For more information, see \l{Designing Application Flows}. For more information, see \l{Designing Application Flows}.
\endif
\section2 Transitions Between States \section2 Transitions Between States

View File

@@ -3,13 +3,8 @@
/*! /*!
\page qtquick-annotations.html \page qtquick-annotations.html
\if defined(qtdesignstudio)
\previouspage qtquick-positioning.html \previouspage qtquick-positioning.html
\nextpage qtquick-prototyping.html \nextpage qtquick-prototyping.html
\else
\previouspage qtquick-fonts.html
\nextpage creator-quick-ui-forms.html
\endif
\title Annotating Designs \title Annotating Designs

View File

@@ -38,13 +38,11 @@
to define how their properties will animate when they change due to a to define how their properties will animate when they change due to a
state change. state change.
\if defined(qtdesignstudio)
The \l{Log In UI - States} example illustrates using states to create The \l{Log In UI - States} example illustrates using states to create
two UI screens and signals emitted by buttons to apply the states. two UI screens and signals emitted by buttons to apply the states.
The button components also switch states when they are pressed down. The button components also switch states when they are pressed down.
\image loginui3.gif "Clicking buttons to switch between screens" \image loginui3.gif "Clicking buttons to switch between screens"
\endif
Using property aliases and states to create the differences in your Using property aliases and states to create the differences in your
component instances enables you to reuse components instead of duplicating component instances enables you to reuse components instead of duplicating
@@ -57,7 +55,6 @@
instances of the controls into custom components and specify new properties instances of the controls into custom components and specify new properties
for them. for them.
\if defined(qtdesignstudio)
To have your UI perform certain operations, you might need to write To have your UI perform certain operations, you might need to write
JavaScript expressions for conditions or convert numbers to strings. JavaScript expressions for conditions or convert numbers to strings.
To make this easier, \QDS provides preset components called To make this easier, \QDS provides preset components called
@@ -74,7 +71,6 @@
to implement the UI logic. to implement the UI logic.
\image studio-logic-helper-combining-example.gif "Logic helper example application" \image studio-logic-helper-combining-example.gif "Logic helper example application"
\endif
The following table summarizes some typical use cases with links to more The following table summarizes some typical use cases with links to more
information. information.
@@ -107,11 +103,9 @@
\row \row
\li Using preset UI controls that have default properties and states \li Using preset UI controls that have default properties and states
\li \l{UI Controls} \li \l{UI Controls}
\if defined(qtdesignstudio)
\row \row
\li Creating conditional conditions \li Creating conditional conditions
\li \l{Logic Helpers} \li \l{Logic Helpers}
\endif
\row \row
\li Adding custom properties for a particular component type \li Adding custom properties for a particular component type
\li \l{Specifying Custom Properties} \li \l{Specifying Custom Properties}

View File

@@ -4,7 +4,7 @@
/*! /*!
\page creator-exporting-qml.html \page creator-exporting-qml.html
\previouspage studio-importing-3d.html \previouspage studio-importing-3d.html
\nextpage qt-effect-maker-files.html \nextpage qt-using-effect-maker-effects.html
\title Exporting Components \title Exporting Components

View File

@@ -3,13 +3,8 @@
/*! /*!
\page qtquick-fonts.html \page qtquick-fonts.html
\if defined(qtdesignstudio)
\previouspage studio-importing-2d.html \previouspage studio-importing-2d.html
\nextpage studio-importing-3d.html \nextpage studio-importing-3d.html
\else
\previouspage qtquick-positioning.html
\nextpage qtquick-annotations.html
\endif
\title Using Custom Fonts \title Using Custom Fonts

View File

@@ -3,7 +3,7 @@
/*! /*!
\page qtquick-motion-design.html \page qtquick-motion-design.html
\previouspage qt-effect-maker.html \previouspage qt-using-effect-maker-effects.html
\nextpage quick-animation-overview.html \nextpage quick-animation-overview.html
\title Motion Design \title Motion Design

View File

@@ -3,11 +3,7 @@
/*! /*!
\page qtquick-prototyping.html \page qtquick-prototyping.html
\if defined(qtdesignstudio)
\previouspage qtquick-annotations.html \previouspage qtquick-annotations.html
\else
\previouspage creator-quick-ui-forms.html
\endif
\nextpage qtquick-creating-ui-logic.html \nextpage qtquick-creating-ui-logic.html
\title Prototyping \title Prototyping
@@ -39,10 +35,8 @@
You can connect UIs to different forms of data from various You can connect UIs to different forms of data from various
sources, such as QML-based data models, JavaScript files, and sources, such as QML-based data models, JavaScript files, and
backend services. backend services.
\if defined(qtdesignstudio)
You can also connect your UI to Simulink to load live data from You can also connect your UI to Simulink to load live data from
a Simulink simulation. a Simulink simulation.
\endif
\li \l {Dynamic Behaviors} \li \l {Dynamic Behaviors}
@@ -50,7 +44,6 @@
communicate with each other. The connections can be triggered by communicate with each other. The connections can be triggered by
changes in component property values or in UI states. changes in component property values or in UI states.
\if defined(qtdesignstudio)
\li \l {Validating with Target Hardware} \li \l {Validating with Target Hardware}
You can use the live preview feature to preview a UI file or the You can use the live preview feature to preview a UI file or the
@@ -64,24 +57,5 @@
files that you can import to projects in \QDS, how to import them, files that you can import to projects in \QDS, how to import them,
and how to export them from \QDS back to the metadata format. and how to export them from \QDS back to the metadata format.
\else
\li \l {Exporting 3D Assets}
You can export assets from 3D graphics applications into several
widely-used formats, such as .blend, .dae, .fbx, .glb, .gltf, .obj,
.uia, or .uip.
\li \l {Importing 3D Assets}
You can import exported assets into \QDS. For a list of formats
supported by each \l{Qt Quick 3D} version, see the module
documentation.
\li \l {Exporting Components}
You can export components contained in \l{UI Files}{UI files}
(.ui.qml) to JSON metadata format and PNG assets.
\endif
\endlist \endlist
*/ */

View File

@@ -3,13 +3,8 @@
/*! /*!
\page quick-uis.html \page quick-uis.html
\if defined(qtdesignstudio)
\previouspage {Examples} \previouspage {Examples}
\nextpage studio-app-flows.html \nextpage studio-app-flows.html
\else
\previouspage qtquick-text-editor.html
\nextpage quick-components.html
\endif
\title Wireframing \title Wireframing
@@ -44,7 +39,6 @@
\list \list
\if defined(qtdesignstudio)
\li \l {Designing Application Flows} \li \l {Designing Application Flows}
You can design an application in the form of a \e {schematic diagram} You can design an application in the form of a \e {schematic diagram}
@@ -52,7 +46,6 @@
interconnections by means of symbols. This results in an interconnections by means of symbols. This results in an
interactive prototype that can be clicked through to simulate interactive prototype that can be clicked through to simulate
the user experience of the application. the user experience of the application.
\endif
\li \l {Using Components} \li \l {Using Components}
@@ -79,31 +72,10 @@
methods, such as anchors, layouts, positioners, and property methods, such as anchors, layouts, positioners, and property
bindings, for dynamic UIs. bindings, for dynamic UIs.
\if defined(qtcreator)
\li \l {Using Custom Fonts}
You can load custom fonts to \QC and use them in your designs.
\endif
\li \l {Annotating Designs} \li \l {Annotating Designs}
You can annotate your designs to provide reviewers or developers You can annotate your designs to provide reviewers or developers
with additional information about them. with additional information about them.
\if defined(qtcreator)
\li \l {Loading Placeholder Data}
You can create QML files that contain placeholder data, so that
you can test grid, list, or path views, even though you don't
have access to real data.
\li \l{UI Files}
Some of the wizards create projects that contain UI files
(.ui.qml). You should always edit UI files in the \l {2D}
and \l Properties view, to avoid breaking the code.
\endif
\endlist \endlist
*/ */

View File

@@ -1,93 +0,0 @@
/****************************************************************************
**
** Copyright (C) 2022 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.
**
****************************************************************************/
/*!
\page qt-effect-maker.html
\previouspage qt-effect-maker-files.html
\nextpage qtquick-motion-design.html
\sa {Creating Qt Quick Effect Maker Files}
\title Working with Effects in Qt Quick Effect Maker
The Qt Quick Effect Maker is a tool to create high-performance
shader effects for Qt Quick.
You can import these effects to \QDS and you can run Qt Quick Effect Maker
from \QDS.
\section1 Creating Effects
When you run Qt Quick Effect Maker, it starts with an empty project. To
create your effect, add nodes to the node tree.
\image qt-quick-effect-maker.webp
Consider the following things when creating effects:
\list
\li Some nodes do not function alone, they need a helper node. For
example, the \uicontrol FastBlur node needs a \uicontrol BlurHelper node
and the \uicontrol Noise node needs a \uicontrol NoiseHelper node. If the
node needs another node, it is mentioned in the node description.
\li If your effect appears cropped, you need to go to \uicontrol Edit >
\uicontrol {Project Settings} and increase the item padding.
\endlist
\section2 Creating a Blur Effect
To create a blur effect:
\list 1
\li Add a \uicontrol FastBlur node to the node tree.
\li Add a \uicontrol BlurHelper node to the node tree. You need the
\uicontrol BlurHelper node for all effects that contains a blur effect.
\endlist
\image blur-effect-nodes.png
You can now select the \uicontrol FastBlur node and in the settings, change
the \uicontrol fastBlurAmount value to control the amount of blur.
\image blur-effect-step-1.webp
\section3 Adjusting Item Borders
The effect appears cropped. You need to adjust item borders:
\list 1
\li Select \inlineimage effect-item-borders-icon.png
to display item borders.
\image blur-effect-step-2.webp
\li Go to \uicontrol Edit > \uicontrol {Project Settings}.
\li Set the item padding for all sides to 100.
\image effect-item-padding-dialog.png
\endlist
Now, you can see the complete blur effect.
\image blur-effect-step-3.webp
*/

View File

@@ -31,14 +31,16 @@
\list 1 \list 1
\li Copy the \QBPS ZXP package from \li Copy the \QBPS ZXP package from
\c {Qt\Tools\QtDesignStudio\photoshop_bridge} to the \c {Qt\Tools\QtDesignStudio\photoshop_bridge} to the
\c Documents directory in your user directory. \c Documents directory in your user directory. The \c {file-name}
should look similar to: \c {qt.QtBridge}.
\li Open Windows PowerShell. \li Open Windows PowerShell.
\li Enter the following commands: \li Enter the following commands, replacing
\c {<bridge-installation-file-name>} with the \c {file-name}:
\badcode \badcode
cd "$env:UserProfile\Documents" cd "$env:UserProfile\Documents"
mv .\io.qt.QtBridge.zxp .\io.qt.QtBridge.zip mv .\<bridge-installation-file-name>.zxp .\<bridge-installation-file-name>.zip
expand-archive .\io.qt.QtBridge.zip expand-archive .\<bridge-installation-file-name>.zip
xcopy /E /I .\io.qt.QtBridge "$env:APPDATA\Adobe\CEP\extensions\io.qt.QtBridge" xcopy /E /I .\<bridge-installation-file-name> "$env:APPDATA\Adobe\CEP\extensions\<bridge-installation-file-name>"
\endcode \endcode
\endlist \endlist
@@ -49,14 +51,16 @@
\list 1 \list 1
\li Copy the \QBPS ZXP package from \li Copy the \QBPS ZXP package from
\c {Qt/QtDesignStudio/photoshop_bridge} \c {Qt/QtDesignStudio/photoshop_bridge}
to your \c Documents directory. to your \c Documents directory. The \c {file-name}
should look similar to: \c {qt.QtBridge}.
\li Open Terminal. \li Open Terminal.
\li Enter the following commands: \li Enter the following commands, replacing
\c {<bridge-installation-file-name>} with the \c {file-name}:
\badcode \badcode
cd ~/Documents cd ~/Documents
unzip io.qt.QtBridge.zxp -d io.qt.QtBridge unzip <bridge-installation-file-name>.zxp -d <bridge-installation-file-name>
sudo mkdir -p /Library/Application\ Support/Adobe/CEP/extensions sudo mkdir -p /Library/Application\ Support/Adobe/CEP/extensions
sudo cp -R ./io.qt.QtBridge /Library/Application\ Support/Adobe/CEP/extensions sudo cp -R ./<bridge-installation-file-name> /Library/Application\ Support/Adobe/CEP/extensions
\endcode \endcode
\endlist \endlist

View File

@@ -25,18 +25,12 @@
and \l Properties view, to avoid breaking the code. and \l Properties view, to avoid breaking the code.
\li \l{Managing Data Collection} \li \l{Managing Data Collection}
\if defined (qtcreator)
You can enable \QC to report crashes automatically. If you agreed to
pseudonymous user statistics collection during the \QC installation,
you can turn it on and determine what type of data is collected and
transmitted to the backend storage.
\else
You can enable \QDS to report crashes automatically. If you enable You can enable \QDS to report crashes automatically. If you enable
the telemetry plugin, you can turn on the pseudonymous user the telemetry plugin, you can turn on the pseudonymous user
statistics collection and determine what type of data is collected statistics collection and determine what type of data is collected
and transmitted to the backend storage. You can also modify and transmitted to the backend storage. You can also modify
settings for collecting user feedback. settings for collecting user feedback.
\endif
\li \l{Packaging Applications} \li \l{Packaging Applications}
When you are ready to deliver your application to users or upload When you are ready to deliver your application to users or upload

View File

@@ -1,79 +0,0 @@
/****************************************************************************
**
** Copyright (C) 2022 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.
**
****************************************************************************/
/*!
\page qt-effect-maker-files.html
\nextpage qt-effect-maker.html
\previouspage creator-exporting-qml.html
\sa {Working with Effects in Qt Quick Effect Maker}
\title Creating Qt Quick Effect Maker Files
\section1 Creating an Effect File
You can create Qt Quick Effect Maker effect (.qep) files in \QDS and
then edit them in Qt Quick Effect Maker.
To create an effect file:
\list 1
\li In \QDS, right-click in the \uicontrol Assets view and
select \uicontrol {New Effect}.
\QDS creates an effect file and opens it in Qt Quick Effect Maker.
\image qt-quick-effect-maker.webp
\li Edit the effect.
\li In Qt Quick Effect Maker, go to \uicontrol File > \uicontrol Save.
\li Select \uicontrol File > \uicontrol Export.
\li With the default settings, select \uicontrol OK.
\image effect-maker-export.png
\endlist
Now, you can close Qt Quick Effect Maker and return to \QDS and apply the
effect.
\section1 Applying an Effect
You can apply effects to components in \QDS. To do so, drag the effect
from the \uicontrol Assets view to the component in the \uicontrol 2D or
\uicontrol Navigator view.
\image apply-effect-maker-effect.webp
\section1 Animated Effect
When you import an animated effect, you need to turn on the animation for it
to see the animation in your \QDS application.
To turn on animation for an effect, first apply the effect to a component,
and then:
\list 1
\li Select the effect in \uicontrol Navigator.
\li In \uicontrol Properties, go to the
\uicontrol {Exposed Custom Properties} section and set
\uicontrol timeRunning to true.
\endlist
*/

View File

@@ -3,7 +3,7 @@
/*! /*!
\page studio-help.html \page studio-help.html
\previouspage creator-editor-external.html \previouspage studio-compatibility-with-mcu-sdks.html
\nextpage creator-help.html \nextpage creator-help.html
\title Help \title Help

View File

@@ -47,10 +47,10 @@
\li Creates a project that uses default and 3D components such as \li Creates a project that uses default and 3D components such as
cameras, lights, 3D models, and materials. cameras, lights, 3D models, and materials.
\row \row
\li Qt for MCUs \li \QMCU
\li MCU \li MCU
\li Creates an application that uses a subset of default components \li Creates an application that uses a subset of default components
(as supported by Qt for MCUs) that you can deploy, run, and debug (as supported by \QMCU) that you can deploy, run, and debug
on MCU boards. on MCU boards.
\row \row
\li {1,3} Mobile \li {1,3} Mobile

View File

@@ -162,7 +162,7 @@
\list \list
\li \l{Setting Up Qt Bridge for Figma} \li \l{Setting Up Qt Bridge for Figma}
\li \l{Using Qt Bridge for Figma} \li \l{Using Qt Bridge for Figma}
\li \l{Using Figma Quick Control Template in Qt Design Studio} \li \l{Using Figma Quick Control Template Components in Qt Design Studio}
\endlist \endlist
\endlist \endlist
\li \l {Exporting 3D Assets} \li \l {Exporting 3D Assets}
@@ -180,11 +180,7 @@
\li \l{Importing 3D Assets} \li \l{Importing 3D Assets}
\endlist \endlist
\li \l{Exporting Components} \li \l{Exporting Components}
\li Qt Quick Effect Maker \li \l{Using Qt Quick Effect Maker Effects}
\list
\li \l{Creating Qt Quick Effect Maker Files}
\li \l{Working with Effects in Qt Quick Effect Maker}
\endlist
\endlist \endlist
\endlist \endlist
\li \l{Motion Design} \li \l{Motion Design}
@@ -263,6 +259,10 @@
\li \l{Converting Qt 5 Projects into Qt 6 Projects} \li \l{Converting Qt 5 Projects into Qt 6 Projects}
\li \l{Converting UI Projects to Applications} \li \l{Converting UI Projects to Applications}
\li \l{Using External Tools} \li \l{Using External Tools}
\li \l{\QDS on MCUs}
\list
\li \l {\QDS Version Compatibility with \QMCU SDKs}
\endlist
\endlist \endlist
\li \l Help \li \l Help
\list \list

View File

@@ -0,0 +1,44 @@
// Copyright (C) 2023 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
/*!
\page qt-using-effect-maker-effects.html
\nextpage qtquick-motion-design.html
\previouspage creator-exporting-qml.html
\title Using Qt Quick Effect Maker Effects
\QQEM is integrated into \QDS for creating shader effects. To create an
effect, you first create the effect file in \QDS, and then you edit it in \QQEM.
For more information about \QQEM, see the
\l{https://doc.qt.io/qt-6/qtquickeffectmaker-index.html}{Qt Quick Effect Maker Manual}.
\section1 Creating an Effect File
To create an effect file in \QDS:
\list 1
\li Right-click in the \uicontrol Assets view and
select \uicontrol {New Effect}.
\QDS creates an effect file and opens it in \QQEM.
\image qt-quick-effect-maker.webp
\li Edit the effect.
\li In \QQEM, go to \uicontrol File > \uicontrol Save.
\li With the default settings, select \uicontrol OK.
\image effect-maker-export.png
\endlist
Now, you can close \QQEM and return to \QDS and apply the
effect.
\section1 Applying an Effect
You can apply effects to components in \QDS. To do so, drag the effect
from the \uicontrol Assets view to the component in the \uicontrol 2D or
\uicontrol Navigator view.
\image apply-effect-maker-effect.webp
*/

View File

@@ -81,6 +81,7 @@
\li \l{Converting Qt 5 Projects into Qt 6 Projects} \li \l{Converting Qt 5 Projects into Qt 6 Projects}
\li \l{Converting UI Projects to Applications} \li \l{Converting UI Projects to Applications}
\li \l{Using External Tools} \li \l{Using External Tools}
\li \l{\QDS on MCUs}
\endlist \endlist
\li \b {\l Help} \li \b {\l Help}
\list \list

View File

@@ -4,26 +4,11 @@
/*! /*!
\page exporting-3d-assets.html \page exporting-3d-assets.html
\if defined(qtdesignstudio)
\previouspage qtbridge-figma-template.html \previouspage qtbridge-figma-template.html
\else
\previouspage quick-states.html
\endif
\nextpage exporting-from-blender.html \nextpage exporting-from-blender.html
\title Exporting 3D Assets \title Exporting 3D Assets
\if defined(qtcreator)
\table
\row
\li \inlineimage blender-logo.png
\li \inlineimage maya-logo.png
\row
\li \l{Exporting from Blender}{Blender}
\li \l{Exporting from Maya}{Maya}
\endtable
\endif
You can import files you created using 3D graphics applications and exported You can import files you created using 3D graphics applications and exported
to several widely-used formats, such as .blend, .dae, .fbx, .glb, .gltf, to several widely-used formats, such as .blend, .dae, .fbx, .glb, .gltf,
.obj, .uia, or .uip. For a list of formats supported by each \l{Qt Quick 3D} .obj, .uia, or .uip. For a list of formats supported by each \l{Qt Quick 3D}

View File

@@ -4,11 +4,7 @@
/*! /*!
\page exporting-from-maya.html \page exporting-from-maya.html
\previouspage exporting-from-blender.html \previouspage exporting-from-blender.html
\if defined (qtdesignstudio)
\nextpage exporting-from-qt3ds.html \nextpage exporting-from-qt3ds.html
\else
\nextpage studio-importing-3d.html
\endif
\title Exporting from Maya \title Exporting from Maya

View File

@@ -4,11 +4,7 @@
/*! /*!
\page exporting-from-qt3ds.html \page exporting-from-qt3ds.html
\previouspage exporting-from-maya.html \previouspage exporting-from-maya.html
\if defined(qtdesignstudio)
\nextpage studio-importing-designs.html \nextpage studio-importing-designs.html
\else
\nextpage studio-importing-3d.html
\endif
\title Exporting from Qt 3D Studio \title Exporting from Qt 3D Studio

View File

@@ -3,11 +3,8 @@
/*! /*!
\page studio-importing-3d.html \page studio-importing-3d.html
\if defined(qtdesignstudio)
\previouspage qtquick-fonts.html \previouspage qtquick-fonts.html
\else
\previouspage exporting-from-maya.html
\endif
\nextpage creator-exporting-qml.html \nextpage creator-exporting-qml.html
\title Importing 3D Assets \title Importing 3D Assets

View File

@@ -208,4 +208,97 @@
To specify the maximum distance for the shadow map, set the To specify the maximum distance for the shadow map, set the
\uicontrol {Shadow map far} property value. Using smaller values \uicontrol {Shadow map far} property value. Using smaller values
may improve the precision and effects of the map. may improve the precision and effects of the map.
\section1 Baking Lightmaps
\note Lightmaps baking is released as technical preview in \QDS 4.1.
\section2 Baking Lightmaps for a 3D Model
Baked lightmap components are not visible in the \uicontrol Navigator view by default. To make
them visible, select \inlineimage icons/visibilityon.png
in the \uicontrol Navigator view.
To bake lightmaps for a 3D model:
\list 1
\li From \uicontrol Components, drag a \uicontrol {Baked Lightmap} component to
the 3D model in the \uicontrol Navigator view.
\image baked-lightmaps-navigator.png
\li In the \uicontrol Navigator view, select \e bakedLightmap and in the \uicontrol Properties
view:
\list
\li Select \uicontrol Enabled.
\li In \uicontrol Key, set the filename base for the generated light maps. This must be
a unique name.
\li In \uicontrol {Load Prefix}, set the relative path to the folder where the generated
light map files are saved.
\endlist
\li In the \uicontrol Navigator view, select the 3D model and in the \uicontrol Properties
view, select \uicontrol {Used in Baked Lighting}.
\li Optional. Adjust \uicontrol Resolution to set the light map resoution. This effects how
accurate and time-consuming the lightmap baking is.
\li In the \uicontrol Navigator view, select the light component that you want to bake
lightmaps for, and in the \uicontrol Properties view, set \uicontrol {Bake Mode} to BakeModeAll.
\li Right-click anywhere in the \uicontrol 3D view and select \uicontrol {Bake Lights}.
\endlist
\section2 Baking Lightmaps for a 3D Model Inside a Sub Component
To bake lightmaps for a 3D model inside a sub component, first add a local custom property to
expose the model:
\list 1
\li In the \uicontrol Navigator view, right-click the sub component and select
\uicontrol {Edit Component}.
\image baked-lightmaps-edit-component.png
\li In the \uicontrol Navigator view, select the root component.
\li In the \uicontrol Properties view, select \inlineimage icons/plus.png
in the \uicontrol {Local Custom Properties} section.
\li Add a new property, set \uicontrol Type to alias.
\image baked-lightmaps-add-property.png
\li For the property, set the value to the ID of the 3D model that you want
to bake lightmaps for.
\image baked-lightmaps-property-value.png
\li In the \uicontrol Navigator view, select the 3D model and in the \uicontrol Properties
view:
\list
\li Select \uicontrol {Used in Baked Lighting}.
\li Set \uicontrol Resolution to, for example, 128.
\endlist
\li Save your changes (\key {Ctrl+S}) and return to the main project file. To do this, select
the bread crumb in the top toolbar.
\image baked-lightmaps-exit-component.png
\li From the \uicontrol Components view, drag a \uicontrol {Baked Lightmap} component to the
sub component in the \uicontrol Navigator view.
\image baked-lightmaps-navigator-blm.png
\li In the \uicontrol Navigator view, select the sub component and go to the
\uicontrol Code view.
\li In the \uicontrol Code view, you need to set the properties for the model inside the sub
component by using the exposed property.
Add the following code inside the sub component.
\code
lmSphere.bakedLightmap: bakedLightmap
\endcode
It should look something like this:
\code
MyGroup {
id: group
lmSphere.bakedLightmap: bakedLightmap
BakedLightmap {
id: bakedLightmap
loadPrefix: "lightmaps"
}
}
\endcode
\li In the \uicontrol Navigator view, select \e bakedLightMap, and in the \uicontrol
Properties view:
\list
\li Select \uicontrol Enabled.
\li In \uicontrol Key, set the filename base for the generated light maps. This must be
a unique name.
\endlist
\li Right-click anywhere in the \uicontrol 3D view and select \uicontrol {Bake Lights}.
\endlist
*/ */

View File

@@ -4,11 +4,7 @@
/*! /*!
\page studio-optimized-3d-scenes.html \page studio-optimized-3d-scenes.html
\previouspage qtquick-optimizing-designs.html \previouspage qtquick-optimizing-designs.html
\if defined(qtdesignstudio)
\nextpage studio-implementing-applications.html \nextpage studio-implementing-applications.html
\else
\nextpage qtquick-iso-icon-browser.html
\endif
\title Creating Optimized 3D Scenes \title Creating Optimized 3D Scenes
@@ -22,11 +18,7 @@
\section1 The Optimal 3D Scene Example \section1 The Optimal 3D Scene Example
\if defined(qtdesignstudio)
The \l {Optimal 3D Scene} The \l {Optimal 3D Scene}
\else
The Optimal 3D Scene
\endif
example features four versions of the same kitchen example features four versions of the same kitchen
scene that have been created using different strategies: High, Low, Combined, scene that have been created using different strategies: High, Low, Combined,
and Vertex Color. The High Scene includes a significantly higher number of and Vertex Color. The High Scene includes a significantly higher number of

View File

@@ -62,13 +62,10 @@
different type. different type.
\endtable \endtable
\if defined(qtdesignstudio)
Alternatively, you can use \uicontrol {And Operator}, Alternatively, you can use \uicontrol {And Operator},
\uicontrol {Or Operator}, and \uicontrol {Not Operator} \uicontrol {Or Operator}, and \uicontrol {Not Operator}
components to bind property values using the boolean AND, components to bind property values using the boolean AND,
OR, and NOT operator. For more information, see \l{Logic Helpers}. OR, and NOT operator. For more information, see \l{Logic Helpers}.
\endif
In addition, you can use arithmetic operators to compare numbers before In addition, you can use arithmetic operators to compare numbers before
checks. However, we recommend that you create separate properties for this checks. However, we recommend that you create separate properties for this

View File

@@ -36,10 +36,8 @@
\li \l {UI Controls} \li \l {UI Controls}
\li \l {User Interaction Methods} \li \l {User Interaction Methods}
\li \l {Lists and Other Data Models} \li \l {Lists and Other Data Models}
\if defined(qtdesignstudio)
\li \l {2D Effects} \li \l {2D Effects}
\li \l {Logic Helpers} \li \l {Logic Helpers}
\endif
\li \l Animations \li \l Animations
\li \l{3D Views} \li \l{3D Views}
\li \l{Node} \li \l{Node}

View File

@@ -54,11 +54,7 @@
\list \list
\li \l{Using States to Change Component Property Values} \li \l{Using States to Change Component Property Values}
\if defined(qtdesignstudio)
\li \l{Exporting Properties} \li \l{Exporting Properties}
\else
\li \l{Moving the Bubble} in \l{Creating a Mobile Application}
\endif
\endlist \endlist
For more information, watch the following video: For more information, watch the following video:

View File

@@ -4,11 +4,8 @@
/*! /*!
\page quick-dynamic-properties.html \page quick-dynamic-properties.html
\previouspage quick-property-bindings.html \previouspage quick-property-bindings.html
\if defined(qtdesignstudio)
\nextpage quick-states.html \nextpage quick-states.html
\else
\nextpage quick-connections-backend.html
\endif
\sa {Specifying Component Properties} \sa {Specifying Component Properties}
\title Specifying Custom Properties \title Specifying Custom Properties

View File

@@ -63,17 +63,12 @@
in the context menu to specify the connection in in the context menu to specify the connection in
\uicontrol {Connection Editor}. \uicontrol {Connection Editor}.
\if defined(qtcreator)
For an example of using the \uicontrol {Connections} view, see
\l{Connecting Mouse Clicks to State Changes}.
\else
For examples of using the \uicontrol {Connections} view, see: For examples of using the \uicontrol {Connections} view, see:
\list \list
\li \l{Connecting Buttons to States} in \l{Log In UI - States} \li \l{Connecting Buttons to States} in \l{Log In UI - States}
\li \l{Connecting Buttons to State Changes} in \l{Washing Machine UI} \li \l{Connecting Buttons to State Changes} in \l{Washing Machine UI}
\endlist \endlist
\endif
\section1 Adding Signal Handlers \section1 Adding Signal Handlers

View File

@@ -33,12 +33,6 @@
not otherwise exist for a particular \l{Component Types} not otherwise exist for a particular \l{Component Types}
{component type} or your custom components. {component type} or your custom components.
\if defined(qtcreator)
\li \l{Managing C++ Backend Objects}
Application developers can access QObject objects implemented in C++
from QML files.
\endif
\endlist \endlist
For an example of using properties, bindings, and connections to create a For an example of using properties, bindings, and connections to create a

View File

@@ -37,11 +37,6 @@
custom properties that would not otherwise exist for a particular custom properties that would not otherwise exist for a particular
\l{Component Types}{component type}. \l{Component Types}{component type}.
\if defined(qtcreator)
In addition, application developers can use the \uicontrol Backends view
to access QObject objects implemented in C++ from QML files.
\endif
\section1 Summary of the Connections View Tabs \section1 Summary of the Connections View Tabs
\table \table
@@ -64,11 +59,6 @@
\li Add custom properties that would not otherwise exist for a \li Add custom properties that would not otherwise exist for a
particular preset component or your own custom component. particular preset component or your own custom component.
\li \l{Specifying Custom Properties} \li \l{Specifying Custom Properties}
\if defined(qtcreator)
\row
\li \uicontrol Backends
\li Access QObject objects implemented in C++ from QML files.
\li \l{Managing C++ Backend Objects}
\endif
\endtable \endtable
*/ */

View File

@@ -9,13 +9,9 @@
/*! /*!
\page creator-using-qt-quick-designer.html \page creator-using-qt-quick-designer.html
\if defined(qtdesignstudio)
\previouspage creator-modes.html \previouspage creator-modes.html
\nextpage qtquick-form-editor.html \nextpage qtquick-form-editor.html
\else
\previouspage quick-projects.html
\nextpage quick-uis.html
\endif
\title Design Views \title Design Views
@@ -151,7 +147,6 @@
\li Keyboard Shortcut \li Keyboard Shortcut
\li Read More \li Read More
\if defined(qtdesignstudio)
\row \row
\li \inlineimage icons/home.png \li \inlineimage icons/home.png
\li \uicontrol {Home}: opens the welcome page. \li \uicontrol {Home}: opens the welcome page.
@@ -168,7 +163,6 @@
make to the UI are instantly visible to you in the preview. make to the UI are instantly visible to you in the preview.
\li \key Alt+P (\key Opt+P on \macos) \li \key Alt+P (\key Opt+P on \macos)
\li \l{Validating with Target Hardware} \li \l{Validating with Target Hardware}
\endif
\row \row
\li Currently open file \li Currently open file

Some files were not shown because too many files have changed in this diff Show More