@next2d/webgpu 3.0.4 → 3.1.0

package/src/Context/usecase/ContextProcessComplexBlendQueueUseCase.js

@@ -2,86 +2,152 @@ import { getComplexBlendQueue, clearComplexBlendQueue } from "../../Blend/BlendI
 import { execute as blendApplyComplexBlendUseCase } from "../../Blend/usecase/BlendApplyComplexBlendUseCase";
 import { $getAtlasAttachmentObject } from "../../AtlasManager";
 // プリアロケート配列
+/**
+ * @description ユニフォームデータの事前確保配列（4要素）
+ *              Pre-allocated uniform data array (4 elements)
+ */
 const $uniform4 = new Float32Array(4);
+/**
+ * @description ユニフォームデータの事前確保配列（6要素）
+ *              Pre-allocated uniform data array (6 elements)
+ */
 const $uniform6 = new Float32Array(6);
+/**
+ * @description ユニフォームデータの事前確保配列（8要素）
+ *              Pre-allocated uniform data array (8 elements)
+ */
 const $uniform8 = new Float32Array(8);
+/**
+ * @description ユニフォームデータの事前確保配列（12要素）
+ *              Pre-allocated uniform data array (12 elements)
+ */
 const $uniform12 = new Float32Array(12);
 // プリアロケート BindGroup Entry 配列
+/**
+ * @description バインドグループエントリの事前確保配列
+ *              Pre-allocated bind group entry array
+ */
 const $entries3 = [
     { "binding": 0, "resource": { "buffer": null } },
     { "binding": 1, "resource": null },
     { "binding": 2, "resource": null }
 ];
-const copyTextureRegionViaRenderPass = (device, commandEncoder, srcView, dstAttachment, srcX, srcY, srcWidth, srcHeight, copyWidth, copyHeight, frameBufferManager, textureManager, pipelineManager, bufferManager) => {
-    const pipeline = pipelineManager.getPipeline("complex_blend_copy");
-    const bindGroupLayout = pipelineManager.getBindGroupLayout("texture_copy");
+/**
+ * @description レンダーパスを使用してテクスチャ領域をコピーする
+ *              Copies a texture region via render pass
+ * @param {GPUDevice} device GPUデバイス / GPU device
+ * @param {GPUCommandEncoder} command_encoder コマンドエンコーダ / Command encoder
+ * @param {GPUTextureView} src_view ソーステクスチャビュー / Source texture view
+ * @param {IAttachmentObject} dst_attachment デスティネーションアタッチメント / Destination attachment
+ * @param {number} src_x ソースX座標 / Source X coordinate
+ * @param {number} src_y ソースY座標 / Source Y coordinate
+ * @param {number} src_width ソース幅 / Source width
+ * @param {number} src_height ソース高さ / Source height
+ * @param {number} copy_width コピー幅 / Copy width
+ * @param {number} copy_height コピー高さ / Copy height
+ * @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}
+ */
+const $copyTextureRegionViaRenderPass = (device, command_encoder, src_view, dst_attachment, src_x, src_y, src_width, src_height, copy_width, copy_height, frame_buffer_manager, texture_manager, pipeline_manager, buffer_manager) => {
+    const pipeline = pipeline_manager.getPipeline("complex_blend_copy");
+    const bindGroupLayout = pipeline_manager.getBindGroupLayout("texture_copy");
     if (!pipeline || !bindGroupLayout) {
         return;
     }
-    $uniform4[0] = copyWidth / srcWidth;
-    $uniform4[1] = copyHeight / srcHeight;
-    $uniform4[2] = srcX / srcWidth;
-    $uniform4[3] = srcY / srcHeight;
-    const uniformBuffer = bufferManager.acquireAndWriteUniformBuffer($uniform4);
-    const sampler = textureManager.createSampler("complex_blend_copy_sampler", false);
+    $uniform4[0] = copy_width / src_width;
+    $uniform4[1] = copy_height / src_height;
+    $uniform4[2] = src_x / src_width;
+    $uniform4[3] = src_y / src_height;
+    const uniformBuffer = buffer_manager.acquireAndWriteUniformBuffer($uniform4);
+    const sampler = texture_manager.createSampler("complex_blend_copy_sampler", false);
     $entries3[0].resource.buffer = uniformBuffer;
     $entries3[1].resource = sampler;
-    $entries3[2].resource = srcView;
+    $entries3[2].resource = src_view;
     const bindGroup = device.createBindGroup({
         "layout": bindGroupLayout,
         "entries": $entries3
     });
-    const renderPassDescriptor = frameBufferManager.createRenderPassDescriptor(dstAttachment.texture.view, 0, 0, 0, 0, "clear");
-    const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);
+    const renderPassDescriptor = frame_buffer_manager.createRenderPassDescriptor(dst_attachment.texture.view, 0, 0, 0, 0, "clear");
+    const passEncoder = command_encoder.beginRenderPass(renderPassDescriptor);
     passEncoder.setPipeline(pipeline);
     passEncoder.setBindGroup(0, bindGroup);
     passEncoder.draw(6, 1, 0, 0);
     passEncoder.end();
 };
-const drawToMainAttachment = (device, commandEncoder, srcAttachment, mainAttachment, dstX, dstY, frameBufferManager, textureManager, pipelineManager, bufferManager) => {
-    const useMsaa = mainAttachment.msaa && mainAttachment.msaaTexture?.view;
+/**
+ * @description ブレンド結果をメインアタッチメントに描画する
+ *              Draws blend result to the main attachment
+ * @param {GPUDevice} device GPUデバイス / GPU device
+ * @param {GPUCommandEncoder} command_encoder コマンドエンコーダ / Command encoder
+ * @param {IAttachmentObject} src_attachment ソースアタッチメント / Source attachment
+ * @param {IAttachmentObject} main_attachment メインアタッチメント / Main attachment
+ * @param {number} dst_x デスティネーションX座標 / Destination X coordinate
+ * @param {number} dst_y デスティネーションY座標 / Destination Y coordinate
+ * @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}
+ */
+const $drawToMainAttachment = (device, command_encoder, src_attachment, main_attachment, dst_x, dst_y, frame_buffer_manager, texture_manager, pipeline_manager, buffer_manager) => {
+    const useMsaa = main_attachment.msaa && main_attachment.msaaTexture?.view;
     const pipelineName = useMsaa ? "complex_blend_output_msaa" : "complex_blend_output";
-    const pipeline = pipelineManager.getPipeline(pipelineName);
-    const bindGroupLayout = pipelineManager.getBindGroupLayout("positioned_texture");
+    const pipeline = pipeline_manager.getPipeline(pipelineName);
+    const bindGroupLayout = pipeline_manager.getBindGroupLayout("positioned_texture");
     if (!pipeline || !bindGroupLayout) {
         return;
     }
-    $uniform8[0] = dstX;
-    $uniform8[1] = dstY;
-    $uniform8[2] = srcAttachment.width;
-    $uniform8[3] = srcAttachment.height;
-    $uniform8[4] = mainAttachment.width;
-    $uniform8[5] = mainAttachment.height;
+    $uniform8[0] = dst_x;
+    $uniform8[1] = dst_y;
+    $uniform8[2] = src_attachment.width;
+    $uniform8[3] = src_attachment.height;
+    $uniform8[4] = main_attachment.width;
+    $uniform8[5] = main_attachment.height;
     $uniform8[6] = 0;
     $uniform8[7] = 0;
-    const uniformBuffer = bufferManager.acquireAndWriteUniformBuffer($uniform8);
-    const sampler = textureManager.createSampler("complex_blend_output_sampler", false);
+    const uniformBuffer = buffer_manager.acquireAndWriteUniformBuffer($uniform8);
+    const sampler = texture_manager.createSampler("complex_blend_output_sampler", false);
     $entries3[0].resource.buffer = uniformBuffer;
     $entries3[1].resource = sampler;
-    $entries3[2].resource = srcAttachment.texture.view;
+    $entries3[2].resource = src_attachment.texture.view;
     const bindGroup = device.createBindGroup({
         "layout": bindGroupLayout,
         "entries": $entries3
     });
-    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);
-    const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);
+    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);
+    const passEncoder = command_encoder.beginRenderPass(renderPassDescriptor);
     passEncoder.setPipeline(pipeline);
     passEncoder.setBindGroup(0, bindGroup);
     passEncoder.draw(6, 1, 0, 0);
     passEncoder.end();
 };
-export const execute = (device, commandEncoder, mainAttachment, frameBufferManager, textureManager, pipelineManager, bufferManager) => {
+/**
+ * @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 const execute = (device, command_encoder, main_attachment, frame_buffer_manager, texture_manager, pipeline_manager, buffer_manager) => {
     const queue = getComplexBlendQueue();
     if (queue.length === 0) {
         return;
     }
-    if (!mainAttachment || !mainAttachment.texture) {
+    if (!main_attachment || !main_attachment.texture) {
         clearComplexBlendQueue();
         return;
     }
-    const atlasAttachment = $getAtlasAttachmentObject() || frameBufferManager.getAttachment("atlas");
+    const atlasAttachment = $getAtlasAttachmentObject() || frame_buffer_manager.getAttachment("atlas");
     if (!atlasAttachment || !atlasAttachment.texture) {
         clearComplexBlendQueue();
         return;
@@ -95,23 +161,23 @@ export const execute = (device, commandEncoder, mainAttachment, frameBufferManag
         }
         const dstX = Math.max(0, Math.floor(matrix[6]));
         const dstY = Math.max(0, Math.floor(matrix[7]));
-        if (dstX >= mainAttachment.width || dstY >= mainAttachment.height) {
+        if (dstX >= main_attachment.width || dstY >= main_attachment.height) {
             continue;
         }
         const hasScale = matrix[0] !== 1 || matrix[1] !== 0 || matrix[3] !== 0 || matrix[4] !== 1;
         const blendWidth = hasScale ? width : node.w;
         const blendHeight = hasScale ? height : node.h;
-        const clippedWidth = Math.min(blendWidth, mainAttachment.width - dstX);
-        const clippedHeight = Math.min(blendHeight, mainAttachment.height - dstY);
+        const clippedWidth = Math.min(blendWidth, main_attachment.width - dstX);
+        const clippedHeight = Math.min(blendHeight, main_attachment.height - dstY);
         if (clippedWidth <= 0 || clippedHeight <= 0) {
             continue;
         }
         // 1. ソーステクスチャを作成
         let srcAttachment;
         if (hasScale) {
-            srcAttachment = frameBufferManager.createTemporaryAttachment(blendWidth, blendHeight);
-            const scalePipeline = pipelineManager.getPipeline("complex_blend_scale");
-            const scaleBindGroupLayout = pipelineManager.getBindGroupLayout("texture_scale");
+            srcAttachment = frame_buffer_manager.createTemporaryAttachment(blendWidth, blendHeight);
+            const scalePipeline = pipeline_manager.getPipeline("complex_blend_scale");
+            const scaleBindGroupLayout = pipeline_manager.getBindGroupLayout("texture_scale");
             if (scalePipeline && scaleBindGroupLayout) {
                 const halfW = blendWidth / 2;
                 const halfH = blendHeight / 2;
@@ -123,8 +189,8 @@ export const execute = (device, commandEncoder, mainAttachment, frameBufferManag
                 $uniform6[3] = matrix[4];
                 $uniform6[4] = -halfNodeW * matrix[0] - halfNodeH * matrix[3] + halfW;
                 $uniform6[5] = -halfNodeW * matrix[1] - halfNodeH * matrix[4] + halfH;
-                const originalAttachment = frameBufferManager.createTemporaryAttachment(node.w, node.h);
-                commandEncoder.copyTextureToTexture({
+                const originalAttachment = frame_buffer_manager.createTemporaryAttachment(node.w, node.h);
+                command_encoder.copyTextureToTexture({
                     "texture": atlasAttachment.texture.resource,
                     "origin": { "x": node.x, "y": node.y, "z": 0 }
                 }, {
@@ -143,8 +209,8 @@ export const execute = (device, commandEncoder, mainAttachment, frameBufferManag
                 $uniform12[9] = blendHeight;
                 $uniform12[10] = 0;
                 $uniform12[11] = 0;
-                const uniformBuffer = bufferManager.acquireAndWriteUniformBuffer($uniform12, 48);
-                const sampler = textureManager.createSampler("scale_sampler", true);
+                const uniformBuffer = buffer_manager.acquireAndWriteUniformBuffer($uniform12, 48);
+                const sampler = texture_manager.createSampler("scale_sampler", true);
                 $entries3[0].resource.buffer = uniformBuffer;
                 $entries3[1].resource = sampler;
                 $entries3[2].resource = originalAttachment.texture.view;
@@ -152,16 +218,16 @@ export const execute = (device, commandEncoder, mainAttachment, frameBufferManag
                     "layout": scaleBindGroupLayout,
                     "entries": $entries3
                 });
-                const renderPassDescriptor = frameBufferManager.createRenderPassDescriptor(srcAttachment.texture.view, 0, 0, 0, 0, "clear");
-                const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);
+                const renderPassDescriptor = frame_buffer_manager.createRenderPassDescriptor(srcAttachment.texture.view, 0, 0, 0, 0, "clear");
+                const passEncoder = command_encoder.beginRenderPass(renderPassDescriptor);
                 passEncoder.setPipeline(scalePipeline);
                 passEncoder.setBindGroup(0, bindGroup);
                 passEncoder.draw(6, 1, 0, 0);
                 passEncoder.end();
-                frameBufferManager.releaseTemporaryAttachment(originalAttachment);
+                frame_buffer_manager.releaseTemporaryAttachment(originalAttachment);
             }
             else {
-                commandEncoder.copyTextureToTexture({
+                command_encoder.copyTextureToTexture({
                     "texture": atlasAttachment.texture.resource,
                     "origin": { "x": node.x, "y": node.y, "z": 0 }
                 }, {
@@ -171,8 +237,8 @@ export const execute = (device, commandEncoder, mainAttachment, frameBufferManag
             }
         }
         else {
-            srcAttachment = frameBufferManager.createTemporaryAttachment(blendWidth, blendHeight);
-            commandEncoder.copyTextureToTexture({
+            srcAttachment = frame_buffer_manager.createTemporaryAttachment(blendWidth, blendHeight);
+            command_encoder.copyTextureToTexture({
                 "texture": atlasAttachment.texture.resource,
                 "origin": { "x": node.x, "y": node.y, "z": 0 }
             }, {
@@ -181,8 +247,8 @@ export const execute = (device, commandEncoder, mainAttachment, frameBufferManag
             }, { "width": blendWidth, "height": blendHeight });
         }
         // 2. デスティネーションテクスチャを作成（メインからレンダーパスでコピー）
-        const dstAttachment = frameBufferManager.createTemporaryAttachment(blendWidth, blendHeight);
-        copyTextureRegionViaRenderPass(device, commandEncoder, mainAttachment.texture.view, dstAttachment, dstX, dstY, mainAttachment.width, mainAttachment.height, blendWidth, blendHeight, frameBufferManager, textureManager, pipelineManager, bufferManager);
+        const dstAttachment = frame_buffer_manager.createTemporaryAttachment(blendWidth, blendHeight);
+        $copyTextureRegionViaRenderPass(device, command_encoder, main_attachment.texture.view, dstAttachment, dstX, dstY, main_attachment.width, main_attachment.height, blendWidth, blendHeight, frame_buffer_manager, texture_manager, pipeline_manager, buffer_manager);
         // 3. カラートランスフォームを準備（add値は生値）
         $uniform8[0] = color_transform[0];
         $uniform8[1] = color_transform[1];
@@ -194,20 +260,20 @@ export const execute = (device, commandEncoder, mainAttachment, frameBufferManag
         $uniform8[7] = 0;
         // 4. 複雑なブレンドを適用
         const blendedAttachment = blendApplyComplexBlendUseCase(srcAttachment, dstAttachment, blend_mode, $uniform8, {
-            device,
-            commandEncoder,
-            bufferManager,
-            frameBufferManager,
-            pipelineManager,
-            textureManager,
+            "device": device,
+            "commandEncoder": command_encoder,
+            "bufferManager": buffer_manager,
+            "frameBufferManager": frame_buffer_manager,
+            "pipelineManager": pipeline_manager,
+            "textureManager": texture_manager,
             "frameTextures": []
         });
         // 5. 結果をメインアタッチメントに描画
-        drawToMainAttachment(device, commandEncoder, blendedAttachment, mainAttachment, dstX, dstY, frameBufferManager, textureManager, pipelineManager, bufferManager);
+        $drawToMainAttachment(device, command_encoder, blendedAttachment, main_attachment, dstX, dstY, frame_buffer_manager, texture_manager, pipeline_manager, buffer_manager);
         // 6. 一時テクスチャを解放
-        frameBufferManager.releaseTemporaryAttachment(srcAttachment);
-        frameBufferManager.releaseTemporaryAttachment(dstAttachment);
-        frameBufferManager.releaseTemporaryAttachment(blendedAttachment);
+        frame_buffer_manager.releaseTemporaryAttachment(srcAttachment);
+        frame_buffer_manager.releaseTemporaryAttachment(dstAttachment);
+        frame_buffer_manager.releaseTemporaryAttachment(blendedAttachment);
     }
     clearComplexBlendQueue();
 };