Crank Storyboard Suite

Crank Software Inc.


                    4017 Carling Ave, Suite 302
                    Ottawa,Ontario,Canada
                    K2K 2A3
                    1.613.595.1999 
                    
                


Table of Contents

I. Crank Storyboard Suite
1. Storyboard Suite Overview
Introduction
Compatibility with Previous Versions
Storyboard Architecture
Graphical Composition Elements
Screens
Layers
Controls
Render Extensions
Events and Actions
Events
Event Naming Conventions
Event Format String
Actions
Action Naming Conventions
Data Variables and the Data Manager
Storyboard Naming Conventions
Control and Layer Data Variables
Control variables
Layer variables
Table variables
Maintaining State and Reacting to Changes
Execution Pipeline
Trigger Event
Action Execution
Focus
Data Change
Display Render
Execution Environment
Animations
Animation Action
Timer Keyframe Animations
Screen Transition Animations
Scripting
External Communication (Storyboard IO)
Performance Considerations
2. Storyboard Designer
Introduction
Designer Environment
Storyboard Designer Workbench
Anatomy of a Storyboard Designer Project
Storyboard Simulator
Storyboard Designer Editor
Editing Content
Editor Toolbar
Storyboard Designer Views
Actions View
Application Model View
Animation Timeline View
Working with Animations
Record Animation
Add Animation
Font Styles View
Images View
Layers View
Navigator View
Outline View
Problems View
Properties View
Templates View
Variables View
Variable Creation
Creating a Storyboard Designer Project
New Storyboard Application
Photoshop PSD File Import
Storyboard Embedded Engine Import
Existing Project Import
Storyboard Designer Development
Simulating and Exporting an Application
Simulating an Application
Exporting to a Storyboard Embedded Engine
Exporting as a Native Android Application
Translation and Internationalization
Working With Templates
Target Configuration
iOS Devices
iOS Developer Account
Code Signing Certificate
Device IDs
Application IDs
Provisioning Profile
User Defined Actions
User Defined Render Extensions
Storyboard Designer Utilities
Design Notes
GoTo Dialog
Storyboard Search Dialog
Resize Storyboard Application
Resource Clean Up Wizard
Consolidate Images Wizard
Trim Images Wizard
Split Images Wizard
Merge Control Images
Collaboration and Team Development
Revision Control System Integration
Comparing and Merging Model Files
Comparing and Merging Projects
3. Storyboard Engine
Introduction
Storyboard Engine Environment
Storyboard Engine
Engine Manager Options
Action Manager
Data Manager
Model Manager
Render Manager
Resource Manager
Screen Manager
IO Manager
Plugins
Animation
Capture/Playback
Audio
Event Redirection
Gesture
Multi-Touch Gestures
Storyboard IO
Logger
Lua
Screen Dump
Screen Path Transition
Screen Scale Transition
Screen 3D Transition
Soft Input/Virtual Keyboard
System
Timer
Linux touchscreen support
Linux input support
QNX input support
Polygon
3D Model rendering
External
Target Configuration
Application Files
Engine Plugins
System Specific Requirements
Linux SDL
Requirements:
Libraries:
Linux FBDEV
Requirements:
Libraries:
Extra Render Manager Options:
Linux DirectFB
Requirements:
Libraries:
Extra Render Manager Options:
Linux OpenVG 1.x
Requirements:
Libraries:
Extra Render Manager Options:
OpenGL ES 2.0
Requirements:
Libraries:
Extra Render Manager Options:
Performance
Neutrino SDL
Requirements:
Libraries:
Neutrino Advanced Graphics
Requirements:
Libraries:
Microsoft WinCE, Compact7
Requirements:
Libraries:
Extra Render Options:
Fujitsu V03
Requirements:
Extra Render Options:
4. Event Definitions
Standard Event Definitions
System Events
gre.init
gre.quit
gre.redraw
Pointer events
gre.press
gre.release
gre.touch
gre.mtpress
gre.mtrelease
gre.inbound
gre.outbound
Keyboard Events
gre.keydown
gre.keyup
Screen Manager Events
gre.screenshow.pre
gre.screenshow.post
gre.screenhide.pre
gre.screenhide.post
Focus Events
gre.gotfocus
gre.lostfocus
Table Events
gre.table.viewport
gre.cell.gotfocus
gre.cell.lostfocus
Plugin Event Definitions
gre.gesture.up
gre.gesture.down
gre.gesture.left
gre.gesture.right
gre.screendump.complete
timer.[name] Timer Events
gre.animate.complete.[name] Animation Events
5. Action Definitions
Built-in Action Definitions
gra.screen
gra.screen.fade
gra.screen.hold
gra.screen.release
gra.sendevent
gra.datachange
gra.screen.focus.set
gra.screen.focus.next
gra.screen.focus.prev
gra.screen.focus.direction
gra.table.scroll
gra.table.resize
gra.table.navigate
gra.log
gra.control.zorder
gra.resource.dump_def
Plugin Action Definitions
gra.lua
gra.animate
gra.animate.stop
gra.audio
gra.greio
gra.perf_state
gra.redirect
gra.screen.path
gra.screen.scale
gra.screen.glswitch
gra.screen.glrotate
gra.screen.glflip
gra.screen.gldoors
gra.screen.gltip
gra.screen.glcube
gra.screendump
gra.timer
6. Render Extension Definitions
Common Render Extension Options
Render Extension Alignment
Fill
Fill Render Extension Options
Polygon
Polygon Render Extension Options
Rectangle
Rectangle Render Extension Options
Image
Image Render Extension Options
Image Alignment
Text
Text Render Extension Options
External
External Render Extension Options
3D Model
3D Model Render Extension Options
7. Scripting with Lua
Lua Function Parameters
Passing Extra Parameters to Functions
Storyboard Lua Integration
Lua Execution Environment
Lua Debugger
Introduction
Configuration
Create a Storyboard Launch Configuration
Enable Lua Debugging
Create the Lua Debug Launch Configuration
Launch the Storyboard Application
Launch the Lua Debug Session
Debugging
Breakpoints
Variables
Stepping, Continuing and Terminating
Storyboard Lua API
gre.SCRIPT_ROOT
gre.set_data
gre.get_data
gre.send_event
gre.send_event_target
gre.send_event_data
gre.greio_disconnect
gre.touch
gre.key_up
gre.key_down
gre.key_repeat
gre.redraw
gre.quit
gre.layer_move
gre.control_move
gre.clone_control
gre.delete_control
gre.get_control_attrs
gre.set_control_attrs
gre.get_layer_attrs
gre.set_layer_attrs
gre.set_layer_attrs_global
gre.get_table_attrs
gre.get_table_cell_attrs
gre.get_string_size
gre.resolve_data_key
gre.load_resource
gre.dump_resource
gre.walk_pool
gre.mstime
gre.env
Storyboard Lua Android Integration
Storyboard Lua Android Integration
Android Lua Java API
Storyboard Lua Android Example
8. Storyboard IO
Connecting to a Storyboard Application
Sending Events to a Storyboard Application
Setting Application Data
Receiving Events from a Storyboard Application
Storyboard IO Utilities
iogen
iorcv
Storyboard IO API
gre_io_add_mdata
gre_io_close
gre_io_free_buffer
gre_io_grow_buffer
gre_io_open
gre_io_receive
gre_io_send
gre_io_send_mdata
gre_io_serialize
gre_io_size_buffer
gre_io_unserialize
gre_io_zero_buffer
9. Optimizing Your Storyboard Application
Choosing the Right Image Format(s)
Frames Per Second
Scaling Images
Reducing Ouput Verbosity
Memory
Measuring Performance
10. Storyboard Software Updates
Automatic Updates
II. Storyboard Design Tutorials
11. Creating a Storyboard Project from a Sample
Creating a New Application using the Storyboard Samples
Import
Import Sample
New Sample Project
12. Creating a 3D Model Application
13. Creating a Multi-Touch Application
14. Crank Public SVN
III. Release Notes
15. Release Notes 3.0
Introduction
Storyboard Designer
Major Changes
iOS Support
Animation Time-line Editor
OpenGL ES Custom Shaders
Language Translation Manager
Non-MMU Device Support
Image Optimization Tools
Minor Changes
Bug Fixes
Existing Feature Enhancements
Known Issues
OpenGL ES running on top of SDL - Linux OpenGL ES only
Runtime Updates
Storyboard Engine
Major Changes
New Runtime Platforms
16. Release Notes 2.1
Introduction
Storyboard Designer
Major Changes
Android Multitouch Support
Table Offset Variables
Minor Changes
Image View Grouping
Image View Filtering
Known Issues
Runtime Updates
Storyboard Engine
Major Changes
New Runtime Platforms
17. Release Notes 2.0
Introduction
Storyboard Designer
Major Changes
3D Modeling
Android Exporting
Consolidating Images
Custom Render Extension / Action Definitions
Minor Changes
Multicontrol / Table Templates
Action Dialogue
Application Model View
Font Editing
Known Issues
Runtime Updates
OpenGL ES
Storyboard Engine
Major Changes
3D
Android
Known Issues
18. Release Notes 1.3
Introduction
Storyboard Designer
Major Changes
Properties View
Drag and Drop in the Application View
Pop-up Preview
Audio
Templates
Resource Clean up
Goto
Minor Changes
Collaboration
PSD Import
Layer Asset Manager
Storyboard Engine
Major Changes
OpenGL ES 2.0
Runtime Updater
Windows Compact 7
Performance Information
Known Issues
19. Release Notes 1.2
Introduction
Storyboard Designer
Major Changes
Mac OS X Support
Collaboration Support with graphical model compare
UI Design Report
Minor Changes
Notes section now available for all model elements
More flexibility with variable selection
Support for offscreen controls
Win32 runtime is now located with all other runtimes
PSD import improvements
New control alignment options
Added recently used sort policy and readable names to action wizard
Strings with comma's or equal signs no longer need to be in a variable
Known Issues
Storyboard Engine
Major Changes
OpenGL ES 1.1
Animation Manager
Internationalization / Unicode Support
Minor Changes
Rotation support for negative numbers
Z co-ordinate for touch events
Keys events under windows all in upper case
gre.send_event_data() supports all data formats
gre.send_event_target()
gre.quit available on WinCE
WinCE and QNX memory optimization
Support for GIF images
Known Issues
20. Release Notes 1.1
Introduction
Storyboard Designer
Major Changes
Linux Host Storyboard Designer
Storyboard Project Merge
Lua Editor Improvements
Lua Debugger (Beta)
Minor Changes
Hot key support
Automatic addition of timer and animation complete events
Action and Variable view sorting and filtering
Animation wizard
Polygon Render Extension
Known Issues
Storyboard Engine
Major Changes
WinCE 6.0 Support for ARMLE
Linux DirectFB Support
Linux OpenVG Support (Beagleboard)
SH4 Support for Linux and QNX6
PPC Support for QNX6
Polygon Render Extension
Minor Changes
liblua.so / dll
Version information
Deployment Bundle (*.gapp) changes
Lua function to calculate string width
Lua function to globally set layer attributes
Lua events
Access control width and height
Move control Z-order
Arbitrary rotation
Screen manager option for available hardware layers
Software cursor support
Layer can now contain variable
Alpha blending for fbdev
Motion events moved to higher verbosity level
Storyboard IO support for Win32
Storyboard IO Channel name option
Load scaled images
Known Issues
Miscellaneous
Minor Changes
License Information
Documentation
IV. Licensing
21. Storyboard End-User License Agreement
22. Crank Software Third Party License Guide
Introduction
Storyboard Designer
Lightweight Java Game Library
Storyboard Engine
Lua
SOIL
Option Parsing
XML Parsing
Imagination OpenGL libraries
FreeType library
Storyboard Engine Platform Specfic Dependencies
All Simple Direct Media Layer (SDL) renderers
SDL
libz
All OpenGL ES 2.0 renderers
libz
All Fujitsu V03 renderers
libz
Fonts
Bitstream Vera
Bitstream Deja Vu
Liberation