1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177
|
// Copyright 2018 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef GPU_COMMAND_BUFFER_CLIENT_WEBGPU_INTERFACE_H_
#define GPU_COMMAND_BUFFER_CLIENT_WEBGPU_INTERFACE_H_
#include <dawn/dawn_proc_table.h>
#include <dawn/webgpu.h>
#include "base/functional/callback.h"
#include "base/types/cxx23_to_underlying.h"
#include "gpu/command_buffer/client/interface_base.h"
#include "gpu/command_buffer/common/webgpu_cmd_enums.h"
#include "gpu/command_buffer/common/webgpu_cmd_ids.h"
#include "third_party/blink/public/common/tokens/tokens.h"
namespace gpu {
struct Mailbox;
namespace webgpu {
struct ReservedBuffer {
WGPUBuffer buffer;
uint32_t id;
uint32_t generation;
uint32_t deviceId;
uint32_t deviceGeneration;
};
struct ReservedTexture {
WGPUTexture texture;
uint32_t id;
uint32_t generation;
uint32_t deviceId;
uint32_t deviceGeneration;
};
// APIChannel is a RefCounted class which holds the Dawn wire client.
class APIChannel : public base::RefCounted<APIChannel> {
public:
// Get the WGPUInstance.
virtual WGPUInstance GetWGPUInstance() const = 0;
// Disconnect. All commands using the WebGPU API should become a
// no-op and server-side resources can be freed.
virtual void Disconnect() = 0;
protected:
friend class base::RefCounted<APIChannel>;
APIChannel() = default;
virtual ~APIChannel() = default;
};
class WebGPUInterface : public InterfaceBase {
public:
WebGPUInterface() = default;
virtual ~WebGPUInterface() = default;
// Flush all commands.
virtual void FlushCommands() = 0;
// Ensure the awaiting flush flag is set on the device client. Returns false
// if a flush has already been indicated, or a flush is not needed (there may
// be no commands to flush). Returns true if the caller should schedule a
// flush.
virtual bool EnsureAwaitingFlush() = 0;
// If the awaiting flush flag is set, flushes commands. Otherwise, does
// nothing.
virtual void FlushAwaitingCommands() = 0;
// Get a strong reference to the APIChannel backing the implementation.
virtual scoped_refptr<APIChannel> GetAPIChannel() const = 0;
virtual ReservedBuffer ReserveBuffer(
WGPUDevice device,
const WGPUBufferDescriptor* optionalDesc = nullptr) = 0;
virtual ReservedTexture ReserveTexture(
WGPUDevice device,
const WGPUTextureDescriptor* optionalDesc = nullptr) = 0;
// Gets or creates a usable WGPUDevice synchronously. It really should not
// be used, and the async request adapter and request device APIs should be
// used instead.
virtual WGPUDevice DeprecatedEnsureDefaultDeviceSync() = 0;
// Include the auto-generated part of this class. We split this because
// it means we can easily edit the non-auto generated parts right here in
// this file instead of having to edit some template or the code generator.
#include "gpu/command_buffer/client/webgpu_interface_autogen.h"
// NOTE: Passing WEBGPU_MAILBOX_DISCARD is only valid if the SharedImage
// associated with `mailbox` has been created with
// SHARED_IMAGE_USAGE_WEBGPU_WRITE and at least one of `usage` or
// `internal_usage` contains a usage supporting lazy clearing (CopyDst or
// RenderAttachment).
virtual void AssociateMailbox(GLuint device_id,
GLuint device_generation,
GLuint id,
GLuint generation,
uint64_t usage,
uint64_t internal_usage,
const WGPUTextureFormat* view_formats,
GLuint view_format_count,
MailboxFlags flags,
const Mailbox& mailbox) = 0;
void AssociateMailbox(GLuint device_id,
GLuint device_generation,
GLuint id,
GLuint generation,
uint64_t usage,
const WGPUTextureFormat* view_formats,
GLuint view_format_count,
MailboxFlags flags,
const Mailbox& mailbox) {
AssociateMailbox(device_id, device_generation, id, generation, usage, 0,
view_formats, view_format_count, flags, mailbox);
}
void AssociateMailbox(GLuint device_id,
GLuint device_generation,
GLuint id,
GLuint generation,
uint64_t usage,
MailboxFlags flags,
const Mailbox& mailbox) {
AssociateMailbox(device_id, device_generation, id, generation, usage, 0,
nullptr, 0, flags, mailbox);
}
void AssociateMailbox(GLuint device_id,
GLuint device_generation,
GLuint id,
GLuint generation,
uint64_t usage,
uint64_t internal_usage,
MailboxFlags flags,
const Mailbox& mailbox) {
AssociateMailbox(device_id, device_generation, id, generation, usage,
internal_usage, nullptr, 0, flags, mailbox);
}
void AssociateMailbox(GLuint device_id,
GLuint device_generation,
GLuint id,
GLuint generation,
uint64_t usage,
const Mailbox& mailbox) {
AssociateMailbox(device_id, device_generation, id, generation, usage, 0,
nullptr, 0, WEBGPU_MAILBOX_NONE, mailbox);
}
virtual void AssociateMailboxForBuffer(GLuint device_id,
GLuint device_generation,
GLuint id,
GLuint generation,
uint64_t usage,
const Mailbox& mailbox) = 0;
void SetWebGPUExecutionContextToken(
const blink::WebGPUExecutionContextToken& token) {
uint64_t high = token.value().GetHighForSerialization();
uint64_t low = token.value().GetLowForSerialization();
SetWebGPUExecutionContextToken(base::to_underlying(token.variant_index()),
high >> 32, high & 0xFFFFFFFF, low >> 32,
low & 0xFFFFFFFF);
}
};
} // namespace webgpu
} // namespace gpu
#endif // GPU_COMMAND_BUFFER_CLIENT_WEBGPU_INTERFACE_H_
|