gr application set data

February 22, 2021 16:39

#include <gre/gre.h>                
int gr_application_set_data(
  gr_application_t *app, 
  const char       *key, 
  gr_data_format_t fmt, 
  gr_data_union_t  *data
);

The gr_application_set_data function provides an interface to set a Storyboard data variable. Copies the data into the corresponding data manager key, creating the key if needed.

Parameters: app A pointer to an application handle created using gr_application_create_args. key The data key variable to set fmt The format describing the data argument: GR_DATA_FORMAT_(1s0|1u1|1s1|2u1|...) 1s0 (string) | 4u1 (uint32_t) | 4s1 (int32_t) ... data A pointer to the data to set, this is not a transfer of memory ownership. Returns: Zero on success, -1 on failure.

The gr_application_set_data is a method of setting, creating, and changing data variables which are useable by the Storyboard engine.