Lobby

The Lobby is the first window that is presented when starting the TouchGFX Designer. From the Lobby new projects can be created, demo projects can be explored and existing projects can be opened from.
The Lobby can also be entered from a opened project by pressing the TouchGFX icon, in the top left corner, or by pressing CTRL + N.
Creating a project from an opened project results in an new instance of the TouchGFX Designer being opened.

When running the TouchGFX Designer for the first time the welcome pop-up and an option to select between light and dark theme will appear before entering the Lobby.

Welcome pop-up

Theme selector pop-up

Home

In the Home tab new projects based on recently used TouchGFX Board Setups (TBS) can be created and projects can be opend.

The Home tab in the Lobby

Recently used TouchGFX Board Setups
In this section the TBS that are used in the most recent projects can be selected, and be used for creating a new project combined with Blank UI. Selecting a TBS presents the same options as selecting a TBS under Create.

My Recent Projects
This section allows users to quickly open a recent project.

Open
Pressing the Open button opens a file browser allowing for manual navigation and opening of a .touchgfx project file.

Create New
Pressing the Create New button changes the tab in the Lobby from Home to Create.

Create

In the Create tab, TBS can be selected to use for a new project, combined with the Blank UI.

The Create tab in the Lobby

Searchbar
The Searchbar is used for filtering the TBS by the name of a board.

The Searchbar

Producer Filter
The producer filter is divided into three filters, Show All, which shows all TBSs, By STMicroelectronics, which shows the TBSs created by STMicroelectronics, and By Partners, which shows the TBSs created by our partners.

The producer filter

TBS List
Based the selected filter a list of TBS is shown. The properties shown on each TBS is the name, the operating system and the resolution.

Example of the TBS List

Selected TBS
When selecting a TBS, the section in the right side shows more information about the TBS and the options to create a new project based on the TBS.

Selected TBS with description and options

Application Name
This will determine the name of the new project, as well as the name of the folder the new project will be contained in.

Application Directory
This will determine the location of the new project.

Color Depth
This dropdown will contain the color depths supported by the selected TBS.

Versions
This dropdown will contain the different versions supported by the selected TBS.

Resolution
The adjustment of the resolution varies depending on which TBS has been selected. The Simulator TBS will support any resolution size between 0 x 0 and 2000 x 2000.

Create
Pressing the Create button, creates a new project based on the selected TBS and Blank UI, with the settings from above.

Examples

In the Examples tab, new projects can be created based on an example and a TBS.

The Examples tab in the Lobby

Searchbar
The Searchbar is used for filtering the Examples by name.

The Searchbar

Examples List
Based the selected filter, a list of examples is shown. The properties shown on each example is name and the resolutions the example is compatible with.

Example of the examples list

Select Board Setup
The Select Board Setup button opens a pop-up from where a TBS can be selected.

The Select Board Setup pop-up

Searchbar
The Searchbar is used for filtering the TBS by name.

Producer Filter
The producer filter is divided into three filters, Show All, which shows all TBSs, By STMicroelectronics, which shows the TBSs created by STMicroelectronics, and By Partners, which shows the TBSs created by our partners.

TBS List
Based on the selected filter, a list of TBS is shown. The properties shown on each TBS is the name, the operating system and the resolution.

TBS Info
When selecting a TBS, the section in the right side shows more information about the TBS, the option to set the versionon the Select button to select the TBS.

The selected TBS is shown instead of the Select Board Setup button and the examples not matching the resolution are greyed out.
Creating a project without having selected a board results in a project based on the Simulator

The examples list with the selected TBS on top and the examples with a resolution that is incompatible with the TBS greyed out

Selected Example
When selecting an example, the section in the right side shows a description and the option to create a new project based on the example.

Selected example with description and options

Application Name
This will determine the name of the new project, as well as the name of the folder the new project will be contained in.

Application Directory
This will determine the location of the new project.

Color Depth
This dropdown will contain the color depths supported by the selected example and TBS.

Versions
This dropdown will contain the different versions of the example.

Resolution
The adjustment of the resolution vary depending on which example and TBS has been selected. The Blank UI combined with the Simulator will support any resolution size between 0 x 0 and 2000 x 2000.

Create
Pressing the Create button creates a new project based on the selected Example and TBS, with the settings from above.

Demos

In the Demos tab, projects based on a Demos and a TBS or a Board Specifc Demo (BSD) can be created.

The Demos tab in the Lobby

Demos Filter
In the filter in the top Demo or Board Specific Demo can be selected, which results in either demos oer BSDs to be shown.

The demo filter

Searchbar
The Searchbar is used for filtering the Demos or BSDs by name.

The searchbar

Demos List
Based the selected filter, a list of demos is shown. The properties shown on each Demo or BSD is the name and the resolution required.

List of demos with the demo filter applied

List of demos with the Board Specific Demo filter applied

Select Board Setup
The Select Board Setup button opens a pop-up from where a TBS can be selected
The Select Board Setup button is only available under the demo filter, since BSDs are a demo and and TBS combined

The Select Board Setup pop-up

Selected Demo or BSD
When selecting an example the section in the right side shows a description, and the option to create a new project based on the example.

Selected demo or BSD with description and options

Application Name
This will determine the name of the new project, as well as the name of the folder the new project will be contained in.

Application Directory
This will determine the location of the new project.

Color Depth
This dropdown will contain the color depths supported by the selected Demo and TBS or BSD.

Versions
This dropdown will contain the different versions of the Demo or BSD.

Resolution
The adjustment of the resolution varies depending on which demo and TBS or BSD which is selected. The Blank UI combined with the Simulator will support any resolution size between 0 x 0 and 2000 x 2000.

Create
Pressing the Create button creates a new project based on the selected Demo and TBS or BSD, with the settings from above.