GPUAdapter that the device was created from.
GPUDevice for the test to use.
GPUDevice for tests requiring a second device different from the default one, e.g. for creating objects for by device_mismatch validation tests.
Returns the (case+subcase) parameters for this test function invocation.
GPUQueue for the test to use. (Same as t.device.queue.)
Gets the test fixture's shared state. This object is shared between subcases within the same testcase.
Emulate a texture to buffer copy by using a compute shader to load texture values of a subregion of a 2d texture and write to a storage buffer. For sample count == 1, the buffer contains extent[0] * extent[1] of the sample. For sample count > 1, the buffer contains extent[0] * extent[1] * (N = sampleCount) values sorted in the order of their sample index [0, sampleCount - 1]
This can be useful when the texture to buffer copy is not available to the texture format e.g. (depth24plus), or when the texture is multisampled.
MAINTENANCE_TODO: extend texture dimension to 1d and 3d.
storage buffer containing the copied value from the texture.
Creates a texture when all that is needed is an aligned texture given the format and desired dimensions/origin. The resultant texture guarantees that a copy with the same size and origin should be possible.
Create a GPUTexture in the specified state. A descriptor may optionally be passed;
if state is 'invalid', it will be modified to add an invalid combination of usages.
Optional descriptor: Readonly<GPUBufferDescriptor>Returns a GPUCommandEncoder, GPUComputePassEncoder, GPURenderPassEncoder, or
GPURenderBundleEncoder, and a finish method returning a GPUCommandBuffer.
Allows testing methods which have the same signature across multiple encoder interfaces.
Optional attachmentOptional occlusiong.test('popDebugGroup')
.params(u => u.combine('encoderType', kEncoderTypes))
.fn(t => {
const { encoder, finish } = t.createEncoder(t.params.encoderType);
encoder.popDebugGroup();
});
g.test('writeTimestamp')
.params(u => u.combine('encoderType', ['non-pass', 'compute pass', 'render pass'] as const)
.fn(t => {
const { encoder, finish } = t.createEncoder(t.params.encoderType);
// Encoder type is inferred, so `writeTimestamp` can be used even though it doesn't exist
// on GPURenderBundleEncoder.
encoder.writeTimestamp(args);
});
Helper for testing createComputePipeline(Async) validation
Expect a buffer to consist exclusively of rows of some repeated expected value. The size of
expectedValue must be 1, 2, or any multiple of 4 bytes. Rows in the buffer are expected to be
zero-padded out to bytesPerRow. minBytesPerRow is the number of bytes per row that contain
actual (non-padding) data and must be an exact multiple of the byte-length of expectedValue.
Expect a GPUBuffer's contents to equal the values in the provided TypedArray.
Optional method?: "map" | "copy"Optional mode?: "fail" | "warn"Expect a GPUBuffer's contents to pass the provided check.
A library of checks can be found in webgpu/util/check_contents.
Optional method?: "map" | "copy"Optional mode?: "fail" | "warn"Optional srcIf the argument is an Error, fail (or warn). If it's undefined, no-op.
If the argument is an array, apply the above behavior on each of elements.
Optional mode?: "fail" | "warn"Optional niceExpect an entire GPUTexture to have a single color at the given mip level (defaults to 0). MAINTENANCE_TODO: Remove this and/or replace it with a helper in TextureTestMixin.
Optional dimension?: GPUTextureDimensionOptional layout?: LayoutOptionsOptional slice?: numberTake a single pixel of a 2D texture, interpret it using a TypedArray of the expected type,
and expect each value in that array to be between the corresponding "expected" values
(either a[i] <= actual[i] <= b[i] or a[i] >= actual[i] => b[i]).
MAINTENANCE_TODO: Remove this once there is a way to deal with undefined lerp-ed values.
Optional checkOptional generateOptional layout?: LayoutOptionsOptional slice?: numberReturn an arbitrary object of the specified webgpu/capability_info!BindableResource type
(e.g. 'errorBuf', 'nonFiltSamp', sampledTexMS, etc.)
Readonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly maxReadonly minReadonly minCreate a GPUBuffer with the specified contents and usage.
MAINTENANCE_TODO: Several call sites would be simplified if this took ArrayBuffer as well.
Snapshot the current contents of a range of a GPUBuffer, and return them as a TypedArray. Also provides a cleanup() function to unmap and destroy the staging buffer.
Optional method?: "map" | "copy"Optional srcExpect that the provided promise rejects, with the provided exception name.
Expect that the provided function throws (if true or string) or not (if false).
If a string is provided, expect that the throw exception has that name.
MAINTENANCE_TODO: Change to string | false so the exception name is always checked.
Optional submit?: booleanIf submit is true, the validation error is expected to come from the submit and encoding should succeed.
Optional submit?: booleanIf submit is true, the validation error is expected to come from the submit and encoding should succeed.
Static MakeGenerated using TypeDoc
Base fixture for WebGPU validation tests.