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.