WebGLRenderingContext.viewport()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 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
void gl.viewport(x, y, largeur, hauteur);
Paramètres
x-
Un
GLintindiquant la coordonnée horizontale du coin inférieur gauche de l'origine du viewport. Valeur par défaut : 0. y-
Un
GLintindiquant la coordonnée verticale du coin inférieur gauche de l'origine du viewport. Valeur par défaut : 0. - largeur
-
Un
Glsizeinon négatif indiquant la largeur du viewport. Valeur par défaut : la largeur du canevas. - height
-
Un
Glsizeinon 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.
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.
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.
gl.getParameter(gl.VIEWPORT);
// e.g. Int32Array[0, 0, 640, 480]
Spécifications
| Specification |
|---|
| WebGL Specification # 5.14.4 |
Compatibilité des navigateurs
Chargement…