#include <gre/gre.h>
gr_application_t * gr_application_create_args(
const char *bundle,
int flags,
char * const *options,
int option_count
);
The gr_application_create_args function creates the application handle for the Storyboard Engine.
The application handle can be used to further configure the engine or to start it's execution.
Parameters:
bundle A pointer to the model data. This may be a filename or a string based on the flags parameter.
flags One or more GR_APP_* flags that control how the application handle is created
options A pointer to an array of option/value pairs used to initialize the engine or NULL if no options
are provided.
option_count The number of options in the options array, must be even (0, 2, 4, ...)
Returns:
An application handle on success or NULL on failure. On platforms where errno is available, it will contain
failure details.
The gr_application_create_args function will load a model, initialize the engine's plugin subsystem and
then return an application handle. The model can be loaded from a file if the flags are GR_APP_LOAD_FILE
or the model can be loaded from an in-memory block if the flags are GR_APP_LOAD_STRING. Once the
model is loaded and plugins are initialized control returns to the caller.