forked from mirrors/gecko-dev
The WebGPU spec says that `beginRenderPass` should generate a validation error if the valid usage rules for `GPURenderPassDescriptor` are not satisfied. In particular, a `GPURenderPassDescriptor` may not contain more than eight color attachments. The `wgpu-core` crate will panic if a `wgpu_core::command::RenderPassDescriptor` contains too many color attachments. This is safe, but panics are not acceptable in Firefox, so it falls to our WebGPU implementation to perform the error checks described by the spec. Since WebGPU error handling records the first error to occur within each error scope, the API is sensitive to the order in which errors are generated. To ensure that the error is properly ordered with respect to other messages sent to the device, we must send the error to compositor process. The WebGPUParent will then handle it interleaved appropriately with other Device timeline activity. Differential Revision: https://phabricator.services.mozilla.com/D146391
303 lines
10 KiB
C++
303 lines
10 KiB
C++
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
|
|
|
#include "mozilla/dom/WebGPUBinding.h"
|
|
#include "RenderPassEncoder.h"
|
|
#include "BindGroup.h"
|
|
#include "CommandEncoder.h"
|
|
#include "RenderBundle.h"
|
|
#include "RenderPipeline.h"
|
|
#include "mozilla/webgpu/ffi/wgpu.h"
|
|
|
|
namespace mozilla::webgpu {
|
|
|
|
GPU_IMPL_CYCLE_COLLECTION(RenderPassEncoder, mParent, mUsedBindGroups,
|
|
mUsedBuffers, mUsedPipelines, mUsedTextureViews,
|
|
mUsedRenderBundles)
|
|
GPU_IMPL_JS_WRAP(RenderPassEncoder)
|
|
|
|
ffi::WGPURenderPass* ScopedFfiRenderTraits::empty() { return nullptr; }
|
|
|
|
void ScopedFfiRenderTraits::release(ffi::WGPURenderPass* raw) {
|
|
if (raw) {
|
|
ffi::wgpu_render_pass_destroy(raw);
|
|
}
|
|
}
|
|
|
|
ffi::WGPULoadOp ConvertLoadOp(const dom::GPULoadOp& aOp) {
|
|
switch (aOp) {
|
|
case dom::GPULoadOp::Load:
|
|
return ffi::WGPULoadOp_Load;
|
|
default:
|
|
MOZ_CRASH("Unexpected load op");
|
|
}
|
|
}
|
|
|
|
ffi::WGPUStoreOp ConvertStoreOp(const dom::GPUStoreOp& aOp) {
|
|
switch (aOp) {
|
|
case dom::GPUStoreOp::Store:
|
|
return ffi::WGPUStoreOp_Store;
|
|
case dom::GPUStoreOp::Discard:
|
|
return ffi::WGPUStoreOp_Discard;
|
|
default:
|
|
MOZ_CRASH("Unexpected load op");
|
|
}
|
|
}
|
|
|
|
ffi::WGPUColor ConvertColor(const dom::GPUColorDict& aColor) {
|
|
ffi::WGPUColor color = {aColor.mR, aColor.mG, aColor.mB, aColor.mA};
|
|
return color;
|
|
}
|
|
|
|
ffi::WGPURenderPass* BeginRenderPass(
|
|
CommandEncoder* const aParent, const dom::GPURenderPassDescriptor& aDesc) {
|
|
ffi::WGPURenderPassDescriptor desc = {};
|
|
|
|
ffi::WGPURenderPassDepthStencilAttachment dsDesc = {};
|
|
if (aDesc.mDepthStencilAttachment.WasPassed()) {
|
|
const auto& dsa = aDesc.mDepthStencilAttachment.Value();
|
|
dsDesc.view = dsa.mView->mId;
|
|
|
|
if (dsa.mDepthLoadValue.IsFloat()) {
|
|
dsDesc.depth.load_op = ffi::WGPULoadOp_Clear;
|
|
dsDesc.depth.clear_value = dsa.mDepthLoadValue.GetAsFloat();
|
|
}
|
|
if (dsa.mDepthLoadValue.IsGPULoadOp()) {
|
|
dsDesc.depth.load_op =
|
|
ConvertLoadOp(dsa.mDepthLoadValue.GetAsGPULoadOp());
|
|
}
|
|
dsDesc.depth.store_op = ConvertStoreOp(dsa.mDepthStoreOp);
|
|
|
|
if (dsa.mStencilLoadValue.IsRangeEnforcedUnsignedLong()) {
|
|
dsDesc.stencil.load_op = ffi::WGPULoadOp_Clear;
|
|
dsDesc.stencil.clear_value =
|
|
dsa.mStencilLoadValue.GetAsRangeEnforcedUnsignedLong();
|
|
}
|
|
if (dsa.mStencilLoadValue.IsGPULoadOp()) {
|
|
dsDesc.stencil.load_op =
|
|
ConvertLoadOp(dsa.mStencilLoadValue.GetAsGPULoadOp());
|
|
}
|
|
dsDesc.stencil.store_op = ConvertStoreOp(dsa.mStencilStoreOp);
|
|
|
|
desc.depth_stencil_attachment = &dsDesc;
|
|
}
|
|
|
|
if (aDesc.mColorAttachments.Length() > WGPUMAX_COLOR_TARGETS) {
|
|
aParent->GetDevice()->GenerateError(nsLiteralCString(
|
|
"Too many color attachments in GPURenderPassDescriptor"));
|
|
return nullptr;
|
|
}
|
|
|
|
std::array<ffi::WGPURenderPassColorAttachment, WGPUMAX_COLOR_TARGETS>
|
|
colorDescs = {};
|
|
desc.color_attachments = colorDescs.data();
|
|
desc.color_attachments_length = aDesc.mColorAttachments.Length();
|
|
|
|
for (size_t i = 0; i < aDesc.mColorAttachments.Length(); ++i) {
|
|
const auto& ca = aDesc.mColorAttachments[i];
|
|
ffi::WGPURenderPassColorAttachment& cd = colorDescs[i];
|
|
cd.view = ca.mView->mId;
|
|
cd.channel.store_op = ConvertStoreOp(ca.mStoreOp);
|
|
|
|
if (ca.mResolveTarget.WasPassed()) {
|
|
cd.resolve_target = ca.mResolveTarget.Value().mId;
|
|
}
|
|
if (ca.mLoadValue.IsGPULoadOp()) {
|
|
cd.channel.load_op = ConvertLoadOp(ca.mLoadValue.GetAsGPULoadOp());
|
|
} else {
|
|
cd.channel.load_op = ffi::WGPULoadOp_Clear;
|
|
if (ca.mLoadValue.IsDoubleSequence()) {
|
|
const auto& seq = ca.mLoadValue.GetAsDoubleSequence();
|
|
if (seq.Length() >= 1) {
|
|
cd.channel.clear_value.r = seq[0];
|
|
}
|
|
if (seq.Length() >= 2) {
|
|
cd.channel.clear_value.g = seq[1];
|
|
}
|
|
if (seq.Length() >= 3) {
|
|
cd.channel.clear_value.b = seq[2];
|
|
}
|
|
if (seq.Length() >= 4) {
|
|
cd.channel.clear_value.a = seq[3];
|
|
}
|
|
}
|
|
if (ca.mLoadValue.IsGPUColorDict()) {
|
|
cd.channel.clear_value =
|
|
ConvertColor(ca.mLoadValue.GetAsGPUColorDict());
|
|
}
|
|
}
|
|
}
|
|
|
|
return ffi::wgpu_command_encoder_begin_render_pass(aParent->mId, &desc);
|
|
}
|
|
|
|
RenderPassEncoder::RenderPassEncoder(CommandEncoder* const aParent,
|
|
const dom::GPURenderPassDescriptor& aDesc)
|
|
: ChildOf(aParent), mPass(BeginRenderPass(aParent, aDesc)) {
|
|
if (!mPass) {
|
|
mValid = false;
|
|
return;
|
|
}
|
|
|
|
for (const auto& at : aDesc.mColorAttachments) {
|
|
mUsedTextureViews.AppendElement(at.mView);
|
|
}
|
|
if (aDesc.mDepthStencilAttachment.WasPassed()) {
|
|
mUsedTextureViews.AppendElement(
|
|
aDesc.mDepthStencilAttachment.Value().mView);
|
|
}
|
|
}
|
|
|
|
RenderPassEncoder::~RenderPassEncoder() {
|
|
if (mValid) {
|
|
mValid = false;
|
|
}
|
|
}
|
|
|
|
void RenderPassEncoder::SetBindGroup(
|
|
uint32_t aSlot, const BindGroup& aBindGroup,
|
|
const dom::Sequence<uint32_t>& aDynamicOffsets) {
|
|
if (mValid) {
|
|
mUsedBindGroups.AppendElement(&aBindGroup);
|
|
ffi::wgpu_render_pass_set_bind_group(mPass, aSlot, aBindGroup.mId,
|
|
aDynamicOffsets.Elements(),
|
|
aDynamicOffsets.Length());
|
|
}
|
|
}
|
|
|
|
void RenderPassEncoder::SetPipeline(const RenderPipeline& aPipeline) {
|
|
if (mValid) {
|
|
mUsedPipelines.AppendElement(&aPipeline);
|
|
ffi::wgpu_render_pass_set_pipeline(mPass, aPipeline.mId);
|
|
}
|
|
}
|
|
|
|
void RenderPassEncoder::SetIndexBuffer(const Buffer& aBuffer,
|
|
const dom::GPUIndexFormat& aIndexFormat,
|
|
uint64_t aOffset, uint64_t aSize) {
|
|
if (mValid) {
|
|
mUsedBuffers.AppendElement(&aBuffer);
|
|
const auto iformat = aIndexFormat == dom::GPUIndexFormat::Uint32
|
|
? ffi::WGPUIndexFormat_Uint32
|
|
: ffi::WGPUIndexFormat_Uint16;
|
|
ffi::wgpu_render_pass_set_index_buffer(mPass, aBuffer.mId, iformat, aOffset,
|
|
aSize);
|
|
}
|
|
}
|
|
|
|
void RenderPassEncoder::SetVertexBuffer(uint32_t aSlot, const Buffer& aBuffer,
|
|
uint64_t aOffset, uint64_t aSize) {
|
|
if (mValid) {
|
|
mUsedBuffers.AppendElement(&aBuffer);
|
|
ffi::wgpu_render_pass_set_vertex_buffer(mPass, aSlot, aBuffer.mId, aOffset,
|
|
aSize);
|
|
}
|
|
}
|
|
|
|
void RenderPassEncoder::Draw(uint32_t aVertexCount, uint32_t aInstanceCount,
|
|
uint32_t aFirstVertex, uint32_t aFirstInstance) {
|
|
if (mValid) {
|
|
ffi::wgpu_render_pass_draw(mPass, aVertexCount, aInstanceCount,
|
|
aFirstVertex, aFirstInstance);
|
|
}
|
|
}
|
|
|
|
void RenderPassEncoder::DrawIndexed(uint32_t aIndexCount,
|
|
uint32_t aInstanceCount,
|
|
uint32_t aFirstIndex, int32_t aBaseVertex,
|
|
uint32_t aFirstInstance) {
|
|
if (mValid) {
|
|
ffi::wgpu_render_pass_draw_indexed(mPass, aIndexCount, aInstanceCount,
|
|
aFirstIndex, aBaseVertex,
|
|
aFirstInstance);
|
|
}
|
|
}
|
|
|
|
void RenderPassEncoder::DrawIndirect(const Buffer& aIndirectBuffer,
|
|
uint64_t aIndirectOffset) {
|
|
if (mValid) {
|
|
ffi::wgpu_render_pass_draw_indirect(mPass, aIndirectBuffer.mId,
|
|
aIndirectOffset);
|
|
}
|
|
}
|
|
|
|
void RenderPassEncoder::DrawIndexedIndirect(const Buffer& aIndirectBuffer,
|
|
uint64_t aIndirectOffset) {
|
|
if (mValid) {
|
|
ffi::wgpu_render_pass_draw_indexed_indirect(mPass, aIndirectBuffer.mId,
|
|
aIndirectOffset);
|
|
}
|
|
}
|
|
|
|
void RenderPassEncoder::SetViewport(float x, float y, float width, float height,
|
|
float minDepth, float maxDepth) {
|
|
if (mValid) {
|
|
ffi::wgpu_render_pass_set_viewport(mPass, x, y, width, height, minDepth,
|
|
maxDepth);
|
|
}
|
|
}
|
|
|
|
void RenderPassEncoder::SetScissorRect(uint32_t x, uint32_t y, uint32_t width,
|
|
uint32_t height) {
|
|
if (mValid) {
|
|
ffi::wgpu_render_pass_set_scissor_rect(mPass, x, y, width, height);
|
|
}
|
|
}
|
|
|
|
void RenderPassEncoder::SetBlendConstant(
|
|
const dom::DoubleSequenceOrGPUColorDict& color) {
|
|
if (mValid) {
|
|
ffi::WGPUColor aColor = ConvertColor(color.GetAsGPUColorDict());
|
|
ffi::wgpu_render_pass_set_blend_constant(mPass, &aColor);
|
|
}
|
|
}
|
|
|
|
void RenderPassEncoder::SetStencilReference(uint32_t reference) {
|
|
if (mValid) {
|
|
ffi::wgpu_render_pass_set_stencil_reference(mPass, reference);
|
|
}
|
|
}
|
|
|
|
void RenderPassEncoder::ExecuteBundles(
|
|
const dom::Sequence<OwningNonNull<RenderBundle>>& aBundles) {
|
|
if (mValid) {
|
|
nsTArray<ffi::WGPURenderBundleId> renderBundles(aBundles.Length());
|
|
for (const auto& bundle : aBundles) {
|
|
mUsedRenderBundles.AppendElement(bundle);
|
|
renderBundles.AppendElement(bundle->mId);
|
|
}
|
|
ffi::wgpu_render_pass_execute_bundles(mPass, renderBundles.Elements(),
|
|
renderBundles.Length());
|
|
}
|
|
}
|
|
|
|
void RenderPassEncoder::PushDebugGroup(const nsAString& aString) {
|
|
if (mValid) {
|
|
const NS_ConvertUTF16toUTF8 utf8(aString);
|
|
ffi::wgpu_render_pass_push_debug_group(mPass, utf8.get(), 0);
|
|
}
|
|
}
|
|
void RenderPassEncoder::PopDebugGroup() {
|
|
if (mValid) {
|
|
ffi::wgpu_render_pass_pop_debug_group(mPass);
|
|
}
|
|
}
|
|
void RenderPassEncoder::InsertDebugMarker(const nsAString& aString) {
|
|
if (mValid) {
|
|
const NS_ConvertUTF16toUTF8 utf8(aString);
|
|
ffi::wgpu_render_pass_insert_debug_marker(mPass, utf8.get(), 0);
|
|
}
|
|
}
|
|
|
|
void RenderPassEncoder::EndPass(ErrorResult& aRv) {
|
|
if (mValid) {
|
|
mValid = false;
|
|
auto* pass = mPass.forget();
|
|
MOZ_ASSERT(pass);
|
|
mParent->EndRenderPass(*pass, aRv);
|
|
}
|
|
}
|
|
|
|
} // namespace mozilla::webgpu
|