Wiley.Games.on.Symbian.OS.A.Handbook.for.Mobile.Development.Apr.2008 (Symbian Books)

Games on Symbian OSA Handbook for Mobile DevelopmentGames on Symbian OSA Handbook for Mobile DevelopmentAuthorsFadi Chehimi, Leon Clarke (Ideaworks3D), Michael Coffey, PaulCoulton, Twm Davies, Roland Geisler, Nigel Hietala, SamMason, Peter Lykke Nielsen, Aleks Garo Pamir and Jo Stichbury(Lead author and editor)ContributorsSam Cartwright (Mobile Developer Lab), Tim Closs(Ideaworks3D), John Holloway (ZingMagic), David MacQueen(Screen Digest), Adam Taylor (Ideaworks3D) and SteveTownsend (Great Ape Software)Reviewed byMichael Aubert, Jan Bonnevier, Sam Cartwright, Martin de Jode,Brian Evans, Toby Gray, Martin Hardman, John Imhofe, MathewInwood, Mark Jacobs, Erik Jacobson, Rob James, Elina Koivisto,Kazuhiro Konishi, Mal Minhas, Ben Morris, Matthew O’Donnell,Matt Plumtree, Lane Roberts, Jesus Ruiz, Hartti Suomela, SteveTownsend, Shawn Van Every and Sally VedrosHead of Symbian PressFreddie GjertsenManaging EditorSatu McNabbCopy EditorLisa VoisinCopyright  2008Published bySymbian Software LtdJohn Wiley & Sons Ltd, The Atrium, Southern Gate, Chichester,West Sussex PO19 8SQ, EnglandTelephone (+44) 1243 779777Email (for orders and customer service enquiries): cs-books@wiley.co.ukVisit our Home Page on www.wileyeurope.com or www.wiley.comAll Rights Reserved.

No part of this publication may be reproduced, stored in a retrieval system or transmitted in any formor by any means, electronic, mechanical, photocopying, recording, scanning or otherwise, except under the terms of theCopyright, Designs and Patents Act 1988 or under the terms of a licence issued by the Copyright Licensing Agency Ltd,90 Tottenham Court Road, London W1T 4LP, UK, without the permission in writing of the Publisher. Requests to thePublisher should be addressed to the Permissions Department, John Wiley & Sons Ltd, The Atrium, Southern Gate,Chichester, West Sussex PO19 8SQ, England, or emailed to permreq@wiley.co.uk, or faxed to (+44) 1243 770620.Designations used by companies to distinguish their products are often claimed as trademarks.

All brand names andproduct names used in this book are trade names, service marks, trademarks or registered trademarks of their respectiveowners. The Publisher is not associated with any product or vendor mentioned in this book.This publication is designed to provide accurate and authoritative information in regard to the subject matter covered. Itis sold on the understanding that the Publisher is not engaged in rendering professional services. If professional advice orother expert assistance is required, the services of a competent professional should be sought.The Publisher and the Author make no representations or warranties with respect to the accuracy or completeness of thecontents of this work and specifically disclaim all warranties, including without limitation any implied warranties offitness for a particular purpose. The advice and strategies contained herein may not be suitable for every situation.

Inview of ongoing research, equipment modifications, changes in governmental regulations, and the constant flow ofinformation relating to the use of experimental reagents, equipment, and devices, the reader is urged to review andevaluate the information provided in the package insert or instructions for each chemical, piece of equipment, reagent, ordevice for, among other things, any changes in the instructions or indication of usage and for added warnings andprecautions. The fact that an organization or Website is referred to in this work as a citation and/or a potential source offurther information does not mean that the author or the publisher endorses the information the organization or Websitemay provide or recommendations it may make.

Further, readers should be aware that Internet Websites listed in this workmay have changed or disappeared between when this work was written and when it is read. No warranty may be createdor extended by any promotional statements for this work. Neither the Publisher nor the Author shall be liable for anydamages arising herefrom.Copyright  2007 Nokia. All rights reserved. Nokia, N-Series, N-Gage QD, N-Gage Arena, Space Impact, Pathway toGlory, High Seize, Pro Series Golf, System Rush: Evolution and Mile High Pinball are trademarks or registered trademarksof Nokia Corporation.Other product and company names mentioned herein may be trademarks or trade names of their respective owners.The Bluetooth  word mark and logos are registered trademarks owned by Bluetooth SIG, Inc.

and any use of such marksby Symbian Software Ltd is under license. Other trademarks and trade names are those of their respective owners.All trademarks and logos that contain Java are trademarks or registered trademarks of Sun Microsystems, Inc. in theUnited States and other countriesOther Wiley Editorial OfficesJohn Wiley & Sons Inc., 111 River Street, Hoboken, NJ 07030, USAJossey-Bass, 989 Market Street, San Francisco, CA 94103-1741, USAWiley-VCH Verlag GmbH, Boschstr. 12, D-69469 Weinheim, GermanyJohn Wiley & Sons Australia Ltd, 42 McDougall Street, Milton, Queensland 4064, AustraliaJohn Wiley & Sons (Asia) Pte Ltd, 2 Clementi Loop #02-01, Jin Xing Distripark, Singapore 129809John Wiley & Sons Canada Ltd, 6045 Freemont Blvd, Mississauga, Ontario, L5R 4J3, CanadaWiley also publishes its books in a variety of electronic formats.

Some content that appearsin print may not be available in electronic books.British Library Cataloguing in Publication DataA catalogue record for this book is available from the British LibraryISBN: 978-0-470-99804-5Typeset in 10/12pt Optima by Laserwords Private Limited, Chennai, IndiaPrinted and bound in Great Britain by Bell & Bain, GlasgowThis book is printed on acid-free paper responsibly manufactured from sustainable forestryin which at least two trees are planted for each one used for paper production.ContentsForewordsixAbout this BookxiiiAbout the AuthorsxviiEditor’s AcknowledgementsxxiiiPart One: A Symbian Perspectiveon Mobile Games1 Introduction1.11.21.31.41.51.61.71.81.91.101.111.121.131.14Why Games?What Is Symbian? What Is Symbian OS?Some StatisticsGames Platforms ComparedTypes of Mobile GamesWho Plays Mobile Games?Who’s Who in Mobile Game Creation?Mobile Game Distribution: Routes to MarketThe User ExperienceMobile Game PlatformsPortability and CompatibilitySmartphone CharacteristicsThe Future for Games on Symbian SmartphonesSummary11261013161720252732373840viCONTENTSPart Two: Creating Native Gameson Symbian OS v92 Symbian OS Game Basics2.12.22.32.42.52.62.72.82.9IntroductionThe Game LoopThe Heartbeat TimerHandling Input from the KeypadHandling Input from the ScreenSystem EventsMemory Management and Disk SpaceMaths and Floating Point SupportTools and Further Reading3 Graphics on Symbian OS3.13.23.33.43.53.63.73.83.93.103.113.123.133.14IntroductionOverviewOn Frame RateAbout Display MemoryA Primer on Drawing on Symbian OSDirect Screen AccessDouble Buffering and Anti-TearingPixel Color RepresentationsLoading and Manipulating ImagesScaling for Variable Screen Sizes and ResolutionsRendering TextPlaying Video ClipsLess Useful APIsSummary4 Adding Audio to Games on Symbian OS4.14.24.34.44.54.6IntroductionMultimedia Framework (MMF)Sound EffectsBackground MusicBest Practice in Mobile Game AudioWhat’s Next?5 Multiplayer Games5.15.25.35.4IntroductionLocal Multiplayer Games Over a BluetoothConnectionOnline Multiplayer GamesAirplay Online: A Multiplayer SDK and ServiceSolution4343434649525457596061616264676875839097105111115121121123123124128142150151157157159160165CONTENTS5.55.65.7N-Gage ArenaOther Online Multiplayer SolutionsFurther Reading6 Exploiting the Phone Hardware6.16.26.36.46.56.66.7IntroductionCameraLocation3D Motion SensorsVibrationSummaryAcknowledgementsvii171174174175175178188198207216216Part Three: Porting Games to Symbian OS7 C/C++ Standards Support for Games Developerson Symbian OS7.17.27.37.47.57.67.77.87.97.107.11P.I.P.S.

Is POSIX on Symbian OSOpen COpenKODEOpenVGOpenMAXOpenSL ESEGLOpenGL ESGet Your FixEnough Already!Further Reading8 The N-Gage Platform8.18.28.38.48.58.6A Brief History of N-GageN-Gage Platform: The Next Generation of MobileGamingThe N-Gage SDKThe N-Gage ApplicationBecoming an N-Gage DeveloperSummary217217220224227228229230231234236237239239244248256262264viiiCONTENTSPart Four: Java ME, DoJa and Flash Liteon Symbian OS9 MIDP Games on Symbian OS9.19.29.39.49.59.69.79.89.99.109.119.12IntroductionJava ME 101To Java ME or Not To Java ME?Tools and SDKsWhat About MIDP on Symbian OS?Pausing for BreathLiving it UpGame ArchitectureCase Study: Third DegreeDid You Hear That SNAP?And Another Thing .

. .Further Reading10 Games In Japan10.110.210.310.410.510.610.710.810.9265265265270271272274277280282289293294297IntroductionThe Japanese MarketEnter DoJa!DoJa 2.5 OverviewPorting MIDP to DoJaDoJa and EclipseMascotTokyo TitlesAt The End Of The Day29729729930231031331631831911 Flash Lite Games on Symbian OS32111.111.211.311.411.5IntroductionFlash Lite on Mobile PhonesFlash Lite OverviewFlash Lite Development ToolsFlash Lite Ecosystem321323324329335References and Resources337Appendix: Airplay341Index351ForewordTim Closs, Chief Technology Officer, Ideaworks3D LtdThe mobile phone is not primarily a platform for playing games, andSymbian OS is not primarily a platform for writing games.