Portable Embedded GUI
              Programming Manual
                  Third Printing
                     June 2006
                © Copyright 2004, 2005, 2006, 
              Swell Software, Inc. All rights reserved.
                    © Copyright 2004, 2005, 2006
                       Swell Software, Inc. 
                       2920 Pine Grove Ave
                       Port Huron, MI 48060
                       PH: (810) 982-5955
                       FAX: (810) 982-5949
                      info@swellsoftware.com
         No part of the document may be reproduced in any form without the 
               express written consent of Swell Software, Inc.
                        All rights reserved.
                ®
             PEG  is a registered trademark of Swell Software, Inc.
                   TM
               C/PEG  is a trademark of Swell Software, Inc.
                                                      CHAPTER 0TABLE OF CONTENTS
                                  Forward........................................................................... v
                                  Introduction................................................................... vii
                                             What PEG IS..................................................................... viii
                                             What PEG is NOT..............................................................  ix
                                             Where PEG is going............................................................  x
                                             Library Updates...................................................................  x
                       Chapter 1 
                       Synopsis................................................................................... 1
                                  What C/PEG Is..............................................................  1
                                  What C/PEG Is Not........................................................  2
                                             How C/PEG Works.............................................................. 2
                                             Benefits of using C/PEG...................................................... 2
                                  High Level Overview......................................................  3
                                             Graphics Objects................................................................. 3
                                  Supported Platforms......................................................  5
                       Chapter 2
                       Common Terms and Concepts.............................................. 7
                                  Structured C Architecture ..............................................  7
                                             Structures as Objects.......................................................... 8
                                             Graphical Interface Terminology ....................................... 10
                       Chapter 3
                       C/PEG Programming Reference........................................... 13
                                  Building the C/PEG Library..........................................  13
                                             Pre-configured Build Files ................................................. 23
                       Chapter 4 
                       The C/PEG Execution Model................................................ 27
                                  Overview......................................................................  27
                                             Software Block Diagram.................................................... 28
                                             Program Startup................................................................ 29
                       Chapter 5
                       PegMessageQueue................................................................ 41
                                  PegMessage Definition................................................  42
                                  Signals.........................................................................  49
                       Swell Software, Inc.                   Table of Contents                                                  iii
         Chapter 6 
         PegScreen.............................................................................  53
         Chapter 7 
         Fundamental Data Types.....................................................  59
         Chapter 8 
         The Mighty Thing..................................................................  73
         Chapter 9 
         Programming with C/PEG..................................................  105
                  C/PEG Naming Conventions........................................... 105
                  Source and Header Files................................................. 105
                  Program Startup Review................................................. 106
                  Rules of Memory Ownership........................................... 106
              Creating PegThings...................................................  107
              Removing and Destroying PegThings.......................  109
              Drawing to the Screen...............................................  110
              Determining Drawability.............................................  112
              Object Boundaries.....................................................  113
              Customizing Objects..................................................  114
                  The Object Factory.......................................................... 115
                  Programming Examples.................................................. 123
         iv            C/PEG Programming Manual              Swell Software, Inc.