@next2d/webgpu 3.0.0

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

@@ -0,0 +1,14 @@
+/**
+ * @description プールから頂点バッファを取得（または新規作成）
+ *              Acquire vertex buffer from pool (or create new)
+ *              バケット化されたMap<number, GPUBuffer[]>からO(1)で取得
+ *
+ * @param  {GPUDevice} device
+ * @param  {Map<number, GPUBuffer[]>} buckets - サイズ別バケットMap
+ * @param  {number} required_size - 必要なバイトサイズ
+ * @param  {Float32Array} [data] - 初期データ
+ * @return {GPUBuffer}
+ * @method
+ * @protected
+ */
+export declare const execute: (device: GPUDevice, buckets: Map<number, GPUBuffer[]>, required_size: number, data?: Float32Array) => GPUBuffer;

package/src/BufferManager/usecase/BufferManagerAcquireVertexBufferUseCase.js

@@ -0,0 +1,46 @@
+import { execute as bufferManagerUpperPowerOfTwoService } from "../service/BufferManagerUpperPowerOfTwoService";
+/**
+ * @description プールから頂点バッファを取得（または新規作成）
+ *              Acquire vertex buffer from pool (or create new)
+ *              バケット化されたMap<number, GPUBuffer[]>からO(1)で取得
+ *
+ * @param  {GPUDevice} device
+ * @param  {Map<number, GPUBuffer[]>} buckets - サイズ別バケットMap
+ * @param  {number} required_size - 必要なバイトサイズ
+ * @param  {Float32Array} [data] - 初期データ
+ * @return {GPUBuffer}
+ * @method
+ * @protected
+ */
+export const execute = (device, buckets, required_size, data) => {
+    // 2のべき乗に切り上げてバケットキーとする
+    const bucketSize = bufferManagerUpperPowerOfTwoService(required_size);
+    // バケットからバッファを取得（O(1)）
+    const bucket = buckets.get(bucketSize);
+    let buffer;
+    if (bucket && bucket.length > 0) {
+        buffer = bucket.pop();
+        // プールヒット: writeBufferで更新
+        if (data) {
+            device.queue.writeBuffer(buffer, 0, data.buffer, data.byteOffset, data.byteLength);
+        }
+    }
+    else if (data) {
+        // 新規作成 + データあり: mappedAtCreationで1コールに統合
+        buffer = device.createBuffer({
+            "size": bucketSize,
+            "usage": GPUBufferUsage.VERTEX | GPUBufferUsage.COPY_DST,
+            "mappedAtCreation": true
+        });
+        new Float32Array(buffer.getMappedRange()).set(data);
+        buffer.unmap();
+    }
+    else {
+        // 新規作成 + データなし
+        buffer = device.createBuffer({
+            "size": bucketSize,
+            "usage": GPUBufferUsage.VERTEX | GPUBufferUsage.COPY_DST
+        });
+    }
+    return buffer;
+};

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

@@ -0,0 +1,12 @@
+import type { IPooledStorageBuffer } from "../../interface/IStorageBufferConfig";
+/**
+ * @description 古いStorage Bufferをクリーンアップ
+ *              Cleanup old Storage Buffers
+ *
+ * 一定フレーム数使用されていないバッファを解放。
+ *
+ * @param {IPooledStorageBuffer[]} pool - Storage Bufferプール
+ * @param {number} current_frame - 現在のフレーム番号
+ * @param {number} max_age - 最大保持フレーム数
+ */
+export declare const execute: (pool: IPooledStorageBuffer[], current_frame: number, max_age?: number) => void;

package/src/BufferManager/usecase/BufferManagerCleanupStorageBuffersUseCase.js

@@ -0,0 +1,20 @@
+/**
+ * @description 古いStorage Bufferをクリーンアップ
+ *              Cleanup old Storage Buffers
+ *
+ * 一定フレーム数使用されていないバッファを解放。
+ *
+ * @param {IPooledStorageBuffer[]} pool - Storage Bufferプール
+ * @param {number} current_frame - 現在のフレーム番号
+ * @param {number} max_age - 最大保持フレーム数
+ */
+export const execute = (pool, current_frame, max_age = 60) => {
+    // 古いバッファを削除
+    for (let i = pool.length - 1; i >= 0; i--) {
+        const entry = pool[i];
+        if (!entry.inUse && current_frame - entry.lastUsedFrame > max_age) {
+            entry.buffer.destroy();
+            pool.splice(i, 1);
+        }
+    }
+};

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

@@ -0,0 +1,9 @@
+import type { IPooledStorageBuffer } from "../../interface/IStorageBufferConfig";
+/**
+ * @description Storage Bufferをプールに返却
+ *              Release Storage Buffer back to pool
+ *
+ * @param {IPooledStorageBuffer[]} pool - Storage Bufferプール
+ * @param {GPUBuffer} buffer - 返却するバッファ
+ */
+export declare const execute: (pool: IPooledStorageBuffer[], buffer: GPUBuffer) => void;

package/src/BufferManager/usecase/BufferManagerReleaseStorageBufferUseCase.js

@@ -0,0 +1,15 @@
+/**
+ * @description Storage Bufferをプールに返却
+ *              Release Storage Buffer back to pool
+ *
+ * @param {IPooledStorageBuffer[]} pool - Storage Bufferプール
+ * @param {GPUBuffer} buffer - 返却するバッファ
+ */
+export const execute = (pool, buffer) => {
+    for (const entry of pool) {
+        if (entry.buffer === buffer) {
+            entry.inUse = false;
+            return;
+        }
+    }
+};

package/src/BufferManager.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @description Dynamic Uniform Buffer Allocator
+ *              1フレーム内の全fill uniform データを1本の大バッファにサブアロケートし、
+ *              BindGroup作成を1回に削減する。
+ */
+export declare class DynamicUniformAllocator {
+    private device;
+    private buffer;
+    private offset;
+    private capacity;
+    readonly alignment: number;
+    private pendingDestroyBuffers;
+    private stagingBuffer;
+    private stagingFloat32;
+    private dirtyEnd;
+    constructor(device: GPUDevice, capacity?: number);
+    /**
+     * @description フレーム開始時にオフセットをリセット
+     *              前フレームの旧バッファを安全に破棄（submit済みのため）
+     */
+    resetFrame(): void;
+    /**
+     * @description バッファを取得（遅延生成）
+     */
+    getBuffer(): GPUBuffer;
+    /**
+     * @description uniform データをCPUステージングバッファにコピーし、アライメント済みオフセットを返す
+     *              実際のGPU書き込みはflush()で一括実行される
+     * @param data - 書き込むデータ
+     * @return アライメント済みオフセット（バイト単位）
+     */
+    allocate(data: Float32Array): number;
+    /**
+     * @description ステージングバッファの内容をGPUバッファに一括書き込み
+     *              submit前に1回だけ呼び出す
+     */
+    flush(): void;
+    dispose(): void;
+}
+export declare class BufferManager {
+    private device;
+    private vertexBuffers;
+    private uniformBuffers;
+    private vertexBufferBuckets;
+    private uniformBufferBuckets;
+    private storageBufferPool;
+    private indirectBuffer;
+    private indirectBufferPool;
+    private frameIndirectBuffers;
+    private frameNumber;
+    private unitRectBuffer;
+    private frameVertexPoolBuffers;
+    private frameUniformPoolBuffers;
+    readonly dynamicUniform: DynamicUniformAllocator;
+    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;
+    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 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;
+    dispose(): void;
+    getPoolStats(): {
+        vertexPoolSize: number;
+        uniformPoolSize: number;
+    };
+    clearFrameBuffers(): void;
+    releaseAllStorageBuffers(): void;
+    acquireStorageBuffer(requiredSize: number): GPUBuffer;
+    releaseStorageBuffer(buffer: GPUBuffer): 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;
+    getUnitRectBuffer(): GPUBuffer;
+    getFrameNumber(): number;
+    getStoragePoolStats(): {
+        storagePoolSize: number;
+        storagePoolInUse: number;
+    };
+}