Palm Developer Guide, Palm OS Platform, Software
Total Page:16
File Type:pdf, Size:1020Kb
Palm® Developer Guide, Palm OS® Platform Software and Hardware Rev. G October 10, 2007 Usage Restrictions Your right to access and use the following "PDN Materials" is subject to and governed by the following terms and the terms and conditions of the Palm Developer Network Program License Agreement, available at https://pdn.palm.com/regac/pdn/page?Page_Name=terms. Disclaimer and Limitation of Liability Palm, Inc. ("Palm") provides these PDN Materials as a courtesy to members of its Palm Developer Network ("PDN"). Palm provides the PDN Materials on an "AS IS" basis and does not guarantee nor assume any liability for the accuracy or completeness of these PDN Materials, nor does Palm guarantee that the PDN Materials will be without errors. You assume the entire risk of using the PDN Materials, including any damage or loss resulting from your use of the PDN Materials or any loss or claims by third parties which may arise from your use of the PDN Materials. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, THE PDN MATERIALS ARE PROVIDED TO YOU ON AN "AS IS" BASIS AND WITHOUT ANY WARRANTY OF ANY KIND OR NATURE. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, PALM AND ITS SUPPLIERS EXPRESSLY DISCLAIM ANY IMPLIED OR STATUTORY WARRANTIES, INCLUDING WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE, ACCURACY, CORRESPONDENCE WITH DESCRIPTION, SATISFACTORY QUALITY AND NON- INFRINGEMENT. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, NEITHER PALM NOR ITS SUPPLIERS SHALL BE LIABLE FOR DIRECT, INCIDENTAL, CONSEQUENTIAL, INDIRECT, SPECIAL, OR PUNITIVE DAMAGES OF ANY KIND, LOSS OF INFORMATION OR DATA, LOSS OF REVENUE, LOSS OF BUSINESS OR OTHER FINANCIAL LOSS ARISING OUT OF OR IN CONNECTION WITH THE USE OF THE PDN MATERIALS, WHETHER BASED IN CONTRACT, TORT (INCLUDING NEGLIGENCE), STRICT PRODUCT LIABILITY OR ANY OTHER THEORY, EVEN IF PALM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES AND EVEN IF ANY LIMITED REMEDY IS DEEMED TO HAVE FAILED OF ITS ESSENTIAL PURPOSE. Some countries, states, or provinces do not allow the limitation of incidental or consequential damages so the above provisions may be limited in their application to you. Copyright and Trademark © 2004-2007 Palm, Inc. All rights reserved. Palm, LifeDrive, Zire, Tungsten, Treo, Centro, Blazer, Handspring, Graffiti, HotSync, VersaMail, Palm Powered, and Palm OS by ACCESS are among the trademarks or registered trademarks owned by or licensed to Palm, Inc. Adobe and Acrobat are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. All other brand and product names are or may be trademarks of, and are used to identify products or services of, their respective owners. The foregoing provisions shall be governed by the laws of the State of California and by the federal laws of the United States, excluding their conflicts of laws provisions. The United Nations Convention on Contracts for the International Sale of Goods (1980) is hereby excluded in its entirety from application to the foregoing provisions. In the event any provision is found to be invalid, illegal or unenforceable, the validity, legality and enforceability of any of the remaining provisions shall not in any way be affected or impaired. Please read the Palm Developer Network Program License Agreement before using the PDN Materials. If you do not agree to the terms and conditions of the Developer Network Program License Agreement, you may not access or use the PDN Materials. USING OR ACCESSING ANY PART OF THE PDN MATERIALS INDICATES THAT YOU ACCEPT THE TERMS OF THE DEVELOPER NETWORK PROGRAM LICENSE AGREEMENT. Document Revision History Date Revision Description of Changes 2004 - 2005 A Documents prior to document revisioning. May 15, 2006 B Revisions for the Treo™ 700p smartphone. June 29, 2006 C Revisions for Multimedia features. November 20, 2006 D Revisions for the Treo™ 700p smartphone Rest of World carrier release. November 22, 2006 E Revisions for the Treo™ 680 smartphone. April 30, 2007 F Revisions for the Treo™ 755p smartphone. October 10, 2007 G Revisions for the Centro™ smartphone. This page intentionally blank Contents What’s New . xiii What’s new in Centro™ smartphones . .xiii What’s new in Treo™ 755p smartphones . .xiv What’s new in Treo™ 680 smartphones . .xiv What’s new in Treo™ 700p ROW smartphones . .xiv What’s new in Treo™ 700p smartphones . xv Chapter 1: Overview . 17 1.1 How this guide is organized . 17 1.2 Typographical conventions . 17 1.3 Submitting documentation feedback . 17 1.4 Getting started . 18 1.4.1 Join the ACCESS® Developer Program . 18 1.4.2 Download the ACCESS® Palm OS® SDK . 18 1.4.3 Acquire an IDE . 18 1.4.4 Join the Palm® Developer Network (PDN) . 19 1.4.5 Download the Palm OS® Platform SDK . 20 1.5 Additional documentation and resources . 21 1.5.1 Palm® Customer Service and Support . 21 1.5.2 PDN Knowledge Base . 21 1.5.3 Designed for Palm® Products Program . 21 1.5.4 ACCESS® documentation . 22 1.5.5 Expansion Parts Store . 22 1.5.6 Cable and connector drawings . 22 Chapter 2: Product Line Overview . 23 2.1 Centro™ smartphones . 23 2.1.1 What’s not supported by Centro™ smartphones . 24 2.2 Treo™ smartphone product line . 24 2.2.1 What’s not supported by Treo™ smartphones . 26 2.3 Tungsten™ handheld product line . 26 2.3.1 What’s not supported by Tungsten™ handhelds . 26 2.4 LifeDrive™ mobile manager . 27 2.4.1 What’s not supported by LifeDrive™ mobile managers . 27 2.5 Zire™ handheld product line . 28 2.5.1 What’s not supported by Zire™ handhelds . 28 Palm Developer Guide, Palm OS Platform, Rev. G v Contents 2.6 Hardware feature matrix . 29 2.6.1 Treo™smartphone hardware features . 29 2.6.2 Palm® handheld and LifeDrive™ mobile manager hardware features 31 2.6.3 Palm® Z22 organizer and Zire™ handhelds hardware features . 32 2.7 SDIO support . 34 2.8 Software compatibility specifications (Palm® libraries) . 35 2.8.1 Palm® smartphones . 35 2.8.2 Palm® handhelds, organizers, and mobile managers . 37 2.9 sysExternalConnectorAttachEvent and sysExternalConnectorDetachEvent notifications . 39 2.10 kPmConnectorClass Notifications . 39 2.11 Optimizing your application for Palm® NVFS devices . 40 2.11.1 Speeding up actual performance . 40 2.11.2 Speeding up perceived performance . 41 Features and Libraries Chapter 3: PIM SDK . 45 3.1 The PIM SDK . 45 3.2 Known issue . 45 Chapter 4: Multimedia . 47 4.1 Codec Plug-in Manager . 48 4.1.1 Codec Plug-in Manager overview . 48 4.1.2 Codec wrapping . 50 4.1.3 Codec Plug-in Manager process . 51 4.1.4 Media codec formats supported by device . 54 4.1.5 For more information . 56 4.2 Imaging . 56 4.2.1 Photo Library . 57 4.2.2 LCD Overlay . 58 4.2.3 Camera Manager . 60 4.3 Audio . 63 4.3.1 Voice recording and sound libraries . 63 4.3.2 Tones library . 65 4.4 Video playback . 69 4.5 Streaming . 70 4.5.1 Best practices for encoding video for streaming . 70 4.5.2 Known issue . 70 Chapter 5: Data Communications . 71 5.1 NetPref Library API . 71 vi Palm Developer Guide, Palm OS Platform, Rev. G Contents 5.1.1 Loading the library . 71 5.1.2 NetPref Library information . 73 5.1.3 NetPref panel . 73 5.2 NetMaster library API.