IwGame Game Engine SDK Programming by Pocketeers Limited IwGame Game Engine SDK Programming v0.36 Developed and maintained by Mat Hopwood of Pocketeers Limited (http://www.pocketeers.co.uk). For support please visit http://www.drmop.com This document is protected under copyright to Pocketeers Limited @2012. Page 1 of 229 IwGame Game Engine SDK Programming by Pocketeers Limited Table of Contents 1.0 IwGame............................................................................................................................................ 1.1 What is IwGame?......................................................................................................................... 1.2 Games Created with IwGame...................................................................................................... 1.2.1 cOnnectiCons....................................................................................................................... 1.2.2 Game of 10........................................................................................................................... 1.2 Installing IwGame........................................................................................................................ 1.3 Usage Rights and Warranties....................................................................................................... 1.4 Brief How To on Using IwGame................................................................................................. 1.5 IwGame Concepts........................................................................................................................ 1.5.1 Standard Class Definitions................................................................................................... 1.5.2 Getters and Setters............................................................................................................... 1.5.3 Init / Release......................................................................................................................... 1.5.4 Singletons............................................................................................................................. 1.5.5 Event Notification................................................................................................................ 1.5.6 XOML Mark-up Language.................................................................................................. 1.5.7 Local and Global Resources................................................................................................ 1.6 Example Code and Tutorials........................................................................................................ 1.7 Known Issues............................................................................................................................... 2.0 CIwGame Object – The Eye in the Sky........................................................................................... 2.1 Introduction.................................................................................................................................. 2.2 Implementing our own CIwGame............................................................................................... 3.0 CIwGameScene Object – A Place for Actors to Play....................................................................... 3.1 Introduction.................................................................................................................................. 3.2 Creating a Scene.......................................................................................................................... 3.3 Virtual Canvas.............................................................................................................................. 3.4 Scene Object Management.......................................................................................................... 3.5 Scene Extents and Clipping......................................................................................................... 3.6 Scene Camera.............................................................................................................................. 3.7 Potential Colliders and Collision Handling................................................................................. 3.8 Current Scene Concept................................................................................................................ 3.9 Actor Management....................................................................................................................... 3.10 Scene Naming and Finding Scenes............................................................................................ 3.11 Scene Layers.............................................................................................................................. 3.12 Scene Origin.............................................................................................................................. 3.13 Scene Visibility and Active State............................................................................................... 3.14 Scene Transitions....................................................................................................................... 3.15 Creating a Scene from XOML................................................................................................... 3.16 Animating Scene Components................................................................................................... 3.17 Creating a Custom Scene........................................................................................................... 3.18 Creating Custom Actions........................................................................................................... 3.19 Augmenting Scenes.................................................................................................................... 4.0 CIwGameActor Object – Sprites With Brains.................................................................................. 4.1 Introduction.................................................................................................................................. 4.2 Creating Actors............................................................................................................................ 4.3 Creating a CIwGameActorImage................................................................................................ 4.4 Text Based Actors........................................................................................................................ Page 2 of 229 IwGame Game Engine SDK Programming by Pocketeers Limited 4.5 Particle System Actors................................................................................................................. 4.6 Actor Lifetimes............................................................................................................................ 4.7 Actor Naming and Finding Actors............................................................................................... 4.8 Actor Types.................................................................................................................................. 4.9 Moving, Rotating and Spinning Actors....................................................................................... 4.10 Attaching a Visual and an Animation Timeline......................................................................... 4.11 Changing an Actors Colour........................................................................................................ 4.12 Obeying Scene Extents.............................................................................................................. 4.13 Actor Layering........................................................................................................................... 4.14 Visibility and Active State......................................................................................................... 4.15 Resetting Actors......................................................................................................................... 4.16 Collision Checking.................................................................................................................... 4.17 Creating an Actor from XOML................................................................................................. 4.18 Animating Actor Components................................................................................................... 4.19 Creating a Custom Actor............................................................................................................ 4.20 Modifying an Actors Behaviour................................................................................................ 5.0 CIwGameString – String Building Without Fragmentation............................................................. 5.1 Introduction.................................................................................................................................. 5.2 Basic String Building................................................................................................................... 5.3 Comparing Strings....................................................................................................................... 5.4 Stream Style Searching...............................................................................................................