@next2d/webgpu 3.0.4 → 3.1.0

package/src/Context/usecase/ContextDrawArraysInstancedUseCase.js

@@ -3,8 +3,48 @@ import { $currentBlendMode } from "../../Blend";
 import { renderQueue } from "@next2d/render-queue";
 import { $isMaskTestEnabled, $getMaskStencilReference } from "../../Mask";
 import { $getAtlasAttachmentObject } from "../../AtlasManager";
+/**
+ * @description キャッシュ済みバインドグループ
+ *              Cached bind group
+ */
 let $cachedBindGroup = null;
+/**
+ * @description キャッシュ済みアトラステクスチャビュー
+ *              Cached atlas texture view
+ */
 let $cachedAtlasView = null;
+/**
+ * @description ブレンドモードに応じたインスタンスパイプライン名を返す
+ */
+const $getPipelineName = (mode) => {
+    switch (mode) {
+        case "add":
+            return "instanced_add";
+        case "screen":
+            return "instanced_screen";
+        case "alpha":
+            return "instanced_alpha";
+        case "erase":
+            return "instanced_erase";
+        case "copy":
+            return "instanced_copy";
+        default:
+            return "instanced";
+    }
+};
+/**
+ * @description インスタンス描画を実行する
+ *              Executes instanced array drawing
+ * @param {GPUDevice} device GPUデバイス / GPU device
+ * @param {GPUCommandEncoder} command_encoder コマンドエンコーダ / Command encoder
+ * @param {GPURenderPassEncoder | null} render_pass_encoder レンダーパスエンコーダ / Render pass encoder
+ * @param {IAttachmentObject} main_attachment メインアタッチメント / Main attachment
+ * @param {BufferManager} buffer_manager バッファマネージャ / Buffer manager
+ * @param {FrameBufferManager} frame_buffer_manager フレームバッファマネージャ / Frame buffer manager
+ * @param {TextureManager} texture_manager テクスチャマネージャ / Texture manager
+ * @param {PipelineManager} pipeline_manager パイプラインマネージャ / Pipeline manager
+ * @return {GPURenderPassEncoder | null} レンダーパスエンコーダまたはnull / Render pass encoder or null
+ */
 export const execute = (device, command_encoder, render_pass_encoder, main_attachment, buffer_manager, frame_buffer_manager, texture_manager, pipeline_manager) => {
     const shaderManager = getInstancedShaderManager();
     if (shaderManager.count === 0) {
@@ -19,26 +59,7 @@ export const execute = (device, command_encoder, render_pass_encoder, main_attac
     const maskReference = $getMaskStencilReference();
     // 現在のブレンドモードを取得
     const blendMode = $currentBlendMode;
-    // ブレンドモードに応じたパイプライン名を生成
-    // simpleBlendModes: normal, layer, add, screen, alpha, erase, copy
-    const getPipelineName = (mode) => {
-        switch (mode) {
-            case "add":
-                return "instanced_add";
-            case "screen":
-                return "instanced_screen";
-            case "alpha":
-                return "instanced_alpha";
-            case "erase":
-                return "instanced_erase";
-            case "copy":
-                return "instanced_copy";
-            default:
-                // normal, layer
-                return "instanced";
-        }
-    };
-    const pipelineName = getPipelineName(blendMode);
+    const pipelineName = $getPipelineName(blendMode);
     const normalPipeline = pipeline_manager.getPipeline(pipelineName);
     const maskedPipeline = pipeline_manager.getPipeline("instanced_masked");
     // 実際にマスクを使用するか判定

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

@@ -3,4 +3,19 @@ import type { BufferManager } from "../../BufferManager";
 import type { FrameBufferManager } from "../../FrameBufferManager";
 import type { TextureManager } from "../../TextureManager";
 import type { PipelineManager } from "../../Shader/PipelineManager";
-export declare const execute: (device: GPUDevice, commandEncoder: GPUCommandEncoder, renderPassEncoder: GPURenderPassEncoder | null, mainAttachment: IAttachmentObject, bufferManager: BufferManager, frameBufferManager: FrameBufferManager, textureManager: TextureManager, pipelineManager: PipelineManager, useIndirect?: boolean, useStorageBuffer?: boolean) => GPURenderPassEncoder | null;
+/**
+ * @description Indirect描画を使用したインスタンス描画を実行する
+ *              Executes instanced drawing with indirect draw support
+ * @param {GPUDevice} device GPUデバイス / GPU device
+ * @param {GPUCommandEncoder} command_encoder コマンドエンコーダ / Command encoder
+ * @param {GPURenderPassEncoder | null} render_pass_encoder レンダーパスエンコーダ / Render pass encoder
+ * @param {IAttachmentObject} main_attachment メインアタッチメント / Main attachment
+ * @param {BufferManager} buffer_manager バッファマネージャ / Buffer manager
+ * @param {FrameBufferManager} frame_buffer_manager フレームバッファマネージャ / Frame buffer manager
+ * @param {TextureManager} texture_manager テクスチャマネージャ / Texture manager
+ * @param {PipelineManager} pipeline_manager パイプラインマネージャ / Pipeline manager
+ * @param {boolean} use_indirect Indirect描画使用フラグ / Whether to use indirect drawing
+ * @param {boolean} use_storage_buffer StorageBuffer使用フラグ / Whether to use storage buffer
+ * @return {GPURenderPassEncoder | null} レンダーパスエンコーダまたはnull / Render pass encoder or null
+ */
+export declare const execute: (device: GPUDevice, command_encoder: GPUCommandEncoder, render_pass_encoder: GPURenderPassEncoder | null, main_attachment: IAttachmentObject, buffer_manager: BufferManager, frame_buffer_manager: FrameBufferManager, texture_manager: TextureManager, pipeline_manager: PipelineManager, use_indirect?: boolean, use_storage_buffer?: boolean) => GPURenderPassEncoder | null;

package/src/Context/usecase/ContextDrawIndirectUseCase.js

@@ -3,17 +3,40 @@ import { $currentBlendMode } from "../../Blend";
 import { renderQueue } from "@next2d/render-queue";
 import { $isMaskTestEnabled, $getMaskStencilReference } from "../../Mask";
 import { $getAtlasAttachmentObject } from "../../AtlasManager";
+/**
+ * @description キャッシュ済みバインドグループ
+ *              Cached bind group
+ */
 let $cachedBindGroup = null;
+/**
+ * @description キャッシュ済みアトラステクスチャビュー
+ *              Cached atlas texture view
+ */
 let $cachedAtlasView = null;
-export const execute = (device, commandEncoder, renderPassEncoder, mainAttachment, bufferManager, frameBufferManager, textureManager, pipelineManager, useIndirect = true, useStorageBuffer = true) => {
+/**
+ * @description Indirect描画を使用したインスタンス描画を実行する
+ *              Executes instanced drawing with indirect draw support
+ * @param {GPUDevice} device GPUデバイス / GPU device
+ * @param {GPUCommandEncoder} command_encoder コマンドエンコーダ / Command encoder
+ * @param {GPURenderPassEncoder | null} render_pass_encoder レンダーパスエンコーダ / Render pass encoder
+ * @param {IAttachmentObject} main_attachment メインアタッチメント / Main attachment
+ * @param {BufferManager} buffer_manager バッファマネージャ / Buffer manager
+ * @param {FrameBufferManager} frame_buffer_manager フレームバッファマネージャ / Frame buffer manager
+ * @param {TextureManager} texture_manager テクスチャマネージャ / Texture manager
+ * @param {PipelineManager} pipeline_manager パイプラインマネージャ / Pipeline manager
+ * @param {boolean} use_indirect Indirect描画使用フラグ / Whether to use indirect drawing
+ * @param {boolean} use_storage_buffer StorageBuffer使用フラグ / Whether to use storage buffer
+ * @return {GPURenderPassEncoder | null} レンダーパスエンコーダまたはnull / Render pass encoder or null
+ */
+export const execute = (device, command_encoder, render_pass_encoder, main_attachment, buffer_manager, frame_buffer_manager, texture_manager, pipeline_manager, use_indirect = true, use_storage_buffer = true) => {
     const shaderManager = getInstancedShaderManager();
     if (shaderManager.count === 0) {
-        return renderPassEncoder;
+        return render_pass_encoder;
     }
     // 既存のレンダーパスを終了
-    if (renderPassEncoder) {
-        renderPassEncoder.end();
-        renderPassEncoder = null;
+    if (render_pass_encoder) {
+        render_pass_encoder.end();
+        render_pass_encoder = null;
     }
     const isMasked = $isMaskTestEnabled();
     const maskReference = $getMaskStencilReference();
@@ -38,10 +61,10 @@ export const execute = (device, commandEncoder, renderPassEncoder, mainAttachmen
         }
     };
     const pipelineName = getPipelineName(blendMode);
-    const normalPipeline = pipelineManager.getPipeline(pipelineName);
-    const maskedPipeline = pipelineManager.getPipeline("instanced_masked");
+    const normalPipeline = pipeline_manager.getPipeline(pipelineName);
+    const maskedPipeline = pipeline_manager.getPipeline("instanced_masked");
     const useStencil = isMasked && maskedPipeline
-        && (mainAttachment.msaaStencil?.view || mainAttachment.stencil?.view);
+        && (main_attachment.msaaStencil?.view || main_attachment.stencil?.view);
     const pipeline = useStencil ? maskedPipeline : normalPipeline;
     if (!pipeline) {
         console.error("[WebGPU] Instanced pipeline not found");
@@ -51,21 +74,21 @@ export const execute = (device, commandEncoder, renderPassEncoder, mainAttachmen
     let passEncoder;
     if (useStencil) {
         // MSAA対応
-        const useMsaa = mainAttachment.msaa && mainAttachment.msaaTexture?.view;
-        const colorView = useMsaa ? mainAttachment.msaaTexture.view : mainAttachment.texture.view;
-        const stencilView = useMsaa && mainAttachment.msaaStencil?.view
-            ? mainAttachment.msaaStencil.view : mainAttachment.stencil.view;
-        const resolveTarget = useMsaa ? mainAttachment.texture.view : null;
-        const renderPassDescriptor = frameBufferManager.createStencilRenderPassDescriptor(colorView, stencilView, "load", "load", resolveTarget);
-        passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);
+        const useMsaa = main_attachment.msaa && main_attachment.msaaTexture?.view;
+        const colorView = useMsaa ? main_attachment.msaaTexture.view : main_attachment.texture.view;
+        const stencilView = useMsaa && main_attachment.msaaStencil?.view
+            ? main_attachment.msaaStencil.view : main_attachment.stencil.view;
+        const resolveTarget = useMsaa ? main_attachment.texture.view : null;
+        const renderPassDescriptor = frame_buffer_manager.createStencilRenderPassDescriptor(colorView, stencilView, "load", "load", resolveTarget);
+        passEncoder = command_encoder.beginRenderPass(renderPassDescriptor);
     }
     else {
         // 通常のレンダーパス（MSAA対応）
-        const useMsaa = mainAttachment.msaa && mainAttachment.msaaTexture?.view;
-        const colorView = useMsaa ? mainAttachment.msaaTexture.view : mainAttachment.texture.view;
-        const resolveTarget = useMsaa ? mainAttachment.texture.view : null;
-        const renderPassDescriptor = frameBufferManager.createRenderPassDescriptor(colorView, 0, 0, 0, 0, "load", resolveTarget);
-        passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);
+        const useMsaa = main_attachment.msaa && main_attachment.msaaTexture?.view;
+        const colorView = useMsaa ? main_attachment.msaaTexture.view : main_attachment.texture.view;
+        const resolveTarget = useMsaa ? main_attachment.texture.view : null;
+        const renderPassDescriptor = frame_buffer_manager.createRenderPassDescriptor(colorView, 0, 0, 0, 0, "load", resolveTarget);
+        passEncoder = command_encoder.beginRenderPass(renderPassDescriptor);
     }
     passEncoder.setPipeline(pipeline);
     if (useStencil) {
@@ -75,29 +98,29 @@ export const execute = (device, commandEncoder, renderPassEncoder, mainAttachmen
     const instanceData = new Float32Array(renderQueue.buffer.buffer, renderQueue.buffer.byteOffset, renderQueue.offset);
     // インスタンスバッファを作成または取得
     let instanceBuffer;
-    if (useStorageBuffer) {
+    if (use_storage_buffer) {
         // Storage Buffer最適化: プールから再利用してメモリアロケーション削減
         // Storage BufferはVERTEXフラグ付きで作成されているため、setVertexBufferで使用可能
-        instanceBuffer = bufferManager.acquireStorageBuffer(instanceData.byteLength);
-        bufferManager.writeStorageBuffer(instanceBuffer, instanceData);
+        instanceBuffer = buffer_manager.acquireStorageBuffer(instanceData.byteLength);
+        buffer_manager.writeStorageBuffer(instanceBuffer, instanceData);
     }
     else {
         // 従来方式: プールから再利用
-        instanceBuffer = bufferManager.acquireVertexBuffer(instanceData.byteLength, instanceData);
+        instanceBuffer = buffer_manager.acquireVertexBuffer(instanceData.byteLength, instanceData);
     }
     // 頂点バッファ（矩形）を取得（キャッシュ済み）
-    const vertexBuffer = bufferManager.getUnitRectBuffer();
+    const vertexBuffer = buffer_manager.getUnitRectBuffer();
     // アトラステクスチャをバインド（複数アトラス対応）
     // AtlasManagerから取得、フォールバックとしてFrameBufferManagerから取得
-    const atlasAttachment = $getAtlasAttachmentObject() || frameBufferManager.getAttachment("atlas");
+    const atlasAttachment = $getAtlasAttachmentObject() || frame_buffer_manager.getAttachment("atlas");
     if (!atlasAttachment) {
         console.error("[WebGPU] Atlas attachment not found");
         passEncoder.end();
         return null;
     }
     // アトラス用サンプラーを取得（キャッシュ済み）
-    const sampler = textureManager.createSampler("atlas_instanced_sampler", false);
-    const bindGroupLayout = pipelineManager.getBindGroupLayout("instanced");
+    const sampler = texture_manager.createSampler("atlas_instanced_sampler", false);
+    const bindGroupLayout = pipeline_manager.getBindGroupLayout("instanced");
     if (!bindGroupLayout) {
         console.error("[WebGPU] Instanced bind group layout not found");
         passEncoder.end();
@@ -125,13 +148,13 @@ export const execute = (device, commandEncoder, renderPassEncoder, mainAttachmen
     passEncoder.setVertexBuffer(0, vertexBuffer);
     passEncoder.setVertexBuffer(1, instanceBuffer);
     passEncoder.setBindGroup(0, $cachedBindGroup);
-    if (useIndirect) {
+    if (use_indirect) {
         // Indirect Drawing: CPU-GPU間のオーバーヘッドを削減
         // 注意: 1フレーム内で複数回呼び出される場合があるため、
         // 毎回新しいIndirect Bufferを作成する必要がある
         // （共有バッファを使うとqueue.writeBufferの更新が全てGPU実行前に行われ、
         // 全てのdrawIndirectが最後の更新値を使用してしまう）
-        const indirectBuffer = bufferManager.createIndirectBuffer(6, // vertexCount (2 triangles = 6 vertices)
+        const indirectBuffer = buffer_manager.createIndirectBuffer(6, // vertexCount (2 triangles = 6 vertices)
         shaderManager.count, // instanceCount
         0, // firstVertex
         0 // firstInstance

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

@@ -1,4 +1,27 @@
 import type { IPath } from "../../interface/IPath";
 import type { BufferManager } from "../../BufferManager";
 import type { PipelineManager } from "../../Shader/PipelineManager";
+/**
+ * @description グラデーションフィル描画を実行する
+ *              Executes gradient fill rendering
+ * @param {GPUDevice} device GPUデバイス / GPU device
+ * @param {GPURenderPassEncoder} render_pass_encoder レンダーパスエンコーダ / Render pass encoder
+ * @param {BufferManager} buffer_manager バッファマネージャ / Buffer manager
+ * @param {PipelineManager} pipeline_manager パイプラインマネージャ / Pipeline manager
+ * @param {IPath[]} path_vertices パス頂点配列 / Path vertices array
+ * @param {Float32Array} context_matrix コンテキスト変換行列 / Context transformation matrix
+ * @param {Float32Array} fill_style フィルスタイル（RGBA） / Fill style (RGBA)
+ * @param {number} type グラデーションタイプ / Gradient type
+ * @param {number[]} stops グラデーションストップ配列 / Gradient stops array
+ * @param {Float32Array} gradient_matrix グラデーション変換行列 / Gradient transformation matrix
+ * @param {number} spread スプレッドモード / Spread mode
+ * @param {number} interpolation 補間モード / Interpolation mode
+ * @param {number} focal 焦点距離 / Focal point
+ * @param {number} viewport_width ビューポート幅 / Viewport width
+ * @param {number} viewport_height ビューポート高さ / Viewport height
+ * @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 {GPUTexture | null} LUTテクスチャまたはnull / LUT texture or null
+ */
 export declare const execute: (device: GPUDevice, render_pass_encoder: GPURenderPassEncoder, buffer_manager: BufferManager, pipeline_manager: PipelineManager, path_vertices: IPath[], context_matrix: Float32Array, fill_style: Float32Array, type: number, stops: number[], gradient_matrix: Float32Array, spread: number, interpolation: number, focal: number, viewport_width: number, viewport_height: number, use_atlas_target: boolean, use_stencil_pipeline?: boolean, _clip_level?: number) => GPUTexture | null;

package/src/Context/usecase/ContextGradientFillUseCase.js

@@ -4,16 +4,63 @@ import { execute as contextComputeGradientMatrixService } from "../service/Conte
 import { $getLUTFromCache, $putLUTToCache } from "../../Gradient/GradientLUTCache";
 import { $acquireFillTexture } from "../../FillTexturePool";
 import { $isMaskDrawing, $getMaskStencilReference } from "../../Mask";
+/**
+ * @description グラデーションサンプラーのキャッシュ
+ *              Cached gradient sampler
+ */
 let $gradientSampler = null;
+/**
+ * @description ユニフォームデータの事前確保配列（36要素）
+ *              Pre-allocated uniform data array (36 elements)
+ */
 const $uniformData36 = new Float32Array(36);
+/**
+ * @description ステンシルデータの事前確保配列（16要素）
+ *              Pre-allocated stencil data array (16 elements)
+ */
 const $stencilData16 = new Float32Array(16);
+/**
+ * @description ステンシル用動的バインドグループのキャッシュ
+ *              Cached dynamic bind group for stencil operations
+ */
 let $stencilDynamicBindGroup = null;
+/**
+ * @description ステンシル用動的バッファのキャッシュ
+ *              Cached dynamic buffer for stencil operations
+ */
 let $stencilDynamicBuffer = null;
+/**
+ * @description バインドグループエントリの事前確保配列
+ *              Pre-allocated bind group entry array
+ */
 const $entries3 = [
     { "binding": 0, "resource": { "buffer": null } },
     { "binding": 1, "resource": null },
     { "binding": 2, "resource": null }
 ];
+/**
+ * @description グラデーションフィル描画を実行する
+ *              Executes gradient fill rendering
+ * @param {GPUDevice} device GPUデバイス / GPU device
+ * @param {GPURenderPassEncoder} render_pass_encoder レンダーパスエンコーダ / Render pass encoder
+ * @param {BufferManager} buffer_manager バッファマネージャ / Buffer manager
+ * @param {PipelineManager} pipeline_manager パイプラインマネージャ / Pipeline manager
+ * @param {IPath[]} path_vertices パス頂点配列 / Path vertices array
+ * @param {Float32Array} context_matrix コンテキスト変換行列 / Context transformation matrix
+ * @param {Float32Array} fill_style フィルスタイル（RGBA） / Fill style (RGBA)
+ * @param {number} type グラデーションタイプ / Gradient type
+ * @param {number[]} stops グラデーションストップ配列 / Gradient stops array
+ * @param {Float32Array} gradient_matrix グラデーション変換行列 / Gradient transformation matrix
+ * @param {number} spread スプレッドモード / Spread mode
+ * @param {number} interpolation 補間モード / Interpolation mode
+ * @param {number} focal 焦点距離 / Focal point
+ * @param {number} viewport_width ビューポート幅 / Viewport width
+ * @param {number} viewport_height ビューポート高さ / Viewport height
+ * @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 {GPUTexture | null} LUTテクスチャまたはnull / LUT texture or null
+ */
 export const execute = (device, render_pass_encoder, buffer_manager, pipeline_manager, path_vertices, context_matrix, fill_style, type, stops, gradient_matrix, spread, interpolation, focal, viewport_width, viewport_height, use_atlas_target, use_stencil_pipeline = false, _clip_level = 1) => {
     // MeshFillGenerateUseCaseで頂点データを生成（4 floats/vertex: position + bezier）
     const mesh = meshFillGenerateUseCase(path_vertices);

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

@@ -1,4 +1,27 @@
 import type { IPath } from "../../interface/IPath";
 import type { BufferManager } from "../../BufferManager";
 import type { PipelineManager } from "../../Shader/PipelineManager";
+/**
+ * @description グラデーションストローク描画を実行する
+ *              Executes gradient stroke rendering
+ * @param {GPUDevice} device GPUデバイス / GPU device
+ * @param {GPURenderPassEncoder} render_pass_encoder レンダーパスエンコーダ / Render pass encoder
+ * @param {BufferManager} buffer_manager バッファマネージャ / Buffer manager
+ * @param {PipelineManager} pipeline_manager パイプラインマネージャ / Pipeline manager
+ * @param {IPath[]} vertices パス頂点配列 / Path vertices array
+ * @param {number} thickness ストローク太さ / Stroke thickness
+ * @param {Float32Array} context_matrix コンテキスト変換行列 / Context transformation matrix
+ * @param {Float32Array} stroke_style ストロークスタイル（RGBA） / Stroke style (RGBA)
+ * @param {number} type グラデーションタイプ / Gradient type
+ * @param {number[]} stops グラデーションストップ配列 / Gradient stops array
+ * @param {Float32Array} gradient_matrix グラデーション変換行列 / Gradient transformation matrix
+ * @param {number} spread スプレッドモード / Spread mode
+ * @param {number} interpolation 補間モード / Interpolation mode
+ * @param {number} focal 焦点距離 / Focal point
+ * @param {number} viewport_width ビューポート幅 / Viewport width
+ * @param {number} viewport_height ビューポート高さ / Viewport height
+ * @param {boolean} use_atlas_target アトラスターゲット使用フラグ / Whether to use atlas target
+ * @param {boolean} use_stencil_pipeline ステンシルパイプライン使用フラグ / Whether to use stencil pipeline
+ * @return {GPUTexture | null} LUTテクスチャまたはnull / LUT texture or null
+ */
 export declare const execute: (device: GPUDevice, render_pass_encoder: GPURenderPassEncoder, buffer_manager: BufferManager, pipeline_manager: PipelineManager, vertices: IPath[], thickness: number, context_matrix: Float32Array, stroke_style: Float32Array, type: number, stops: number[], gradient_matrix: Float32Array, spread: number, interpolation: number, focal: number, viewport_width: number, viewport_height: number, use_atlas_target: boolean, use_stencil_pipeline: boolean) => GPUTexture | null;

package/src/Context/usecase/ContextGradientStrokeUseCase.js

@@ -3,13 +3,48 @@ import { generateGradientLUT, getAdaptiveResolution } from "../../Gradient/Gradi
 import { execute as contextComputeGradientMatrixService } from "../service/ContextComputeGradientMatrixService";
 import { $getLUTFromCache, $putLUTToCache } from "../../Gradient/GradientLUTCache";
 import { $acquireFillTexture } from "../../FillTexturePool";
+/**
+ * @description グラデーションサンプラーのキャッシュ
+ *              Cached gradient sampler
+ */
 let $gradientSampler = null;
+/**
+ * @description ユニフォームデータの事前確保配列（36要素）
+ *              Pre-allocated uniform data array (36 elements)
+ */
 const $uniformData36 = new Float32Array(36);
+/**
+ * @description バインドグループエントリの事前確保配列
+ *              Pre-allocated bind group entry array
+ */
 const $entries3 = [
     { "binding": 0, "resource": { "buffer": null } },
     { "binding": 1, "resource": null },
     { "binding": 2, "resource": null }
 ];
+/**
+ * @description グラデーションストローク描画を実行する
+ *              Executes gradient stroke rendering
+ * @param {GPUDevice} device GPUデバイス / GPU device
+ * @param {GPURenderPassEncoder} render_pass_encoder レンダーパスエンコーダ / Render pass encoder
+ * @param {BufferManager} buffer_manager バッファマネージャ / Buffer manager
+ * @param {PipelineManager} pipeline_manager パイプラインマネージャ / Pipeline manager
+ * @param {IPath[]} vertices パス頂点配列 / Path vertices array
+ * @param {number} thickness ストローク太さ / Stroke thickness
+ * @param {Float32Array} context_matrix コンテキスト変換行列 / Context transformation matrix
+ * @param {Float32Array} stroke_style ストロークスタイル（RGBA） / Stroke style (RGBA)
+ * @param {number} type グラデーションタイプ / Gradient type
+ * @param {number[]} stops グラデーションストップ配列 / Gradient stops array
+ * @param {Float32Array} gradient_matrix グラデーション変換行列 / Gradient transformation matrix
+ * @param {number} spread スプレッドモード / Spread mode
+ * @param {number} interpolation 補間モード / Interpolation mode
+ * @param {number} focal 焦点距離 / Focal point
+ * @param {number} viewport_width ビューポート幅 / Viewport width
+ * @param {number} viewport_height ビューポート高さ / Viewport height
+ * @param {boolean} use_atlas_target アトラスターゲット使用フラグ / Whether to use atlas target
+ * @param {boolean} use_stencil_pipeline ステンシルパイプライン使用フラグ / Whether to use stencil pipeline
+ * @return {GPUTexture | null} LUTテクスチャまたはnull / LUT texture or null
+ */
 export const execute = (device, render_pass_encoder, buffer_manager, pipeline_manager, vertices, thickness, context_matrix, stroke_style, type, stops, gradient_matrix, spread, interpolation, focal, viewport_width, viewport_height, use_atlas_target, use_stencil_pipeline) => {
     // グラデーションストローク用メッシュを生成（4 floats/vertex: position + bezier）
     const mesh = meshGradientStrokeGenerateUseCase(vertices, thickness);

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

@@ -3,4 +3,16 @@ import type { BufferManager } from "../../BufferManager";
 import type { FrameBufferManager } from "../../FrameBufferManager";
 import type { TextureManager } from "../../TextureManager";
 import type { PipelineManager } from "../../Shader/PipelineManager";
-export declare const execute: (device: GPUDevice, commandEncoder: GPUCommandEncoder, mainAttachment: IAttachmentObject | null, frameBufferManager: FrameBufferManager, textureManager: TextureManager, pipelineManager: PipelineManager, bufferManager: BufferManager) => void;
+/**
+ * @description 複雑なブレンドモードキューを処理する
+ *              Processes the complex blend mode queue
+ * @param {GPUDevice} device GPUデバイス / GPU device
+ * @param {GPUCommandEncoder} command_encoder コマンドエンコーダ / Command encoder
+ * @param {IAttachmentObject | null} main_attachment メインアタッチメント / Main attachment
+ * @param {FrameBufferManager} frame_buffer_manager フレームバッファマネージャ / Frame buffer manager
+ * @param {TextureManager} texture_manager テクスチャマネージャ / Texture manager
+ * @param {PipelineManager} pipeline_manager パイプラインマネージャ / Pipeline manager
+ * @param {BufferManager} buffer_manager バッファマネージャ / Buffer manager
+ * @return {void}
+ */
+export declare const execute: (device: GPUDevice, command_encoder: GPUCommandEncoder, main_attachment: IAttachmentObject | null, frame_buffer_manager: FrameBufferManager, texture_manager: TextureManager, pipeline_manager: PipelineManager, buffer_manager: BufferManager) => void;