WebGLRenderingContext.viewport()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

La méthode WebGLRenderingContext.viewport() de l'API WebGL définit le viewport, qui indique la transformation affine de x et de y, de coordonnées d'appareil normalisées en coordonnées de fenêtre.

Syntaxe

js
void gl.viewport(x, y, largeur, hauteur);

Paramètres

x

Un GLint indiquant la coordonnée horizontale du coin inférieur gauche de l'origine du viewport. Valeur par défaut : 0.

y

Un GLint indiquant la coordonnée verticale du coin inférieur gauche de l'origine du viewport. Valeur par défaut : 0.

largeur

Un Glsizei non négatif indiquant la largeur du viewport. Valeur par défaut : la largeur du canevas.

height

Un Glsizei non négatif indiquant la hauteur du viewport. Valeur par défaut : la hauteur du canevas.

Valeur retournée

Aucune.

Erreurs déclenchées

Si largeur ou hauteur est une valeur négative, une erreur gl.INVALID_VALUE est déclenchée.

Exemples

Lorsque vous créez un contexte WebGL pour la première fois, la taille de la fenêtre correspondra à celle du canevas. Toutefois, si vous redimensionnez le canevas, vous devrez indiquer au contexte de WebGL une nouvelle définition de viewport. Dans cette situation, vous pouvez utiliser gl.viewport.

js
gl.viewport(0, 0, canevas.width, canevas.height);

La largeur et la hauteur de la fenêtre sont limitées à une plage dépendante de l'implémentation. Pour obtenir cette plage, vous pouvez utiliser la constante MAX_VIEWPORT_DIMS, qui renvoie un Int32Array.

js
gl.getParameter(gl.MAX_VIEWPORT_DIMS);
// Par ex., Int32Array[16384, 16384]

Pour obtenir le viewport en cours, faites une requête sur la constante VIEWPORT.

js
gl.getParameter(gl.VIEWPORT);
// e.g. Int32Array[0, 0, 640, 480]

Spécifications

Specification
WebGL Specification
# 5.14.4

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi