@next2d/webgpu 3.0.4 → 3.1.0

package/src/Context.d.ts

@@ -9,423 +9,805 @@ import type { Node } from "@next2d/texture-packer";
  * @class
  */
 export declare class Context {
+    /** @description 変換行列スタック / Transform matrix stack */
     readonly $stack: Float32Array[];
+    /** @description 現在の2D変換行列 / Current 2D transform matrix */
     readonly $matrix: Float32Array;
+    /** @description 背景クリア色R / Background clear color R */
     $clearColorR: number;
+    /** @description 背景クリア色G / Background clear color G */
     $clearColorG: number;
+    /** @description 背景クリア色B / Background clear color B */
     $clearColorB: number;
+    /** @description 背景クリア色A / Background clear color A */
     $clearColorA: number;
+    /** @description メインアタッチメントオブジェクト / Main attachment object */
     $mainAttachmentObject: IAttachmentObject | null;
+    /** @description アタッチメントオブジェクトのスタック / Attachment object stack */
     readonly $stackAttachmentObject: IAttachmentObject[];
+    /** @description グローバルアルファ値 / Global alpha value */
     globalAlpha: number;
+    /** @description グローバル合成操作 / Global composite operation */
     globalCompositeOperation: IBlendMode;
+    /** @description 画像スムージングの有効/無効 / Whether image smoothing is enabled */
     imageSmoothingEnabled: boolean;
+    /** @description 塗りつぶしスタイル / Fill style color */
     $fillStyle: Float32Array;
+    /** @description 線スタイル / Stroke style color */
     $strokeStyle: Float32Array;
+    /** @description マスク描画範囲 / Mask drawing bounds */
     readonly maskBounds: IBounds;
+    /** @description 線の太さ / Line thickness */
     thickness: number;
+    /** @description 線端の形状 / Line cap style */
     caps: number;
+    /** @description 線の結合スタイル / Line joint style */
     joints: number;
+    /** @description マイターリミット / Miter limit */
     miterLimit: number;
+    /** @description GPUデバイス / GPU device instance */
     private device;
+    /** @description GPUキャンバスコンテキスト / GPU canvas context */
     private canvasContext;
+    /** @description 優先テクスチャフォーマット / Preferred texture format */
     private preferredFormat;
+    /** @description コマンドエンコーダー / Command encoder */
     private commandEncoder;
+    /** @description レンダーパスエンコーダー / Render pass encoder */
     private renderPassEncoder;
+    /** @description メインキャンバステクスチャ（最終表示用、フレームごとに1回取得） / Main canvas texture (for final display, acquired once per frame) */
     private mainTexture;
+    /** @description メインキャンバステクスチャビュー / Main canvas texture view */
     private mainTextureView;
+    /** @description フレーム開始済みフラグ / Whether the frame has been started */
     private frameStarted;
+    /** @description フレームごとの一時テクスチャ（endFrame()でdestroy） / Per-frame temporary textures (destroyed in endFrame()) */
     private frameTextures;
+    /** @description フレームごとのプール管理テクスチャ（endFrame()でプールに返却） / Per-frame pooled textures (returned to pool in endFrame()) */
     private pooledTextures;
+    /** @description フレームごとのレンダーテクスチャプール管理（endFrame()でプールに返却） / Per-frame render texture pool (returned to pool in endFrame()) */
     private pooledRenderTextures;
+    /** @description 現在のレンダーターゲット（メインまたはアトラス） / Current render target (could be main or atlas) */
     private currentRenderTarget;
+    /** @description 現在のビューポート幅（アトラス描画時はアトラスサイズ） / Current viewport width (atlas size during atlas rendering) */
     private viewportWidth;
+    /** @description 現在のビューポート高さ（アトラス描画時はアトラスサイズ） / Current viewport height (atlas size during atlas rendering) */
     private viewportHeight;
+    /** @description パスコマンド / Path command handler */
     private pathCommand;
+    /** @description バッファマネージャー / Buffer manager */
     private bufferManager;
+    /** @description テクスチャマネージャー / Texture manager */
     private textureManager;
+    /** @description フレームバッファマネージャー / Frame buffer manager */
     private frameBufferManager;
+    /** @description パイプラインマネージャー / Pipeline manager */
     private pipelineManager;
-    private computePipelineManager;
-    private attachmentManager;
+    /** @description 新しい描画状態フラグ / New draw state flag */
     newDrawState: boolean;
+    /** @description cacheAsBitmap用の保留中アトラスノードスタック / Pending atlas nodes stack for cacheAsBitmap */
+    private readonly _pendingAtlasNodes;
+    /** @description コンテナレイヤースタック（フィルター/ブレンド用） / Container layer stack (for filter/blend) */
     private readonly $containerLayerStack;
+    /** @description コンテナレイヤーのコンテンツサイズ / Container layer content sizes */
     private containerLayerContentSizes;
+    /** @description マスク描画モードフラグ（beginMask〜endMask間でtrue） / Mask drawing mode flag (true between beginMask and endMask) */
     private inMaskMode;
+    /** @description ノード領域クリア済みフラグ（beginNodeRendering〜endNodeRendering間で使用） / Node area cleared flag (used between beginNodeRendering and endNodeRendering) */
     private nodeAreaCleared;
+    /** @description 現在のノードのシザー範囲（クリア後に戻すため） / Current node scissor rect (to restore after clearing) */
     private currentNodeScissor;
+    /** @description アトラスレンダーパス統合: 同一アトラスへの連続描画でパスを再利用 / Atlas render pass integration: reuse pass for consecutive draws to the same atlas */
     private nodeRenderPassAtlasIndex;
+    /** @description Dynamic Uniform BindGroup（fill/stencilパイプライン共有、フレームごとに1回作成） / Dynamic Uniform BindGroup (shared by fill/stencil pipelines, created once per frame) */
     private fillDynamicBindGroup;
+    /** @description Dynamic Uniform BindGroupのバッファ / Dynamic Uniform BindGroup buffer */
     private fillDynamicBindGroupBuffer;
+    /** @description clearNodeArea() 用頂点バッファキャッシュ / Vertex buffer cache for clearNodeArea() */
     private nodeClearQuadBuffer;
+    /** @description Storage Buffer + Indirect Drawing を使用するかどうか / Whether to use Storage Buffer + Indirect Drawing */
     private useOptimizedInstancing;
+    /** @description リサイズ後にcanvasContextの再設定が必要かどうか / Whether canvasContext reconfiguration is needed after resize */
     private $needsReconfigure;
+    /** @description Hot Path 用の事前割り当てバッファ / Pre-allocated buffer for hot path */
     private readonly $uniformData8;
+    /** @description Hot Path 用の事前割り当てシザーレクト / Pre-allocated scissor rect for hot path */
     private readonly $scissorRect;
+    /** @description フィルター/コンテナレイヤー用のプリアロケートされた設定オブジェクト / Pre-allocated config object for filter/container layers */
     private readonly $filterConfig;
+    /**
+     * @description WebGPUコンテキストを初期化する
+     *              Initialize the WebGPU context
+     *
+     * @param  {GPUDevice} device - GPUデバイス / GPU device instance
+     * @param  {GPUCanvasContext} canvas_context - GPUキャンバスコンテキスト / GPU canvas context
+     * @param  {GPUTextureFormat} preferred_format - 優先テクスチャフォーマット / Preferred texture format
+     * @param  {number} device_pixel_ratio - デバイスピクセル比 / Device pixel ratio
+     */
     constructor(device: GPUDevice, canvas_context: GPUCanvasContext, preferred_format: GPUTextureFormat, device_pixel_ratio?: number);
     /**
      * @description 転送範囲をリセット（フレーム開始）
+     *              Reset transfer bounds (frame start)
+     *
+     * @return {void}
      */
     clearTransferBounds(): void;
     /**
      * @description 背景色を更新
+     *              Update the background color
+     *
+     * @param  {number} red   - 赤色成分 / Red component
+     * @param  {number} green - 緑色成分 / Green component
+     * @param  {number} blue  - 青色成分 / Blue component
+     * @param  {number} alpha - アルファ成分 / Alpha component
+     * @return {void}
      */
     updateBackgroundColor(red: number, green: number, blue: number, alpha: number): void;
     /**
      * @description 背景色で塗りつぶす（メインアタッチメント）
+     *              Fill with background color (main attachment)
+     *
+     * @return {void}
      */
     fillBackgroundColor(): void;
     /**
      * @description メインcanvasのサイズを変更
+     *              Resize the main canvas
+     *
+     * @param  {number}  width       - 新しい幅 / New width
+     * @param  {number}  height      - 新しい高さ / New height
+     * @param  {boolean} cache_clear - キャッシュをクリアするか / Whether to clear cache
+     * @return {void}
      */
     resize(width: number, height: number, cache_clear?: boolean): void;
-    /**
-     * @description 指定範囲をクリアする
-     */
-    clearRect(_x: number, _y: number, _w: number, _h: number): void;
     /**
      * @description 現在の2D変換行列を保存
+     *              Save the current 2D transform matrix
+     *
+     * @return {void}
      */
     save(): void;
     /**
      * @description 2D変換行列を復元
+     *              Restore the 2D transform matrix
+     *
+     * @return {void}
      */
     restore(): void;
     /**
      * @description 2D変換行列を設定
+     *              Set the 2D transform matrix
+     *
+     * @param  {number} a - 水平スケール / Horizontal scale
+     * @param  {number} b - 垂直スキュー / Vertical skew
+     * @param  {number} c - 水平スキュー / Horizontal skew
+     * @param  {number} d - 垂直スケール / Vertical scale
+     * @param  {number} e - 水平移動 / Horizontal translation
+     * @param  {number} f - 垂直移動 / Vertical translation
+     * @return {void}
      */
     setTransform(a: number, b: number, c: number, d: number, e: number, f: number): void;
     /**
      * @description 現在の2D変換行列に対して乗算を行います
+     *              Multiply the current 2D transform matrix
+     *
+     * @param  {number} a - 水平スケール / Horizontal scale
+     * @param  {number} b - 垂直スキュー / Vertical skew
+     * @param  {number} c - 水平スキュー / Horizontal skew
+     * @param  {number} d - 垂直スケール / Vertical scale
+     * @param  {number} e - 水平移動 / Horizontal translation
+     * @param  {number} f - 垂直移動 / Vertical translation
+     * @return {void}
      */
     transform(a: number, b: number, c: number, d: number, e: number, f: number): void;
     /**
      * @description コンテキストの値を初期化する
+     *              Reset all context values to their initial state
+     *
+     * @return {void}
      */
     reset(): void;
     /**
      * @description パスを開始
+     *              Begin a new path
+     *
+     * @return {void}
      */
     beginPath(): void;
     /**
      * @description パスを移動
+     *              Move the path to the specified point
+     *
+     * @param  {number} x - X座標 / X coordinate
+     * @param  {number} y - Y座標 / Y coordinate
+     * @return {void}
      */
     moveTo(x: number, y: number): void;
     /**
      * @description パスを線で結ぶ
+     *              Draw a line to the specified point
+     *
+     * @param  {number} x - X座標 / X coordinate
+     * @param  {number} y - Y座標 / Y coordinate
+     * @return {void}
      */
     lineTo(x: number, y: number): void;
     /**
      * @description 二次ベジェ曲線を描画
+     *              Draw a quadratic Bézier curve
+     *
+     * @param  {number} cx - 制御点X / Control point X
+     * @param  {number} cy - 制御点Y / Control point Y
+     * @param  {number} x  - 終点X / End point X
+     * @param  {number} y  - 終点Y / End point Y
+     * @return {void}
      */
     quadraticCurveTo(cx: number, cy: number, x: number, y: number): void;
     /**
      * @description 塗りつぶしスタイルを設定
+     *              Set the fill style color
+     *
+     * @param  {number} red   - 赤色成分 / Red component
+     * @param  {number} green - 緑色成分 / Green component
+     * @param  {number} blue  - 青色成分 / Blue component
+     * @param  {number} alpha - アルファ成分 / Alpha component
+     * @return {void}
      */
     fillStyle(red: number, green: number, blue: number, alpha: number): void;
     /**
      * @description 線のスタイルを設定
+     *              Set the stroke style color
+     *
+     * @param  {number} red   - 赤色成分 / Red component
+     * @param  {number} green - 緑色成分 / Green component
+     * @param  {number} blue  - 青色成分 / Blue component
+     * @param  {number} alpha - アルファ成分 / Alpha component
+     * @return {void}
      */
     strokeStyle(red: number, green: number, blue: number, alpha: number): void;
     /**
      * @description パスを閉じる
+     *              Close the current path
+     *
+     * @return {void}
      */
     closePath(): void;
     /**
      * @description 円弧を描画
+     *              Draw an arc
+     *
+     * @param  {number} x      - 中心X / Center X
+     * @param  {number} y      - 中心Y / Center Y
+     * @param  {number} radius - 半径 / Radius
+     * @return {void}
      */
     arc(x: number, y: number, radius: number): void;
     /**
      * @description 3次ベジェ曲線を描画
+     *              Draw a cubic Bézier curve
+     *
+     * @param  {number} cx1 - 第1制御点X / First control point X
+     * @param  {number} cy1 - 第1制御点Y / First control point Y
+     * @param  {number} cx2 - 第2制御点X / Second control point X
+     * @param  {number} cy2 - 第2制御点Y / Second control point Y
+     * @param  {number} x   - 終点X / End point X
+     * @param  {number} y   - 終点Y / End point Y
+     * @return {void}
      */
     bezierCurveTo(cx1: number, cy1: number, cx2: number, cy2: number, x: number, y: number): void;
     /**
      * @description 描画メソッド共通: レンダーパスの確保とノード領域クリア
+     *              Common drawing method: ensure render pass and clear node area
      *              fill(), stroke(), gradientFill(), bitmapFill(), gradientStroke(), bitmapStroke() で使用
+     *
+     * @return {void}
      */
     private ensureFillRenderPass;
     /**
      * @description 塗りつぶしを実行（Loop-Blinn方式対応）
+     *              Execute fill operation (with Loop-Blinn support)
+     *
+     * @return {void}
      */
     fill(): void;
     /**
      * @description Dynamic Uniform BindGroupを取得（フレーム内で初回呼び出し時に作成）
+     *              Get or create the Dynamic Uniform BindGroup (created on first call within a frame)
+     *
+     * @return {GPUBindGroup} Dynamic Uniform BindGroup
      */
     private getOrCreateFillDynamicBindGroup;
     /**
      * @description fill/stroke用のcolor/matrix uniformを書き込む
-     * FillUniforms構造体: color(vec4) + matrix0(vec4) + matrix1(vec4) + matrix2(vec4) = 64 bytes
-     * @return Dynamic Uniform Buffer内のアライメント済みオフセット
+     *              Write color/matrix uniform for fill/stroke operations
+     *              FillUniforms構造体: color(vec4) + matrix0(vec4) + matrix1(vec4) + matrix2(vec4) = 64 bytes
+     *
+     * @param  {number} red              - 赤色成分 / Red component
+     * @param  {number} green            - 緑色成分 / Green component
+     * @param  {number} blue             - 青色成分 / Blue component
+     * @param  {number} alpha            - アルファ成分 / Alpha component
+     * @param  {number} a                - 変換行列a / Transform matrix a
+     * @param  {number} b                - 変換行列b / Transform matrix b
+     * @param  {number} c                - 変換行列c / Transform matrix c
+     * @param  {number} d                - 変換行列d / Transform matrix d
+     * @param  {number} tx               - 変換行列tx / Transform matrix tx
+     * @param  {number} ty               - 変換行列ty / Transform matrix ty
+     * @param  {number} viewport_width   - ビューポート幅 / Viewport width
+     * @param  {number} viewport_height  - ビューポート高さ / Viewport height
+     * @return {number} Dynamic Uniform Buffer内のアライメント済みオフセット / Aligned offset in the Dynamic Uniform Buffer
      */
     private writeFillUniform;
     /**
      * @description 2パスステンシルフィル（アトラス用）
+     *              Two-pass stencil fill (for atlas)
+     *
+     * @param  {GPUBuffer}   vertex_buffer  - 頂点バッファ / Vertex buffer
+     * @param  {number}      vertex_count   - 頂点数 / Vertex count
+     * @param  {GPUBindGroup} bind_group    - バインドグループ / Bind group
+     * @param  {number}      uniform_offset - ユニフォームオフセット / Uniform offset
+     * @return {void}
      */
     private fillWithStencil;
     /**
      * @description 2パスステンシルフィル（メインキャンバス用）
+     *              Two-pass stencil fill (for main canvas)
+     *
+     * @param  {GPUBuffer}   vertex_buffer  - 頂点バッファ / Vertex buffer
+     * @param  {number}      vertex_count   - 頂点数 / Vertex count
+     * @param  {GPUBindGroup} bind_group    - バインドグループ / Bind group
+     * @param  {number}      uniform_offset - ユニフォームオフセット / Uniform offset
+     * @return {void}
      */
     private fillWithStencilMain;
     /**
      * @description 単純なフィル（ステンシルなし、キャンバス描画用）
+     *              Simple fill (no stencil, for canvas rendering)
+     *
+     * @param  {GPUBuffer}    vertex_buffer        - 頂点バッファ / Vertex buffer
+     * @param  {number}       vertex_count         - 頂点数 / Vertex count
+     * @param  {boolean}      use_stencil_pipeline - ステンシルパイプラインを使用するか / Whether to use stencil pipeline
+     * @param  {GPUBindGroup} bind_group           - バインドグループ / Bind group
+     * @param  {number}       uniform_offset       - ユニフォームオフセット / Uniform offset
+     * @return {void}
      */
     private fillSimple;
-    /**
-     * @description オフスクリーンアタッチメントにバインド
-     * WebGL: FrameBufferManagerBindAttachmentObjectService
-     */
-    bindAttachment(attachment: IAttachmentObject): void;
-    /**
-     * @description メインキャンバスにバインド
-     * WebGL: FrameBufferManagerUnBindAttachmentObjectService
-     */
-    unbindAttachment(): void;
-    /**
-     * @description アタッチメントオブジェクトを取得
-     * WebGL: FrameBufferManagerGetAttachmentObjectUseCase
-     */
-    getAttachmentObject(width: number, height: number, msaa?: boolean): IAttachmentObject;
-    /**
-     * @description アタッチメントオブジェクトを解放
-     * WebGL: FrameBufferManagerReleaseAttachmentObjectUseCase
-     */
-    releaseAttachment(attachment: IAttachmentObject): void;
     /**
      * @description 線の描画を実行（WebGL版と同じ仕様）
+     *              Execute stroke drawing (same specification as WebGL version)
      *              WebGL版と同様に、ストロークを塗りとして描画する
+     *
+     * @return {void}
      */
     stroke(): void;
     /**
      * @description グラデーションの塗りつぶしを実行
+     *              Execute gradient fill
+     *
+     * @param  {number}       type          - グラデーションタイプ / Gradient type
+     * @param  {number[]}     stops         - カラーストップ配列 / Color stop array
+     * @param  {Float32Array} matrix        - グラデーション変換行列 / Gradient transform matrix
+     * @param  {number}       spread        - スプレッドメソッド / Spread method
+     * @param  {number}       interpolation - 補間方法 / Interpolation method
+     * @param  {number}       focal         - 焦点距離 / Focal point ratio
+     * @return {void}
      */
     gradientFill(type: number, stops: number[], matrix: Float32Array, spread: number, interpolation: number, focal: number): void;
     /**
      * @description ビットマップの塗りつぶしを実行
+     *              Execute bitmap fill
+     *
+     * @param  {Uint8Array}   pixels - ピクセルデータ / Pixel data
+     * @param  {Float32Array} matrix - ビットマップ変換行列 / Bitmap transform matrix
+     * @param  {number}       width  - ビットマップ幅 / Bitmap width
+     * @param  {number}       height - ビットマップ高さ / Bitmap height
+     * @param  {boolean}      repeat - 繰り返しフラグ / Repeat flag
+     * @param  {boolean}      smooth - スムージングフラグ / Smoothing flag
+     * @return {void}
      */
     bitmapFill(pixels: Uint8Array, matrix: Float32Array, width: number, height: number, repeat: boolean, smooth: boolean): void;
     /**
      * @description グラデーション線の描画を実行
+     *              Execute gradient stroke drawing
+     *
+     * @param  {number}       type          - グラデーションタイプ / Gradient type
+     * @param  {number[]}     stops         - カラーストップ配列 / Color stop array
+     * @param  {Float32Array} matrix        - グラデーション変換行列 / Gradient transform matrix
+     * @param  {number}       spread        - スプレッドメソッド / Spread method
+     * @param  {number}       interpolation - 補間方法 / Interpolation method
+     * @param  {number}       focal         - 焦点距離 / Focal point ratio
+     * @return {void}
      */
     gradientStroke(type: number, stops: number[], matrix: Float32Array, spread: number, interpolation: number, focal: number): void;
     /**
      * @description ビットマップ線の描画を実行
+     *              Execute bitmap stroke drawing
+     *
+     * @param  {Uint8Array}   pixels - ピクセルデータ / Pixel data
+     * @param  {Float32Array} matrix - ビットマップ変換行列 / Bitmap transform matrix
+     * @param  {number}       width  - ビットマップ幅 / Bitmap width
+     * @param  {number}       height - ビットマップ高さ / Bitmap height
+     * @param  {boolean}      repeat - 繰り返しフラグ / Repeat flag
+     * @param  {boolean}      smooth - スムージングフラグ / Smoothing flag
+     * @return {void}
      */
     bitmapStroke(pixels: Uint8Array, matrix: Float32Array, width: number, height: number, repeat: boolean, smooth: boolean): void;
     /**
      * @description マスク処理を実行
+     *              Execute mask clipping operation
      *              WebGL版と同様にステンシルバッファを使用したクリッピング
      *              メインアタッチメントとアトラス両方でマスク処理をサポート
+     *
+     * @return {void}
      */
     clip(): void;
     /**
      * @description アタッチメントオブジェクトをバインド
+     *              Bind an attachment object
+     *
+     * @param  {IAttachmentObject} attachment_object - バインドするアタッチメント / Attachment to bind
+     * @return {void}
      */
     bind(attachment_object: IAttachmentObject): void;
     /**
      * @description 現在のアタッチメントオブジェクトを取得
+     *              Get the current attachment object
      *              アトラスがバインドされていない場合はメインアタッチメントを返す
      *              When no atlas is bound, returns the main attachment
+     *
+     * @return {IAttachmentObject | null} 現在のアタッチメント / Current attachment
      */
     get currentAttachmentObject(): IAttachmentObject | null;
     /**
      * @description アトラス専用のアタッチメントオブジェクトを取得
+     *              Get the atlas-specific attachment object
+     *
+     * @return {IAttachmentObject | null} アトラスアタッチメント / Atlas attachment
      */
     get atlasAttachmentObject(): IAttachmentObject | null;
     /**
      * @description グリッドの描画データをセット
+     *              Set grid drawing data
+     *
+     * @param  {Float32Array | null} grid_data - グリッドデータ / Grid data
+     * @return {void}
      */
     useGrid(grid_data: Float32Array | null): void;
     /**
      * @description 指定のノード範囲で描画を開始（アトラステクスチャへの描画）
+     *              Begin rendering for the specified node region (drawing to atlas texture)
      *              2パスステンシルフィル対応: ステンシルバッファ付きレンダーパスを使用
+     *
+     * @param  {Node} node - 描画対象ノード / Target node for rendering
+     * @return {void}
      */
     beginNodeRendering(node: Node): void;
     /**
      * @description ノード領域がまだクリアされていない場合にクリアを実行
+     *              Clear the node area if it has not been cleared yet
      *              最初の描画操作（fill, gradientFill, gradientStroke等）で呼び出される
+     *
+     * @return {void}
      */
     private ensureNodeAreaCleared;
     /**
      * @description ノード領域をクリア（透明色 + ステンシル=0）
+     *              Clear the node area (transparent color + stencil=0)
      *              WebGL版の gl.clear(COLOR_BUFFER_BIT | STENCIL_BUFFER_BIT) と同等
+     *
+     * @return {void}
      */
     private clearNodeArea;
     /**
      * @description 指定のノード範囲で描画を終了
+     *              End rendering for the current node region
      *              レンダーパスは終了しない（次のbeginNodeRenderingで再利用するため）
+     *
+     * @return {void}
      */
     endNodeRendering(): void;
     /**
      * @description 塗りの描画を実行
+     *              Execute fill drawing
+     *
+     * @return {void}
      */
     drawFill(): void;
     /**
      * @description インスタンスを描画
+     *              Draw a display object instance
+     *
+     * @param  {Node}         node            - 描画対象ノード / Target node
+     * @param  {number}       x_min           - バウンディングボックス左端 / Bounding box left
+     * @param  {number}       y_min           - バウンディングボックス上端 / Bounding box top
+     * @param  {number}       x_max           - バウンディングボックス右端 / Bounding box right
+     * @param  {number}       y_max           - バウンディングボックス下端 / Bounding box bottom
+     * @param  {Float32Array} color_transform - カラー変換パラメータ / Color transform parameters
+     * @return {void}
      */
     drawDisplayObject(node: Node, x_min: number, y_min: number, x_max: number, y_max: number, color_transform: Float32Array): void;
     /**
      * @description インスタンス配列を描画
      *              Draw instanced arrays
      *
-     * useOptimizedInstancingがtrueの場合、Storage BufferとIndirect Drawingを使用。
-     * - Storage Buffer: メモリアロケーション削減、CPU負荷15-25%軽減
-     * - Indirect Drawing: CPU-GPUオーバーヘッド5-15%削減
+     *              useOptimizedInstancingがtrueの場合、Storage BufferとIndirect Drawingを使用。
+     *              - Storage Buffer: メモリアロケーション削減、CPU負荷15-25%軽減
+     *              - Indirect Drawing: CPU-GPUオーバーヘッド5-15%削減
      *
+     * @return {void}
      */
     drawArraysInstanced(): void;
-    /**
-     * @description 最適化インスタンス描画の有効/無効を設定
-     *              Enable or disable optimized instancing
-     *
-     */
-    setOptimizedInstancing(enabled: boolean): void;
-    /**
-     * @description 最適化インスタンス描画が有効かどうか
-     *              Whether optimized instancing is enabled
-     *
-     */
-    isOptimizedInstancingEnabled(): boolean;
     /**
      * @description 複雑なブレンドモードのキューを処理
+     *              Process the complex blend mode queue
+     *
+     * @return {void}
      */
     private processComplexBlendQueue;
     /**
      * @description インスタンス配列をクリア
+     *              Clear instanced arrays
+     *
+     * @return {void}
      */
     clearArraysInstanced(): void;
     /**
      * @description ピクセルバッファをNodeの指定箇所に転送
+     *              Transfer pixel buffer to the specified position of the Node
      *              WebGPUでは、Shapeのシェーダーが-ndc.yでY軸反転しているため、
      *              Bitmapも同じ方向になるよう画像を上下反転して書き込む
+     *
+     * @param  {Node}       node   - 描画対象ノード / Target node
+     * @param  {Uint8Array} pixels - ピクセルデータ / Pixel data
+     * @return {void}
      */
     drawPixels(node: Node, pixels: Uint8Array): void;
     /**
      * @description 一時テクスチャ経由でピクセルデータをMSAAテクスチャに描画
+     *              Draw pixel data to MSAA texture via a temporary texture
+     *
+     * @param  {IAttachmentObject} attachment - アタッチメントオブジェクト / Attachment object
+     * @param  {Node}              node       - 描画対象ノード / Target node
+     * @param  {Uint8Array}        pixels     - ピクセルデータ / Pixel data
+     * @param  {number}            width      - 幅 / Width
+     * @param  {number}            height     - 高さ / Height
+     * @return {void}
      */
     private drawPixelsToMsaa;
     /**
      * @description OffscreenCanvasをNodeの指定箇所に転送
+     *              Transfer OffscreenCanvas to the specified position of the Node
      *              WebGPUでは、Shapeのシェーダーが-ndc.yでY軸反転しているため、
      *              Bitmapも同じ方向になるよう画像を上下反転して書き込む
+     *
+     * @param  {Node}                              node    - 描画対象ノード / Target node
+     * @param  {OffscreenCanvas | ImageBitmap}     element - 描画要素 / Element to draw
+     * @param  {boolean}                           flip_y  - Y軸反転フラグ / Y-axis flip flag
+     * @return {void}
      */
-    drawElement(node: Node, element: OffscreenCanvas | ImageBitmap, flipY?: boolean): void;
+    drawElement(node: Node, element: OffscreenCanvas | ImageBitmap, flip_y?: boolean): void;
     /**
      * @description 一時テクスチャ経由でMSAAテクスチャに直接描画
+     *              Draw to MSAA texture directly via a temporary texture
+     *
+     * @param  {IAttachmentObject}             attachment - アタッチメントオブジェクト / Attachment object
+     * @param  {Node}                          node       - 描画対象ノード / Target node
+     * @param  {OffscreenCanvas | ImageBitmap} element    - 描画要素 / Element to draw
+     * @param  {number}                        width      - 幅 / Width
+     * @param  {number}                        height     - 高さ / Height
+     * @param  {boolean}                       flip_y     - Y軸反転フラグ / Y-axis flip flag
+     * @return {void}
      */
     private drawElementToMsaa;
     /**
      * @description 一時テクスチャ経由で通常テクスチャに描画（非MSAA版）
+     *              Draw to a regular texture via a temporary texture (non-MSAA version)
+     *
+     * @param  {IAttachmentObject}             attachment - アタッチメントオブジェクト / Attachment object
+     * @param  {Node}                          node       - 描画対象ノード / Target node
+     * @param  {OffscreenCanvas | ImageBitmap} element    - 描画要素 / Element to draw
+     * @param  {number}                        width      - 幅 / Width
+     * @param  {number}                        height     - 高さ / Height
+     * @param  {boolean}                       flip_y     - Y軸反転フラグ / Y-axis flip flag
+     * @return {void}
      */
     private drawElementToTexture;
     /**
      * @description フィルターを適用
+     *              Apply filter effects
+     *
+     * @param  {Node}         node            - 描画対象ノード / Target node
+     * @param  {string}       _unique_key     - ユニークキー / Unique key
+     * @param  {boolean}      _updated        - 更新フラグ / Updated flag
+     * @param  {number}       width           - 幅 / Width
+     * @param  {number}       height          - 高さ / Height
+     * @param  {boolean}      _is_bitmap      - ビットマップかどうか / Whether it is a bitmap
+     * @param  {Float32Array} matrix          - 変換行列 / Transform matrix
+     * @param  {Float32Array} color_transform - カラー変換パラメータ / Color transform parameters
+     * @param  {IBlendMode}   blend_mode      - ブレンドモード / Blend mode
+     * @param  {Float32Array} bounds          - バウンディングボックス / Bounding box
+     * @param  {Float32Array} params          - フィルターパラメータ / Filter parameters
+     * @return {void}
      */
     applyFilter(node: Node, _unique_key: string, _updated: boolean, width: number, height: number, _is_bitmap: boolean, matrix: Float32Array, color_transform: Float32Array, blend_mode: IBlendMode, bounds: Float32Array, params: Float32Array): void;
     /**
      * @description コンテナのフィルター/ブレンド用のレイヤーを開始
      *              Begin a container layer for filter/blend processing
      *
+     * @param  {number} width  - レイヤー幅 / Layer width
+     * @param  {number} height - レイヤー高さ / Layer height
+     * @return {void}
      */
     containerBeginLayer(width: number, height: number): void;
     /**
      * @description コンテナのフィルター/ブレンド用レイヤーを終了し、結果を元のメインに合成
      *              End the container layer and composite the result back to the original main
      *
-     * @param  {IBlendMode} blend_mode
-     * @param  {Float32Array} matrix
-     * @param  {Float32Array | null} color_transform
-     * @param  {boolean} use_filter
-     * @param  {Float32Array | null} filter_bounds
-     * @param  {Float32Array | null} filter_params
-     * @param  {string} unique_key
-     * @param  {string} filter_key
+     * @param  {IBlendMode}          blend_mode      - ブレンドモード / Blend mode
+     * @param  {Float32Array}        matrix          - 変換行列 / Transform matrix
+     * @param  {Float32Array | null} color_transform - カラー変換パラメータ / Color transform parameters
+     * @param  {boolean}             use_filter      - フィルター使用フラグ / Whether to use filter
+     * @param  {Float32Array | null} filter_bounds   - フィルターバウンド / Filter bounds
+     * @param  {Float32Array | null} filter_params   - フィルターパラメータ / Filter parameters
+     * @param  {string}              unique_key      - ユニークキー / Unique key
+     * @param  {string}              filter_key      - フィルターキー / Filter key
+     * @return {void}
      */
     containerEndLayer(blend_mode: IBlendMode, matrix: Float32Array, color_transform: Float32Array | null, use_filter: boolean, filter_bounds: Float32Array | null, filter_params: Float32Array | null, unique_key: string, filter_key: string): void;
+    /**
+     * @description cacheAsBitmap: temp FBO作成→子要素描画開始
+     *              Begin container cacheAsBitmap: create temp bgra8unorm FBO for children,
+     *              allocate atlas node for later copy
+     *
+     * @param  {number} width  - ノード幅 / Node width
+     * @param  {number} height - ノード高さ / Node height
+     * @return {Node}
+     */
+    containerBeginAtlasNode(width: number, height: number): Node;
+    /**
+     * @description cacheAsBitmap: temp FBO→アトラスノードへコピー
+     *              End container cacheAsBitmap: copy temp FBO content to atlas node,
+     *              release temp FBO
+     *
+     * @return {void}
+     */
+    containerEndAtlasNode(): void;
+    /**
+     * @description temp FBOの内容をアトラスノード領域にコピー
+     *              Copy temp FBO content to the atlas node region using texture_copy pipeline
+     *
+     * @param  {IAttachmentObject} temp_attachment - コピー元のtemp FBO / Source temp FBO
+     * @param  {Node}              node            - コピー先のアトラスノード / Destination atlas node
+     * @return {void}
+     */
+    private copyTempToAtlasNode;
     /**
      * @description キャッシュされたコンテナフィルターテクスチャをメインに描画
      *              Draw a cached container filter texture to the main attachment
      *
-     * @param  {IBlendMode} blend_mode
-     * @param  {Float32Array} matrix
-     * @param  {Float32Array} color_transform
-     * @param  {Float32Array} filter_bounds
-     * @param  {string} unique_key
-     * @param  {string} filter_key
+     * @param  {IBlendMode}   blend_mode      - ブレンドモード / Blend mode
+     * @param  {Float32Array} matrix          - 変換行列 / Transform matrix
+     * @param  {Float32Array} color_transform - カラー変換パラメータ / Color transform parameters
+     * @param  {Float32Array} filter_bounds   - フィルターバウンド / Filter bounds
+     * @param  {string}       unique_key      - ユニークキー / Unique key
+     * @param  {string}       filter_key      - フィルターキー / Filter key
+     * @return {void}
      */
     containerDrawCachedFilter(blend_mode: IBlendMode, matrix: Float32Array, color_transform: Float32Array, filter_bounds: Float32Array, unique_key: string, filter_key: string): void;
     /**
      * @description メインテクスチャを確保（フレーム開始時に一度だけgetCurrentTexture呼び出し）
+     *              Ensure the main texture is acquired (calls getCurrentTexture once per frame)
+     *
+     * @return {void}
      */
     private ensureMainTexture;
     /**
      * @description 現在の描画ターゲットのテクスチャビューを取得
+     *              Get the texture view of the current render target
+     *
+     * @return {GPUTextureView} 現在のテクスチャビュー / Current texture view
      */
     private getCurrentTextureView;
     /**
      * @description コマンドエンコーダーが存在することを保証
+     *              Ensure the command encoder exists
+     *
+     * @return {void}
      */
     private ensureCommandEncoder;
     /**
      * @description フレーム開始（レンダリング開始前に呼ぶ）
+     *              Begin a new frame (call before rendering starts)
+     *
+     * @return {void}
      */
     beginFrame(): void;
     /**
      * @description フレームごとのプール管理テクスチャを追加（endFrame()でプールに返却）
+     *              Add a pooled texture for the current frame (returned to pool in endFrame())
+     *
+     * @param  {GPUTexture} texture - プール管理テクスチャ / Pooled texture
+     * @return {void}
      */
     addFrameTexture(texture: GPUTexture): void;
     /**
      * @description フレーム終了とコマンド送信（レンダリング完了後に呼ぶ）
+     *              End the frame and submit commands (call after rendering is complete)
+     *
+     * @return {void}
      */
     endFrame(): void;
     /**
      * @description コマンドを送信（後方互換性のため残す）
+     *              Submit commands (kept for backward compatibility)
+     *
+     * @return {void}
      */
     submit(): void;
     /**
      * @description ノードを作成
+     *              Create a node in the texture atlas
      *              アトラスがいっぱいの場合は新しいアトラスを作成して再試行
+     *
+     * @param  {number} width  - ノード幅 / Node width
+     * @param  {number} height - ノード高さ / Node height
+     * @return {Node} 作成されたノード / Created node
      */
     createNode(width: number, height: number): Node;
     /**
      * @description ノードを削除
+     *              Remove a node from the texture atlas
+     *
+     * @param  {Node} node - 削除対象ノード / Node to remove
+     * @return {void}
      */
     removeNode(node: Node): void;
     /**
      * @description フレームバッファの描画情報をキャンバスに転送
+     *              Transfer frame buffer contents to the canvas
      *              スワップチェーンはCopyDstをサポートしないため、レンダーパスでブリット
+     *
+     * @return {void}
      */
     transferMainCanvas(): void;
     /**
      * @description ImageBitmapを生成
+     *              Create an ImageBitmap from the current rendering result
+     *
+     * @param  {number} width  - 画像幅 / Image width
+     * @param  {number} height - 画像高さ / Image height
+     * @return {Promise<ImageBitmap>} 生成されたImageBitmap / Created ImageBitmap
      */
     createImageBitmap(width: number, height: number): Promise<ImageBitmap>;
     /**
      * @description マスク描画の開始準備
      *              Prepare to start drawing the mask
      *
+     * @return {void}
      */
     beginMask(): void;
     /**
      * @description マスクの描画範囲を設定
      *              Set the mask drawing bounds
      *
-     * @param  {number} x_min
-     * @param  {number} y_min
-     * @param  {number} x_max
-     * @param  {number} y_max
+     * @param  {number} x_min - 最小X座標 / Minimum X coordinate
+     * @param  {number} y_min - 最小Y座標 / Minimum Y coordinate
+     * @param  {number} x_max - 最大X座標 / Maximum X coordinate
+     * @param  {number} y_max - 最大Y座標 / Maximum Y coordinate
+     * @return {void}
      */
     setMaskBounds(x_min: number, y_min: number, x_max: number, y_max: number): void;
     /**
      * @description マスクの描画を終了
      *              End mask drawing
      *
+     * @return {void}
      */
     endMask(): void;
     /**
      * @description マスクの終了処理
-     *              Mask end processing
+     *              Mask end processing (leave the mask)
      *
+     * @return {void}
      */
     leaveMask(): void;
 }