各種入力（Toy-Con）

XCTRLSTYLE 最大接続数,100,Toy-Con種類左1,Toy-Con種類右1[,接続画面表示フラグ]
XCTRLSTYLE 最大接続数,100,Toy-Con種類左1,Toy-Con種類右1,Toy-Con種類左2,Toy-Con種類右2[,接続画面表示フラグ]

Toy-Conの接続設定をする

・Toy-Conを使用する場合、操作スタイルは専用スタイルを使用する。
・通常ジョイコンとしての情報は、BUTTON,STICK,ACCEL,GYROA,GYROVで2本持ちスタイル相当として取得できる。
・Toy-Con使用中はIRカメラ命令は使用できない。
・接続確認画面の操作結果はRESULT関数で確認できる（1:成功,-1:キャンセル）。
・サブプログラムからの呼び出しは無視される。

引数

最大接続数

接続したい最大のコントローラー数を指定する:1～2

100

Toy-Conを使用する場合操作スタイルに100を指定する

Toy-Con種類

認識するToy-Conの種類を左右別に設定する

	左	右
0	ToyCon認識OFF	ToyCon認識OFF
1	×	ピアノ
2	×	おうち
3	△バイク	△バイク
4	△つり	△つり
5	×	ロボット
6	バイザー	×
7	△クルマ	△クルマ
8	△ヒコウキ	△ヒコウキ
9	△センスイカン	△センスイカン
10	7,8,9すべて	7,8,9すべて

・×となっている値は指定できない。
・バイザーは左にのみ指定可能。
・ピアノ、おうち、ロボットは右にのみ指定可能。
・△のついた種類は左右両方に指定しなければならない。
・10はカギToy-Conの装着により7,8,9を自動で切替える。

接続画面表示フラグ

コントローラー接続画面を必ず表示するかどうかを指定する
・1を指定すると、コントローラー接続画面が必ず表示される。
・0を指定すると、設定が変わった時だけコントローラー接続画面が表示される。
・省略時は0。

TCPIANO コントローラーID OUT 認識フラグ[,キー・ボタン情報,ダイアル種類,ダイアル回転角速度]

ピアノToy-Conの認識情報を取得する

・XCTRLSTYLEでToy-Con種類に1以外を指定するとエラーとなる。
・キー・ボタン情報以降の返値はすべて省略可能。

引数

コントローラーID

情報を取得するコントローラーのID:1～2

返値

認識フラグ

ピアノToy-Conを認識しているかどうかを返す
・1で認識中。0で認識していない。

キー・ボタン情報

ピアノToy-Conのキー・ボタン状況をビット毎に返す
各ビットの意味は次の通り

bit0	ド
bit1	ド♯
bit2	レ
bit3	レ♯
bit4	ミ
bit5	ファ
bit6	ファ♯
bit7	ソ
bit8	ソ♯
bit9	ラ
bit10	ラ♯
bit11	シ
bit12	ド（1オクターブ上）
bit13	読み込みボタン
bit14	オクターブアップ
bit15	オクターブダウン
bit16	再生ボタン
bit17	録音ボタン

ダイアル種類

ToyConに挿入されているダイアルの種類

0	挿入していない、認識できない
1	太線
2	細線
3	２本線
4	中線

ダイアル回転角速度

ダイアルが挿入されている場合の回転角速度
・時計回りに1周で1.0、反時計回りに1周で-1.0。

TCROBOT コントローラーID OUT 認識フラグ,手足情報配列[,ピッチ,ロール,ヨー]

ロボットToy-Conの認識情報を取得する

・XCTRLSTYLEでロボットToy-Conの認識を開始しない状態で使用するとエラーとなる。

引数

コントローラーID

情報を取得するコントローラーのID:1～2

返値

認識フラグ

ロボットToy-Conの各スロットを認識しているかどうかをビット値で返す
・各ビット1で認識中、0で認識していない。

bit0	右足
bit1	右手
bit2	左手
bit3	左足

手足情報配列

各スロットの情報が格納された2次元数値配列を返す
配列要素を[Y,X]とした時のYとXの意味は次の通り

Y=0	右足
1	右手
2	左手
3	左足

X=0	補正済検出値:0～1
1	補正前検出値:0～320
2	補正最小値:0～320
3	補正最大値:0～320
4	対応するクラスタID

ピッチ,ロール,ヨー

ロボットToy-Conを背負った状態での姿勢角度情報
・角度の単位はラジアン。

ピッチ	前後の傾き。Toy-Conを背中側に傾けると正(値が大きくなる)
ロール	左右の傾き。Toy-Conを左側に傾けると正
ヨー	腰の回転。反時計まわりに回転させると正

TCVISOR コントローラーID OUT 認識フラグ,ピッチ,ロール,ヨー

ロボットToy-Conのバイザー認識情報を取得する

・XCTRLSTYLEでロボットToy-Conバイザーの認識を開始しない状態で使用するとエラーとなる。

引数

コントローラーID

情報を取得するコントローラーのID:1～2

返値

認識フラグ

バイザーを正しく認識している場合は1、認識していない場合は0が返る

ピッチ,ロール,ヨー

バイザーの姿勢角度情報
・バイザーを頭に装着した状態を想定している。
・角度の単位はラジアン。

ピッチ	バイザー上げ下げの傾き。Toy-Conを上げると正(値が大きくなる)
ロール	頭の左右の傾き。首を左に傾けると正
ヨー	頭の回転。反時計まわりに回転させると正

TCHOUSE コントローラーID OUT 認識フラグ,情報配列

おうちToy-Conの認識情報を取得する

・XCTRLSTYLEでおうちToy-Conの認識を開始しない状態で使用するとエラーとなる。

引数

コントローラーID

情報を取得するコントローラーのID:1～2

返値

認識フラグ

おうちToy-Conを認識しているかどうかを返す。1で認識中。0で認識していない

情報配列

各差し込み口の情報が格納された2次元数値配列を返す
配列要素を[Y,X]とした時のYとXの意味は次の通り

Y=0	下差し込み口
1	左差し込み口
2	右差し込み口

・X=0に次のように差し込まれているブロックのタイプが格納される。

0	ブロックなし
1	くるくる
2	ぷすぷす
3	ねじねじ
4	ケーブル1
5	ケーブル2

・X=1以降は次のような値が格納される。

X	くるくる	ぷすぷす	ねじねじ	その他
1	回転速度	フラグ	フラグ	0
2	0	押し量	ねじり量	0
3	0	0	差し込み向き	0

・くるくるの回転速度は-1～1の値で、0で静止。
・ぷすぷすのフラグは次のとおり。

bit0	押されている
bit1	押した瞬間

・ぷすぷすの押し量は0～1.0。0で全く押されていない。
・ねじねじのフラグは1でつまみを離した瞬間、0で離していない。
・ねじり量は0～1.0。0で全くねじっていない。
・差し込み向きは0かそれ以外で、ねじねじを縦に刺したか横に刺したかをあらわす。

TCFISHING コントローラーID OUT 認識フラグ[,釣り竿ヨー,釣り竿ピッチ,リール速度,釣り竿ヨー角度,釣り竿ピッチ角度]

つりToy-Conの認識情報を取得する

・XCTRLSTYLEでつりToy-Conの認識を開始しない状態で使用するとエラーとなる。
・釣り竿ヨー以降の返値はすべて省略可能。

引数

コントローラーID

情報を取得するコントローラーのID:1～2

返値

認識フラグ

つりToy-Conを認識しているかどうかを返す。1で認識中。0で認識していない
・認識方法は、左右Joy-ConをつりToy-Conに装着し、認識フラグが1を返すまで静止させておく。

釣り竿ヨー

釣り竿のヨー（左右の角度）を-1.0～1.0の値で取得する
・左が正の値、右が負の値で、0が中央。
・左右に動かさない場合でも徐々に0に戻る。

釣り竿ピッチ

釣り竿のピッチ（上下の角度）を-1.0～1.0の値で取得する
・上向きが正の値、下向きが負の値で、0が水平。

リール速度

リールの巻き速度を取得する
・釣り竿を持って奥側に回すと正の値、手前側に回すと負の値で、0が静止。
・一周で1.0となる。

釣り竿ヨー角度

釣り竿のヨー（左右の角度）をラジアンで取得する
・左が正の値、右が負の値で、0が中央。
・左右に動かさない場合でも徐々に0に戻る。

釣り竿ピッチ角度

釣り竿のピッチ（上下の角度）をラジアンで取得する
・上向きが正の値、下向きが負の値で、0が水平。

TCBIKE コントローラーID OUT 認識フラグ[,ハンドル傾き,アクセル量,アクセル角度,ウイリー角度]

バイクToy-Conの認識情報を取得する

・XCTRLSTYLEでバイクToy-Conの認識を開始しない状態で使用するとエラーとなる。
・ハンドル傾き以降の返値はすべて省略可能。

引数

コントローラーID

情報を取得するコントローラーのID:1～2

返値

認識フラグ

バイクToy-Conを認識しているかどうかと、操作ボタンの状態をビット値で返す

0	認識していない
bit0	認識中
bit1	ブレーキレバー
bit2	左手前ボタン
bit3	右手前ボタン

・認識方法は、左右Joy-ConをバイクToy-Conに装着し、認識フラグが0以外の値を返すまで静止させておく。
・認識していない場合ボタン状態はかならず0になる。

ハンドル傾き

ハンドルの傾き量を-1.0～1.0の値で取得する
・左に傾けると正の値、右に傾けると負の値、0が水平。

アクセル量

アクセルのひねり量を0～1.0の値で取得する
・ひねっていない状態で0を返す。

アクセル角度

アクセルのひねり角度をラジアンで取得する
・ひねっていない状態で0を返す。

ウイリー角度

バイクToy-Conを上に向けた時の角度をラジアンで取得する

TCCAR コントローラーID OUT 認識フラグ [,アクセル,ハンドル入力[,ハンドル角度,左レバー,右レバー,ひも,サイドレバー,左ギミック,右ギミック]

クルマToy-Conの認識情報を取得する

・XCTRLSTYLEでToy-Con種類に7または10を指定しないとエラーとなる。
・アクセル以降の返値はすべて省略可能。

引数

コントローラーID

情報を取得するコントローラーのID:1～2

返値

認識フラグ

クルマToy-Conを認識しているかどうかと、操作ボタンの状態をビット値で返す。

0	認識していない
bit0	認識中
bit1	カギToy-Conボタン

アクセル

アクセルペダルの踏み込み量:0～1.0

ハンドル入力

ハンドルの回転量: -1.0～1.0
・-1.0で左180°、1.0で右180°、0でまっすぐ。
・180°以上ハンドルを回転しても上限・下限値を維持する。

ハンドル角度

ハンドルの回転角度:-0.5～0.5
・-0.5で左180°、0.5で右180°、0でまっすぐ。
・180°以上ハンドルを回転すると値が反転する。

左レバー

左レバーの操作量:0～1.0

右レバー

右レバーの操作量:0～1.0

ひも

ひもの引き量:0～1.0

サイドレバー

サイドレバーの操作量:0～1.0

左ギミック,右ギミック

左右レバーのギミックダイアル位置:0～4

TCPLANE コントローラーID OUT 認識フラグ [,アクセル,スティックX,スティックY]

ヒコウキToy-Conの認識情報を取得する

・XCTRLSTYLEでToy-Con種類に8または10を指定しないとエラーとなる。
・アクセル以降の返値はすべて省略可能。

引数

コントローラーID

情報を取得するコントローラーのID:1～2

返値

認識フラグ

ヒコウキToy-Conを認識しているかどうかと、操作ボタンの状態をビット値で返す。

0	認識していない
bit0	認識中
bit1	カギToy-Conボタン
bit2	トリガーボタン

アクセル

アクセルペダルの踏み込み量:0～1.0

スティックX

スティック左右方向の傾き:-1.0～1.0
・-1.0で左いっぱい,-1.0で右いっぱい、0で中央。

スティックY

スティック前後方向の傾き:-1.0～1.0
・-1.0で奥いっぱい,-1.0で手前いっぱい、0で中央。

TCSUBM コントローラーID, OUT 認識フラグ [,アクセル,左ハンドル角度,右ハンドル角度]

センスイカンToy-Conの認識情報を取得する

・XCTRLSTYLEでToy-Con種類に9または10を指定しないとエラーとなる。
・アクセル以降の返値はすべて省略可能。

引数

コントローラーID

情報を取得するコントローラーのID:1～2

返値

認識フラグ

センスイカンToy-Conを認識しているかどうかと、操作ボタンの状態をビット値で返す。

0	認識していない
bit0	認識中
bit1	カギToy-Conボタン
bit2	センスイカンToy-Conボタン

アクセル

アクセルペダルの踏み込み量:0～1.0

左ハンドル角度

左側ハンドルの回転角度:-0.5～0.5
・-0.5で-180°、0.5で180°をあらわす。
・180°以上ハンドルを回転すると値が反転する。

右ハンドル角度

右側ハンドルの回転角度:-0.5～0.5
・-0.5で-180°、0.5で180°をあらわす。
・180°以上ハンドルを回転すると値が反転する。

TCVEHICLE(コントローラーID)

現在認識中のDriveKit Toy-Con種類を返す

・XCTRLSTYLEでToy-Conを使用する設定にしていないとエラーとなる。

引数

コントローラーID

情報を取得するコントローラーのID:1～2

返値

Toy-Con種類

次のいずれかの値

0	未認識
7	クルマ
8	ヒコウキ
9	センスイカン

・XCTRLSTYLEでToy-Con種類として7,8,9,10を指定してる時のみ0以外の値を返す。