Esta página ha sido traducida del inglés por la comunidad. Aprende más y únete a la comunidad de MDN Web Docs.

View in English Always switch to English

GPU: Método getPreferredCanvasFormat()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Contexto seguro: Esta función está disponible solo en contextos seguros (HTTPS), en algunos o todos los navegadores que lo soportan.

Nota: Esta característica está disponible en Web Workers.

El método getPreferredCanvasFormat() de la interfaz GPU devuelve el formato óptimo de textura para el canvas para renderizar contenido de 8 bits y rango dinámico estándar en el sistema actual.

Esto es comúnmente usado para proporcionar una llamada a GPUCanvasContext.configure() con el valor de format óptimo para el sistema actual. Esto es recomendable, si no usas el formato preferido al configurar el contexto del canvas, es posible que incurras en gastos innecesarios, como copias de texturas adicionales, dependiendo de la plataforma.

Sintaxis

js
getPreferredCanvasFormat()

Parámetros

Ninguno.

Valor devuelto

Una cadena de texto indicando un formato de textura del canvas. El valor puede ser rgba8unorm o bgra8unorm.

Excepciones

Ninguna.

Ejemplos

js
const canvas = document.querySelector("#gpuCanvas");
const context = canvas.getContext("webgpu");

context.configure({
  device,
  format: navigator.gpu.getPreferredCanvasFormat(),
  alphaMode: "premultiplied",
});

Especificaciones

Specification
WebGPU
# dom-gpu-getpreferredcanvasformat

Compatibilidad con navegadores

Véase también