CuteHMI - View (cutehmi.view.4)
View

Development status

Client, GUI application, which allows one to run CuteHMI project in a window.

By default this tool shows only a simple help screen.

Default view screenshot

CuteHMI approach is to treat each project as a first-class QML extension, so the purpose of the tool is to load specified extension and display one of its QML components. Any extension that provides graphical UI QML component can be loaded as cutehmi.view.4 project. Use command line argument to specify an extension.

For example to run Simple View example use following command.

cutehmi.view.4 CuteHMI.Examples.SimpleView.2

To run project from QtCreator click Projects -> Run. Select cutehmi.view.4 from Run configuration. In the Command line arguments box type: CuteHMI.Examples.SimpleView.2. The window should look similar to the screenshot below.

SimpleView screenshot

Default loader picks View as default QML component to load. Component can be specified with second positional argument. For example following displays RectangularElement component from the previous example.

cutehmi.view.4 CuteHMI.Examples.SimpleView.2 RectangularElement

One can also use --init option to replace default loader with custom one.

You can use --help command line argument to see a list of all possible command line options.

For debug builds use cutehmi.view.4.debug instead of cutehmi.view.4.

Providing Qt Quick Controls configuration file

Qt allows for configuring the style of application with a special qtquickcontrols2.conf file. This file has to be built into application resources. Extension may provide it within cutehmi.view.rcc resource file, which shall be intalled into extension dedicated directory. For this cutehmi.rcc Qbs module can be used, which generates rcc artifacts from qrc files. Extension just needs to put qtquickcontrols2.conf (root prefix) inside cutehmi.view.qrc, declare dependency on cutehmi.rcc module and assign cutehmi.qrc tag to the cutehmi.view.qrc file (module cutehmi.rcc uses distinct tag to prevent Qt.core from creating cpp files with qrc resources, which is not desired for simple QML extensions).

Depends { name: "cutehmi.rcc" }
Group {
files: "cutehmi.view.qrc"
fileTags: "cutehmi.qrc"
}

Resource file can be also specified with --resource option.

Changes

Compared to previous major version following changes were made.

  • View looks for View component instead of Main.
  • Extension is specified with first positional argument instead of --extension argument.
  • Component is specified with second positional argument instead of --component argument.
  • It is possible to register resource on startup (by the extension with cutehmi.view.rcc lookup or by the user with --resource argument).