Important: The information in this document is obsolete and should not be used for new development.
The Development Environment
The system software routines described in this book are available using Pascal, C, or assembly-language interfaces. How you access these routines depends on the development environment you are using. When showing system software routines, this book uses the Pascal interface available with the Macintosh Programmer's Workshop (MPW).All code listings in this book are shown in Pascal (except for listings that describe resources, which are shown in Rez-input format). They show methods of using various routines and illustrate techniques for accomplishing particular tasks. All code listings have been compiled and in many cases tested. However, Apple Computer, Inc., does not intend for you to use these code samples in your application. You can find the location of code listings in the list of figures, tables, and listings beginning on page xvii. If you know the name of a particular routine (such as
DoPictBalloon
orMyPlotAnICON
) shown in a code listing, you can find the page on which the routine occurs by looking under the entry "sample routines" in the index of this book.To make the code listings in this book more readable, they show only limited error handling. You need to develop your own techniques for handling errors.
This book occasionally illustrates concepts by referring to a sample application called SurfWriter; this book also refers to the sample applications SurfPaint and SurfDB. These applications are not actual products of Apple Computer, Inc. This book also refers to a River control panel and SurfBoard display card. These are not actual products of Apple Computer, Inc. In addition, the name River Change Systems is used to represent a fictitious company.
APDA is Apple's worldwide source for over three hundred development tools, technical resources, training products, and information for anyone interested in developing applications on Apple platforms. Customers receive the quarterly APDA Tools Catalog featuring all current versions of Apple and the most popular third-party development tools. Ordering is easy; there are no membership fees, and application forms are not required for most products. APDA offers convenient payment and shipping options including site licensing.
To order products or to request a complimentary copy of the APDA Tools Catalog, contact
APDA
Apple Computer, Inc.
P.O. Box 319
Buffalo, NY 14207-0319
Telephone: 800-282-2732 (United States)
800-637-0029 (Canada)
716-871-6555 (elsewhere in the world)Fax: 716-871-6511 AppleLink: APDA America Online: APDA CompuServe: 76666,2405 Internet: APDA@applelink.apple.com If you provide commercial products and services, call 408-974-4897 for information on the developer support programs available from Apple.
For information on registering signatures, file types, and other technical information, contact
Macintosh Developer Technical Support
Apple Computer, Inc.
20525 Mariani Avenue, M/S 303-2T
Cupertino, CA 95014-6299