Tooling: Add pyside6-balsamui

- Add documentation for the tool
- Add a screenshot of the tool

Pick-to: 6.7 6.6 6.5
Task-number: PYSIDE-2629
Change-Id: I63d1d7e65d92ec37012ce40bb319dfeef9c9695b
Reviewed-by: Friedemann Kleint <Friedemann.Kleint@qt.io>

6 files changed, 36 insertions, 2 deletions

diff --git a/build_scripts/__init__.py b/build_scripts/__init__.py
index 38f4da95f..128bb2394 100644
--- a/build_scripts/__init__.py
+++ b/build_scripts/__init__.py
@@ -19,7 +19,8 @@ PYSIDE_UNIX_BIN_TOOLS = ["lupdate",
                          "qmlformat",
                          "qmlls",
                          "qsb",
-                         "balsam"]
+                         "balsam",
+                         "balsamui"]
 
 # tools that are bundled as .app in macOS, but are normal executables in Linux and Windows
 PYSIDE_UNIX_BUNDLED_TOOLS = ["assistant",
diff --git a/sources/pyside-tools/CMakeLists.txt b/sources/pyside-tools/CMakeLists.txt
index 308f7bbc7..e629ec570 100644
--- a/sources/pyside-tools/CMakeLists.txt
+++ b/sources/pyside-tools/CMakeLists.txt
@@ -46,7 +46,8 @@ else()
                         "${TOOLS_PATH}/qmlformat${CMAKE_EXECUTABLE_SUFFIX}"
                         "${TOOLS_PATH}/qmlls${CMAKE_EXECUTABLE_SUFFIX}"
                         "${TOOLS_PATH}/qsb${CMAKE_EXECUTABLE_SUFFIX}"
-                        "${TOOLS_PATH}/balsam${CMAKE_EXECUTABLE_SUFFIX}")
+                        "${TOOLS_PATH}/balsam${CMAKE_EXECUTABLE_SUFFIX}"
+                        "${TOOLS_PATH}/balsamui${CMAKE_EXECUTABLE_SUFFIX}")
 
         if (APPLE)
             list(APPEND directories "${TOOLS_PATH}/Assistant.app"
diff --git a/sources/pyside-tools/pyside_tool.py b/sources/pyside-tools/pyside_tool.py
index 32e0b917b..b369be8a2 100644
--- a/sources/pyside-tools/pyside_tool.py
+++ b/sources/pyside-tools/pyside_tool.py
@@ -235,5 +235,9 @@ def balsam():
     qt_tool_wrapper("balsam", sys.argv[1:])
 
 
+def balsamui():
+    qt_tool_wrapper("balsamui", sys.argv[1:])
+
+
 if __name__ == "__main__":
     main()
diff --git a/sources/pyside6/doc/tools/index.rst b/sources/pyside6/doc/tools/index.rst
index 900b2525a..b421a428f 100644
--- a/sources/pyside6/doc/tools/index.rst
+++ b/sources/pyside6/doc/tools/index.rst
@@ -203,3 +203,9 @@ Qt Quick 3D
         a command line tool that takes assets created in digital content
         creation tools like Maya, 3ds Max or Blender and converts them into an
         efficient runtime format for use with Qt Quick 3D.
+
+    .. grid-item-card:: ``pyside6-balsamui``
+        :link: pyside6-balsamui
+        :link-type: ref
+
+        a graphical user interface for the ``pyside6-balsam`` tool.
diff --git a/sources/pyside6/doc/tools/pyside6-balsamui.rst b/sources/pyside6/doc/tools/pyside6-balsamui.rst
new file mode 100644
index 000000000..f34cb6045
--- /dev/null
+++ b/sources/pyside6/doc/tools/pyside6-balsamui.rst
@@ -0,0 +1,22 @@
+.. _pyside6-balsamui:
+
+pyside6-balsamui
+================
+
+``pyside6-balsamui`` is graphical user interface frontend to the command line
+tool :ref:`pyside6-balsam`. The purpose of the tool is to take assets created
+in digital content creation tools like `Maya`_, `3ds Max`_ or `Blender`_ and
+converts them into an efficient runtime format for use with Qt Quick 3D.
+
+For more information on the further capabilities of the tool, read Qt's
+documentation here: `Balsam Asset Import Tool`_.
+
+.. image:: pyside6-balsamui_screenshot.webp
+    :width: 500
+    :alt: pyside6-balsamui screenshot
+
+.. _`Balsam Asset Import Tool`: https://doc.qt.io/qt-6/qtquick3d-tool-balsam.html
+.. _Maya: https://www.autodesk.com/products/maya/overview
+.. _3ds Max: https://www.autodesk.com/products/3ds-max/overview
+.. _Blender: https://www.blender.org/
+
diff --git a/sources/pyside6/doc/tools/pyside6-balsamui_screenshot.webp b/sources/pyside6/doc/tools/pyside6-balsamui_screenshot.webp
new file mode 100644
index 000000000..5c194fdb6
--- /dev/null
+++ b/sources/pyside6/doc/tools/pyside6-balsamui_screenshot.webp