Skip to main content

Examples and Board Specific Demos

To help further explore the possibilities and features of TouchGFX, multiple premade Examples and Demos are made available to the user. These Examples and Demos can be accessed through the Lobby of TouchGFX Designer and all include free-to-use images, code, etc., which means that they can even be used as a base to build your own unique application from. Examples and Demos are combined with TouchGFX Board Setup to create TouchGFX applications. If you are new to TouchGFX, this can be a great starting source of inspiration and knowledge about how TouchGFX applications function.

Some Examples and Demos focus on single features while others implement several different functionalities found in TouchGFX. Demos are divided into two different types: Demos and Board Specific Demos.

Examples and Demos

Examples are generally smaller, more self-contained applications that mostly focus on specific features such as different widgets. Examples can run on any STM32 evaluation kit and the PC simulator, but for the best experience it is encouraged to create projects where the resolution of the Example fits the resolution of your board. Some Examples are also built with specific color depths in mind, which means they might not display as well on lower color depth displays.

The Demos include several applications made by the TouchGFX team which showcase more features with higher quality UI design. These can be a great place to start to get a feeling for what TouchGFX is capable of.

To create an application using an Example or Demo, start by clicking the "Examples" or "Demos" in the top left of the lobby to see the available applications and click on whichever application you want. Optionally, select another resolution and color depth in the drop downs. If you wish to run on a supported hardware click on the "Select Hardware" in the top of the window, choose whichever board you wish and press "Select". Finally, press 'Create' to create an application from the selected TouchGFX Board Setup and Example or Demo. Press either 'Run Simulator' or 'Run Target' to see the application running.

An animation of these steps can be seen below:

Creating a project using an Example

Board Specific Demos

Board Specific Demos are out-of-the-box applications for specific hardware solutions and it is therefore not possible to run these on any other STM32 evaluation kit than the one it was created for (aside from the PC simulator). These applications are generally a lot larger and explore multiple different features of the TouchGFX framework and can also include sample integration with the hardware.

To create an application using a Board Specific Demo, first access these by clicking the 'Demos' tab in the top left of the lobby. Click the "Board Specific Demo" label in the top of the window to show what applications are available. Click the application you want and finish by pressing 'Create'. Either press 'Run Simulator' or 'Run Target' to see the application running.

An animation of these steps can be seen below:

Creating a project using a Board Specific Demo

Further reading
To read more about how to create applications using Examples or Demos, see the Lobby section.