diff options
author | Vikas Pachdha <vikas.pachdha@qt.io> | 2020-09-08 22:37:28 +0200 |
---|---|---|
committer | Vikas Pachdha <vikas.pachdha@qt.io> | 2020-09-09 09:33:28 +0000 |
commit | f7634fc73836e368cfa14379eeda26ee761b16b7 (patch) | |
tree | ce5295d737e090517d1406e1ae8e06c6e22c7994 | |
parent | 90a18fe7fa94c8c98cff86c957aa96c8c8c414a8 (diff) |
Doc: Add Qt Bridge import documentationqds/v1.6.0
Change-Id: Iab73c53c4f128f54ebd4938ad24d0febb8705784
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
-rw-r--r-- | doc/qtdesignstudio/images/qt-bridge-import-warning.png | bin | 0 -> 35447 bytes | |||
-rw-r--r-- | doc/qtdesignstudio/images/qt-bridge-import.png | bin | 0 -> 25057 bytes | |||
-rw-r--r-- | doc/qtdesignstudio/src/qtbridge/qtbridge-ps-using.qdoc | 40 |
3 files changed, 40 insertions, 0 deletions
diff --git a/doc/qtdesignstudio/images/qt-bridge-import-warning.png b/doc/qtdesignstudio/images/qt-bridge-import-warning.png Binary files differnew file mode 100644 index 00000000000..8f037ca2630 --- /dev/null +++ b/doc/qtdesignstudio/images/qt-bridge-import-warning.png diff --git a/doc/qtdesignstudio/images/qt-bridge-import.png b/doc/qtdesignstudio/images/qt-bridge-import.png Binary files differnew file mode 100644 index 00000000000..f438beb3c2c --- /dev/null +++ b/doc/qtdesignstudio/images/qt-bridge-import.png diff --git a/doc/qtdesignstudio/src/qtbridge/qtbridge-ps-using.qdoc b/doc/qtdesignstudio/src/qtbridge/qtbridge-ps-using.qdoc index ff12226ab42..86282ffd281 100644 --- a/doc/qtdesignstudio/src/qtbridge/qtbridge-ps-using.qdoc +++ b/doc/qtdesignstudio/src/qtbridge/qtbridge-ps-using.qdoc @@ -251,4 +251,44 @@ \li \l{https://www.youtube.com/watch?v=ZzbucmQPU44} {From Photoshop to Prototype with Qt Design Studio} \endlist + + \section1 Importing Metadata & Assets + + \QBPS can import metadata generated from other tools and generate a Photoshop document. A + conventional workflow would be to generate metadata and assets by \l {Exporting QML} {exporting} + a QML project from \QDS and use \QBPS to generate a Photoshop document. + + Imported text and the assets are organized into Artboards, layers, and groups. + + Select the \uicontrol Import button to launch the \uicontrol Import panel. Alternatively, \QB + import can be launched from \uicontrol Window > \uicontrol Extensions. + + \image qt-bridge-import.png + + Create a new PSD document and launch the \uicontrol Import dialog. Open the metadata file to + import and select \uicontrol Import. + + \note The import process removes all the existing layers in the selected PSD document. + + \image qt-bridge-import-warning.png + + The following guidelines are followed to generate the Photoshop document: + \list + \li An Artboard is created for each QML component exported and defined in the metadata file. + \li An image layer is created for an item with an asset. + \li A solid fill layer is created for an item without an asset. + \li A paragraph text layer is created for Text items. + \endlist + + All QML metadata specified in the metadata file is assigned to the generated layers. + + An important concept of \e {Virtual parent} is applied to translate the QML DOM to Photoshop + DOM. A QML \l Item can have children but a layer in a Photoshop document cannot have child + layers. To mitigate this variance, a Group layer is created and child items are added to this + Group layer. The Group layer acts as a virtual parent and the correct parent is assigned when + the Photoshop document is exported and re-imported in \QDS. + + \note The parent-child relationship may be lost if the virtual parent Group layer is moved or + deleted. + */ |