Throughout this book, we’ve put a number or letter on the right side of any line of code we explain. Numbered explanations appear below a listing, as shown by the following:
myCartoonRef = GetStandardCartoon (myCartoonID); //1 status = FloatCartoon (myCartoonRef, myWindow); //2
The Cartoon Manager function GetStandardCartoon
returns a reference to the cartoon character specified by myCartoonID
.
A cartoon ID is a unique 8-bit value you assign to the cartoon character when you create it.
The Cartoon Manager function FloatCartoon
floats a cartoon character across a window. It returns a status of 0
if the character successfully gets to the other side.
Where appropriate, we’ll identify the name of the Carbon manager or technology to which a function belongs. If you want to find out more about the function and its manager or technology, see Chapter 1 or Carbon Help (available in the Project Builder Help menu).
In some cases we do not provide error checking so you can more easily see the code that’s central to a function.