Monday, December 3, 2018

What is new—EB GUIDE Script functions part II

Markus Schnell

Part II of this blog post introduces further EB GUIDE Script functions for reading items from the JSON configuration, versioning, and focus management. Read part I here.

Making the JSON configuration even more powerful

With EB GUIDE 6.5 we added a very powerful JSON configuration that could also be used in custom EB GUIDE TF extensions and applications created by you, the user.

With EB GUIDE 6.7 it is now also possible to retrieve the configuration items in EB GUIDE Script. This opens up a lot of possibilities.

Here are some ideas and benefits that we want to share with you:

* Display the current model configuration and the used renderer

* Read the display size of the scenes and adapting the layout accordingly

* Read the configurations of custom applications and model logic depending on the availability of the items or their values

* Retrieve the names of the plug-ins that are loaded in the core life cycle and in the model life cycle

* Introduce configuration items that can change the behavior of the model without the need to export the model a second time

* Use the JSONImport from the SDK to import a JSON data file and display the data in the EB GUIDE model with just a few lines of code and script

This is the EB GUIDE Script function that you need to retrieve a configuration item:

getConfigItem           fills a data pool item with a configuration item value


And here is a small example on how easy it is to read the height of a scene into a data pool item:


Figure 1: A typical JSON configuration


Figure 2: Reading the configuration item into a data pool item



You can now display the product name and also the version number of EB GUIDE GTF:

getProductString           is the product name of EB GUIDE GTF
getVersionString           is the version number of EB GUIDE GTF


Focus management

Managing the current focused element in a complex HMI can be a quite tedious task. With our focus features and the focus policies it is already a lot easier. Most use cases can be solved out of the box without implementing additional logic in scripts. Nonetheless, we decided to give you another powerful tool to enable you to set the current focused element in a very convenient way. This should help you in keeping your focus management cleaner and enable you to easily model every focus logic of which we can think.

focusMoveTo           forces the focus manager to forward the focus
          to a dedicated focusable element


For a complete reference of all available built-in script functions and their parameters see the user documentation.

An example to create own custom script functions is provided in the SDK examples.


Start modeling now!

As always, we are constantly looking for ways to improve the tool.

Download the latest version of the tool, try it out, and send us your feedback.

Also, don’t forget to visit our Resources section to download examples, review tutorials, and read user documentation.

As always, get in touch with us if you have questions or feedback.