@next2d/webgpu 3.0.4 → 3.1.0

package/src/Shader/wgsl/fragment/StencilFragment.js

@@ -1,3 +1,10 @@
+/**
+ * @description ステンシル書き込み用フラグメントシェーダー（ベジェ曲線アンチエイリアス）
+ *              Stencil write fragment shader with bezier curve anti-aliasing
+ *
+ * @type {string}
+ * @constant
+ */
 export const StencilWriteFragment = /* wgsl */ `
 struct FragmentInput {
     @builtin(position) position: vec4<f32>,
@@ -19,6 +26,13 @@ fn main(input: FragmentInput) -> @location(0) vec4<f32> {
     return vec4<f32>(0.0, 0.0, 0.0, min(alpha, 1.0));
 }
 `;
+/**
+ * @description ステンシル塗り用フラグメントシェーダー（プリマルチプライドアルファ出力）
+ *              Stencil fill fragment shader with premultiplied alpha output
+ *
+ * @type {string}
+ * @constant
+ */
 export const StencilFillFragment = /* wgsl */ `
 struct FragmentInput {
     @builtin(position) position: vec4<f32>,

package/src/Shader/wgsl/vertex/BasicVertex.d.ts

@@ -1 +1,8 @@
+/**
+ * @description 基本頂点シェーダー（行列変換・プリマルチプライドカラー出力）
+ *              Basic vertex shader with matrix transform and premultiplied color output
+ *
+ * @type {string}
+ * @constant
+ */
 export declare const BasicVertex = "\noverride yFlipSign: f32 = 1.0;\n\nstruct VertexInput {\n    @location(0) position: vec2<f32>,\n    @location(1) texCoord: vec2<f32>,\n}\n\nstruct VertexOutput {\n    @builtin(position) position: vec4<f32>,\n    @location(0) texCoord: vec2<f32>,\n    @location(1) color: vec4<f32>,\n}\n\nstruct Uniforms {\n    matrix: mat3x3<f32>,\n    color: vec4<f32>,\n    alpha: f32,\n}\n\n@group(0) @binding(0) var<uniform> uniforms: Uniforms;\n\n@vertex\nfn main(input: VertexInput) -> VertexOutput {\n    var output: VertexOutput;\n    let pos = uniforms.matrix * vec3<f32>(input.position, 1.0);\n    let ndc = pos.xy * 2.0 - 1.0;\n    output.position = vec4<f32>(ndc.x, ndc.y * yFlipSign, 0.0, 1.0);\n    output.texCoord = input.texCoord;\n    let premultipliedColor = vec4<f32>(\n        uniforms.color.rgb * uniforms.color.a * uniforms.alpha,\n        uniforms.color.a * uniforms.alpha\n    );\n    output.color = premultipliedColor;\n    return output;\n}\n";

package/src/Shader/wgsl/vertex/BasicVertex.js

@@ -1,3 +1,10 @@
+/**
+ * @description 基本頂点シェーダー（行列変換・プリマルチプライドカラー出力）
+ *              Basic vertex shader with matrix transform and premultiplied color output
+ *
+ * @type {string}
+ * @constant
+ */
 export const BasicVertex = /* wgsl */ `
 override yFlipSign: f32 = 1.0;
 

package/src/Shader/wgsl/vertex/BitmapVertex.d.ts

@@ -1 +1,8 @@
+/**
+ * @description ビットマップ塗り用頂点シェーダー（ワールド座標出力付き）
+ *              Bitmap fill vertex shader with world position output
+ *
+ * @type {string}
+ * @constant
+ */
 export declare const BitmapFillVertex = "\noverride yFlipSign: f32 = 1.0;\n\nstruct VertexInput {\n    @location(0) position: vec2<f32>,\n    @location(1) bezier: vec2<f32>,\n}\n\nstruct VertexOutput {\n    @builtin(position) position: vec4<f32>,\n    @location(0) bezier: vec2<f32>,\n    @location(1) color: vec4<f32>,\n    @location(2) worldPos: vec2<f32>,\n}\n\nstruct BitmapUniforms {\n    bitmapMatrix: mat3x3<f32>,\n    width: f32,\n    height: f32,\n    repeat: f32,\n    _pad: f32,\n    color: vec4<f32>,\n    contextMatrix0: vec4<f32>,\n    contextMatrix1: vec4<f32>,\n    contextMatrix2: vec4<f32>,\n}\n\n@group(0) @binding(0) var<uniform> bitmap: BitmapUniforms;\n\n@vertex\nfn main(input: VertexInput) -> VertexOutput {\n    var output: VertexOutput;\n    let matrix = mat3x3<f32>(bitmap.contextMatrix0.xyz, bitmap.contextMatrix1.xyz, bitmap.contextMatrix2.xyz);\n    let transformedPos = matrix * vec3<f32>(input.position, 1.0);\n    let clipX = transformedPos.x * 2.0 - 1.0;\n    let clipY = (transformedPos.y * 2.0 - 1.0) * yFlipSign;\n    output.position = vec4<f32>(clipX, clipY, 0.0, 1.0);\n    output.bezier = input.bezier;\n    output.color = bitmap.color;\n    output.worldPos = input.position;\n    return output;\n}\n";

package/src/Shader/wgsl/vertex/BitmapVertex.js

@@ -1,3 +1,10 @@
+/**
+ * @description ビットマップ塗り用頂点シェーダー（ワールド座標出力付き）
+ *              Bitmap fill vertex shader with world position output
+ *
+ * @type {string}
+ * @constant
+ */
 export const BitmapFillVertex = /* wgsl */ `
 override yFlipSign: f32 = 1.0;
 

package/src/Shader/wgsl/vertex/FillVertex.d.ts

@@ -1 +1,8 @@
+/**
+ * @description 塗り用頂点シェーダー（ベジェ曲線パラメータ付き行列変換）
+ *              Fill vertex shader with matrix transform and bezier parameters
+ *
+ * @type {string}
+ * @constant
+ */
 export declare const FillVertex = "\noverride yFlipSign: f32 = 1.0;\n\nstruct VertexInput {\n    @location(0) position: vec2<f32>,\n    @location(1) bezier: vec2<f32>,\n}\n\nstruct VertexOutput {\n    @builtin(position) position: vec4<f32>,\n    @location(0) bezier: vec2<f32>,\n    @location(1) color: vec4<f32>,\n}\n\nstruct FillUniforms {\n    color: vec4<f32>,\n    matrix0: vec4<f32>,\n    matrix1: vec4<f32>,\n    matrix2: vec4<f32>,\n}\n\n@group(0) @binding(0) var<uniform> uniforms: FillUniforms;\n\n@vertex\nfn main(input: VertexInput) -> VertexOutput {\n    var output: VertexOutput;\n    let matrix = mat3x3<f32>(uniforms.matrix0.xyz, uniforms.matrix1.xyz, uniforms.matrix2.xyz);\n    let transformed = matrix * vec3<f32>(input.position, 1.0);\n    let ndc = transformed.xy * 2.0 - 1.0;\n    output.position = vec4<f32>(ndc.x, ndc.y * yFlipSign, 0.0, 1.0);\n    output.bezier = input.bezier;\n    output.color = uniforms.color;\n    return output;\n}\n";

package/src/Shader/wgsl/vertex/FillVertex.js

@@ -1,3 +1,10 @@
+/**
+ * @description 塗り用頂点シェーダー（ベジェ曲線パラメータ付き行列変換）
+ *              Fill vertex shader with matrix transform and bezier parameters
+ *
+ * @type {string}
+ * @constant
+ */
 export const FillVertex = /* wgsl */ `
 override yFlipSign: f32 = 1.0;
 

package/src/Shader/wgsl/vertex/FilterVertex.d.ts

@@ -1,12 +1,88 @@
+/**
+ * @description ブラーフィルター用フルスクリーン頂点シェーダー（Y軸テクスチャ反転）
+ *              Full-screen vertex shader for blur filter with Y-axis texture flip
+ *
+ * @type {string}
+ * @constant
+ */
 export declare const BlurFilterVertex: string;
+/**
+ * @description 複合ブレンド用フルスクリーン頂点シェーダー
+ *              Full-screen vertex shader for complex blend
+ *
+ * @type {string}
+ * @constant
+ */
 export declare const ComplexBlendVertex: string;
+/**
+ * @description 複合ブレンドコピー用フルスクリーン頂点シェーダー
+ *              Full-screen vertex shader for complex blend copy
+ *
+ * @type {string}
+ * @constant
+ */
 export declare const ComplexBlendCopyVertex: string;
+/**
+ * @description ノードクリア用頂点シェーダー（NDC変換のみ）
+ *              Node clear vertex shader with NDC transform only
+ *
+ * @type {string}
+ * @constant
+ */
 export declare const NodeClearVertex = "\nstruct VertexInput {\n    @location(0) position: vec2<f32>,\n}\n\nstruct VertexOutput {\n    @builtin(position) position: vec4<f32>,\n}\n\n@vertex\nfn main(input: VertexInput) -> VertexOutput {\n    var output: VertexOutput;\n    let ndc = input.position * 2.0 - 1.0;\n    output.position = vec4<f32>(ndc.x, ndc.y, 0.0, 1.0);\n    return output;\n}\n";
+/**
+ * @description 位置指定テクスチャ描画用頂点シェーダー（ビューポート変換付き）
+ *              Positioned texture rendering vertex shader with viewport transform
+ *
+ * @type {string}
+ * @constant
+ */
 export declare const PositionedTextureVertex = "\nstruct PositionUniforms {\n    offset: vec2<f32>,\n    size: vec2<f32>,\n    viewport: vec2<f32>,\n    padding: vec2<f32>,\n}\n\nstruct VertexOutput {\n    @builtin(position) position: vec4<f32>,\n    @location(0) texCoord: vec2<f32>,\n}\n\n@group(0) @binding(0) var<uniform> uniforms: PositionUniforms;\n\n@vertex\nfn main(@builtin(vertex_index) vertexIndex: u32) -> VertexOutput {\n    var output: VertexOutput;\n\n    const vertices = array<vec2<f32>, 6>(\n        vec2<f32>(0.0, 0.0),\n        vec2<f32>(1.0, 0.0),\n        vec2<f32>(0.0, 1.0),\n        vec2<f32>(0.0, 1.0),\n        vec2<f32>(1.0, 0.0),\n        vec2<f32>(1.0, 1.0)\n    );\n    let vertex = vertices[vertexIndex];\n    output.texCoord = vec2<f32>(vertex.x, 1.0 - vertex.y);\n    var position = vertex * uniforms.size + uniforms.offset;\n    position = position / uniforms.viewport;\n    position = position * 2.0 - 1.0;\n    output.position = vec4<f32>(position.x, -position.y, 0.0, 1.0);\n    return output;\n}\n";
+/**
+ * @description ビットマップ同期用頂点シェーダー（ノード矩形ベース配置）
+ *              Bitmap sync vertex shader with node rectangle-based positioning
+ *
+ * @type {string}
+ * @constant
+ */
 export declare const BitmapSyncVertex = "\nstruct BitmapSyncUniforms {\n    nodeRect: vec4<f32>,\n    textureSize: vec2<f32>,\n    padding: vec2<f32>,\n}\n\nstruct VertexOutput {\n    @builtin(position) position: vec4<f32>,\n    @location(0) texCoord: vec2<f32>,\n}\n\n@group(0) @binding(0) var<uniform> uniforms: BitmapSyncUniforms;\n\n@vertex\nfn main(@builtin(vertex_index) vertexIndex: u32) -> VertexOutput {\n    var output: VertexOutput;\n\n    const vertices = array<vec2<f32>, 6>(\n        vec2<f32>(0.0, 0.0),\n        vec2<f32>(1.0, 0.0),\n        vec2<f32>(0.0, 1.0),\n        vec2<f32>(0.0, 1.0),\n        vec2<f32>(1.0, 0.0),\n        vec2<f32>(1.0, 1.0)\n    );\n    let vertex = vertices[vertexIndex];\n    let pixelPos = vec2<f32>(\n        uniforms.nodeRect.x + vertex.x * uniforms.nodeRect.z,\n        uniforms.nodeRect.y + vertex.y * uniforms.nodeRect.w\n    );\n    let ndc = pixelPos / uniforms.textureSize * 2.0 - 1.0;\n    output.position = vec4<f32>(ndc.x, -ndc.y, 0.0, 1.0);\n    output.texCoord = pixelPos / uniforms.textureSize;\n    return output;\n}\n";
-export declare const BlendModeVertex = "\nstruct VertexInput {\n    @location(0) position: vec2<f32>,\n    @location(1) texCoord: vec2<f32>,\n}\n\nstruct VertexOutput {\n    @builtin(position) position: vec4<f32>,\n    @location(0) texCoord: vec2<f32>,\n}\n\n@vertex\nfn main(input: VertexInput) -> VertexOutput {\n    var output: VertexOutput;\n    output.position = vec4<f32>(input.position, 0.0, 1.0);\n    output.texCoord = input.texCoord;\n    return output;\n}\n";
+/**
+ * @description テクスチャスケール用頂点シェーダー
+ *              Texture scale vertex shader
+ *
+ * @type {string}
+ * @constant
+ */
 export declare const TextureScaleVertex: string;
+/**
+ * @description ブレンド用テクスチャスケール頂点シェーダー（Y軸反転）
+ *              Texture scale vertex shader for blend with Y-axis flip
+ *
+ * @type {string}
+ * @constant
+ */
 export declare const TextureScaleBlendVertex: string;
+/**
+ * @description 複合ブレンドスケール用頂点シェーダー
+ *              Complex blend scale vertex shader
+ *
+ * @type {string}
+ * @constant
+ */
 export declare const ComplexBlendScaleVertex: string;
+/**
+ * @description 複合ブレンド出力用頂点シェーダー
+ *              Complex blend output vertex shader
+ *
+ * @type {string}
+ * @constant
+ */
 export declare const ComplexBlendOutputVertex: string;
+/**
+ * @description フィルター複合ブレンド出力用頂点シェーダー（Y軸反転）
+ *              Filter complex blend output vertex shader with Y-axis flip
+ *
+ * @type {string}
+ * @constant
+ */
 export declare const FilterComplexBlendOutputVertex: string;

package/src/Shader/wgsl/vertex/FilterVertex.js

@@ -1,5 +1,12 @@
 import { WgslFullscreenPositions, WgslUnitQuadVertices, WgslVertexOutput } from "../common/SharedWgsl";
-const createFullscreenQuadVertex = (yFlipTexCoord) => /* wgsl */ `
+/**
+ * @description フルスクリーン四角形の頂点シェーダーを生成する
+ *              Generate a full-screen quad vertex shader
+ *
+ * @param  {boolean} y_flip_tex_coord - テクスチャY座標を反転するかどうか
+ * @return {string}
+ */
+const $createFullscreenQuadVertex = (y_flip_tex_coord) => /* wgsl */ `
 ${WgslVertexOutput}
 
 @vertex
@@ -7,21 +14,49 @@ fn main(@builtin(vertex_index) vertexIndex: u32) -> VertexOutput {
     var output: VertexOutput;
 ${WgslFullscreenPositions}
     var texCoords = array<vec2<f32>, 6>(
-        vec2<f32>(0.0, ${yFlipTexCoord ? "1.0" : "0.0"}),
-        vec2<f32>(1.0, ${yFlipTexCoord ? "1.0" : "0.0"}),
-        vec2<f32>(0.0, ${yFlipTexCoord ? "0.0" : "1.0"}),
-        vec2<f32>(0.0, ${yFlipTexCoord ? "0.0" : "1.0"}),
-        vec2<f32>(1.0, ${yFlipTexCoord ? "1.0" : "0.0"}),
-        vec2<f32>(1.0, ${yFlipTexCoord ? "0.0" : "1.0"})
+        vec2<f32>(0.0, ${y_flip_tex_coord ? "1.0" : "0.0"}),
+        vec2<f32>(1.0, ${y_flip_tex_coord ? "1.0" : "0.0"}),
+        vec2<f32>(0.0, ${y_flip_tex_coord ? "0.0" : "1.0"}),
+        vec2<f32>(0.0, ${y_flip_tex_coord ? "0.0" : "1.0"}),
+        vec2<f32>(1.0, ${y_flip_tex_coord ? "1.0" : "0.0"}),
+        vec2<f32>(1.0, ${y_flip_tex_coord ? "0.0" : "1.0"})
     );
     output.position = vec4<f32>(positions[vertexIndex], 0.0, 1.0);
     output.texCoord = texCoords[vertexIndex];
     return output;
 }
 `;
-export const BlurFilterVertex = createFullscreenQuadVertex(true);
-export const ComplexBlendVertex = createFullscreenQuadVertex(false);
-export const ComplexBlendCopyVertex = createFullscreenQuadVertex(false);
+/**
+ * @description ブラーフィルター用フルスクリーン頂点シェーダー（Y軸テクスチャ反転）
+ *              Full-screen vertex shader for blur filter with Y-axis texture flip
+ *
+ * @type {string}
+ * @constant
+ */
+export const BlurFilterVertex = $createFullscreenQuadVertex(true);
+/**
+ * @description 複合ブレンド用フルスクリーン頂点シェーダー
+ *              Full-screen vertex shader for complex blend
+ *
+ * @type {string}
+ * @constant
+ */
+export const ComplexBlendVertex = $createFullscreenQuadVertex(false);
+/**
+ * @description 複合ブレンドコピー用フルスクリーン頂点シェーダー
+ *              Full-screen vertex shader for complex blend copy
+ *
+ * @type {string}
+ * @constant
+ */
+export const ComplexBlendCopyVertex = $createFullscreenQuadVertex(false);
+/**
+ * @description ノードクリア用頂点シェーダー（NDC変換のみ）
+ *              Node clear vertex shader with NDC transform only
+ *
+ * @type {string}
+ * @constant
+ */
 export const NodeClearVertex = /* wgsl */ `
 struct VertexInput {
     @location(0) position: vec2<f32>,
@@ -39,6 +74,13 @@ fn main(input: VertexInput) -> VertexOutput {
     return output;
 }
 `;
+/**
+ * @description 位置指定テクスチャ描画用頂点シェーダー（ビューポート変換付き）
+ *              Positioned texture rendering vertex shader with viewport transform
+ *
+ * @type {string}
+ * @constant
+ */
 export const PositionedTextureVertex = /* wgsl */ `
 struct PositionUniforms {
     offset: vec2<f32>,
@@ -67,6 +109,13 @@ ${WgslUnitQuadVertices}
     return output;
 }
 `;
+/**
+ * @description ビットマップ同期用頂点シェーダー（ノード矩形ベース配置）
+ *              Bitmap sync vertex shader with node rectangle-based positioning
+ *
+ * @type {string}
+ * @constant
+ */
 export const BitmapSyncVertex = /* wgsl */ `
 struct BitmapSyncUniforms {
     nodeRect: vec4<f32>,
@@ -96,26 +145,14 @@ ${WgslUnitQuadVertices}
     return output;
 }
 `;
-export const BlendModeVertex = /* wgsl */ `
-struct VertexInput {
-    @location(0) position: vec2<f32>,
-    @location(1) texCoord: vec2<f32>,
-}
-
-struct VertexOutput {
-    @builtin(position) position: vec4<f32>,
-    @location(0) texCoord: vec2<f32>,
-}
-
-@vertex
-fn main(input: VertexInput) -> VertexOutput {
-    var output: VertexOutput;
-    output.position = vec4<f32>(input.position, 0.0, 1.0);
-    output.texCoord = input.texCoord;
-    return output;
-}
-`;
-const ScaleUniformsAndStruct = `
+/**
+ * @description スケール変換用Uniform定義と頂点出力構造体のWGSLコード
+ *              WGSL code for scale transform uniform definitions and vertex output struct
+ *
+ * @type {string}
+ * @constant
+ */
+const $ScaleUniformsAndStruct = `
 struct ScaleUniforms {
     matrix: vec4<f32>,
     translate: vec2<f32>,
@@ -131,7 +168,14 @@ struct VertexOutput {
 
 @group(0) @binding(0) var<uniform> uniforms: ScaleUniforms;
 `;
-const ScaleTransformBody = `
+/**
+ * @description スケール変換の頂点位置計算処理のWGSLコード
+ *              WGSL code for scale transform vertex position calculation
+ *
+ * @type {string}
+ * @constant
+ */
+const $ScaleTransformBody = `
     var pos = vertex * uniforms.srcSize;
     let a = uniforms.matrix.x;
     let b = uniforms.matrix.y;
@@ -145,23 +189,58 @@ const ScaleTransformBody = `
     position = position * 2.0 - 1.0;
     output.position = vec4<f32>(position.x, -position.y, 0.0, 1.0);
 `;
-const createScaleVertex = (yFlipTexCoord) => /* wgsl */ `
-${ScaleUniformsAndStruct}
+/**
+ * @description スケール変換用頂点シェーダーを生成する
+ *              Generate a scale transform vertex shader
+ *
+ * @param  {boolean} y_flip_tex_coord - テクスチャY座標を反転するかどうか
+ * @return {string}
+ */
+const $createScaleVertex = (y_flip_tex_coord) => /* wgsl */ `
+${$ScaleUniformsAndStruct}
 
 @vertex
 fn main(@builtin(vertex_index) vertexIndex: u32) -> VertexOutput {
     var output: VertexOutput;
 ${WgslUnitQuadVertices}
     let vertex = vertices[vertexIndex];
-    output.texCoord = ${yFlipTexCoord ? "vec2<f32>(vertex.x, 1.0 - vertex.y)" : "vertex"};
-${ScaleTransformBody}
+    output.texCoord = ${y_flip_tex_coord ? "vec2<f32>(vertex.x, 1.0 - vertex.y)" : "vertex"};
+${$ScaleTransformBody}
     return output;
 }
 `;
-export const TextureScaleVertex = createScaleVertex(false);
-export const TextureScaleBlendVertex = createScaleVertex(true);
-export const ComplexBlendScaleVertex = createScaleVertex(false);
-const createOutputVertex = (yFlipTexCoord) => /* wgsl */ `
+/**
+ * @description テクスチャスケール用頂点シェーダー
+ *              Texture scale vertex shader
+ *
+ * @type {string}
+ * @constant
+ */
+export const TextureScaleVertex = $createScaleVertex(false);
+/**
+ * @description ブレンド用テクスチャスケール頂点シェーダー（Y軸反転）
+ *              Texture scale vertex shader for blend with Y-axis flip
+ *
+ * @type {string}
+ * @constant
+ */
+export const TextureScaleBlendVertex = $createScaleVertex(true);
+/**
+ * @description 複合ブレンドスケール用頂点シェーダー
+ *              Complex blend scale vertex shader
+ *
+ * @type {string}
+ * @constant
+ */
+export const ComplexBlendScaleVertex = $createScaleVertex(false);
+/**
+ * @description 出力用頂点シェーダーを生成する（位置指定・ビューポート変換）
+ *              Generate an output vertex shader with positioning and viewport transform
+ *
+ * @param  {boolean} y_flip_tex_coord - テクスチャY座標を反転するかどうか
+ * @return {string}
+ */
+const $createOutputVertex = (y_flip_tex_coord) => /* wgsl */ `
 struct PositionUniforms {
     offset: vec2<f32>,
     size: vec2<f32>,
@@ -181,7 +260,7 @@ fn main(@builtin(vertex_index) vertexIndex: u32) -> VertexOutput {
     var output: VertexOutput;
 ${WgslUnitQuadVertices}
     let vertex = vertices[vertexIndex];
-    output.texCoord = ${yFlipTexCoord ? "vec2<f32>(vertex.x, 1.0 - vertex.y)" : "vertex"};
+    output.texCoord = ${y_flip_tex_coord ? "vec2<f32>(vertex.x, 1.0 - vertex.y)" : "vertex"};
     var position = vertex * uniforms.size + uniforms.offset;
     position = position / uniforms.viewport;
     position = position * 2.0 - 1.0;
@@ -189,5 +268,19 @@ ${WgslUnitQuadVertices}
     return output;
 }
 `;
-export const ComplexBlendOutputVertex = createOutputVertex(false);
-export const FilterComplexBlendOutputVertex = createOutputVertex(true);
+/**
+ * @description 複合ブレンド出力用頂点シェーダー
+ *              Complex blend output vertex shader
+ *
+ * @type {string}
+ * @constant
+ */
+export const ComplexBlendOutputVertex = $createOutputVertex(false);
+/**
+ * @description フィルター複合ブレンド出力用頂点シェーダー（Y軸反転）
+ *              Filter complex blend output vertex shader with Y-axis flip
+ *
+ * @type {string}
+ * @constant
+ */
+export const FilterComplexBlendOutputVertex = $createOutputVertex(true);

package/src/Shader/wgsl/vertex/GradientVertex.d.ts

@@ -1 +1,8 @@
+/**
+ * @description グラデーション塗り用頂点シェーダー（逆行列によるUV座標計算）
+ *              Gradient fill vertex shader with inverse matrix UV coordinate calculation
+ *
+ * @type {string}
+ * @constant
+ */
 export declare const GradientFillVertex = "\noverride yFlipSign: f32 = 1.0;\n\nstruct VertexInput {\n    @location(0) position: vec2<f32>,\n    @location(1) bezier: vec2<f32>,\n}\n\nstruct VertexOutput {\n    @builtin(position) position: vec4<f32>,\n    @location(0) v_uv: vec2<f32>,\n    @location(1) bezier: vec2<f32>,\n    @location(2) color: vec4<f32>,\n}\n\nstruct GradientUniforms {\n    inverseMatrix: mat3x3<f32>,\n    gradientType: f32,\n    focal: f32,\n    spread: f32,\n    radius: f32,\n    linearPoints: vec4<f32>,\n    color: vec4<f32>,\n    contextMatrix0: vec4<f32>,\n    contextMatrix1: vec4<f32>,\n    contextMatrix2: vec4<f32>,\n}\n\n@group(0) @binding(0) var<uniform> gradient: GradientUniforms;\n\n@vertex\nfn main(input: VertexInput) -> VertexOutput {\n    var output: VertexOutput;\n    let contextMatrix = mat3x3<f32>(gradient.contextMatrix0.xyz, gradient.contextMatrix1.xyz, gradient.contextMatrix2.xyz);\n    let pos = contextMatrix * vec3<f32>(input.position, 1.0);\n    let ndc = vec2<f32>(pos.x * 2.0 - 1.0, pos.y * 2.0 - 1.0);\n    output.position = vec4<f32>(ndc.x, ndc.y * yFlipSign, 0.0, 1.0);\n    let uvPos = gradient.inverseMatrix * vec3<f32>(input.position, 1.0);\n    output.v_uv = uvPos.xy;\n    output.bezier = input.bezier;\n    output.color = gradient.color;\n    return output;\n}\n";

package/src/Shader/wgsl/vertex/GradientVertex.js

@@ -1,3 +1,10 @@
+/**
+ * @description グラデーション塗り用頂点シェーダー（逆行列によるUV座標計算）
+ *              Gradient fill vertex shader with inverse matrix UV coordinate calculation
+ *
+ * @type {string}
+ * @constant
+ */
 export const GradientFillVertex = /* wgsl */ `
 override yFlipSign: f32 = 1.0;
 

package/src/Shader/wgsl/vertex/InstancedVertex.d.ts

@@ -1 +1,8 @@
+/**
+ * @description インスタンス描画用頂点シェーダー（インスタンスごとの変換・カラー）
+ *              Instanced rendering vertex shader with per-instance transform and color
+ *
+ * @type {string}
+ * @constant
+ */
 export declare const InstancedVertex = "\nstruct VertexInput {\n    @location(0) position: vec2<f32>,\n    @location(1) texCoord: vec2<f32>,\n}\n\nstruct InstanceInput {\n    @location(2) textureRect: vec4<f32>,\n    @location(3) textureDim: vec4<f32>,\n    @location(4) matrixTx: vec4<f32>,\n    @location(5) matrixScale: vec4<f32>,\n    @location(6) mulColor: vec4<f32>,\n    @location(7) addColor: vec4<f32>,\n}\n\nstruct VertexOutput {\n    @builtin(position) position: vec4<f32>,\n    @location(0) texCoord: vec2<f32>,\n    @location(1) mulColor: vec4<f32>,\n    @location(2) addColor: vec4<f32>,\n}\n\n@vertex\nfn main(\n    input: VertexInput,\n    instance: InstanceInput,\n    @builtin(instance_index) instanceIdx: u32\n) -> VertexOutput {\n    var output: VertexOutput;\n    let texX = instance.textureRect.x + input.texCoord.x * instance.textureRect.z;\n    let texY = instance.textureRect.y + input.texCoord.y * instance.textureRect.w;\n    output.texCoord = vec2<f32>(texX, texY);\n    var pos = vec2<f32>(input.position.x, 1.0 - input.position.y);\n    pos = pos * vec2<f32>(instance.textureDim.x, instance.textureDim.y);\n    let scale0 = instance.matrixScale.x;\n    let rotate0 = instance.matrixScale.y;\n    let scale1 = instance.matrixScale.z;\n    let rotate1 = instance.matrixScale.w;\n    let transformedX = pos.x * scale0 + pos.y * scale1 + instance.matrixTx.x;\n    let transformedY = pos.x * rotate0 + pos.y * rotate1 + instance.matrixTx.y;\n    var position = vec2<f32>(transformedX, transformedY) / vec2<f32>(instance.textureDim.z, instance.textureDim.w);\n    position = position * 2.0 - 1.0;\n    output.position = vec4<f32>(position.x, -position.y, 0.0, 1.0);\n    output.mulColor = instance.mulColor;\n    output.addColor = instance.addColor;\n    return output;\n}\n";

package/src/Shader/wgsl/vertex/InstancedVertex.js

@@ -1,3 +1,10 @@
+/**
+ * @description インスタンス描画用頂点シェーダー（インスタンスごとの変換・カラー）
+ *              Instanced rendering vertex shader with per-instance transform and color
+ *
+ * @type {string}
+ * @constant
+ */
 export const InstancedVertex = /* wgsl */ `
 struct VertexInput {
     @location(0) position: vec2<f32>,

package/src/Shader/wgsl/vertex/MaskVertex.d.ts

@@ -1 +1,8 @@
+/**
+ * @description マスク用頂点シェーダー（ベジェ曲線パラメータ付き行列変換）
+ *              Mask vertex shader with matrix transform and bezier parameters
+ *
+ * @type {string}
+ * @constant
+ */
 export declare const MaskVertex = "\nstruct VertexInput {\n    @location(0) position: vec2<f32>,\n    @location(1) bezier: vec2<f32>,\n}\n\nstruct VertexOutput {\n    @builtin(position) position: vec4<f32>,\n    @location(0) bezier: vec2<f32>,\n}\n\nstruct Uniforms {\n    viewportSize: vec2<f32>,\n    _padding0: vec2<f32>,\n    matrixCol0: vec3<f32>,\n    _padding1: f32,\n    matrixCol1: vec3<f32>,\n    _padding2: f32,\n    matrixCol2: vec3<f32>,\n    _padding3: f32,\n}\n\n@group(0) @binding(0) var<uniform> uniforms: Uniforms;\n\n@vertex\nfn main(input: VertexInput) -> VertexOutput {\n    var output: VertexOutput;\n    let matrix = mat3x3<f32>(uniforms.matrixCol0, uniforms.matrixCol1, uniforms.matrixCol2);\n    let transformed = matrix * vec3<f32>(input.position, 1.0);\n    let pos = transformed.xy;\n    let ndc = pos * 2.0 - 1.0;\n    output.position = vec4<f32>(ndc.x, -ndc.y, 0.0, 1.0);\n    output.bezier = input.bezier;\n    return output;\n}\n";

package/src/Shader/wgsl/vertex/MaskVertex.js

@@ -1,3 +1,10 @@
+/**
+ * @description マスク用頂点シェーダー（ベジェ曲線パラメータ付き行列変換）
+ *              Mask vertex shader with matrix transform and bezier parameters
+ *
+ * @type {string}
+ * @constant
+ */
 export const MaskVertex = /* wgsl */ `
 struct VertexInput {
     @location(0) position: vec2<f32>,

package/src/Shader/wgsl/vertex/StencilVertex.d.ts

@@ -1,2 +1,16 @@
+/**
+ * @description ステンシル書き込み用頂点シェーダー（ベジェ曲線パラメータ付き）
+ *              Stencil write vertex shader with bezier parameters
+ *
+ * @type {string}
+ * @constant
+ */
 export declare const StencilWriteVertex = "\noverride yFlipSign: f32 = 1.0;\n\nstruct VertexInput {\n    @location(0) position: vec2<f32>,\n    @location(1) bezier: vec2<f32>,\n}\n\nstruct VertexOutput {\n    @builtin(position) position: vec4<f32>,\n    @location(0) bezier: vec2<f32>,\n}\n\nstruct FillUniforms {\n    color: vec4<f32>,\n    matrix0: vec4<f32>,\n    matrix1: vec4<f32>,\n    matrix2: vec4<f32>,\n}\n\n@group(0) @binding(0) var<uniform> uniforms: FillUniforms;\n\n@vertex\nfn main(input: VertexInput) -> VertexOutput {\n    var output: VertexOutput;\n    let matrix = mat3x3<f32>(uniforms.matrix0.xyz, uniforms.matrix1.xyz, uniforms.matrix2.xyz);\n    let transformed = matrix * vec3<f32>(input.position, 1.0);\n    let ndc = transformed.xy * 2.0 - 1.0;\n    output.position = vec4<f32>(ndc.x, ndc.y * yFlipSign, 0.0, 1.0);\n    output.bezier = input.bezier;\n    return output;\n}\n";
+/**
+ * @description ステンシル塗り用頂点シェーダー（カラー出力付き）
+ *              Stencil fill vertex shader with color output
+ *
+ * @type {string}
+ * @constant
+ */
 export declare const StencilFillVertex = "\noverride yFlipSign: f32 = 1.0;\n\nstruct VertexInput {\n    @location(0) position: vec2<f32>,\n    @location(1) bezier: vec2<f32>,\n}\n\nstruct VertexOutput {\n    @builtin(position) position: vec4<f32>,\n    @location(0) color: vec4<f32>,\n}\n\nstruct FillUniforms {\n    color: vec4<f32>,\n    matrix0: vec4<f32>,\n    matrix1: vec4<f32>,\n    matrix2: vec4<f32>,\n}\n\n@group(0) @binding(0) var<uniform> uniforms: FillUniforms;\n\n@vertex\nfn main(input: VertexInput) -> VertexOutput {\n    var output: VertexOutput;\n    let matrix = mat3x3<f32>(uniforms.matrix0.xyz, uniforms.matrix1.xyz, uniforms.matrix2.xyz);\n    let transformed = matrix * vec3<f32>(input.position, 1.0);\n    let ndc = transformed.xy * 2.0 - 1.0;\n    output.position = vec4<f32>(ndc.x, ndc.y * yFlipSign, 0.0, 1.0);\n    output.color = uniforms.color;\n    return output;\n}\n";

package/src/Shader/wgsl/vertex/StencilVertex.js

@@ -1,3 +1,10 @@
+/**
+ * @description ステンシル書き込み用頂点シェーダー（ベジェ曲線パラメータ付き）
+ *              Stencil write vertex shader with bezier parameters
+ *
+ * @type {string}
+ * @constant
+ */
 export const StencilWriteVertex = /* wgsl */ `
 override yFlipSign: f32 = 1.0;
 
@@ -31,6 +38,13 @@ fn main(input: VertexInput) -> VertexOutput {
     return output;
 }
 `;
+/**
+ * @description ステンシル塗り用頂点シェーダー（カラー出力付き）
+ *              Stencil fill vertex shader with color output
+ *
+ * @type {string}
+ * @constant
+ */
 export const StencilFillVertex = /* wgsl */ `
 override yFlipSign: f32 = 1.0;
 

package/src/TextureManager/service/TextureManagerInitializeSamplersService.d.ts

@@ -2,8 +2,8 @@
  * @description サンプラーを初期化
  *              Initialize samplers
  *
- * @param  {GPUDevice} device
- * @param  {Map<string, GPUSampler>} samplers
+ * @param  {GPUDevice} device - GPUデバイス
+ * @param  {Map<string, GPUSampler>} samplers - サンプラー管理マップ
  * @return {void}
  * @method
  * @protected

package/src/TextureManager/service/TextureManagerInitializeSamplersService.js

@@ -2,8 +2,8 @@
  * @description サンプラーを初期化
  *              Initialize samplers
  *
- * @param  {GPUDevice} device
- * @param  {Map<string, GPUSampler>} samplers
+ * @param  {GPUDevice} device - GPUデバイス
+ * @param  {Map<string, GPUSampler>} samplers - サンプラー管理マップ
  * @return {void}
  * @method
  * @protected

package/src/TextureManager.d.ts

@@ -1,15 +1,46 @@
+/**
+ * @description テクスチャとサンプラーの管理クラス
+ *              Manager class for textures and samplers
+ */
 export declare class TextureManager {
     private device;
     private textures;
     private samplers;
+    /**
+     * @description TextureManagerのコンストラクタ
+     *              Constructor for TextureManager
+     * @param {GPUDevice} device - WebGPUデバイス / WebGPU device
+     */
     constructor(device: GPUDevice);
+    /**
+     * @description 新しいGPUテクスチャを作成する
+     *              Create a new GPU texture
+     * @param  {string}           name   - テクスチャ名 / Texture name
+     * @param  {number}           width  - テクスチャの幅 / Texture width
+     * @param  {number}           height - テクスチャの高さ / Texture height
+     * @param  {GPUTextureFormat} [format="rgba8unorm"] - テクスチャフォーマット / Texture format
+     * @return {GPUTexture}
+     */
     createTexture(name: string, width: number, height: number, format?: GPUTextureFormat): GPUTexture;
-    createTextureFromPixels(name: string, pixels: Uint8Array, width: number, height: number): GPUTexture;
-    createTextureFromImageBitmap(name: string, imageBitmap: ImageBitmap): GPUTexture;
-    updateTexture(name: string, pixels: Uint8Array, width: number, height: number): void;
+    /**
+     * @description 名前でテクスチャを取得する
+     *              Get a texture by name
+     * @param  {string} name - テクスチャ名 / Texture name
+     * @return {GPUTexture | undefined}
+     */
     getTexture(name: string): GPUTexture | undefined;
-    getSampler(name: string): GPUSampler | undefined;
+    /**
+     * @description サンプラーを作成する（既存の場合は返却）
+     *              Create a sampler (returns existing if found)
+     * @param  {string}  name            - サンプラー名 / Sampler name
+     * @param  {boolean} [smooth=true]   - スムージングを有効にするか / Whether to enable smoothing
+     * @return {GPUSampler}
+     */
     createSampler(name: string, smooth?: boolean): GPUSampler;
-    destroyTexture(name: string): void;
+    /**
+     * @description 全テクスチャとサンプラーを破棄する
+     *              Dispose all textures and samplers
+     * @return {void}
+     */
     dispose(): void;
 }