MasaoJSS Helper
Canvas正男のJavaScript API（MasaoJSS）のドキュメントをVisual Studio Codeに統合する拡張機能です。
機能
- APIドキュメンテーション表示 - カーソルをMasaoJSSメソッド名に合わせると、そのメソッドの詳細な説明がホバー表示されます
- コード補完 - JavaScriptやTypeScriptなどのファイル編集時に、MasaoJSS APIのメソッド名が自動補完候補として表示されます
- 詳細な説明と使用例 - 各メソッドについて、概要、パラメータ、戻り値、使用例などの詳細情報を提供します
- 自動識別子検出 - コード内のuserJSCallback関数の引数名を自動検出し、様々な命名規則に対応します
インストール方法
- VS Codeの拡張機能ビュー（Ctrl+Shift+X）を開く
- 検索バーに「MasaoJSS Helper」と入力
- インストールボタンをクリック
または、以下の方法でもインストール可能です：
ext install urotaichi.masaojss-helper
使用方法
拡張機能をインストール後、JavaScript、TypeScript、HTML、PHPなどのサポート対象ファイルで作業する際に自動的に機能が有効になります。
Canvas正男のAPI呼び出しを入力すると、コード補完候補が表示されます：
userJSCallback: function(g, mode, view_x, view_y, ap) {
ap. // ← ここでMasaoJSSメソッド候補が表示されます
g. // ← ここでGraphicsメソッド候補が表示されます
}
既存のAPIメソッド上にカーソルを合わせると、詳細なドキュメントがホバー表示されます。
サポートしているファイル形式
- JavaScript (
.js)
- TypeScript (
.ts)
- JSX/TSX (
.jsx, .tsx)
- HTML (
.html)
- PHP (
.php)
対応APIメソッド
この拡張機能は以下のようなMasaoJSSメソッドをサポートしています：
ゲームシステム関連
getHighscore / getScore - スコア関連情報取得getMode - ゲームモード取得addScore / setScore - スコア操作getValue / getParamValue - パラメータ取得setValue / setParamValue - パラメータ設定restart - ゲーム再起動setTitleLock / startGame - タイトル・ゲーム開始制御getTimeLimit / setTimeLimit - 制限時間取得・設定getMyLeft / setMyLeft - 残機取得・設定
キャラクター制御
getMyX / getMyY - 主人公座標取得（ブロック単位）getMyXReal / getMyYReal - 主人公座標取得（ピクセル単位）setMyPosition - 主人公位置設定getMyVX / getMyVY - 主人公速度取得setMyVX / setMyVY - 主人公速度設定getMyDirection / setMyDirection - 主人公向き取得・設定setMyMiss - 主人公ミス処理setMyWait - 主人公一時停止設定setMyHP / getMyHP - HP設定・取得
入力制御
pressLeft / pressRight / pressUp / pressDown - 方向キー押下pressTrigger1 - ジャンプキー押下releaseAll - 全キー解放isPressZKey / isPressXKey / isPressSpaceKey - キー押下状態取得
マップ・オブジェクト関連
setMapchip / getMapchip - 標準レイヤーのマップチップ設定・取得setMapchip2 / getMapchip2 - 背景レイヤーのマップチップ設定・取得setEnemy / getEnemyTotal - 敵配置・取得newYuka / setYukaPosition - 床オブジェクト生成・制御getViewX / getViewY - 画面座標取得（ブロック単位）getViewXReal / getViewYReal - 画面座標取得（ピクセル単位）
画像・描画関連
newImageOnLoad - 画像読み込みnewChipImage - チップ画像作成setBackImage / setSecondImage - 背景画像設定setSystemDrawMode - 描画モード設定showGauge / hideGauge - ゲージ表示・非表示showMessage - メッセージ表示showImage - 画像表示
Graphicsクラスのメソッド
Canvas正男のGraphicsクラスメソッドも同様にサポートしています：
図形描画
drawLine - 線分描画drawRect / fillRect - 矩形描画・塗りつぶしdrawOval / fillOval - 楕円描画・塗りつぶしdrawArc / fillArc - 円弧描画・塗りつぶしdrawPolygon / fillPolygon - 多角形描画・塗りつぶし
画像描画
drawImage - 画像描画copyArea - 画像領域コピー
スタイル・テキスト
setColor - 描画色設定setFont - フォント設定setGlobalAlpha - 不透明度設定drawString - 文字列描画
座標変換
translate - 座標軸移動rotate - 座標軸回転scale - 座標軸拡大縮小setClip - クリッピング領域設定
リリースノート
最新のリリース情報はCHANGELOG.mdを参照してください。
フィードバックと貢献
バグの報告や新機能のリクエストは、GitHubリポジトリのIssuesページでお願いします。
ライセンス
このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSE.mdをご覧ください。
