Storyboard IO example

[jason]

This is a simple example of using StoryboardIO to communicate with an external application. When you hit one of the 4 button on the bottom the main screen the application will send a storyboard IO message to the external application. The external application (weather.c) when it receives the message will then populate the new information on the screen.

Just unzip the attached zip somewhere, then go
file-> import->Storyboard Embedded Engine (GAPP)
And just point it at the gapp file in the root directory of the unzipped archive.

The C source file is in there also (weather.c). This is the build line I use to build it

jason@ubuntu:~$ cc weather.c -L /home/jason/Crank_Software/Storyboard_Engine/linux-x86-sdl-obj/lib -I /home/jason/Crank_Software/Storyboard_Engine/linux-x86-sdl-obj/include/ -l greio -l rt -o weather

- To compile this for QNX drop the -lrt from the compile line.
- If you are running this on Linux you will need mqueue support in the kernel.
- If you want to run this on Windows, you'll want to wait until 1.1 since Storyboard IO will be supported on windows then

[thomas]

Storyboard 1.1 is now available and with it comes a GREIO implementation for our Win32 simulator.

The weather.c file compiles without modification using Visual Studio. All you have to do is add the dependency to libgreio.lib and the paths to the Storyboard Engine headers and libraries, typically something like:

<installroot>\Storyboard Designer\storyboard\plugins\<simulatorid>\resources\sbengine\include
<installroot>\Storyboard Designer\storyboard\plugins\<simulatorid>\resources\sbengine\libs

Where <installroot> is the root of your installation, typically:
C:\Program Files\Crank Software
and <simulatorid> is the plugin id of the simulator, typically:
com.crank.gdt.simulator.runtime.win32_1.1.0.201005210959

This path is a bit out of the way, you'll find the non-simulator platforms in the Storyboard Engine directory.

I've attached a VS project archive that you should be able to use after adjusting the paths for your own installation.

Thomas

[jamiev]

Our image loader does not support gifs on some platforms. I've respun Jason's example to use pngs instead of gifs.

-JamieV

[thomas]

For a bit more of an interactive view of this sample, you can watch the video that walks through the steps of associating the Storyboard IO channel with a user interface action:

http://www.youtube.com/watch?v=jNElexQ9dAI

Thomas

[garryc]

In addition to the above config there is a missing external symbol definition relating to errno if you are using C++ source code format. This is caused by differences in the naming conventions for symbols, firstly between C and C++ files under the Microsoft compiler and secondly between standard libraries of OS platforms.

typical error messages found on link:

Code: Select all

libgreio.lib(multi_data.obj) : error LNK2019: unresolved external symbol errno referenced in function gre_io_add_mdata
libgreio.lib(greio_cemsmq.obj) : error LNK2001: unresolved external symbol errno


The solution below was used to resolve this dependency on Windows CE 6.0R3 under Visual Studio 2008 Pro. The code snipped was added to the VS project within a new include file 'utils.h', which in turn was referenced in '<project path>\sbio_vs_ce\sbio_vs_ce.cpp':

Contents of utils.h

Code: Select all

#ifndef _UTILS_H_
#define _UTILS_H_

#include <errno.h>

// define errno to satisfy unresolved external symbol errno referenced in function gre_io_add_mdata
// extern "C"{ } declaration is essential to ensure matching library dependency definitions
#ifdef __cplusplus
extern "C"{
#endif

#define GRE_IO_NOERROR   0

extern errno_t errno;

#ifdef __cplusplus
}
#endif

#endif /*_UTILS_H_*/

Hopefully this works for you.

PS: The GREIO library requires the system components for MSMQ under WindowsCE so make sure this is included in the Platform Builder catalog for your nk.bin.

Garry

[cguthrie]

Hi all,

I've been trying to get this to run on my pc, just as a starting point for getting used to IO and I am having a terrible time of it. I set up my Crank environment with send and receive handles, I verified that they are the same in the C code as they are in the environment. I put my additional dependencies in both linker and c/c++. When I try to run the C code after launching the simulator I receive a "can't open send handle" failure. I have checked, double checked, and triple checked for spelling errors. Am I missing a step?

Thanks,
Chelsea

[jamiev]

Hello,

We changed the Storyboard IO project name but did not make the channel name change to the weather.c file. This only pertains to the example included with the Designer installation.

In weather.c just change the name of the send channel from this

send_handle = gre_io_open("sbio_example.gapp", GRE_IO_TYPE_WRONLY);
if(send_handle == NULL) {
printf("Can't open send handle\n");
return 0;
}

To this

send_handle = gre_io_open("storyboard_IO.gapp", GRE_IO_TYPE_WRONLY);
if(send_handle == NULL) {
printf("Can't open send handle\n");
return 0;
}

Thanks,

-Jamie