diff options
author | julieng <julien.gattelier@gmail.com> | 2021-10-02 17:20:24 +0200 |
---|---|---|
committer | SphinxKnight <SphinxKnight@users.noreply.github.com> | 2021-10-02 17:30:20 +0200 |
commit | 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde (patch) | |
tree | 30a56efd3eff3a01bd1611e1840fdbbfacf544a4 /files/fr/web/api/webglrenderingcontext/viewport | |
parent | c05efa8d7ae464235cf83d7c0956e42dc6974103 (diff) | |
download | translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.gz translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.tar.bz2 translated-content-1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde.zip |
convert content to md
Diffstat (limited to 'files/fr/web/api/webglrenderingcontext/viewport')
-rw-r--r-- | files/fr/web/api/webglrenderingcontext/viewport/index.md | 109 |
1 files changed, 46 insertions, 63 deletions
diff --git a/files/fr/web/api/webglrenderingcontext/viewport/index.md b/files/fr/web/api/webglrenderingcontext/viewport/index.md index 76290a9bd6..beed6333a7 100644 --- a/files/fr/web/api/webglrenderingcontext/viewport/index.md +++ b/files/fr/web/api/webglrenderingcontext/viewport/index.md @@ -9,84 +9,67 @@ tags: - WebGLRenderingContext translation_of: Web/API/WebGLRenderingContext/viewport --- -<div>{{APIRef("WebGL")}}</div> +{{APIRef("WebGL")}} -<p>La méthode <strong><code>WebGLRenderingContext.viewport()</code></strong> de l'<a href="/fr-FR/docs/Web/API/WebGL_API">API WebGL</a> 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.</p> +La méthode **`WebGLRenderingContext.viewport()`** de l'[API WebGL](/fr-FR/docs/Web/API/WebGL_API) 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. -<h2 id="Syntaxe">Syntaxe</h2> +## Syntaxe -<pre class="syntaxbox"><var><em>void gl</em>.viewport</var><var>(x, y, largeur, hauteur);</var> -</pre> + void gl.viewport(x, y, largeur, hauteur); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<dl> - <dt><code>x</code></dt> - <dd>Un {{domxref("GLint")}} indiquant la coordonnée horizontale du coin inférieur gauche de l'origine du viewport. Valeur par défaut : 0.</dd> - <dt><code>y</code></dt> - <dd>Un {{domxref("GLint")}} indiquant la coordonnée verticale du coin inférieur gauche de l'origine du viewport. Valeur par défaut : 0.</dd> - <dt>largeur</dt> - <dd>Un {{domxref("Glsizei")}} non négatif indiquant la largeur du viewport. Valeur par défaut : la largeur du canevas.</dd> - <dt>height</dt> - <dd>Un {{domxref("Glsizei")}} non négatif indiquant la hauteur du viewport. Valeur par défaut : la hauteur du canevas.</dd> -</dl> +- `x` + - : Un {{domxref("GLint")}} indiquant la coordonnée horizontale du coin inférieur gauche de l'origine du viewport. Valeur par défaut : 0. +- `y` + - : Un {{domxref("GLint")}} indiquant la coordonnée verticale du coin inférieur gauche de l'origine du viewport. Valeur par défaut : 0. +- largeur + - : Un {{domxref("Glsizei")}} non négatif indiquant la largeur du viewport. Valeur par défaut : la largeur du canevas. +- height + - : Un {{domxref("Glsizei")}} non négatif indiquant la hauteur du viewport. Valeur par défaut : la hauteur du canevas. -<h3 id="Valeur_retournée">Valeur retournée</h3> +### Valeur retournée -<p>Aucune.</p> +Aucune. -<h3 id="Erreurs_déclenchées">Erreurs déclenchées</h3> +### Erreurs déclenchées -<p>Si <em>largeur</em> ou <em>hauteur</em> est une valeur négative, une erreur <code>gl.INVALID_VALUE</code> est déclenchée.</p> +Si *largeur* ou *hauteur* est une valeur négative, une erreur `gl.INVALID_VALUE` est déclenchée. -<h2 id="Exemples">Exemples</h2> +## Exemples -<p>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 <code>gl.viewport</code>.</p> +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`. -<pre class="brush: js">gl.viewport(0, 0, canevas.width, canevas.height); -</pre> +```js +gl.viewport(0, 0, canevas.width, canevas.height); +``` -<p>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 <code>MAX_VIEWPORT_DIMS</code>, qui renvoie un {{jsxref ("Int32Array")}}.</p> +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 {{jsxref ("Int32Array")}}. -<pre class="brush: js">gl.getParameter(gl.MAX_VIEWPORT_DIMS); +```js +gl.getParameter(gl.MAX_VIEWPORT_DIMS); // Par ex., Int32Array[16384, 16384] -</pre> +``` -<p>Pour obtenir le viewport en cours, faites une requête sur la constante <code>VIEWPORT</code>.</p> +Pour obtenir le viewport en cours, faites une requête sur la constante `VIEWPORT`. -<pre class="brush: js">gl.getParameter(gl.VIEWPORT); +```js +gl.getParameter(gl.VIEWPORT); // e.g. Int32Array[0, 0, 640, 480] -</pre> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('WebGL', "#5.14.4", "viewport")}}</td> - <td>{{Spec2('WebGL')}}</td> - <td>Définition initiale.</td> - </tr> - <tr> - <td>{{SpecName('OpenGL ES 2.0', "glViewport.xml", "glViewport")}}</td> - <td>{{Spec2('OpenGL ES 2.0')}}</td> - <td>Page man de l'API OpenGL.</td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.WebGLRenderingContext.viewport")}}</p> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{domxref("WebGLRenderingContext.scissor()")}}</li> - <li>{{domxref("WebGLRenderingContext.getParameter()")}}</li> -</ul> +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------- | ------------------------------------ | ------------------------- | +| {{SpecName('WebGL', "#5.14.4", "viewport")}} | {{Spec2('WebGL')}} | Définition initiale. | +| {{SpecName('OpenGL ES 2.0', "glViewport.xml", "glViewport")}} | {{Spec2('OpenGL ES 2.0')}} | Page man de l'API OpenGL. | + +## Compatibilité des navigateurs + +{{Compat("api.WebGLRenderingContext.viewport")}} + +## Voir aussi + +- {{domxref("WebGLRenderingContext.scissor()")}} +- {{domxref("WebGLRenderingContext.getParameter()")}} |