FORMAT
#include <NinjaWin.h> NJS_PERIPHERAL *njGetPeripheral(port) Uint32 port
PARAMETER
- port
- Peripheral port number
NJD_PORT_SYSKEYBOARD System keyboard NJD_PORT_SYSMOUSE System mouse NJD_PORT_JOYSTICK1 Joystick port 1 : NJD_PORT_JOYSTICK16 Joystick port 16
RETURN VALUE
FUNCTION
- Gets information about peripheral connection, kinds, and button.
- By referring members of peripheral structure, applications can get various information.
Explanation of NJS_PERIPHERALstructure members
- id The kind of connected peripheral
NJD_DEV_NODEVICE Disconnected NJD_DEV_SYSKEYBOARD System keyboard NJD_DEV_SYSMOUSE System mouse NJD_DEV_JOYSTICK Joystick NJD_DEV_UNDEFINED Undefined 
Do not mix them up with peripheral port numbers. - on button information(ON)
- Button information is stored.
If buttons are pushed, the bit which matches the button becomes 1, if not pushed, the bit becomes 0.Gets ON/OFF of buttons using AND with the following macro.
NJD_DGT_KU Directional key Up NJD_DGT_KD Directional key Down NJD_DGT_KL Directional key Left NJD_DGT_KR Directional key Right NJD_DGT_TA A button NJD_DGT_TB B button NJD_DGT_TC C button NJD_DGT_TX X button NJD_DGT_TY Y button NJD_DGT_TZ Z button NJD_DGT_TL L button NJD_DGT_TR R button NJD_DGT_ST START button - off button information(OFF)
- Contrary to member on, the bit which matches the button becomes 0, if not pushed, the bit becomes 1.
- push button information(ON edge)
-
The moment the button is pushed, the bit becomes 1.
Uses it for edge detection. - pull button information(OFF edge)
-
The moment the button is pulled, the bit becomes 1.
Uses it for edge detection.
- x,y,z,r,u,v
-
Gets data of analog axis.
The value must be 16bit and from -32768 to 32767. - extend
-
The address of extended data corresponding to the kind of peripherals is set.
Not available!! - name
- The pointer of peripheral name string (ASCIIZ) is set.
- Keyboard and digital pad
-
Digital Pad Keyboard Direction key UP Cursol UP or Ten key 8 Direction key DOWN Cursol DOWN or Ten key 2 Direction key LEFT Cursol LEFT or Ten key 4 Direction key RIGHT Cursol RIGHT or Ten key 6 A Button Z Key B Button X Key C Button C Key X Button A Key Y Button S Key Z Button D Key L Button Q Key R Button E Key START Button SPACE Key
or
RETURN Key
-
EXAMPLE
Sint32 njUserMain(void)
{
NJS_PERIPHERAL* per;
/* Gets information of peripheral which is
* connected to joystick port1.
*/
per = njGetPeripheral(NJD_DEV_JOYSTICK1);
if(per->id == NJD_DEV_NODEVICE){
/* Peripheral disconnected */
}
if(per->push & NJD_DGT_ST){
/* Start button is pushed (edge) */
}
if(per->on & NJD_DGT_KU){
/* Directional key is pushed */
}
if((per->on & (NJD_DGT_TA | NJD_DGT_TB))==(NJD_DGT_TA | NJD_DGT_TB){
/* Judgement for some buttons pushed
* simultaneously - Both buttons A and B are pushed.
*/
}
return NJS_USER_CONTINUE;
}
NOTES
- Peripheral information is updated in the system after calling back njUserMain. Please note that peripheral information isn't updated in the case that it doesn't return from njUserMain.
- Joystick must be set up properly at the control panel.
- Only two joysticks can be used at present version.
RELATED TOPICS
NjWinDef.h