However, I really need to be writing and making sample code. This will help avoid questions and help a lot of people. I'm going to be doing both of those here, with the final product getting polished and put up on the Palm Developer Site eventually. Consider these posts a working draft.
We've got three APIs that are used for PDK apps. The first is SDL (Simple Directmedia Library). Our current release is based on SDL 1.2. This API gives you drawing surfaces, 2D primitives, image loading, fonts, events, timers, network access, accelerometer (via joystick APIs), touch screen (via mouse APIs). It's well described at the libsdl.org website.
The final API is Open GL ES. We support both version 1.1 and 2.0, although not both in the same program. Open GL ES 1.1 has a fixed-function pipeline and works well for a lot of 2D and 3D applications, while ES 2.0 uses a programmable shader system which is more complicated for simple programs, but very powerful in its ability to shift vertex transformation and shading into the GPU. I'm still learning the Open GL way, but I hope to blog about my experience getting some GL ES 2.0 sample code running on the device.
Next time, we explore some basic SDL-based sample code.