WebGLRenderingContext.viewport()
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
(en-US) indiquant la coordonnée horizontale du coin inférieur gauche de l'origine du viewport. Valeur par défaut : 0. y
-
Un
GLint
(en-US) indiquant la coordonnée verticale du coin inférieur gauche de l'origine du viewport. Valeur par défaut : 0. - largeur
-
Un
Glsizei
(en-US) non négatif indiquant la largeur du viewport. Valeur par défaut : la largeur du canevas. - height
-
Un
Glsizei
(en-US) 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