TouchGFX documentation feedback

[Romain DIELEMAN]

We wish to always improve our documentation. The best reviews and critics always come from the people that read it, so we would like to use this post to collect your thoughts and feedbacks.

Please share what you like, dislike, what you think is missing, etc ...

/The TouchGFX team

[HP]

I know it's not really related to the documentation but then again - it would be greatly appreciated to know when a new version is released. 4.19.0 released 21st of March but only because I looked at the changelog I noticed!

Can't you write it into your release-flow that a sticky forum post would be a good idea to notify users of a new version?

Thanks for your great work! I'll look forward to play around with the new version :)

[wired]

After having spent two weeks trying to upgrade (unsuccessfully) a working project to the latest CubeIDE, CubeMX, and TouchGFX, I was informed by ST Tech Support not to use CubeMX 6.6.1, but remain at 6.5.0 (see https://community.st.com/s/question/0D53W00001hljujSAA for more information about that). My suggestion is that ST put compatibility information in an easy to find spot in the online documentation. Had I known that using TouchGFX with CubeMX 6.6.1 would cause problems, I would not have upgraded. I'm sure there are many customers who use other ST tools in conjunction with TouchGFX so compatibility issues are important.

[RBoud.1]

Very good documentation but I don't know if I missed it. I was hoping when you describe a function in the library, please also suggest which library file (.h) to include as most of the time. it is not obvious or at least for me. it is not.

[Richard Lowe]

Documentation overall is pretty good. Several things are missing that would be helpful. For instance: Looking up the Gradients class you find the basic generated documentation but is lacks any real meaningful explanation on how it is used.

All public functions are lacking any documentation on many of the classes.

I've struggled with TouchGFX for several weeks. Still pulling hair and frustrated on how the engine is assembled and what is called and what isn't. I've been attempting to use TouchGFX with various SPI based displays and to date, I have limited success due to lack of documentation.

[Yoann KLEIN]

Hello,

Thanks for your input, I will let my colleagues know.

If you have other examples of things that should be improved in our documentation, please report.

/Yoann

[ferro]

Hi,

I started to use TouchGFX few days ago and it took me a while to understand that there is only 1 Model for the whole GFX (I come from Qt world so had to readjust to GFX's use of Model concept). I think it would help a lot if this was emphasized in docementation a bit more eg:

 

Or as it is done in this document:

www(dot)e4ds(dot)com/prom/files/Quest_5_Material.pdf

 

Ferro

[Richard Lowe]

I'd really like to see an example with E-Ink displays and any non-traditional displays. Anything that demonstrates the versatility of TouchGFX. At the moment it feels contrary to the description that it is suitable for all displays.

[ferro]

Hi,

In colortype we read that:

"Note that in order to maintain backwards compatibility, casting this type to an integral value will yield a 16-bit value."

Seems as a leftover from older GFX versions(?) as there are no cast operator overloads in v4.21.1 (other than uint32_t)

Ferro

[Bertha]

Hi guys here my experience with touchGFX documentation :

I tried implementing TouchGFX about a year ago, probably version 17. At the time, I could understand the frustration expressed on the forums regarding the old documentation. So, I switched to another library, written in C, which I was able to port with touch features in just a few hours.

Yesterday, for no particular reason, I decided to give TouchGFX another chance and I was pleasantly surprised by the new documentation. It's a big improvement, so big thumbs up to the TouchGFX team for making it better.

Now I feel like I have a good overall picture of TouchGFX, and the small issue I'm facing right now is probably due to my lack of knowledge in C++.

Thanks again for this work

[Osman SOYKURT]

Hello Bertha,

Thank you for your message, I'll pass the word to the team. It's nice to hear you're having a great experience with TouchGFX :)

/Osman