・基本（方向/決定/ｷｬﾝｾﾙ/ｻﾌﾞ）
キーボード/パッドの方向キーおよび、決定キー(Enter/スペース)、キャンセルキー(Esc/Backspace/Delete)、サブキー(Shift)、
システム変数52〜57で決定キー/キャンセルキー/サブキーに設定したキーコードのキーを受け付けます。
・方向キー … 受け付け可能な方向キーを設定します。各方向の値は、以下のようにテンキーの番号と対応しています。
・決定キー/キャンセルキー/サブキー … 各々のキー入力を受け付けるかどうかを指定します。
・キーが押されるまで待つ … 上記で設定した何らかのキーが押されるまで、イベント処理を進めずに停止します。
|
・キーボード全キー （100〜）
キーボードの全文字キーを受け付けます（基本は、下記画像で ● が付いてるキーのみ）。 受け付けたキーコードをシステム変数52〜54のどれかに代入すると、システム文字列1〜3を使ってキー名が確認できます。
・特定キーのみ判定 …
ここにチェックを入れると、キーコードで指定したコードのキーのみ受け付けます。
通常のキーボード全キー受付で取得できないキーコードも取得可能です （下記画像で
● が付いてないキー）
キーボードとキーコードの対応は以下の図のようになります。
※メインとテンキーのEnter共に本来は「128」だが、同時押しした後にメインのEnterのみ離すと「256」になる。
半角全角は「248」、ただしカナキーと同じく一度押すと常時押しっぱしになる。
PrtScrは「283」、Homeキーが「299」
○調査・画像提供 ： ナナミ 様
※外部のソフトにキーショートカットが設定されている場合、ウディタ側でキー受付されない場合があります。特に「PrtScr」キーは他のソフトに入力を吸われてウディタ上で機能しない状況が多くなりがちです。
※キーボードによっては3〜4キー以上同時受け付けできない、あるいは特定キーの組み合わせが受付できない場合があります。
【よくある状況】「←+↑」を押したままだと「ESC」「F6」「G」「H」「＊」「B」「N」「/」「＼」「テンキー0」「テンキー . (ドット/Del)」 が反応しない、など。
特に「左上+ESC」は通常のプレイでも使用する可能性がありながら一般的なキーボードでは受付されないので、説明書などでそれを周知する必要があるかもしれません。 |
・マウスクリック・座標
マウスの各種クリックの受付や座標の取得を行います。
・クリック状態： 左・右・中クリックを受け付けます。
・マウスX座標： マウスの画面内X座標を取得します。
・マウスY座標： マウスの画面内Y座標を取得します。
・ホイール回転： マウスの１フレーム中のホイール回転量を取得します。基本は-1〜2、0、+1〜2くらいの数値が入ります。
※ただ一部のPC機種ではホイールに-100や+100以上の数値が入り続けてしまうケースがあるそうです。
|
・パッドボタン（300〜）
ゲームパッドの全ボタンを受け付けます。受け付けたキーコードをシステム変数55〜57のどれかに代入すると、システム文字列4〜6を使って「ボタン0〜20」というキー名が確認できます。キーコード「301」なら「ボタン1」です。
【パッドの種類別の対応ボタン】 2024/01/17時点
| |
Xboxコントローラー |
PSコントローラー
(Dualshockなど) |
Nintendo Switch用
(プロコントローラー・Joy-Con) |
| ボタン1(301) |
Aボタン |
□ボタン |
Bボタン |
| ボタン2(302) |
Bボタン |
×ボタン |
Aボタン |
| ボタン3(303) |
Xボタン |
○ボタン |
Yボタン |
| ボタン4(304) |
Yボタン |
△ボタン |
Xボタン |
| ボタン5(305) |
LBボタン |
L1ボタン |
Lボタン |
| ボタン6(306) |
RBボタン |
R1ボタン |
Rボタン |
| ボタン7(307) |
BACKボタン(Xbox 360)
ビューボタン(Xbox One) |
L2トリガー |
ZLボタン |
| ボタン8(308) |
STARTボタン(Xbox 360)
メニューボタン(Xbox One) |
R2トリガー |
ZRボタン |
| ボタン9(309) |
左スティック押し込み |
SHAREボタン |
−ボタン |
| ボタン10(310) |
右スティック押し込み |
OPTIONSボタン |
+ボタン |
| ボタン11(311) |
LT（左トリガー） |
左スティック押し込み |
左スティック押し込み |
| ボタン12(312) |
RT（右トリガー） |
右スティック押し込み |
右スティック押し込み |
| ボタン13(313) |
なし |
PSボタン |
ホームボタン |
| ボタン14(314) |
なし |
タッチパネル押し込み |
スクリーンショットボタン |
| ボタン15(315) |
なし |
ミュートボタン |
なし |
※「SysS71：[読]ゲームパッドの種別」（システム文字列）で上記のパッドの種類を得ることが可能です。
ユーザーのゲームパッドに合ったキー表記で表示することで、より直感的に操作しやすくなるでしょう。
※ゲームストアのSteamには「AとB」、「XとY」のボタンを入れ替えるオプションがあり、それがオンになっているプレイヤーにはこの通りに表記されない場合がありました。
※Xboxコントローラーの「Xboxボタン」は、Xbox 360コントローラーの場合はどのボタンとしても認識しませんでした。
|
・アナログスティック
ゲームパッドの左右アナログスティックの状態受付を行います。
・（左/右）スティック上下[±1000]： スティックの上下傾き度合いを-1000〜+1000で得られます。
・（左/右）スティック左右[±1000]： スティックの左右傾き度合いを-1000〜+1000で得られます。
・（左/右）スティック角度[0-3600/右が0]： スティックが傾いている方向を0〜3600で得られます。右方向が0、時計回りで増えます。
・（左/右）スティック傾き[0-1000]： 方向関わらず、スティックが傾いている量を0-1000で得られます。
Xboxコントローラなど、「斜めの最大の傾き」が900くらいにしかならない場合がありますので注意してください。
・ZL/ZRトリガー[0-1000/一部非対応]： 背面トリガーを押し込んだ量を得られます。DirectInputには対応していないそうです。 Ver3.23よりDirectInputにも対応しました。
・Z軸値[±1000/Direct/XInput両用]： パッドの生パラメータです。XInputなら背面トリガー「両方」を押し込んだ量を足した値を±1000内で得られます。片方をいっぱい引くと+1000、もう片方いっぱい引くと-1000になり、両トリガーを同時にいっぱいまで引くと0になります。
DirectInputでは下のX/Y/Z回転と合わせ、各社別々の使い方をしていることがあります。
・X/Y/Z回転[±1000/Direct/XInput両用]： パッドの生パラメータです。DirectInputではZ軸とこのXYZ回転を各社「右スティック」に割り当てていたり、「トリガー」に割り当てたりと別々の使い方をしています(Ver3.230より実装)。
※Ver3.230より、システム変数「Sys146:DirectInputならPS/Swiｺﾝ準拠?=1(1推奨)」が1(デフォルト値)になっているときは「Xbox、PS4、PS5、Switchプロコン」などほとんどのコントローラで右スティックやトリガーが正常に読み込めるようになりました。
実は右スティックやZトリガー値は、「Z軸、XYZ回転」の4つの値を各社別々に割り当てています。それをウディタ側で自動で判別し、「右スティック」情報や「ZL/ZRトリガー値」として得られるようにしています。 |
・POV十字キー
ゲームパッドの十字キー（POVキー）の状態受付を行います。
・方向キー … 受け付け可能な方向キーを設定します。各方向の値は、以下のようにテンキーの番号と対応しています。
|
・複数タッチ認識
タブレット端末などでタッチ受け付けをするための機能でです。
・タッチ何番？： 同時タッチのうち、「何番目」の値を取得するか指定します。1つめのタッチが「0番」となり、タッチされてない場合は-1の値が返されます。
【読込対象】
・X座標（-1：なし)： タッチされたX座標を取得します。タッチがない場合は-1が返されます。
・Y座標（-1：なし)： タッチされたY座標を取得します。タッチがない場合は-1が返されます。
・追跡用ID（-1：なし)： 1タッチごとに1つの番号が割り振られ、タッチが離さない限り同じ追跡用IDを返します。
たとえば同じ「タッチ0番」でも、先にタッチした手を離したりすると順番が変わるため、そういった場合に同じタッチを識別するために使います。
追跡用IDは端末によって「0〜押された順の数が常に返る、全部離すとまた0から」「9億から1ずつ減っていく」「数が増える」「値が循環する」など寄せられる情報がまちまちなので、とにかく「タッチしたら離すまでは同じ固有のIDが返される」と考えてください。
|
