Inside Macintosh: Apple Game Sprockets Guide /

Chapter 3 - InputSprocket / InputSprocket Reference

Resources

The InputSprocket Set List Resource

You use a set list resource to specify a list of initial saved sets of preferences for the various devices that a user might use to play your game. A set list resource allows you to have one default configuration as well as various other named configurations. A set list resource is of type 'setl'.

The set list resource contains the following elements:

• Version. This 4-byte field specifies the version of the 'setl' data type. The current version is 0x00000001.
• Count. This 4-byte field specifies the number of set list entries that follow.
• Set list entries. Following the count field is an array of set list entry records. Each set list entry record occupies an 80-byte field. A single set list may have multiple sets in it. These sets may correspond to multiple devices as well as multiple configurations for a single device.

The set list entry record contains the following elements:

• Name. This 64-byte field contains the name of this set. It will be displayed to the user.
• Set length. This 4-byte field is the length of data in the 'tset' resource that corresponds to this entry.
• Device identifier. This 4-byte field identifies the device that this set of entry records is for.
• Flags. Two fields are defined for the 4-byte flag field. All others are reserved and should be set to zero. For the first field you should OR in kSetListEntryNotSelected. The following information is provided for completeness only:

kSetListEntrySelectedMask = 0x000000001
kSetListEntryIsSelected = 0x000000001 // set list entry is selected
kSetListEntryNotSelected = 0x000000000 // set list entry is not
                            	   // selected

For the second field you should OR in kSetListEntryDefaultEntry if you want this entry to be the default; otherwise, OR in kSetListEntryAppEntry.

kSetListEntryWhoMask = 0x000000006
kSetListEntryNormalEntry = 0x000000000// a normal user-created
                               	  	// entry
kSetListEntryDefaultEntry = 0x000000002 // the default entry
kSetListEntryAppEntry = 0x000000004// an application-provided
                                	 // entry
kSetListEntryDriverEntry = 0x000000006// a driver-provided entry

• Set resource ID. This 2-byte field contains the resource ID of the 'tset' resource that corresponds to this entry.
• Reserved. This 2-byte field is reserved and should be set to zero.