@next2d/webgpu 3.0.4 → 3.1.0

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

@@ -3,10 +3,10 @@ import type { ITextureObject } from "../../interface/ITextureObject";
  * @description テクスチャをプールに返却
  *              Release texture back to pool
  *
- * @param  {Map<string, ITextureObject[]>} texturePool
- * @param  {ITextureObject} textureObject
+ * @param  {Map<string, ITextureObject[]>} texture_pool - テクスチャプール
+ * @param  {ITextureObject} texture_object - 返却するテクスチャオブジェクト
  * @return {void}
  * @method
  * @protected
  */
-export declare const execute: (texturePool: Map<string, ITextureObject[]>, textureObject: ITextureObject) => void;
+export declare const execute: (texture_pool: Map<string, ITextureObject[]>, texture_object: ITextureObject) => void;

package/src/AttachmentManager/service/AttachmentManagerReleaseTextureService.js

@@ -2,16 +2,16 @@
  * @description テクスチャをプールに返却
  *              Release texture back to pool
  *
- * @param  {Map<string, ITextureObject[]>} texturePool
- * @param  {ITextureObject} textureObject
+ * @param  {Map<string, ITextureObject[]>} texture_pool - テクスチャプール
+ * @param  {ITextureObject} texture_object - 返却するテクスチャオブジェクト
  * @return {void}
  * @method
  * @protected
  */
-export const execute = (texturePool, textureObject) => {
-    const key = `${textureObject.width}x${textureObject.height}_${textureObject.smooth ? "smooth" : "nearest"}`;
-    if (!texturePool.has(key)) {
-        texturePool.set(key, []);
+export const execute = (texture_pool, texture_object) => {
+    const key = `${texture_object.width}x${texture_object.height}_${texture_object.smooth ? "smooth" : "nearest"}`;
+    if (!texture_pool.has(key)) {
+        texture_pool.set(key, []);
     }
-    texturePool.get(key).push(textureObject);
+    texture_pool.get(key).push(texture_object);
 };

package/src/AttachmentManager/usecase/AttachmentManagerGetAttachmentObjectUseCase.d.ts

@@ -6,20 +6,20 @@ import type { IStencilBufferObject } from "../../interface/IStencilBufferObject"
  * @description アタッチメントオブジェクトを取得
  *              Get attachment object
  *
- * @param  {GPUDevice} device
- * @param  {IAttachmentObject[]} attachmentPool
- * @param  {Map<string, ITextureObject[]>} texturePool
- * @param  {IColorBufferObject[]} colorBufferPool
- * @param  {IStencilBufferObject[]} stencilBufferPool
- * @param  {number} width
- * @param  {number} height
- * @param  {boolean} msaa
- * @param  {{ attachmentId: number, textureId: number, stencilId: number }} idCounter
+ * @param  {GPUDevice} device - GPUデバイス
+ * @param  {IAttachmentObject[]} attachment_pool - アタッチメントプール
+ * @param  {Map<string, ITextureObject[]>} texture_pool - テクスチャプール
+ * @param  {IColorBufferObject[]} color_buffer_pool - カラーバッファプール
+ * @param  {IStencilBufferObject[]} stencil_buffer_pool - ステンシルバッファプール
+ * @param  {number} width - バッファ幅
+ * @param  {number} height - バッファ高さ
+ * @param  {boolean} msaa - MSAA有効フラグ
+ * @param  {{ attachmentId: number, textureId: number, stencilId: number }} id_counter - ID管理カウンタ
  * @return {IAttachmentObject}
  * @method
  * @protected
  */
-export declare const execute: (device: GPUDevice, attachmentPool: IAttachmentObject[], texturePool: Map<string, ITextureObject[]>, colorBufferPool: IColorBufferObject[], stencilBufferPool: IStencilBufferObject[], width: number, height: number, msaa: boolean, idCounter: {
+export declare const execute: (device: GPUDevice, attachment_pool: IAttachmentObject[], texture_pool: Map<string, ITextureObject[]>, color_buffer_pool: IColorBufferObject[], stencil_buffer_pool: IStencilBufferObject[], width: number, height: number, msaa: boolean, id_counter: {
     attachmentId: number;
     textureId: number;
     stencilId: number;

package/src/AttachmentManager/usecase/AttachmentManagerGetAttachmentObjectUseCase.js

@@ -6,24 +6,24 @@ import { execute as attachmentManagerGetTextureService } from "../service/Attach
  * @description アタッチメントオブジェクトを取得
  *              Get attachment object
  *
- * @param  {GPUDevice} device
- * @param  {IAttachmentObject[]} attachmentPool
- * @param  {Map<string, ITextureObject[]>} texturePool
- * @param  {IColorBufferObject[]} colorBufferPool
- * @param  {IStencilBufferObject[]} stencilBufferPool
- * @param  {number} width
- * @param  {number} height
- * @param  {boolean} msaa
- * @param  {{ attachmentId: number, textureId: number, stencilId: number }} idCounter
+ * @param  {GPUDevice} device - GPUデバイス
+ * @param  {IAttachmentObject[]} attachment_pool - アタッチメントプール
+ * @param  {Map<string, ITextureObject[]>} texture_pool - テクスチャプール
+ * @param  {IColorBufferObject[]} color_buffer_pool - カラーバッファプール
+ * @param  {IStencilBufferObject[]} stencil_buffer_pool - ステンシルバッファプール
+ * @param  {number} width - バッファ幅
+ * @param  {number} height - バッファ高さ
+ * @param  {boolean} msaa - MSAA有効フラグ
+ * @param  {{ attachmentId: number, textureId: number, stencilId: number }} id_counter - ID管理カウンタ
  * @return {IAttachmentObject}
  * @method
  * @protected
  */
-export const execute = (device, attachmentPool, texturePool, colorBufferPool, stencilBufferPool, width, height, msaa, idCounter) => {
+export const execute = (device, attachment_pool, texture_pool, color_buffer_pool, stencil_buffer_pool, width, height, msaa, id_counter) => {
     // プールから再利用
-    const attachment = attachmentPool.length > 0
-        ? attachmentPool.pop()
-        : attachmentManagerCreateAttachmentObjectService(idCounter);
+    const attachment = attachment_pool.length > 0
+        ? attachment_pool.pop()
+        : attachmentManagerCreateAttachmentObjectService(id_counter);
     // サイズとフラグを更新
     attachment.width = width;
     attachment.height = height;
@@ -31,13 +31,13 @@ export const execute = (device, attachmentPool, texturePool, colorBufferPool, st
     attachment.mask = false;
     attachment.clipLevel = 0;
     // ステンシルバッファを取得または作成
-    const stencil = attachmentManagerGetStencilBufferService(device, stencilBufferPool, width, height, idCounter);
+    const stencil = attachmentManagerGetStencilBufferService(device, stencil_buffer_pool, width, height, id_counter);
     // カラーバッファを取得または作成（ステンシルを参照）
-    const color = attachmentManagerGetColorBufferService(device, colorBufferPool, width, height, stencil);
+    const color = attachmentManagerGetColorBufferService(device, color_buffer_pool, width, height, stencil);
     attachment.color = color;
     attachment.stencil = stencil;
     // テクスチャを取得
-    const texture = attachmentManagerGetTextureService(device, texturePool, width, height, true, idCounter);
+    const texture = attachmentManagerGetTextureService(device, texture_pool, width, height, true, id_counter);
     attachment.texture = texture;
     return attachment;
 };

package/src/AttachmentManager/usecase/AttachmentManagerReleaseAttachmentUseCase.d.ts

@@ -6,13 +6,13 @@ import type { IStencilBufferObject } from "../../interface/IStencilBufferObject"
  * @description アタッチメントを解放してプールに返却
  *              Release attachment and return to pool
  *
- * @param  {IAttachmentObject[]} attachmentPool
- * @param  {Map<string, ITextureObject[]>} texturePool
- * @param  {IColorBufferObject[]} colorBufferPool
- * @param  {IStencilBufferObject[]} stencilBufferPool
- * @param  {IAttachmentObject} attachment
+ * @param  {IAttachmentObject[]} attachment_pool - アタッチメントプール
+ * @param  {Map<string, ITextureObject[]>} texture_pool - テクスチャプール
+ * @param  {IColorBufferObject[]} color_buffer_pool - カラーバッファプール
+ * @param  {IStencilBufferObject[]} stencil_buffer_pool - ステンシルバッファプール
+ * @param  {IAttachmentObject} attachment - 解放するアタッチメント
  * @return {void}
  * @method
  * @protected
  */
-export declare const execute: (attachmentPool: IAttachmentObject[], texturePool: Map<string, ITextureObject[]>, colorBufferPool: IColorBufferObject[], stencilBufferPool: IStencilBufferObject[], attachment: IAttachmentObject) => void;
+export declare const execute: (attachment_pool: IAttachmentObject[], texture_pool: Map<string, ITextureObject[]>, color_buffer_pool: IColorBufferObject[], stencil_buffer_pool: IStencilBufferObject[], attachment: IAttachmentObject) => void;

package/src/AttachmentManager/usecase/AttachmentManagerReleaseAttachmentUseCase.js

@@ -3,31 +3,31 @@ import { execute as attachmentManagerReleaseTextureService } from "../service/At
  * @description アタッチメントを解放してプールに返却
  *              Release attachment and return to pool
  *
- * @param  {IAttachmentObject[]} attachmentPool
- * @param  {Map<string, ITextureObject[]>} texturePool
- * @param  {IColorBufferObject[]} colorBufferPool
- * @param  {IStencilBufferObject[]} stencilBufferPool
- * @param  {IAttachmentObject} attachment
+ * @param  {IAttachmentObject[]} attachment_pool - アタッチメントプール
+ * @param  {Map<string, ITextureObject[]>} texture_pool - テクスチャプール
+ * @param  {IColorBufferObject[]} color_buffer_pool - カラーバッファプール
+ * @param  {IStencilBufferObject[]} stencil_buffer_pool - ステンシルバッファプール
+ * @param  {IAttachmentObject} attachment - 解放するアタッチメント
  * @return {void}
  * @method
  * @protected
  */
-export const execute = (attachmentPool, texturePool, colorBufferPool, stencilBufferPool, attachment) => {
+export const execute = (attachment_pool, texture_pool, color_buffer_pool, stencil_buffer_pool, attachment) => {
     // テクスチャをプールに返却
     if (attachment.texture) {
-        attachmentManagerReleaseTextureService(texturePool, attachment.texture);
+        attachmentManagerReleaseTextureService(texture_pool, attachment.texture);
         attachment.texture = null;
     }
     // カラーバッファをプールに返却
     if (attachment.color) {
-        colorBufferPool.push(attachment.color);
+        color_buffer_pool.push(attachment.color);
         attachment.color = null;
     }
     // ステンシルバッファをプールに返却
     if (attachment.stencil) {
-        stencilBufferPool.push(attachment.stencil);
+        stencil_buffer_pool.push(attachment.stencil);
         attachment.stencil = null;
     }
     // アタッチメントをプールに返却
-    attachmentPool.push(attachment);
+    attachment_pool.push(attachment);
 };

package/src/AttachmentManager.d.ts

@@ -1,4 +1,8 @@
 import type { IAttachmentObject } from "./interface/IAttachmentObject";
+/**
+ * @description アタッチメントリソースのプール管理クラス
+ *              Pool manager class for attachment resources
+ */
 export declare class AttachmentManager {
     private device;
     private attachmentPool;
@@ -6,14 +10,32 @@ export declare class AttachmentManager {
     private colorBufferPool;
     private stencilBufferPool;
     private idCounter;
-    private currentAttachment;
+    /**
+     * @description AttachmentManagerのコンストラクタ
+     *              Constructor for AttachmentManager
+     * @param {GPUDevice} device - WebGPUデバイス / WebGPU device
+     */
     constructor(device: GPUDevice);
+    /**
+     * @description プールからアタッチメントオブジェクトを取得する
+     *              Get an attachment object from the pool
+     * @param  {number}  width  - テクスチャの幅 / Texture width
+     * @param  {number}  height - テクスチャの高さ / Texture height
+     * @param  {boolean} [msaa=false] - MSAAを有効にするか / Whether to enable MSAA
+     * @return {IAttachmentObject}
+     */
     getAttachmentObject(width: number, height: number, msaa?: boolean): IAttachmentObject;
-    bindAttachment(attachment: IAttachmentObject): void;
-    getCurrentAttachment(): IAttachmentObject | null;
-    get currentAttachmentObject(): IAttachmentObject | null;
-    unbindAttachment(): void;
+    /**
+     * @description アタッチメントをプールに返却する
+     *              Release an attachment back to the pool
+     * @param  {IAttachmentObject} attachment - 返却するアタッチメント / Attachment to release
+     * @return {void}
+     */
     releaseAttachment(attachment: IAttachmentObject): void;
-    createRenderPassDescriptor(attachment: IAttachmentObject, r: number, g: number, b: number, a: number, loadOp?: GPULoadOp): GPURenderPassDescriptor;
+    /**
+     * @description 全リソースを破棄する
+     *              Dispose all resources
+     * @return {void}
+     */
     dispose(): void;
 }

package/src/AttachmentManager.js

@@ -1,7 +1,15 @@
 import { execute as attachmentManagerGetAttachmentObjectUseCase } from "./AttachmentManager/usecase/AttachmentManagerGetAttachmentObjectUseCase";
 import { execute as attachmentManagerReleaseAttachmentUseCase } from "./AttachmentManager/usecase/AttachmentManagerReleaseAttachmentUseCase";
-import { execute as attachmentManagerCreateRenderPassDescriptorService } from "./AttachmentManager/service/AttachmentManagerCreateRenderPassDescriptorService";
+/**
+ * @description アタッチメントリソースのプール管理クラス
+ *              Pool manager class for attachment resources
+ */
 export class AttachmentManager {
+    /**
+     * @description AttachmentManagerのコンストラクタ
+     *              Constructor for AttachmentManager
+     * @param {GPUDevice} device - WebGPUデバイス / WebGPU device
+     */
     constructor(device) {
         Object.defineProperty(this, "device", {
             enumerable: true,
@@ -39,41 +47,38 @@ export class AttachmentManager {
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "currentAttachment", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
         this.device = device;
         this.attachmentPool = [];
         this.texturePool = new Map();
         this.colorBufferPool = [];
         this.stencilBufferPool = [];
         this.idCounter = { "attachmentId": 0, "textureId": 0, "stencilId": 0 };
-        this.currentAttachment = null;
     }
+    /**
+     * @description プールからアタッチメントオブジェクトを取得する
+     *              Get an attachment object from the pool
+     * @param  {number}  width  - テクスチャの幅 / Texture width
+     * @param  {number}  height - テクスチャの高さ / Texture height
+     * @param  {boolean} [msaa=false] - MSAAを有効にするか / Whether to enable MSAA
+     * @return {IAttachmentObject}
+     */
     getAttachmentObject(width, height, msaa = false) {
         return attachmentManagerGetAttachmentObjectUseCase(this.device, this.attachmentPool, this.texturePool, this.colorBufferPool, this.stencilBufferPool, width, height, msaa, this.idCounter);
     }
-    bindAttachment(attachment) {
-        this.currentAttachment = attachment;
-    }
-    getCurrentAttachment() {
-        return this.currentAttachment;
-    }
-    get currentAttachmentObject() {
-        return this.currentAttachment;
-    }
-    unbindAttachment() {
-        this.currentAttachment = null;
-    }
+    /**
+     * @description アタッチメントをプールに返却する
+     *              Release an attachment back to the pool
+     * @param  {IAttachmentObject} attachment - 返却するアタッチメント / Attachment to release
+     * @return {void}
+     */
     releaseAttachment(attachment) {
         attachmentManagerReleaseAttachmentUseCase(this.attachmentPool, this.texturePool, this.colorBufferPool, this.stencilBufferPool, attachment);
     }
-    createRenderPassDescriptor(attachment, r, g, b, a, loadOp = "clear") {
-        return attachmentManagerCreateRenderPassDescriptorService(attachment, r, g, b, a, loadOp);
-    }
+    /**
+     * @description 全リソースを破棄する
+     *              Dispose all resources
+     * @return {void}
+     */
     dispose() {
         for (const pool of this.texturePool.values()) {
             for (const textureObj of pool) {

package/src/BezierConverter/BezierConverter.d.ts

@@ -10,7 +10,13 @@
  *
  * これにより品質を維持しながら不要な計算を削減。
  */
-export { execute as adaptiveCubicToQuad, calculateAdaptiveThreshold } from "./usecase/BezierConverterAdaptiveCubicToQuadUseCase";
+/**
+ * @description 三次ベジェ曲線を適応的に二次ベジェ曲線群に変換する関数
+ *              Function to adaptively convert cubic bezier to quadratic bezier segments
+ */
+export { execute as adaptiveCubicToQuad } from "./usecase/BezierConverterAdaptiveCubicToQuadUseCase";
+/**
+ * @description 二次ベジェ曲線セグメントのインターフェース
+ *              Interface for quadratic bezier curve segment
+ */
 export type { IQuadraticSegment } from "../interface/IQuadraticSegment";
-export { execute as calculateFlatness } from "./service/BezierConverterCalculateFlatnessService";
-export { execute as splitCubic } from "./service/BezierConverterSplitCubicService";

package/src/BezierConverter/BezierConverter.js

@@ -10,6 +10,8 @@
  *
  * これにより品質を維持しながら不要な計算を削減。
  */
-export { execute as adaptiveCubicToQuad, calculateAdaptiveThreshold } from "./usecase/BezierConverterAdaptiveCubicToQuadUseCase";
-export { execute as calculateFlatness } from "./service/BezierConverterCalculateFlatnessService";
-export { execute as splitCubic } from "./service/BezierConverterSplitCubicService";
+/**
+ * @description 三次ベジェ曲線を適応的に二次ベジェ曲線群に変換する関数
+ *              Function to adaptively convert cubic bezier to quadratic bezier segments
+ */
+export { execute as adaptiveCubicToQuad } from "./usecase/BezierConverterAdaptiveCubicToQuadUseCase";

package/src/BezierConverter/usecase/BezierConverterAdaptiveCubicToQuadUseCase.d.ts

@@ -12,18 +12,7 @@ export type { IQuadraticSegment };
  * @param {IPoint} p1 - 制御点1
  * @param {IPoint} p2 - 制御点2
  * @param {IPoint} p3 - 終点
- * @param {number} flatnessThreshold - フラットネス閾値（オプション）
+ * @param {number} flatness_threshold - フラットネス閾値（オプション）
  * @return {IQuadraticSegment[]} 二次ベジェ曲線のセグメント配列
  */
-export declare const execute: (p0: IPoint, p1: IPoint, p2: IPoint, p3: IPoint, flatnessThreshold?: number) => IQuadraticSegment[];
-/**
- * @description スケールに応じたフラットネス閾値を計算
- *              Calculate flatness threshold based on scale
- *
- * ズームレベルが高い場合は高品質な近似が必要。
- * スケール = sqrt(matrix[0]^2 + matrix[1]^2) などで計算可能。
- *
- * @param {number} scale - 現在のスケール
- * @return {number} 調整されたフラットネス閾値
- */
-export declare const calculateAdaptiveThreshold: (scale: number) => number;
+export declare const execute: (p0: IPoint, p1: IPoint, p2: IPoint, p3: IPoint, flatness_threshold?: number) => IQuadraticSegment[];

package/src/BezierConverter/usecase/BezierConverterAdaptiveCubicToQuadUseCase.js

@@ -25,17 +25,26 @@ const MAX_RECURSION_DEPTH = 8;
  * @param {IPoint} p1 - 制御点1
  * @param {IPoint} p2 - 制御点2
  * @param {IPoint} p3 - 終点
- * @param {number} flatnessThreshold - フラットネス閾値（オプション）
+ * @param {number} flatness_threshold - フラットネス閾値（オプション）
  * @return {IQuadraticSegment[]} 二次ベジェ曲線のセグメント配列
  */
-export const execute = (p0, p1, p2, p3, flatnessThreshold = DEFAULT_FLATNESS_THRESHOLD) => {
+export const execute = (p0, p1, p2, p3, flatness_threshold = DEFAULT_FLATNESS_THRESHOLD) => {
     const result = [];
-    // 再帰的に分割を行う内部関数
+    /**
+     * @description 再帰的に三次ベジェ曲線を分割し、二次ベジェ曲線に近似する内部関数
+     *              Internal recursive function that subdivides cubic bezier and approximates with quadratic bezier
+     * @param {IPoint} start - 始点
+     * @param {IPoint} ctrl1 - 制御点1
+     * @param {IPoint} ctrl2 - 制御点2
+     * @param {IPoint} end - 終点
+     * @param {number} depth - 現在の再帰深度
+     * @return {void}
+     */
     const subdivide = (start, ctrl1, ctrl2, end, depth) => {
         // フラットネスを計算
         const flatness = calculateFlatness(start, ctrl1, ctrl2, end);
         // フラットネスが閾値以下、または最大深度に達した場合は近似
-        if (flatness <= flatnessThreshold || depth >= MAX_RECURSION_DEPTH) {
+        if (flatness <= flatness_threshold || depth >= MAX_RECURSION_DEPTH) {
             // 三次ベジェを二次ベジェに近似
             // WebGL版と同じ: 分割後は単純に2つの制御点の中点を使用
             const ctrl = {
@@ -57,24 +66,3 @@ export const execute = (p0, p1, p2, p3, flatnessThreshold = DEFAULT_FLATNESS_THR
     subdivide(p0, p1, p2, p3, 0);
     return result;
 };
-/**
- * @description スケールに応じたフラットネス閾値を計算
- *              Calculate flatness threshold based on scale
- *
- * ズームレベルが高い場合は高品質な近似が必要。
- * スケール = sqrt(matrix[0]^2 + matrix[1]^2) などで計算可能。
- *
- * @param {number} scale - 現在のスケール
- * @return {number} 調整されたフラットネス閾値
- */
-export const calculateAdaptiveThreshold = (scale) => {
-    // スケールが大きい場合は閾値を小さくして高品質に
-    // スケールが小さい場合は閾値を大きくしてパフォーマンス優先
-    const baseThreshold = DEFAULT_FLATNESS_THRESHOLD;
-    // スケールの逆数に比例した閾値
-    // 最小値と最大値を設定して極端な値を防ぐ
-    const adjustedThreshold = baseThreshold / (scale * scale);
-    // 閾値の範囲を制限（0.0625〜4.0）
-    // 0.0625 = 0.25px squared, 4.0 = 2px squared
-    return Math.max(0.0625, Math.min(4.0, adjustedThreshold));
-};

package/src/Blend/BlendInstancedManager.d.ts

@@ -3,33 +3,37 @@ import type { IComplexBlendItem } from "../interface/IComplexBlendItem";
 import { ShaderInstancedManager } from "../Shader/ShaderInstancedManager";
 /**
  * @description 複雑なブレンドモードの描画キューを取得
+ *              Returns the queue of complex blend mode draw items
  * @return {IComplexBlendItem[]}
  */
 export declare const getComplexBlendQueue: () => IComplexBlendItem[];
 /**
- * @description 複雑なブレンドモードの描画キューをクリア
+ * @description 複雑なブレンドモードの描画キューをクリアし、プールへ返却する
+ *              Clears the complex blend queue and returns arrays to their pools
  * @return {void}
  */
 export declare const clearComplexBlendQueue: () => void;
 /**
- * @description インスタンスシェーダーマネージャーを取得
+ * @description インスタンスシェーダーマネージャーを取得（なければ生成）
+ *              Gets or creates the instanced shader manager
  * @return {ShaderInstancedManager}
  */
 export declare const getInstancedShaderManager: () => ShaderInstancedManager;
 /**
- * @description DisplayObject単体の描画をインスタンス配列に追加
- * @param {Node} node
- * @param {number} x_min
- * @param {number} y_min
- * @param {number} x_max
- * @param {number} y_max
- * @param {Float32Array} color_transform
- * @param {Float32Array} matrix
- * @param {string} blend_mode
- * @param {number} viewport_width
- * @param {number} viewport_height
- * @param {number} render_max_size
- * @param {number} global_alpha
+ * @description DisplayObject単体の描画をインスタンス配列に追加する
+ *              Adds a single DisplayObject's draw data to the instanced array
+ * @param {Node} node - テクスチャアトラスノード / Texture atlas node
+ * @param {number} x_min - バウンディングボックス左端 / Bounding box left edge
+ * @param {number} y_min - バウンディングボックス上端 / Bounding box top edge
+ * @param {number} x_max - バウンディングボックス右端 / Bounding box right edge
+ * @param {number} y_max - バウンディングボックス下端 / Bounding box bottom edge
+ * @param {Float32Array} color_transform - カラートランスフォーム配列 / Color transform array
+ * @param {Float32Array} matrix - 変換行列配列 / Transformation matrix array
+ * @param {string} blend_mode - ブレンドモード名 / Blend mode name
+ * @param {number} viewport_width - ビューポート幅 / Viewport width
+ * @param {number} viewport_height - ビューポート高さ / Viewport height
+ * @param {number} render_max_size - レンダーテクスチャ最大サイズ / Render texture max size
+ * @param {number} global_alpha - グローバルアルファ値 / Global alpha value
  * @return {void}
  */
 export declare const addDisplayObjectToInstanceArray: (node: Node, x_min: number, y_min: number, x_max: number, y_max: number, color_transform: Float32Array, matrix: Float32Array, blend_mode: string, viewport_width: number, viewport_height: number, render_max_size: number, global_alpha: number) => void;

package/src/Blend/BlendInstancedManager.js

@@ -5,31 +5,41 @@ import { renderQueue } from "@next2d/render-queue";
 import { $context } from "../WebGPUUtil";
 /**
  * @description シンプルなブレンドモード（インスタンス描画可能）
+ *              Simple blend modes that support instanced rendering
+ * @type {ReadonlySet<string>}
  */
-const SIMPLE_BLEND_MODES = new Set([
+const $SIMPLE_BLEND_MODES = new Set([
     "normal", "layer", "add", "screen", "alpha", "erase", "copy"
 ]);
 /**
  * @description 複雑なブレンドモード描画キュー
+ *              Queue for complex blend mode draw items
+ * @type {IComplexBlendItem[]}
  */
 const $complexBlendQueue = [];
 /**
  * @description Float32Array(8) プール（color_transform 用）
+ *              Object pool for Float32Array(8) used by color transforms
+ * @type {Float32Array[]}
  */
 const $ct8Pool = [];
 /**
  * @description Float32Array(9) プール（matrix 用）
+ *              Object pool for Float32Array(9) used by matrices
+ * @type {Float32Array[]}
  */
 const $m9Pool = [];
 /**
  * @description 複雑なブレンドモードの描画キューを取得
+ *              Returns the queue of complex blend mode draw items
  * @return {IComplexBlendItem[]}
  */
 export const getComplexBlendQueue = () => {
     return $complexBlendQueue;
 };
 /**
- * @description 複雑なブレンドモードの描画キューをクリア
+ * @description 複雑なブレンドモードの描画キューをクリアし、プールへ返却する
+ *              Clears the complex blend queue and returns arrays to their pools
  * @return {void}
  */
 export const clearComplexBlendQueue = () => {
@@ -43,34 +53,37 @@ export const clearComplexBlendQueue = () => {
 };
 /**
  * @description インスタンスシェーダーマネージャーのキャッシュ
- * @private
+ *              Cache map for instanced shader managers
+ * @type {Map<string, ShaderInstancedManager>}
  */
-const shaderManagers = new Map();
+const $shaderManagers = new Map();
 /**
- * @description インスタンスシェーダーマネージャーを取得
+ * @description インスタンスシェーダーマネージャーを取得（なければ生成）
+ *              Gets or creates the instanced shader manager
  * @return {ShaderInstancedManager}
  */
 export const getInstancedShaderManager = () => {
     const key = "blend_instanced";
-    if (!shaderManagers.has(key)) {
-        shaderManagers.set(key, new ShaderInstancedManager());
+    if (!$shaderManagers.has(key)) {
+        $shaderManagers.set(key, new ShaderInstancedManager());
     }
-    return shaderManagers.get(key);
+    return $shaderManagers.get(key);
 };
 /**
- * @description DisplayObject単体の描画をインスタンス配列に追加
- * @param {Node} node
- * @param {number} x_min
- * @param {number} y_min
- * @param {number} x_max
- * @param {number} y_max
- * @param {Float32Array} color_transform
- * @param {Float32Array} matrix
- * @param {string} blend_mode
- * @param {number} viewport_width
- * @param {number} viewport_height
- * @param {number} render_max_size
- * @param {number} global_alpha
+ * @description DisplayObject単体の描画をインスタンス配列に追加する
+ *              Adds a single DisplayObject's draw data to the instanced array
+ * @param {Node} node - テクスチャアトラスノード / Texture atlas node
+ * @param {number} x_min - バウンディングボックス左端 / Bounding box left edge
+ * @param {number} y_min - バウンディングボックス上端 / Bounding box top edge
+ * @param {number} x_max - バウンディングボックス右端 / Bounding box right edge
+ * @param {number} y_max - バウンディングボックス下端 / Bounding box bottom edge
+ * @param {Float32Array} color_transform - カラートランスフォーム配列 / Color transform array
+ * @param {Float32Array} matrix - 変換行列配列 / Transformation matrix array
+ * @param {string} blend_mode - ブレンドモード名 / Blend mode name
+ * @param {number} viewport_width - ビューポート幅 / Viewport width
+ * @param {number} viewport_height - ビューポート高さ / Viewport height
+ * @param {number} render_max_size - レンダーテクスチャ最大サイズ / Render texture max size
+ * @param {number} global_alpha - グローバルアルファ値 / Global alpha value
  * @return {void}
  */
 export const addDisplayObjectToInstanceArray = (node, x_min, y_min, x_max, y_max, color_transform, matrix, blend_mode, viewport_width, viewport_height, render_max_size, global_alpha) => {
@@ -83,7 +96,7 @@ export const addDisplayObjectToInstanceArray = (node, x_min, y_min, x_max, y_max
     const ct5 = color_transform[5] / 255;
     const ct6 = color_transform[6] / 255;
     const ct7 = 0;
-    if (SIMPLE_BLEND_MODES.has(blend_mode)) {
+    if ($SIMPLE_BLEND_MODES.has(blend_mode)) {
         // ブレンドモードまたはアトラスインデックスが変わった場合
         if ($currentBlendMode !== blend_mode || $getCurrentAtlasIndex() !== node.index) {
             // 異なるブレンドモード/アトラスになるので、切り替え前にバッチを描画

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

@@ -1,6 +1,13 @@
 import type { IAttachmentObject } from "../../interface/IAttachmentObject";
 import type { IFilterConfig } from "../../interface/IFilterConfig";
 /**
- * @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 declare const execute: (srcAttachment: IAttachmentObject, dstAttachment: IAttachmentObject, blendMode: string, colorTransform: Float32Array, config: IFilterConfig) => IAttachmentObject;
+export declare const execute: (src_attachment: IAttachmentObject, dst_attachment: IAttachmentObject, blend_mode: string, color_transform: Float32Array, config: IFilterConfig) => IAttachmentObject;