User Guide Volume
Total Page:16
File Type:pdf, Size:1020Kb
User Guide Volume III Copyright © 2003 – Criterion Software Ltd. User Guide Contact Us Criterion Software Ltd. For general information about RenderWare Graphics e-mail [email protected]. Developer Relations For information regarding Support please email [email protected]. Sales For sales information contact: [email protected] Acknowledgements Contributors RenderWare Graphics Development and Documentation Teams The information in this document is subject to change without notice and does not represent a commitment on the part of Criterion Software Ltd. The software described in this document is furnished under a license agreement or a non- disclosure agreement. The software may be used or copied only in accordance with the terms of the agreement. It is against the law to copy the software on any medium except as specifically allowed in the license or non-disclosure agreement. No part of this manual may be reproduced or transmitted in any form or by any means for any purpose without the express written permission of Criterion Software Ltd. Copyright © 1993 - 2003 Criterion Software Ltd. All rights reserved. Canon and RenderWare are registered trademarks of Canon Inc. Nintendo is a registered trademark and NINTENDO GAMECUBE a trademark of Nintendo Co., Ltd. Microsoft is a registered trademark and Xbox is a trademark of Microsoft Corporation. PlayStation is a registered trademark of Sony Computer Entertainment Inc. All other trademark mentioned herein are the property of their respective companies. III-2 22 April 2003 Table of Contents Table of Contents Part F - Utility Libraries........................................................................................... 7 Chapter 27 - 2D Graphics Toolkits........................................................................... 9 27.1 Introduction ................................................................................................10 27.1.1 The 2D Toolkit ................................................................................ 10 27.1.2 2D Objects ..................................................................................... 10 27.1.3 The Character Set Toolkit ................................................................. 10 27.2 Using the 2D Toolkit.....................................................................................11 27.2.1 Initialization.................................................................................... 11 27.2.2 Device Abstraction........................................................................... 11 27.2.3 The Current Transformation Matrix .................................................... 12 27.2.4 Paths ............................................................................................. 13 27.2.5 Brushes.......................................................................................... 16 27.2.6 The Current Transformation Matrix .................................................... 17 27.2.7 Fonts ............................................................................................. 19 27.3 2D Objects..................................................................................................22 27.3.1 Introduction.................................................................................... 22 27.3.2 Creating Objects ............................................................................. 22 27.3.3 Adding Objects to a Scene................................................................ 25 27.3.4 Object Serialization.......................................................................... 27 27.3.5 Object Manipulation......................................................................... 27 27.3.6 Object Rendering ............................................................................ 28 27.3.7 Object Destruction........................................................................... 29 27.3.8 Objects .......................................................................................... 29 27.4 The Character Set Toolkit .............................................................................31 27.5 Font File Formats .........................................................................................33 27.6 Summary....................................................................................................37 27.6.1 2D Toolkit ...................................................................................... 37 27.6.2 Rt2dObjects.................................................................................... 38 27.6.3 Character Set Toolkit ....................................................................... 38 Chapter 28 - Maestro ............................................................................................ 39 28.1 Introduction ................................................................................................40 28.1.1 Maestro Overview............................................................................ 40 28.1.2 This document ................................................................................ 42 28.1.3 Other Resources.............................................................................. 42 28.1.4 Using the maestro1 Example ............................................................ 42 28.2 Flash and RenderWare Graphics ....................................................................44 28.2.1 Supported Features ......................................................................... 44 28.2.2 Unsupported Features ...................................................................... 45 28.3 Creating 2D Content for Use Within RenderWare Graphics ................................47 28.3.1 Publishing an SWF ........................................................................... 47 28.3.2 Elements of a User Interface............................................................. 48 RenderWare Graphics 3.5 III-3 User Guide 28.3.3 Virtual Controllers and Console Artwork ............................................. 53 28.4 Importing Flash Files into RenderWare Graphics .............................................. 55 28.4.1 Importing the SWF into RenderWare Graphics .................................... 55 28.4.2 2d Viewer....................................................................................... 56 28.5 Developing With Maestro .............................................................................. 57 28.5.1 Introduction ................................................................................... 57 28.5.2 Playback of an ANM file in RenderWare Graphics ................................. 58 28.5.3 String Labels .................................................................................. 61 28.5.4 Messages ....................................................................................... 63 28.5.5 Hooking a custom message handler................................................... 65 28.5.6 Triggering button transitions by name ............................................... 66 28.5.7 Mouse Interaction on a PC................................................................ 67 28.6 Summary ................................................................................................... 70 28.7 Appendix I – Planning a Menu System............................................................ 71 28.8 Appendix II – Naming Conventions ................................................................ 73 Chapter 29 - The User Data Plugin ........................................................................ 75 29.1 Introduction................................................................................................ 76 29.2 Plugin Features ........................................................................................... 77 29.2.1 User Data Arrays............................................................................. 77 29.3 Storing User Data ........................................................................................ 79 29.3.1 Exporters ....................................................................................... 79 29.3.2 Procedural Generation ..................................................................... 80 29.3.3 Accessing User Data ........................................................................ 81 29.3.4 Deleting User Data .......................................................................... 83 29.4 Summary ................................................................................................... 84 29.4.1 Main Properties ............................................................................... 84 29.4.2 Access functions.............................................................................. 84 29.4.3 Creation......................................................................................... 85 Part G - PowerPipe................................................................................................ 87 Chapter 30 - PowerPipe Overview......................................................................... 89 30.1 Introduction................................................................................................ 90 30.1.1 What is PowerPipe? ......................................................................... 90 30.1.2 Pipelines and Nodes......................................................................... 90 30.1.3 PowerPipe Usage in the Real World.................................................... 91 30.1.4 Other Documents