feedc0de/qt-creator
1
0
Fork 0
forked from qt-creator/qt-creator
Code Pull Requests Activity

Doc: Describe QML Asset Exporter

Browse Source 
...as the chosen tool for exporting designs from Adobe Photoshop
to .ui.qml files. Remove the descriptions of using the old
export script.

Change-Id: Ib09d737c43debcf9773ba9145d66d5f6d91a4c98
Task-number: QTCREATORBUG-18486
Reviewed-by: Alessandro Portale <alessandro.portale@qt.io>
This commit is contained in:
Leena Miettinen
2017-07-12 15:11:15 +02:00
parent 8a3c798e4f
commit d785999512
2 changed files with 31 additions and 83 deletions
Download Patch File Download Diff File Expand all files Collapse all files

BIN
doc/images/qml-export-photoshop.png
View File

Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 29 KiB

114
doc/src/qtquick/qtquick-exporting-qml.qdoc
View File

@@ -39,29 +39,38 @@
\title Exporting Designs from Graphics Software \title Exporting Designs from Graphics Software
You can export designs from graphics software, such as Adobe Photoshop and You can export designs from graphics software, such as Adobe Photoshop and
GIMP, to QML files. Each scene is converted into a single QML file with an GIMP, to QML files.
\l [QML]{Image} or a \l [QML]{Text} item for each layer and saved on the
development PC. Top-level layer groups are converted into merged QML
\l [QML]{Image} types.
\note GIMP does not support grouping, and therefore, each layer is exported \section1 Exporting from Adobe Photoshop to QML
as an item in GIMP.
You can use a QML Asset Exporter to export designs from Adobe Photoshop
to .ui.qml files. The the QML Asset Exporter provides templates that are
based on the \l{http://www.pngexpress.com}{PNG EXPRESS} plugin for
Photoshop. They enable you to export PSD files to QML format, so that each
PSD file is converted into an .ui.qml file.
The filename of the generated document is based on the name of the PSD file.
Tagged image and text objects are exported with absolute positioning. Text
objects are exported with font and alignment information.
For more information, see the
\l {https://github.com/Pelagicore/QmlAssetExporter}{QML Asset Exporter}
documentation.
\section1 Exporting from GIMP to QML
\image qml-export-gimp.png
Each scene is converted into a single QML file with an
\l [QML]{Image} or a \l [QML]{Text} item for each layer and saved on the
development PC. Each layer is exported as an item.
You can open the QML file in \QC for editing. By default, the export scripts You can open the QML file in \QC for editing. By default, the export scripts
generate Qt Quick 1 files. To edit the files in \QMLD, change the import generate Qt Quick 1 files. To edit the files in \QMLD, change the import
statements in the export scripts to import Qt Quick 2. Or, you can change statements in the export scripts to import Qt Quick 2. Or, you can change
the import statement in each file after generating the files. the import statement in each file after generating the files.
If you edit the file in Adobe \section2 Conversion Rules
Photoshop and export it to the same directory again, any changes you made in
\QC are overwritten. However, you can re-export graphical assets without
recreating the QML code.
If you create vector graphics with other tools that have an Adobe Photoshop
export option, such as Adobe Illustrator, you can export them first to
Photoshop and then to QML.
\section1 Conversion Rules
The following rules apply to the conversions: The following rules apply to the conversions:
@@ -85,24 +94,21 @@
\endlist \endlist
\section1 Preparing Files for Conversion \section2 Preparing Files for Conversion
To create QML files that are easy to use, prepare the Adobe Photoshop or To create QML files that are easy to use, prepare the
GIMP designs for exporting, as follows: GIMP designs for exporting, as follows:
\list \list
\li To minimize the number of items, minimize the number of layers or \li To minimize the number of items, minimize the number of layers,
use top-level layer groups, because each layer or layer group is because each layer or is
exported as a \l [QML]{Text} or \l [QML]{Image} item. exported as a \l [QML]{Text} or \l [QML]{Image} item.
\li To make sure that all related items are exported to the same
item, use top-level layer groups.
\li To determine that some layers are not exported, hide them, and \li To determine that some layers are not exported, hide them, and
deselect the \uicontrol {Export hidden} check box during exporting. deselect the \uicontrol {Export hidden} check box during exporting.
\li To make it easier to find the layers and layer groups after \li To make it easier to find the layers after
exporting them, use descriptive names for them. exporting them, use descriptive names for them.
\li To make sure that image dimensions are preserved during export, \li To make sure that image dimensions are preserved during export,
@@ -118,65 +124,7 @@
\endlist \endlist
\section1 Exporting from Adobe Photoshop to QML \section2 Running the Export Script
\image qml-export-photoshop.png
The script has been tested to work on Adobe Photoshop CS 4 and 5, but it
might also work on other versions.
\list 1
\li Clone the repository that contains the export script,
\e{Export QML.jx}, from
\l{https://codereview.qt-project.org/#/admin/projects/qt-labs/photoshop-qmlexporter}
{Qt Code Review}.
\note Read the README.txt file in the repository for latest
information about the script.
\li To generate QML files that you can edit in \QMLD, edit the import
statement in \e {Export QML.jx}. For example:
\code
qmlfile.write("import QtQuick 2.5\n");
\endcode
\li Double-click the export script to add the export command to the
\uicontrol Scripts menu. You can also copy the script file to the Adobe
Photoshop scripts directory (typically, \c{\Presets\Scripts} in the
Photoshop installation directory).
\li In Adobe Photoshop, choose \uicontrol {File > Scripts > Export to QML} to
export the scene to a QML file.
\li In the \uicontrol {Export Document to QML} dialog, enter a name and
location for the QML file.
\li Select the \uicontrol {Rasterize text} check box to export text layers as
images, not as \l [QML]{Text} items.
\li Select the \uicontrol {Group layers} check box to export each top-level
group as a merged QML \l [QML]{Image} item.
\li Select the \uicontrol {Export hidden} check box to export hidden layers
and to set their visibility property to hidden.
\li Deselect the \uicontrol {Export QML} check box if you have modified the
QML document in \QC, but still want to re-export graphical assets.
\li Click \uicontrol Export.
\endlist
The QML file is saved to the location that you specified. In \QC, choose
\uicontrol {File > Open File or Project} to open the QML file.
\note Existing files are replaced without warning.
\section1 Exporting from GIMP to QML
\image qml-export-gimp.png
The script has been tested to work on GIMP 2. You can download GIMP 2 from The script has been tested to work on GIMP 2. You can download GIMP 2 from
\l{http://www.gimp.org/downloads/}{GIMP Downloads}. \l{http://www.gimp.org/downloads/}{GIMP Downloads}.