@next2d/webgpu 3.0.4 → 3.1.0

package/src/Gradient/GradientLUTGenerator.js

@@ -3,28 +3,36 @@
  *              Gradient LUT texture generator
  */
 /**
- * @description ストップ数に応じた適応解像度を取得
- * @param {number} stopsLength
- * @return {number}
+ * @description ストップ数に応じた適応解像度を取得する
+ *              Get adaptive resolution based on the number of gradient stops
+ *
+ * @param  {number} stops_length - ストップ数 / Number of gradient stops
+ * @return {number} 解像度 (256, 512, or 1024) / Resolution
+ * @method
+ * @protected
  */
-export const getAdaptiveResolution = (stopsLength) => {
-    if (stopsLength <= 4) {
+export const getAdaptiveResolution = (stops_length) => {
+    if (stops_length <= 4) {
         return 256;
     }
-    if (stopsLength <= 8) {
+    if (stops_length <= 8) {
         return 512;
     }
     return 1024;
 };
 /**
- * @description グラデーションLUTテクスチャデータを生成
+ * @description グラデーションLUTテクスチャデータを生成する
+ *              Generate gradient LUT texture data.
  *              stops配列: [offset, R, G, B, A, offset, R, G, B, A, ...]
  *              注意: R, G, B, A は 0-255 範囲
  *              LUTは0-1の範囲の色を生成し、spread処理はシェーダー側で行う
- * @param {number[]} stops - グラデーションストップ配列
- * @param {number} _spread - スプレッドメソッド（未使用、シェーダー側で処理）
- * @param {number} interpolation - 補間方法 (0: linearRGB, 1: RGB) ※WebGL互換
- * @return {Uint8Array}
+ *
+ * @param  {number[]} stops - グラデーションストップ配列 / Gradient stop array
+ * @param  {number} _spread - スプレッドメソッド（未使用、シェーダー側で処理）/ Spread method (unused, handled by shader)
+ * @param  {number} interpolation - 補間方法 (0: linearRGB, 1: RGB) / Interpolation method (WebGL compatible)
+ * @return {Uint8Array} LUTテクスチャデータ / LUT texture data
+ * @method
+ * @protected
  */
 export const generateGradientLUT = (stops, _spread, interpolation) => {
     // ストップ数を計算（5要素ずつ: offset, R, G, B, A）
@@ -37,7 +45,7 @@ export const generateGradientLUT = (stops, _spread, interpolation) => {
     for (let i = 0; i < resolution; i++) {
         const t = i / (resolution - 1);
         // 色を補間（色は0-255範囲で返される）
-        const color = interpolateColor(stops, t, interpolation);
+        const color = $interpolateColor(stops, t, interpolation);
         // WebGL版と同じ: プリマルチプライドアルファは適用しない
         // LUTにはストレート（非プリマルチプライド）の色を格納
         // プリマルチプライドはシェーダー側でサンプリング後に行う
@@ -52,14 +60,18 @@ export const generateGradientLUT = (stops, _spread, interpolation) => {
     return lutData;
 };
 /**
- * @description 色を補間
+ * @description 色を補間する
+ *              Interpolate color between gradient stops.
  *              色は0-255範囲で入力され、0-255範囲で出力される
- * @param {number[]} stops
- * @param {number} t
- * @param {number} interpolation - 0: linearRGB, 1: RGB（WebGL互換）
- * @return {{ r: number, g: number, b: number, a: number }}
+ *              Colors are input in 0-255 range and output in 0-255 range.
+ *
+ * @param  {number[]} stops - グラデーションストップ配列 / Gradient stop array
+ * @param  {number} t - 補間位置 (0-1) / Interpolation position (0-1)
+ * @param  {number} interpolation - 補間方法 (0: linearRGB, 1: RGB) / Interpolation method (WebGL compatible)
+ * @return {{ r: number, g: number, b: number, a: number }} 補間された色 / Interpolated color
+ * @private
  */
-const interpolateColor = (stops, t, interpolation) => {
+const $interpolateColor = (stops, t, interpolation) => {
     const stopsLength = stops.length / 5;
     // 最初と最後のストップを見つける
     let startIdx = 0;
@@ -107,49 +119,68 @@ const interpolateColor = (stops, t, interpolation) => {
         // linearRGB補間（ガンマ補正）
         // 0-255 → 0-1に正規化してからリニア変換
         return {
-            "r": linearToSRGB(lerp(sRGBToLinear(startR / 255), sRGBToLinear(endR / 255), localT)) * 255,
-            "g": linearToSRGB(lerp(sRGBToLinear(startG / 255), sRGBToLinear(endG / 255), localT)) * 255,
-            "b": linearToSRGB(lerp(sRGBToLinear(startB / 255), sRGBToLinear(endB / 255), localT)) * 255,
-            "a": lerp(startA, endA, localT)
+            "r": $linearToSRGB($lerp($sRGBToLinear(startR / 255), $sRGBToLinear(endR / 255), localT)) * 255,
+            "g": $linearToSRGB($lerp($sRGBToLinear(startG / 255), $sRGBToLinear(endG / 255), localT)) * 255,
+            "b": $linearToSRGB($lerp($sRGBToLinear(startB / 255), $sRGBToLinear(endB / 255), localT)) * 255,
+            "a": $lerp(startA, endA, localT)
         };
     }
     // RGB補間（リニア、デフォルト）- 0-255範囲でそのまま補間
     return {
-        "r": lerp(startR, endR, localT),
-        "g": lerp(startG, endG, localT),
-        "b": lerp(startB, endB, localT),
-        "a": lerp(startA, endA, localT)
+        "r": $lerp(startR, endR, localT),
+        "g": $lerp(startG, endG, localT),
+        "b": $lerp(startB, endB, localT),
+        "a": $lerp(startA, endA, localT)
     };
 };
 /**
- * @description 線形補間
+ * @description 線形補間を行う
+ *              Perform linear interpolation between two values
+ *
+ * @param  {number} a - 開始値 / Start value
+ * @param  {number} b - 終了値 / End value
+ * @param  {number} t - 補間係数 (0-1) / Interpolation factor (0-1)
+ * @return {number} 補間結果 / Interpolated result
+ * @private
  */
-const lerp = (a, b, t) => {
+const $lerp = (a, b, t) => {
     return a + (b - a) * t;
 };
 /**
- * @description sRGBからリニアへ変換（入力: 0-1正規化値）
+ * @description sRGBからリニア色空間へ変換する（入力: 0-1正規化値）
+ *              Convert from sRGB to linear color space (input: 0-1 normalized value).
  *              WebGL版と同じガンマ値 2.23333333 を使用
+ *
+ * @param  {number} value - sRGB色空間の正規化値 (0-1) / Normalized value in sRGB color space
+ * @return {number} リニア色空間の値 / Value in linear color space
+ * @private
  */
-const sRGBToLinear = (value) => {
-    // WebGL版と同じ簡易ガンマ補正
+const $sRGBToLinear = (value) => {
     return Math.pow(value, 2.23333333);
 };
 /**
- * @description リニアからsRGBへ変換（出力: 0-1正規化値）
+ * @description リニア色空間からsRGBへ変換する（出力: 0-1正規化値）
+ *              Convert from linear color space to sRGB (output: 0-1 normalized value).
  *              WebGL版と同じガンマ値 0.45454545 (= 1/2.2) を使用
+ *
+ * @param  {number} value - リニア色空間の値 / Value in linear color space
+ * @return {number} sRGB色空間の正規化値 / Normalized value in sRGB color space
+ * @private
  */
-const linearToSRGB = (value) => {
-    // WebGL版と同じ簡易ガンマ補正
+const $linearToSRGB = (value) => {
     return Math.pow(value, 0.45454545);
 };
 /**
- * @description フィルター用グラデーションLUTテクスチャデータを生成
+ * @description フィルター用グラデーションLUTテクスチャデータを生成する
+ *              Generate gradient LUT texture data for filters.
  *              ratios, colors, alphas配列から1D LUTを生成
- * @param {Float32Array} ratios - 比率配列 (0-255)
- * @param {Float32Array} colors - 色配列 (32bit整数)
- * @param {Float32Array} alphas - アルファ配列 (0-1)
- * @return {Uint8Array}
+ *
+ * @param  {Float32Array} ratios - 比率配列 (0-255) / Ratio array (0-255)
+ * @param  {Float32Array} colors - 色配列 (32bit整数) / Color array (32-bit integers)
+ * @param  {Float32Array} alphas - アルファ配列 (0-1) / Alpha array (0-1)
+ * @return {Uint8Array} LUTテクスチャデータ / LUT texture data
+ * @method
+ * @protected
  */
 export const generateFilterGradientLUT = (ratios, colors, alphas) => {
     const resolution = 256;
@@ -187,10 +218,10 @@ export const generateFilterGradientLUT = (ratios, colors, alphas) => {
         if (end.offset !== start.offset) {
             localT = (t - start.offset) / (end.offset - start.offset);
         }
-        const r = lerp(start.r, end.r, localT);
-        const g = lerp(start.g, end.g, localT);
-        const b = lerp(start.b, end.b, localT);
-        const a = lerp(start.a, end.a, localT);
+        const r = $lerp(start.r, end.r, localT);
+        const g = $lerp(start.g, end.g, localT);
+        const b = $lerp(start.b, end.b, localT);
+        const a = $lerp(start.a, end.a, localT);
         // プリマルチプライドアルファで書き込み
         const offset = i * 4;
         lutData[offset + 0] = Math.round(r * a * 255);

package/src/Mask/service/MaskUnionMaskService.d.ts

@@ -1,4 +1,19 @@
 import type { BufferManager } from "../../BufferManager";
 import type { PipelineManager } from "../../Shader/PipelineManager";
 import type { IAttachmentObject } from "../../interface/IAttachmentObject";
-export declare const execute: (device: GPUDevice, renderPassEncoder: GPURenderPassEncoder, bufferManager: BufferManager, pipelineManager: PipelineManager, currentAttachment: IAttachmentObject) => void;
+/**
+ * @description マスクの合成処理（ネストされたマスク対応）
+ *              Union mask processing for nested masks.
+ *              WebGL版と同様に、レベル7を超えたステンシルビットをマージする
+ *              Merges stencil bits exceeding level 7, same as WebGL version.
+ *
+ * @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  {IAttachmentObject} current_attachment - 現在のアタッチメントオブジェクト / Current attachment object
+ * @return {void}
+ * @method
+ * @protected
+ */
+export declare const execute: (device: GPUDevice, render_pass_encoder: GPURenderPassEncoder, buffer_manager: BufferManager, pipeline_manager: PipelineManager, current_attachment: IAttachmentObject) => void;

package/src/Mask/service/MaskUnionMaskService.js

@@ -1,17 +1,10 @@
 /**
- * @description マスクの合成処理（ネストされたマスク対応）
- *              WebGL版と同様に、レベル7を超えたステンシルビットをマージする
+ * @description フルスクリーン矩形の頂点データ（4 floats/vertex: position + bezier）
+ *              Full-screen rectangle vertex data (4 floats/vertex: position + bezier)
  *
- * @param {GPUDevice} device
- * @param {GPURenderPassEncoder} renderPassEncoder
- * @param {BufferManager} bufferManager
- * @param {PipelineManager} pipelineManager
- * @param {IAttachmentObject} currentAttachment
- * @return {void}
- * @method
- * @protected
+ * @type {Float32Array}
+ * @constant
  */
-// フルスクリーン矩形（4 floats/vertex: position + bezier）
 const $rectVertices = new Float32Array([
     // Triangle 1
     -1, -1, 0.5, 0.5,
@@ -22,24 +15,45 @@ const $rectVertices = new Float32Array([
     1, -1, 0.5, 0.5,
     1, 1, 0.5, 0.5
 ]);
-// FillUniforms: identity matrix + white color (NDC座標なので変換不要)
+/**
+ * @description FillUniformsデータ: 恒等行列と白色（NDC座標なので変換不要）
+ *              FillUniforms data: identity matrix + white color (no transform needed for NDC coordinates)
+ *
+ * @type {Float32Array}
+ * @constant
+ */
 const $uniformData16 = new Float32Array([
     1, 1, 1, 1, // color: white
     0.5, 0, 0, 0, // matrix0: (0.5, 0, 0, pad) → identity-like for NDC passthrough
     0, 0.5, 0, 0, // matrix1: (0, 0.5, 0, pad)
     0.5, 0.5, 1, 0 // matrix2: (0.5, 0.5, 1, pad)
 ]);
-export const execute = (device, renderPassEncoder, bufferManager, pipelineManager, currentAttachment) => {
-    if (!currentAttachment) {
+/**
+ * @description マスクの合成処理（ネストされたマスク対応）
+ *              Union mask processing for nested masks.
+ *              WebGL版と同様に、レベル7を超えたステンシルビットをマージする
+ *              Merges stencil bits exceeding level 7, same as WebGL version.
+ *
+ * @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  {IAttachmentObject} current_attachment - 現在のアタッチメントオブジェクト / Current attachment object
+ * @return {void}
+ * @method
+ * @protected
+ */
+export const execute = (device, render_pass_encoder, buffer_manager, pipeline_manager, current_attachment) => {
+    if (!current_attachment) {
         return;
     }
-    const clipLevel = currentAttachment.clipLevel;
+    const clipLevel = current_attachment.clipLevel;
     const mask = 1 << clipLevel - 1;
-    const vertexBuffer = bufferManager.acquireVertexBuffer($rectVertices.byteLength, $rectVertices);
+    const vertexBuffer = buffer_manager.acquireVertexBuffer($rectVertices.byteLength, $rectVertices);
     // Dynamic Uniform Bufferにデータを書き込み
-    const uniformOffset = bufferManager.dynamicUniform.allocate($uniformData16);
+    const uniformOffset = buffer_manager.dynamicUniform.allocate($uniformData16);
     // Dynamic BindGroupを取得
-    const layout = pipelineManager.getBindGroupLayout("fill_dynamic");
+    const layout = pipeline_manager.getBindGroupLayout("fill_dynamic");
     if (!layout) {
         return;
     }
@@ -48,27 +62,27 @@ export const execute = (device, renderPassEncoder, bufferManager, pipelineManage
         "entries": [{
                 "binding": 0,
                 "resource": {
-                    "buffer": bufferManager.dynamicUniform.getBuffer(),
+                    "buffer": buffer_manager.dynamicUniform.getBuffer(),
                     "size": 256
                 }
             }]
     });
     // === Pass 1: ステンシルビットのマージ ===
-    const mergePipeline = pipelineManager.getPipeline(`mask_union_merge_${clipLevel}`);
+    const mergePipeline = pipeline_manager.getPipeline(`mask_union_merge_${clipLevel}`);
     if (mergePipeline) {
-        renderPassEncoder.setPipeline(mergePipeline);
-        renderPassEncoder.setStencilReference(mask);
-        renderPassEncoder.setVertexBuffer(0, vertexBuffer);
-        renderPassEncoder.setBindGroup(0, bindGroup, [uniformOffset]);
-        renderPassEncoder.draw(6, 1, 0, 0);
+        render_pass_encoder.setPipeline(mergePipeline);
+        render_pass_encoder.setStencilReference(mask);
+        render_pass_encoder.setVertexBuffer(0, vertexBuffer);
+        render_pass_encoder.setBindGroup(0, bindGroup, [uniformOffset]);
+        render_pass_encoder.draw(6, 1, 0, 0);
     }
     // === Pass 2: 上位ビットのクリア ===
-    const clearPipeline = pipelineManager.getPipeline(`mask_union_clear_${clipLevel}`);
+    const clearPipeline = pipeline_manager.getPipeline(`mask_union_clear_${clipLevel}`);
     if (clearPipeline) {
-        renderPassEncoder.setPipeline(clearPipeline);
-        renderPassEncoder.setStencilReference(0);
-        renderPassEncoder.setVertexBuffer(0, vertexBuffer);
-        renderPassEncoder.setBindGroup(0, bindGroup, [uniformOffset]);
-        renderPassEncoder.draw(6, 1, 0, 0);
+        render_pass_encoder.setPipeline(clearPipeline);
+        render_pass_encoder.setStencilReference(0);
+        render_pass_encoder.setVertexBuffer(0, vertexBuffer);
+        render_pass_encoder.setBindGroup(0, bindGroup, [uniformOffset]);
+        render_pass_encoder.draw(6, 1, 0, 0);
     }
 };

package/src/Mask.d.ts

@@ -1,12 +1,66 @@
+/**
+ * @description マスク描画状態を設定する
+ *              Set the mask drawing state
+ *
+ * @param {boolean} state - マスク描画中かどうか / whether mask drawing is active
+ * @return {void}
+ */
 export declare const $setMaskDrawing: (state: boolean) => void;
+/**
+ * @description マスク描画中かどうかを返す
+ *              Returns whether mask drawing is currently active
+ *
+ * @return {boolean}
+ */
 export declare const $isMaskDrawing: () => boolean;
+/**
+ * @description マスクテストの有効/無効を設定する
+ *              Enable or disable mask (stencil) testing
+ *
+ * @param {boolean} enabled - 有効にするかどうか / whether to enable
+ * @return {void}
+ */
 export declare const $setMaskTestEnabled: (enabled: boolean) => void;
+/**
+ * @description マスクテストが有効かどうかを返す
+ *              Returns whether mask (stencil) testing is enabled
+ *
+ * @return {boolean}
+ */
 export declare const $isMaskTestEnabled: () => boolean;
+/**
+ * @description マスクステンシル参照値を設定する
+ *              Set the mask stencil reference value
+ *
+ * @param {number} value - ステンシル参照値 / stencil reference value
+ * @return {void}
+ */
 export declare const $setMaskStencilReference: (value: number) => void;
+/**
+ * @description マスクステンシル参照値を取得する
+ *              Get the current mask stencil reference value
+ *
+ * @return {number}
+ */
 export declare const $getMaskStencilReference: () => number;
-export declare const $pushMaskAttachment: (attachment: any) => void;
-export declare const $popMaskAttachment: () => any;
-export declare const $hasMaskAttachment: () => boolean;
+/**
+ * @description クリップ境界のマップ（キー: ID、値: バウンディングボックス）
+ *              Map of clip bounds (key: ID, value: bounding box as Float32Array)
+ *
+ * @type {Map<number, Float32Array>}
+ */
 export declare const $clipBounds: Map<number, Float32Array>;
+/**
+ * @description クリップレベルのマップ（キー: ID、値: クリップ深度）
+ *              Map of clip levels (key: ID, value: clip depth)
+ *
+ * @type {Map<number, number>}
+ */
 export declare const $clipLevels: Map<number, number>;
+/**
+ * @description マスク関連の全状態をリセットする
+ *              Reset all mask-related state to initial values
+ *
+ * @return {void}
+ */
 export declare const $resetMaskState: () => void;

package/src/Mask.js

@@ -1,41 +1,105 @@
+/**
+ * @description マスク描画中かどうかの状態フラグ
+ *              Flag indicating whether mask drawing is in progress
+ *
+ * @type {boolean}
+ */
 let $maskDrawingState = false;
+/**
+ * @description マスク描画状態を設定する
+ *              Set the mask drawing state
+ *
+ * @param {boolean} state - マスク描画中かどうか / whether mask drawing is active
+ * @return {void}
+ */
 export const $setMaskDrawing = (state) => {
     $maskDrawingState = state;
 };
+/**
+ * @description マスク描画中かどうかを返す
+ *              Returns whether mask drawing is currently active
+ *
+ * @return {boolean}
+ */
 export const $isMaskDrawing = () => {
     return $maskDrawingState;
 };
+/**
+ * @description マスクテストが有効かどうかのフラグ
+ *              Flag indicating whether mask (stencil) testing is enabled
+ *
+ * @type {boolean}
+ */
 let $maskTestEnabled = false;
+/**
+ * @description マスクステンシル参照値
+ *              Mask stencil reference value used for stencil comparison
+ *
+ * @type {number}
+ */
 let $maskStencilReference = 0;
+/**
+ * @description マスクテストの有効/無効を設定する
+ *              Enable or disable mask (stencil) testing
+ *
+ * @param {boolean} enabled - 有効にするかどうか / whether to enable
+ * @return {void}
+ */
 export const $setMaskTestEnabled = (enabled) => {
     $maskTestEnabled = enabled;
 };
+/**
+ * @description マスクテストが有効かどうかを返す
+ *              Returns whether mask (stencil) testing is enabled
+ *
+ * @return {boolean}
+ */
 export const $isMaskTestEnabled = () => {
     return $maskTestEnabled;
 };
+/**
+ * @description マスクステンシル参照値を設定する
+ *              Set the mask stencil reference value
+ *
+ * @param {number} value - ステンシル参照値 / stencil reference value
+ * @return {void}
+ */
 export const $setMaskStencilReference = (value) => {
     $maskStencilReference = value;
 };
+/**
+ * @description マスクステンシル参照値を取得する
+ *              Get the current mask stencil reference value
+ *
+ * @return {number}
+ */
 export const $getMaskStencilReference = () => {
     return $maskStencilReference;
 };
-const $maskAttachmentStack = [];
-export const $pushMaskAttachment = (attachment) => {
-    $maskAttachmentStack.push(attachment);
-};
-export const $popMaskAttachment = () => {
-    return $maskAttachmentStack.pop();
-};
-export const $hasMaskAttachment = () => {
-    return $maskAttachmentStack.length > 0;
-};
+/**
+ * @description クリップ境界のマップ（キー: ID、値: バウンディングボックス）
+ *              Map of clip bounds (key: ID, value: bounding box as Float32Array)
+ *
+ * @type {Map<number, Float32Array>}
+ */
 export const $clipBounds = new Map();
+/**
+ * @description クリップレベルのマップ（キー: ID、値: クリップ深度）
+ *              Map of clip levels (key: ID, value: clip depth)
+ *
+ * @type {Map<number, number>}
+ */
 export const $clipLevels = new Map();
+/**
+ * @description マスク関連の全状態をリセットする
+ *              Reset all mask-related state to initial values
+ *
+ * @return {void}
+ */
 export const $resetMaskState = () => {
     $maskDrawingState = false;
     $maskTestEnabled = false;
     $maskStencilReference = 0;
-    $maskAttachmentStack.length = 0;
     $clipBounds.clear();
     $clipLevels.clear();
 };

package/src/Mesh/service/MeshFillGenerateService.d.ts

@@ -9,10 +9,10 @@ import type { IPath } from "../../interface/IPath";
  *
  * color/matrixはuniform bufferで供給される
  *
- * @param  {IPath} vertex
- * @param  {Float32Array} buffer
- * @param  {number} index - 現在の頂点インデックス
- * @return {number} 新しい頂点インデックス
+ * @param  {IPath} vertex - 頂点パスデータ / Vertex path data
+ * @param  {Float32Array} buffer - 出力先バッファ / Output buffer
+ * @param  {number} index - 現在の頂点インデックス / Current vertex index
+ * @return {number} 新しい頂点インデックス / New vertex index
  * @method
  * @protected
  */

package/src/Mesh/service/MeshFillGenerateService.js

@@ -8,10 +8,10 @@
  *
  * color/matrixはuniform bufferで供給される
  *
- * @param  {IPath} vertex
- * @param  {Float32Array} buffer
- * @param  {number} index - 現在の頂点インデックス
- * @return {number} 新しい頂点インデックス
+ * @param  {IPath} vertex - 頂点パスデータ / Vertex path data
+ * @param  {Float32Array} buffer - 出力先バッファ / Output buffer
+ * @param  {number} index - 現在の頂点インデックス / Current vertex index
+ * @return {number} 新しい頂点インデックス / New vertex index
  * @method
  * @protected
  */

package/src/Mesh/service/MeshStrokeFillGenerateService.d.ts

@@ -9,10 +9,10 @@ import type { IPath } from "../../interface/IPath";
  *
  * color/matrixはuniform bufferで供給される
  *
- * @param  {IPath} vertex
- * @param  {Float32Array} buffer
- * @param  {number} index - 現在の頂点インデックス
- * @return {number} 新しい頂点インデックス
+ * @param  {IPath} vertex - 頂点パスデータ / Vertex path data
+ * @param  {Float32Array} buffer - 出力先バッファ / Output buffer
+ * @param  {number} index - 現在の頂点インデックス / Current vertex index
+ * @return {number} 新しい頂点インデックス / New vertex index
  * @method
  * @protected
  */

package/src/Mesh/service/MeshStrokeFillGenerateService.js

@@ -8,10 +8,10 @@
  *
  * color/matrixはuniform bufferで供給される
  *
- * @param  {IPath} vertex
- * @param  {Float32Array} buffer
- * @param  {number} index - 現在の頂点インデックス
- * @return {number} 新しい頂点インデックス
+ * @param  {IPath} vertex - 頂点パスデータ / Vertex path data
+ * @param  {Float32Array} buffer - 出力先バッファ / Output buffer
+ * @param  {number} index - 現在の頂点インデックス / Current vertex index
+ * @return {number} 新しい頂点インデックス / New vertex index
  * @method
  * @protected
  */

package/src/Mesh/usecase/MeshBitmapStrokeGenerateUseCase.d.ts

@@ -4,9 +4,9 @@ import type { IMeshResult } from "../../interface/IMeshResult";
  * @description ビットマップストローク用のメッシュを生成する
  *              Generate a mesh for bitmap stroke
  *
- * @param  {IPath[]} vertices
- * @param  {number} thickness
- * @return {IMeshResult}
+ * @param  {IPath[]} vertices - パス頂点配列 / Array of path vertices
+ * @param  {number} thickness - 線の太さ / Line thickness
+ * @return {IMeshResult} メッシュ結果 / Mesh result
  * @method
  * @protected
  */

package/src/Mesh/usecase/MeshBitmapStrokeGenerateUseCase.js

@@ -4,6 +4,13 @@ import { execute as meshStrokeFillGenerateService } from "../service/MeshStrokeF
  * @description メッシュ生成用の再利用可能な一時バッファ（GC回避）
  */
 let $meshTempBuffer = new Float32Array(32);
+/**
+ * @description 2のべき乗に切り上げる
+ *              Round up to the next power of two
+ *
+ * @param  {number} v - 切り上げ対象の値 / Value to round up
+ * @return {number} 2のべき乗の値 / Next power of two
+ */
 const $upperPowerOfTwo = (v) => {
     v--;
     v |= v >> 1;
@@ -18,9 +25,9 @@ const $upperPowerOfTwo = (v) => {
  * @description ビットマップストローク用のメッシュを生成する
  *              Generate a mesh for bitmap stroke
  *
- * @param  {IPath[]} vertices
- * @param  {number} thickness
- * @return {IMeshResult}
+ * @param  {IPath[]} vertices - パス頂点配列 / Array of path vertices
+ * @param  {number} thickness - 線の太さ / Line thickness
+ * @return {IMeshResult} メッシュ結果 / Mesh result
  * @method
  * @protected
  */

package/src/Mesh/usecase/MeshFillGenerateUseCase.d.ts

@@ -4,8 +4,8 @@ import type { IMeshResult } from "../../interface/IMeshResult";
  * @description 塗りのメッシュを生成する
  *              Generate a fill mesh
  *
- * @param  {IPath[]} vertices
- * @return {IMeshResult}
+ * @param  {IPath[]} vertices - パス頂点配列 / Array of path vertices
+ * @return {IMeshResult} メッシュ結果 / Mesh result
  * @method
  * @protected
  */

package/src/Mesh/usecase/MeshFillGenerateUseCase.js

@@ -3,6 +3,13 @@ import { execute as meshFillGenerateService } from "../service/MeshFillGenerateS
  * @description メッシュ生成用の再利用可能な一時バッファ（GC回避）
  */
 let $meshTempBuffer = new Float32Array(32);
+/**
+ * @description 2のべき乗に切り上げる
+ *              Round up to the next power of two
+ *
+ * @param  {number} v - 切り上げ対象の値 / Value to round up
+ * @return {number} 2のべき乗の値 / Next power of two
+ */
 const $upperPowerOfTwo = (v) => {
     v--;
     v |= v >> 1;
@@ -17,8 +24,8 @@ const $upperPowerOfTwo = (v) => {
  * @description 塗りのメッシュを生成する
  *              Generate a fill mesh
  *
- * @param  {IPath[]} vertices
- * @return {IMeshResult}
+ * @param  {IPath[]} vertices - パス頂点配列 / Array of path vertices
+ * @return {IMeshResult} メッシュ結果 / Mesh result
  * @method
  * @protected
  */