From c05efa8d7ae464235cf83d7c0956e42dc6974103 Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:14 +0200 Subject: move *.html to *.md --- .../getuniformlocation/index.html | 142 --------------------- .../getuniformlocation/index.md | 142 +++++++++++++++++++++ 2 files changed, 142 insertions(+), 142 deletions(-) delete mode 100644 files/fr/web/api/webglrenderingcontext/getuniformlocation/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/getuniformlocation/index.md (limited to 'files/fr/web/api/webglrenderingcontext/getuniformlocation') diff --git a/files/fr/web/api/webglrenderingcontext/getuniformlocation/index.html b/files/fr/web/api/webglrenderingcontext/getuniformlocation/index.html deleted file mode 100644 index 89393bd4f7..0000000000 --- a/files/fr/web/api/webglrenderingcontext/getuniformlocation/index.html +++ /dev/null @@ -1,142 +0,0 @@ ---- -title: WebGLRenderingContext.getUniformLocation() -slug: Web/API/WebGLRenderingContext/getUniformLocation -tags: - - API - - Méthode - - Reference - - Uniform Variables - - Uniforms - - Variables - - Variables en WebGL - - WebGL - - WebGLRenderingContext - - getUniformLocation -translation_of: Web/API/WebGLRenderingContext/getUniformLocation ---- -
{{APIRef("WebGL")}}
- -
Faisant partie de l'API WebGL, la méthode {{domxref("WebGLRenderingContext")}} getUniformLocation() retourne l'emplacement d'une variable uniform particulière appartenant au {{domxref ("WebGLProgram")}} indiqué. La variable uniform est retournée sous la forme d'un objet {{domxref("WebGLUniformLocation")}}, qui est un identificateur opaque utilisé pour indiquer où se trouve la variable uniform dans la mémoire de la GPU.
- -
 
- -
Une fois que vous avez l'emplacement de l'uniform, vous pouvez accéder à l'uniform lui-même en utilisant l'une des autres méthodes d'accès uniform, en passant l'emplacement de l'uniform comme l'une des entrées :
- -
 
- -
-
{{domxref ("WebGLRenderingContext.getUniform", "getUniform()")}}
-
Retourne la valeur de l'uniform à l'emplacement indiqué.
-

- {{domxref ("WebGLRenderingContext.uniform", "uniform[1234] [fi] [v]()")}}
-
Affecte à la valeur de l'uniform la valeur spécifiée, qui peut être un nombre flottant ou entier unique, ou un vecteur de 2 à 4 composantes spécifié soit comme une liste de valeurs, soit comme un {{jsxref ("Float32Array")}} ou un {{ jsxref ("Int32Array")}}.
-

- {{domxref ("WebGLRenderingContext.uniformMatrix", "uniformMatrix[234][fv]()")}}
-
Affecte à la valeur de l'uniforme la matrice spécifiée, éventuellement avec transposition. La valeur est représentée comme une suite de valeurs GLfloat ou comme un Float32Array.
-
- -


- L'uniform lui-même est déclaré dans le programme shader en utilisant GLSL.

- -

Syntaxe

- -
WebGLUniformLocation = WebGLRenderingContext.getUniformLocation(programme, nom);
-
- -

Paramètres

- -
-
programme
-
Le {{domxref ("WebGLProgram")}} dans lequel localiser la variable uniform indiquée.
-
nom
-
Une {{domxref ("DOMString")}} indiquant le nom de la variable uniform dont l'emplacement doit être retourné. Le nom ne peut contenir aucun espace, et vous ne pouvez pas utiliser cette fonction pour obtenir l'emplacement d'aucun uniform commençant par la chaîne réservée "gl_", du fait que ceux-ci sont internes à la couche WebGL.
-
- -

Valeur retournée

- -

Une valeur {{domxref ("WebGLUniformLocation")}} indiquant l'emplacement de la variable nommée, si elle existe. Si la variable indiquée n'existe pas, {{jsxref("null")}} est retourné à la place.

- -

WebGLUniformLocation est une valeur opaque utilisée pour identifier de manière unique l'emplacement dans la mémoire de la GPU auquel se trouve la variable uniform. Avec cette valeur en main, vous pouvez appeler d'autres méthodes WebGL pour accéder à la valeur de la variable uniform.

- -
-

Note : Le type WebGLUniformLocation est compatible avec le type GLint pour indiquer l'indice ou l'emplacement d'un attribut uniform.

-
- -

Erreurs

- -

Les erreurs suivantes peuvent se produire ; pour vérifier les erreurs après le retour de getUniformLocation(), appelez {{domxref ("WebGLRenderingContext.getError", "getError()")}}.

- -
-
GL_INVALID_VALUE
-
Le paramètre programme n'est pas une valeur ou un objet généré par WebGL.
-
GL_INVALID_OPERATION
-
Le paramètre programme ne correspond pas à un programme GLSL généré par WebGL, ou le programme indiqué n'a pas été lié avec succès.
-
- -

Exemple

- -

Dans cet exemple, extrait de la méthode animateScene() dans l'article Un exemple d'animation 2D WebGL de base, retrouve les emplacements de trois uniforms du programme d'ombrage, puis définit la valeur de chacun des trois uniforms.

- -
gl.useProgram(programmeShader);
-
-uScalingFactor =
-    gl.getUniformLocation(programmeShader, "uScalingFactor");
-uGlobalColor =
-    gl.getUniformLocation(programmeShader, "uGlobalColor");
-uRotationVector =
-    gl.getUniformLocation(programmeShader, "uRotationVector")
-
-gl.uniform2fv(uScalingFactor, currentScale);
-gl.uniform2fv(uRotationVector, currentRotation);
-gl.uniform4fv(uGlobalColor, [0.1, 0.7, 0.2, 1.0]);
- -
-

Note : Cet extrait de code provient de la fonction animateScene() dans "Un exemple d'animation WebGL 2D de base". Voir cet article pour l'exemple complet et pour voir l'animation résultante en action.

-
- -

Après avoir défini le programme d'ombrage en cours comme programmeShader, ce code récupère les trois uniforms "uScalingFactor", "uGlobalColor" et "uRotationVector", en appelant getUniformLocation() une fois pour chaque uniform.

- -

Ensuite, les valeurs des trois uniforms sont définies :

- - - -

Cela fait, la prochaine fois que les fonctions d'ombrage seront appelées, leurs propres variables nommées uScalingFactor, uGlobalColor et uRotationVector auront toutes les valeurs fournies par le code JavaScript.

- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.10", "getUniformLocation")}}{{Spec2('WebGL')}} -

Définition initiale.

-
{{SpecName('OpenGL ES 2.0', "glGetUniformLocation.xml", "glGetUniformLocation")}}{{Spec2('OpenGL ES 2.0')}}Page man de l’API OpenGL.
- -

Compatibilité des navigateurs

- -

{{Compat("api.WebGLRenderingContext.getUniformLocation")}}

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/getuniformlocation/index.md b/files/fr/web/api/webglrenderingcontext/getuniformlocation/index.md new file mode 100644 index 0000000000..89393bd4f7 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/getuniformlocation/index.md @@ -0,0 +1,142 @@ +--- +title: WebGLRenderingContext.getUniformLocation() +slug: Web/API/WebGLRenderingContext/getUniformLocation +tags: + - API + - Méthode + - Reference + - Uniform Variables + - Uniforms + - Variables + - Variables en WebGL + - WebGL + - WebGLRenderingContext + - getUniformLocation +translation_of: Web/API/WebGLRenderingContext/getUniformLocation +--- +
{{APIRef("WebGL")}}
+ +
Faisant partie de l'API WebGL, la méthode {{domxref("WebGLRenderingContext")}} getUniformLocation() retourne l'emplacement d'une variable uniform particulière appartenant au {{domxref ("WebGLProgram")}} indiqué. La variable uniform est retournée sous la forme d'un objet {{domxref("WebGLUniformLocation")}}, qui est un identificateur opaque utilisé pour indiquer où se trouve la variable uniform dans la mémoire de la GPU.
+ +
 
+ +
Une fois que vous avez l'emplacement de l'uniform, vous pouvez accéder à l'uniform lui-même en utilisant l'une des autres méthodes d'accès uniform, en passant l'emplacement de l'uniform comme l'une des entrées :
+ +
 
+ +
+
{{domxref ("WebGLRenderingContext.getUniform", "getUniform()")}}
+
Retourne la valeur de l'uniform à l'emplacement indiqué.
+

+ {{domxref ("WebGLRenderingContext.uniform", "uniform[1234] [fi] [v]()")}}
+
Affecte à la valeur de l'uniform la valeur spécifiée, qui peut être un nombre flottant ou entier unique, ou un vecteur de 2 à 4 composantes spécifié soit comme une liste de valeurs, soit comme un {{jsxref ("Float32Array")}} ou un {{ jsxref ("Int32Array")}}.
+

+ {{domxref ("WebGLRenderingContext.uniformMatrix", "uniformMatrix[234][fv]()")}}
+
Affecte à la valeur de l'uniforme la matrice spécifiée, éventuellement avec transposition. La valeur est représentée comme une suite de valeurs GLfloat ou comme un Float32Array.
+
+ +


+ L'uniform lui-même est déclaré dans le programme shader en utilisant GLSL.

+ +

Syntaxe

+ +
WebGLUniformLocation = WebGLRenderingContext.getUniformLocation(programme, nom);
+
+ +

Paramètres

+ +
+
programme
+
Le {{domxref ("WebGLProgram")}} dans lequel localiser la variable uniform indiquée.
+
nom
+
Une {{domxref ("DOMString")}} indiquant le nom de la variable uniform dont l'emplacement doit être retourné. Le nom ne peut contenir aucun espace, et vous ne pouvez pas utiliser cette fonction pour obtenir l'emplacement d'aucun uniform commençant par la chaîne réservée "gl_", du fait que ceux-ci sont internes à la couche WebGL.
+
+ +

Valeur retournée

+ +

Une valeur {{domxref ("WebGLUniformLocation")}} indiquant l'emplacement de la variable nommée, si elle existe. Si la variable indiquée n'existe pas, {{jsxref("null")}} est retourné à la place.

+ +

WebGLUniformLocation est une valeur opaque utilisée pour identifier de manière unique l'emplacement dans la mémoire de la GPU auquel se trouve la variable uniform. Avec cette valeur en main, vous pouvez appeler d'autres méthodes WebGL pour accéder à la valeur de la variable uniform.

+ +
+

Note : Le type WebGLUniformLocation est compatible avec le type GLint pour indiquer l'indice ou l'emplacement d'un attribut uniform.

+
+ +

Erreurs

+ +

Les erreurs suivantes peuvent se produire ; pour vérifier les erreurs après le retour de getUniformLocation(), appelez {{domxref ("WebGLRenderingContext.getError", "getError()")}}.

+ +
+
GL_INVALID_VALUE
+
Le paramètre programme n'est pas une valeur ou un objet généré par WebGL.
+
GL_INVALID_OPERATION
+
Le paramètre programme ne correspond pas à un programme GLSL généré par WebGL, ou le programme indiqué n'a pas été lié avec succès.
+
+ +

Exemple

+ +

Dans cet exemple, extrait de la méthode animateScene() dans l'article Un exemple d'animation 2D WebGL de base, retrouve les emplacements de trois uniforms du programme d'ombrage, puis définit la valeur de chacun des trois uniforms.

+ +
gl.useProgram(programmeShader);
+
+uScalingFactor =
+    gl.getUniformLocation(programmeShader, "uScalingFactor");
+uGlobalColor =
+    gl.getUniformLocation(programmeShader, "uGlobalColor");
+uRotationVector =
+    gl.getUniformLocation(programmeShader, "uRotationVector")
+
+gl.uniform2fv(uScalingFactor, currentScale);
+gl.uniform2fv(uRotationVector, currentRotation);
+gl.uniform4fv(uGlobalColor, [0.1, 0.7, 0.2, 1.0]);
+ +
+

Note : Cet extrait de code provient de la fonction animateScene() dans "Un exemple d'animation WebGL 2D de base". Voir cet article pour l'exemple complet et pour voir l'animation résultante en action.

+
+ +

Après avoir défini le programme d'ombrage en cours comme programmeShader, ce code récupère les trois uniforms "uScalingFactor", "uGlobalColor" et "uRotationVector", en appelant getUniformLocation() une fois pour chaque uniform.

+ +

Ensuite, les valeurs des trois uniforms sont définies :

+ + + +

Cela fait, la prochaine fois que les fonctions d'ombrage seront appelées, leurs propres variables nommées uScalingFactor, uGlobalColor et uRotationVector auront toutes les valeurs fournies par le code JavaScript.

+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.10", "getUniformLocation")}}{{Spec2('WebGL')}} +

Définition initiale.

+
{{SpecName('OpenGL ES 2.0', "glGetUniformLocation.xml", "glGetUniformLocation")}}{{Spec2('OpenGL ES 2.0')}}Page man de l’API OpenGL.
+ +

Compatibilité des navigateurs

+ +

{{Compat("api.WebGLRenderingContext.getUniformLocation")}}

+ +

Voir aussi

+ + -- cgit v1.2.3-54-g00ecf