はじめに

 本パッケージ「PAD設定さん」はモジュール、サンプル、ツールなどで構成された開発者(HSP3ユーザー)向けのファイル群です。 次のような目的のために活用できます。

 本モジュールの使用方法を習得するため、サンプルスクリプトを準備しています。 各サンプルの内容については、後述のパッケージ内容をご確認ください。

 次のような方にはオススメいたしません。

機能概要

 stick命令と同じような感覚でゲームパッドの入力を取得しながらも、より便利に使えるようにする ことを目的に作成しました。主に以下のような機能があります。

自作ソフトのゲームパッドへの対応化

 本モジュールを使用すると、stick 命令と同じような感覚でゲームパッドを使用できるようにできます。 また、stick 命令では対応していないアナログ入力やキー配置変更などの機能が追加されています。 HSP3標準添付モジュールである mod_joystick.as や mod_joystick2.as の jstick 命令よりもより多くの機能を持っています。

ボタン配置の変更・設定の保存

 付属ツール設定.exeを自作ゲームと一緒に配布することで、ゲームパッドのボタン配置の変更設定機能を手軽に提供できます。 変更した設定は、iniファイルに出力されるので、ユーザーは設定ファイルを他の本モジュールで作成したゲームでも利用できます。

 また、このような設定ツールは自作することもできます。 作成するゲームにあわせた設定ツールやゲーム内に設定機能を持たせることも可能です。 設定.exeはスクリプトを公開しています。

ゲームパッド認識精度の向上

 エンドユーザーの環境によっては、プログラム側がゲームパッドを正しく認識できない場合があります。 この問題は、「ポート番号」を「0(ゼロ)」に決め打ちすることで発生します。

本モジュールは、この問題を解決するための機能を準備しています。お手軽にこの問題回避に取り組むことができます。

その他の特徴

パッケージ内容

本パッケージは次のものを含んでいます。

モジュール

m_joystick.hsp
ゲームパッド情報取得用のモジュールです。使用するにはIniEdit.asが必要です。
ゲームパッドの検出、入力情報の取得、キー配置変更、などが行えます。
IniEdit.as
INIファイル操作用モジュールです。m_joystick.hspを使用しなくても、このモジュールだけを使うことも出来ます。

その他のファイル

joyp_sample01~.hsp
サンプルスクリプトです。詳しくは、を参照してください。
padset.hsp
「コントローラーの設定」設定.exeのスクリプト。
padskn01.png ~ padskn07.png
「コントローラーの設定」で使用している画像ファイル。
pad_icon.ico
「コントローラーの設定」のためのアイコンファイル。

ツール

設定.exe
「コントローラーの設定」ゲームパッドのキー配置を変更して、INIファイルを出力するツール。

マニュアルなど

m_joystick.hs
m_joystick.hspのヘルプファイルです。
インストール作業を行うとHDLで説明が参照できるようになります。
IniEdit.hs
IniEdit.asのヘルプファイルです。
インストール作業を行うとHDLで説明が参照できるようになります。
readme.html
本マニュアルです。

謝辞

 このソフトウェアはHSP3(開発言語)にて作成されました。 HSPを開発されたおにたま様、すばらしいソフトを提供していただきありがとうございました。 CK JOYFORCE DLL作者のchokko様、CK JOYFORCE DLLの仕様を参考にさせていただきました。 モジュールのテストして情報くださった方々、ありがとうございました。

ONION software HOMEPAGE
http://www.onionsoft.net/

CK JOYFORCE DLL version 2.6
http://www1.odn.ne.jp/chokko

皆様のご協力でソフトおよびモジュールを完成させることができました。ありがとうございます。

PLAYSTATION3のSIXAXISをWindowsPCでつかう
http://www.padc.cs.tsukuba.ac.jp/~k1/
SIXAXISでの動作確認にPLAYSTATION3 SIXAXIS initiatorを利用させていただきました。
※これVistaでは使えないらしいので注意。

スキンファイル(padskn.bmp)とアイコンファイル(padset.ico)はVeLTiNAさんに頂きました。
カッコイイ画像を提供いただきありがとうございます。

作者連絡先

作者名 : GENKI
GHP(仮): http://mclab.uunyan.com/index.htm
twitter:@genki_hsp

バグや要望などありましたら、作者までご連絡ください。
ジョイスティック固有の問題の場合は、joyp_sample06.hspの実行結果と一緒に報告いただければ助かります。

更新履歴

バージョン
更新日
更新内容
Ver1.10a
2022/09/15
  • jstick命令のパラメーターinfoswtを 1 にした場合、キーボードのZXCASDWの値が正しく取得できない問題を修正。
Ver1.10
2022/03/31
  • パッド設定番号に文字列で名前を付ける機能を追加。
  • 設定.exe, padset.hsp にアナログスティック入力の設定変更機能を追加。
  • 設定.exe, padset.hsp 引出線の視認性向上。
  • 設定.exe, padset.hsp 「PAD接続」ボタン押下時のメッセージが正しくなかった不具合を修正。
  • JStickSetSettingName命令を追加。
  • JStickGetSettingName命令を追加。
  • JStickGetACfg関数を追加。
  • JStickGetACfgRev関数を追加。
Ver1.09
2022/03/06
  • IniEdLoad命令で読み込んだキーが存在しない場合、キーが存在しないのか空文字なのか判断がつかないため「\n」を返すように修正。
  • アナログスティック配置とプラス方向を変更できる機能を追加。
  • キー配置変更後の現在の設定をiniファイルに一括出力する機能を追加。
  • スキンファイル機能を廃止。
  • 設定.exeのGUI配置を見やすく微調整。
Ver.1.08
2022/02/25
  • マニュアルの体裁を改定。文字の読みやすさを改善しました。(フォントサイズ拡大、コントラスト強調)
  • 設定.exe(padset.hsp)の改修を行いました。主にスキン機能の強化です。
  • ライセンスを見直してよりゆるく変更しました。
  • サンプルスクリプトを見直して、HDLのサンプル逆引きに適切なコメントが表示されるように修正。
  • hsファイルの説明文で表にすべき箇所はtableタグを使った表に変更。
  • hsファイルの説明文を見直して加筆訂正。
Ver.1.07
2019/12/05
  • JStick命令を引数省略して連続で呼び出した場合の挙動が分かりにくいとの報告があったため、ヘルプでの説明を見直して修正。
  • 同じ理由でサンプルを追加。(joyp_sample07.hsp)
  • ヘルプを全体的に見直して加筆修正。
  • 「ジョイスティック」と「ゲームパッド」で表記が揺れていたので「ゲームパッド」に統一しました。
  • JStickCnvState 命令を追加
  • サンプルスクリプトを追加。(joyp_sample08.hsp)
  • モジュールの多重読み込み対策を適用。(m_joystick.hsp、IniEdit.as)
Ver.1.05a
2018/12/31
  • 連絡先urlを新しいサイトに更新しました。
  • 連絡先メールアドレスをTwitterに変更しました。メールアドレスの記載をやめました。メールはwebサイトにのみ記載。
  • joyp_sample05.hspを修正ボタンの数とアナログ表示の数を増加。
  • padset01.hspを修正。#packopt、#packを追記。ファイル名やアイコンなどの変更作業が発生しないようにした。
  • 設定.exeを終了する際にエラーが発生していた不具合を修正。古いバージョンのHSP3でコンパイルしていたのが原因。HSP3.5でコンパイルし直した。
  • 一部のWindows 10環境において、ゲームパッド取得時のエラーによりその後の動作が遅くなることがあるらしいので、JStick命令でエラーを返すように修正。
Ver.1.05
2010/02/06
  • 「コントローラーの設定」をスキンファイルを複数の拡張子に対応させました。
    対応形式:jpg,bmp,png
  • VeLTiNAさんに頂いた画像を添付しました。
Ver.1.04
2008/12/16
  • JStick命令でキーボードの情報を取得するとずれて取得される問題を修正。
  • キーカ配置変更をすると方向キーが正しく動作しない不具合を修正。
  • JStickIniSetPad命令実行時に、ファイルが見つからない場合は、statに0意外が返るように変更。
  • joyp_sample04.hspがHSP3.2βで動作しない問題を修正。
Ver.1.03
2008/10/30
  • 「コントローラーの設定」のデフォルト画像の変更。
  • 「コントローラーの設定」をスキンファイルへ対応させた。
Ver.1.02
2008/08/02
  • 「コントローラーの設定」でコントロールパネルのゲームコントローラダイアログを起動できるようにした。
  • 「コントローラーの設定」のレイアウト極微調整。
  • hsファイル付け忘れ+データ紛失してたので再作成して付けました。
Ver.1.01
2008/05/02
何修正したのか忘れました。orz
Ver.1.00
2008/05/01
  • マニュアル整備。(HTMLとHS
  • ジョイスティックによっては↑が押しっぱなしになるバグを修正。
  • サンプルの追加、修正。
Ver.0.5β
2008/04/16
  • アナログ入力も取得できるように変更。
  • スクリプトの整理、デバッグ、仕様変更。
Ver.0.4β 何やったか忘れました。orz
Ver.0.3
  • HSP3用に仕様変更。
  • CK JOYFORCE DLLおよびINI ELEMENTALモジュールがなくても単独で動作するように変更。
  • たくさんバグ取り。
Ver.0.2a
  • Ver.0.2ではうっかり作りかけの古いバージョンを公開してしまったので、最新版に差し替え。
  • ついでにキー表示をCK JOYFORCEのマニュアルに合わせるように修正。
PAD設定さん Ver.0.2
  • HSP用の汎用ソフトとして名前を変更。
  • psb_ece命令を追加。(外部プログラムの起動と終了待ち)
  • 汎用化のため細部を調整。
「コントローラーの設定
for PSBS」(バージョン 0.1)
PSBS専用ソフトとして完成。