next2d-development-mcp 1.1.2 → 1.1.4

package/dist/references/player-specs.md

@@ -265,6 +265,7 @@ DisplayObjectは、Next2D Playerにおける全ての表示オブジェクトの
 | `visible` | boolean | 表示オブジェクトが可視かどうか（デフォルト: true） |
 | `x` | number | 親DisplayObjectContainerのローカル座標を基準にしたX座標 |
 | `y` | number | 親DisplayObjectContainerのローカル座標を基準にしたY座標 |
+| `cacheAsBitmap` | Matrix \| null | ベクター描画やコンテナをビットマップとしてキャッシュするMatrix（nullで解除、Videoには適用不可） |
 
 ## メソッド (Methods)
 
@@ -377,6 +378,108 @@ const state = displayObject.getGlobalVariable("gameState");
 displayObject.clearGlobalVariable(); // 全てクリア
 ```
 
+### cacheAsBitmapの例
+
+`cacheAsBitmap`はベクター描画やコンテナをビットマップとしてキャッシュし、2回目以降の描画でキャッシュを再利用することでパフォーマンスを向上させるプロパティです。
+
+**適用対象クラス:**
+- `Shape` — ベクター描画のキャッシュ
+- `TextField` — テキスト描画のキャッシュ
+- `Sprite` — コンテナとその子要素をまとめてキャッシュ
+- `MovieClip` — コンテナとその子要素をまとめてキャッシュ
+
+> ⚠️ `Video`には適用できません。Videoは画像サイズが固定されているため、キャッシュの効果がありません。
+
+**Matrixの制限:**
+Matrixにはスケール値（a, d）のみ設定できます。回転（b, c）や移動（tx, ty）は無視されます。
+
+```typescript
+// ✅ 正しい使い方（スケールのみ設定）
+shape.cacheAsBitmap = new Matrix(1, 0, 0, 1, 0, 0);  // 等倍
+shape.cacheAsBitmap = new Matrix(2, 0, 0, 2, 0, 0);  // 2倍品質
+
+// ❌ 回転・移動の値は無視される
+shape.cacheAsBitmap = new Matrix(1, 0.5, 0.5, 1, 100, 200);  // b, c, tx, tyは無視
+```
+
+**利用用途の例:**
+
+1. **速度の速いアニメーション** — 高速で動くオブジェクトは視認性が低いため、キャッシュによる画質低下が目立たず、パフォーマンス向上が期待できます
+2. **静的な背景やUI部品** — 変化しないUI要素（パネル、装飾、アイコンなど）をキャッシュすることで毎フレームの再描画コストを削減できます
+3. **複雑なベクター描画** — パスが多い複雑なShapeをキャッシュすることで描画負荷を大幅に軽減できます
+
+```typescript
+const { Shape, Sprite } = next2d.display;
+const { Matrix } = next2d.geom;
+
+// 等倍でキャッシュ（1.0基準 = displayObjectのscaleX/scaleYに対する等倍）
+const shape = new Shape();
+shape.graphics.beginFill(0xFF0000).drawCircle(50, 50, 40).endFill();
+shape.cacheAsBitmap = new Matrix(1, 0, 0, 1, 0, 0);
+
+// 2倍の解像度でキャッシュ（自身のスケールの2倍品質）
+const hqShape = new Shape();
+hqShape.graphics.beginFill(0x00FF00).drawRect(0, 0, 100, 80).endFill();
+hqShape.cacheAsBitmap = new Matrix(2, 0, 0, 2, 0, 0);
+
+// scaleX/scaleYが反映される（キャッシュ品質 = Matrix × 自身のスケール × stageスケール）
+shape.scaleX = 2; // キャッシュ品質: 1 × 2 × stageScale
+shape.scaleY = 2;
+
+// 親のスケールはキャッシュ品質に影響しない（描画位置には反映される）
+const container = new Sprite();
+container.scaleX = 3;
+container.scaleY = 3;
+container.addChild(shape);
+
+// ヒットテスト・幅・高さはベクター基準
+const bounds = shape.getBounds(shape); // ベクターの境界を返す
+
+// キャッシュを解除
+shape.cacheAsBitmap = null;
+```
+
+### DisplayObjectContainerでのcacheAsBitmap
+
+`Sprite`や`MovieClip`などの`DisplayObjectContainer`に対しても`cacheAsBitmap`を設定できます。
+コンテナの全子要素をまとめてテクスチャにキャッシュし、以降のフレームではキャッシュされたテクスチャを再利用します。
+
+```typescript
+const { Shape, Sprite, MovieClip } = next2d.display;
+const { Matrix } = next2d.geom;
+
+// 複数の子要素を持つSprite
+const sprite = new Sprite();
+const rect = new Shape();
+rect.graphics.beginFill(0xFF0000).drawRect(0, 0, 100, 80).endFill();
+sprite.addChild(rect);
+const circle = new Shape();
+circle.graphics.beginFill(0x00FF00).drawCircle(50, 40, 30).endFill();
+sprite.addChild(circle);
+
+// コンテナ全体をビットマップキャッシュ
+sprite.cacheAsBitmap = new Matrix(1, 0, 0, 1, 0, 0);
+
+// MovieClipにも同様に適用可能
+const mc = new MovieClip();
+mc.cacheAsBitmap = new Matrix(1, 0, 0, 1, 0, 0);
+
+// キャッシュを解除（次フレームから通常描画に戻る）
+sprite.cacheAsBitmap = null;
+```
+
+**キャッシュの動作:**
+- 先祖や自身のスケールが変更されるとキャッシュが無効化され、次フレームで再生成されます
+- 位置（x, y）の変更ではキャッシュは維持され、描画位置のみ更新されます
+- スケールが頻繁に変化するアニメーション中はキャッシュが毎フレーム再生成されるため、アニメーション完了後の静的な状態で最も効果を発揮します
+
+**注意事項:**
+- **Matrixにはスケール値のみ設定可能**です（回転・移動は無視されます）
+- **Videoには適用できません**（固定サイズの画像データのため）
+- キャッシュ中は子要素の変更（追加・削除・プロパティ変更）が画面に反映されません
+- `stage.rendererScale`が変更されるとキャッシュが自動的に無効化されます
+- `filter`と`cacheAsBitmap`を同時に設定した場合、`cacheAsBitmap`が優先されます
+
 ## 関連項目
 
 - [MovieClip](/ja/reference/player/movie-clip)
@@ -727,6 +830,7 @@ classDiagram
 | `mouseChildren` | `boolean` | オブジェクトの子がマウスまたはユーザー入力デバイスに対応しているかどうかを判断する |
 | `mask` | `DisplayObject \| null` | 呼び出し元の表示オブジェクトをマスクする指定されたマスクオブジェクト |
 | `isContainerEnabled` | `boolean` | コンテナの機能を所持しているかを返却（読み取り専用） |
+| `cacheAsBitmap` | `Matrix \| null` | ベクター描画やコンテナをビットマップとしてキャッシュするMatrix（nullで解除） |
 
 ## メソッド
 
@@ -1160,7 +1264,8 @@ stage.addChild(frontShape);
 
 ```typescript
 // 複雑な図形をビットマップとしてキャッシュ
-shape.cacheAsBitmap = true;
+const { Matrix } = next2d.geom;
+shape.cacheAsBitmap = new Matrix(1, 0, 0, 1, 0, 0);
 ```
 
 ## Graphics クラス
@@ -1739,6 +1844,7 @@ classDiagram
 | `mouseY` | number | Yes | - | 対象のDisplayObjectの基準点からのy軸の位置（ピクセル） |
 | `dropTarget` | Sprite \| null | Yes | null | スプライトのドラッグ先またはドロップされた先の表示オブジェクト |
 | `isMask` | boolean | No | false | マスクとしてDisplayObjectにセットされているかを示します |
+| `cacheAsBitmap` | Matrix \| null | No | null | ベクター描画やコンテナをビットマップとしてキャッシュするMatrix（nullで解除） |
 
 ## メソッド
 
@@ -1992,6 +2098,12 @@ classDiagram
 | `xScrollShape` | Shape | xスクロールバーの表示用のShapeオブジェクト（読み取り専用） |
 | `yScrollShape` | Shape | yスクロールバーの表示用のShapeオブジェクト（読み取り専用） |
 
+### DisplayObjectから継承されるプロパティ
+
+| プロパティ | 型 | 説明 |
+|-----------|------|------|
+| `cacheAsBitmap` | Matrix \| null | テキスト描画をビットマップとしてキャッシュするMatrix（nullで解除） |
+
 ## メソッド
 
 | メソッド | 戻り値 | 説明 |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "next2d-development-mcp",
   "displayName": "Next2D Development MCP",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "MCP server for Next2D application development assistance",
   "type": "module",
   "author": "Toshiyuki Ienaga <ienaga@next2d.app>",
@@ -48,20 +48,20 @@
     ]
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1"
+    "@modelcontextprotocol/sdk": "^1.29.0"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@types/node": "^25.3.1",
-    "@types/vscode": "^1.109.0",
-    "@typescript-eslint/eslint-plugin": "^8.56.1",
-    "@typescript-eslint/parser": "^8.56.1",
+    "@types/node": "^25.5.2",
+    "@types/vscode": "^1.110.0",
+    "@typescript-eslint/eslint-plugin": "^8.58.0",
+    "@typescript-eslint/parser": "^8.58.0",
     "@vscode/vsce": "^3.7.1",
-    "eslint": "^10.0.2",
+    "eslint": "^10.2.0",
     "eslint-plugin-unused-imports": "^4.4.1",
-    "globals": "^17.3.0",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
+    "globals": "^17.4.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
   },
   "engines": {
     "node": ">=22.0.0",