#include <gre/gre.h> int gr_application_get_data( gr_application_t *app, const char *key, gr_data_format_t *fmt, gr_wrapped_data_t *data );
The gr_application_get_data
function provides an interface to get Storyboard data variables associated with a key, and their formats.
The returned gr_wrapped_data_t
must be freed with gr_application_free_data
.
Parameters: app A pointer to an application handle created using gr_application_create_args
. key The data key variable to get fmt The format describing the format you want the data in: GR_DATA_FORMAT_(1s0|1u1|1s1|2u1|...) 1s0 (string) | 4u1 (uint32_t) | 4s1 (int32_t) ... Can be GR_DATA_FORMAT_UNKNOWN and the original format will be used. data Location to store the returned data, this is a copy of the requested data and its format Returns: Zero on success, -1 on failure.
The gr_application_get_data
function is a method of retrieving the data values and formats for any keys associated Storyboard engine variables.