TweetFollow Us on Twitter

Apr 02 Palm OS

Volume Number: 18 (2002)
Issue Number: 04
Column Tag: Handheld Technologies

TicTacPalm

by Danny Swarzman

Getting started with Palm OS

Preface

Developing a Palm OS application comes naturally to a Mac programmer. You find familiar notions like resources, handle-based memory and an event loop. You can use CodeWarrior for Palm OS as the development environment.

This article presents a simple Palm OS application, TicTacPalm, which illustrates the main features of a Palm OS application. This application simply plays tic tac toe against the user.

The Palm OS Environment

The Palm Device

The Palm Operating System, Palm OS, is used in a growing number of products made by different manufacturers including Palm, Handspring and Sony.

The screen is typically divided into a 160x160 pixel display area, although at least one new device has a slightly longer screen. (Remember when Inside Macintosh admonished developers not to make assumptions about a fixed screen size? That advice holds true for Palm OS as well.) An application can detect stylus activity in this area. The stylus can also be used to enter characters in Palm's custom cursive writing system, graffiti, in the area just below the display. All stylus taps enter the system event queue as discrete pen events, similar to the mouse events you are familiar with in Mac OS. The graffiti input comes in the form of graffiti events.

Applications are loaded into the device by the synchronizing with a desktop computer through a serial port or IR communication. This is the standard way for a Palm device user to install your program. Some types of programs may be downloaded via a network connection, but we won't consider that approach here.


Figure 1. A typical Palm device. The Application Launcher program provides the equivalent of a "desktop" on a Palm Device.

Launching and Running Applications

The device shown in Figure 1 is displaying the equivalent of a desktop. Tapping an icon brings an application to the front. From the user's point of view, all applications are always running. When an application is brought to the front, it looks exactly like it did the last time it was in front.

An application must give up its temporary memory and close down each time another application comes to the front. The closing application can store information about the partially completed document or transaction prior to closing. Later, when the application is activated again it can read the stored information and restore the program state. A special database is used for this purpose, the preferences. There are functions in the API designed specifically for reading and writing preferences, greatly simplifying the task.

Forms

Like a window on a desktop system, a Palm OS Form object occupies an area of the screen. Due to the small screen sizes on current devices, many forms use the entire visible area. An application may have several forms and switch between them in response to user actions. At any given time, one form is in front and interacting with the user.

In Palm OS parlance, a window is any entity in which drawing occurs. Both forms and offscreen bitmaps are windows. Offscreen bitmaps allow you to create a composite image and then transfer it flicker-free to the screen.

Using Constructor, the GUI design tool included with CodeWarrior for Palm OS, you can create forms and populate them with controls. Controls include buttons, checkboxes, lists, etc. Each control is identified by a symbol or name that you specify. Each name will be included in the auto-generated resource file along with a numeric equate. For example, suppose you have a button named New on the form named GameBoard. In the generated header file, Constructor inserts a #define for the symbol GameBoardNewButton. Its value is the numeric ID of the button. Using the symbol (and not the numeric value) in your source code makes the code easier to read and understand.

Controls and Gadgets

Controls include interface elements such as buttons, labels, fields, etc. For most controls, there is a standard behavior provided by the OS. The exception is the gadget. The application defines a gadget's behavior, responding when the stylus enters its area and drawing its contents. Most of the time you can use the pre-built controls, and use gadgets only when custom appearance or behavior is required.

Memory

Palm OS uses a handle-based memory management system. These handles can't be treated as pointers to pointers, as is done in Mac OS. Instead, to reference data a program first locks a handle. The handle-locking function returns a pointer to the data. You can then use the pointer to transfer data to or from the area. Remember to unlock the handle when you are done using it, or heap fragmentation may result. This becomes even more of an issue on older devices with less memory. If you are aiming for compatibility with older devices and/or older versions of Palm OS, take a close look at the available dynamic heap space versus your program's requirements. The issue exists in a less severe form on modern devices and versions of the operating system.

Events

The operating system maintains a queue of events. Whenever the system requires the services of an application that has been launched, it sends events to the application.

For many events there is a standard response. When the user presses the stylus on the menu bar, the sequence of stylus events is interpreted as a menu command. The menu command then becomes a new event that is placed in the queue.

Some events will appear in your application's event handler, but are really intended for the system. You can ensure that your application hands events to the appropriate Palm OS functions by retaining the AppEventLoop exactly as provided in the Starter.cpp , part of the template code that is generated when you build a new project.

Everything relating to your application from launch to "shutdown" will arrive in the form of events. For example, at launch time an application-defined function, called from the main event loop, processes a request to load a form. That function assigns a callback function to the form to assist in the handling of events occurring in controls in that form. Once the form is loaded the callback function handles subsequent events.

A gadget, the custom user interface object discussed earlier, can have a callback function too. The application assigns a callback to each gadget when the form is opened. This is how a gadget responds to system requests to draw itself, and to handle taps in the gadget.

Developing for Palm OS

CodeWarrior and Alternatives

The vast majority of applications are developed using CodeWarrior However, the official Palm SDK, available on the Palm web site, works with many development environments. Other tools that are available to create Palm applications include a gnu compiler and a translator from Java bytecode to assembler for the handheld.

The sample code in this article was developed using CodeWarrior for Palm OS, Version 7. It comes with everything you need to develop for Palm OS 3.5, including the Palm SDK and related documentation. Current devices run Palm OS 3.5 and Palm OS 4.0, although with proper attention to detail you can build an application supporting earlier versions of the operating system.

The CodeWarrior package includes two disks - one to develop on the Mac, one to develop on Windows. The sample code accompanying this article was developed on the Mac.

Creating a Project

Use the New command from the File menu. In the dialog that appears, enter a name for the new project and choose Palm OS 3.5 Stationary.


Figure 2. Creating the project in CodeWarrior.

A second dialog will appear, giving you a few choices for the template project. For the sample code, Palm OS C++ App was used. CodeWarrior then generates a ‘Starter' project. This project produces a do-nothing application to use as a framework on which to build. You need to rename some things if your project's name isn't to be ‘Starter'. I just replaced every ‘Starter' occurrence with ‘TicTacPalm' in the code, file names, etc.

Constructor

Constructor for Palm is an interactive resource editor included with CodeWarrior for Palm. Constructor creates a collection of resources that contribute to the appearance of the application, including menus, forms and icons. In addition to editing a resource file, Constructor generates a header file that defines symbols for all the resources in the resource file.


Figure 3. The Constructor project window.

Debugging, Simulator and POSE

A Palm application can run in one of these environments:

  • the Palm Operating System Emulator (POSE)
  • the Simulator
  • the device itself

The sample project, like the Starter project has two targets: TicTacPalm and TicTacPalmSim.

TicTacPalm generates a Palm OS application that can be run in POSE or on an actual device. CodeWarrior provides a Palm OS debugger to step through the object code for this target.

For the TicTacSim target, a collection of simulator libraries is included in the project. When the project is built, a MacOS application is created. CodeWarrior's MacOS debugger can be used to step through this application. This is the easiest way to debug. There are limitations to this approach in that you don't have access to other applications or permanent data, which is not significant for our game project, but may be an issue for more complex applications.

There are a couple of strange rituals that you need to follow when using the simulator. The first time you run a program with the simulator, a dialog asks you to find the resources file. You must locate :CW for Palm OS Platform 7.0:Metrowerks CodeWarrrior:Palm OS Support:Simulator:SystemResources. You may notice that the simulator window sticks to the menu bar on your screen. To fix that, remove the Palm OS Simulator Preference file from the System Folder's Preferences subfolder. You only need to do these things once or twice when you are first using the product.

Most of the time, POSE is the preferred debugging platform. POSE is a desktop application that emulates the entire Palm OS device. It allows you to switch between applications, and even retain information between runs. You set up POSE to emulate a particular Palm OS device by copying the ROM from your device or by getting the ROM file for another device from the Palm web site. The POSE application must be running when you run the TicTacPalm target. Use the CodeWarrior debugger for Palm OS with this target.

Debugging while running on the device itself is possible but less convenient. It wasn't needed for the sample application. When the code works in simulation, load the .prc file onto the device as you would any Palm application.

User's View of TicTacPalm

Forms

TicTacPalm includes these forms:

  • Game Board
  • Game Info
  • About

Most of the action occurs on the game board (see Figure 4). The user taps on a square to make an ‘X' move. The program responds by playing an ‘O'. There are two buttons: New causes the Game Info dialog to be displayed, while Clear erases all the plays.


Figure 4. The game board.

The game information form has one field for the user to enter a name for the game. There is an OK button and a Cancel button. OK starts a new game with the name in the name field. Cancel returns to the game board without altering the name or the position.


Figure 5. Game info form.

The About form is a modal dialog that appears in response to the About menu command.


Figure 6. The About form.

Inside TicTacPalm

Source Files

The source files are organized into three subgroups:

  • Application
  • User Interface
  • Game


Figure 7. The TicTacPalm Project.

Application

When you generate a project using the project stationary, one of the files, Starter.cpp, contains the main program for the application. In the sample application, Starter.cpp is replaced by TicTacPalm.cpp. It has seven functions:

  • AppHandleEvent
  • AppStart
  • AppStop
  • RomVersionCompatible
  • AppEventLoop
  • TicTacPalmMain
  • PilotMain

The contents of the first three are new in TicTacPalm.cpp. Of the other four, only TicTacPalmMain has been changed from the original StarterMain in Starter.cpp. One line of StarterMain has been commented out.

   FrmGotoForm ( MainForm );

In the sample application, the first form is loaded in AppStart rather than the main program.

Three variables of file scope are defined in TicTacPalm.cpp. Their referenced objects are created in AppStart and deleted in AppStop. They are:

static CGameBoardForm *fGameBoardForm = NULL;
static CGameInfoForm *fGameInfoForm = NULL;
static CTicTacGame *fGame = NULL;

The first two handle the two different forms. The game object contains all the data about the current game that is in dynamic RAM. Each of the form objects is initialized with a pointer to the game.

AppStart
// static 
Err AppStart(void)
{
   UInt16 prefsSize;
   TicTacPalmPreferenceType preferences;
 
   // Read the saved preferences / saved-state information.
   fGame = new CTicTacGame ();
   fGameBoardForm = new CGameBoardForm( fGame );
   fGameInfoForm = new CGameInfoForm ( fGame );

   prefsSize = sizeof(TicTacPalmPreferenceType);
   if (PrefGetAppPreferences(appFileCreator, appPrefID,
       &preferences, &prefsSize, true) != noPreferenceFound)
   {
      fGame->SetPrefs ( &preferences );
   }
   // Display the first form.
   FrmGotoForm ( fGame->GetForm() );      
   return errNone;
}
Listing 1. AppStart

The preferences record stores information used to reconstruct the last state of the program so that it will appear to the user that the program wasn't interrupted at all. If there is no preferences record to read, a default preferences record is constructed.

AppStart creates fGame and initializes it with the values in the preferences. It then brings forward a form, chosen according to the last state of the application as recorded in the preferences.

AppHandleEvent
// static 
Boolean AppHandleEvent(EventPtr eventP)
{   
   return eventP->eType == frmLoadEvent && 
      LForm :: Load ( eventP->data.frmLoad.formID );
}
Listing 2. AppHandleEvent

AppHandleEvent sends the load event to the LForm class (which is discussed later).

AppStop
// static 
void AppStop(void)
{
   FrmCloseAllForms ();
    TicTacPalmPreferenceType preferences;
   fGame->GetPrefs ( &preferences );
   PrefSetAppPreferences (appFileCreator, appPrefID,
       appPrefVersionNum, &preferences, 
      sizeof (preferences), true);
   
   if ( fGameBoardForm )
      delete fGameBoardForm;
   if ( fGameInfoForm )
      delete fGameInfoForm;
   if ( fGame )
      delete fGame;
}
Listing 3. AppStop

When the application receives a stop event, AppStop saves into the preference record the state of things as recorded in gGame, and deletes the objects that were created in AppStart.

Supporting Forms

Associated with an active form is a callback function that processes events sent to the form. The classes CGameBoardForm and CGameInfoForm handle events for the two types of forms. These classes are subclasses of LForm.

LForm :: DispatchEvent
// static
Boolean LForm :: DispatchEvent ( EventType *inEvent )
{
   //   Identify the event type and respond to it accordingly.

   Boolean handled = false;
   if ( sActiveLForm )
      switch ( inEvent->eType )
      {
         case frmOpenEvent :
            // Do follow up after open event
            FrmDrawForm ( FrmGetActiveForm() );
            handled = sActiveLForm->Open();
            break;
         case frmCloseEvent :
            // Close stuff before closing if necessary
            handled = sActiveLForm->Close();
            break;
         case menuEvent :
            handled = sActiveLForm->
               DoCommand ( inEvent->data.menu.itemID, NULL );
            break;   
         case ctlSelectEvent:
            handled = sActiveLForm->
               DoSelect ( inEvent->data.ctlSelect.controlID, 
                  NULL );
            break;
         default :
            handled = false;
            break;
      }
   return handled;
}
Listing 4. LForm::Dispatch Event
   LForm :: Load

// static
Boolean LForm ::    Load ( UInt16 inFormID )
// 
// The Palm OS has requested that a form be loaded.
// If the form can be loaded, mark the appropriate
// LForm
{
   Boolean handled = false;
   FormPtr formPointer = FrmInitForm ( inFormID );
   if ( formPointer )
   {
      sActiveLForm = IDToLForm ( inFormID );
      if ( sActiveLForm )
      {
         FrmSetActiveForm ( formPointer );
         FrmSetEventHandler ( formPointer, &DispatchEvent );
         handled = true;
      }
   }
   return handled;
}
Listing 5. LForm::Load

When the system function FrmGotoForm is called to switch forms, the application sends the function to the class function, LForm::Load. That function finds the LForm object that will handle the form according to the ID requested. It establishes the event handler for that class as the handler for form events.

When events arrive for a form, the class function LForm::DispatchEvent, sends the event to one of the virtual functions, DoCommand, DoSelect, Open or Close. Subclasses need only override these functions.

Game Board Form

This form displays the name of the current game, the playing surface and two buttons. One button clears the board. The other switches to the game information form.

CGameForm::Open
// virtual
Boolean CGameBoardForm :: Open ()
{
   // Set up all the gadgets as CSquareGadget objects
   FormPtr form = FrmGetActiveForm();
   UInt16 numberOfObjects = FrmGetNumberOfObjects ( form );
   for ( UInt16 j = 0; j < numberOfObjects; j++ )
   {
      FormObjectType *objectPointer = 
         (FormObjectType*)FrmGetObjectPtr( form, j );
   FormObjectKind objectKind = FrmGetObjectType ( form, j );
      if ( objectKind == frmGadgetObj )
      {
         FormGadgetType *gadget = (FormGadgetType*)objectPointer;
   CSquareGadget *squareGadget = new CSquareGadget ( mID, j,
            gadget, mGame );
      }
   }
   GameNameType gameName;
   mGame->GetName ( gameName );
   SetFieldText ( GameBoardGameNameField, gameName );
   FrmDrawForm ( form );
   
   // Also mark the game that this form is active.   
   mGame->SetForm ( GameBoardForm );
   return true;
 }
Listing 6. CGameBoardForm::Open

Open creates a collection of objects to handle the gadgets that will be used in the form. These objects are not deleted in CGameBoardForm. They delete themselves as we'll see in the section on gadgets.

The list of controls in the form is scanned to find controls that are gadgets. As each gadget is found, a LgameSquareGadget object is created to handle its events.

CGameBoardForm::DoSelect
// virtual
Boolean CGameBoardForm :: DoSelect ( UInt16 inCommand, void */*inParam*/ )
{
   Boolean handled = false;
   switch ( inCommand )
   {
      case GameBoardClearButton:
         mGame->Clear();
         FormPtr activeForm = FrmGetActiveForm();
         FrmDrawForm ( activeForm );
         handled = true;
         break;
      case GameBoardNewButton:
         FrmGotoForm(GameInfoForm);
         handled = true;
         break;         
   }   
   return handled;
}
Listing 7. CGameForm::Open

DoSelect handles the two buttons: Clear and New. For the Clear button, it just tells the game object to clear its data and then redraws the form. FrmDrawForm will call the gadget handlers to do the drawing. The gadget handlers will then retrieve any needed data from the game object as part of the redraw operation.

GameInfoForm

With this form the user enters a name for the game. When the user taps on the OK button, the current game is cleared and a new game is started and control is switched to the game board form. If the user taps Cancel, control also returns to the game board form, but the name is not changed and the game resumes.

The user could also switch to another application. In that case, the name field is restored as it was, with a name that the user has changed, but not confirmed by tapping OK.

CGameInfoForm :: Open
// virtual 
Boolean CGameInfoForm :: Open()
{
   // Inform the game that the info form is active.
   mGame->SetForm ( GameInfoForm );

   GameNameType name;
   // If the last open form was a game info form then use the name 
   // that appeared on that form.
   mGame->GetUnconfirmedName ( name );
      
   // Otherwise use the name of current game.
   if ( StrLen ( name ) == 0 )
      mGame->GetName ( name );
   mGame->SetUnconfirmedName ( name );
   SetFieldText ( GameInfoNameFieldField, name );
   FieldType *field = GetField ( GameInfoNameFieldField );
   FldDrawField ( field );

   mOKWasPressed = false;
   mCancelWasPressed = false;
   return true;
}
Listing 8. CGameInfoForm::Open

If the form was replaced because the user changed applications, then an unconfirmed name is stored in the game object and the unconfirmed name will be loaded into the field. Otherwise, the name of the current game will be loaded into the field.

CGameInofForm::Close
// virtual 
Boolean CGameInfoForm :: Close()
{
   GameNameType name;
   if ( mCancelWasPressed )
      // Don't care about what was in the field.
      mGame->SetUnconfirmedName ( "" );
   else
   {
      if ( GetFieldText ( GameInfoNameFieldField, name ) )
         if ( mOKWasPressed )
         {
            mGame->Clear();
            mGame->SetName ( name );
            mGame->SetUnconfirmedName ( "" );
         }
         else // switched applications
            mGame->SetUnconfirmedName ( name );
   }
   // Return false to tell the OS to clean up the form
   // in the usual way after we have extracted the info.
   return false;   
}
Listing 9 CGameInfoForm::Close

Close sets the name and unconfirmed name fields in the game according to two flags: mOKWasPressed and mCancelWasPressed.

CGameInfoForm::Open
// virtual
Boolean CGameInfoForm :: DoSelect ( UInt16 inCommand, void */*inParam*/ )
{
   Boolean handled = false;
   switch ( inCommand )
   {
      case GameInfoOKButton:
         mOKWasPressed = true;
         FrmGotoForm(GameBoardForm); 
         handled = true;
         break;
      case GameInfoCancelButton:
         mCancelWasPressed = true;
         FrmGotoForm(GameBoardForm);
         handled = true;
         break;         
   }
   return handled;
}
Listing 10 CGameInfoForm::DoSelect

DoSelect sets the appropriate flags according to which button was pressed. It then switches to the game board form.

A Gadget for a Square

Instead of handling events as is done for forms, a gadget callback handles commands. One type of command is an event command. So you need two levels of dispatch: one at a higher-level for events, and one at a lower-level for commands.

In TicTacPalm, there is a gadget for each of the nine squares in the game board. The class LGadget handles the dispatch. Its subclass, CSquareGadget contains the code to respond to actions.

The Palm data type for gadgets contains a field for application defined data. Unfortunately, the argument passed to the handler is a pointer to an opaque structure. Palm documentation warns you not to directly access its fields. But they don't provide the accessor functions needed to conveniently get the application data, making the data field unusable. In Palm OS 4.0 an accessor function was added but it doesn't work with all the commands that may be sent to the handler.

The workaround is to search all the gadgets looking for a matching pointer.

LGadget::LGadget
LGadget ::   LGadget ( UInt16 inFormID, UInt16 inGadgetIndex,
   FormGadgetType *inGadget )
: mFormID ( inFormID ), mGadgetIndex ( inGadgetIndex ), 
   mGadget ( inGadget )
{
   FormType *formPointer = FrmGetFormPtr ( mFormID );   
   FrmSetGadgetHandler ( formPointer, 
mGadgetIndex, &DispatchCommand );
   mPrevious = sLast;
   sLast = this;
}
Listing 11. LGadget::LGadget

The constructor stores a pointer to the data structure for the form and sets a class function of LGadget to be the handler.

LGadget.cpp
// static
Boolean LGadget :: DispatchCommand ( FormGadgetType *inGadget, 
   UInt16 inCommand, void *inParam )
{
   Boolean success = false;
   LGadget *lGadget = FindLGadget ( inGadget );   
   success = lGadget && lGadget->DoCommand ( inCommand, inParam );
   return success;
}
Listing 12. LGadget::DispatchCommand

DispatchCommand is the class function that receives the command. It finds the LForm object to handle that command.

LGadget::DoCommand
Boolean LGadget :: DoCommand ( UInt16 inCommand, void *inParam )
{
   Boolean handled = false;
   switch ( inCommand )
   {
      case formGadgetDrawCmd :
         Draw();
         mGadget->attr.visible = true;
         handled = true;
         break;
      case formGadgetHandleEventCmd :
         handled = HandleEvent ( (EventType*)inParam );
         break;
      case formGadgetDeleteCmd :
         delete this;
         handled = true;
         break;
      case formGadgetEraseCmd :
         handled = false;
         break;
      default :
         handled = false;
         break;
   }
   return handled;
}
Listing 13. LGadget::DoCommand

DoCommand determines the type of command and forwards it along. The delete command gets sent immediately before the enclosing form gets deleted. This handler deletes the LForm object in response.

         LGadget::HandleEvent 
Boolean LGadget :: HandleEvent ( EventType *inEvent )
{
   Boolean handled = false;
   switch ( inEvent->eType )
   {
      case frmGadgetEnterEvent :
         // A pen down event has been passed to the form.
         handled = true;
         Tapped();
         break;
      case frmGadgetMiscEvent :
         // The application, not the system generates
         // this event. Not used in the sample code,
         // include to allow for future modifications.
         handled = false;
         break;
      default :
         // Should never get here.
         handled = false;
         break;
   }
   return handled;
}
Listing 13. LGadget::HandleEvent

CSquareget

For each of the squares in the game there is a gadget. For each gadget there is an LSquareGadget object. Squares are numbered 0 through 8. When the user taps a game square, Tapped checks if the square is empty and tries to play an X at that location. It displays the current object and then tells the LSquareGadget object corresponding to the O response to draw itself.

Images of the X and O characters, and an empty field image, are stored as bitmaps. Draw copies the appropriate bitmap to the active form.

CSquareGadget::CSquareGadget
CSquareGadget ::   CSquareGadget( UInt16 inFormID, 
   UInt16 inGadgetIndex, FormGadgetType *inGadget, CTicTacGame *inGame )
: LGadget ( inFormID, inGadgetIndex, inGadget )
{
   FormPtr form = FrmGetFormPtr ( inFormID );
   UInt16 objectID = FrmGetObjectId ( form, inGadgetIndex );
   mGame = inGame;
   mSquare = SquareNumber ( objectID );
   sSquareGadget[mSquare] = this;
}
Listing 14. CSquareGadget::CSquareGadget

The constructor uses the object ID of the gadget to determine the number of the square. That is the number that will be used in the game logic to interpret the play.

CSquareGadget::Draw
// virtual
void CSquareGadget :: Draw ()
{
   Coord x;
   Coord y;
   FormType *formPointer = FrmGetFormPtr ( mFormID );
   FrmGetObjectPosition 
      ( formPointer, mGadgetIndex, &x, &y );
   UInt16 bitmapID = EmptySquareBitmap;
   PlayerT contents = mGame->Get ( mSquare );
   switch ( contents )
   {
      case kX :
         bitmapID = XBitmap;
         break;
      case kO :
         bitmapID = OBitmap;
         break;
      case kPlayerEmpty :
      default:
         bitmapID = EmptySquareBitmap;
         break;
   }
   MemHandle resource = DmGetResource 
      ( bitmapRsc, bitmapID );
   BitmapPtr bitmapResource = 
      (BitmapPtr)MemHandleLock ( resource );
   Err error = DmGetLastErr();
   if ( !error && bitmapResource )
   {
      WinDrawBitmap ( bitmapResource, x, y );
      error = MemHandleUnlock ( resource );
      DmReleaseResource ( resource );
   }
}
Listing 15. CSquareGadget::Draw

The content of the square is determined from the game object. According to the content, select a resource with the X, O or blank bitmap.

CSquareGadget::Tapped
// virtual
void CSquareGadget :: Tapped ()
{
   UInt16 oResponse = kNoPosition;
   if ( mGame && mGame->Get ( mSquare ) == kPlayerEmpty )
   {
      oResponse = mGame->PlayX ( mSquare );
      Draw();
   }
   if ( oResponse != kNoPosition )
   {
      CSquareGadget *cSquareGadget = 
         sSquareGadget[oResponse];
      cSquareGadget->Draw();
   }
}
Listing 16. CSquareGadget::Tapped

When the user taps on a game square, this function responds by displaying an X. It gets the next O move from the game object and calls the draw function for the CSquareGadget for that square.

Conclusion

Developing for the Palm is easy to do with CodeWarrior and POSE. The Palm OS is continually evolving and making many housekeeping chores easier, such as improved bitmap support. Right now, the API reminds me of the early days of Macintosh. The application programmer must be concerned with a lot of messy details. I find that I miss having an application framework and feel the need to head in that direction.

The need to be able to fold up the tent whenever the user switches applications adds an interesting twist to the job of programming for the Palm OS. Here, too, an application framework would come in handy.

TicTacPalm is a fairly simple application. Additional features might include the ability to store and recall games, beam games between devices, and back games up to a desktop machine. Feel free to use the code presented here as the basis for writing an improved version of TicTacPalm, or possibly some other game.

References

The Palm web site contains tons of information and links to related sites.

http://www.Palm OS.com/dev/

To register a creator code just click on the list item Creator ID. As on Mac OS, creator IDs uniquely identify applications.

The documentation in the Palm SDK is fairly good. There is a Reference manual and a Programmers' Guide. Some third-party books on Palm programming are available. Palm Programming by Neil Rhodes and Julie McKeehan is a good introduction, though the material in it is quite dated.

Metrowerks has a demo version of CodeWarrior for Palm that you can use to get started, available at:

http://www.metrowerks.com/products/palm/demo

There is a free online course in Palm programming offered by Metrowerks. It's at:

http://www.codewarrioru.com/CodeWarriorU

Credits

Thanks to Victoria Leonard for graphic resources. Thanks to Bob Ackerman and Victoria Leonard for reviewing the text.


Danny Swarzman writes programs in JavaScript, Java, C++ and other languages. He also plays Go and grows potatoes. Contact him with comments and job offers. dannys@stowlake.com, http://www.stowlake.com

 
AAPL
$524.94
Apple Inc.
+5.93
MSFT
$40.01
Microsoft Corpora
-0.39
GOOG
$536.10
Google Inc.
-20.44

MacTech Search:
Community Search:

Software Updates via MacUpdate

Tweetbot 1.5.1 - Popular iOS twitter cli...
Tweetbot is a full-featured OS X Twitter client with a lot of personality. Whether it's the meticulously-crafted interface, sounds and animation, or features like multiple timelines and column views... Read more
Mac DVDRipper Pro 4.1.7 - Copy, backup,...
Mac DVDRipper Pro is the DVD backup solution that lets you protect your DVDs from scratches, save your batteries by reading your movies from your hard disk, manage your collection with just a few... Read more
PDFpenPro 6.2 - Advanced PDF toolkit for...
PDFpenPro allows users to edit PDF's easily. Add text, images and signatures. Fill out PDF forms. Merge or split PDF documents. Reorder and delete pages. Even correct text and edit graphics! Create... Read more
PDFpen 6.2 - Edit and annotate PDFs with...
PDFpen allows users to easily edit PDF's. Add text, images and signatures. Fill out PDF forms. Merge or split PDF documents. Reorder and delete pages. Even correct text and edit graphics! Features... Read more
Monolingual 1.5.9 - Remove unwanted OS X...
Monolingual is a program for removing unnecesary language resources from OS X, in order to reclaim several hundred megabytes of disk space. It requires a 64-bit capable Intel-based Mac and at least... Read more
Maya 2015 - Professional 3D modeling and...
Maya is an award-winning software and powerful, integrated 3D modeling, animation, visual effects, and rendering solution. Because Maya is based on an open architecture, all your work can be scripted... Read more
Starcraft II: Wings of Liberty 1.1.1.180...
Download the patch by launching the Starcraft II game and downloading it through the Battle.net connection within the app. Starcraft II: Wings of Liberty is a strategy game played in real-time. You... Read more
Sibelius 7.5.0 - Music notation solution...
Sibelius is the world's best-selling music notation software for Mac. It is as intuitive to use as a pen, yet so powerful that it does most things in less than the blink of an eye. The demo includes... Read more
Typinator 5.9 - Speedy and reliable text...
Typinator turbo-charges your typing productivity. Type a little. Typinator does the rest. We've all faced projects that require repetitive typing tasks. With Typinator, you can store commonly used... Read more
MYStuff Pro 2.0.16 - Create inventories...
MYStuff Pro is the most flexible way to create detail-rich inventories for your home or small business. Add items to MYStuff by dragging and dropping existing information, uploading new images, or... Read more

Latest Forum Discussions

See All

Have a Special Dead Trigger 2 Easter Bas...
Have a Special Dead Trigger 2 Easter Basket Full of Goodies, Courtesy of Madfinger Games Posted by Rob Rich on April 18th, 2014 [ permalink ] Dead Trigger 2 | Read more »
Zynga Launches Brand New Farmville Exper...
Zynga Launches Brand New Farmville Experience with Farmville 2: Country Escape Posted by Tre Lawrence on April 18th, 2014 [ permalink ] | Read more »
David. Review
David. Review By Cata Modorcea on April 18th, 2014 Our Rating: :: MINIMALISTIC IN A DIFFERENT WAYUniversal App - Designed for iPhone and iPad David is a minimalistic game wrapped inside of a soothing atmosphere in which the hero... | Read more »
Eyefi Unveils New Eyefi Cloud Service Th...
Eyefi Unveils New Eyefi Cloud Service That Allows Users to Share Media Across Personal Devices Posted by Tre Lawrence on April 18th, 2014 [ permalink ] | Read more »
Tales from the Dragon Mountain: The Lair...
Tales from the Dragon Mountain: The Lair Review By Jennifer Allen on April 18th, 2014 Our Rating: :: STEADY ADVENTURINGiPad Only App - Designed for the iPad Treading a safe path, Tales from the Dragon Mountain: The Lair is a... | Read more »
Yahoo Updates Flickr App with Advanced E...
Yahoo Updates Flickr App with Advanced Editing Features and More Posted by Tre Lawrence on April 18th, 2014 [ permalink ] | Read more »
My Incredible Body - A Kid's App to...
My Incredible Body - A Kid's App to Learn about the Human Body 1.1.00 Device: iOS Universal Category: Education Price: $2.99, Version: 1.1.00 (iTunes) Description: Wouldn’t it be cool to look inside yourself and see what was going on... | Read more »
Trials Frontier Review
Trials Frontier Review By Carter Dotson on April 18th, 2014 Our Rating: :: A ROUGH LANDINGUniversal App - Designed for iPhone and iPad Trials Frontier finally brings the famed stunt racing franchise to mobile, but how much does its... | Read more »
Evernote Business Notebook by Moleskin I...
Evernote Business Notebook by Moleskin Introduced – Support Available in Evernote for iOS Posted by Tre Lawrence on April 18th, 2014 [ permalink ] | Read more »
Sparkle Unleashed Review
Sparkle Unleashed Review By Jennifer Allen on April 18th, 2014 Our Rating: :: CLASSY MARBLE FLINGINGUniversal App - Designed for iPhone and iPad It’s a concept we’ve seen before, but Sparkle Unleashed is a solidly enjoyable orb... | Read more »

Price Scanner via MacPrices.net

iMacs on sale for up to $160 off MSRP this we...
Best Buy has iMacs on sale for up to $160 off MSRP for a limited time. Choose free home shipping or free instant local store pickup (if available). Prices are valid for online orders only, in-store... Read more
iPad Airs on sale this weekend for up to $100...
Best Buy has WiFi iPad Airs on sale for $50 off MSRP and WiFi + Cellular iPad Airs on sale for $100 off MSRP on their online store for a limited time, with prices now starting at $449. Choose free... Read more
Apple restocks refurbished Mac minis starting...
The Apple Store has restocked Apple Certified Refurbished Mac minis for up to $150 off the cost of new models. Apple’s one-year warranty is included with each mini, and shipping is free: - 2.5GHz Mac... Read more
Hyundai Brings Apple CarPlay To The 2015 Sona...
Hyundai Motor America has announced it will bring Apple CarPlay functionality to the 2015 Sonata. CarPlay is pitched as a smarter, safer and easier way to use iPhone in the car and gives iPhone users... Read more
Updated iPads Coming Sooner Than We Had Thoug...
MacRumors, cites KGI securities analyst Ming Chi Kuo, well-respected as an Apple product prognisticator, saying that Apple will introduce an upgraded iPad Air and iPad mini in 2014/Q3, meaning the... Read more
Toshiba Unveils New High And Low End Laptop M...
Toshiba has announced new laptop models covering both the high-end and low-end of the notebook computer spectrum. Toshiba 4K Ultra HD Laptop Toshiba’s new Satellite P55t features one of the world’s... Read more
Save up to $270 with Apple refurbished 13-inc...
The Apple Store has Apple Certified Refurbished October 2013 13″ Retina MacBook Pros available starting at $1099, with models up to $270 off MSRP. Apple’s one-year warranty is standard, and shipping... Read more
Apple now offering refurbished iPad mini with...
The Apple Store has Certified Refurbished 2nd generation iPad minis with Retina Displays now available starting at $339. Apple’s one-year warranty is included with each model, and shipping is free.... Read more
Microsoft Blinks – Drops Microsoft Office 365...
Microsoft has dropped the annual subscription fee for Microsoft Office 365 Personal – which is needed in order to create and edit documents in Microsoft Office for iPad. However, Apple’s iOS and OS X... Read more
New AVG Vault Apps for iOS and Android Help K...
AVG Technologies N.V. an online security company for 177 million active users, has announced the launch of its latest mobile application, AVG Vault. The free app introduces an innovative user... Read more

Jobs Board

*Apple* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
*Apple* Retail - Manager - Holyoke - Apple I...
Job Summary Keeping an Apple Store thriving requires a diverse set of leadership skills, and as a Manager, you’re a master of them all. In the store’s fast-paced, Read more
*Apple* Retail - Manager - Apple (United Sta...
Job SummaryKeeping an Apple Store thriving requires a diverse set of leadership skills, and as a Manager, you're a master of them all. In the store's fast-paced, dynamic Read more
*Apple* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
*Apple* Retail - Market Leader - Cincinnati...
…challenges of developing individuals, building teams, and affecting growth across Apple Stores. You demonstrate successful leadership ability - focusing on excellence Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.