// Copyright (C) 2021 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only

/*!
    \previouspage creator-help.html
    \page studio-faq.html
    \nextpage studio-platforms.html

    \title Frequently Asked Questions

    This section contains answers to some frequently asked questions about \QDS
    grouped by categories. You might also find answers to your questions in the
    product documentation by searching or browsing the index in the
    \l{Using the Help Mode}{Help mode}. Many questions are also answered by the
    \l{Examples}{examples} and \l{Tutorials}{video tutorials}.

    \list
        \li \l {FAQ - \QB}{\QB}
        \li \l {FAQ - Assets}{Assets}
        \li \l {FAQ - Components}{Components}
        \li \l {FAQ - Views}{Views}
        \li \l {FAQ - Integration Between \QDS and Qt Creator}{Integration Between \QDS and Qt Creator}
        \li \l {FAQ - Performance}{Performance}
        \li \l {FAQ - Data Simulation}{Data Simulation}
    \endlist

    \section1 FAQ - \QB

    \section2 How does \QBPS differ from \QBSK and \QBF?

    \QBPS, \QBSK, and \QBF are functionally similar. The biggest difference
    between the tools is that \QBSK and \QBF can export .svg (vector), .png, and
    .jpeg files, while \QBPS only supports .png and .jpeg. Adobe Illustrator
    users can port their designs into Photoshop, but they must be rasterized
    into \e {smart objects}.

    For more information, see \l {Exporting from Design Tools}.

    \section2 Do I need to copy the .qml files in the resource folder after each design modification?

    No you don't. When you add new or modified .metadata files to your project
    from Photoshop, \QBPS, \QBSK, or \QBF, select the \uicontrol {Merge QML}
    check box in the \uicontrol {Asset Import} dialog to merge the changes into
    existing QML files instead of overwriting them.

    For more information, see \l {Importing 2D Assets}.

    \section2 Where can I find log files generated by \QB while exporting metadata?

    On Windows, the logs are stored inside the temp folder in
    \c {C:\Users\<USERNAME>\AppData\Local\Temp}. The log files are named as
    \e csxs<versionNumber>-<HostID>.log. Please note that you might have to set
    the log level to generate logs. Also note the CEP version while setting the
    log level. The CEP version depends on the Photoshop version you are using.
    Currently the latest version is version 10.

    \section1 FAQ - Assets

    \section2 Can I import my organization's preferred font in \QDS?

    Yes, you can import your custom fonts, for example, in .ttf or .otf formats.
    Fonts installed on your system will be available to use in your imported
    designs. If you need to deploy the device, you will have to import the font
    into the project.

    For more information, see \l {Using Custom Fonts}.

    \section1 FAQ - Components

    \section2 Can I use custom components?

    Yes, you can create custom components and controls by using wizard templates
    or move component instances into separate files to turn them into new
    components that you can create instances of. For more information, see
    \l {Using Components}.

    \section2 What are the 3D import formats for \QDS?

    You can import files stored in several widely-used formats, such as .fbx,
    .obj, .gltf, .glb, .blend, .dae, .uia, and .uip.

    For more information, see \l {Importing 3D Assets}.

    \section2 How can I integrate custom C++ components into QDS?

    You must create your own QML module that contains the components and
    provides additional information about your components. For more information,
    see \l {Using QML Modules with Plugins}.

    \section1 FAQ - Views

    \section2 What are the keyboard shortcuts for moving around in the \uicontrol{3D} view?

    \list
        \li To pan: \key Alt + middle mouse button
        \li To orbit (rotate): \key Alt (or \key Option on \macos) + left mouse button
        \li To zoom: \key Alt + right mouse button
    \endlist

    For more information, see the \l {3D} view.

    \section1 FAQ - Integration Between \QDS and Qt Creator

    \section2 Can I automatically propagate name changes between \QDS and Qt Creator?

    Unfortunately we do not automate renaming files between tools at the moment.
    If you decide to change the name of a property, alias, or signal in \QDS,
    you need to manually change the name in Qt Creator to maintain the connection.
    However, you can rename symbols in all files within a project. To rename a
    QML type in a project, select \uicontrol Tools > \uicontrol QML/JS >
    \uicontrol {Rename Symbol Under Cursor} or press \key Ctrl+Shift+R. For more
    information, see \l {Renaming Symbols}.

    \section2 How can I add .qml files to my project in Qt Creator?

    Use the project wizard templates to create an application in \QDS and copy
    your .qml files to the project folder. Then make some changes to the project
    configuration and source files, as instructed in
    \l {Converting UI Projects to Applications}.

    \section1 FAQ - Performance

    \section2 Will my application with 3D components run at 60 FPS?

    With the ability to test the full (2D/3D) UI in \QDS on target hardware,
    you will quickly be able to determine if a 3D object is causing performance
    issues using the \uicontrol FPS field in the \uicontrol Design mode.
    \uicontrol FPS displays the frames-per-second (FPS) refresh rate of
    previewed animations.

    See \l {Optimizing Your 3D Scene} to learn how you can enhance the
    performance by optimizing your scene.

    \section1 FAQ - Data Simulation

    \section2 Can I automatically generate dummy data?
    No, this is not supported at the moment. For more information about creating
    the data manually, see \l {Loading Placeholder Data}.
    */
