set joy callback

set_joy_callback

Original Documentation

void set_joy_callback(char num, char mask, char keys, void (*proc)());

You can program the library to call one of your function when a certain joypad key as been pressed. The best use of this function is to handle game pause mode when the player press the START button. 'num' is the numero of the callback to install, for now there's only one callback (0), but future versions of the library may have more. 'mask' indicates which joypad to scan (one bit for each joypad, with bit 0 for joypad 0, etc...), and 'keys' indicates which keypresses to look, usualy just JOY_STRT. 'proc' is the address of the function you want to be called by the library.

Additional Documentation

Prototype

void set_joy_callback(char num, char mask, char keys, void (*proc)());

Arguments

num	The number of the callback to install
mask	The joypad(s) to scan
keys	The keys to look for (defined in huc.h)
proc	The procedure to call

Return Value

None

Description

You can program the library to call one of your functions when a certain joypad key has been pressed. A good example of this function is to handle game pause mode when the player presses the START button.

For now, "num" can only be 0, as only one callback is supported. This may change in the future. "mask" indicates the joypad mask to use. Each joypad gets one bit, so the first joypad would be 0x01, the second would be 0x02, both would be 0x03, etc. "keys" indicates which keypresses to look for. Finally, "proc" is the address of the function you want to have executed by the callback.

For the callback to work correctly, the function you wish to use must precede set_joy_callback.

Complete Example

#include "huc.h"

my_function()
{
  put_string("JOY_STRT pressed.", 0, 0);
  while(1) { vsync(); }
}

main()
{
  set_joy_callback (0, 0x01, JOY_STRT, my_function);
  while(1) { vsync(); }
}