@next2d/webgpu 3.0.4 → 3.1.0

package/src/BufferManager.js

@@ -4,16 +4,20 @@ import { execute as bufferManagerAcquireUniformBufferUseCase } from "./BufferMan
 import { execute as bufferManagerReleaseVertexBufferService } from "./BufferManager/service/BufferManagerReleaseVertexBufferService";
 import { execute as bufferManagerReleaseUniformBufferService } from "./BufferManager/service/BufferManagerReleaseUniformBufferService";
 import { execute as bufferManagerAcquireStorageBufferUseCase } from "./BufferManager/usecase/BufferManagerAcquireStorageBufferUseCase";
-import { execute as releaseStorageBufferUseCase } from "./BufferManager/usecase/BufferManagerReleaseStorageBufferUseCase";
 import { execute as cleanupStorageBuffersUseCase } from "./BufferManager/usecase/BufferManagerCleanupStorageBuffersUseCase";
 import { execute as bufferManagerCreateIndirectBufferService } from "./BufferManager/service/BufferManagerCreateIndirectBufferService";
 import { execute as updateIndirectBuffer } from "./BufferManager/service/BufferManagerUpdateIndirectBufferService";
 /**
- * @description Dynamic Uniform Buffer Allocator
- *              1フレーム内の全fill uniform データを1本の大バッファにサブアロケートし、
- *              BindGroup作成を1回に削減する。
+ * @description 動的Uniformバッファアロケータ。1フレーム内の全uniformデータを1本の大バッファにサブアロケートし、BindGroup作成を1回に削減
+ *              Dynamic Uniform Buffer Allocator. Sub-allocates all uniform data within a frame into a single large buffer, reducing BindGroup creation to once
  */
 export class DynamicUniformAllocator {
+    /**
+     * @description コンストラクタ。GPUデバイスとバッファ容量を設定
+     *              Constructor. Sets up GPU device and buffer capacity
+     * @param {GPUDevice} device - WebGPUデバイス
+     * @param {number} capacity - 初期バッファ容量（バイト単位、デフォルト: 65536）
+     */
     constructor(device, capacity = 65536) {
         Object.defineProperty(this, "device", {
             enumerable: true,
@@ -75,8 +79,9 @@ export class DynamicUniformAllocator {
         this.stagingFloat32 = new Float32Array(this.stagingBuffer);
     }
     /**
-     * @description フレーム開始時にオフセットをリセット
-     *              前フレームの旧バッファを安全に破棄（submit済みのため）
+     * @description フレーム開始時にオフセットをリセットし、前フレームの旧バッファを安全に破棄
+     *              Reset offset at frame start and safely destroy old buffers from previous frame
+     * @return {void}
      */
     resetFrame() {
         this.offset = 0;
@@ -88,6 +93,8 @@ export class DynamicUniformAllocator {
     }
     /**
      * @description バッファを取得（遅延生成）
+     *              Get buffer with lazy initialization
+     * @return {GPUBuffer} GPUバッファ
      */
     getBuffer() {
         if (!this.buffer) {
@@ -99,10 +106,10 @@ export class DynamicUniformAllocator {
         return this.buffer;
     }
     /**
-     * @description uniform データをCPUステージングバッファにコピーし、アライメント済みオフセットを返す
-     *              実際のGPU書き込みはflush()で一括実行される
-     * @param data - 書き込むデータ
-     * @return アライメント済みオフセット（バイト単位）
+     * @description uniformデータをCPUステージングバッファにコピーし、アライメント済みオフセットを返す。実際のGPU書き込みはflush()で一括実行
+     *              Copy uniform data to CPU staging buffer and return aligned offset. Actual GPU write is batched in flush()
+     * @param {Float32Array} data - 書き込むデータ
+     * @return {number} アライメント済みオフセット（バイト単位）
      */
     allocate(data) {
         // バッファの遅延生成
@@ -142,8 +149,9 @@ export class DynamicUniformAllocator {
         return alignedOffset;
     }
     /**
-     * @description ステージングバッファの内容をGPUバッファに一括書き込み
-     *              submit前に1回だけ呼び出す
+     * @description ステージングバッファの内容をGPUバッファに一括書き込み。submit前に1回だけ呼び出す
+     *              Flush staging buffer content to GPU buffer in bulk. Call once before submit
+     * @return {void}
      */
     flush() {
         if (this.dirtyEnd > 0 && this.buffer) {
@@ -151,6 +159,11 @@ export class DynamicUniformAllocator {
             this.dirtyEnd = 0;
         }
     }
+    /**
+     * @description バッファを破棄してリソースを解放
+     *              Dispose buffers and release resources
+     * @return {void}
+     */
     dispose() {
         if (this.buffer) {
             this.buffer.destroy();
@@ -162,7 +175,16 @@ export class DynamicUniformAllocator {
         this.pendingDestroyBuffers.length = 0;
     }
 }
+/**
+ * @description GPUバッファの管理クラス。頂点・ユニフォーム・ストレージ・インダイレクトバッファのプール管理と再利用を提供
+ *              GPU buffer management class. Provides pooling and reuse for vertex, uniform, storage, and indirect buffers
+ */
 export class BufferManager {
+    /**
+     * @description コンストラクタ。GPUデバイスを設定し、各種バッファプールを初期化
+     *              Constructor. Sets up GPU device and initializes buffer pools
+     * @param {GPUDevice} device - WebGPUデバイス
+     */
     constructor(device) {
         Object.defineProperty(this, "device", {
             enumerable: true,
@@ -170,18 +192,6 @@ export class BufferManager {
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "vertexBuffers", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "uniformBuffers", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
         Object.defineProperty(this, "vertexBufferBuckets", {
             enumerable: true,
             configurable: true,
@@ -200,12 +210,6 @@ export class BufferManager {
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "indirectBuffer", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
         Object.defineProperty(this, "indirectBufferPool", {
             enumerable: true,
             configurable: true,
@@ -249,12 +253,9 @@ export class BufferManager {
             value: void 0
         });
         this.device = device;
-        this.vertexBuffers = new Map();
-        this.uniformBuffers = new Map();
         this.vertexBufferBuckets = new Map();
         this.uniformBufferBuckets = new Map();
         this.storageBufferPool = [];
-        this.indirectBuffer = null;
         this.indirectBufferPool = [];
         this.frameIndirectBuffers = [];
         this.frameNumber = 0;
@@ -263,90 +264,60 @@ export class BufferManager {
         this.frameUniformPoolBuffers = [];
         this.dynamicUniform = new DynamicUniformAllocator(device);
     }
-    createVertexBuffer(name, data) {
-        const buffer = this.device.createBuffer({
-            "size": data.byteLength,
-            "usage": GPUBufferUsage.VERTEX | GPUBufferUsage.COPY_DST,
-            "mappedAtCreation": true
-        });
-        new Float32Array(buffer.getMappedRange()).set(data);
-        buffer.unmap();
-        this.vertexBuffers.set(name, buffer);
-        return buffer;
-    }
-    createUniformBuffer(name, size) {
-        const buffer = this.device.createBuffer({
-            "size": size,
-            "usage": GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST
-        });
-        this.uniformBuffers.set(name, buffer);
-        return buffer;
-    }
-    updateUniformBuffer(name, data) {
-        const buffer = this.uniformBuffers.get(name);
-        if (buffer) {
-            this.device.queue.writeBuffer(buffer, 0, data.buffer, data.byteOffset, data.byteLength);
-        }
-    }
-    getVertexBuffer(name) {
-        return this.vertexBuffers.get(name);
-    }
-    getUniformBuffer(name) {
-        return this.uniformBuffers.get(name);
-    }
+    /**
+     * @description 矩形の頂点データを作成
+     *              Create rect vertices data
+     * @param {number} x - X座標
+     * @param {number} y - Y座標
+     * @param {number} width - 幅
+     * @param {number} height - 高さ
+     * @return {Float32Array} 矩形の頂点データ
+     */
     createRectVertices(x, y, width, height) {
         return bufferManagerCreateRectVerticesService(x, y, width, height);
     }
-    acquireVertexBuffer(requiredSize, data) {
-        const buffer = bufferManagerAcquireVertexBufferUseCase(this.device, this.vertexBufferBuckets, requiredSize, data);
+    /**
+     * @description プールから頂点バッファを取得（または新規作成）
+     *              Acquire vertex buffer from pool or create new one
+     * @param {number} required_size - 必要なバイトサイズ
+     * @param {Float32Array} [data] - 初期データ
+     * @return {GPUBuffer} 取得された頂点バッファ
+     */
+    acquireVertexBuffer(required_size, data) {
+        const buffer = bufferManagerAcquireVertexBufferUseCase(this.device, this.vertexBufferBuckets, required_size, data);
         this.frameVertexPoolBuffers.push(buffer);
         return buffer;
     }
-    releaseVertexBuffer(buffer) {
-        bufferManagerReleaseVertexBufferService(this.vertexBufferBuckets, buffer);
-    }
-    acquireUniformBuffer(requiredSize) {
-        const buffer = bufferManagerAcquireUniformBufferUseCase(this.device, this.uniformBufferBuckets, requiredSize);
+    /**
+     * @description プールからユニフォームバッファを取得（または新規作成）
+     *              Acquire uniform buffer from pool or create new one
+     * @param {number} required_size - 必要なバイトサイズ
+     * @return {GPUBuffer} 取得されたユニフォームバッファ
+     */
+    acquireUniformBuffer(required_size) {
+        const buffer = bufferManagerAcquireUniformBufferUseCase(this.device, this.uniformBufferBuckets, required_size);
         this.frameUniformPoolBuffers.push(buffer);
         return buffer;
     }
     /**
      * @description Uniform Bufferの取得と書き込みを一括で行うヘルパー
-     *              acquireUniformBuffer + writeBuffer の2ステップを1呼び出しに統合
-     * @param data - 書き込むデータ
-     * @param byteLength - 書き込みバイト数（省略時はdata.byteLength）
-     * @return GPUBuffer
+     *              Helper to acquire and write uniform buffer in one call, combining acquireUniformBuffer + writeBuffer
+     * @param {Float32Array} data - 書き込むデータ
+     * @param {number} [byte_length] - 書き込みバイト数（省略時はdata.byteLength）
+     * @return {GPUBuffer} 取得されたユニフォームバッファ
      */
-    acquireAndWriteUniformBuffer(data, byteLength) {
-        const writeBytes = byteLength ?? data.byteLength;
+    acquireAndWriteUniformBuffer(data, byte_length) {
+        const writeBytes = byte_length ?? data.byteLength;
         const buffer = this.acquireUniformBuffer(writeBytes);
         this.device.queue.writeBuffer(buffer, 0, data.buffer, data.byteOffset, writeBytes);
         return buffer;
     }
-    releaseUniformBuffer(buffer) {
-        bufferManagerReleaseUniformBufferService(this.uniformBufferBuckets, buffer);
-    }
-    destroyBuffer(name) {
-        const vertexBuffer = this.vertexBuffers.get(name);
-        if (vertexBuffer) {
-            vertexBuffer.destroy();
-            this.vertexBuffers.delete(name);
-        }
-        const uniformBuffer = this.uniformBuffers.get(name);
-        if (uniformBuffer) {
-            uniformBuffer.destroy();
-            this.uniformBuffers.delete(name);
-        }
-    }
+    /**
+     * @description 全バッファを破棄してリソースを解放
+     *              Dispose all buffers and release resources
+     * @return {void}
+     */
     dispose() {
-        for (const buffer of this.vertexBuffers.values()) {
-            buffer.destroy();
-        }
-        this.vertexBuffers.clear();
-        for (const buffer of this.uniformBuffers.values()) {
-            buffer.destroy();
-        }
-        this.uniformBuffers.clear();
         for (const bucket of this.vertexBufferBuckets.values()) {
             for (const buffer of bucket) {
                 buffer.destroy();
@@ -363,10 +334,6 @@ export class BufferManager {
             entry.buffer.destroy();
         }
         this.storageBufferPool = [];
-        if (this.indirectBuffer) {
-            this.indirectBuffer.destroy();
-            this.indirectBuffer = null;
-        }
         for (const buffer of this.indirectBufferPool) {
             buffer.destroy();
         }
@@ -383,29 +350,12 @@ export class BufferManager {
         this.frameUniformPoolBuffers.length = 0;
         this.dynamicUniform.dispose();
     }
-    getPoolStats() {
-        let vertexCount = 0;
-        for (const bucket of this.vertexBufferBuckets.values()) {
-            vertexCount += bucket.length;
-        }
-        let uniformCount = 0;
-        for (const bucket of this.uniformBufferBuckets.values()) {
-            uniformCount += bucket.length;
-        }
-        return {
-            "vertexPoolSize": vertexCount,
-            "uniformPoolSize": uniformCount
-        };
-    }
+    /**
+     * @description フレーム内で使用したバッファをクリアし、プールに返却
+     *              Clear frame buffers and return them to pool
+     * @return {void}
+     */
     clearFrameBuffers() {
-        for (const buffer of this.vertexBuffers.values()) {
-            buffer.destroy();
-        }
-        this.vertexBuffers.clear();
-        for (const buffer of this.uniformBuffers.values()) {
-            buffer.destroy();
-        }
-        this.uniformBuffers.clear();
         // フレーム内で取得したプールバッファをプールに返却
         for (const buffer of this.frameVertexPoolBuffers) {
             bufferManagerReleaseVertexBufferService(this.vertexBufferBuckets, buffer);
@@ -427,40 +377,60 @@ export class BufferManager {
             cleanupStorageBuffersUseCase(this.storageBufferPool, this.frameNumber);
         }
     }
+    /**
+     * @description 全てのStorage Bufferを未使用状態に戻す
+     *              Mark all storage buffers as not in use
+     * @return {void}
+     */
     releaseAllStorageBuffers() {
         for (const entry of this.storageBufferPool) {
             entry.inUse = false;
         }
     }
-    acquireStorageBuffer(requiredSize) {
-        return bufferManagerAcquireStorageBufferUseCase(this.device, this.storageBufferPool, requiredSize, this.frameNumber);
-    }
-    releaseStorageBuffer(buffer) {
-        releaseStorageBufferUseCase(this.storageBufferPool, buffer);
+    /**
+     * @description プールからStorage Bufferを取得（または新規作成）
+     *              Acquire storage buffer from pool or create new one
+     * @param {number} required_size - 必要なバイトサイズ
+     * @return {GPUBuffer} 取得されたStorage Buffer
+     */
+    acquireStorageBuffer(required_size) {
+        return bufferManagerAcquireStorageBufferUseCase(this.device, this.storageBufferPool, required_size, this.frameNumber);
     }
+    /**
+     * @description Storage Bufferにデータを書き込む
+     *              Write data to storage buffer
+     * @param {GPUBuffer} buffer - 書き込み先バッファ
+     * @param {Float32Array | Uint32Array} data - 書き込むデータ
+     * @return {void}
+     */
     writeStorageBuffer(buffer, data) {
         this.device.queue.writeBuffer(buffer, 0, data.buffer, data.byteOffset, data.byteLength);
     }
-    getOrCreateIndirectBuffer(vertexCount, instanceCount, firstVertex = 0, firstInstance = 0) {
-        if (!this.indirectBuffer) {
-            this.indirectBuffer = bufferManagerCreateIndirectBufferService(this.device, vertexCount, instanceCount, firstVertex, firstInstance);
-        }
-        else {
-            updateIndirectBuffer(this.device, this.indirectBuffer, vertexCount, instanceCount, firstVertex, firstInstance);
-        }
-        return this.indirectBuffer;
-    }
-    createIndirectBuffer(vertexCount, instanceCount, firstVertex = 0, firstInstance = 0) {
+    /**
+     * @description 新しいIndirect Bufferを作成（プールから再利用または新規作成）
+     *              Create new indirect buffer (reuse from pool or create new)
+     * @param {number} vertex_count - 頂点数
+     * @param {number} instance_count - インスタンス数
+     * @param {number} first_vertex - 開始頂点インデックス
+     * @param {number} first_instance - 開始インスタンスインデックス
+     * @return {GPUBuffer} 作成されたIndirect Buffer
+     */
+    createIndirectBuffer(vertex_count, instance_count, first_vertex = 0, first_instance = 0) {
         let buffer = this.indirectBufferPool.pop();
         if (buffer) {
-            updateIndirectBuffer(this.device, buffer, vertexCount, instanceCount, firstVertex, firstInstance);
+            updateIndirectBuffer(this.device, buffer, vertex_count, instance_count, first_vertex, first_instance);
         }
         else {
-            buffer = bufferManagerCreateIndirectBufferService(this.device, vertexCount, instanceCount, firstVertex, firstInstance);
+            buffer = bufferManagerCreateIndirectBufferService(this.device, vertex_count, instance_count, first_vertex, first_instance);
         }
         this.frameIndirectBuffers.push(buffer);
         return buffer;
     }
+    /**
+     * @description 単位矩形（0,0,1,1）の頂点バッファを取得（遅延生成）
+     *              Get unit rect (0,0,1,1) vertex buffer with lazy creation
+     * @return {GPUBuffer} 単位矩形の頂点バッファ
+     */
     getUnitRectBuffer() {
         if (!this.unitRectBuffer) {
             const vertices = this.createRectVertices(0, 0, 1, 1);
@@ -474,14 +444,4 @@ export class BufferManager {
         }
         return this.unitRectBuffer;
     }
-    getFrameNumber() {
-        return this.frameNumber;
-    }
-    getStoragePoolStats() {
-        const inUse = this.storageBufferPool.filter((e) => e.inUse).length;
-        return {
-            "storagePoolSize": this.storageBufferPool.length,
-            "storagePoolInUse": inUse
-        };
-    }
 }

package/src/Context/service/ContextComputeBitmapMatrixService.d.ts

@@ -1 +1,8 @@
+/**
+ * @description ビットマップ行列とコンテキスト行列からテクスチャマッピング用の逆行列を計算する
+ *              Computes the inverse matrix for texture mapping from bitmap and context matrices
+ * @param {Float32Array} bitmap_matrix ビットマップ変換行列 / Bitmap transformation matrix
+ * @param {Float32Array} context_matrix コンテキスト変換行列 / Context transformation matrix
+ * @return {Float32Array} 列優先形式の3x3逆行列 / Column-major 3x3 inverse matrix
+ */
 export declare const execute: (bitmap_matrix: Float32Array, context_matrix: Float32Array) => Float32Array;

package/src/Context/service/ContextComputeBitmapMatrixService.js

@@ -1,3 +1,10 @@
+/**
+ * @description ビットマップ行列とコンテキスト行列からテクスチャマッピング用の逆行列を計算する
+ *              Computes the inverse matrix for texture mapping from bitmap and context matrices
+ * @param {Float32Array} bitmap_matrix ビットマップ変換行列 / Bitmap transformation matrix
+ * @param {Float32Array} context_matrix コンテキスト変換行列 / Context transformation matrix
+ * @return {Float32Array} 列優先形式の3x3逆行列 / Column-major 3x3 inverse matrix
+ */
 export const execute = (bitmap_matrix, context_matrix) => {
     // ビットマップ行列 [a, b, c, d, tx, ty]
     const ba = bitmap_matrix[0];

package/src/Context/service/ContextComputeGradientMatrixService.d.ts

@@ -1,4 +1,12 @@
-export declare const execute: (gradientMatrix: Float32Array, _contextMatrix: Float32Array, type: number) => {
+/**
+ * @description グラデーション行列からグラデーション描画用の逆行列とリニアポイントを計算する
+ *              Computes inverse matrix and linear points for gradient rendering from gradient matrix
+ * @param {Float32Array} gradient_matrix グラデーション変換行列 / Gradient transformation matrix
+ * @param {Float32Array} _context_matrix コンテキスト変換行列（未使用） / Context transformation matrix (unused)
+ * @param {number} type グラデーションタイプ (0: linear, 1: radial) / Gradient type (0: linear, 1: radial)
+ * @return {{ inverseMatrix: Float32Array; linearPoints: Float32Array | null }} 逆行列とリニアポイント / Inverse matrix and linear points
+ */
+export declare const execute: (gradient_matrix: Float32Array, _context_matrix: Float32Array, type: number) => {
     inverseMatrix: Float32Array;
     linearPoints: Float32Array | null;
 };

package/src/Context/service/ContextComputeGradientMatrixService.js

@@ -1,11 +1,19 @@
-export const execute = (gradientMatrix, _contextMatrix, type) => {
+/**
+ * @description グラデーション行列からグラデーション描画用の逆行列とリニアポイントを計算する
+ *              Computes inverse matrix and linear points for gradient rendering from gradient matrix
+ * @param {Float32Array} gradient_matrix グラデーション変換行列 / Gradient transformation matrix
+ * @param {Float32Array} _context_matrix コンテキスト変換行列（未使用） / Context transformation matrix (unused)
+ * @param {number} type グラデーションタイプ (0: linear, 1: radial) / Gradient type (0: linear, 1: radial)
+ * @return {{ inverseMatrix: Float32Array; linearPoints: Float32Array | null }} 逆行列とリニアポイント / Inverse matrix and linear points
+ */
+export const execute = (gradient_matrix, _context_matrix, type) => {
     // グラデーション行列
-    const ga = gradientMatrix[0];
-    const gb = gradientMatrix[1];
-    const gc = gradientMatrix[2];
-    const gd = gradientMatrix[3];
-    const gtx = gradientMatrix[4];
-    const gty = gradientMatrix[5];
+    const ga = gradient_matrix[0];
+    const gb = gradient_matrix[1];
+    const gc = gradient_matrix[2];
+    const gd = gradient_matrix[3];
+    const gtx = gradient_matrix[4];
+    const gty = gradient_matrix[5];
     if (type === 0) {
         // === Linear gradient ===
         // WebGL版と同じ: $linearGradientXY(matrix)で点a, bを計算

package/src/Context/service/ContextFillSimpleService.d.ts

@@ -1,2 +1,16 @@
 import type { PipelineManager } from "../../Shader/PipelineManager";
+/**
+ * @description シンプルなフィル描画を実行する
+ *              Executes simple fill rendering
+ * @param {GPURenderPassEncoder} render_pass_encoder レンダーパスエンコーダ / Render pass encoder
+ * @param {PipelineManager} pipeline_manager パイプラインマネージャ / Pipeline manager
+ * @param {GPUBuffer} vertex_buffer 頂点バッファ / Vertex buffer
+ * @param {number} vertex_count 頂点数 / Vertex count
+ * @param {GPUBindGroup} bind_group バインドグループ / Bind group
+ * @param {number} uniform_offset ユニフォームオフセット / Uniform offset
+ * @param {boolean} use_atlas_target アトラスターゲット使用フラグ / Whether to use atlas target
+ * @param {boolean} use_stencil_pipeline ステンシルパイプライン使用フラグ / Whether to use stencil pipeline
+ * @param {number} _clip_level クリップレベル（未使用） / Clip level (unused)
+ * @return {void}
+ */
 export declare const execute: (render_pass_encoder: GPURenderPassEncoder, pipeline_manager: PipelineManager, vertex_buffer: GPUBuffer, vertex_count: number, bind_group: GPUBindGroup, uniform_offset: number, use_atlas_target: boolean, use_stencil_pipeline?: boolean, _clip_level?: number) => void;

package/src/Context/service/ContextFillSimpleService.js

@@ -1,4 +1,18 @@
 import { $isMaskDrawing, $getMaskStencilReference } from "../../Mask";
+/**
+ * @description シンプルなフィル描画を実行する
+ *              Executes simple fill rendering
+ * @param {GPURenderPassEncoder} render_pass_encoder レンダーパスエンコーダ / Render pass encoder
+ * @param {PipelineManager} pipeline_manager パイプラインマネージャ / Pipeline manager
+ * @param {GPUBuffer} vertex_buffer 頂点バッファ / Vertex buffer
+ * @param {number} vertex_count 頂点数 / Vertex count
+ * @param {GPUBindGroup} bind_group バインドグループ / Bind group
+ * @param {number} uniform_offset ユニフォームオフセット / Uniform offset
+ * @param {boolean} use_atlas_target アトラスターゲット使用フラグ / Whether to use atlas target
+ * @param {boolean} use_stencil_pipeline ステンシルパイプライン使用フラグ / Whether to use stencil pipeline
+ * @param {number} _clip_level クリップレベル（未使用） / Clip level (unused)
+ * @return {void}
+ */
 export const execute = (render_pass_encoder, pipeline_manager, vertex_buffer, vertex_count, bind_group, uniform_offset, use_atlas_target, use_stencil_pipeline = false, _clip_level = 1) => {
     let pipelineName;
     if (use_atlas_target) {

package/src/Context/service/ContextFillWithStencilMainService.d.ts

@@ -1,2 +1,13 @@
 import type { PipelineManager } from "../../Shader/PipelineManager";
+/**
+ * @description メインキャンバス向けのステンシル書き込みとフィル描画を2パスで実行する
+ *              Executes two-pass stencil write and fill rendering for the main canvas
+ * @param {GPURenderPassEncoder} render_pass_encoder レンダーパスエンコーダ / Render pass encoder
+ * @param {PipelineManager} pipeline_manager パイプラインマネージャ / Pipeline manager
+ * @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}
+ */
 export declare const execute: (render_pass_encoder: GPURenderPassEncoder, pipeline_manager: PipelineManager, vertex_buffer: GPUBuffer, vertex_count: number, bind_group: GPUBindGroup, uniform_offset: number) => void;

package/src/Context/service/ContextFillWithStencilMainService.js

@@ -1,3 +1,14 @@
+/**
+ * @description メインキャンバス向けのステンシル書き込みとフィル描画を2パスで実行する
+ *              Executes two-pass stencil write and fill rendering for the main canvas
+ * @param {GPURenderPassEncoder} render_pass_encoder レンダーパスエンコーダ / Render pass encoder
+ * @param {PipelineManager} pipeline_manager パイプラインマネージャ / Pipeline manager
+ * @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}
+ */
 export const execute = (render_pass_encoder, pipeline_manager, vertex_buffer, vertex_count, bind_group, uniform_offset) => {
     // === Pass 1: ステンシル書き込み（両面を1回で処理） ===
     const stencilWritePipeline = pipeline_manager.getPipeline("stencil_write_main");

package/src/Context/service/ContextFillWithStencilService.d.ts

@@ -1,2 +1,13 @@
 import type { PipelineManager } from "../../Shader/PipelineManager";
+/**
+ * @description アトラスターゲット向けのステンシル書き込みとフィル描画を2パスで実行する
+ *              Executes two-pass stencil write and fill rendering for the atlas target
+ * @param {GPURenderPassEncoder} render_pass_encoder レンダーパスエンコーダ / Render pass encoder
+ * @param {PipelineManager} pipeline_manager パイプラインマネージャ / Pipeline manager
+ * @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}
+ */
 export declare const execute: (render_pass_encoder: GPURenderPassEncoder, pipeline_manager: PipelineManager, vertex_buffer: GPUBuffer, vertex_count: number, bind_group: GPUBindGroup, uniform_offset: number) => void;

package/src/Context/service/ContextFillWithStencilService.js

@@ -1,3 +1,14 @@
+/**
+ * @description アトラスターゲット向けのステンシル書き込みとフィル描画を2パスで実行する
+ *              Executes two-pass stencil write and fill rendering for the atlas target
+ * @param {GPURenderPassEncoder} render_pass_encoder レンダーパスエンコーダ / Render pass encoder
+ * @param {PipelineManager} pipeline_manager パイプラインマネージャ / Pipeline manager
+ * @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}
+ */
 export const execute = (render_pass_encoder, pipeline_manager, vertex_buffer, vertex_count, bind_group, uniform_offset) => {
     // === Pass 1: ステンシル書き込み（両面を1回で処理） ===
     const stencilWritePipeline = pipeline_manager.getPipeline("stencil_write_atlas");

package/src/Context/usecase/ContextApplyFilterUseCase.d.ts

@@ -2,4 +2,21 @@ import type { Node } from "@next2d/texture-packer";
 import type { IBlendMode } from "../../interface/IBlendMode";
 import type { ILocalFilterConfig } from "../../interface/ILocalFilterConfig";
 import type { BufferManager } from "../../BufferManager";
+/**
+ * @description フィルターを適用してメインキャンバスに描画する
+ *              Applies filters and draws the result to the main canvas
+ * @param {Node} node テクスチャパッカーノード / Texture packer node
+ * @param {number} width 幅 / Width
+ * @param {number} height 高さ / Height
+ * @param {boolean} is_bitmap ビットマップフラグ / Whether the source is a bitmap
+ * @param {Float32Array} matrix 変換行列 / Transformation matrix
+ * @param {Float32Array} color_transform カラートランスフォーム配列 / Color transform array
+ * @param {IBlendMode} blend_mode ブレンドモード / Blend mode
+ * @param {Float32Array} bounds バウンディングボックス / Bounding box
+ * @param {Float32Array} params フィルターパラメータ配列 / Filter parameters array
+ * @param {ILocalFilterConfig} config フィルター設定 / Filter configuration
+ * @param {GPUTextureView} main_texture_view メインテクスチャビュー / Main texture view
+ * @param {BufferManager} buffer_manager バッファマネージャ / Buffer manager
+ * @return {void}
+ */
 export declare const execute: (node: Node, width: number, height: number, is_bitmap: boolean, matrix: Float32Array, color_transform: Float32Array, blend_mode: IBlendMode, bounds: Float32Array, params: Float32Array, config: ILocalFilterConfig, main_texture_view: GPUTextureView, buffer_manager: BufferManager) => void;