JSL4HSP3

ダウンロード

JSL4HSP3 Ver.3.0.0.3 (2023/07/19)
ダウンロード (421 KB) 　 サンプル ダウンロード (1 MB)

JSL4HSP3 Ver.2.2.0.1 (2023/01/29)
ダウンロード (194 KB)

内容

　JSL4HSP3（JoyShockLibrary for HSP3） は、HSP3で DualShock 4、DualSense、Nintendo、Switch Joy-Con、Nintendo Switch Pro コントローラーを使用できるようにするためのモジュールです。JibbSmart氏により開発された、JoyShockLibrary.dllをHSP3で使用するために、モジュールやマニュアルを整備し、いくつかの機能を追加したものです。

　通常のボタン操作に加え、ジャイロなどのコントローラ独自の入力を取得することができます。また、DualShock 4、DualSenseは、振動の出力にも対応しています。

　対応しているコントローラーは、以下の通り。対応していないコントローラーについては、本モジュールでは接続しても認識できません。

• Switch Joy-Con
• Switch Pro コントローラー
• DualShock 4
• DualSense

謝辞

　JSL4HSP3 は、JoyShockLibrary.dllのHSP3向けラッパーです。

　JoyShockLibrary.dll は、Jibb Smartさんが作成したものです。 本家 JoyShockLibrary はGitHubで開発及び配布が行われています。
https://github.com/JibbSmart/JoyShockLibrary
大変素晴らしいライブラリを開発いただき大変感謝しております。 このDLLがなければ、このモジュールを作成することはできませんでした。

　また開発にあたり、nennneko5787さんが作成したJoyShockLibrary.asを参考に させていただきました。ありがとうございます。このモジュールがなければ、 JoyShockLibraryを知ることすらできませんでした。
https://github.com/nennneko5787/JoyShockLibrary-For-HSP3

　MIZUSHIKIさんの JoyShockLibrary-plus-HDRumble のおかげで、あきらめていたHD振動で遊べるようになりました。ありがとうございます。
https://github.com/MIZUSHIKI/JoyShockLibrary-plus-HDRumble

ライセンス

　JSL4HSP3 は MIT ライセンスの下でライセンスされています。詳細は、添付の License.txt を参照してください。

　JoyShockLibrary.dll は MIT ライセンスの下でライセンスされています。下記アドレスのサイトを参照してください。
JoyShockLibrary, Copyright 2018-2023 Julian Smart : https://github.com/JibbSmart/JoyShockLibrary#license
https://github.com/JibbSmart/JoyShockLibrary/blob/master/LICENSE.md

動作環境

Windows10で動作確認済み。

機能

主に次のような機能に対応しています。

• ボタン 取得
• アナログ入力 取得（スティックとトリガー）
• 加速度 取得
• 角速度 取得
• モーション 取得（センサフュージョン）
• タッチパッド（DS4、DS5 のみ）
• 振動 出力（DS4、DS5 のみ）
• HD振動 出力（N のみ）（JoyShockLibrary-plus-HDRumbleが必要）
• コントローラの色 取得（N のみ）
• ライトバーの色 変更（DS4、DS5 のみ）
• プレイヤーランプ 変更（N、DS5 のみ）
• 校正（キャリブレーション）

記号の意味
N …Nintendoデバイス（Joy-Con、Pro コントローラー）
DS4 …DualShock4
DS5 …DualSense

追加機能

　JoyShockLibrary.dllには、ロール・ピッチ・ヨーを直接取得する機能はありません。 本モジュールでは、ロール・ピッチ・ヨーを手軽に取得するための命令を作成しました。

また、ロール・ピッチ・ヨーの取得に関して解説記事を用意いたしましたので、気になる方はご覧ください。
ロール・ピッチ・ヨーの取得について解説

サンプル

　導入をしやすくするため、サンプルを用意してあります。導入時の参考として活用ください。

• ample01_入力を受け取る.hsp
  入力値を表示する基本的な使用方法の例。
• ample02_デバイスの性能.hsp
  接続したデバイスの性能を調べて表示する。
• ample03_デバイスの性能一括取得.hsp
  JslGetControllerInfoAndSettings命令の使用例。
• ample04_振動機能.hsp
  振動機能を使ったサンプル。
• ample05_詳細な入力.hsp
  コントローラから取得した情報をできるだけ多く表示するサンプル。
• ample06_クォータニオン.hsp
  ジャイロから姿勢情報をクォータニオンで取得するサンプル。
• ample07_コールバック.hsp
  modclbk3を使ってコールバック機能を使う不完全なサンプル。
• ample08_1軸のみ取得.hsp
  ジャイロから取得したクォータニオンの情報を1軸だけにするサンプル。
• ample09_ロールピッチヨー.hsp
  ジャイロからロール・ピッチ・ヨーを取得するサンプル。
• ample10_カートレース.hsp
  ジャイロからヨー角を取得するサンプル。HGIMG4を使ったカートレース。
• ample11_マウス.hsp
  ジャイロ機能を使ったマウス。応用すればガンコンのような利用法も考えられます。

履歴