GPUCommandEncoder: clearBuffer() method

Cú pháp

clearBuffer(buffer)
clearBuffer(buffer, offset)
clearBuffer(buffer, offset, size)

Tham số

buffer

Một đối tượng GPUBuffer đại diện cho buffer cần xóa.

offset Optional

Một số biểu diễn độ lệch, tính bằng byte, từ đầu buffer đến vùng con cần xóa. Nếu bỏ qua, offset mặc định là 0.

size Optional

Một số biểu diễn kích thước, tính bằng byte, của vùng con cần xóa. Nếu bỏ qua, size mặc định là kích thước buffer trừ offset.

Giá trị trả về

Không có (Undefined).

Kiểm tra hợp lệ

Các tiêu chí sau phải được đáp ứng khi gọi clearBuffer(), nếu không một GPUValidationError sẽ được tạo và GPUCommandEncoder trở nên không hợp lệ:

• usage của buffer bao gồm cờ GPUBufferUsage.COPY_DST.
• offset và size đều là bội số của 4.
• GPUBuffer.size của buffer lớn hơn hoặc bằng offset + size.

Ví dụ

// …

const buffer = device.createBuffer({
  size: 1000,
  usage: GPUBufferUsage.MAP_READ | GPUBufferUsage.COPY_DST,
});

// Sau đó

const commandBuffer = device.createCommandEncoder();
commandEncoder.clearBuffer(buffer);

// …

Thông số kỹ thuật

Tương thích trình duyệt

Xem thêm

• WebGPU API