Skip to main content

Examples

To help further explore the possibilities and features of TouchGFX, multiple premade examples are made available to the user. These examples can be accessed through the Startup Window 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 are combined with Application Templates 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 focus on single features while others implement several different functionalities found in TouchGFX. Examples are divided into two different types.

UI Templates

UI Templates are generally smaller, more self-contained examples that mostly focus on specific features such as different widgets. UI Templates 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 UI Template fits the resolution of your board. Some UI Templates are also built with specific color depths in mind, which means they might not display as well on lower color depth displays.

The UI Templates also include several demos 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 a UI Template, start by pressing the card under the 'Application Template' label to see the available Application Templates. Click whichever Application Template you want and then press 'Select'. Next, press the card under the 'UI Template' label to see the available UI Templates. Click whichever UI Template you want and then press 'Select'. Optionally, select another resolution and color depth in the drop downs. Finally, press 'Create' to create an application from the selected Application Template and UI Template. 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 a UI template

Online Applications

Online Applications 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 examples 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 an Online Application, first access these by clicking the 'Online Applications' tab in the top of the startup window. Click the card under the 'Online Application' label to show what applications are available. Click the application you want and press 'Select'. Finish by pressing 'Create' and 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 an online application

Further reading
To read more about how to create applications using examples, see the Startup Window section.