Title Banner

Previous Book Contents Book Index Next

Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /
Chapter 18 - QuickDraw 3D Pointing Device Manager / QuickDraw 3D Pointing Device Manager Reference
QuickDraw 3D Pointing Device Manager Routines / Creating and Managing Controllers


Q3Controller_New

You can use the Q3Controller_New function to create a new controller.

TQ3ControllerRef Q3Controller_New (
const TQ3ControllerData *controllerData);
controllerData
A pointer to a controller data structure.
DESCRIPTION
The Q3Controller_New function returns, as its function result, a reference to a new controller object having the characteristics specified by the controllerData parameter. The new controller object is initially made active and is associated with the system cursor's tracker. You can call Q3Controller_SetTracker to associate the controller with some other tracker. The serial number of the new controller object is set to 1. If Q3Controller_New cannot create a new controller, it returns NULL.

You cannot delete a controller, but you can make it no longer operational. See the description of Q3Controller_Decommission (page 18-15) for details.

SPECIAL CONSIDERATIONS
In general, you need to use this function only if you are writing a device driver for a controller.

SEE ALSO
See "Controller Data Structure" on page 18-12 for a description of the fields of the controller data structure.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
11 JUL 1996




Navigation graphic, see text links

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help