@next2d/webgpu 3.0.5 → 3.1.0

package/src/PathCommand.d.ts

@@ -1,4 +1,3 @@
-import type { IPoint } from "./interface/IPoint";
 import type { IPath } from "./interface/IPath";
 /**
  * @description WebGPU用パスコマンド（WebGL互換形式）
@@ -9,11 +8,35 @@ import type { IPath } from "./interface/IPath";
  * - isControlPoint = false: 通常の頂点または終点
  */
 export declare class PathCommand {
+    /**
+     * @description 現在のパスデータ
+     *              Current path data array
+     */
     private $currentPath;
+    /**
+     * @description 確定済みパスの配列
+     *              Array of finalized path vertices
+     */
     private $vertices;
+    /**
+     * @description 現在のX座標
+     *              Current X coordinate
+     */
     private $currentX;
+    /**
+     * @description 現在のY座標
+     *              Current Y coordinate
+     */
     private $currentY;
+    /**
+     * @description サブパスの開始X座標
+     *              Start X coordinate of current sub-path
+     */
     private $startX;
+    /**
+     * @description サブパスの開始Y座標
+     *              Start Y coordinate of current sub-path
+     */
     private $startY;
     /**
      * @constructor
@@ -53,13 +76,6 @@ export declare class PathCommand {
      *              0.25 = 0.5px squared（滑らかなストローク描画用）
      */
     private $flatnessThreshold;
-    /**
-     * @description フラットネス閾値を設定
-     *              Set flatness threshold for adaptive bezier tessellation
-     * @param {number} scale - 現在のスケール（行列のスケール成分）
-     * @return {void}
-     */
-    setScale(scale: number): void;
     /**
      * @description 三次ベジェ曲線を二次ベジェ曲線に適応的に近似
      *              Adaptively approximate cubic bezier with quadratic beziers
@@ -94,21 +110,6 @@ export declare class PathCommand {
      * @return {IPath[]}
      */
     get $getVertices(): IPath[];
-    /**
-     * @description パスから頂点配列を生成（従来互換用・単純なfan triangulation）
-     * @return {Float32Array}
-     */
-    generateVertices(): Float32Array;
-    /**
-     * @description 現在のパスを取得（ストローク用）
-     * @return {IPoint[]}
-     */
-    getCurrentPath(): IPoint[];
-    /**
-     * @description すべてのパスを取得（ストローク用）
-     * @return {IPoint[][]}
-     */
-    getAllPaths(): IPoint[][];
     /**
      * @description WebGL互換形式でパスを取得（ストローク用）
      *              [x, y, isCurve, x, y, isCurve, ...] 形式

package/src/PathCommand.js

@@ -1,4 +1,4 @@
-import { adaptiveCubicToQuad, calculateAdaptiveThreshold } from "./BezierConverter/BezierConverter";
+import { adaptiveCubicToQuad } from "./BezierConverter/BezierConverter";
 /**
  * @description WebGPU用パスコマンド（WebGL互換形式）
  *              Path commands for WebGPU (WebGL compatible format)
@@ -12,36 +12,60 @@ export class PathCommand {
      * @constructor
      */
     constructor() {
+        /**
+         * @description 現在のパスデータ
+         *              Current path data array
+         */
         Object.defineProperty(this, "$currentPath", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
+        /**
+         * @description 確定済みパスの配列
+         *              Array of finalized path vertices
+         */
         Object.defineProperty(this, "$vertices", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
+        /**
+         * @description 現在のX座標
+         *              Current X coordinate
+         */
         Object.defineProperty(this, "$currentX", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
+        /**
+         * @description 現在のY座標
+         *              Current Y coordinate
+         */
         Object.defineProperty(this, "$currentY", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
+        /**
+         * @description サブパスの開始X座標
+         *              Start X coordinate of current sub-path
+         */
         Object.defineProperty(this, "$startX", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
+        /**
+         * @description サブパスの開始Y座標
+         *              Start Y coordinate of current sub-path
+         */
         Object.defineProperty(this, "$startY", {
             enumerable: true,
             configurable: true,
@@ -127,15 +151,6 @@ export class PathCommand {
         this.$currentX = x;
         this.$currentY = y;
     }
-    /**
-     * @description フラットネス閾値を設定
-     *              Set flatness threshold for adaptive bezier tessellation
-     * @param {number} scale - 現在のスケール（行列のスケール成分）
-     * @return {void}
-     */
-    setScale(scale) {
-        this.$flatnessThreshold = calculateAdaptiveThreshold(scale);
-    }
     /**
      * @description 三次ベジェ曲線を二次ベジェ曲線に適応的に近似
      *              Adaptively approximate cubic bezier with quadratic beziers
@@ -221,75 +236,6 @@ export class PathCommand {
         }
         return vertices;
     }
-    /**
-     * @description パスから頂点配列を生成（従来互換用・単純なfan triangulation）
-     * @return {Float32Array}
-     */
-    generateVertices() {
-        const vertices = this.$getVertices;
-        const triangles = [];
-        for (const path of vertices) {
-            if (path.length < 9) {
-                continue;
-            } // 最低3点（9要素）必要
-            // 点を抽出
-            const points = [];
-            for (let i = 0; i < path.length; i += 3) {
-                points.push({ "x": path[i], "y": path[i + 1] });
-            }
-            // Fan triangulation
-            for (let i = 1; i < points.length - 1; i++) {
-                triangles.push(points[0].x, points[0].y, points[i].x, points[i].y, points[i + 1].x, points[i + 1].y);
-            }
-        }
-        return new Float32Array(triangles);
-    }
-    /**
-     * @description 現在のパスを取得（ストローク用）
-     * @return {IPoint[]}
-     */
-    getCurrentPath() {
-        const points = [];
-        for (let i = 0; i < this.$currentPath.length; i += 3) {
-            points.push({
-                "x": this.$currentPath[i],
-                "y": this.$currentPath[i + 1]
-            });
-        }
-        return points;
-    }
-    /**
-     * @description すべてのパスを取得（ストローク用）
-     * @return {IPoint[][]}
-     */
-    getAllPaths() {
-        const allPaths = [];
-        for (const path of this.$vertices) {
-            const points = [];
-            for (let i = 0; i < path.length; i += 3) {
-                points.push({
-                    "x": path[i],
-                    "y": path[i + 1]
-                });
-            }
-            if (points.length > 0) {
-                allPaths.push(points);
-            }
-        }
-        if (this.$currentPath.length >= 3) {
-            const points = [];
-            for (let i = 0; i < this.$currentPath.length; i += 3) {
-                points.push({
-                    "x": this.$currentPath[i],
-                    "y": this.$currentPath[i + 1]
-                });
-            }
-            if (points.length > 0) {
-                allPaths.push(points);
-            }
-        }
-        return allPaths;
-    }
     /**
      * @description WebGL互換形式でパスを取得（ストローク用）
      *              [x, y, isCurve, x, y, isCurve, ...] 形式

package/src/Shader/PipelineManager.d.ts

@@ -1,57 +1,274 @@
+/**
+ * @description WebGPUレンダーパイプラインの管理クラス。パイプラインとバインドグループレイアウトの生成・キャッシュを行う
+ *              Manager class for WebGPU render pipelines. Creates, caches, and manages pipelines and bind group layouts
+ */
 export declare class PipelineManager {
+    /**
+     * @description GPUデバイスの参照
+     *              Reference to the GPU device
+     */
     private device;
+    /**
+     * @description 出力テクスチャフォーマット
+     *              Output texture format
+     */
     private format;
+    /**
+     * @description パイプライン名からGPURenderPipelineへのキャッシュマップ
+     *              Cache map from pipeline name to GPURenderPipeline
+     */
     private pipelines;
+    /**
+     * @description バインドグループレイアウト名からGPUBindGroupLayoutへのキャッシュマップ
+     *              Cache map from layout name to GPUBindGroupLayout
+     */
     private bindGroupLayouts;
+    /**
+     * @description MSAAサンプル数
+     *              MSAA sample count
+     */
     private sampleCount;
+    /**
+     * @description シェーダーモジュールのキャッシュ
+     *              Shader module cache by key
+     */
     private shaderModuleCache;
+    /**
+     * @description フィルター用バインドグループレイアウトキャッシュ（テクスチャ数別）
+     *              Filter bind group layout cache indexed by texture count
+     */
     private filterBindGroupLayouts;
+    /**
+     * @description PipelineManagerのコンストラクタ。GPUデバイスとフォーマットを設定し、パイプラインを初期化する
+     *              Construct PipelineManager. Sets GPU device, format, and initializes pipelines
+     * @param {GPUDevice} device - GPUデバイス / GPU device instance
+     * @param {GPUTextureFormat} format - テクスチャフォーマット / Texture format for output
+     */
     constructor(device: GPUDevice, format: GPUTextureFormat);
+    /**
+     * @description シェーダーモジュールをキャッシュから取得、または新規作成する
+     *              Get a shader module from cache, or create and cache a new one
+     * @param {string} key - キャッシュキー / Cache key
+     * @param {string} code - WGSLシェーダーコード / WGSL shader source code
+     * @return {GPUShaderModule} シェーダーモジュール / The shader module
+     */
     private getOrCreateShaderModule;
+    /**
+     * @description 初期パイプライン群を一括作成する
+     *              Create all initial render pipelines
+     */
     private initialize;
+    /**
+     * @description 初期化済みの遅延グループ名セット
+     *              Set of initialized lazy group names
+     */
     private lazyInitGroups;
+    /**
+     * @description パイプライン名から遅延初期化グループ名への読み取り専用マップ
+     *              Read-only map from pipeline name to lazy initialization group name
+     */
     private readonly lazyGroupMap;
+    /**
+     * @description 指定された名前に対応する遅延初期化グループをまだ初期化されていなければ初期化する
+     *              Ensure the lazy initialization group for the given name is initialized
+     * @param {string} name - パイプライン名 / Pipeline name to look up its lazy group
+     */
     private ensureLazyGroup;
+    /**
+     * @description すべての遅延初期化グループを事前にロードする
+     *              Preload all lazy initialization groups eagerly
+     */
     preloadLazyGroups(): void;
+    /**
+     * @description 塗りつぶし描画用パイプラインを作成する（RGBA/BGRA/ステンシル対応）
+     *              Create fill render pipelines (RGBA, BGRA, and stencil variants)
+     */
     private createFillPipeline;
+    /**
+     * @description ステンシル塗りつぶし用パイプラインを作成する（書き込み・塗りつぶし・アトラス・メイン・マスク対応）
+     *              Create stencil fill pipelines (write, fill, atlas, main, and masked variants)
+     */
     private createStencilFillPipelines;
+    /**
+     * @description クリッピング用パイプラインを作成する（レベル別の書き込み・クリア）
+     *              Create clip pipelines (level-based write and clear variants)
+     */
     private createClipPipeline;
+    /**
+     * @description マスク合成用パイプラインを作成する（レベル別のマージ・クリア）
+     *              Create mask union pipelines (level-based merge and clear variants)
+     */
     private createMaskUnionPipelines;
+    /**
+     * @description マスク描画用パイプラインを作成する
+     *              Create mask render pipeline
+     */
     private createMaskPipeline;
+    /**
+     * @description 基本描画パイプラインを作成する（RGBA/BGRA）
+     *              Create basic render pipelines (RGBA and BGRA variants)
+     */
     private createBasicPipeline;
+    /**
+     * @description テクスチャ描画用パイプラインを作成する
+     *              Create texture render pipeline
+     */
     private createTexturePipeline;
+    /**
+     * @description インスタンス描画用パイプラインを作成する（ブレンドバリアント・マスク対応）
+     *              Create instanced render pipelines (blend variants and masked)
+     */
     private createInstancedPipeline;
+    /**
+     * @description グラデーション塗りつぶし用パイプラインを作成する（RGBA/BGRA/ステンシル対応）
+     *              Create gradient fill pipelines (RGBA, BGRA, stencil, and stroke variants)
+     */
     private createGradientPipeline;
+    /**
+     * @description ビットマップ塗りつぶし用パイプラインを作成する（RGBA/BGRA/ステンシル・ストローク対応）
+     *              Create bitmap fill pipelines (RGBA, BGRA, stencil, and stroke variants)
+     */
     private createBitmapFillPipeline;
+    /**
+     * @description ブレンド描画用パイプラインを作成する（デュアルテクスチャブレンド）
+     *              Create blend render pipeline for dual-texture blending
+     */
     private createBlendPipeline;
+    /**
+     * @description ブラーフィルター用パイプラインを作成する（halfBlur 1〜16のバリアント）
+     *              Create blur filter pipelines (halfBlur 1-16 variants)
+     */
     private createBlurFilterPipeline;
+    /**
+     * @description テクスチャコピー用パイプラインを作成する（各種ブレンド・フィルター出力・MSAA対応）
+     *              Create texture copy pipelines (various blend modes, filter output, MSAA variants)
+     */
     private createTextureCopyPipeline;
+    /**
+     * @description 位置指定テクスチャ描画用パイプラインを作成する（RGBA/ビットマップレンダー対応）
+     *              Create positioned texture pipelines (RGBA, bitmap render, MSAA variants)
+     */
     private createPositionedTexturePipeline;
+    /**
+     * @description テクスチャスケーリング用パイプラインを作成する
+     *              Create texture scale pipelines
+     */
     private createTextureScalePipeline;
+    /**
+     * @description ビットマップ同期描画用パイプラインを作成する（MSAA 4x）
+     *              Create bitmap sync render pipeline (MSAA 4x)
+     */
     private createBitmapSyncPipeline;
+    /**
+     * @description カラーマトリクスフィルター・ベベル・グロー・ドロップシャドウ等のフィルターパイプラインを作成する
+     *              Create filter pipelines (color matrix, bevel, glow, drop shadow, gradient glow/bevel)
+     */
     private createColorMatrixFilterPipeline;
+    /**
+     * @description 複合ブレンド用パイプラインを作成する
+     *              Create complex blend pipelines
+     */
     private createComplexBlendPipelines;
+    /**
+     * @description 複合ブレンドのコピー・スケール用パイプラインを作成する
+     *              Create complex blend copy and scale pipelines
+     */
     private createComplexBlendCopyPipeline;
+    /**
+     * @description 複合ブレンドの出力用パイプラインを作成する（MSAA対応含む）
+     *              Create complex blend output pipelines (including MSAA variants)
+     */
     private createComplexBlendOutputPipeline;
+    /**
+     * @description 指定されたフラグメントシェーダーとテクスチャ数でフィルターパイプラインを作成する
+     *              Create a filter pipeline with the specified fragment shader and texture count
+     * @param {string} name - パイプライン名 / Pipeline name
+     * @param {string} fragment_shader_code - フラグメントシェーダーコード / Fragment shader WGSL source code
+     * @param {number} texture_count - テクスチャバインディング数 / Number of texture bindings
+     * @param {GPUBlendState} blend - ブレンドステート / Blend state configuration
+     */
     private createFilterPipelineWithLayout;
+    /**
+     * @description フルスクリーンクアッド描画用の汎用パイプラインを作成する
+     *              Create a generic fullscreen quad render pipeline
+     * @param {GPUPipelineLayout} pipeline_layout - パイプラインレイアウト / Pipeline layout
+     * @param {GPUShaderModule} vertex_module - 頂点シェーダーモジュール / Vertex shader module
+     * @param {GPUShaderModule} fragment_module - フラグメントシェーダーモジュール / Fragment shader module
+     * @param {GPUTextureFormat} format - テクスチャフォーマット / Target texture format
+     * @param {GPUBlendState} blend - ブレンドステート / Blend state configuration
+     * @param {number} multisample_count - MSAAサンプル数（任意） / Optional MSAA sample count
+     * @param {GPUDepthStencilState} depth_stencil - 深度ステンシルステート（任意） / Optional depth-stencil state
+     * @return {GPURenderPipeline} レンダーパイプライン / The created render pipeline
+     */
     private createFullscreenQuadPipeline;
+    /**
+     * @description 名前からレンダーパイプラインを取得する（遅延初期化を含む）
+     *              Get a render pipeline by name, initializing lazy groups if needed
+     * @param {string} name - パイプライン名 / Pipeline name
+     * @return {GPURenderPipeline | undefined} パイプラインまたはundefined / The pipeline or undefined
+     */
     getPipeline(name: string): GPURenderPipeline | undefined;
     /**
-     * @description フィルターパイプラインのoverride定数バリアントを取得
-     *              GPU warp divergenceを排除するコンパイル時分岐特殊化
+     * @description フィルターパイプラインのoverride定数バリアントを取得する。GPU warp divergenceを排除するコンパイル時分岐特殊化
+     *              Get a filter pipeline variant with override constants. Compile-time branch specialization to eliminate GPU warp divergence
+     * @param {string} base_name - ベースパイプライン名 / Base pipeline name
+     * @param {Record<string, number>} constants - オーバーライド定数 / Override constant values
+     * @return {GPURenderPipeline | undefined} パイプラインまたはundefined / The pipeline or undefined
      */
-    getFilterPipeline(baseName: string, constants: Record<string, number>): GPURenderPipeline | undefined;
+    getFilterPipeline(base_name: string, constants: Record<string, number>): GPURenderPipeline | undefined;
     /**
-     * @description グラデーションタイプとスプレッドモードに応じた特殊化パイプラインを取得
-     *              override定数でGPU warp divergenceを排除
+     * @description グラデーションタイプとスプレッドモードに応じた特殊化パイプラインを取得する。override定数でGPU warp divergenceを排除
+     *              Get a gradient pipeline specialized by gradient type and spread mode. Uses override constants to eliminate GPU warp divergence
+     * @param {string} base_name - ベースパイプライン名 / Base pipeline name
+     * @param {number} gradient_type - グラデーションタイプ / Gradient type identifier
+     * @param {number} spread_mode - スプレッドモード / Spread mode identifier
+     * @return {GPURenderPipeline | undefined} パイプラインまたはundefined / The pipeline or undefined
+     */
+    getGradientPipeline(base_name: string, gradient_type: number, spread_mode: number): GPURenderPipeline | undefined;
+    /**
+     * @description グラデーション用パイプラインレイアウト
+     *              Pipeline layout for gradient pipelines
      */
-    getGradientPipeline(baseName: string, gradientType: number, spreadMode: number): GPURenderPipeline | undefined;
     private gradientPipelineLayout;
+    /**
+     * @description グラデーション用頂点シェーダーモジュール
+     *              Vertex shader module for gradient pipelines
+     */
     private gradientVertexShaderModule;
+    /**
+     * @description グラデーション用フラグメントシェーダーモジュール
+     *              Fragment shader module for gradient pipelines
+     */
     private gradientFragmentShaderModule;
+    /**
+     * @description グラデーション用ステンシルフラグメントシェーダーモジュール
+     *              Stencil fragment shader module for gradient pipelines
+     */
     private gradientStencilFragmentShaderModule;
+    /**
+     * @description グラデーションバリアントパイプラインを作成する（override定数による特殊化）
+     *              Create a gradient variant pipeline with override constants for specialization
+     * @param {string} base_name - ベースパイプライン名 / Base pipeline name
+     * @param {number} gradient_type - グラデーションタイプ / Gradient type identifier
+     * @param {number} spread_mode - スプレッドモード / Spread mode identifier
+     * @return {GPURenderPipeline | undefined} パイプラインまたはundefined / The pipeline or undefined
+     */
     private createGradientVariant;
+    /**
+     * @description 名前からバインドグループレイアウトを取得する（遅延初期化を含む）
+     *              Get a bind group layout by name, initializing lazy groups if needed
+     * @param {string} name - バインドグループレイアウト名 / Bind group layout name
+     * @return {GPUBindGroupLayout | undefined} レイアウトまたはundefined / The layout or undefined
+     */
     getBindGroupLayout(name: string): GPUBindGroupLayout | undefined;
+    /**
+     * @description ノードクリア用パイプラインを作成する（カラーとステンシルの同時クリア）
+     *              Create node clear pipeline for simultaneous color and stencil clear
+     */
     private createNodeClearPipeline;
+    /**
+     * @description すべてのパイプライン・レイアウト・シェーダーモジュールを解放する
+     *              Dispose all pipelines, layouts, and shader module caches
+     */
     dispose(): void;
 }