@next2d/webgpu 3.0.5 → 3.1.0

package/src/Blend/usecase/BlendApplyComplexBlendUseCase.js

@@ -1,10 +1,14 @@
 import { ShaderSource } from "../../Shader/ShaderSource";
 /**
  * @description プリアロケートされた uniform データ (12 floats = 48 bytes)
+ *              Pre-allocated uniform data array (12 floats = 48 bytes)
+ * @type {Float32Array}
  */
 const $uniform12 = new Float32Array(12);
 /**
  * @description プリアロケートされた BindGroupEntry 配列 (4 bindings)
+ *              Pre-allocated BindGroupEntry array (4 bindings)
+ * @type {GPUBindGroupEntry[]}
  */
 const $entries4 = [
     { "binding": 0, "resource": { "buffer": null } },
@@ -13,22 +17,29 @@ const $entries4 = [
     { "binding": 3, "resource": null }
 ];
 /**
- * @description 複雑なブレンドモードを適用
+ * @description 複雑なブレンドモードを適用し、ブレンド結果のアタッチメントを返す
+ *              Applies a complex blend mode and returns the resulting attachment
+ * @param {IAttachmentObject} src_attachment - ソースアタッチメント / Source attachment
+ * @param {IAttachmentObject} dst_attachment - デスティネーションアタッチメント / Destination attachment
+ * @param {string} blend_mode - ブレンドモード名 / Blend mode name
+ * @param {Float32Array} color_transform - カラートランスフォーム配列 / Color transform array
+ * @param {IFilterConfig} config - フィルター設定 / Filter configuration
+ * @return {IAttachmentObject}
  */
-export const execute = (srcAttachment, dstAttachment, blendMode, colorTransform, config) => {
+export const execute = (src_attachment, dst_attachment, blend_mode, color_transform, config) => {
     const { device, commandEncoder, frameBufferManager, pipelineManager, textureManager } = config;
     // 出力サイズは両方の大きい方を使用
-    const width = Math.max(srcAttachment.width, dstAttachment.width);
-    const height = Math.max(srcAttachment.height, dstAttachment.height);
+    const width = Math.max(src_attachment.width, dst_attachment.width);
+    const height = Math.max(src_attachment.height, dst_attachment.height);
     // 出力アタッチメントを作成
     const destAttachment = frameBufferManager.createTemporaryAttachment(width, height);
     // 統一パイプラインを使用
     const pipeline = pipelineManager.getPipeline("complex_blend");
     const bindGroupLayout = pipelineManager.getBindGroupLayout("complex_blend");
     if (!pipeline || !bindGroupLayout) {
-        console.error(`[WebGPU ComplexBlend] Pipeline not found for blend mode: ${blendMode}`);
+        console.error(`[WebGPU ComplexBlend] Pipeline not found for blend mode: ${blend_mode}`);
         // フォールバック: srcをそのまま返す
-        return srcAttachment;
+        return src_attachment;
     }
     // サンプラーを作成
     const sampler = textureManager.createSampler("complex_blend_sampler", true);
@@ -37,15 +48,15 @@ export const execute = (srcAttachment, dstAttachment, blendMode, colorTransform,
     // addColor: vec4<f32> (16 bytes)
     // blendMode: f32 + padding: vec3<f32> (16 bytes)
     // Total: 48 bytes
-    const blendModeIndex = ShaderSource.getBlendModeIndex(blendMode);
-    $uniform12[0] = colorTransform[0];
-    $uniform12[1] = colorTransform[1];
-    $uniform12[2] = colorTransform[2];
-    $uniform12[3] = colorTransform[3];
-    $uniform12[4] = colorTransform[4];
-    $uniform12[5] = colorTransform[5];
-    $uniform12[6] = colorTransform[6];
-    $uniform12[7] = colorTransform[7];
+    const blendModeIndex = ShaderSource.getBlendModeIndex(blend_mode);
+    $uniform12[0] = color_transform[0];
+    $uniform12[1] = color_transform[1];
+    $uniform12[2] = color_transform[2];
+    $uniform12[3] = color_transform[3];
+    $uniform12[4] = color_transform[4];
+    $uniform12[5] = color_transform[5];
+    $uniform12[6] = color_transform[6];
+    $uniform12[7] = color_transform[7];
     $uniform12[8] = blendModeIndex;
     $uniform12[9] = 0;
     $uniform12[10] = 0;
@@ -62,8 +73,8 @@ export const execute = (srcAttachment, dstAttachment, blendMode, colorTransform,
     // バインドグループを作成
     $entries4[0].resource.buffer = uniformBuffer;
     $entries4[1].resource = sampler;
-    $entries4[2].resource = dstAttachment.texture.view;
-    $entries4[3].resource = srcAttachment.texture.view;
+    $entries4[2].resource = dst_attachment.texture.view;
+    $entries4[3].resource = src_attachment.texture.view;
     const bindGroup = device.createBindGroup({
         "layout": bindGroupLayout,
         "entries": $entries4

package/src/Blend.d.ts

@@ -1,8 +1,26 @@
 import type { IBlendMode } from "./interface/IBlendMode";
 import type { IBlendState } from "./interface/IBlendState";
 export type { IBlendState };
+/**
+ * @description 現在のブレンドモード
+ *              The current blend mode used for rendering
+ *
+ * @type {IBlendMode}
+ */
 export declare let $currentBlendMode: IBlendMode;
-export declare let $funcCode: number;
+/**
+ * @description 現在のブレンドモードを設定する
+ *              Set the current blend mode
+ *
+ * @param {IBlendMode} blend_mode - ブレンドモード / blend mode to apply
+ * @return {void}
+ */
 export declare const $setCurrentBlendMode: (blend_mode: IBlendMode) => void;
-export declare const $setFuncCode: (code: number) => void;
+/**
+ * @description 指定されたブレンドモードに対応するWebGPUブレンドステートを返す
+ *              Returns the WebGPU blend state configuration for the given blend mode
+ *
+ * @param {IBlendMode} mode - ブレンドモード / blend mode
+ * @return {IBlendState}
+ */
 export declare const $getBlendState: (mode: IBlendMode) => IBlendState;

package/src/Blend.js

@@ -1,11 +1,27 @@
+/**
+ * @description 現在のブレンドモード
+ *              The current blend mode used for rendering
+ *
+ * @type {IBlendMode}
+ */
 export let $currentBlendMode = "normal";
-export let $funcCode = 0;
+/**
+ * @description 現在のブレンドモードを設定する
+ *              Set the current blend mode
+ *
+ * @param {IBlendMode} blend_mode - ブレンドモード / blend mode to apply
+ * @return {void}
+ */
 export const $setCurrentBlendMode = (blend_mode) => {
     $currentBlendMode = blend_mode;
 };
-export const $setFuncCode = (code) => {
-    $funcCode = code;
-};
+/**
+ * @description 指定されたブレンドモードに対応するWebGPUブレンドステートを返す
+ *              Returns the WebGPU blend state configuration for the given blend mode
+ *
+ * @param {IBlendMode} mode - ブレンドモード / blend mode
+ * @return {IBlendState}
+ */
 export const $getBlendState = (mode) => {
     switch (mode) {
         case "add":

package/src/BufferManager/service/BufferManagerReleaseUniformBufferService.js

@@ -4,7 +4,7 @@
  * @type {number}
  * @const
  */
-const MAX_BUCKET_SIZE = 32;
+const $MAX_BUCKET_SIZE = 32;
 /**
  * @description ユニフォームバッファをプールに返却
  *              Release uniform buffer back to pool
@@ -23,7 +23,7 @@ export const execute = (buckets, buffer) => {
         bucket = [];
         buckets.set(size, bucket);
     }
-    if (bucket.length >= MAX_BUCKET_SIZE) {
+    if (bucket.length >= $MAX_BUCKET_SIZE) {
         // バケットが満杯の場合、このバッファを破棄
         buffer.destroy();
         return;

package/src/BufferManager/service/BufferManagerReleaseVertexBufferService.js

@@ -4,7 +4,7 @@
  * @type {number}
  * @const
  */
-const MAX_BUCKET_SIZE = 32;
+const $MAX_BUCKET_SIZE = 32;
 /**
  * @description 頂点バッファをプールに返却
  *              Release vertex buffer back to pool
@@ -23,7 +23,7 @@ export const execute = (buckets, buffer) => {
         bucket = [];
         buckets.set(size, bucket);
     }
-    if (bucket.length >= MAX_BUCKET_SIZE) {
+    if (bucket.length >= $MAX_BUCKET_SIZE) {
         // バケットが満杯の場合、このバッファを破棄
         buffer.destroy();
         return;

package/src/BufferManager/service/BufferManagerUpdateIndirectBufferService.d.ts

@@ -8,5 +8,6 @@
  * @param {number} instance_count - インスタンス数
  * @param {number} first_vertex - 開始頂点インデックス
  * @param {number} first_instance - 開始インスタンスインデックス
+ * @return {void}
  */
 export declare const execute: (device: GPUDevice, buffer: GPUBuffer, vertex_count: number, instance_count: number, first_vertex?: number, first_instance?: number) => void;

package/src/BufferManager/service/BufferManagerUpdateIndirectBufferService.js

@@ -8,6 +8,7 @@
  * @param {number} instance_count - インスタンス数
  * @param {number} first_vertex - 開始頂点インデックス
  * @param {number} first_instance - 開始インスタンスインデックス
+ * @return {void}
  */
 export const execute = (device, buffer, vertex_count, instance_count, first_vertex = 0, first_instance = 0) => {
     const indirectData = new Uint32Array([

package/src/BufferManager/usecase/BufferManagerCleanupStorageBuffersUseCase.d.ts

@@ -8,5 +8,6 @@ import type { IPooledStorageBuffer } from "../../interface/IStorageBufferConfig"
  * @param {IPooledStorageBuffer[]} pool - Storage Bufferプール
  * @param {number} current_frame - 現在のフレーム番号
  * @param {number} max_age - 最大保持フレーム数
+ * @return {void}
  */
 export declare const execute: (pool: IPooledStorageBuffer[], current_frame: number, max_age?: number) => void;

package/src/BufferManager/usecase/BufferManagerCleanupStorageBuffersUseCase.js

@@ -7,6 +7,7 @@
  * @param {IPooledStorageBuffer[]} pool - Storage Bufferプール
  * @param {number} current_frame - 現在のフレーム番号
  * @param {number} max_age - 最大保持フレーム数
+ * @return {void}
  */
 export const execute = (pool, current_frame, max_age = 60) => {
     // 古いバッファを削除

package/src/BufferManager.d.ts

@@ -1,7 +1,6 @@
 /**
- * @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 declare class DynamicUniformAllocator {
     private device;
@@ -13,38 +12,54 @@ export declare class DynamicUniformAllocator {
     private stagingBuffer;
     private stagingFloat32;
     private dirtyEnd;
+    /**
+     * @description コンストラクタ。GPUデバイスとバッファ容量を設定
+     *              Constructor. Sets up GPU device and buffer capacity
+     * @param {GPUDevice} device - WebGPUデバイス
+     * @param {number} capacity - 初期バッファ容量（バイト単位、デフォルト: 65536）
+     */
     constructor(device: GPUDevice, capacity?: number);
     /**
-     * @description フレーム開始時にオフセットをリセット
-     *              前フレームの旧バッファを安全に破棄（submit済みのため）
+     * @description フレーム開始時にオフセットをリセットし、前フレームの旧バッファを安全に破棄
+     *              Reset offset at frame start and safely destroy old buffers from previous frame
+     * @return {void}
      */
     resetFrame(): void;
     /**
      * @description バッファを取得（遅延生成）
+     *              Get buffer with lazy initialization
+     * @return {GPUBuffer} GPUバッファ
      */
     getBuffer(): GPUBuffer;
     /**
-     * @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: Float32Array): number;
     /**
-     * @description ステージングバッファの内容をGPUバッファに一括書き込み
-     *              submit前に1回だけ呼び出す
+     * @description ステージングバッファの内容をGPUバッファに一括書き込み。submit前に1回だけ呼び出す
+     *              Flush staging buffer content to GPU buffer in bulk. Call once before submit
+     * @return {void}
      */
     flush(): void;
+    /**
+     * @description バッファを破棄してリソースを解放
+     *              Dispose buffers and release resources
+     * @return {void}
+     */
     dispose(): void;
 }
+/**
+ * @description GPUバッファの管理クラス。頂点・ユニフォーム・ストレージ・インダイレクトバッファのプール管理と再利用を提供
+ *              GPU buffer management class. Provides pooling and reuse for vertex, uniform, storage, and indirect buffers
+ */
 export declare class BufferManager {
     private device;
-    private vertexBuffers;
-    private uniformBuffers;
     private vertexBufferBuckets;
     private uniformBufferBuckets;
     private storageBufferPool;
-    private indirectBuffer;
     private indirectBufferPool;
     private frameIndirectBuffers;
     private frameNumber;
@@ -52,42 +67,92 @@ export declare class BufferManager {
     private frameVertexPoolBuffers;
     private frameUniformPoolBuffers;
     readonly dynamicUniform: DynamicUniformAllocator;
+    /**
+     * @description コンストラクタ。GPUデバイスを設定し、各種バッファプールを初期化
+     *              Constructor. Sets up GPU device and initializes buffer pools
+     * @param {GPUDevice} device - WebGPUデバイス
+     */
     constructor(device: GPUDevice);
-    createVertexBuffer(name: string, data: Float32Array): GPUBuffer;
-    createUniformBuffer(name: string, size: number): GPUBuffer;
-    updateUniformBuffer(name: string, data: Float32Array): void;
-    getVertexBuffer(name: string): GPUBuffer | undefined;
-    getUniformBuffer(name: string): GPUBuffer | undefined;
+    /**
+     * @description 矩形の頂点データを作成
+     *              Create rect vertices data
+     * @param {number} x - X座標
+     * @param {number} y - Y座標
+     * @param {number} width - 幅
+     * @param {number} height - 高さ
+     * @return {Float32Array} 矩形の頂点データ
+     */
     createRectVertices(x: number, y: number, width: number, height: number): Float32Array;
-    acquireVertexBuffer(requiredSize: number, data?: Float32Array): GPUBuffer;
-    releaseVertexBuffer(buffer: GPUBuffer): void;
-    acquireUniformBuffer(requiredSize: number): GPUBuffer;
+    /**
+     * @description プールから頂点バッファを取得（または新規作成）
+     *              Acquire vertex buffer from pool or create new one
+     * @param {number} required_size - 必要なバイトサイズ
+     * @param {Float32Array} [data] - 初期データ
+     * @return {GPUBuffer} 取得された頂点バッファ
+     */
+    acquireVertexBuffer(required_size: number, data?: Float32Array): GPUBuffer;
+    /**
+     * @description プールからユニフォームバッファを取得（または新規作成）
+     *              Acquire uniform buffer from pool or create new one
+     * @param {number} required_size - 必要なバイトサイズ
+     * @return {GPUBuffer} 取得されたユニフォームバッファ
+     */
+    acquireUniformBuffer(required_size: number): GPUBuffer;
     /**
      * @description Uniform Bufferの取得と書き込みを一括で行うヘルパー
-     *              acquireUniformBuffer + writeBuffer の2ステップを1呼び出しに統合
-     * @param data - 書き込むデータ
-     * @param byteLength - 書き込みバイト数（省略時はdata.byteLength）
-     * @return GPUBuffer
-     */
-    acquireAndWriteUniformBuffer(data: Float32Array, byteLength?: number): GPUBuffer;
-    releaseUniformBuffer(buffer: GPUBuffer): void;
-    destroyBuffer(name: string): void;
+     *              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: Float32Array, byte_length?: number): GPUBuffer;
+    /**
+     * @description 全バッファを破棄してリソースを解放
+     *              Dispose all buffers and release resources
+     * @return {void}
+     */
     dispose(): void;
-    getPoolStats(): {
-        vertexPoolSize: number;
-        uniformPoolSize: number;
-    };
+    /**
+     * @description フレーム内で使用したバッファをクリアし、プールに返却
+     *              Clear frame buffers and return them to pool
+     * @return {void}
+     */
     clearFrameBuffers(): void;
+    /**
+     * @description 全てのStorage Bufferを未使用状態に戻す
+     *              Mark all storage buffers as not in use
+     * @return {void}
+     */
     releaseAllStorageBuffers(): void;
-    acquireStorageBuffer(requiredSize: number): GPUBuffer;
-    releaseStorageBuffer(buffer: GPUBuffer): void;
+    /**
+     * @description プールからStorage Bufferを取得（または新規作成）
+     *              Acquire storage buffer from pool or create new one
+     * @param {number} required_size - 必要なバイトサイズ
+     * @return {GPUBuffer} 取得されたStorage Buffer
+     */
+    acquireStorageBuffer(required_size: number): GPUBuffer;
+    /**
+     * @description Storage Bufferにデータを書き込む
+     *              Write data to storage buffer
+     * @param {GPUBuffer} buffer - 書き込み先バッファ
+     * @param {Float32Array | Uint32Array} data - 書き込むデータ
+     * @return {void}
+     */
     writeStorageBuffer(buffer: GPUBuffer, data: Float32Array | Uint32Array): void;
-    getOrCreateIndirectBuffer(vertexCount: number, instanceCount: number, firstVertex?: number, firstInstance?: number): GPUBuffer;
-    createIndirectBuffer(vertexCount: number, instanceCount: number, firstVertex?: number, firstInstance?: number): GPUBuffer;
+    /**
+     * @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: number, instance_count: number, first_vertex?: number, first_instance?: number): GPUBuffer;
+    /**
+     * @description 単位矩形（0,0,1,1）の頂点バッファを取得（遅延生成）
+     *              Get unit rect (0,0,1,1) vertex buffer with lazy creation
+     * @return {GPUBuffer} 単位矩形の頂点バッファ
+     */
     getUnitRectBuffer(): GPUBuffer;
-    getFrameNumber(): number;
-    getStoragePoolStats(): {
-        storagePoolSize: number;
-        storagePoolInUse: number;
-    };
 }