@next2d/webgpu 3.0.5 → 3.1.0

package/src/interface/IGradientStop.d.ts

@@ -3,9 +3,29 @@
  *              Gradient stop type definition
  */
 export interface IGradientStop {
+    /**
+     * @description グラデーション位置（0.0〜1.0）
+     *              Gradient position ratio (0.0 to 1.0)
+     */
     ratio: number;
+    /**
+     * @description 赤チャンネル値（0〜255）
+     *              Red channel value (0 to 255)
+     */
     r: number;
+    /**
+     * @description 緑チャンネル値（0〜255）
+     *              Green channel value (0 to 255)
+     */
     g: number;
+    /**
+     * @description 青チャンネル値（0〜255）
+     *              Blue channel value (0 to 255)
+     */
     b: number;
+    /**
+     * @description アルファチャンネル値（0〜255）
+     *              Alpha channel value (0 to 255)
+     */
     a: number;
 }

package/src/interface/ILocalFilterConfig.d.ts

@@ -3,19 +3,49 @@ import type { BufferManager } from "../BufferManager";
 import type { FrameBufferManager } from "../FrameBufferManager";
 import type { PipelineManager } from "../Shader/PipelineManager";
 import type { TextureManager } from "../TextureManager";
-import type { ComputePipelineManager } from "../Compute/ComputePipelineManager";
 /**
  * @description フィルター適用時のローカル設定（ContextApplyFilterUseCase用）
  *              Local filter configuration for ContextApplyFilterUseCase
  */
 export interface ILocalFilterConfig {
+    /**
+     * @description GPUデバイス
+     *              GPU device instance
+     */
     device: GPUDevice;
+    /**
+     * @description GPUコマンドエンコーダー
+     *              GPU command encoder
+     */
     commandEncoder: GPUCommandEncoder;
+    /**
+     * @description バッファマネージャー
+     *              Buffer manager instance
+     */
     bufferManager: BufferManager;
+    /**
+     * @description フレームバッファマネージャー
+     *              Frame buffer manager instance
+     */
     frameBufferManager: FrameBufferManager;
+    /**
+     * @description パイプラインマネージャー
+     *              Pipeline manager instance
+     */
     pipelineManager: PipelineManager;
+    /**
+     * @description テクスチャマネージャー
+     *              Texture manager instance
+     */
     textureManager: TextureManager;
+    /**
+     * @description メインのアタッチメントオブジェクト（任意）
+     *              Main attachment object (optional)
+     */
     mainAttachment?: IAttachmentObject;
-    computePipelineManager?: ComputePipelineManager;
+    /**
+     * @description フレームテクスチャの配列
+     *              Array of frame textures
+     */
     frameTextures: GPUTexture[];
 }

package/src/interface/IMeshResult.d.ts

@@ -3,6 +3,14 @@
  *              Common interface for mesh generation results
  */
 export interface IMeshResult {
+    /**
+     * @description 頂点データバッファ
+     *              Vertex data buffer
+     */
     buffer: Float32Array;
+    /**
+     * @description インデックスの数（描画する三角形の頂点数）
+     *              Number of indices (vertex count for drawing triangles)
+     */
     indexCount: number;
 }

package/src/interface/IPoint.d.ts

@@ -1,4 +1,16 @@
+/**
+ * @description 2D座標点のインターフェース
+ *              2D coordinate point interface
+ */
 export interface IPoint {
+    /**
+     * @description X座標
+     *              X coordinate
+     */
     x: number;
+    /**
+     * @description Y座標
+     *              Y coordinate
+     */
     y: number;
 }

package/src/interface/IPooledTexture.d.ts

@@ -3,11 +3,35 @@
  *              Pooled texture interface
  */
 export interface IPooledTexture {
+    /**
+     * @description GPUテクスチャリソース
+     *              GPU texture resource
+     */
     texture: GPUTexture;
+    /**
+     * @description テクスチャの幅（ピクセル）
+     *              Width of the texture in pixels
+     */
     width: number;
+    /**
+     * @description テクスチャの高さ（ピクセル）
+     *              Height of the texture in pixels
+     */
     height: number;
+    /**
+     * @description テクスチャフォーマット
+     *              Texture format
+     */
     format: GPUTextureFormat;
+    /**
+     * @description 最後に使用されたフレーム番号
+     *              Last frame number when this texture was used
+     */
     lastUsedFrame: number;
+    /**
+     * @description 使用中フラグ
+     *              Whether this texture is currently in use
+     */
     inUse: boolean;
 }
 /**

package/src/interface/IQuadraticSegment.d.ts

@@ -4,6 +4,14 @@ import type { IPoint } from "./IPoint";
  *              Quadratic bezier segment approximation
  */
 export interface IQuadraticSegment {
+    /**
+     * @description 制御点
+     *              Control point
+     */
     ctrl: IPoint;
+    /**
+     * @description 終点
+     *              End point
+     */
     end: IPoint;
 }

package/src/interface/IStencilBufferObject.d.ts

@@ -6,11 +6,39 @@
  * リソースはGPUTextureを使用します。
  */
 export interface IStencilBufferObject {
+    /**
+     * @description ステンシルバッファの一意な識別子
+     *              Unique identifier for the stencil buffer
+     */
     id: number;
+    /**
+     * @description GPUテクスチャリソース
+     *              GPU texture resource
+     */
     resource: GPUTexture;
+    /**
+     * @description テクスチャビュー（レンダーパスへのアタッチ用）
+     *              Texture view for attaching to render passes
+     */
     view: GPUTextureView;
+    /**
+     * @description ステンシルバッファの幅（ピクセル）
+     *              Width of the stencil buffer in pixels
+     */
     width: number;
+    /**
+     * @description ステンシルバッファの高さ（ピクセル）
+     *              Height of the stencil buffer in pixels
+     */
     height: number;
+    /**
+     * @description バッファの面積（width × height）
+     *              Area of the buffer (width × height)
+     */
     area: number;
+    /**
+     * @description バッファが変更されたかどうか
+     *              Whether the buffer has been modified
+     */
     dirty: boolean;
 }

package/src/interface/IStorageBufferConfig.d.ts

@@ -5,14 +5,17 @@
 export interface IStorageBufferConfig {
     /**
      * @description バッファサイズ（バイト）
+     *              Buffer size in bytes
      */
     size: number;
     /**
-     * @description 使用目的
+     * @description 使用目的フラグ
+     *              Usage flags for the buffer
      */
     usage: GPUBufferUsageFlags;
     /**
      * @description ラベル（デバッグ用）
+     *              Label for debugging purposes
      */
     label?: string;
 }
@@ -23,18 +26,22 @@ export interface IStorageBufferConfig {
 export interface IPooledStorageBuffer {
     /**
      * @description GPUバッファ
+     *              GPU buffer instance
      */
     buffer: GPUBuffer;
     /**
      * @description バッファサイズ（バイト）
+     *              Buffer size in bytes
      */
     size: number;
     /**
      * @description 使用中フラグ
+     *              Whether this buffer is currently in use
      */
     inUse: boolean;
     /**
      * @description 最後に使用されたフレーム番号
+     *              Last frame number when this buffer was used
      */
     lastUsedFrame: number;
 }

package/src/interface/ITextureObject.d.ts

@@ -6,11 +6,39 @@
  * resourceプロパティを持ちます。
  */
 export interface ITextureObject {
+    /**
+     * @description テクスチャの一意な識別子
+     *              Unique identifier for the texture
+     */
     id: number;
+    /**
+     * @description GPUテクスチャリソース
+     *              GPU texture resource
+     */
     resource: GPUTexture;
+    /**
+     * @description テクスチャビュー（シェーダーバインド用）
+     *              Texture view for shader binding
+     */
     view: GPUTextureView;
+    /**
+     * @description テクスチャの幅（ピクセル）
+     *              Width of the texture in pixels
+     */
     width: number;
+    /**
+     * @description テクスチャの高さ（ピクセル）
+     *              Height of the texture in pixels
+     */
     height: number;
+    /**
+     * @description テクスチャの面積（width × height）
+     *              Area of the texture (width × height)
+     */
     area: number;
+    /**
+     * @description スムージング（バイリニアフィルタリング）が有効かどうか
+     *              Whether smoothing (bilinear filtering) is enabled
+     */
     smooth: boolean;
 }

package/src/AttachmentManager/service/AttachmentManagerCreateRenderPassDescriptorService.d.ts

@@ -1,5 +0,0 @@
-import type { IAttachmentObject } from "../../interface/IAttachmentObject";
-/**
- * @description レンダーパスディスクリプタを作成（プリアロケート再利用）
- */
-export declare const execute: (attachment: IAttachmentObject, r: number, g: number, b: number, a: number, loadOp?: GPULoadOp) => GPURenderPassDescriptor;

package/src/AttachmentManager/service/AttachmentManagerCreateRenderPassDescriptorService.js

@@ -1,42 +0,0 @@
-const $clearValue = { "r": 0, "g": 0, "b": 0, "a": 0 };
-const $colorAttachment = {
-    "view": null,
-    "loadOp": "clear",
-    "storeOp": "store",
-    "clearValue": $clearValue
-};
-const $depthStencilAttachment = {
-    "view": null,
-    "depthLoadOp": "clear",
-    "depthStoreOp": "store",
-    "depthClearValue": 1.0,
-    "stencilLoadOp": "clear",
-    "stencilStoreOp": "store",
-    "stencilClearValue": 0
-};
-const $descriptor = {
-    "colorAttachments": [$colorAttachment]
-};
-/**
- * @description レンダーパスディスクリプタを作成（プリアロケート再利用）
- */
-export const execute = (attachment, r, g, b, a, loadOp = "clear") => {
-    const colorView = attachment.color?.view ?? attachment.texture?.view;
-    if (!colorView) {
-        throw new Error("No color view available for render pass");
-    }
-    $colorAttachment.view = colorView;
-    $colorAttachment.loadOp = loadOp;
-    $clearValue.r = r;
-    $clearValue.g = g;
-    $clearValue.b = b;
-    $clearValue.a = a;
-    if (attachment.stencil?.view) {
-        $depthStencilAttachment.view = attachment.stencil.view;
-        $descriptor.depthStencilAttachment = $depthStencilAttachment;
-    }
-    else {
-        $descriptor.depthStencilAttachment = undefined;
-    }
-    return $descriptor;
-};

package/src/Blend/service/BlendAddService.d.ts

@@ -1 +0,0 @@
-export declare const execute: () => boolean;

package/src/Blend/service/BlendAddService.js

@@ -1,8 +0,0 @@
-import { $setFuncCode, $funcCode } from "../../Blend";
-export const execute = () => {
-    if ($funcCode !== 101) {
-        $setFuncCode(101);
-        return true;
-    }
-    return false;
-};

package/src/Blend/service/BlendAlphaService.d.ts

@@ -1 +0,0 @@
-export declare const execute: () => boolean;

package/src/Blend/service/BlendAlphaService.js

@@ -1,8 +0,0 @@
-import { $setFuncCode, $funcCode } from "../../Blend";
-export const execute = () => {
-    if ($funcCode !== 401) {
-        $setFuncCode(401);
-        return true;
-    }
-    return false;
-};

package/src/Blend/service/BlendEraseService.d.ts

@@ -1 +0,0 @@
-export declare const execute: () => boolean;

package/src/Blend/service/BlendEraseService.js

@@ -1,8 +0,0 @@
-import { $setFuncCode, $funcCode } from "../../Blend";
-export const execute = () => {
-    if ($funcCode !== 501) {
-        $setFuncCode(501);
-        return true;
-    }
-    return false;
-};

package/src/Blend/service/BlendGetStateService.d.ts

@@ -1,12 +0,0 @@
-import type { IBlendMode } from "../../interface/IBlendMode";
-import type { IBlendState } from "../../Blend";
-/**
- * @description ブレンドモードからWebGPUブレンドステートを取得するサービス
- *              Service to get WebGPU blend state from blend mode
- *
- * @param  {IBlendMode} mode
- * @return {IBlendState}
- * @method
- * @protected
- */
-export declare const execute: (mode: IBlendMode) => IBlendState;

package/src/Blend/service/BlendGetStateService.js

@@ -1,13 +0,0 @@
-import { $getBlendState } from "../../Blend";
-/**
- * @description ブレンドモードからWebGPUブレンドステートを取得するサービス
- *              Service to get WebGPU blend state from blend mode
- *
- * @param  {IBlendMode} mode
- * @return {IBlendState}
- * @method
- * @protected
- */
-export const execute = (mode) => {
-    return $getBlendState(mode);
-};

package/src/Blend/service/BlendOneZeroService.d.ts

@@ -1 +0,0 @@
-export declare const execute: () => boolean;

package/src/Blend/service/BlendOneZeroService.js

@@ -1,8 +0,0 @@
-import { $setFuncCode, $funcCode } from "../../Blend";
-export const execute = () => {
-    if ($funcCode !== 10) {
-        $setFuncCode(10);
-        return true;
-    }
-    return false;
-};

package/src/Blend/service/BlendResetService.d.ts

@@ -1 +0,0 @@
-export declare const execute: () => boolean;

package/src/Blend/service/BlendResetService.js

@@ -1,8 +0,0 @@
-import { $setFuncCode, $funcCode } from "../../Blend";
-export const execute = () => {
-    if ($funcCode !== 613) {
-        $setFuncCode(613);
-        return true;
-    }
-    return false;
-};

package/src/Blend/service/BlendScreenService.d.ts

@@ -1 +0,0 @@
-export declare const execute: () => boolean;

package/src/Blend/service/BlendScreenService.js

@@ -1,8 +0,0 @@
-import { $setFuncCode, $funcCode } from "../../Blend";
-export const execute = () => {
-    if ($funcCode !== 301) {
-        $setFuncCode(301);
-        return true;
-    }
-    return false;
-};

package/src/Blend/service/BlendSetModeService.d.ts

@@ -1,2 +0,0 @@
-import type { IBlendMode } from "../../interface/IBlendMode";
-export declare const execute: (mode: IBlendMode) => void;

package/src/Blend/service/BlendSetModeService.js

@@ -1,4 +0,0 @@
-import { $setCurrentBlendMode } from "../../Blend";
-export const execute = (mode) => {
-    $setCurrentBlendMode(mode);
-};

package/src/Blend/usecase/BlendOperationUseCase.d.ts

@@ -1,11 +0,0 @@
-import type { IBlendMode } from "../../interface/IBlendMode";
-/**
- * @description 設定されたブレンドモードへ切り替える
- *              Switch to the set blend mode
- *
- * @param  {IBlendMode} operation
- * @return {boolean} ブレンドモードが変更されたかどうか
- * @method
- * @protected
- */
-export declare const execute: (operation: IBlendMode) => boolean;

package/src/Blend/usecase/BlendOperationUseCase.js

@@ -1,31 +0,0 @@
-import { execute as blendAddService } from "../service/BlendAddService";
-import { execute as blendResetService } from "../service/BlendResetService";
-import { execute as blendScreenService } from "../service/BlendScreenService";
-import { execute as blendAlphaService } from "../service/BlendAlphaService";
-import { execute as blendEraseService } from "../service/BlendEraseService";
-import { execute as blendOneZeroService } from "../service/BlendOneZeroService";
-/**
- * @description 設定されたブレンドモードへ切り替える
- *              Switch to the set blend mode
- *
- * @param  {IBlendMode} operation
- * @return {boolean} ブレンドモードが変更されたかどうか
- * @method
- * @protected
- */
-export const execute = (operation) => {
-    switch (operation) {
-        case "add":
-            return blendAddService();
-        case "screen":
-            return blendScreenService();
-        case "alpha":
-            return blendAlphaService();
-        case "erase":
-            return blendEraseService();
-        case "copy":
-            return blendOneZeroService();
-        default:
-            return blendResetService();
-    }
-};

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

@@ -1,9 +0,0 @@
-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

@@ -1,15 +0,0 @@
-/**
- * @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/Compute/ComputePipelineManager.d.ts

@@ -1,61 +0,0 @@
-/**
- * @description Compute Pipeline Manager
- *              Compute Shaderパイプラインの管理
- *
- * Compute Shaderは並列処理に最適で、フィルター処理を高速化。
- * 特に大きなブラー半径（64+）の場合、20-35%の高速化が期待できる。
- *
- * @class
- */
-export declare class ComputePipelineManager {
-    private device;
-    private pipelines;
-    private bindGroupLayouts;
-    /**
-     * @constructor
-     * @param {GPUDevice} device - WebGPU device
-     */
-    constructor(device: GPUDevice);
-    /**
-     * @description ブラー用Compute Pipelineを初期化
-     * @private
-     */
-    private initializeBlurPipelines;
-    /**
-     * @description ブラーCompute Pipelineを作成
-     * @param {string} name - パイプライン名
-     * @private
-     */
-    private createBlurComputePipeline;
-    /**
-     * @description ブラーCompute Shaderコードを生成
-     *              ボックスブラー（均一加重平均）を使用。Fragment Shaderと同一出力。
-     * @return {string} WGSLシェーダーコード
-     * @private
-     */
-    private getBlurComputeShaderCode;
-    /**
-     * @description 共有メモリ版ブラーCompute Shaderコードを生成
-     *              ワークグループ共有メモリでテクスチャ読み込みの重複を排除。
-     *              radius >= 8 で通常版より高速。
-     * @return {string} WGSLシェーダーコード
-     * @private
-     */
-    private getSharedBlurComputeShaderCode;
-    /**
-     * @description パイプラインを取得
-     * @param {string} name - パイプライン名
-     * @return {GPUComputePipeline | undefined}
-     */
-    getPipeline(name: string): GPUComputePipeline | undefined;
-    /**
-     * @description BindGroupLayoutを取得
-     * @param {string} name - レイアウト名
-     * @return {GPUBindGroupLayout | undefined}
-     */
-    getBindGroupLayout(name: string): GPUBindGroupLayout | undefined;
-    /**
-     * @description リソースを破棄
-     */
-    destroy(): void;
-}