Inside Macintosh: Imaging With QuickDraw /

Preface - About This Book

Conventions Used in This Book

Inside Macintosh uses various conventions to present information. Words that require special treatment appear in specific fonts or font styles. Certain information uses special formats so that you can scan it quickly.

Special Fonts

All code listings, reserved words, and names of actual data structures,
fields, constants, parameters, and routines are shown in Courier (this
is Courier).

Words that appear in boldface are key terms or concepts and are defined in the glossary.

Types of Notes

There are several types of notes used in this book.

Note

A note like this contains information that is interesting but possibly not essential to an understanding of the main text. (An example appears on page 2-3 in the chapter "Basic QuickDraw.")

IMPORTANT

A note like this contains information that is essential for an understanding of the main text. (An example appears on page 2-4 in the chapter "Basic QuickDraw.")

WARNING

Warnings like this indicate potential problems that you should be aware of as you design your application. Failure to heed these warnings could result in system crashes or loss of data. (An example appears on page 2-28 in the chapter "Basic QuickDraw.")

Empty Strings

This book occasionally instructs you to provide an empty string in routine parameters and resources. How you specify an empty string depends on what language and development environment you are using. In Rez input files and in C code, for example, you specify an empty string by using two double quotation marks (""), and in Pascal you specify an empty string by using two single quotation marks ('').

Assembly-Language Information

Inside Macintosh provides information about the trap macro and routine selector for specific routines like this:

Trap macro	Selector
_QDExtensions	$00E0010

In "Assembly-Language Summary" at the end of a chapter, Inside Macintosh presents information about the fields of data structures in
this format:

0	baseAddr	long	bitmap base address
4	rowBytes	word	row bytes (must be even)
6	bounds	8 bytes	boundary rectangle

The left column indicates the byte offset of the field from the beginning of the data structure. The second column shows the field name as defined in the MPW assembly-language interface files; the third column indicates the size of that field. The fourth column provides a brief description of the use of the field. For a complete description of each field, see "Data Structures" in the main text of the chapter.