書 式
#include <NinjaWin.h> NJS_PERIPHERAL *njGetPeripheral(port) Uint32 port
引 数
- port
- ペリフェラルポート番号
NJD_PORT_SYSKEYBOARD システムキーボード NJD_PORT_SYSMOUSE システムマウス NJD_PORT_JOYSTICK1 ジョイスティックポート１ : NJD_PORT_JOYSTICK16 ジョイスティックポート16
返 値
機 能
- ペリフェラルの接続状況、種別、ボタン情報等を取得します。
- ペリフェラル構造体のメンバを参照することにより、アプリケーションは、各種情報を取得することができます。
NJS_PERIPHERAL構造体メンバ解説
- id 接続されているペリフェラルの種類
NJD_DEV_NODEVICE 接続されていない NJD_DEV_SYSKEYBOARD システムキーボード NJD_DEV_SYSMOUSE システムマウス NJD_DEV_JOYSTICK ジョイスティック NJD_DEV_UNDEFINED 不明 
ペリフェラルポート番号と混同しないように注意してください。 - on ボタン情報(ON)
- ボタン情報が格納されます。
ボタンが押されると対応するビットが1、押されていなければ0になります。
以下のマクロとの論理積を用いてボタンのON/OFFを取得します。
NJD_DGT_KU 十字キー上 NJD_DGT_KD 十字キー下 NJD_DGT_KL 十字キー左 NJD_DGT_KR 十字キー右 NJD_DGT_TA Aボタン NJD_DGT_TB Bボタン NJD_DGT_TC Cボタン NJD_DGT_TX Xボタン NJD_DGT_TY Yボタン NJD_DGT_TZ Zボタン NJD_DGT_TL Lボタン NJD_DGT_TR Rボタン NJD_DGT_ST スタートボタン - off ボタン情報(OFF)
- メンバonとは逆に、ボタンが押されていると対応するビットが 0、押されていなければ1となります。
- push ボタン情報(ONエッジ)
- ボタンが押された瞬間に対応するビットが1になります。
エッジ検出に使用します。 - pull ボタン情報(OFFエッジ)
- ボタンが放された瞬間に対応するビットが1になります。
エッジ検出に使用します。
- x,y,z,r,u,v
- アナログ軸のデータを取得します。
16ビットで、-32768〜32767の範囲で値を取得します。 - extend
- ペリフェラルの種類に応じた拡張データのアドレスが入ります。
現在は使用されていません。 - name
- ペリフェラル名称文字列(ASCIIZ)へのポインタが入ります。
- キーボードとデジタルパッドは、以下のように対応しています。
-
デジタルパット キーボード 十字キー上 カーソル上またはテンキー８ 十字キー下 カーソル下またはテンキー２ 十字キー左 カーソル左またはテンキー４ 十字キー右 カーソル右またはテンキー６ Aボタン Zキー Bボタン Xキー Cボタン Cキー Xボタン Aキー Yボタン Sキー Zボタン Dキー Lボタン Qキー Rボタン Eキー スタートボタン スペースキー
または
リターンキー
-
用 例
Sint32 njUserMain(void)
{
NJS_PERIPHERAL* per;
/* ジョイスティックポート1に接続されているペリフェラル情報を取得 */
per = njGetPeripheral(NJD_DEV_JOYSTICK1);
if(per->id == NJD_DEV_NODEVICE){
/* ペリフェラル未接続 */
}
if(per->push & NJD_DGT_ST){
/* スタートボタンが押された(エッジ) */
}
if(per->on & NJD_DGT_KU){
/* 十字キー上が押されている */
}
if((per->on & (NJD_DGT_TA | NJD_DGT_TB))==(NJD_DGT_TA | NJD_DGT_TB){
/* 複数ボタンの判定 - AボタンとBボタンが押されている */
}
return NJS_USER_CONTINUE;
}
備 考
- ペリフェラル情報は、njUserMainのコールバック後にシステム内部で 更新されます。従ってnjUserMainからリターンしない場合、ペリフェラル 情報は更新されませんので注意してください。
- コントロールパネルでジョイスティックが正しく設定されている必要があります。
- 現バージョンでは対応しているジョイスティックは２つまでです。
関 連
NjWinDef.h