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 --- .../webglrenderingcontext/activetexture/index.html | 85 ----- .../webglrenderingcontext/activetexture/index.md | 85 +++++ .../webglrenderingcontext/attachshader/index.html | 96 ------ .../webglrenderingcontext/attachshader/index.md | 96 ++++++ .../webglrenderingcontext/bindbuffer/index.html | 130 -------- .../api/webglrenderingcontext/bindbuffer/index.md | 130 ++++++++ .../webglrenderingcontext/bindtexture/index.html | 119 ------- .../api/webglrenderingcontext/bindtexture/index.md | 119 +++++++ .../webglrenderingcontext/bufferdata/index.html | 161 --------- .../api/webglrenderingcontext/bufferdata/index.md | 161 +++++++++ .../api/webglrenderingcontext/canvas/index.html | 74 ----- .../web/api/webglrenderingcontext/canvas/index.md | 74 +++++ .../web/api/webglrenderingcontext/clear/index.html | 93 ------ .../web/api/webglrenderingcontext/clear/index.md | 93 ++++++ .../webglrenderingcontext/compileshader/index.html | 85 ----- .../webglrenderingcontext/compileshader/index.md | 85 +++++ .../webglrenderingcontext/createbuffer/index.html | 75 ----- .../webglrenderingcontext/createbuffer/index.md | 75 +++++ .../webglrenderingcontext/createprogram/index.html | 85 ----- .../webglrenderingcontext/createprogram/index.md | 85 +++++ .../webglrenderingcontext/createshader/index.html | 85 ----- .../webglrenderingcontext/createshader/index.md | 85 +++++ .../webglrenderingcontext/createtexture/index.html | 76 ----- .../webglrenderingcontext/createtexture/index.md | 76 +++++ .../webglrenderingcontext/deletebuffer/index.html | 77 ----- .../webglrenderingcontext/deletebuffer/index.md | 77 +++++ .../webglrenderingcontext/deleteshader/index.html | 70 ---- .../webglrenderingcontext/deleteshader/index.md | 70 ++++ .../webglrenderingcontext/drawarrays/index.html | 99 ------ .../api/webglrenderingcontext/drawarrays/index.md | 99 ++++++ .../api/webglrenderingcontext/enable/index.html | 142 -------- .../web/api/webglrenderingcontext/enable/index.md | 142 ++++++++ .../enablevertexattribarray/index.html | 119 ------- .../enablevertexattribarray/index.md | 119 +++++++ .../generatemipmap/index.html | 91 ----- .../webglrenderingcontext/generatemipmap/index.md | 91 +++++ .../getattriblocation/index.html | 69 ---- .../getattriblocation/index.md | 69 ++++ .../api/webglrenderingcontext/geterror/index.html | 105 ------ .../api/webglrenderingcontext/geterror/index.md | 105 ++++++ .../getshaderparameter/index.html | 75 ----- .../getshaderparameter/index.md | 75 +++++ .../gettexparameter/index.html | 199 ----------- .../webglrenderingcontext/gettexparameter/index.md | 199 +++++++++++ .../getuniformlocation/index.html | 142 -------- .../getuniformlocation/index.md | 142 ++++++++ files/fr/web/api/webglrenderingcontext/index.html | 367 --------------------- files/fr/web/api/webglrenderingcontext/index.md | 367 +++++++++++++++++++++ .../api/webglrenderingcontext/isbuffer/index.html | 77 ----- .../api/webglrenderingcontext/isbuffer/index.md | 77 +++++ .../webglrenderingcontext/shadersource/index.html | 74 ----- .../webglrenderingcontext/shadersource/index.md | 74 +++++ .../webglrenderingcontext/teximage2d/index.html | 240 -------------- .../api/webglrenderingcontext/teximage2d/index.md | 240 ++++++++++++++ .../webglrenderingcontext/texparameter/index.html | 177 ---------- .../webglrenderingcontext/texparameter/index.md | 177 ++++++++++ .../api/webglrenderingcontext/uniform/index.html | 97 ------ .../web/api/webglrenderingcontext/uniform/index.md | 97 ++++++ .../webglrenderingcontext/uniformmatrix/index.html | 88 ----- .../webglrenderingcontext/uniformmatrix/index.md | 88 +++++ .../webglrenderingcontext/useprogram/index.html | 80 ----- .../api/webglrenderingcontext/useprogram/index.md | 80 +++++ .../vertexattribpointer/index.html | 254 -------------- .../vertexattribpointer/index.md | 254 ++++++++++++++ .../api/webglrenderingcontext/viewport/index.html | 92 ------ .../api/webglrenderingcontext/viewport/index.md | 92 ++++++ 66 files changed, 3898 insertions(+), 3898 deletions(-) delete mode 100644 files/fr/web/api/webglrenderingcontext/activetexture/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/activetexture/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/attachshader/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/attachshader/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/bindbuffer/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/bindbuffer/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/bindtexture/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/bindtexture/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/bufferdata/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/bufferdata/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/canvas/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/canvas/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/clear/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/clear/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/compileshader/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/compileshader/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/createbuffer/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/createbuffer/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/createprogram/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/createprogram/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/createshader/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/createshader/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/createtexture/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/createtexture/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/deletebuffer/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/deletebuffer/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/deleteshader/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/deleteshader/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/drawarrays/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/drawarrays/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/enable/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/enable/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/enablevertexattribarray/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/enablevertexattribarray/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/generatemipmap/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/generatemipmap/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/getattriblocation/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/getattriblocation/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/geterror/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/geterror/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/getshaderparameter/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/getshaderparameter/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/gettexparameter/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/gettexparameter/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/getuniformlocation/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/getuniformlocation/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/isbuffer/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/isbuffer/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/shadersource/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/shadersource/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/teximage2d/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/teximage2d/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/texparameter/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/texparameter/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/uniform/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/uniform/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/uniformmatrix/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/uniformmatrix/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/useprogram/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/useprogram/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/vertexattribpointer/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/vertexattribpointer/index.md delete mode 100644 files/fr/web/api/webglrenderingcontext/viewport/index.html create mode 100644 files/fr/web/api/webglrenderingcontext/viewport/index.md (limited to 'files/fr/web/api/webglrenderingcontext') diff --git a/files/fr/web/api/webglrenderingcontext/activetexture/index.html b/files/fr/web/api/webglrenderingcontext/activetexture/index.html deleted file mode 100644 index 2967ea1329..0000000000 --- a/files/fr/web/api/webglrenderingcontext/activetexture/index.html +++ /dev/null @@ -1,85 +0,0 @@ ---- -title: WebGLRenderingContext.activeTexture() -slug: Web/API/WebGLRenderingContext/activeTexture -tags: - - API - - Méthode - - Reference - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/activeTexture ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.activeTexture() de l'API WebGL indique quelle unité de texture doit être rendue active.

- -

Syntaxe

- -
void gl.activeTexture(texture);
-
- -

Paramètres

- -
-
texture
-
L'unité de texture à rendre active. La valueur est une gl.TEXTUREI où I est dans la plage de 0 àgl.MAX_COMBINED_TEXTURE_IMAGE_UNITS - 1.
-
- -

Valeur retournée

- -

Aucune.

- -

Exceptions

- -

Si texture n'est pas l'une des gl.TEXTUREI, où I est dans la plage de 0 àgl.MAX_COMBINED_TEXTURE_IMAGE_UNITS - 1, une erreur gl.INVALID_ENUM est déclenchée.

- -

Exemples

- -

L'appel suivant choisit gl.TEXTURE1 comme texture en cours. Les appels suivants qui modifient l'état de la texture affecteront cette texture.

- -
gl.activeTexture(gl.TEXTURE1);
-
- -

Le nombre d'unités de texture dépend de l'implémentation, vous pouvez obtenir ce nombre à l'aide de la constante MAX_COMBINED_TEXTURE_IMAGE_UNITS. Il est, de par la spécification, d'au moins 8.

- -
gl.getParameter(gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS);
-
- -

Pour obtenir la texture en cours, faire une requête sur la constante ACTIVE_TEXTURE.

- -
gl.activeTexture(gl.TEXTURE0);
-gl.getParameter(gl.ACTIVE_TEXTURE);
-// retourne "33984" (0x84C0, valeur enum pour gl.TEXTURE0)
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatuéCommentaire
{{SpecName('WebGL', "#5.14.3", "activeTexture")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glActiveTexture.xml", "glActiveTexture")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API OpenGL.
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/activetexture/index.md b/files/fr/web/api/webglrenderingcontext/activetexture/index.md new file mode 100644 index 0000000000..2967ea1329 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/activetexture/index.md @@ -0,0 +1,85 @@ +--- +title: WebGLRenderingContext.activeTexture() +slug: Web/API/WebGLRenderingContext/activeTexture +tags: + - API + - Méthode + - Reference + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/activeTexture +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.activeTexture() de l'API WebGL indique quelle unité de texture doit être rendue active.

+ +

Syntaxe

+ +
void gl.activeTexture(texture);
+
+ +

Paramètres

+ +
+
texture
+
L'unité de texture à rendre active. La valueur est une gl.TEXTUREI où I est dans la plage de 0 àgl.MAX_COMBINED_TEXTURE_IMAGE_UNITS - 1.
+
+ +

Valeur retournée

+ +

Aucune.

+ +

Exceptions

+ +

Si texture n'est pas l'une des gl.TEXTUREI, où I est dans la plage de 0 àgl.MAX_COMBINED_TEXTURE_IMAGE_UNITS - 1, une erreur gl.INVALID_ENUM est déclenchée.

+ +

Exemples

+ +

L'appel suivant choisit gl.TEXTURE1 comme texture en cours. Les appels suivants qui modifient l'état de la texture affecteront cette texture.

+ +
gl.activeTexture(gl.TEXTURE1);
+
+ +

Le nombre d'unités de texture dépend de l'implémentation, vous pouvez obtenir ce nombre à l'aide de la constante MAX_COMBINED_TEXTURE_IMAGE_UNITS. Il est, de par la spécification, d'au moins 8.

+ +
gl.getParameter(gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS);
+
+ +

Pour obtenir la texture en cours, faire une requête sur la constante ACTIVE_TEXTURE.

+ +
gl.activeTexture(gl.TEXTURE0);
+gl.getParameter(gl.ACTIVE_TEXTURE);
+// retourne "33984" (0x84C0, valeur enum pour gl.TEXTURE0)
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatuéCommentaire
{{SpecName('WebGL', "#5.14.3", "activeTexture")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glActiveTexture.xml", "glActiveTexture")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API OpenGL.
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/attachshader/index.html b/files/fr/web/api/webglrenderingcontext/attachshader/index.html deleted file mode 100644 index 9b2c2b9be7..0000000000 --- a/files/fr/web/api/webglrenderingcontext/attachshader/index.html +++ /dev/null @@ -1,96 +0,0 @@ ---- -title: WebGLRenderingContext.attachShader() -slug: Web/API/WebGLRenderingContext/attachShader -tags: - - Méthode - - WebGL -translation_of: Web/API/WebGLRenderingContext/attachShader ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.attachShader() de l'API WebGL attache un {{domxref("WebGLShader")}} de fragment ou de sommet à un {{domxref("WebGLProgram")}}.

- -

Syntaxe

- -
void gl.attachShader(programme, shader);
-
- -

Paramètres

- -
-
programme
-
Un {{domxref("WebGLProgram")}}.
-
shader
-
Un {{domxref("WebGLShader")}} de fragment ou de sommet.
-
- -

Exemples

- -

Le code suivant attache des shaders pré-existants à un {{domxref("WebGLProgram")}}.

- -
var programme = gl.createProgram();
-
-// Attacher des shaders pré-existants
-gl.attachShader(programme, shaderDeSommet);
-gl.attachShader(programme, shaderDeFragment);
-
-gl.linkProgram(programme);
-
-if ( !gl.getProgramParameter( programme, gl.LINK_STATUS) ) {
-  var info = gl.getProgramInfoLog(programme);
-  throw 'Impossible de compiler le program WebGL. \n\n' + info;
-}
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.9", "attachShader")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glAttachShader.xml", "glAttachShader")}}{{Spec2('OpenGL ES 2.0')}}Page man OpenGL.
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/attachshader/index.md b/files/fr/web/api/webglrenderingcontext/attachshader/index.md new file mode 100644 index 0000000000..9b2c2b9be7 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/attachshader/index.md @@ -0,0 +1,96 @@ +--- +title: WebGLRenderingContext.attachShader() +slug: Web/API/WebGLRenderingContext/attachShader +tags: + - Méthode + - WebGL +translation_of: Web/API/WebGLRenderingContext/attachShader +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.attachShader() de l'API WebGL attache un {{domxref("WebGLShader")}} de fragment ou de sommet à un {{domxref("WebGLProgram")}}.

+ +

Syntaxe

+ +
void gl.attachShader(programme, shader);
+
+ +

Paramètres

+ +
+
programme
+
Un {{domxref("WebGLProgram")}}.
+
shader
+
Un {{domxref("WebGLShader")}} de fragment ou de sommet.
+
+ +

Exemples

+ +

Le code suivant attache des shaders pré-existants à un {{domxref("WebGLProgram")}}.

+ +
var programme = gl.createProgram();
+
+// Attacher des shaders pré-existants
+gl.attachShader(programme, shaderDeSommet);
+gl.attachShader(programme, shaderDeFragment);
+
+gl.linkProgram(programme);
+
+if ( !gl.getProgramParameter( programme, gl.LINK_STATUS) ) {
+  var info = gl.getProgramInfoLog(programme);
+  throw 'Impossible de compiler le program WebGL. \n\n' + info;
+}
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.9", "attachShader")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glAttachShader.xml", "glAttachShader")}}{{Spec2('OpenGL ES 2.0')}}Page man OpenGL.
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/bindbuffer/index.html b/files/fr/web/api/webglrenderingcontext/bindbuffer/index.html deleted file mode 100644 index 72cc698db6..0000000000 --- a/files/fr/web/api/webglrenderingcontext/bindbuffer/index.html +++ /dev/null @@ -1,130 +0,0 @@ ---- -title: WebGLRenderingContext.bindBuffer() -slug: Web/API/WebGLRenderingContext/bindBuffer -tags: - - API - - Méthode - - Reference - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/bindBuffer ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.bindBuffer() de l'API WebGL lie un {{domxref("WebGLBuffer")}} donné à une cible.

- -

Syntaxe

- -
void gl.bindBuffer(cible, tampon);
-
- -

Paramètres

- -
-
cible
-
Un {{domxref ("GLenum")}} spécifiant le point de liaison (cible). Valeurs possibles :
-
- - - -
-
tampon
-
Un {{domxref ("WebGLBuffer")}} à lier.
-
- -

Valeur retournée

- -

Aucune.

- -

Exceptions

- -

Une seule cible peut être liée à un {{domxref ("WebGLBuffer")}} donné. Une tentative de lier le tampon à une autre cible déclenchera une erreur INVALID_OPERATION et la liaison du tampon en cours restera la même.

- -

Exemples

- -

Liaison d'un tampon à une cible

- -
var canevas = document.getElementById('canevas');
-var gl = canevas.getContext('webgl');
-var tampon = gl.createBuffer();
-
-gl.bindBuffer(gl.ARRAY_BUFFER, tampon);
-
- -

Récupération des liaisons en cours

- -

Pour vérifier les liaisons de tampon en cours, interrogez les constantes ARRAY_BUFFER_BINDING et ELEMENT_ARRAY_BUFFER_BINDING.

- -
gl.getParameter(gl.ARRAY_BUFFER_BINDING);
-gl.getParameter(gl.ELEMENT_ARRAY_BUFFER_BINDING);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.5", "bindBuffer")}}{{Spec2('WebGL')}} -

Définition initiale pour WebGL.

-
{{SpecName('OpenGL ES 2.0', "glBindBuffer.xml", "glBindBuffer")}}{{Spec2('OpenGL ES 2.0')}}Page man de l’API OpenGL ES 2 (similaire).
{{SpecName('WebGL2', "#3.7.1", "bindBuffer")}}{{Spec2('WebGL2')}} -

Définition mise à jour pour WebGL 2.

- -

Ajoute de nouveaux tampons cible :
- gl.COPY_READ_BUFFER,
- gl.COPY_WRITE_BUFFER,
- gl.TRANSFORM_FEEDBACK_BUFFER,
- gl.UNIFORM_BUFFER,
- gl.PIXEL_PACK_BUFFER,
- gl.PIXEL_UNPACK_BUFFER

-
{{SpecName('OpenGL ES 3.0', "glBindBuffer.xhtml", "glBindBuffer")}}{{Spec2('OpenGL ES 3.0')}}Page man de l’API OpenGL ES 3 (similaire).
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/bindbuffer/index.md b/files/fr/web/api/webglrenderingcontext/bindbuffer/index.md new file mode 100644 index 0000000000..72cc698db6 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/bindbuffer/index.md @@ -0,0 +1,130 @@ +--- +title: WebGLRenderingContext.bindBuffer() +slug: Web/API/WebGLRenderingContext/bindBuffer +tags: + - API + - Méthode + - Reference + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/bindBuffer +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.bindBuffer() de l'API WebGL lie un {{domxref("WebGLBuffer")}} donné à une cible.

+ +

Syntaxe

+ +
void gl.bindBuffer(cible, tampon);
+
+ +

Paramètres

+ +
+
cible
+
Un {{domxref ("GLenum")}} spécifiant le point de liaison (cible). Valeurs possibles :
+
+ + + +
+
tampon
+
Un {{domxref ("WebGLBuffer")}} à lier.
+
+ +

Valeur retournée

+ +

Aucune.

+ +

Exceptions

+ +

Une seule cible peut être liée à un {{domxref ("WebGLBuffer")}} donné. Une tentative de lier le tampon à une autre cible déclenchera une erreur INVALID_OPERATION et la liaison du tampon en cours restera la même.

+ +

Exemples

+ +

Liaison d'un tampon à une cible

+ +
var canevas = document.getElementById('canevas');
+var gl = canevas.getContext('webgl');
+var tampon = gl.createBuffer();
+
+gl.bindBuffer(gl.ARRAY_BUFFER, tampon);
+
+ +

Récupération des liaisons en cours

+ +

Pour vérifier les liaisons de tampon en cours, interrogez les constantes ARRAY_BUFFER_BINDING et ELEMENT_ARRAY_BUFFER_BINDING.

+ +
gl.getParameter(gl.ARRAY_BUFFER_BINDING);
+gl.getParameter(gl.ELEMENT_ARRAY_BUFFER_BINDING);
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.5", "bindBuffer")}}{{Spec2('WebGL')}} +

Définition initiale pour WebGL.

+
{{SpecName('OpenGL ES 2.0', "glBindBuffer.xml", "glBindBuffer")}}{{Spec2('OpenGL ES 2.0')}}Page man de l’API OpenGL ES 2 (similaire).
{{SpecName('WebGL2', "#3.7.1", "bindBuffer")}}{{Spec2('WebGL2')}} +

Définition mise à jour pour WebGL 2.

+ +

Ajoute de nouveaux tampons cible :
+ gl.COPY_READ_BUFFER,
+ gl.COPY_WRITE_BUFFER,
+ gl.TRANSFORM_FEEDBACK_BUFFER,
+ gl.UNIFORM_BUFFER,
+ gl.PIXEL_PACK_BUFFER,
+ gl.PIXEL_UNPACK_BUFFER

+
{{SpecName('OpenGL ES 3.0', "glBindBuffer.xhtml", "glBindBuffer")}}{{Spec2('OpenGL ES 3.0')}}Page man de l’API OpenGL ES 3 (similaire).
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/bindtexture/index.html b/files/fr/web/api/webglrenderingcontext/bindtexture/index.html deleted file mode 100644 index 662c18a8be..0000000000 --- a/files/fr/web/api/webglrenderingcontext/bindtexture/index.html +++ /dev/null @@ -1,119 +0,0 @@ ---- -title: WebGLRenderingContext.bindTexture() -slug: Web/API/WebGLRenderingContext/bindTexture -tags: - - API - - Méthode - - Reference - - Textures - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/bindTexture ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.bindTexture() de l'API WebGL lie la {{domxref("WebGLTexture")}} donnée à une cible (point de liaison).

- -

Syntaxe

- -
void gl.bindTexture(cible, texture);
-
- -

Paramètres

- -
-
cible
-
Un {{domxref ("GLenum")}} indiquant le point de liaison (cible). Valeurs possibles : -
    -
  • gl.TEXTURE_2D : une texture bidimensionnelle ;
  • -
  • gl.TEXTURE_CUBE_MAP : une texture mappée sur un cube ;
  • -
  • lors de l'utilisation d'un {{domxref("WebGL2RenderingContext", "WebGL 2 context", "", 1)}}, les valeurs suivantes sont en outre disponibles : -
      -
    • gl.TEXTURE_3D : une texture tridimensionnelle ;
    • -
    • gl.TEXTURE_2D_ARRAY : une texture en tableau bidimensionnelle.
    • -
    -
  • -
-
-
texture
-
Un objet {{domxref ("WebGLTexture")}} à lier.
-
- -

Valeur retournée

- -

Aucune.

- -

Exceptions

- -

Une erreur gl.INVALID_ENUM est déclenchée si cible n'est pas gl.TEXTURE_2D, gl.TEXTURE_CUBE_MAP, gl.TEXTURE_3D, ou gl.TEXTURE_2D_ARRAY.

- -

Exemples

- -

Liaison d'une texture

- -
var canevas = document.getElementById('canevas');
-var gl = canevas.getContext('webgl');
-var texture = gl.createTexture();
-
-gl.bindTexture(gl.TEXTURE_2D, texture);
-
- -

Obtention des liaisons en cours

- -

Pour vérifier la liaison de texture en cours, interrogez les constantes gl.TEXTURE_BINDING_2D ou gl.TEXTURE_BINDING_CUBE_MAP.

- -
gl.getParameter(gl.TEXTURE_BINDING_2D);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.8", "bindTexture")}}{{Spec2('WebGL')}} -

Définition initiale pour WebGL.

-
{{SpecName('OpenGL ES 2.0', "glBindTexture.xml", "glBindTexture")}}{{Spec2('OpenGL ES 2.0')}} -

Page man de l’API OpenGL ES 2.0 (similaire).

-
{{SpecName('WebGL2', "#3.7.1", "bindTexture")}}{{Spec2('WebGL2')}}Définition mise à jour pour WebGL 2.
- Ajoute : gl.TEXTURE_3D et  gl.TEXTURE_2D_ARRAY
{{SpecName('OpenGL ES 3.0', "glBindTexture.xhtml", "glBindTexture")}}{{Spec2('OpenGL ES 3.0')}}Page man de l’API OpenGL ES 3.0 (similaire).
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - - - diff --git a/files/fr/web/api/webglrenderingcontext/bindtexture/index.md b/files/fr/web/api/webglrenderingcontext/bindtexture/index.md new file mode 100644 index 0000000000..662c18a8be --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/bindtexture/index.md @@ -0,0 +1,119 @@ +--- +title: WebGLRenderingContext.bindTexture() +slug: Web/API/WebGLRenderingContext/bindTexture +tags: + - API + - Méthode + - Reference + - Textures + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/bindTexture +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.bindTexture() de l'API WebGL lie la {{domxref("WebGLTexture")}} donnée à une cible (point de liaison).

+ +

Syntaxe

+ +
void gl.bindTexture(cible, texture);
+
+ +

Paramètres

+ +
+
cible
+
Un {{domxref ("GLenum")}} indiquant le point de liaison (cible). Valeurs possibles : +
    +
  • gl.TEXTURE_2D : une texture bidimensionnelle ;
  • +
  • gl.TEXTURE_CUBE_MAP : une texture mappée sur un cube ;
  • +
  • lors de l'utilisation d'un {{domxref("WebGL2RenderingContext", "WebGL 2 context", "", 1)}}, les valeurs suivantes sont en outre disponibles : +
      +
    • gl.TEXTURE_3D : une texture tridimensionnelle ;
    • +
    • gl.TEXTURE_2D_ARRAY : une texture en tableau bidimensionnelle.
    • +
    +
  • +
+
+
texture
+
Un objet {{domxref ("WebGLTexture")}} à lier.
+
+ +

Valeur retournée

+ +

Aucune.

+ +

Exceptions

+ +

Une erreur gl.INVALID_ENUM est déclenchée si cible n'est pas gl.TEXTURE_2D, gl.TEXTURE_CUBE_MAP, gl.TEXTURE_3D, ou gl.TEXTURE_2D_ARRAY.

+ +

Exemples

+ +

Liaison d'une texture

+ +
var canevas = document.getElementById('canevas');
+var gl = canevas.getContext('webgl');
+var texture = gl.createTexture();
+
+gl.bindTexture(gl.TEXTURE_2D, texture);
+
+ +

Obtention des liaisons en cours

+ +

Pour vérifier la liaison de texture en cours, interrogez les constantes gl.TEXTURE_BINDING_2D ou gl.TEXTURE_BINDING_CUBE_MAP.

+ +
gl.getParameter(gl.TEXTURE_BINDING_2D);
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.8", "bindTexture")}}{{Spec2('WebGL')}} +

Définition initiale pour WebGL.

+
{{SpecName('OpenGL ES 2.0', "glBindTexture.xml", "glBindTexture")}}{{Spec2('OpenGL ES 2.0')}} +

Page man de l’API OpenGL ES 2.0 (similaire).

+
{{SpecName('WebGL2', "#3.7.1", "bindTexture")}}{{Spec2('WebGL2')}}Définition mise à jour pour WebGL 2.
+ Ajoute : gl.TEXTURE_3D et  gl.TEXTURE_2D_ARRAY
{{SpecName('OpenGL ES 3.0', "glBindTexture.xhtml", "glBindTexture")}}{{Spec2('OpenGL ES 3.0')}}Page man de l’API OpenGL ES 3.0 (similaire).
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + + + diff --git a/files/fr/web/api/webglrenderingcontext/bufferdata/index.html b/files/fr/web/api/webglrenderingcontext/bufferdata/index.html deleted file mode 100644 index e9512ad7bd..0000000000 --- a/files/fr/web/api/webglrenderingcontext/bufferdata/index.html +++ /dev/null @@ -1,161 +0,0 @@ ---- -title: WebGLRenderingContext.bufferData() -slug: Web/API/WebGLRenderingContext/bufferData -tags: - - API - - Méthode - - Reference - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/bufferData ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.bufferData() de l'API WebGL initialise et crée le magasin de données de l'objet tampon.

- -

Syntaxe

- -
// WebGL1:
-void gl.bufferData(cible, taille, utilisation);
-void gl.bufferData(cible, ArrayBuffer? donneesSrc, utilisation);
-void gl.bufferData(cible, ArrayBufferView donneesSrc, utilisation);
-
-// WebGL2:
-void gl.bufferData(cible, ArrayBufferView donneesSrc, utilisation, decalageSrc, longueur);
-
- -

Paramètres

- -
-
cible
-
Un {{domxref ("GLenum")}} spécifiant le point de liaison (cible). Valeurs possibles : -
    -
  • gl.ARRAY_BUFFER : tampon contenant des attributs de sommet, tels que des coordonnées de sommet, des données de coordonnées de texture ou des données de couleurs de sommet ;
  • -
  • gl.ELEMENT_ARRAY_BUFFER : tampon utilisé pour les indices d'éléments ;
  • -
  • lors de l'utilisation d'un {{domxref ("WebGL2RenderingContext", "WebGL context 2", "", 1)}}, les valeurs suivantes sont en outre disponibles : -
      -
    • gl.COPY_READ_BUFFER : tampon pour la copie d'un objet tampon à un autre ;
    • -
    • gl.COPY_WRITE_BUFFER : tampon pour la copie d'un objet tampon à un autre ;
    • -
    • gl.TRANSFORM_FEEDBACK_BUFFER : tampon pour les opérations de retour de transformation ;
    • -
    • gl.UNIFORM_BUFFER : tampon utilisé pour stocker des blocs uniform ;
    • -
    • gl.PIXEL_PACK_BUFFER : tampon utilisé pour les opérations de transfert de pixels ;
    • -
    • gl.PIXEL_UNPACK_BUFFER : tampon utilisé pour les opérations de transfert de pixels.
    • -
    -
  • -
-
-
taille
-
Un {{domxref("GLsizeiptr")}} définissant la taille du magasin de données de l'objet tampon.
-
donneesSrc {{optional_inline}}
-
Un {{jsxref("ArrayBuffer")}}, {{jsxref("SharedArrayBuffer")}} ou l'un des types de tableau typés {{domxref("ArrayBufferView")}} à copier dans le magasin de données. Si null, un magasin de données est quand même créé, mais son contenu n'est ni initialisé, ni défini.
-
utilisation
-
Un {{domxref("GLenum")}} indiquant le modèle d'utilisation du magasin de données. Valeurs possibles : -
    -
  • gl.STATIC_DRAW : le contenu du tampon est susceptible d'être utilisé souvent mais de ne pas changer souvent ; du contenu est écrit dans le tampon, mais non lu ;
  • -
  • gl.DYNAMIC_DRAW : le contenu du tampon est susceptible d'être souvent utilisé et de changer souvent ; du contenu est écrit dans le tampon, mais non lu ;
  • -
  • gl.STREAM_DRAW : le contenu du tampon est susceptible de ne pas être utilisé souvent ; du contenu est écrit dans le tampon, mais non lu ;
  • -
  • lors de l'utilisation d'un {{domxref("WebGL2RenderingContext", "WebGL 2 context", "", 1)}}, les valeurs suivantes the following values sont en outre disponibles : -
      -
    • gl.STATIC_READ : le contenu du tampon est susceptible d'être utilisé souvent et de ne pas changer souvent ; du contenu est lu depuis le tampon, mais non écrit ;
    • -
    • gl.DYNAMIC_READ : le contenu du tampon est susceptible d'être utilisé souvent et de changer souvent ; du contenu est lu depuis le tampon, mais non écrit ;
    • -
    • gl.STREAM_READ : le contenu du tampon est susceptible de ne pas être utilisé souvent ; du contenu est lu depuis le tampon, mais non écrit ;
    • -
    • gl.STATIC_COPY : le contenu du tampon est susceptible d'être utilisé souvent et de ne pas changer souvent ; aucun contenu n'est écrit ou lu par l'utilisateur ;
    • -
    • gl.DYNAMIC_COPY : le contenu du tampon est susceptible d'être utilisé souvent et de changer souvent ; aucun contenu n'est écrit ou lu par l'utilisateur ;
    • -
    • gl.STREAM_COPY : le contenu du tampon est susceptible d'être utilisé souvent et de ne pas changer souvent ; aucun contenu n'est écrit ou lu par l'utilisateur.
    • -
    -
  • -
-
-
decalageSrc
-
Un {{domxref("GLuint")}} indiquant le décalage d'indice d'élément où commencer à lire dans le tampon.
-
longueur {{optional_inline}}
-
Un {{domxref("GLuint")}} valant 0 par défaut.
-
- -

Valeur retournée

- -

Aucune.

- -

Exceptions

- - - -

Exemples

- -

Utilisation de bufferData

- -
var canevas = document.getElementById('canevas');
-var gl = canevas.getContext('webgl');
-var tampon = gl.createBuffer();
-gl.bindBuffer(gl.ARRAY_BUFFER, tampon);
-gl.bufferData(gl.ARRAY_BUFFER, 1024, gl.STATIC_DRAW);
-
- -

Récupération de l'information de tampon

- -

Pour vérifier l'utilisation du tampon en cours et la taille du tampon, utiliser la méthode {{domxref("WebGLRenderingContext.getBufferParameter()")}}.

- -
gl.getBufferParameter(gl.ARRAY_BUFFER, gl.BUFFER_SIZE);
-gl.getBufferParameter(gl.ARRAY_BUFFER, gl.BUFFER_USAGE);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.5", "bufferData")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glBufferData.xml", "glBufferData")}}{{Spec2('OpenGL ES 2.0')}} -

Page man de l’API OpenGL.

-
{{SpecName('OpenGL ES 3.0', "glBufferData.xhtml", "glBufferData")}}{{Spec2('OpenGL ES 3.0')}} -

Page man de l’API OpenGL ES 3 (similaire).

- Ajoute les noouveaux tampons cible :
- gl.COPY_READ_BUFFER,
- gl.COPY_WRITE_BUFFER,
- gl.TRANSFORM_FEEDBACK_BUFFER,
- gl.UNIFORM_BUFFER,
- gl.PIXEL_PACK_BUFFER,
- gl.PIXEL_UNPACK_BUFFER
-
- Ajoute les nouvelles indications d'utilisation :
- gl.STATIC_READ,
- gl.DYNAMIC_READ,
- gl.STREAM_READ,
- gl.STATIC_COPY,
- gl.DYNAMIC_COPY,
- gl.STREAM_COPY.
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/bufferdata/index.md b/files/fr/web/api/webglrenderingcontext/bufferdata/index.md new file mode 100644 index 0000000000..e9512ad7bd --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/bufferdata/index.md @@ -0,0 +1,161 @@ +--- +title: WebGLRenderingContext.bufferData() +slug: Web/API/WebGLRenderingContext/bufferData +tags: + - API + - Méthode + - Reference + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/bufferData +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.bufferData() de l'API WebGL initialise et crée le magasin de données de l'objet tampon.

+ +

Syntaxe

+ +
// WebGL1:
+void gl.bufferData(cible, taille, utilisation);
+void gl.bufferData(cible, ArrayBuffer? donneesSrc, utilisation);
+void gl.bufferData(cible, ArrayBufferView donneesSrc, utilisation);
+
+// WebGL2:
+void gl.bufferData(cible, ArrayBufferView donneesSrc, utilisation, decalageSrc, longueur);
+
+ +

Paramètres

+ +
+
cible
+
Un {{domxref ("GLenum")}} spécifiant le point de liaison (cible). Valeurs possibles : +
    +
  • gl.ARRAY_BUFFER : tampon contenant des attributs de sommet, tels que des coordonnées de sommet, des données de coordonnées de texture ou des données de couleurs de sommet ;
  • +
  • gl.ELEMENT_ARRAY_BUFFER : tampon utilisé pour les indices d'éléments ;
  • +
  • lors de l'utilisation d'un {{domxref ("WebGL2RenderingContext", "WebGL context 2", "", 1)}}, les valeurs suivantes sont en outre disponibles : +
      +
    • gl.COPY_READ_BUFFER : tampon pour la copie d'un objet tampon à un autre ;
    • +
    • gl.COPY_WRITE_BUFFER : tampon pour la copie d'un objet tampon à un autre ;
    • +
    • gl.TRANSFORM_FEEDBACK_BUFFER : tampon pour les opérations de retour de transformation ;
    • +
    • gl.UNIFORM_BUFFER : tampon utilisé pour stocker des blocs uniform ;
    • +
    • gl.PIXEL_PACK_BUFFER : tampon utilisé pour les opérations de transfert de pixels ;
    • +
    • gl.PIXEL_UNPACK_BUFFER : tampon utilisé pour les opérations de transfert de pixels.
    • +
    +
  • +
+
+
taille
+
Un {{domxref("GLsizeiptr")}} définissant la taille du magasin de données de l'objet tampon.
+
donneesSrc {{optional_inline}}
+
Un {{jsxref("ArrayBuffer")}}, {{jsxref("SharedArrayBuffer")}} ou l'un des types de tableau typés {{domxref("ArrayBufferView")}} à copier dans le magasin de données. Si null, un magasin de données est quand même créé, mais son contenu n'est ni initialisé, ni défini.
+
utilisation
+
Un {{domxref("GLenum")}} indiquant le modèle d'utilisation du magasin de données. Valeurs possibles : +
    +
  • gl.STATIC_DRAW : le contenu du tampon est susceptible d'être utilisé souvent mais de ne pas changer souvent ; du contenu est écrit dans le tampon, mais non lu ;
  • +
  • gl.DYNAMIC_DRAW : le contenu du tampon est susceptible d'être souvent utilisé et de changer souvent ; du contenu est écrit dans le tampon, mais non lu ;
  • +
  • gl.STREAM_DRAW : le contenu du tampon est susceptible de ne pas être utilisé souvent ; du contenu est écrit dans le tampon, mais non lu ;
  • +
  • lors de l'utilisation d'un {{domxref("WebGL2RenderingContext", "WebGL 2 context", "", 1)}}, les valeurs suivantes the following values sont en outre disponibles : +
      +
    • gl.STATIC_READ : le contenu du tampon est susceptible d'être utilisé souvent et de ne pas changer souvent ; du contenu est lu depuis le tampon, mais non écrit ;
    • +
    • gl.DYNAMIC_READ : le contenu du tampon est susceptible d'être utilisé souvent et de changer souvent ; du contenu est lu depuis le tampon, mais non écrit ;
    • +
    • gl.STREAM_READ : le contenu du tampon est susceptible de ne pas être utilisé souvent ; du contenu est lu depuis le tampon, mais non écrit ;
    • +
    • gl.STATIC_COPY : le contenu du tampon est susceptible d'être utilisé souvent et de ne pas changer souvent ; aucun contenu n'est écrit ou lu par l'utilisateur ;
    • +
    • gl.DYNAMIC_COPY : le contenu du tampon est susceptible d'être utilisé souvent et de changer souvent ; aucun contenu n'est écrit ou lu par l'utilisateur ;
    • +
    • gl.STREAM_COPY : le contenu du tampon est susceptible d'être utilisé souvent et de ne pas changer souvent ; aucun contenu n'est écrit ou lu par l'utilisateur.
    • +
    +
  • +
+
+
decalageSrc
+
Un {{domxref("GLuint")}} indiquant le décalage d'indice d'élément où commencer à lire dans le tampon.
+
longueur {{optional_inline}}
+
Un {{domxref("GLuint")}} valant 0 par défaut.
+
+ +

Valeur retournée

+ +

Aucune.

+ +

Exceptions

+ + + +

Exemples

+ +

Utilisation de bufferData

+ +
var canevas = document.getElementById('canevas');
+var gl = canevas.getContext('webgl');
+var tampon = gl.createBuffer();
+gl.bindBuffer(gl.ARRAY_BUFFER, tampon);
+gl.bufferData(gl.ARRAY_BUFFER, 1024, gl.STATIC_DRAW);
+
+ +

Récupération de l'information de tampon

+ +

Pour vérifier l'utilisation du tampon en cours et la taille du tampon, utiliser la méthode {{domxref("WebGLRenderingContext.getBufferParameter()")}}.

+ +
gl.getBufferParameter(gl.ARRAY_BUFFER, gl.BUFFER_SIZE);
+gl.getBufferParameter(gl.ARRAY_BUFFER, gl.BUFFER_USAGE);
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.5", "bufferData")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glBufferData.xml", "glBufferData")}}{{Spec2('OpenGL ES 2.0')}} +

Page man de l’API OpenGL.

+
{{SpecName('OpenGL ES 3.0', "glBufferData.xhtml", "glBufferData")}}{{Spec2('OpenGL ES 3.0')}} +

Page man de l’API OpenGL ES 3 (similaire).

+ Ajoute les noouveaux tampons cible :
+ gl.COPY_READ_BUFFER,
+ gl.COPY_WRITE_BUFFER,
+ gl.TRANSFORM_FEEDBACK_BUFFER,
+ gl.UNIFORM_BUFFER,
+ gl.PIXEL_PACK_BUFFER,
+ gl.PIXEL_UNPACK_BUFFER
+
+ Ajoute les nouvelles indications d'utilisation :
+ gl.STATIC_READ,
+ gl.DYNAMIC_READ,
+ gl.STREAM_READ,
+ gl.STATIC_COPY,
+ gl.DYNAMIC_COPY,
+ gl.STREAM_COPY.
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/canvas/index.html b/files/fr/web/api/webglrenderingcontext/canvas/index.html deleted file mode 100644 index ccdfa7ed8a..0000000000 --- a/files/fr/web/api/webglrenderingcontext/canvas/index.html +++ /dev/null @@ -1,74 +0,0 @@ ---- -title: WebGLRenderingContext.canvas -slug: Web/API/WebGLRenderingContext/canvas -tags: - - Propriété - - WebGL - - WebGLRenderingContext - - lecture seule -translation_of: Web/API/WebGLRenderingContext/canvas -original_slug: Web/API/WebGLRenderingContext/canevas ---- -
{{APIRef("WebGL")}}
- -

La propriété WebGLRenderingContext.canvas est une référence en lecture seule à l'objet {{domxref("HTMLCanvasElement")}} ou {{domxref("OffscreenCanvas")}} associé au contexte. Il peut s'agir de {{jsxref("null")}} s'il n'est pas associé à un élément {{HTMLElement("canvas")}} ou à un objet {{domxref("OffscreenCanvas")}}.

- -

Syntaxe

- -
gl.canvas;
- -

Valeur retournée

- -

Soit un objet {{domxref("HTMLCanvasElement")}} ou {{domxref("OffscreenCanvas")}}, soit {{jsxref("null")}}.

- -

Exemples

- -

Élément canevas

- -

Étant donné cet élément {{HTMLElement("canvas")}} :

- -
<canvas id="canevas"></canvas>
-
- -

Vous pouvez en récupérer une référence à partir du WebGLRenderingContext en utilisant la propriété canvas :

- -
var canevas = document.getElementById('canevas');
-var gl = canevas.getContext('webgl');
-gl.canvas; // HTMLCanvasElement
-
- -

Canevas hors écran

- -

Exemple d'utilisation de l'objet expérimental {{domxref("OffscreenCanvas")}}.

- -
var horsEcran = new OffscreenCanvas(256, 256);
-var gl = horsEcran.getContext('webgl');
-gl.canvas; // OffscreenCanvas
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#DOM-WebGLRenderingContext-canvas", "WebGLRenderingContext.canvas")}}{{Spec2('WebGL')}}Définition initiale.
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/canvas/index.md b/files/fr/web/api/webglrenderingcontext/canvas/index.md new file mode 100644 index 0000000000..ccdfa7ed8a --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/canvas/index.md @@ -0,0 +1,74 @@ +--- +title: WebGLRenderingContext.canvas +slug: Web/API/WebGLRenderingContext/canvas +tags: + - Propriété + - WebGL + - WebGLRenderingContext + - lecture seule +translation_of: Web/API/WebGLRenderingContext/canvas +original_slug: Web/API/WebGLRenderingContext/canevas +--- +
{{APIRef("WebGL")}}
+ +

La propriété WebGLRenderingContext.canvas est une référence en lecture seule à l'objet {{domxref("HTMLCanvasElement")}} ou {{domxref("OffscreenCanvas")}} associé au contexte. Il peut s'agir de {{jsxref("null")}} s'il n'est pas associé à un élément {{HTMLElement("canvas")}} ou à un objet {{domxref("OffscreenCanvas")}}.

+ +

Syntaxe

+ +
gl.canvas;
+ +

Valeur retournée

+ +

Soit un objet {{domxref("HTMLCanvasElement")}} ou {{domxref("OffscreenCanvas")}}, soit {{jsxref("null")}}.

+ +

Exemples

+ +

Élément canevas

+ +

Étant donné cet élément {{HTMLElement("canvas")}} :

+ +
<canvas id="canevas"></canvas>
+
+ +

Vous pouvez en récupérer une référence à partir du WebGLRenderingContext en utilisant la propriété canvas :

+ +
var canevas = document.getElementById('canevas');
+var gl = canevas.getContext('webgl');
+gl.canvas; // HTMLCanvasElement
+
+ +

Canevas hors écran

+ +

Exemple d'utilisation de l'objet expérimental {{domxref("OffscreenCanvas")}}.

+ +
var horsEcran = new OffscreenCanvas(256, 256);
+var gl = horsEcran.getContext('webgl');
+gl.canvas; // OffscreenCanvas
+ +

Spécifications

+ + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#DOM-WebGLRenderingContext-canvas", "WebGLRenderingContext.canvas")}}{{Spec2('WebGL')}}Définition initiale.
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/clear/index.html b/files/fr/web/api/webglrenderingcontext/clear/index.html deleted file mode 100644 index 69acd2f1d1..0000000000 --- a/files/fr/web/api/webglrenderingcontext/clear/index.html +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: WebGLRenderingContext.clear() -slug: Web/API/WebGLRenderingContext/clear -tags: - - API - - Méthode - - Reference - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/clear ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.clear() de l'API WebGL efface les tampons avec des valeurs prédéfinies.

- -

Ces valeurs prédéfinies peuvent être affectées par {{domxref("WebGLRenderingContext.clearColor", "clearColor()")}}, {{domxref("WebGLRenderingContext.clearDepth", "clearDepth()")}} ou {{domxref("WebGLRenderingContext.clearStencil", "clearStencil()")}}.

- -

Les masques d'écriture, de détourage, de tramage et de tampon peuvent affecter la méthode clear().

- -

Syntaxe

- -
void gl.clear(masque);
-
- -

Paramètres

- -
-
masque
-
Un masque OU par bits {{domxref("GLbitfield")}} qui indique les tampons à effacer. Les valeurs possibles sont : -
    -
  • gl.COLOR_BUFFER_BIT
  • -
  • gl.DEPTH_BUFFER_BIT
  • -
  • gl.STENCIL_BUFFER_BIT
  • -
-
-
- -

Valeur retournée

- -

Aucune.

- -

Exceptions

- -

Si masque n'est pas l'une des valeurs possibles listées, une erreur gl.INVALID_ENUM est déclenchée.

- -

Exemples

- -

La méthode clear() accepte des valeurs multiples.

- -
gl.clear(gl.DEPTH_BUFFER_BIT);
-gl.clear(gl.DEPTH_BUFFER_BIT | gl.COLOR_BUFFER_BIT);
-
- -

Pour obtenir les valeurs d'effacement courantes, interrogez les constantes COLOR_CLEAR_VALUE, DEPTH_CLEAR_VALUE et STENCIL_CLEAR_VALUE grâce à la méthode getParameter().

- -
gl.getParameter(gl.COLOR_CLEAR_VALUE);
-gl.getParameter(gl.DEPTH_CLEAR_VALUE);
-gl.getParameter(gl.STENCIL_CLEAR_VALUE);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.11", "clear")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glClear.xml", "glClear")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API OpenGL.
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/clear/index.md b/files/fr/web/api/webglrenderingcontext/clear/index.md new file mode 100644 index 0000000000..69acd2f1d1 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/clear/index.md @@ -0,0 +1,93 @@ +--- +title: WebGLRenderingContext.clear() +slug: Web/API/WebGLRenderingContext/clear +tags: + - API + - Méthode + - Reference + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/clear +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.clear() de l'API WebGL efface les tampons avec des valeurs prédéfinies.

+ +

Ces valeurs prédéfinies peuvent être affectées par {{domxref("WebGLRenderingContext.clearColor", "clearColor()")}}, {{domxref("WebGLRenderingContext.clearDepth", "clearDepth()")}} ou {{domxref("WebGLRenderingContext.clearStencil", "clearStencil()")}}.

+ +

Les masques d'écriture, de détourage, de tramage et de tampon peuvent affecter la méthode clear().

+ +

Syntaxe

+ +
void gl.clear(masque);
+
+ +

Paramètres

+ +
+
masque
+
Un masque OU par bits {{domxref("GLbitfield")}} qui indique les tampons à effacer. Les valeurs possibles sont : +
    +
  • gl.COLOR_BUFFER_BIT
  • +
  • gl.DEPTH_BUFFER_BIT
  • +
  • gl.STENCIL_BUFFER_BIT
  • +
+
+
+ +

Valeur retournée

+ +

Aucune.

+ +

Exceptions

+ +

Si masque n'est pas l'une des valeurs possibles listées, une erreur gl.INVALID_ENUM est déclenchée.

+ +

Exemples

+ +

La méthode clear() accepte des valeurs multiples.

+ +
gl.clear(gl.DEPTH_BUFFER_BIT);
+gl.clear(gl.DEPTH_BUFFER_BIT | gl.COLOR_BUFFER_BIT);
+
+ +

Pour obtenir les valeurs d'effacement courantes, interrogez les constantes COLOR_CLEAR_VALUE, DEPTH_CLEAR_VALUE et STENCIL_CLEAR_VALUE grâce à la méthode getParameter().

+ +
gl.getParameter(gl.COLOR_CLEAR_VALUE);
+gl.getParameter(gl.DEPTH_CLEAR_VALUE);
+gl.getParameter(gl.STENCIL_CLEAR_VALUE);
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.11", "clear")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glClear.xml", "glClear")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API OpenGL.
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/compileshader/index.html b/files/fr/web/api/webglrenderingcontext/compileshader/index.html deleted file mode 100644 index 4727567959..0000000000 --- a/files/fr/web/api/webglrenderingcontext/compileshader/index.html +++ /dev/null @@ -1,85 +0,0 @@ ---- -title: WebGLRenderingContext.compileShader() -slug: Web/API/WebGLRenderingContext/compileShader -tags: - - API - - Méthode - - Reference - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/compileShader ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.compileShader() de l'API WebGL compile un shader GLSL en données binaires, de sorte qu'il puisse être utilisé par un {{domxref("WebGLProgram")}}.

- -

Syntaxe

- -
void gl.compileShader(shader);
-
- -

Paramètres

- -
-
shader
-
Un {{domxref("WebGLShader")}} de fragments ou de sommets.
-
- -

Exemples

- -
var shader = gl.createShader(gl.VERTEX_SHADER);
-gl.shaderSource(shader, sourceShader);
-gl.compileShader(shader);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.9", "compileShader")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glCompileShader.xml", "glCompileShader")}}{{Spec2('OpenGL ES 2.0')}}Page man OpenGL.
- -

Compatibilité des navigateurs

- -

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

- -

Voire aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/compileshader/index.md b/files/fr/web/api/webglrenderingcontext/compileshader/index.md new file mode 100644 index 0000000000..4727567959 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/compileshader/index.md @@ -0,0 +1,85 @@ +--- +title: WebGLRenderingContext.compileShader() +slug: Web/API/WebGLRenderingContext/compileShader +tags: + - API + - Méthode + - Reference + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/compileShader +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.compileShader() de l'API WebGL compile un shader GLSL en données binaires, de sorte qu'il puisse être utilisé par un {{domxref("WebGLProgram")}}.

+ +

Syntaxe

+ +
void gl.compileShader(shader);
+
+ +

Paramètres

+ +
+
shader
+
Un {{domxref("WebGLShader")}} de fragments ou de sommets.
+
+ +

Exemples

+ +
var shader = gl.createShader(gl.VERTEX_SHADER);
+gl.shaderSource(shader, sourceShader);
+gl.compileShader(shader);
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.9", "compileShader")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glCompileShader.xml", "glCompileShader")}}{{Spec2('OpenGL ES 2.0')}}Page man OpenGL.
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voire aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/createbuffer/index.html b/files/fr/web/api/webglrenderingcontext/createbuffer/index.html deleted file mode 100644 index 6970f50070..0000000000 --- a/files/fr/web/api/webglrenderingcontext/createbuffer/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: WebGLRenderingContext.createBuffer() -slug: Web/API/WebGLRenderingContext/createBuffer -tags: - - API - - Méthode - - Reference - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/createBuffer ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.createBuffer() de l'API WebGL crée et initialise un {{domxref ("WebGLBuffer")}} stockant des données telles que des sommets ou des couleurs.

- -

Syntaxe

- -
WebGLBuffer gl.createBuffer();
-
- -

Paramètres

- -

Aucun.

- -

Valeur retournée

- -

Un {{domxref("WebGLBuffer")}} stockant des données telles que des sommets ou des couleurs.

- -

Exemples

- -

Création d'un tampon

- -
var canevas = document.getElementById('canevas');
-var gl = canevas.getContext('webgl');
-var tampon = gl.createBuffer();
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.5", "createBuffer")}}{{Spec2('WebGL')}} -

Définition initiale.

-
{{SpecName('OpenGL ES 2.0', "glGenBuffers.xml", "glGenBuffers")}}{{Spec2('OpenGL ES 2.0')}} -

Page man de l’API OpenGL (similaire).

-
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/createbuffer/index.md b/files/fr/web/api/webglrenderingcontext/createbuffer/index.md new file mode 100644 index 0000000000..6970f50070 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/createbuffer/index.md @@ -0,0 +1,75 @@ +--- +title: WebGLRenderingContext.createBuffer() +slug: Web/API/WebGLRenderingContext/createBuffer +tags: + - API + - Méthode + - Reference + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/createBuffer +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.createBuffer() de l'API WebGL crée et initialise un {{domxref ("WebGLBuffer")}} stockant des données telles que des sommets ou des couleurs.

+ +

Syntaxe

+ +
WebGLBuffer gl.createBuffer();
+
+ +

Paramètres

+ +

Aucun.

+ +

Valeur retournée

+ +

Un {{domxref("WebGLBuffer")}} stockant des données telles que des sommets ou des couleurs.

+ +

Exemples

+ +

Création d'un tampon

+ +
var canevas = document.getElementById('canevas');
+var gl = canevas.getContext('webgl');
+var tampon = gl.createBuffer();
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.5", "createBuffer")}}{{Spec2('WebGL')}} +

Définition initiale.

+
{{SpecName('OpenGL ES 2.0', "glGenBuffers.xml", "glGenBuffers")}}{{Spec2('OpenGL ES 2.0')}} +

Page man de l’API OpenGL (similaire).

+
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/createprogram/index.html b/files/fr/web/api/webglrenderingcontext/createprogram/index.html deleted file mode 100644 index 4b59a8b581..0000000000 --- a/files/fr/web/api/webglrenderingcontext/createprogram/index.html +++ /dev/null @@ -1,85 +0,0 @@ ---- -title: WebGLRenderingContext.createProgram() -slug: Web/API/WebGLRenderingContext/createProgram -tags: - - API - - Méthode - - Reference - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/createProgram ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.createProgram() de l'API WebGL crée et initialise un objet {{domxref("WebGLProgram")}}.

- -

Syntaxe

- -
WebGLProgram gl.createProgram();
-
- -

Paramètres

- -

Aucun.

- -

Valeur retournée

- -

Un objet {{domxref("WebGLProgram")}} qui est une combinaison de deux {{domxref("WebGLShader")}}s compilés, constitués d'un shader de sommet et d'un shader de fragment (tous deux écrits en GLSL). Ceux-ci sont ensuite liés en un programme utilisable.

- -

Exemples

- -

Création d'un programme WebGL

- -
var programme = gl.createProgram();
-
-// Attacher les shaders pré-existants
-gl.attachShader(programme, shaderDeSommet);
-gl.attachShader(programme, shaderDeFragment);
-
-gl.linkProgram(programme);
-
-if ( !gl.getProgramParameter( programme, gl.LINK_STATUS) ) {
-  var info = gl.getProgramInfoLog(program);
-  throw 'Impossible de compiler le programme WebGL. \n\n' + info;
-}
-
- -

Voir {{domxref ("WebGLShader")}} pour plus d'informations sur la création du shaderDeSommet et du shaderDeFragment dans l'exemple ci-dessus.

- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.9", "createProgram")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glCreateProgram.xml", "glCreateProgram")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API OpenGL (similaire).
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/createprogram/index.md b/files/fr/web/api/webglrenderingcontext/createprogram/index.md new file mode 100644 index 0000000000..4b59a8b581 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/createprogram/index.md @@ -0,0 +1,85 @@ +--- +title: WebGLRenderingContext.createProgram() +slug: Web/API/WebGLRenderingContext/createProgram +tags: + - API + - Méthode + - Reference + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/createProgram +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.createProgram() de l'API WebGL crée et initialise un objet {{domxref("WebGLProgram")}}.

+ +

Syntaxe

+ +
WebGLProgram gl.createProgram();
+
+ +

Paramètres

+ +

Aucun.

+ +

Valeur retournée

+ +

Un objet {{domxref("WebGLProgram")}} qui est une combinaison de deux {{domxref("WebGLShader")}}s compilés, constitués d'un shader de sommet et d'un shader de fragment (tous deux écrits en GLSL). Ceux-ci sont ensuite liés en un programme utilisable.

+ +

Exemples

+ +

Création d'un programme WebGL

+ +
var programme = gl.createProgram();
+
+// Attacher les shaders pré-existants
+gl.attachShader(programme, shaderDeSommet);
+gl.attachShader(programme, shaderDeFragment);
+
+gl.linkProgram(programme);
+
+if ( !gl.getProgramParameter( programme, gl.LINK_STATUS) ) {
+  var info = gl.getProgramInfoLog(program);
+  throw 'Impossible de compiler le programme WebGL. \n\n' + info;
+}
+
+ +

Voir {{domxref ("WebGLShader")}} pour plus d'informations sur la création du shaderDeSommet et du shaderDeFragment dans l'exemple ci-dessus.

+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.9", "createProgram")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glCreateProgram.xml", "glCreateProgram")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API OpenGL (similaire).
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/createshader/index.html b/files/fr/web/api/webglrenderingcontext/createshader/index.html deleted file mode 100644 index d67f27443d..0000000000 --- a/files/fr/web/api/webglrenderingcontext/createshader/index.html +++ /dev/null @@ -1,85 +0,0 @@ ---- -title: WebGLRenderingContext.createShader() -slug: Web/API/WebGLRenderingContext/createShader -tags: - - API - - Graphiques - - Méthode - - Reference - - Shader - - WebGL -translation_of: Web/API/WebGLRenderingContext/createShader ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.createShader() de l'API WebGL crée un {{domxref("WebGLShader")}}, qui peut alors être configuré davantage en utilisant {{domxref("WebGLRenderingContext.shaderSource()")}} et {{domxref("WebGLRenderingContext.compileShader()")}}.

- -

Syntaxe

- -
WebGLShader gl.createShader(type);
-
- -

Paramètres

- -
-
type
-
Soit gl.VERTEX_SHADER, soit gl.FRAGMENT_SHADER
-
- -

Exemples

- -

Voir {{domxref("WebGLShader")}} pour l'utilisation et des exemples.

- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.9", "createShader")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glCreateShader.xml", "glCreateShader")}}{{Spec2('OpenGL ES 2.0')}}Page man OpenGL.
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/createshader/index.md b/files/fr/web/api/webglrenderingcontext/createshader/index.md new file mode 100644 index 0000000000..d67f27443d --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/createshader/index.md @@ -0,0 +1,85 @@ +--- +title: WebGLRenderingContext.createShader() +slug: Web/API/WebGLRenderingContext/createShader +tags: + - API + - Graphiques + - Méthode + - Reference + - Shader + - WebGL +translation_of: Web/API/WebGLRenderingContext/createShader +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.createShader() de l'API WebGL crée un {{domxref("WebGLShader")}}, qui peut alors être configuré davantage en utilisant {{domxref("WebGLRenderingContext.shaderSource()")}} et {{domxref("WebGLRenderingContext.compileShader()")}}.

+ +

Syntaxe

+ +
WebGLShader gl.createShader(type);
+
+ +

Paramètres

+ +
+
type
+
Soit gl.VERTEX_SHADER, soit gl.FRAGMENT_SHADER
+
+ +

Exemples

+ +

Voir {{domxref("WebGLShader")}} pour l'utilisation et des exemples.

+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.9", "createShader")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glCreateShader.xml", "glCreateShader")}}{{Spec2('OpenGL ES 2.0')}}Page man OpenGL.
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/createtexture/index.html b/files/fr/web/api/webglrenderingcontext/createtexture/index.html deleted file mode 100644 index 2ac9c1fd62..0000000000 --- a/files/fr/web/api/webglrenderingcontext/createtexture/index.html +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: WebGLRenderingContext.createTexture() -slug: Web/API/WebGLRenderingContext/createTexture -tags: - - API - - Méthode - - Reference - - Textures - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/createTexture ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.createTexture() de l'API WebGL crée et initialise un objet {{domxref("WebGLTexture")}}.

- -

Syntaxe

- -
WebGLTexture gl.createTexture();
-
- -

Paramètres

- -

Aucun.

- -

Valeur retournée

- -

Un objet {{domxref("WebGLTexture")}} auquel des images peuvent être liées.

- -

Exemples

- -

Voir aussi le tutoriel WebGL sur l'Utilisation de textures en WebGL.

- -

Création d'une texture

- -
var canevas = document.getElementById('canevas');
-var gl = canevas.getContext('webgl');
-var texture = gl.createTexture();
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.8", "createTexture")}}{{Spec2('WebGL')}} -

Définition initiale.

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

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/createtexture/index.md b/files/fr/web/api/webglrenderingcontext/createtexture/index.md new file mode 100644 index 0000000000..2ac9c1fd62 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/createtexture/index.md @@ -0,0 +1,76 @@ +--- +title: WebGLRenderingContext.createTexture() +slug: Web/API/WebGLRenderingContext/createTexture +tags: + - API + - Méthode + - Reference + - Textures + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/createTexture +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.createTexture() de l'API WebGL crée et initialise un objet {{domxref("WebGLTexture")}}.

+ +

Syntaxe

+ +
WebGLTexture gl.createTexture();
+
+ +

Paramètres

+ +

Aucun.

+ +

Valeur retournée

+ +

Un objet {{domxref("WebGLTexture")}} auquel des images peuvent être liées.

+ +

Exemples

+ +

Voir aussi le tutoriel WebGL sur l'Utilisation de textures en WebGL.

+ +

Création d'une texture

+ +
var canevas = document.getElementById('canevas');
+var gl = canevas.getContext('webgl');
+var texture = gl.createTexture();
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.8", "createTexture")}}{{Spec2('WebGL')}} +

Définition initiale.

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

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/deletebuffer/index.html b/files/fr/web/api/webglrenderingcontext/deletebuffer/index.html deleted file mode 100644 index 561e0c77c6..0000000000 --- a/files/fr/web/api/webglrenderingcontext/deletebuffer/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: WebGLRenderingContext.deleteBuffer() -slug: Web/API/WebGLRenderingContext/deleteBuffer -tags: - - API - - Méthode - - Reference - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/deleteBuffer ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.deleteBuffer() de l'API WebGL supprime le {{domxref ("WebGLBuffer")}} indiqué. Cette méthode n'a aucun effet si le tampon a déjà été supprimé.

- -

Syntaxe

- -
void gl.deleteBuffer(tampon);
-
- -

Paramètres

- -
-
tampon
-
Un objet {{domxref("WebGLBuffer")}} à supprimer.
-
- -

Valeur retournée

- -

Aucune.

- -

Exemples

- -

Suppression d'un tampon

- -
var canevas = document.getElementById('canevas');
-var gl = canevas.getContext('webgl');
-var tampon = gl.createBuffer();
-
-// ...
-
-gl.deleteBuffer(tampon);
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.5", "deleteBuffer")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glDeleteBuffers.xml", "glDeleteBuffers")}}{{Spec2('OpenGL ES 2.0')}}Page man de l’API OpenGL (similaire).
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/deletebuffer/index.md b/files/fr/web/api/webglrenderingcontext/deletebuffer/index.md new file mode 100644 index 0000000000..561e0c77c6 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/deletebuffer/index.md @@ -0,0 +1,77 @@ +--- +title: WebGLRenderingContext.deleteBuffer() +slug: Web/API/WebGLRenderingContext/deleteBuffer +tags: + - API + - Méthode + - Reference + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/deleteBuffer +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.deleteBuffer() de l'API WebGL supprime le {{domxref ("WebGLBuffer")}} indiqué. Cette méthode n'a aucun effet si le tampon a déjà été supprimé.

+ +

Syntaxe

+ +
void gl.deleteBuffer(tampon);
+
+ +

Paramètres

+ +
+
tampon
+
Un objet {{domxref("WebGLBuffer")}} à supprimer.
+
+ +

Valeur retournée

+ +

Aucune.

+ +

Exemples

+ +

Suppression d'un tampon

+ +
var canevas = document.getElementById('canevas');
+var gl = canevas.getContext('webgl');
+var tampon = gl.createBuffer();
+
+// ...
+
+gl.deleteBuffer(tampon);
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.5", "deleteBuffer")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glDeleteBuffers.xml", "glDeleteBuffers")}}{{Spec2('OpenGL ES 2.0')}}Page man de l’API OpenGL (similaire).
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/deleteshader/index.html b/files/fr/web/api/webglrenderingcontext/deleteshader/index.html deleted file mode 100644 index 01a62f3e7a..0000000000 --- a/files/fr/web/api/webglrenderingcontext/deleteshader/index.html +++ /dev/null @@ -1,70 +0,0 @@ ---- -title: WebGLRenderingContext.deleteShader() -slug: Web/API/WebGLRenderingContext/deleteShader -tags: - - API - - Méthode - - Reference - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/deleteShader ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.deleteShader() de l'API WebGL marque l'objet {{domxref("WebGLShader")}} indiqué pour suppression. Il sera ensuite supprimé dès que le shader ne sera plus utilisé. Cette méthode n'a aucun effet si le shader a déjà été supprimé, et le {{domxref ("WebGLShader")}} est automatiquement marqué pour la suppression lorsqu'il est détruit par le garbage collector.

- -

Syntaxe

- -
void gl.deleteShader(shader);
-
- -

Paramètres

- -
-
shader
-
Un objet {{domxref("WebGLShader")}} à détruire.
-
- -

Valeur retournée

- -

Aucune.

- -

Exemples

- -

Suppression d'un shader

- -
gl.deleteShader(shader);
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.9", "deleteShader")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glDeleteShader.xml", "glDeleteShader")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API OpenGL (similaire).
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/deleteshader/index.md b/files/fr/web/api/webglrenderingcontext/deleteshader/index.md new file mode 100644 index 0000000000..01a62f3e7a --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/deleteshader/index.md @@ -0,0 +1,70 @@ +--- +title: WebGLRenderingContext.deleteShader() +slug: Web/API/WebGLRenderingContext/deleteShader +tags: + - API + - Méthode + - Reference + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/deleteShader +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.deleteShader() de l'API WebGL marque l'objet {{domxref("WebGLShader")}} indiqué pour suppression. Il sera ensuite supprimé dès que le shader ne sera plus utilisé. Cette méthode n'a aucun effet si le shader a déjà été supprimé, et le {{domxref ("WebGLShader")}} est automatiquement marqué pour la suppression lorsqu'il est détruit par le garbage collector.

+ +

Syntaxe

+ +
void gl.deleteShader(shader);
+
+ +

Paramètres

+ +
+
shader
+
Un objet {{domxref("WebGLShader")}} à détruire.
+
+ +

Valeur retournée

+ +

Aucune.

+ +

Exemples

+ +

Suppression d'un shader

+ +
gl.deleteShader(shader);
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.9", "deleteShader")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glDeleteShader.xml", "glDeleteShader")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API OpenGL (similaire).
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/drawarrays/index.html b/files/fr/web/api/webglrenderingcontext/drawarrays/index.html deleted file mode 100644 index 8bdffeed97..0000000000 --- a/files/fr/web/api/webglrenderingcontext/drawarrays/index.html +++ /dev/null @@ -1,99 +0,0 @@ ---- -title: WebGLRenderingContext.drawArrays() -slug: Web/API/WebGLRenderingContext/drawArrays -tags: - - API - - Méthode - - Reference - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/drawArrays ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.drawArrays() de l'API WebGL dessine des primitives à partir de données tabulaires.

- -

Syntaxe

- -
void gl.drawArrays(mode, premier, compte);
-
- -

Paramètres

- -
-
mode
-
Un {{domxref ("GLenum")}} indiquant la primitive de type à dessiner. Les valeurs possibles sont : -
    -
  • gl.POINTS : dessine un seul point ;
  • -
  • gl.LINE_STRIP : dessine une ligne droite jusqu'au sommet suivant ;
  • -
  • gl.LINE_LOOP : dessine une ligne droite jusqu'au sommet suivant, et relie le dernier sommet au premier ;
  • -
  • gl.LINES : dessine une ligne entre une paire de sommets ;
  • -
  • gl.TRIANGLE_STRIP
  • -
  • gl.TRIANGLE_FAN
  • -
  • gl.TRIANGLES : dessine un triangle pour un groupe de trois sommets.
  • -
-
-
premier
-
Un {{domxref("GLint")}} indiquant de l'indice de départ dans le tableau des points des vecteurs.
-
compte
-
Un {{domxref("GLsizei")}} indiquant le nombre d'indices à dessiner.
-
- -

Valeur retournée

- -

None.

- -

Exceptions

- - - -

Exemples

- -
gl.drawArrays(gl.POINTS, 0, 8);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.11", "drawArrays")}}{{Spec2('WebGL')}} -

 

- Définition initiale.
{{SpecName('OpenGL ES 2.0', "glDrawArrays.xml", "glDrawArrays")}}{{Spec2('OpenGL ES 2.0')}} -

Page man de l’API OpenGL.

-
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/drawarrays/index.md b/files/fr/web/api/webglrenderingcontext/drawarrays/index.md new file mode 100644 index 0000000000..8bdffeed97 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/drawarrays/index.md @@ -0,0 +1,99 @@ +--- +title: WebGLRenderingContext.drawArrays() +slug: Web/API/WebGLRenderingContext/drawArrays +tags: + - API + - Méthode + - Reference + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/drawArrays +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.drawArrays() de l'API WebGL dessine des primitives à partir de données tabulaires.

+ +

Syntaxe

+ +
void gl.drawArrays(mode, premier, compte);
+
+ +

Paramètres

+ +
+
mode
+
Un {{domxref ("GLenum")}} indiquant la primitive de type à dessiner. Les valeurs possibles sont : +
    +
  • gl.POINTS : dessine un seul point ;
  • +
  • gl.LINE_STRIP : dessine une ligne droite jusqu'au sommet suivant ;
  • +
  • gl.LINE_LOOP : dessine une ligne droite jusqu'au sommet suivant, et relie le dernier sommet au premier ;
  • +
  • gl.LINES : dessine une ligne entre une paire de sommets ;
  • +
  • gl.TRIANGLE_STRIP
  • +
  • gl.TRIANGLE_FAN
  • +
  • gl.TRIANGLES : dessine un triangle pour un groupe de trois sommets.
  • +
+
+
premier
+
Un {{domxref("GLint")}} indiquant de l'indice de départ dans le tableau des points des vecteurs.
+
compte
+
Un {{domxref("GLsizei")}} indiquant le nombre d'indices à dessiner.
+
+ +

Valeur retournée

+ +

None.

+ +

Exceptions

+ + + +

Exemples

+ +
gl.drawArrays(gl.POINTS, 0, 8);
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.11", "drawArrays")}}{{Spec2('WebGL')}} +

 

+ Définition initiale.
{{SpecName('OpenGL ES 2.0', "glDrawArrays.xml", "glDrawArrays")}}{{Spec2('OpenGL ES 2.0')}} +

Page man de l’API OpenGL.

+
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/enable/index.html b/files/fr/web/api/webglrenderingcontext/enable/index.html deleted file mode 100644 index 3a4a7633b1..0000000000 --- a/files/fr/web/api/webglrenderingcontext/enable/index.html +++ /dev/null @@ -1,142 +0,0 @@ ---- -title: WebGLRenderingContext.enable() -slug: Web/API/WebGLRenderingContext/enable -tags: - - API - - Méthode - - Reference - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/enable -original_slug: Web/API/WebGLRenderingContext/activer ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.enable() de l'API WebGL active des fonctionnalités WebGL particulières pour ce contexte.

- -

Syntaxe

- -
void gl.enable(fon);
-
- -

Paramètres

- -
-
fon
-

Un {{domxref("GLenum")}} indiquant quelle fonctionnalité WebGL activer. Valeurs possibles :

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ConstanteDescription
gl.BLENDActive le mélange des valeurs de couleur de fragment calculées. Voir {{domxref("WebGLRenderingContext.blendFunc()")}}.
gl.CULL_FACEActive le masquage des polygones. Voir {{domxref("WebGLRenderingContext.cullFace()")}}.
gl.DEPTH_TESTActive les comparaisons et les mises à jour dans le tampon de profondeur. Voir {{domxref("WebGLRenderingContext.depthFunc()")}}.
gl.DITHERActive le tramage des composantes de couleur avant qu'elles ne soient écrites dans le tampon de couleur.
gl.POLYGON_OFFSET_FILLActive l'ajout d'un décalage aux valeurs de profondeur des fragments de polygone. Voir {{domxref("WebGLRenderingContext.polygonOffset()")}}.
gl.SAMPLE_ALPHA_TO_COVERAGEActive le calcul d'une valeur de couverture temporaire déterminée par la valeur alpha.
gl.SAMPLE_COVERAGEActive le ET de la couverture des fragments avec la valeur de couverture temporaire. Voir {{domxref("WebGLRenderingContext.sampleCoverage()")}}.
gl.SCISSOR_TESTActive le test de détourage qui supprime les fragments se trouvant en dehors du rectangle de détourage. Voir {{domxref("WebGLRenderingContext.scissor()")}}.
gl.STENCIL_TESTActive le test et les mises à jour stencil dans le stencil buffer. Voir {{domxref("WebGLRenderingContext.stencilFunc()")}}.
-

Lors de l'utilisation d'un {{domxref("WebGL2RenderingContext", "WebGL 2 context", "", 1)}}, les valeurs suivantes sont en outre disponibles :

- - - - - - - - - - - - - -
ConstanteDescription
gl.RASTERIZER_DISCARDLes primitives sont supprimées immédiatement après l'étape de rastérisation, mais après l'étape de renvoi de transformation optionnelle. Les commandes gl.clear() sont ignorées.
-
-
- -

Valeur retournée

- -

Aucune.

- -

Exemples

- -
gl.enable(gl.DITHER);
-
- -

Pour vérifier que cette fonctionnalité est activée, utilisez la méthode {{domxref("WebGLRenderingContext.isEnabled()")}} :

- -
gl.isEnabled(gl.DITHER);
-// true
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.3", "enable")}}{{Spec2('WebGL')}}Définition initiale pour WebGL.
{{SpecName('OpenGL ES 2.0', "glEnable.xml", "glEnable")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API OpenGL ES 2.0.
{{SpecName('OpenGL ES 3.0', "glEnable.xhtml", "glEnable")}}{{Spec2('OpenGL ES 3.0')}}Page man de l'API OpenGL ES 3.0 API.
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/enable/index.md b/files/fr/web/api/webglrenderingcontext/enable/index.md new file mode 100644 index 0000000000..3a4a7633b1 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/enable/index.md @@ -0,0 +1,142 @@ +--- +title: WebGLRenderingContext.enable() +slug: Web/API/WebGLRenderingContext/enable +tags: + - API + - Méthode + - Reference + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/enable +original_slug: Web/API/WebGLRenderingContext/activer +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.enable() de l'API WebGL active des fonctionnalités WebGL particulières pour ce contexte.

+ +

Syntaxe

+ +
void gl.enable(fon);
+
+ +

Paramètres

+ +
+
fon
+

Un {{domxref("GLenum")}} indiquant quelle fonctionnalité WebGL activer. Valeurs possibles :

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ConstanteDescription
gl.BLENDActive le mélange des valeurs de couleur de fragment calculées. Voir {{domxref("WebGLRenderingContext.blendFunc()")}}.
gl.CULL_FACEActive le masquage des polygones. Voir {{domxref("WebGLRenderingContext.cullFace()")}}.
gl.DEPTH_TESTActive les comparaisons et les mises à jour dans le tampon de profondeur. Voir {{domxref("WebGLRenderingContext.depthFunc()")}}.
gl.DITHERActive le tramage des composantes de couleur avant qu'elles ne soient écrites dans le tampon de couleur.
gl.POLYGON_OFFSET_FILLActive l'ajout d'un décalage aux valeurs de profondeur des fragments de polygone. Voir {{domxref("WebGLRenderingContext.polygonOffset()")}}.
gl.SAMPLE_ALPHA_TO_COVERAGEActive le calcul d'une valeur de couverture temporaire déterminée par la valeur alpha.
gl.SAMPLE_COVERAGEActive le ET de la couverture des fragments avec la valeur de couverture temporaire. Voir {{domxref("WebGLRenderingContext.sampleCoverage()")}}.
gl.SCISSOR_TESTActive le test de détourage qui supprime les fragments se trouvant en dehors du rectangle de détourage. Voir {{domxref("WebGLRenderingContext.scissor()")}}.
gl.STENCIL_TESTActive le test et les mises à jour stencil dans le stencil buffer. Voir {{domxref("WebGLRenderingContext.stencilFunc()")}}.
+

Lors de l'utilisation d'un {{domxref("WebGL2RenderingContext", "WebGL 2 context", "", 1)}}, les valeurs suivantes sont en outre disponibles :

+ + + + + + + + + + + + + +
ConstanteDescription
gl.RASTERIZER_DISCARDLes primitives sont supprimées immédiatement après l'étape de rastérisation, mais après l'étape de renvoi de transformation optionnelle. Les commandes gl.clear() sont ignorées.
+
+
+ +

Valeur retournée

+ +

Aucune.

+ +

Exemples

+ +
gl.enable(gl.DITHER);
+
+ +

Pour vérifier que cette fonctionnalité est activée, utilisez la méthode {{domxref("WebGLRenderingContext.isEnabled()")}} :

+ +
gl.isEnabled(gl.DITHER);
+// true
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.3", "enable")}}{{Spec2('WebGL')}}Définition initiale pour WebGL.
{{SpecName('OpenGL ES 2.0', "glEnable.xml", "glEnable")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API OpenGL ES 2.0.
{{SpecName('OpenGL ES 3.0', "glEnable.xhtml", "glEnable")}}{{Spec2('OpenGL ES 3.0')}}Page man de l'API OpenGL ES 3.0 API.
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/enablevertexattribarray/index.html b/files/fr/web/api/webglrenderingcontext/enablevertexattribarray/index.html deleted file mode 100644 index a573a50f6c..0000000000 --- a/files/fr/web/api/webglrenderingcontext/enablevertexattribarray/index.html +++ /dev/null @@ -1,119 +0,0 @@ ---- -title: WebGLRenderingContext.enableVertexAttribArray() -slug: Web/API/WebGLRenderingContext/enableVertexAttribArray -tags: - - 3D - - API - - API WebGL - - Attributs des Sommets - - Graphiques - - Méthode - - Reference - - Tableau des Attributs - - WebGL - - WebGLRenderingContext - - enableVertexAttribArray - - shader de sommet - - sommet -translation_of: Web/API/WebGLRenderingContext/enableVertexAttribArray ---- -
{{APIRef("WebGL")}}
- -

La méthode {{domxref ("WebGLRenderingContext")}} enableVertexAttribArray() - qui fait partie de l'API WebGL - active le tableau générique des attributs de sommet à l'indice spécifié dans la liste des tableaux d'attributs.

- -
-

Note : Vous pouvez désactiver le tableau d'attributs en appelant {{domxref("WebGLRenderingContext.disableVertexAttribArray", "disableVertexAttribArray()")}}.

-
- -

Dans WebGL, les valeurs s'appliquant à un sommet particulier sont stockées dans des attributs. Ceux-ci ne sont disponibles que pour le code JavaScript et le shader de sommet. Les attributs sont référencés par un numéro d'indice dans la liste des attributs gérés par la GPU. Certains indices d'attributs de sommet peuvent avoir des buts prédéfinis, suivant la plate-forme et/ou la GPU. D'autres sont affectés par la couche WebGL lorsque vous créez les attributs.

- -

De toute façon, puisque les attributs ne peuvent pas être utilisés sauf s'ils sont activés, et ils sont désactivés par défaut, vous devez appeler enableVertexAttribArray() pour activer les attributs individuels, afin qu'ils puissent être utilisés. Ceci fait, d'autres méthodes peuvent être utilisées pour accéder à l'attribut, y compris {{domxref("WebGLRenderingContext.vertexAttribPointer", "vertexAttribPointer()")}}, {{domxref("WebGLRenderingContext.vertexAttrib", "vertexAttrib*()")}}, et {{domxref("WebGLRenderingContext.getVertexAttrib"," getVertexAttrib()")}}.

- -

Syntaxe

- -
void gl.enableVertexAttribArray(indice);
-
- -

Paramètres

- -
-
indice
-
Un {{domxref("GLuint")}} indiquant le numéro d'indice identifiant de façon unique l'attribut de sommet à activer. Si vous connaissez le nom de l'attribut mais pas son indice, vous pouvez obtenir l'indice en appelant {{domxref ("WebGLRenderingContext.getAttribLocation", "getAttribLocation()")}}.
-
- -

Valeur retournée

- -

undefined.

- -

Erreurs

- -

Pour vérifier d'éventuelles erreurs  après l'appel à enableVertexAttribArray(), appelez {{domxref("WebGLRenderingContext.getError", "getError()")}}.

- -
-
WebGLRenderingContext.INVALID_VALUE
-
L'indice spécifié est invalide, c'est-à-dire qu'il est supérieur ou égal au nombre maximal d'entrées autorisées dans la liste des attributs de sommet du contexte, comme indiqué par la valeur de WebGLRenderingContext.MAX_VERTEX_ATTRIBS.
-
- -

Exemple

- -

Ce code — un extrait de l'exemple complet Un exemple d'animation 2D WebGL de base — montre l'utilisation de enableVertexArray() pour activer l'attribut qui sera utilisé par la couche WebGL pour passer des sommets individuels depuis le tampon des sommets à la fonction shader de sommet.

- -
gl.bindBuffer(gl.ARRAY_BUFFER, vertexBuffer);
-
-aVertexPosition =
-    gl.getAttribLocation(programmeShader, "aVertexPosition");
-
-gl.enableVertexAttribArray(aVertexPosition);
-gl.vertexAttribPointer(aVertexPosition, vertexNumComponents,
-      gl.FLOAT, false, 0, 0);
-
-gl.drawArrays(gl.TRIANGLES, 0, vertexCount);
- -
-

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.

-
- -

Ce code définit le tampon des sommets qui sera utilisé pour dessiner les triangles de la forme en appelant {{domxref("WebGLRenderingContext.bindBuffer", "bindBuffer()")}}. Ensuite, l'indice de l'attribut de position des sommets est obtenu à partir du programme shader en appelant {{domxref("WebGLRenderingContext.getAttribLocation", "getAttribLocation()")}}.

- -

Avec l'indice de l'attribut de position des sommets maintenant disponible dans aVertexPosition, nous appelons enableVertexAttribArray() pour activer l'attribut de position afin qu'il puisse être utilisé par le programme shader (en particulier, par le shader de sommet).

- -

Le tampon des sommets est alors lié à l'attribut aVertexPosition en appelant {{domxref("WebGLRenderingContext.vertexAttribPointer", "vertexAttribPointer()")}}. Cette étape n'est pas évidente, puisque cette liaison est presque un effet de biais. Mais cela a pour résultat qu'un accès à aVertexPosition récupére désormais des données à partir du tampon des sommets.

- -

Avec l'association définie entre le tampon des sommets de notre forme et l'attribut aVertexPosition utilisé pour fournir les sommets un par un dans le shader de sommet, nous sommes prêts à dessiner la forme en appelant {{domxref ("WebGLRenderingContext.drawArrays", "drawArrays()")}}.

- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.10", "enableVertexAttribArray")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glEnableVertexAttribArray.xml", "glEnableVertexAttribArray")}}{{Spec2('OpenGL ES 2.0')}} -

Page man de l’API OpenGL.

-
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/enablevertexattribarray/index.md b/files/fr/web/api/webglrenderingcontext/enablevertexattribarray/index.md new file mode 100644 index 0000000000..a573a50f6c --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/enablevertexattribarray/index.md @@ -0,0 +1,119 @@ +--- +title: WebGLRenderingContext.enableVertexAttribArray() +slug: Web/API/WebGLRenderingContext/enableVertexAttribArray +tags: + - 3D + - API + - API WebGL + - Attributs des Sommets + - Graphiques + - Méthode + - Reference + - Tableau des Attributs + - WebGL + - WebGLRenderingContext + - enableVertexAttribArray + - shader de sommet + - sommet +translation_of: Web/API/WebGLRenderingContext/enableVertexAttribArray +--- +
{{APIRef("WebGL")}}
+ +

La méthode {{domxref ("WebGLRenderingContext")}} enableVertexAttribArray() - qui fait partie de l'API WebGL - active le tableau générique des attributs de sommet à l'indice spécifié dans la liste des tableaux d'attributs.

+ +
+

Note : Vous pouvez désactiver le tableau d'attributs en appelant {{domxref("WebGLRenderingContext.disableVertexAttribArray", "disableVertexAttribArray()")}}.

+
+ +

Dans WebGL, les valeurs s'appliquant à un sommet particulier sont stockées dans des attributs. Ceux-ci ne sont disponibles que pour le code JavaScript et le shader de sommet. Les attributs sont référencés par un numéro d'indice dans la liste des attributs gérés par la GPU. Certains indices d'attributs de sommet peuvent avoir des buts prédéfinis, suivant la plate-forme et/ou la GPU. D'autres sont affectés par la couche WebGL lorsque vous créez les attributs.

+ +

De toute façon, puisque les attributs ne peuvent pas être utilisés sauf s'ils sont activés, et ils sont désactivés par défaut, vous devez appeler enableVertexAttribArray() pour activer les attributs individuels, afin qu'ils puissent être utilisés. Ceci fait, d'autres méthodes peuvent être utilisées pour accéder à l'attribut, y compris {{domxref("WebGLRenderingContext.vertexAttribPointer", "vertexAttribPointer()")}}, {{domxref("WebGLRenderingContext.vertexAttrib", "vertexAttrib*()")}}, et {{domxref("WebGLRenderingContext.getVertexAttrib"," getVertexAttrib()")}}.

+ +

Syntaxe

+ +
void gl.enableVertexAttribArray(indice);
+
+ +

Paramètres

+ +
+
indice
+
Un {{domxref("GLuint")}} indiquant le numéro d'indice identifiant de façon unique l'attribut de sommet à activer. Si vous connaissez le nom de l'attribut mais pas son indice, vous pouvez obtenir l'indice en appelant {{domxref ("WebGLRenderingContext.getAttribLocation", "getAttribLocation()")}}.
+
+ +

Valeur retournée

+ +

undefined.

+ +

Erreurs

+ +

Pour vérifier d'éventuelles erreurs  après l'appel à enableVertexAttribArray(), appelez {{domxref("WebGLRenderingContext.getError", "getError()")}}.

+ +
+
WebGLRenderingContext.INVALID_VALUE
+
L'indice spécifié est invalide, c'est-à-dire qu'il est supérieur ou égal au nombre maximal d'entrées autorisées dans la liste des attributs de sommet du contexte, comme indiqué par la valeur de WebGLRenderingContext.MAX_VERTEX_ATTRIBS.
+
+ +

Exemple

+ +

Ce code — un extrait de l'exemple complet Un exemple d'animation 2D WebGL de base — montre l'utilisation de enableVertexArray() pour activer l'attribut qui sera utilisé par la couche WebGL pour passer des sommets individuels depuis le tampon des sommets à la fonction shader de sommet.

+ +
gl.bindBuffer(gl.ARRAY_BUFFER, vertexBuffer);
+
+aVertexPosition =
+    gl.getAttribLocation(programmeShader, "aVertexPosition");
+
+gl.enableVertexAttribArray(aVertexPosition);
+gl.vertexAttribPointer(aVertexPosition, vertexNumComponents,
+      gl.FLOAT, false, 0, 0);
+
+gl.drawArrays(gl.TRIANGLES, 0, vertexCount);
+ +
+

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.

+
+ +

Ce code définit le tampon des sommets qui sera utilisé pour dessiner les triangles de la forme en appelant {{domxref("WebGLRenderingContext.bindBuffer", "bindBuffer()")}}. Ensuite, l'indice de l'attribut de position des sommets est obtenu à partir du programme shader en appelant {{domxref("WebGLRenderingContext.getAttribLocation", "getAttribLocation()")}}.

+ +

Avec l'indice de l'attribut de position des sommets maintenant disponible dans aVertexPosition, nous appelons enableVertexAttribArray() pour activer l'attribut de position afin qu'il puisse être utilisé par le programme shader (en particulier, par le shader de sommet).

+ +

Le tampon des sommets est alors lié à l'attribut aVertexPosition en appelant {{domxref("WebGLRenderingContext.vertexAttribPointer", "vertexAttribPointer()")}}. Cette étape n'est pas évidente, puisque cette liaison est presque un effet de biais. Mais cela a pour résultat qu'un accès à aVertexPosition récupére désormais des données à partir du tampon des sommets.

+ +

Avec l'association définie entre le tampon des sommets de notre forme et l'attribut aVertexPosition utilisé pour fournir les sommets un par un dans le shader de sommet, nous sommes prêts à dessiner la forme en appelant {{domxref ("WebGLRenderingContext.drawArrays", "drawArrays()")}}.

+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.10", "enableVertexAttribArray")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glEnableVertexAttribArray.xml", "glEnableVertexAttribArray")}}{{Spec2('OpenGL ES 2.0')}} +

Page man de l’API OpenGL.

+
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/generatemipmap/index.html b/files/fr/web/api/webglrenderingcontext/generatemipmap/index.html deleted file mode 100644 index d97ee1aa73..0000000000 --- a/files/fr/web/api/webglrenderingcontext/generatemipmap/index.html +++ /dev/null @@ -1,91 +0,0 @@ ---- -title: WebGLRenderingContext.generateMipmap() -slug: Web/API/WebGLRenderingContext/generateMipmap -tags: - - API - - Méthode - - Reference - - Textures - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/generateMipmap ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.generateMipmap() de l'API WebGL génère un ensemble de mipmaps pour un objet {{domxref("WebGLTexture")}}.

- -

Les mipmaps sont utilisées pour créer de la distance avec des objets. Une mipmap de haute résolution est utilisée pour les objets qui sont proches, et une mipmap de résolution inférieure est utilisée pour les objets qui sont plus éloignés. Elles commencent avec la résolution de l'image de texture, puis la résolution est divisée par deux jusqu'à ce qu'une image de texture de dimension 1x1 soit créée.

- -

Syntaxe

- -
void gl.generateMipmap(cible);
-
- -

Paramètres

- -
-
cible
-
Un {{domxref("GLenum")}} indiquant le point de liaison (cible) de la texture active dont les mipmaps seront générées. Valeurs possibles : -
    -
  • gl.TEXTURE_2D : une  texture bi-dimensionnelle.
  • -
  • gl.TEXTURE_CUBE_MAP : une texture appliquée sur un cube.
  • -
  • Lorsqu'un {{domxref("WebGL2RenderingContext", "WebGL 2 context", "", 1)}} est utilisé, les valeurs suivantes sont en outre disponibles : -
      -
    • gl.TEXTURE_3D : une texture tri-dimensionnelle.
    • -
    • gl.TEXTURE_2D_ARRAY : une texture bi-dimensionnelle en tableau.
    • -
    -
  • -
-
-
- -

Valeur retournée

- -

Aucune.

- -

Exemples

- -
gl.generateMipmap(gl.TEXTURE_2D);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.8", "generateMipmap")}}{{Spec2('WebGL')}}Définition initiale pour WebGL.
{{SpecName('OpenGL ES 2.0', "glGenerateMipmap.xml", "glGenerateMipmap")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API (similaire) d'OpenGL ES 2.0.
{{SpecName('OpenGL ES 3.0', "glGenerateMipmap.xhtml", "glGenerateMipmap")}}{{Spec2('OpenGL ES 3.0')}}Page man de l'API (similaire) d'OpenGL ES 3.0
- Ajoute : gl.TEXTURE_3D et gl.TEXTURE_2D_ARRAY
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/generatemipmap/index.md b/files/fr/web/api/webglrenderingcontext/generatemipmap/index.md new file mode 100644 index 0000000000..d97ee1aa73 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/generatemipmap/index.md @@ -0,0 +1,91 @@ +--- +title: WebGLRenderingContext.generateMipmap() +slug: Web/API/WebGLRenderingContext/generateMipmap +tags: + - API + - Méthode + - Reference + - Textures + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/generateMipmap +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.generateMipmap() de l'API WebGL génère un ensemble de mipmaps pour un objet {{domxref("WebGLTexture")}}.

+ +

Les mipmaps sont utilisées pour créer de la distance avec des objets. Une mipmap de haute résolution est utilisée pour les objets qui sont proches, et une mipmap de résolution inférieure est utilisée pour les objets qui sont plus éloignés. Elles commencent avec la résolution de l'image de texture, puis la résolution est divisée par deux jusqu'à ce qu'une image de texture de dimension 1x1 soit créée.

+ +

Syntaxe

+ +
void gl.generateMipmap(cible);
+
+ +

Paramètres

+ +
+
cible
+
Un {{domxref("GLenum")}} indiquant le point de liaison (cible) de la texture active dont les mipmaps seront générées. Valeurs possibles : +
    +
  • gl.TEXTURE_2D : une  texture bi-dimensionnelle.
  • +
  • gl.TEXTURE_CUBE_MAP : une texture appliquée sur un cube.
  • +
  • Lorsqu'un {{domxref("WebGL2RenderingContext", "WebGL 2 context", "", 1)}} est utilisé, les valeurs suivantes sont en outre disponibles : +
      +
    • gl.TEXTURE_3D : une texture tri-dimensionnelle.
    • +
    • gl.TEXTURE_2D_ARRAY : une texture bi-dimensionnelle en tableau.
    • +
    +
  • +
+
+
+ +

Valeur retournée

+ +

Aucune.

+ +

Exemples

+ +
gl.generateMipmap(gl.TEXTURE_2D);
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.8", "generateMipmap")}}{{Spec2('WebGL')}}Définition initiale pour WebGL.
{{SpecName('OpenGL ES 2.0', "glGenerateMipmap.xml", "glGenerateMipmap")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API (similaire) d'OpenGL ES 2.0.
{{SpecName('OpenGL ES 3.0', "glGenerateMipmap.xhtml", "glGenerateMipmap")}}{{Spec2('OpenGL ES 3.0')}}Page man de l'API (similaire) d'OpenGL ES 3.0
+ Ajoute : gl.TEXTURE_3D et gl.TEXTURE_2D_ARRAY
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/getattriblocation/index.html b/files/fr/web/api/webglrenderingcontext/getattriblocation/index.html deleted file mode 100644 index d12d46f1c6..0000000000 --- a/files/fr/web/api/webglrenderingcontext/getattriblocation/index.html +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: WebGLRenderingContext.getAttribLocation() -slug: Web/API/WebGLRenderingContext/getAttribLocation -tags: - - API - - Méthode - - Reference - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/getAttribLocation ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.getAttribLocation() de l'API WebGL retourne l'emplacement d'une variable d'attribut dans le {{domxref("WebGLProgram")}} indiqué.

- -

Syntaxe

- -
GLint gl.getAttribLocation(programme, nom);
-
- -

Paramètres

- -
-
programme
-
Un {{domxref("WebGLProgram")}} contenant la variable d'attribut.
-
nom
-
Un {{domxref("DOMString")}} indiquant le nom de la variable d'attribut dont l'emplacement est à retourner.
-
- -

Valeur retournée

- -

Un nombre {{domxref("GLint")}} indiquant l'emplacement du nom de la variable si trouvé. Retourne -1 sinon.

- -

Exemples

- -
gl.getAttribLocation(programme, 'vColor');
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.10", "getAttribLocation")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glGetAttribLocation.xml", "glGetAttribLocation")}}{{Spec2('OpenGL ES 2.0')}}Page principale de l'API OpenGL.
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/getattriblocation/index.md b/files/fr/web/api/webglrenderingcontext/getattriblocation/index.md new file mode 100644 index 0000000000..d12d46f1c6 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/getattriblocation/index.md @@ -0,0 +1,69 @@ +--- +title: WebGLRenderingContext.getAttribLocation() +slug: Web/API/WebGLRenderingContext/getAttribLocation +tags: + - API + - Méthode + - Reference + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/getAttribLocation +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.getAttribLocation() de l'API WebGL retourne l'emplacement d'une variable d'attribut dans le {{domxref("WebGLProgram")}} indiqué.

+ +

Syntaxe

+ +
GLint gl.getAttribLocation(programme, nom);
+
+ +

Paramètres

+ +
+
programme
+
Un {{domxref("WebGLProgram")}} contenant la variable d'attribut.
+
nom
+
Un {{domxref("DOMString")}} indiquant le nom de la variable d'attribut dont l'emplacement est à retourner.
+
+ +

Valeur retournée

+ +

Un nombre {{domxref("GLint")}} indiquant l'emplacement du nom de la variable si trouvé. Retourne -1 sinon.

+ +

Exemples

+ +
gl.getAttribLocation(programme, 'vColor');
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.10", "getAttribLocation")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glGetAttribLocation.xml", "glGetAttribLocation")}}{{Spec2('OpenGL ES 2.0')}}Page principale de l'API OpenGL.
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/geterror/index.html b/files/fr/web/api/webglrenderingcontext/geterror/index.html deleted file mode 100644 index 1e3d624e40..0000000000 --- a/files/fr/web/api/webglrenderingcontext/geterror/index.html +++ /dev/null @@ -1,105 +0,0 @@ ---- -title: WebGLRenderingContext.getError() -slug: Web/API/WebGLRenderingContext/getError -tags: - - API - - Méthode - - Reference - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/getError ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.getError() de l'API WebGL retourne des informations d'erreur.

- -

Syntaxe

- -
GLenum gl.getError();
-
- -

Paramètres

- -

Aucun.

- -

Valeur retournée

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ConstanteDescription
gl.NO_ERRORAucune erreur n'a été enregistrée. La valeur de cette constante est 0.
gl.INVALID_ENUMUne valeur non acceptable a été spécifiée pour un argument énuméré. La commande est ignorée et l'indicateur d'erreur est positionné.
gl.INVALID_VALUEUn argument numérique est hors de sa plage. La commande est ignorée et l'indicateur d'erreur est positionné.
gl.INVALID_OPERATIONLa commande indiquée n'est pas permise dans l'état courant. La commande est ignorée et l'indicateur d'erreur est positionné.
gl.INVALID_FRAMEBUFFER_OPERATIONLe tampon d'images actuellement lié n'est pas complet lors d'une tentative de rendu ou de relecture.
gl.OUT_OF_MEMORYPlus assez de mémoire restante pour exécuter la commande.
gl.CONTEXT_LOST_WEBGLSi le contexte WebGL est perdu, cette erreur est retournée lors du premier appel à getError. Après cela et jusqu'à ce que le contexte soit restauré, elle retourne gl.NO_ERROR.
- -

Exemples

- -
gl.getError(); // gl.NO_ERROR (0)
-
-gl.enable(gl.MACHINTRUC);
-gl.getError(); // gl.INVALID_ENUM;
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.3", "getError")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glGetError.xml", "glGetError")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API OpenGL.
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/geterror/index.md b/files/fr/web/api/webglrenderingcontext/geterror/index.md new file mode 100644 index 0000000000..1e3d624e40 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/geterror/index.md @@ -0,0 +1,105 @@ +--- +title: WebGLRenderingContext.getError() +slug: Web/API/WebGLRenderingContext/getError +tags: + - API + - Méthode + - Reference + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/getError +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.getError() de l'API WebGL retourne des informations d'erreur.

+ +

Syntaxe

+ +
GLenum gl.getError();
+
+ +

Paramètres

+ +

Aucun.

+ +

Valeur retournée

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ConstanteDescription
gl.NO_ERRORAucune erreur n'a été enregistrée. La valeur de cette constante est 0.
gl.INVALID_ENUMUne valeur non acceptable a été spécifiée pour un argument énuméré. La commande est ignorée et l'indicateur d'erreur est positionné.
gl.INVALID_VALUEUn argument numérique est hors de sa plage. La commande est ignorée et l'indicateur d'erreur est positionné.
gl.INVALID_OPERATIONLa commande indiquée n'est pas permise dans l'état courant. La commande est ignorée et l'indicateur d'erreur est positionné.
gl.INVALID_FRAMEBUFFER_OPERATIONLe tampon d'images actuellement lié n'est pas complet lors d'une tentative de rendu ou de relecture.
gl.OUT_OF_MEMORYPlus assez de mémoire restante pour exécuter la commande.
gl.CONTEXT_LOST_WEBGLSi le contexte WebGL est perdu, cette erreur est retournée lors du premier appel à getError. Après cela et jusqu'à ce que le contexte soit restauré, elle retourne gl.NO_ERROR.
+ +

Exemples

+ +
gl.getError(); // gl.NO_ERROR (0)
+
+gl.enable(gl.MACHINTRUC);
+gl.getError(); // gl.INVALID_ENUM;
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.3", "getError")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glGetError.xml", "glGetError")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API OpenGL.
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/getshaderparameter/index.html b/files/fr/web/api/webglrenderingcontext/getshaderparameter/index.html deleted file mode 100644 index 46c5369067..0000000000 --- a/files/fr/web/api/webglrenderingcontext/getshaderparameter/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: WebGLRenderingContext.getShaderParameter() -slug: Web/API/WebGLRenderingContext/getShaderParameter -tags: - - API - - Méthode - - Reference - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/getShaderParameter ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.getShaderParameter() de l'API WebGL retourne des informations sur le shader donné.

- -

Syntaxe

- -
quelconque gl.getShaderParameter(shader, nomp);
-
- -

Parameters

- -
-
shader
-
Un {{domxref("WebGLShader")}} depuis lequel obtenir une information de paramètre.
-
nomp
-
Un {{domxref("Glenum")}} indiquant l'information à retrouver. Valeurs possibles : -
    -
  • gl.DELETE_STATUS : retourne un {{domxref("GLboolean")}} indicating si le shader est marqué pour suppression ou non.
  • -
  • gl.COMPILE_STATUS : retourne un {{domxref("GLboolean")}} indiquant si la dernière compilation du shader a réussi ou non.
  • -
  • gl.SHADER_TYPE : retourne un {{domxref("GLenum")}} indiquant si le shader est un objet shader de sommets (gl.VERTEX_SHADER) ou shader de fragment (gl.FRAGMENT_SHADER).
  • -
-
-
- -

Valeur retournée

- -

Retourne l'information de shader demandée (telle qu'indiquée par nomp).

- -

Exemples

- -
gl.getShaderParameter(shader, gl.SHADER_TYPE);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.9", "getShaderParameter")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glGetShaderiv.xml", "glGetShaderiv")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API OpenGL (similaire).
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/getshaderparameter/index.md b/files/fr/web/api/webglrenderingcontext/getshaderparameter/index.md new file mode 100644 index 0000000000..46c5369067 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/getshaderparameter/index.md @@ -0,0 +1,75 @@ +--- +title: WebGLRenderingContext.getShaderParameter() +slug: Web/API/WebGLRenderingContext/getShaderParameter +tags: + - API + - Méthode + - Reference + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/getShaderParameter +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.getShaderParameter() de l'API WebGL retourne des informations sur le shader donné.

+ +

Syntaxe

+ +
quelconque gl.getShaderParameter(shader, nomp);
+
+ +

Parameters

+ +
+
shader
+
Un {{domxref("WebGLShader")}} depuis lequel obtenir une information de paramètre.
+
nomp
+
Un {{domxref("Glenum")}} indiquant l'information à retrouver. Valeurs possibles : +
    +
  • gl.DELETE_STATUS : retourne un {{domxref("GLboolean")}} indicating si le shader est marqué pour suppression ou non.
  • +
  • gl.COMPILE_STATUS : retourne un {{domxref("GLboolean")}} indiquant si la dernière compilation du shader a réussi ou non.
  • +
  • gl.SHADER_TYPE : retourne un {{domxref("GLenum")}} indiquant si le shader est un objet shader de sommets (gl.VERTEX_SHADER) ou shader de fragment (gl.FRAGMENT_SHADER).
  • +
+
+
+ +

Valeur retournée

+ +

Retourne l'information de shader demandée (telle qu'indiquée par nomp).

+ +

Exemples

+ +
gl.getShaderParameter(shader, gl.SHADER_TYPE);
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.9", "getShaderParameter")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glGetShaderiv.xml", "glGetShaderiv")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API OpenGL (similaire).
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/gettexparameter/index.html b/files/fr/web/api/webglrenderingcontext/gettexparameter/index.html deleted file mode 100644 index a153da3ba0..0000000000 --- a/files/fr/web/api/webglrenderingcontext/gettexparameter/index.html +++ /dev/null @@ -1,199 +0,0 @@ ---- -title: WebGLRenderingContext.getTexParameter() -slug: Web/API/WebGLRenderingContext/getTexParameter -tags: - - API - - Méthode - - Reference - - Textures - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/getTexParameter ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.getTexParameter() de l'API WebGL retourne des informations concernant la texture indiquée.

- -

Syntaxe

- -
quelconque gl.getTexParameter(cible, nomp);
-
- -

Paramètres

- -
-
cible
-
Un {{domxref("GLenum")}} indiquant le point de liaison (cible). Valeurs possibles : -
    -
  • gl.TEXTURE_2D : une texture bi-dimensionnelle.
  • -
  • gl.TEXTURE_CUBE_MAP : une texture appliquée à un cube.
  • -
  • Lorsqu' un {{domxref("WebGL2RenderingContext", "WebGL 2 context", "", 1)}} est utilisé, les valeurs suivantes sont en outre disponibles : -
      -
    • gl.TEXTURE_3D : une texture tri-dimensionnelle.
    • -
    • gl.TEXTURE_2D_ARRAY : une texture bi-dimensionnelle en tableau.
    • -
    -
  • -
-
-
nomp
-
Un {{domxref("Glenum")}} indiquant l'information à obtenir. Valeurs possibles : - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
nompType retournéDescriptionValeurs retournées possibles
Disponible dans un contexte WebGL 1
gl.TEXTURE_MAG_FILTER{{domxref("GLenum")}}Filtre de grossissement de texturegl.LINEAR (valeur par défaut), gl.NEAREST.
gl.TEXTURE_MIN_FILTER{{domxref("GLenum")}}Filtre de réduction de texturegl.LINEAR, gl.NEAREST, gl.NEAREST_MIPMAP_NEAREST, gl.LINEAR_MIPMAP_NEAREST, gl.NEAREST_MIPMAP_LINEAR (valeur par défaut), gl.LINEAR_MIPMAP_LINEAR.
gl.TEXTURE_WRAP_S{{domxref("GLenum")}}Fonction d'emballage pour la coordonnée de texture sgl.REPEAT (valeur par défaut), gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.
gl.TEXTURE_WRAP_T{{domxref("GLenum")}}Fonction d'emballage pour la coordonnée de texture tgl.REPEAT (valeur par défaut), gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.
Disponible en outre lorsque l'extension {{domxref("EXT_texture_filter_anisotropic")}} est utilisée
ext.TEXTURE_MAX_ANISOTROPY_EXT{{domxref("GLfloat")}}Anisotropie maximum pour une textureToutes valeurs float.
Disponible en outre lorsqu'un contexte WebGL 2 est utilisé
gl.TEXTURE_BASE_LEVEL{{domxref("GLint")}}Niveau  de mipmap de textureToutes valeurs int.
gl.TEXTURE_COMPARE_FUNC{{domxref("GLenum")}}Fonction de comparaisongl.LEQUAL (valeurs par défaut), gl.GEQUAL, gl.LESS, gl.GREATER, gl.EQUAL, gl.NOTEQUAL, gl.ALWAYS, gl.NEVER.
gl.TEXTURE_COMPARE_MODE{{domxref("GLenum")}}Mode de comparaison de texturegl.NONE (valeur par défaut), gl.COMPARE_REF_TO_TEXTURE.
gl.TEXTURE_IMMUTABLE_FORMAT{{domxref("GLboolean")}}Immuabilité du format et de la taille de la texturetrue ou false.
gl.TEXTURE_IMMUTABLE_LEVELS{{domxref("GLuint")}}?Toutes valeurs uint.
gl.TEXTURE_MAX_LEVEL{{domxref("GLint")}}Niveau maximum  de mipmap de texture en tableauToutes valeurs int.
gl.TEXTURE_MAX_LOD{{domxref("GLfloat")}}Valeur de niveau-de-détail maximum de textureToutes valeurs float.
gl.TEXTURE_MIN_LOD{{domxref("GLfloat")}}Valeur de niveau-de-détail minimum de textureToutes valeurs float.
gl.TEXTURE_WRAP_R{{domxref("GLenum")}}Fonction d'emballage pour la coordonnée de texture  rgl.REPEAT (valeur par défaut), gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.
-
-
- -

Valeur retournée

- -

Retourne l'information de texture demandée (telle qu'indiquée par nomp). Si une erreur se produit, {{jsxref("null")}} est retourné.

- -

Exemples

- -
gl.getTexParameter(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.8", "getTexParameter")}}{{Spec2('WebGL')}}Définition initiale pour WebGL.
{{SpecName('OpenGL ES 2.0', "glGetTexParameter.xml", "glGetTexParameter")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API OpenGL ES 2.0 (similaire).
{{SpecName('WebGL2', "#3.7.6", "getTexParameter")}}{{Spec2('WebGL2')}}Définition mise à jour pour WebGL.
{{SpecName('OpenGL ES 3.0', "glGetTexParameter.xhtml", "glGetTexParameter")}}{{Spec2('OpenGL ES 3.0')}}Page man de l'API OpenGL ES 3.0 (similaire).
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/gettexparameter/index.md b/files/fr/web/api/webglrenderingcontext/gettexparameter/index.md new file mode 100644 index 0000000000..a153da3ba0 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/gettexparameter/index.md @@ -0,0 +1,199 @@ +--- +title: WebGLRenderingContext.getTexParameter() +slug: Web/API/WebGLRenderingContext/getTexParameter +tags: + - API + - Méthode + - Reference + - Textures + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/getTexParameter +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.getTexParameter() de l'API WebGL retourne des informations concernant la texture indiquée.

+ +

Syntaxe

+ +
quelconque gl.getTexParameter(cible, nomp);
+
+ +

Paramètres

+ +
+
cible
+
Un {{domxref("GLenum")}} indiquant le point de liaison (cible). Valeurs possibles : +
    +
  • gl.TEXTURE_2D : une texture bi-dimensionnelle.
  • +
  • gl.TEXTURE_CUBE_MAP : une texture appliquée à un cube.
  • +
  • Lorsqu' un {{domxref("WebGL2RenderingContext", "WebGL 2 context", "", 1)}} est utilisé, les valeurs suivantes sont en outre disponibles : +
      +
    • gl.TEXTURE_3D : une texture tri-dimensionnelle.
    • +
    • gl.TEXTURE_2D_ARRAY : une texture bi-dimensionnelle en tableau.
    • +
    +
  • +
+
+
nomp
+
Un {{domxref("Glenum")}} indiquant l'information à obtenir. Valeurs possibles : + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
nompType retournéDescriptionValeurs retournées possibles
Disponible dans un contexte WebGL 1
gl.TEXTURE_MAG_FILTER{{domxref("GLenum")}}Filtre de grossissement de texturegl.LINEAR (valeur par défaut), gl.NEAREST.
gl.TEXTURE_MIN_FILTER{{domxref("GLenum")}}Filtre de réduction de texturegl.LINEAR, gl.NEAREST, gl.NEAREST_MIPMAP_NEAREST, gl.LINEAR_MIPMAP_NEAREST, gl.NEAREST_MIPMAP_LINEAR (valeur par défaut), gl.LINEAR_MIPMAP_LINEAR.
gl.TEXTURE_WRAP_S{{domxref("GLenum")}}Fonction d'emballage pour la coordonnée de texture sgl.REPEAT (valeur par défaut), gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.
gl.TEXTURE_WRAP_T{{domxref("GLenum")}}Fonction d'emballage pour la coordonnée de texture tgl.REPEAT (valeur par défaut), gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.
Disponible en outre lorsque l'extension {{domxref("EXT_texture_filter_anisotropic")}} est utilisée
ext.TEXTURE_MAX_ANISOTROPY_EXT{{domxref("GLfloat")}}Anisotropie maximum pour une textureToutes valeurs float.
Disponible en outre lorsqu'un contexte WebGL 2 est utilisé
gl.TEXTURE_BASE_LEVEL{{domxref("GLint")}}Niveau  de mipmap de textureToutes valeurs int.
gl.TEXTURE_COMPARE_FUNC{{domxref("GLenum")}}Fonction de comparaisongl.LEQUAL (valeurs par défaut), gl.GEQUAL, gl.LESS, gl.GREATER, gl.EQUAL, gl.NOTEQUAL, gl.ALWAYS, gl.NEVER.
gl.TEXTURE_COMPARE_MODE{{domxref("GLenum")}}Mode de comparaison de texturegl.NONE (valeur par défaut), gl.COMPARE_REF_TO_TEXTURE.
gl.TEXTURE_IMMUTABLE_FORMAT{{domxref("GLboolean")}}Immuabilité du format et de la taille de la texturetrue ou false.
gl.TEXTURE_IMMUTABLE_LEVELS{{domxref("GLuint")}}?Toutes valeurs uint.
gl.TEXTURE_MAX_LEVEL{{domxref("GLint")}}Niveau maximum  de mipmap de texture en tableauToutes valeurs int.
gl.TEXTURE_MAX_LOD{{domxref("GLfloat")}}Valeur de niveau-de-détail maximum de textureToutes valeurs float.
gl.TEXTURE_MIN_LOD{{domxref("GLfloat")}}Valeur de niveau-de-détail minimum de textureToutes valeurs float.
gl.TEXTURE_WRAP_R{{domxref("GLenum")}}Fonction d'emballage pour la coordonnée de texture  rgl.REPEAT (valeur par défaut), gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.
+
+
+ +

Valeur retournée

+ +

Retourne l'information de texture demandée (telle qu'indiquée par nomp). Si une erreur se produit, {{jsxref("null")}} est retourné.

+ +

Exemples

+ +
gl.getTexParameter(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER);
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.8", "getTexParameter")}}{{Spec2('WebGL')}}Définition initiale pour WebGL.
{{SpecName('OpenGL ES 2.0', "glGetTexParameter.xml", "glGetTexParameter")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API OpenGL ES 2.0 (similaire).
{{SpecName('WebGL2', "#3.7.6", "getTexParameter")}}{{Spec2('WebGL2')}}Définition mise à jour pour WebGL.
{{SpecName('OpenGL ES 3.0', "glGetTexParameter.xhtml", "glGetTexParameter")}}{{Spec2('OpenGL ES 3.0')}}Page man de l'API OpenGL ES 3.0 (similaire).
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + 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

+ + diff --git a/files/fr/web/api/webglrenderingcontext/index.html b/files/fr/web/api/webglrenderingcontext/index.html deleted file mode 100644 index 437dbe6f19..0000000000 --- a/files/fr/web/api/webglrenderingcontext/index.html +++ /dev/null @@ -1,367 +0,0 @@ ---- -title: WebGLRenderingContext -slug: Web/API/WebGLRenderingContext -tags: - - NeedsTranslation - - TopicStub - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext ---- -
{{APIRef("WebGL")}}
- -
L'interface WebGLRenderingContext fournit le contexte de rendu OpenGL ES 2.0 pour le dessin d'une suface dans un élément HTML {{HTMLElement("canvas")}}.
- -
 
- -

Pour obtenir une instance de cette interface, appelez {{domxref("HTMLCanvasElement.getContext()", "getContext()")}} sur un élément <canvas>, en spécifiant "webgl" en paramètre :

- -
var canvas = document.getElementById('myCanvas');
-var gl = canvas.getContext('webgl');
-
- -

Une fois que avez le contexte de rendu WebGL, vous pouvez dessiner à l'intérieur.

- -

Le tutoriel WebGL contient plus d'informations, d'exemples, et de ressources sur comment débuter en WebGL.

- -

Constants

- -

See the WebGL constants page.

- -

The WebGL context

- -

The following properties and methods provide general information and functionality to deal with the WebGL context:

- -
-
{{domxref("WebGLRenderingContext.canvas")}}
-
A read-only back-reference to the {{domxref("HTMLCanvasElement")}}. Might be {{jsxref("null")}} if it is not associated with a {{HTMLElement("canvas")}} element.
-
{{domxref("WebGLRenderingContext.commit()")}} {{experimental_inline}}
-
-

Pushes frames back to the original {{domxref("HTMLCanvasElement")}}, if the context is not directly fixed to a specific canvas.

-
-
{{domxref("WebGLRenderingContext.drawingBufferWidth")}}
-
The read-only width of the current drawing buffer. Should match the width of the canvas element associated with this context.
-
{{domxref("WebGLRenderingContext.drawingBufferHeight")}}
-
The read-only height of the current drawing buffer. Should match the height of the canvas element associated with this context.
-
{{domxref("WebGLRenderingContext.getContextAttributes()")}}
-
Returns a WebGLContextAttributes object that contains the actual context parameters. Might return {{jsxref("null")}}, if the context is lost.
-
{{domxref("WebGLRenderingContext.isContextLost()")}}
-
Returns true if the context is lost, otherwise returns false.
-
- -

Viewing and clipping

- -
-
{{domxref("WebGLRenderingContext.scissor()")}}
-
Defines the scissor box.
-
{{domxref("WebGLRenderingContext.viewport()")}}
-
Sets the viewport.
-
- -

State information

- -
-
{{domxref("WebGLRenderingContext.activeTexture()")}}
-
Selects the active texture unit.
-
{{domxref("WebGLRenderingContext.blendColor()")}}
-
Sets the source and destination blending factors.
-
{{domxref("WebGLRenderingContext.blendEquation()")}}
-
Sets both the RGB blend equation and alpha blend equation to a single equation.
-
{{domxref("WebGLRenderingContext.blendEquationSeparate()")}}
-
Sets the RGB blend equation and alpha blend equation separately.
-
{{domxref("WebGLRenderingContext.blendFunc()")}}
-
Defines which function is used for blending pixel arithmetic.
-
{{domxref("WebGLRenderingContext.blendFuncSeparate()")}}
-
Defines which function is used for blending pixel arithmetic for RGB and alpha components separately.
-
{{domxref("WebGLRenderingContext.clearColor()")}}
-
Specifies the color values used when clearing color buffers.
-
{{domxref("WebGLRenderingContext.clearDepth()")}}
-
Specifies the depth value used when clearing the depth buffer.
-
{{domxref("WebGLRenderingContext.clearStencil()")}}
-
Specifies the stencil value used when clearing the stencil buffer.
-
{{domxref("WebGLRenderingContext.colorMask()")}}
-
Sets which color components to enable or to disable when drawing or rendering to a {{domxref("WebGLFramebuffer")}}.
-
{{domxref("WebGLRenderingContext.cullFace()")}}
-
Specifies whether or not front- and/or back-facing polygons can be culled.
-
{{domxref("WebGLRenderingContext.depthFunc()")}}
-
Specifies a function that compares incoming pixel depth to the current depth buffer value.
-
{{domxref("WebGLRenderingContext.depthMask()")}}
-
Sets whether writing into the depth buffer is enabled or disabled.
-
{{domxref("WebGLRenderingContext.depthRange()")}}
-
Specifies the depth range mapping from normalized device coordinates to window or viewport coordinates.
-
{{domxref("WebGLRenderingContext.disable()")}}
-
Disables specific WebGL capabilities for this context.
-
{{domxref("WebGLRenderingContext.enable()")}}
-
Enables specific WebGL capabilities for this context.
-
{{domxref("WebGLRenderingContext.frontFace()")}}
-
Specifies whether polygons are front- or back-facing by setting a winding orientation.
-
{{domxref("WebGLRenderingContext.getParameter()")}}
-
Returns a value for the passed parameter name.
-
{{domxref("WebGLRenderingContext.getError()")}}
-
Returns error information.
-
{{domxref("WebGLRenderingContext.hint()")}}
-
Specifies hints for certain behaviors. The interpretation of these hints depend on the implementation.
-
{{domxref("WebGLRenderingContext.isEnabled()")}}
-
Tests whether a specific WebGL capability is enabled or not for this context.
-
{{domxref("WebGLRenderingContext.lineWidth()")}}
-
Sets the line width of rasterized lines.
-
{{domxref("WebGLRenderingContext.pixelStorei()")}}
-
Specifies the pixel storage modes
-
{{domxref("WebGLRenderingContext.polygonOffset()")}}
-
Specifies the scale factors and units to calculate depth values.
-
{{domxref("WebGLRenderingContext.sampleCoverage()")}}
-
Specifies multi-sample coverage parameters for anti-aliasing effects.
-
{{domxref("WebGLRenderingContext.stencilFunc()")}}
-
Sets the both front and back function and reference value for stencil testing.
-
{{domxref("WebGLRenderingContext.stencilFuncSeparate()")}}
-
Sets the front and/or back function and reference value for stencil testing.
-
{{domxref("WebGLRenderingContext.stencilMask()")}}
-
Controls enabling and disabling of both the front and back writing of individual bits in the stencil planes.
-
{{domxref("WebGLRenderingContext.stencilMaskSeparate()")}}
-
Controls enabling and disabling of front and/or back writing of individual bits in the stencil planes.
-
{{domxref("WebGLRenderingContext.stencilOp()")}}
-
Sets both the front and back-facing stencil test actions.
-
{{domxref("WebGLRenderingContext.stencilOpSeparate()")}}
-
Sets the front and/or back-facing stencil test actions.
-
- -

Buffers

- -
-
{{domxref("WebGLRenderingContext.bindBuffer()")}}
-
Binds a WebGLBuffer object to a given target.
-
{{domxref("WebGLRenderingContext.bufferData()")}}
-
Updates buffer data.
-
{{domxref("WebGLRenderingContext.bufferSubData()")}}
-
Updates buffer data starting at a passed offset.
-
{{domxref("WebGLRenderingContext.createBuffer()")}}
-
Creates a WebGLBuffer object.
-
{{domxref("WebGLRenderingContext.deleteBuffer()")}}
-
Deletes a WebGLBuffer object.
-
{{domxref("WebGLRenderingContext.getBufferParameter()")}}
-
Returns information about the buffer.
-
{{domxref("WebGLRenderingContext.isBuffer()")}}
-
Returns a Boolean indicating if the passed buffer is valid.
-
- -

Framebuffers

- -
-
{{domxref("WebGLRenderingContext.bindFramebuffer()")}}
-
Binds a WebGLFrameBuffer object to a given target.
-
{{domxref("WebGLRenderingContext.checkFramebufferStatus()")}}
-
Returns the status of the framebuffer.
-
{{domxref("WebGLRenderingContext.createFramebuffer()")}}
-
Creates a WebGLFrameBuffer object.
-
{{domxref("WebGLRenderingContext.deleteFramebuffer()")}}
-
Deletes a WebGLFrameBuffer object.
-
{{domxref("WebGLRenderingContext.framebufferRenderbuffer()")}}
-
Attaches a WebGLRenderingBuffer object to a WebGLFrameBuffer object.
-
{{domxref("WebGLRenderingContext.framebufferTexture2D()")}}
-
Attaches a textures image to a WebGLFrameBuffer object.
-
{{domxref("WebGLRenderingContext.getFramebufferAttachmentParameter()")}}
-
Returns information about the framebuffer.
-
{{domxref("WebGLRenderingContext.isFramebuffer()")}}
-
Returns a Boolean indicating if the passed WebGLFrameBuffer object is valid.
-
{{domxref("WebGLRenderingContext.readPixels()")}}
-
Reads a block of pixels from the WebGLFrameBuffer.
-
- -

Renderbuffers

- -
-
{{domxref("WebGLRenderingContext.bindRenderbuffer()")}}
-
Binds a WebGLRenderBuffer object to a given target.
-
{{domxref("WebGLRenderingContext.createRenderbuffer()")}}
-
Creates a WebGLRenderBuffer object.
-
{{domxref("WebGLRenderingContext.deleteRenderbuffer()")}}
-
Deletes a WebGLRenderBuffer object.
-
{{domxref("WebGLRenderingContext.getRenderbufferParameter()")}}
-
Returns information about the renderbuffer.
-
{{domxref("WebGLRenderingContext.isRenderbuffer()")}}
-
Returns a Boolean indicating if the passed WebGLRenderingBuffer is valid.
-
{{domxref("WebGLRenderingContext.renderbufferStorage()")}}
-
Creates a renderbuffer data store.
-
- -

Textures

- -
-
{{domxref("WebGLRenderingContext.bindTexture()")}}
-
Binds a WebGLTexture object to a given target.
-
{{domxref("WebGLRenderingContext.compressedTexImage2D()")}}
-
Specifies a 2D texture image in a compressed format.
-
{{domxref("WebGLRenderingContext.compressedTexSubImage2D()")}}
-
Specifies a 2D texture sub-image in a compressed format.
-
{{domxref("WebGLRenderingContext.copyTexImage2D()")}}
-
Copies a 2D texture image.
-
{{domxref("WebGLRenderingContext.copyTexSubImage2D()")}}
-
Copies a 2D texture sub-image.
-
{{domxref("WebGLRenderingContext.createTexture()")}}
-
Creates a WebGLTexture object.
-
{{domxref("WebGLRenderingContext.deleteTexture()")}}
-
Deletes a WebGLTexture object.
-
{{domxref("WebGLRenderingContext.generateMipmap()")}}
-
Generates a set of mipmaps for a WebGLTexture object.
-
{{domxref("WebGLRenderingContext.getTexParameter()")}}
-
Returns information about the texture.
-
{{domxref("WebGLRenderingContext.isTexture()")}}
-
Returns a Boolean indicating if the passed WebGLTexture is valid.
-
{{domxref("WebGLRenderingContext.texImage2D()")}}
-
Specifies a 2D texture image.
-
{{domxref("WebGLRenderingContext.texSubImage2D()")}}
-
Updates a sub-rectangle of the current WebGLTexture.
-
{{domxref("WebGLRenderingContext.texParameter", "WebGLRenderingContext.texParameterf()")}}
-
Sets texture parameters.
-
{{domxref("WebGLRenderingContext.texParameter", "WebGLRenderingContext.texParameteri()")}}
-
Sets texture parameters.
-
- -

Programs and shaders

- -
-
{{domxref("WebGLRenderingContext.attachShader()")}}
-
Attaches a WebGLShader to a WebGLProgram.
-
{{domxref("WebGLRenderingContext.bindAttribLocation()")}}
-
Binds a generic vertex index to a named attribute variable.
-
{{domxref("WebGLRenderingContext.compileShader()")}}
-
Compiles a WebGLShader.
-
{{domxref("WebGLRenderingContext.createProgram()")}}
-
Creates a WebGLProgram.
-
{{domxref("WebGLRenderingContext.createShader()")}}
-
Creates a WebGLShader.
-
{{domxref("WebGLRenderingContext.deleteProgram()")}}
-
Deletes a WebGLProgram.
-
{{domxref("WebGLRenderingContext.deleteShader()")}}
-
Deletes a WebGLShader.
-
{{domxref("WebGLRenderingContext.detachShader()")}}
-
Detaches a WebGLShader.
-
{{domxref("WebGLRenderingContext.getAttachedShaders()")}}
-
Returns a list of WebGLShader objects attached to a WebGLProgram.
-
{{domxref("WebGLRenderingContext.getProgramParameter()")}}
-
Returns information about the program.
-
{{domxref("WebGLRenderingContext.getProgramInfoLog()")}}
-
Returns the information log for a WebGLProgram object.
-
{{domxref("WebGLRenderingContext.getShaderParameter()")}}
-
Returns information about the shader.
-
{{domxref("WebGLRenderingContext.getShaderPrecisionFormat()")}}
-
Returns a WebGLShaderPrecisionFormat object describing the precision for the numeric format of the shader.
-
{{domxref("WebGLRenderingContext.getShaderInfoLog()")}}
-
Returns the information log for a WebGLShader object.
-
{{domxref("WebGLRenderingContext.getShaderSource()")}}
-
Returns the source code of a WebGLShader as a string.
-
{{domxref("WebGLRenderingContext.isProgram()")}}
-
Returns a Boolean indicating if the passed WebGLProgram is valid.
-
{{domxref("WebGLRenderingContext.isShader()")}}
-
Returns a Boolean indicating if the passed WebGLShader is valid.
-
{{domxref("WebGLRenderingContext.linkProgram()")}}
-
Links the passed WebGLProgram object.
-
{{domxref("WebGLRenderingContext.shaderSource()")}}
-
Sets the source code in a WebGLShader.
-
{{domxref("WebGLRenderingContext.useProgram()")}}
-
Uses the specified WebGLProgram as part the current rendering state.
-
{{domxref("WebGLRenderingContext.validateProgram()")}}
-
Validates a WebGLProgram.
-
- -

Uniforms and attributes

- -
-
{{domxref("WebGLRenderingContext.disableVertexAttribArray()")}}
-
Disables a vertex attribute array at a given position.
-
{{domxref("WebGLRenderingContext.enableVertexAttribArray()")}}
-
Enables a vertex attribute array at a given position.
-
{{domxref("WebGLRenderingContext.getActiveAttrib()")}}
-
Returns information about an active attribute variable.
-
{{domxref("WebGLRenderingContext.getActiveUniform()")}}
-
Returns information about an active uniform variable.
-
{{domxref("WebGLRenderingContext.getAttribLocation()")}}
-
Returns the location of an attribute variable.
-
{{domxref("WebGLRenderingContext.getUniform()")}}
-
Returns the value of a uniform variable at a given location.
-
{{domxref("WebGLRenderingContext.getUniformLocation()")}}
-
Returns the location of a uniform variable.
-
{{domxref("WebGLRenderingContext.getVertexAttrib()")}}
-
Returns information about a vertex attribute at a given position.
-
{{domxref("WebGLRenderingContext.getVertexAttribOffset()")}}
-
Returns the address of a given vertex attribute.
-
{{domxref("WebGLRenderingContext.uniform()", "WebGLRenderingContext.uniform[1234][fi][v]()")}}
-
Specifies a value for a uniform variable.
-
{{domxref("WebGLRenderingContext.uniformMatrix()", "WebGLRenderingContext.uniformMatrix[234]fv()")}}
-
Specifies a matrix value for a uniform variable.
-
{{domxref("WebGLRenderingContext.vertexAttrib()", "WebGLRenderingContext.vertexAttrib[1234]f[v]()")}}
-
Specifies a value for a generic vertex attribute.
-
{{domxref("WebGLRenderingContext.vertexAttribPointer()")}}
-
Specifies the data formats and locations of vertex attributes in a vertex attributes array.
-
- -

Drawing buffers

- -
-
{{domxref("WebGLRenderingContext.clear()")}}
-
Clears specified buffers to preset values.
-
{{domxref("WebGLRenderingContext.drawArrays()")}}
-
Renders primitives from array data.
-
{{domxref("WebGLRenderingContext.drawElements()")}}
-
Renders primitives from element array data.
-
{{domxref("WebGLRenderingContext.finish()")}}
-
Blocks execution until all previously called commands are finished.
-
{{domxref("WebGLRenderingContext.flush()")}}
-
Empties different buffer commands, causing all commands to be executed as quickly as possible.
-
- -

Working with extensions

- -

These methods manage WebGL extensions:

- -
-
{{domxref("WebGLRenderingContext.getSupportedExtensions()")}}
-
Returns an {{jsxref("Array")}} of {{domxref("DOMString")}} elements with all the supported WebGL extensions.
-
{{domxref("WebGLRenderingContext.getExtension()")}}
-
Returns an extension object.
-
- -

Examples

- -

WebGL context feature detection

- -

{{page("/en-US/Learn/WebGL/By_example/Detect_WebGL", "summary")}}

- -

{{page("/en-US/Learn/WebGL/By_example/Detect_WebGL", "detect-webgl-source")}}

- -

{{EmbedLiveSample("detect-webgl-source", 660,150 ,"" , "Learn/WebGL/By_example/Detect_WebGL")}}

- -

Effect of canvas size on rendering with WebGL

- -

{{page("/en-US/Learn/WebGL/By_example/Canvas_size_and_WebGL", "canvas-size-and-webgl-intro")}}

- -

{{page("/en-US/Learn/WebGL/By_example/Canvas_size_and_WebGL", "canvas-size-and-webgl-source")}}

- -

{{EmbedLiveSample("canvas-size-and-webgl-source", 660,180 ,"" , "Learn/WebGL/By_example/Canvas_size_and_WebGL")}}

- -

Specifications

- - - - - - - - - - - - - - -
SpecificationStatusComment
{{SpecName('WebGL', "#5.14", "WebGLRenderingContext")}}{{Spec2('WebGL')}}Initial definition
- -

Browser compatibility

- -

{{Compat("api/WebGLRenderingContext", "WebGLRenderingContext")}}

- -

See also

- - diff --git a/files/fr/web/api/webglrenderingcontext/index.md b/files/fr/web/api/webglrenderingcontext/index.md new file mode 100644 index 0000000000..437dbe6f19 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/index.md @@ -0,0 +1,367 @@ +--- +title: WebGLRenderingContext +slug: Web/API/WebGLRenderingContext +tags: + - NeedsTranslation + - TopicStub + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext +--- +
{{APIRef("WebGL")}}
+ +
L'interface WebGLRenderingContext fournit le contexte de rendu OpenGL ES 2.0 pour le dessin d'une suface dans un élément HTML {{HTMLElement("canvas")}}.
+ +
 
+ +

Pour obtenir une instance de cette interface, appelez {{domxref("HTMLCanvasElement.getContext()", "getContext()")}} sur un élément <canvas>, en spécifiant "webgl" en paramètre :

+ +
var canvas = document.getElementById('myCanvas');
+var gl = canvas.getContext('webgl');
+
+ +

Une fois que avez le contexte de rendu WebGL, vous pouvez dessiner à l'intérieur.

+ +

Le tutoriel WebGL contient plus d'informations, d'exemples, et de ressources sur comment débuter en WebGL.

+ +

Constants

+ +

See the WebGL constants page.

+ +

The WebGL context

+ +

The following properties and methods provide general information and functionality to deal with the WebGL context:

+ +
+
{{domxref("WebGLRenderingContext.canvas")}}
+
A read-only back-reference to the {{domxref("HTMLCanvasElement")}}. Might be {{jsxref("null")}} if it is not associated with a {{HTMLElement("canvas")}} element.
+
{{domxref("WebGLRenderingContext.commit()")}} {{experimental_inline}}
+
+

Pushes frames back to the original {{domxref("HTMLCanvasElement")}}, if the context is not directly fixed to a specific canvas.

+
+
{{domxref("WebGLRenderingContext.drawingBufferWidth")}}
+
The read-only width of the current drawing buffer. Should match the width of the canvas element associated with this context.
+
{{domxref("WebGLRenderingContext.drawingBufferHeight")}}
+
The read-only height of the current drawing buffer. Should match the height of the canvas element associated with this context.
+
{{domxref("WebGLRenderingContext.getContextAttributes()")}}
+
Returns a WebGLContextAttributes object that contains the actual context parameters. Might return {{jsxref("null")}}, if the context is lost.
+
{{domxref("WebGLRenderingContext.isContextLost()")}}
+
Returns true if the context is lost, otherwise returns false.
+
+ +

Viewing and clipping

+ +
+
{{domxref("WebGLRenderingContext.scissor()")}}
+
Defines the scissor box.
+
{{domxref("WebGLRenderingContext.viewport()")}}
+
Sets the viewport.
+
+ +

State information

+ +
+
{{domxref("WebGLRenderingContext.activeTexture()")}}
+
Selects the active texture unit.
+
{{domxref("WebGLRenderingContext.blendColor()")}}
+
Sets the source and destination blending factors.
+
{{domxref("WebGLRenderingContext.blendEquation()")}}
+
Sets both the RGB blend equation and alpha blend equation to a single equation.
+
{{domxref("WebGLRenderingContext.blendEquationSeparate()")}}
+
Sets the RGB blend equation and alpha blend equation separately.
+
{{domxref("WebGLRenderingContext.blendFunc()")}}
+
Defines which function is used for blending pixel arithmetic.
+
{{domxref("WebGLRenderingContext.blendFuncSeparate()")}}
+
Defines which function is used for blending pixel arithmetic for RGB and alpha components separately.
+
{{domxref("WebGLRenderingContext.clearColor()")}}
+
Specifies the color values used when clearing color buffers.
+
{{domxref("WebGLRenderingContext.clearDepth()")}}
+
Specifies the depth value used when clearing the depth buffer.
+
{{domxref("WebGLRenderingContext.clearStencil()")}}
+
Specifies the stencil value used when clearing the stencil buffer.
+
{{domxref("WebGLRenderingContext.colorMask()")}}
+
Sets which color components to enable or to disable when drawing or rendering to a {{domxref("WebGLFramebuffer")}}.
+
{{domxref("WebGLRenderingContext.cullFace()")}}
+
Specifies whether or not front- and/or back-facing polygons can be culled.
+
{{domxref("WebGLRenderingContext.depthFunc()")}}
+
Specifies a function that compares incoming pixel depth to the current depth buffer value.
+
{{domxref("WebGLRenderingContext.depthMask()")}}
+
Sets whether writing into the depth buffer is enabled or disabled.
+
{{domxref("WebGLRenderingContext.depthRange()")}}
+
Specifies the depth range mapping from normalized device coordinates to window or viewport coordinates.
+
{{domxref("WebGLRenderingContext.disable()")}}
+
Disables specific WebGL capabilities for this context.
+
{{domxref("WebGLRenderingContext.enable()")}}
+
Enables specific WebGL capabilities for this context.
+
{{domxref("WebGLRenderingContext.frontFace()")}}
+
Specifies whether polygons are front- or back-facing by setting a winding orientation.
+
{{domxref("WebGLRenderingContext.getParameter()")}}
+
Returns a value for the passed parameter name.
+
{{domxref("WebGLRenderingContext.getError()")}}
+
Returns error information.
+
{{domxref("WebGLRenderingContext.hint()")}}
+
Specifies hints for certain behaviors. The interpretation of these hints depend on the implementation.
+
{{domxref("WebGLRenderingContext.isEnabled()")}}
+
Tests whether a specific WebGL capability is enabled or not for this context.
+
{{domxref("WebGLRenderingContext.lineWidth()")}}
+
Sets the line width of rasterized lines.
+
{{domxref("WebGLRenderingContext.pixelStorei()")}}
+
Specifies the pixel storage modes
+
{{domxref("WebGLRenderingContext.polygonOffset()")}}
+
Specifies the scale factors and units to calculate depth values.
+
{{domxref("WebGLRenderingContext.sampleCoverage()")}}
+
Specifies multi-sample coverage parameters for anti-aliasing effects.
+
{{domxref("WebGLRenderingContext.stencilFunc()")}}
+
Sets the both front and back function and reference value for stencil testing.
+
{{domxref("WebGLRenderingContext.stencilFuncSeparate()")}}
+
Sets the front and/or back function and reference value for stencil testing.
+
{{domxref("WebGLRenderingContext.stencilMask()")}}
+
Controls enabling and disabling of both the front and back writing of individual bits in the stencil planes.
+
{{domxref("WebGLRenderingContext.stencilMaskSeparate()")}}
+
Controls enabling and disabling of front and/or back writing of individual bits in the stencil planes.
+
{{domxref("WebGLRenderingContext.stencilOp()")}}
+
Sets both the front and back-facing stencil test actions.
+
{{domxref("WebGLRenderingContext.stencilOpSeparate()")}}
+
Sets the front and/or back-facing stencil test actions.
+
+ +

Buffers

+ +
+
{{domxref("WebGLRenderingContext.bindBuffer()")}}
+
Binds a WebGLBuffer object to a given target.
+
{{domxref("WebGLRenderingContext.bufferData()")}}
+
Updates buffer data.
+
{{domxref("WebGLRenderingContext.bufferSubData()")}}
+
Updates buffer data starting at a passed offset.
+
{{domxref("WebGLRenderingContext.createBuffer()")}}
+
Creates a WebGLBuffer object.
+
{{domxref("WebGLRenderingContext.deleteBuffer()")}}
+
Deletes a WebGLBuffer object.
+
{{domxref("WebGLRenderingContext.getBufferParameter()")}}
+
Returns information about the buffer.
+
{{domxref("WebGLRenderingContext.isBuffer()")}}
+
Returns a Boolean indicating if the passed buffer is valid.
+
+ +

Framebuffers

+ +
+
{{domxref("WebGLRenderingContext.bindFramebuffer()")}}
+
Binds a WebGLFrameBuffer object to a given target.
+
{{domxref("WebGLRenderingContext.checkFramebufferStatus()")}}
+
Returns the status of the framebuffer.
+
{{domxref("WebGLRenderingContext.createFramebuffer()")}}
+
Creates a WebGLFrameBuffer object.
+
{{domxref("WebGLRenderingContext.deleteFramebuffer()")}}
+
Deletes a WebGLFrameBuffer object.
+
{{domxref("WebGLRenderingContext.framebufferRenderbuffer()")}}
+
Attaches a WebGLRenderingBuffer object to a WebGLFrameBuffer object.
+
{{domxref("WebGLRenderingContext.framebufferTexture2D()")}}
+
Attaches a textures image to a WebGLFrameBuffer object.
+
{{domxref("WebGLRenderingContext.getFramebufferAttachmentParameter()")}}
+
Returns information about the framebuffer.
+
{{domxref("WebGLRenderingContext.isFramebuffer()")}}
+
Returns a Boolean indicating if the passed WebGLFrameBuffer object is valid.
+
{{domxref("WebGLRenderingContext.readPixels()")}}
+
Reads a block of pixels from the WebGLFrameBuffer.
+
+ +

Renderbuffers

+ +
+
{{domxref("WebGLRenderingContext.bindRenderbuffer()")}}
+
Binds a WebGLRenderBuffer object to a given target.
+
{{domxref("WebGLRenderingContext.createRenderbuffer()")}}
+
Creates a WebGLRenderBuffer object.
+
{{domxref("WebGLRenderingContext.deleteRenderbuffer()")}}
+
Deletes a WebGLRenderBuffer object.
+
{{domxref("WebGLRenderingContext.getRenderbufferParameter()")}}
+
Returns information about the renderbuffer.
+
{{domxref("WebGLRenderingContext.isRenderbuffer()")}}
+
Returns a Boolean indicating if the passed WebGLRenderingBuffer is valid.
+
{{domxref("WebGLRenderingContext.renderbufferStorage()")}}
+
Creates a renderbuffer data store.
+
+ +

Textures

+ +
+
{{domxref("WebGLRenderingContext.bindTexture()")}}
+
Binds a WebGLTexture object to a given target.
+
{{domxref("WebGLRenderingContext.compressedTexImage2D()")}}
+
Specifies a 2D texture image in a compressed format.
+
{{domxref("WebGLRenderingContext.compressedTexSubImage2D()")}}
+
Specifies a 2D texture sub-image in a compressed format.
+
{{domxref("WebGLRenderingContext.copyTexImage2D()")}}
+
Copies a 2D texture image.
+
{{domxref("WebGLRenderingContext.copyTexSubImage2D()")}}
+
Copies a 2D texture sub-image.
+
{{domxref("WebGLRenderingContext.createTexture()")}}
+
Creates a WebGLTexture object.
+
{{domxref("WebGLRenderingContext.deleteTexture()")}}
+
Deletes a WebGLTexture object.
+
{{domxref("WebGLRenderingContext.generateMipmap()")}}
+
Generates a set of mipmaps for a WebGLTexture object.
+
{{domxref("WebGLRenderingContext.getTexParameter()")}}
+
Returns information about the texture.
+
{{domxref("WebGLRenderingContext.isTexture()")}}
+
Returns a Boolean indicating if the passed WebGLTexture is valid.
+
{{domxref("WebGLRenderingContext.texImage2D()")}}
+
Specifies a 2D texture image.
+
{{domxref("WebGLRenderingContext.texSubImage2D()")}}
+
Updates a sub-rectangle of the current WebGLTexture.
+
{{domxref("WebGLRenderingContext.texParameter", "WebGLRenderingContext.texParameterf()")}}
+
Sets texture parameters.
+
{{domxref("WebGLRenderingContext.texParameter", "WebGLRenderingContext.texParameteri()")}}
+
Sets texture parameters.
+
+ +

Programs and shaders

+ +
+
{{domxref("WebGLRenderingContext.attachShader()")}}
+
Attaches a WebGLShader to a WebGLProgram.
+
{{domxref("WebGLRenderingContext.bindAttribLocation()")}}
+
Binds a generic vertex index to a named attribute variable.
+
{{domxref("WebGLRenderingContext.compileShader()")}}
+
Compiles a WebGLShader.
+
{{domxref("WebGLRenderingContext.createProgram()")}}
+
Creates a WebGLProgram.
+
{{domxref("WebGLRenderingContext.createShader()")}}
+
Creates a WebGLShader.
+
{{domxref("WebGLRenderingContext.deleteProgram()")}}
+
Deletes a WebGLProgram.
+
{{domxref("WebGLRenderingContext.deleteShader()")}}
+
Deletes a WebGLShader.
+
{{domxref("WebGLRenderingContext.detachShader()")}}
+
Detaches a WebGLShader.
+
{{domxref("WebGLRenderingContext.getAttachedShaders()")}}
+
Returns a list of WebGLShader objects attached to a WebGLProgram.
+
{{domxref("WebGLRenderingContext.getProgramParameter()")}}
+
Returns information about the program.
+
{{domxref("WebGLRenderingContext.getProgramInfoLog()")}}
+
Returns the information log for a WebGLProgram object.
+
{{domxref("WebGLRenderingContext.getShaderParameter()")}}
+
Returns information about the shader.
+
{{domxref("WebGLRenderingContext.getShaderPrecisionFormat()")}}
+
Returns a WebGLShaderPrecisionFormat object describing the precision for the numeric format of the shader.
+
{{domxref("WebGLRenderingContext.getShaderInfoLog()")}}
+
Returns the information log for a WebGLShader object.
+
{{domxref("WebGLRenderingContext.getShaderSource()")}}
+
Returns the source code of a WebGLShader as a string.
+
{{domxref("WebGLRenderingContext.isProgram()")}}
+
Returns a Boolean indicating if the passed WebGLProgram is valid.
+
{{domxref("WebGLRenderingContext.isShader()")}}
+
Returns a Boolean indicating if the passed WebGLShader is valid.
+
{{domxref("WebGLRenderingContext.linkProgram()")}}
+
Links the passed WebGLProgram object.
+
{{domxref("WebGLRenderingContext.shaderSource()")}}
+
Sets the source code in a WebGLShader.
+
{{domxref("WebGLRenderingContext.useProgram()")}}
+
Uses the specified WebGLProgram as part the current rendering state.
+
{{domxref("WebGLRenderingContext.validateProgram()")}}
+
Validates a WebGLProgram.
+
+ +

Uniforms and attributes

+ +
+
{{domxref("WebGLRenderingContext.disableVertexAttribArray()")}}
+
Disables a vertex attribute array at a given position.
+
{{domxref("WebGLRenderingContext.enableVertexAttribArray()")}}
+
Enables a vertex attribute array at a given position.
+
{{domxref("WebGLRenderingContext.getActiveAttrib()")}}
+
Returns information about an active attribute variable.
+
{{domxref("WebGLRenderingContext.getActiveUniform()")}}
+
Returns information about an active uniform variable.
+
{{domxref("WebGLRenderingContext.getAttribLocation()")}}
+
Returns the location of an attribute variable.
+
{{domxref("WebGLRenderingContext.getUniform()")}}
+
Returns the value of a uniform variable at a given location.
+
{{domxref("WebGLRenderingContext.getUniformLocation()")}}
+
Returns the location of a uniform variable.
+
{{domxref("WebGLRenderingContext.getVertexAttrib()")}}
+
Returns information about a vertex attribute at a given position.
+
{{domxref("WebGLRenderingContext.getVertexAttribOffset()")}}
+
Returns the address of a given vertex attribute.
+
{{domxref("WebGLRenderingContext.uniform()", "WebGLRenderingContext.uniform[1234][fi][v]()")}}
+
Specifies a value for a uniform variable.
+
{{domxref("WebGLRenderingContext.uniformMatrix()", "WebGLRenderingContext.uniformMatrix[234]fv()")}}
+
Specifies a matrix value for a uniform variable.
+
{{domxref("WebGLRenderingContext.vertexAttrib()", "WebGLRenderingContext.vertexAttrib[1234]f[v]()")}}
+
Specifies a value for a generic vertex attribute.
+
{{domxref("WebGLRenderingContext.vertexAttribPointer()")}}
+
Specifies the data formats and locations of vertex attributes in a vertex attributes array.
+
+ +

Drawing buffers

+ +
+
{{domxref("WebGLRenderingContext.clear()")}}
+
Clears specified buffers to preset values.
+
{{domxref("WebGLRenderingContext.drawArrays()")}}
+
Renders primitives from array data.
+
{{domxref("WebGLRenderingContext.drawElements()")}}
+
Renders primitives from element array data.
+
{{domxref("WebGLRenderingContext.finish()")}}
+
Blocks execution until all previously called commands are finished.
+
{{domxref("WebGLRenderingContext.flush()")}}
+
Empties different buffer commands, causing all commands to be executed as quickly as possible.
+
+ +

Working with extensions

+ +

These methods manage WebGL extensions:

+ +
+
{{domxref("WebGLRenderingContext.getSupportedExtensions()")}}
+
Returns an {{jsxref("Array")}} of {{domxref("DOMString")}} elements with all the supported WebGL extensions.
+
{{domxref("WebGLRenderingContext.getExtension()")}}
+
Returns an extension object.
+
+ +

Examples

+ +

WebGL context feature detection

+ +

{{page("/en-US/Learn/WebGL/By_example/Detect_WebGL", "summary")}}

+ +

{{page("/en-US/Learn/WebGL/By_example/Detect_WebGL", "detect-webgl-source")}}

+ +

{{EmbedLiveSample("detect-webgl-source", 660,150 ,"" , "Learn/WebGL/By_example/Detect_WebGL")}}

+ +

Effect of canvas size on rendering with WebGL

+ +

{{page("/en-US/Learn/WebGL/By_example/Canvas_size_and_WebGL", "canvas-size-and-webgl-intro")}}

+ +

{{page("/en-US/Learn/WebGL/By_example/Canvas_size_and_WebGL", "canvas-size-and-webgl-source")}}

+ +

{{EmbedLiveSample("canvas-size-and-webgl-source", 660,180 ,"" , "Learn/WebGL/By_example/Canvas_size_and_WebGL")}}

+ +

Specifications

+ + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('WebGL', "#5.14", "WebGLRenderingContext")}}{{Spec2('WebGL')}}Initial definition
+ +

Browser compatibility

+ +

{{Compat("api/WebGLRenderingContext", "WebGLRenderingContext")}}

+ +

See also

+ + diff --git a/files/fr/web/api/webglrenderingcontext/isbuffer/index.html b/files/fr/web/api/webglrenderingcontext/isbuffer/index.html deleted file mode 100644 index 8a10a0f09c..0000000000 --- a/files/fr/web/api/webglrenderingcontext/isbuffer/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: WebGLRenderingContext.isBuffer() -slug: Web/API/WebGLRenderingContext/isBuffer -tags: - - API - - Méthode - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/isBuffer ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.isBuffer() de l'API WebGL renvoie true si le {{domxref ("WebGLBuffer")}} passé est valide et false dans le cas contraire.

- -

Syntaxe

- -
GLboolean gl.isBuffer(tampon);
-
- -

Paramètres

- -
-
tampon
-
Un {{domxref("WebGLBuffer")}} à vérifier.
-
- -

Valeur retournée

- -

Un {{domxref("GLboolean")}} indiquant si le tampon est ou non valide.

- -

Exemples

- -

Création d'un tampon

- -
var canevas = document.getElementById('canevas');
-var gl = canevas.getContext('webgl');
-var tampon = gl.createBuffer();
-
-gl.isBuffer(tampon);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.5", "isBuffer")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glIsBuffer.xml", "glIsBuffer")}}{{Spec2('OpenGL ES 2.0')}} -

Page man de l’API OpenGL.

-
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/isbuffer/index.md b/files/fr/web/api/webglrenderingcontext/isbuffer/index.md new file mode 100644 index 0000000000..8a10a0f09c --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/isbuffer/index.md @@ -0,0 +1,77 @@ +--- +title: WebGLRenderingContext.isBuffer() +slug: Web/API/WebGLRenderingContext/isBuffer +tags: + - API + - Méthode + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/isBuffer +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.isBuffer() de l'API WebGL renvoie true si le {{domxref ("WebGLBuffer")}} passé est valide et false dans le cas contraire.

+ +

Syntaxe

+ +
GLboolean gl.isBuffer(tampon);
+
+ +

Paramètres

+ +
+
tampon
+
Un {{domxref("WebGLBuffer")}} à vérifier.
+
+ +

Valeur retournée

+ +

Un {{domxref("GLboolean")}} indiquant si le tampon est ou non valide.

+ +

Exemples

+ +

Création d'un tampon

+ +
var canevas = document.getElementById('canevas');
+var gl = canevas.getContext('webgl');
+var tampon = gl.createBuffer();
+
+gl.isBuffer(tampon);
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.5", "isBuffer")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glIsBuffer.xml", "glIsBuffer")}}{{Spec2('OpenGL ES 2.0')}} +

Page man de l’API OpenGL.

+
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/shadersource/index.html b/files/fr/web/api/webglrenderingcontext/shadersource/index.html deleted file mode 100644 index 7825a72f7b..0000000000 --- a/files/fr/web/api/webglrenderingcontext/shadersource/index.html +++ /dev/null @@ -1,74 +0,0 @@ ---- -title: WebGLRenderingContext.shaderSource() -slug: Web/API/WebGLRenderingContext/shaderSource -tags: - - API - - Méthode - - Reference - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/shaderSource ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.shaderSource() de l'API WebGL définit le code source d'un {{domxref("WebGLShader")}}.

- -

Syntaxe

- -
void gl.shaderSource(shader, source);
-
- -

Parameters

- -
-
shader
-
Un objet {{domxref("WebGLShader")}} dans lequel définir le code source.
-
source
-
Une {{domxref("DOMString")}} contenant le code source GLSL à définir.
-
- -

Valeur retournée

- -

Aucune.

- -

Exemple

- -
var shader = gl.createShader(gl.VERTEX_SHADER);
-gl.shaderSource(shader, originalSource);
-
-var source = gl.getShaderSource(shader);
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.9", "shaderSource")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glShaderSource.xml", "glShaderSource")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API OpenGL (similaire).
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/shadersource/index.md b/files/fr/web/api/webglrenderingcontext/shadersource/index.md new file mode 100644 index 0000000000..7825a72f7b --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/shadersource/index.md @@ -0,0 +1,74 @@ +--- +title: WebGLRenderingContext.shaderSource() +slug: Web/API/WebGLRenderingContext/shaderSource +tags: + - API + - Méthode + - Reference + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/shaderSource +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.shaderSource() de l'API WebGL définit le code source d'un {{domxref("WebGLShader")}}.

+ +

Syntaxe

+ +
void gl.shaderSource(shader, source);
+
+ +

Parameters

+ +
+
shader
+
Un objet {{domxref("WebGLShader")}} dans lequel définir le code source.
+
source
+
Une {{domxref("DOMString")}} contenant le code source GLSL à définir.
+
+ +

Valeur retournée

+ +

Aucune.

+ +

Exemple

+ +
var shader = gl.createShader(gl.VERTEX_SHADER);
+gl.shaderSource(shader, originalSource);
+
+var source = gl.getShaderSource(shader);
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.9", "shaderSource")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glShaderSource.xml", "glShaderSource")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API OpenGL (similaire).
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/teximage2d/index.html b/files/fr/web/api/webglrenderingcontext/teximage2d/index.html deleted file mode 100644 index af95e8f3c8..0000000000 --- a/files/fr/web/api/webglrenderingcontext/teximage2d/index.html +++ /dev/null @@ -1,240 +0,0 @@ ---- -title: WebGLRenderingContext.texImage2D() -slug: Web/API/WebGLRenderingContext/texImage2D -tags: - - API - - Méthode - - Reference - - Textures - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/texImage2D ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.texImage2D() de l'API WebGL spécifie une image de texture bidimensionnelle.

- -

Syntaxe

- -
// WebGL1:
-void gl.texImage2D(cible, niveau, formatinterne, largeur, hauteur, bordure, format, type, ArrayBufferView? pixels);
-void gl.texImage2D(cible, niveau, formatinterne, format, type, ImageData? pixels);
-void gl.texImage2D(cible, niveau, formatinterne, format, type, HTMLImageElement? pixels);
-void gl.texImage2D(cible, niveau, formatinterne, format, type, HTMLCanvasElement? pixels);
-void gl.texImage2D(cible, niveau, formatinterne, format, type, HTMLVideoElement? pixels);
-void gl.texImage2D(cible, niveau, formatinterne, format, type, ImageBitmap? pixels);
-
-// WebGL2:
-void gl.texImage2D(cible, niveau, formatinterne, largeur, hauteur, bordure, format, type, GLintptr decalage);
-void gl.texImage2D(cible, niveau, formatinterne, largeur, hauteur, bordure, format, type, HTMLCanvasElement source);
-void gl.texImage2D(cible, niveau, formatinterne, largeur, hauteur, bordure, format, type, HTMLImageElement source);
-void gl.texImage2D(cible, niveau, formatinterne, largeur, hauteur, bordure, format, type, HTMLVideoElement source);
-void gl.texImage2D(cible, niveau, formatinterne, largeur, hauteur, bordure, format, type, ImageBitmap source);
-void gl.texImage2D(cible, niveau, formatinterne, largeur, hauteur, bordure, format, type, ImageData source);
-void gl.texImage2D(cible, niveau, formatinterne, largeur, hauteur, bordure, format, type, ArrayBufferView donneesSrc, decalageSrc);
-
- -

Paramètres

- -
-
cible
-

Un {{domxref ("GLenum")}} indiquant le point de liaison (cible) de la texture active. Valeurs possibles :

-
    -
  • gl.TEXTURE_2D : une texture bidimensionnelle ;
  • -
  • gl.TEXTURE_CUBE_MAP_POSITIVE_X : face X positive pour une texture mappée sur un cube ;
  • -
  • gl.TEXTURE_CUBE_MAP_NEGATIVE_X : face X négative pour une texture mappée sur un cube ;
  • -
  • gl.TEXTURE_CUBE_MAP_POSITIVE_Y : face Y positive pour une texture mappée sur un cube ;
  • -
  • gl.TEXTURE_CUBE_MAP_NEGATIVE_Y : face Y négative pour une texture mappée sur un cube ;
  • -
  • gl.TEXTURE_CUBE_MAP_POSITIVE_Z : face Z positive pour une texture mappée sur un cube ;
  • -
  • gl.TEXTURE_CUBE_MAP_NEGATIVE_Z : face Z négative pour une texture mappée sur un cube.
  • -
-
-
niveau
-
Un {{domxref ("GLint")}} indiquant le niveau de détail. Le niveau 0 est le niveau de l'image de base et le niveau n est le n-ième niveau de réduction du mipmap.
-
formatinterne
-

Un {{domxref ("GLint")}} indiquant les composantes de couleur dans la texture. Valeurs possibles :

-
    -
  • gl.ALPHA : ignore les composantes rouge, vert et bleu, et lit la composante alpha ;
  • -
  • gl.RGB : ignore la composante alpha et lit les composantes rouge, vert et bleu ;
  • -
  • gl.RGBA : les composantes rouge, vert, bleu et alpha sont lues à partir du tampon des couleurs ;
  • -
  • gl.LUMINANCE : chaque composante de couleur est une composante de luminance, alpha vaut 1,0 ;
  • -
  • gl.LUMINANCE_ALPHA : chaque composante est une composante de luminance/alpha ;
  • -
  • lors de l'utilisation de l'extension {{domxref("WEBGL_depth_texture")}} : -
      -
    • gl.DEPTH_COMPONENT
    • -
    • gl.DEPTH_STENCIL
    • -
    -
  • -
  • lors de l'utilisation de l'extension {{domxref("EXT_sRGB")}} : -
      -
    • ext.SRGB_EXT
    • -
    • ext.SRGB_ALPHA_EXT
    • -
    -
  • -
  • Lors de l'utilisation d'un {{domxref("WebGL2RenderingContext", "WebGL 2 context", "", 1)}}, les valeurs suivantes sont en outre disponibles : -
      -
    • gl.R8
    • -
    • gl.R16F
    • -
    • gl.R32F
    • -
    • gl.R8UI
    • -
    • gl.RG8
    • -
    • gl.RG16F
    • -
    • gl.RG32F
    • -
    • gl.RG8UI
    • -
    • gl.RG16UI
    • -
    • gl.RG32UI
    • -
    • gl.RGB8
    • -
    • gl.SRGB8
    • -
    • gl.RGB565
    • -
    • gl.R11F_G11F_B10F
    • -
    • gl.RGB9_E5
    • -
    • gl.RGB16F
    • -
    • gl.RGB32F
    • -
    • gl.RGB8UI
    • -
    • gl.RGBA8
    • -
    • gl.SRGB8_APLHA8
    • -
    • gl.RGB5_A1
    • -
    • gl.RGB10_A2
    • -
    • gl.RGBA4
    • -
    • gl.RGBA16F
    • -
    • gl.RGBA32F
    • -
    • gl.RGBA8UI
    • -
    -
  • -
-
-
largeur
-
Un {{domxref ("GLsizei")}} indiquant la largeur de la texture.
-
hauteur
-
Un {{domxref ("GLsizei")}} indiquant la hauteur de la texture.
-
bordure
-
Un {{domxref("GLint")}} indiquant la largeur de la bordure. Doit être 0.
-
format
-
Un {{domxref("GLenum")}} indiquant le format des données de texel. En WebGL 1, cela doit être identique à formatinterne (voir ci-dessus). En WebGL 2, les combinaisons sont répertoriées dans ce tableau.
-
type
-

Un {{domxref("GLenum")}} indiquant le type de données des données de texel. Valeurs possibles :

-
    -
  • gl.UNSIGNED_BYTE : 8 bits par canal pour gl.RGBA ;
  • -
  • gl.UNSIGNED_SHORT_5_6_5 : 5 bits de rouge, 6 bits de vert, 5 bits de bleu ;
  • -
  • gl.UNSIGNED_SHORT_4_4_4_4 : 4 bits de rouge, 4 bits de vert, 4 bits de bleu, 4 bits d'alpha ;
  • -
  • gl.UNSIGNED_SHORT_5_5_5_1 : 5 bits de rouge, 5 bits de vert, 5 bits de bleu, 1 bit d'alpha ;
  • -
  • lors de l'utilisation de l'extension {{domxref ("WEBGL_depth_texture")}} : -
      -
    • gl.UNSIGNED_SHORT
    • -
    • gl.UNSIGNED_INT
    • -
    • ext.UNSIGNED_INT_24_8_WEBGL (constante fournie par l'extension)
    • -
    -
  • -
  • lors de l'utilisation de l'extension {{domxref("OES_texture_float")}} : -
      -
    • gl.FLOAT
    • -
    -
  • -
  • lors de l'utilisation de l'extension {{domxref("OES_texture_half_float")}} : -
      -
    • ext.HALF_FLOAT_OES (constante fournie par l'extension)
    • -
    -
  • -
  • lors de l'utilisation d'un {{domxref("WebGL2RenderingContext", "WebGL 2 context", "", 1)}}, les valeurs suivantes sont en outre disponibles : -
      -
    • gl.BYTE
    • -
    • gl.UNSIGNED_SHORT
    • -
    • gl.SHORT
    • -
    • gl.UNSIGNED_INT
    • -
    • gl.INT
    • -
    • gl.HALF_FLOAT
    • -
    • gl.FLOAT
    • -
    • gl.UNSIGNED_INT_2_10_10_10_REV
    • -
    • gl.UNSIGNED_INT_10F_11F_11F_REV
    • -
    • gl.UNSIGNED_INT_5_9_9_9_REV
    • -
    • gl.UNSIGNED_INT_24_8
    • -
    • gl.FLOAT_32_UNSIGNED_INT_24_8_REV (les pixels doivent être {{jsxref("null")}})
    • -
    -
  • -
-
-
pixels
-

L'un des objets suivants peut être utilisé comme source de pixels pour la texture :

-
    -
  • {{domxref("ArrayBufferView")}}, -
      -
    • un {{jsxref("Uint8Array")}} doit être utilisé si type est gl.UNSIGNED_BYTE ;
    • -
    • un {{jsxref("Uint16Array")}} doit être utilisé si type est gl.UNSIGNED_SHORT_5_6_5, gl.UNSIGNED_SHORT_4_4_4_4, gl.UNSIGNED_SHORT_5_5_5_1, gl.UNSIGNED_SHORT ou ext.HALF_FLOAT_OES ;
    • -
    • un {{jsxref("Uint32Array")}} doit être utilisé si type est gl.UNSIGNED_INT ou ext.UNSIGNED_INT_24_8_WEBGL ;
    • -
    • un {{jsxref("Float32Array")}} doit être utilisé si type est gl.FLOAT ;
    • -
    -
  • -
  • {{domxref("ImageData")}},
  • -
  • {{domxref("HTMLImageElement")}},
  • -
  • {{domxref("HTMLCanvasElement")}},
  • -
  • {{domxref("HTMLVideoElement")}},
  • -
  • {{domxref("ImageBitmap")}}.
  • -
-
-
decalage
-
(WebGL 2 seulement) Un décalage en octets {{domxref("GLintptr")}} dans le magasin de données du {{domxref("WebGLBuffer")}}. Utilisé pour télécharger des données vers la {{domxref ("WebGLTexture")}} liée, depuis le WebGLBuffer lié à la cible PIXEL_UNPACK_BUFFER.
-
- -

Valeur retournée

- -

Aucune.

- -

Exemples

- -
gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, image);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.8", "texImage2D")}}{{Spec2('WebGL')}} -

Définition initiale pour WebGL.

-
{{SpecName('OpenGL ES 2.0', "glTexImage2D.xml", "glTexImage2D")}}{{Spec2('OpenGL ES 2.0')}} -

Page man de l’API OpenGL ES 2.0 (similaire).

-
{{SpecName('WebGL2', "#3.7.6", "texImage2D")}}{{Spec2('WebGL2')}}Définition mise à jour pour WebGL.
{{SpecName('OpenGL ES 3.0', "glTexImage2D.xhtml", "glTexImage2D")}}{{Spec2('OpenGL ES 3.0')}}Page man de l’API OpenGL ES 3.0 (similaire).
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/teximage2d/index.md b/files/fr/web/api/webglrenderingcontext/teximage2d/index.md new file mode 100644 index 0000000000..af95e8f3c8 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/teximage2d/index.md @@ -0,0 +1,240 @@ +--- +title: WebGLRenderingContext.texImage2D() +slug: Web/API/WebGLRenderingContext/texImage2D +tags: + - API + - Méthode + - Reference + - Textures + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/texImage2D +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.texImage2D() de l'API WebGL spécifie une image de texture bidimensionnelle.

+ +

Syntaxe

+ +
// WebGL1:
+void gl.texImage2D(cible, niveau, formatinterne, largeur, hauteur, bordure, format, type, ArrayBufferView? pixels);
+void gl.texImage2D(cible, niveau, formatinterne, format, type, ImageData? pixels);
+void gl.texImage2D(cible, niveau, formatinterne, format, type, HTMLImageElement? pixels);
+void gl.texImage2D(cible, niveau, formatinterne, format, type, HTMLCanvasElement? pixels);
+void gl.texImage2D(cible, niveau, formatinterne, format, type, HTMLVideoElement? pixels);
+void gl.texImage2D(cible, niveau, formatinterne, format, type, ImageBitmap? pixels);
+
+// WebGL2:
+void gl.texImage2D(cible, niveau, formatinterne, largeur, hauteur, bordure, format, type, GLintptr decalage);
+void gl.texImage2D(cible, niveau, formatinterne, largeur, hauteur, bordure, format, type, HTMLCanvasElement source);
+void gl.texImage2D(cible, niveau, formatinterne, largeur, hauteur, bordure, format, type, HTMLImageElement source);
+void gl.texImage2D(cible, niveau, formatinterne, largeur, hauteur, bordure, format, type, HTMLVideoElement source);
+void gl.texImage2D(cible, niveau, formatinterne, largeur, hauteur, bordure, format, type, ImageBitmap source);
+void gl.texImage2D(cible, niveau, formatinterne, largeur, hauteur, bordure, format, type, ImageData source);
+void gl.texImage2D(cible, niveau, formatinterne, largeur, hauteur, bordure, format, type, ArrayBufferView donneesSrc, decalageSrc);
+
+ +

Paramètres

+ +
+
cible
+

Un {{domxref ("GLenum")}} indiquant le point de liaison (cible) de la texture active. Valeurs possibles :

+
    +
  • gl.TEXTURE_2D : une texture bidimensionnelle ;
  • +
  • gl.TEXTURE_CUBE_MAP_POSITIVE_X : face X positive pour une texture mappée sur un cube ;
  • +
  • gl.TEXTURE_CUBE_MAP_NEGATIVE_X : face X négative pour une texture mappée sur un cube ;
  • +
  • gl.TEXTURE_CUBE_MAP_POSITIVE_Y : face Y positive pour une texture mappée sur un cube ;
  • +
  • gl.TEXTURE_CUBE_MAP_NEGATIVE_Y : face Y négative pour une texture mappée sur un cube ;
  • +
  • gl.TEXTURE_CUBE_MAP_POSITIVE_Z : face Z positive pour une texture mappée sur un cube ;
  • +
  • gl.TEXTURE_CUBE_MAP_NEGATIVE_Z : face Z négative pour une texture mappée sur un cube.
  • +
+
+
niveau
+
Un {{domxref ("GLint")}} indiquant le niveau de détail. Le niveau 0 est le niveau de l'image de base et le niveau n est le n-ième niveau de réduction du mipmap.
+
formatinterne
+

Un {{domxref ("GLint")}} indiquant les composantes de couleur dans la texture. Valeurs possibles :

+
    +
  • gl.ALPHA : ignore les composantes rouge, vert et bleu, et lit la composante alpha ;
  • +
  • gl.RGB : ignore la composante alpha et lit les composantes rouge, vert et bleu ;
  • +
  • gl.RGBA : les composantes rouge, vert, bleu et alpha sont lues à partir du tampon des couleurs ;
  • +
  • gl.LUMINANCE : chaque composante de couleur est une composante de luminance, alpha vaut 1,0 ;
  • +
  • gl.LUMINANCE_ALPHA : chaque composante est une composante de luminance/alpha ;
  • +
  • lors de l'utilisation de l'extension {{domxref("WEBGL_depth_texture")}} : +
      +
    • gl.DEPTH_COMPONENT
    • +
    • gl.DEPTH_STENCIL
    • +
    +
  • +
  • lors de l'utilisation de l'extension {{domxref("EXT_sRGB")}} : +
      +
    • ext.SRGB_EXT
    • +
    • ext.SRGB_ALPHA_EXT
    • +
    +
  • +
  • Lors de l'utilisation d'un {{domxref("WebGL2RenderingContext", "WebGL 2 context", "", 1)}}, les valeurs suivantes sont en outre disponibles : +
      +
    • gl.R8
    • +
    • gl.R16F
    • +
    • gl.R32F
    • +
    • gl.R8UI
    • +
    • gl.RG8
    • +
    • gl.RG16F
    • +
    • gl.RG32F
    • +
    • gl.RG8UI
    • +
    • gl.RG16UI
    • +
    • gl.RG32UI
    • +
    • gl.RGB8
    • +
    • gl.SRGB8
    • +
    • gl.RGB565
    • +
    • gl.R11F_G11F_B10F
    • +
    • gl.RGB9_E5
    • +
    • gl.RGB16F
    • +
    • gl.RGB32F
    • +
    • gl.RGB8UI
    • +
    • gl.RGBA8
    • +
    • gl.SRGB8_APLHA8
    • +
    • gl.RGB5_A1
    • +
    • gl.RGB10_A2
    • +
    • gl.RGBA4
    • +
    • gl.RGBA16F
    • +
    • gl.RGBA32F
    • +
    • gl.RGBA8UI
    • +
    +
  • +
+
+
largeur
+
Un {{domxref ("GLsizei")}} indiquant la largeur de la texture.
+
hauteur
+
Un {{domxref ("GLsizei")}} indiquant la hauteur de la texture.
+
bordure
+
Un {{domxref("GLint")}} indiquant la largeur de la bordure. Doit être 0.
+
format
+
Un {{domxref("GLenum")}} indiquant le format des données de texel. En WebGL 1, cela doit être identique à formatinterne (voir ci-dessus). En WebGL 2, les combinaisons sont répertoriées dans ce tableau.
+
type
+

Un {{domxref("GLenum")}} indiquant le type de données des données de texel. Valeurs possibles :

+
    +
  • gl.UNSIGNED_BYTE : 8 bits par canal pour gl.RGBA ;
  • +
  • gl.UNSIGNED_SHORT_5_6_5 : 5 bits de rouge, 6 bits de vert, 5 bits de bleu ;
  • +
  • gl.UNSIGNED_SHORT_4_4_4_4 : 4 bits de rouge, 4 bits de vert, 4 bits de bleu, 4 bits d'alpha ;
  • +
  • gl.UNSIGNED_SHORT_5_5_5_1 : 5 bits de rouge, 5 bits de vert, 5 bits de bleu, 1 bit d'alpha ;
  • +
  • lors de l'utilisation de l'extension {{domxref ("WEBGL_depth_texture")}} : +
      +
    • gl.UNSIGNED_SHORT
    • +
    • gl.UNSIGNED_INT
    • +
    • ext.UNSIGNED_INT_24_8_WEBGL (constante fournie par l'extension)
    • +
    +
  • +
  • lors de l'utilisation de l'extension {{domxref("OES_texture_float")}} : +
      +
    • gl.FLOAT
    • +
    +
  • +
  • lors de l'utilisation de l'extension {{domxref("OES_texture_half_float")}} : +
      +
    • ext.HALF_FLOAT_OES (constante fournie par l'extension)
    • +
    +
  • +
  • lors de l'utilisation d'un {{domxref("WebGL2RenderingContext", "WebGL 2 context", "", 1)}}, les valeurs suivantes sont en outre disponibles : +
      +
    • gl.BYTE
    • +
    • gl.UNSIGNED_SHORT
    • +
    • gl.SHORT
    • +
    • gl.UNSIGNED_INT
    • +
    • gl.INT
    • +
    • gl.HALF_FLOAT
    • +
    • gl.FLOAT
    • +
    • gl.UNSIGNED_INT_2_10_10_10_REV
    • +
    • gl.UNSIGNED_INT_10F_11F_11F_REV
    • +
    • gl.UNSIGNED_INT_5_9_9_9_REV
    • +
    • gl.UNSIGNED_INT_24_8
    • +
    • gl.FLOAT_32_UNSIGNED_INT_24_8_REV (les pixels doivent être {{jsxref("null")}})
    • +
    +
  • +
+
+
pixels
+

L'un des objets suivants peut être utilisé comme source de pixels pour la texture :

+
    +
  • {{domxref("ArrayBufferView")}}, +
      +
    • un {{jsxref("Uint8Array")}} doit être utilisé si type est gl.UNSIGNED_BYTE ;
    • +
    • un {{jsxref("Uint16Array")}} doit être utilisé si type est gl.UNSIGNED_SHORT_5_6_5, gl.UNSIGNED_SHORT_4_4_4_4, gl.UNSIGNED_SHORT_5_5_5_1, gl.UNSIGNED_SHORT ou ext.HALF_FLOAT_OES ;
    • +
    • un {{jsxref("Uint32Array")}} doit être utilisé si type est gl.UNSIGNED_INT ou ext.UNSIGNED_INT_24_8_WEBGL ;
    • +
    • un {{jsxref("Float32Array")}} doit être utilisé si type est gl.FLOAT ;
    • +
    +
  • +
  • {{domxref("ImageData")}},
  • +
  • {{domxref("HTMLImageElement")}},
  • +
  • {{domxref("HTMLCanvasElement")}},
  • +
  • {{domxref("HTMLVideoElement")}},
  • +
  • {{domxref("ImageBitmap")}}.
  • +
+
+
decalage
+
(WebGL 2 seulement) Un décalage en octets {{domxref("GLintptr")}} dans le magasin de données du {{domxref("WebGLBuffer")}}. Utilisé pour télécharger des données vers la {{domxref ("WebGLTexture")}} liée, depuis le WebGLBuffer lié à la cible PIXEL_UNPACK_BUFFER.
+
+ +

Valeur retournée

+ +

Aucune.

+ +

Exemples

+ +
gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, image);
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.8", "texImage2D")}}{{Spec2('WebGL')}} +

Définition initiale pour WebGL.

+
{{SpecName('OpenGL ES 2.0', "glTexImage2D.xml", "glTexImage2D")}}{{Spec2('OpenGL ES 2.0')}} +

Page man de l’API OpenGL ES 2.0 (similaire).

+
{{SpecName('WebGL2', "#3.7.6", "texImage2D")}}{{Spec2('WebGL2')}}Définition mise à jour pour WebGL.
{{SpecName('OpenGL ES 3.0', "glTexImage2D.xhtml", "glTexImage2D")}}{{Spec2('OpenGL ES 3.0')}}Page man de l’API OpenGL ES 3.0 (similaire).
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/texparameter/index.html b/files/fr/web/api/webglrenderingcontext/texparameter/index.html deleted file mode 100644 index ec02f92374..0000000000 --- a/files/fr/web/api/webglrenderingcontext/texparameter/index.html +++ /dev/null @@ -1,177 +0,0 @@ ---- -title: 'WebGLRenderingContext.texParameter[fi]()' -slug: Web/API/WebGLRenderingContext/texParameter -tags: - - API - - Méthode - - Reference - - Textures - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/texParameter ---- -
{{APIRef("WebGL")}}
- -

Les méthodes WebGLRenderingContext.texParameter[fi]() de l'API WebGL définissent les paramètres de texture.

- -

Syntaxe

- -
void gl.texParameterf(GLenum cible, GLenum nomp, GLfloat param);
-void gl.texParameteri(GLenum cible, GLenum nomp, GLint param);
-
- -

Paramètres

- -
-
cible
-
Un {{domxref("GLenum")}} indiquant le point de liaison (cible). Valeurs possibles : -
    -
  • gl.TEXTURE_2D : une texture bi-dimensionelle.
  • -
  • gl.TEXTURE_CUBE_MAP : une texte appliquée sur un cube.
  • -
  • Lorsqu'un {{domxref("WebGL2RenderingContext", "WebGL 2 context", "", 1)}} est utilisé, les valeurs suivantes sont en outre disponibles : -
      -
    • gl.TEXTURE_3D : une texture tri-dimensionnelle.
    • -
    • gl.TEXTURE_2D_ARRAY : une texture bi-dimensionnelle en tableau.
    • -
    -
  • -
-
-
- -

Le paramètre nomp est un {{domxref("Glenum")}} indiquant le paramètre de texture à définir. Le paramètre param est un {{domxref("GLfloat")}} ou un {{domxref("GLint")}} indiquant la valeur pour le paramètre nomp indiqué.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
pnomDescriptionparam
Disponible en WebGL 1
gl.TEXTURE_MAG_FILTERFiltre de grossissement de texturegl.LINEAR (valeur par défaut), gl.NEAREST.
gl.TEXTURE_MIN_FILTERFiltre de réduction de texturegl.LINEAR, gl.NEAREST, gl.NEAREST_MIPMAP_NEAREST, gl.LINEAR_MIPMAP_NEAREST, gl.NEAREST_MIPMAP_LINEAR (valeur par défaut), gl.LINEAR_MIPMAP_LINEAR.
gl.TEXTURE_WRAP_SFonction d'emballage pour la coordonnée de texture sgl.REPEAT (valeur par défaut),gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.
gl.TEXTURE_WRAP_TFonction d'emballage pour la coordonnée de texture tgl.REPEAT (valeur par défaut),gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.
Disponible en outre quand l'extension {{domxref("EXT_texture_filter_anisotropic")}} est utilisée
ext.TEXTURE_MAX_ANISOTROPY_EXTAnisotropie maximum pour une textureUne valeur {{domxref("GLfloat")}}.
Disponible en outre quand un contexte WebGL 2 est utilisé
gl.TEXTURE_BASE_LEVELNiveau de mipmap de textureToutes valeurs int.
gl.TEXTURE_COMPARE_FUNCFonction de comparaison de texturegl.LEQUAL (valeur par défaut), gl.GEQUAL, gl.LESS, gl.GREATER, gl.EQUAL, gl.NOTEQUAL, gl.ALWAYS, gl.NEVER.
gl.TEXTURE_COMPARE_MODEMode de comparaison de texturegl.NONE (valeur défaut), gl.COMPARE_REF_TO_TEXTURE.
gl.TEXTURE_MAX_LEVELNiveau maximum de mipmap de texture en tableauToutes valeurs int.
gl.TEXTURE_MAX_LOD -

Valeur de niveau-de-détail maximum de texture

-
Toutes valeurs float.
gl.TEXTURE_MIN_LODValeur de niveau-de-détail minimum de textureToutes valeurs float.
gl.TEXTURE_WRAP_RFonction d'emballage pour la coordonnée de texture  rgl.REPEAT (valeur par défaut), gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.
- -

Valeur retournée

- -

Aucune.

- -

Exemples

- -
gl.texParameterf(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
-gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR_MIPMAP_NEAREST);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.8", "texParameter[fi]")}}{{Spec2('WebGL')}}Définition initiale pour WebGL.
{{SpecName('OpenGL ES 2.0', "glTexParameter.xml", "glTexParameter")}}{{Spec2('OpenGL ES 2.0')}}Page man de l’API OpenGL ES 2.0 API (similaire).
{{SpecName('WebGL2', "#3.7.6", "texParameter[fi]")}}{{Spec2('WebGL2')}}Définition mise à jour pour WebGL.
{{SpecName('OpenGL ES 3.0', "glTexParameter.xhtml", "glTexParameter")}}{{Spec2('OpenGL ES 3.0')}}Page man de l’API OpenGL ES 3.0 API (similaire).
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/texparameter/index.md b/files/fr/web/api/webglrenderingcontext/texparameter/index.md new file mode 100644 index 0000000000..ec02f92374 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/texparameter/index.md @@ -0,0 +1,177 @@ +--- +title: 'WebGLRenderingContext.texParameter[fi]()' +slug: Web/API/WebGLRenderingContext/texParameter +tags: + - API + - Méthode + - Reference + - Textures + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/texParameter +--- +
{{APIRef("WebGL")}}
+ +

Les méthodes WebGLRenderingContext.texParameter[fi]() de l'API WebGL définissent les paramètres de texture.

+ +

Syntaxe

+ +
void gl.texParameterf(GLenum cible, GLenum nomp, GLfloat param);
+void gl.texParameteri(GLenum cible, GLenum nomp, GLint param);
+
+ +

Paramètres

+ +
+
cible
+
Un {{domxref("GLenum")}} indiquant le point de liaison (cible). Valeurs possibles : +
    +
  • gl.TEXTURE_2D : une texture bi-dimensionelle.
  • +
  • gl.TEXTURE_CUBE_MAP : une texte appliquée sur un cube.
  • +
  • Lorsqu'un {{domxref("WebGL2RenderingContext", "WebGL 2 context", "", 1)}} est utilisé, les valeurs suivantes sont en outre disponibles : +
      +
    • gl.TEXTURE_3D : une texture tri-dimensionnelle.
    • +
    • gl.TEXTURE_2D_ARRAY : une texture bi-dimensionnelle en tableau.
    • +
    +
  • +
+
+
+ +

Le paramètre nomp est un {{domxref("Glenum")}} indiquant le paramètre de texture à définir. Le paramètre param est un {{domxref("GLfloat")}} ou un {{domxref("GLint")}} indiquant la valeur pour le paramètre nomp indiqué.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
pnomDescriptionparam
Disponible en WebGL 1
gl.TEXTURE_MAG_FILTERFiltre de grossissement de texturegl.LINEAR (valeur par défaut), gl.NEAREST.
gl.TEXTURE_MIN_FILTERFiltre de réduction de texturegl.LINEAR, gl.NEAREST, gl.NEAREST_MIPMAP_NEAREST, gl.LINEAR_MIPMAP_NEAREST, gl.NEAREST_MIPMAP_LINEAR (valeur par défaut), gl.LINEAR_MIPMAP_LINEAR.
gl.TEXTURE_WRAP_SFonction d'emballage pour la coordonnée de texture sgl.REPEAT (valeur par défaut),gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.
gl.TEXTURE_WRAP_TFonction d'emballage pour la coordonnée de texture tgl.REPEAT (valeur par défaut),gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.
Disponible en outre quand l'extension {{domxref("EXT_texture_filter_anisotropic")}} est utilisée
ext.TEXTURE_MAX_ANISOTROPY_EXTAnisotropie maximum pour une textureUne valeur {{domxref("GLfloat")}}.
Disponible en outre quand un contexte WebGL 2 est utilisé
gl.TEXTURE_BASE_LEVELNiveau de mipmap de textureToutes valeurs int.
gl.TEXTURE_COMPARE_FUNCFonction de comparaison de texturegl.LEQUAL (valeur par défaut), gl.GEQUAL, gl.LESS, gl.GREATER, gl.EQUAL, gl.NOTEQUAL, gl.ALWAYS, gl.NEVER.
gl.TEXTURE_COMPARE_MODEMode de comparaison de texturegl.NONE (valeur défaut), gl.COMPARE_REF_TO_TEXTURE.
gl.TEXTURE_MAX_LEVELNiveau maximum de mipmap de texture en tableauToutes valeurs int.
gl.TEXTURE_MAX_LOD +

Valeur de niveau-de-détail maximum de texture

+
Toutes valeurs float.
gl.TEXTURE_MIN_LODValeur de niveau-de-détail minimum de textureToutes valeurs float.
gl.TEXTURE_WRAP_RFonction d'emballage pour la coordonnée de texture  rgl.REPEAT (valeur par défaut), gl.CLAMP_TO_EDGE, gl.MIRRORED_REPEAT.
+ +

Valeur retournée

+ +

Aucune.

+ +

Exemples

+ +
gl.texParameterf(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
+gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR_MIPMAP_NEAREST);
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.8", "texParameter[fi]")}}{{Spec2('WebGL')}}Définition initiale pour WebGL.
{{SpecName('OpenGL ES 2.0', "glTexParameter.xml", "glTexParameter")}}{{Spec2('OpenGL ES 2.0')}}Page man de l’API OpenGL ES 2.0 API (similaire).
{{SpecName('WebGL2', "#3.7.6", "texParameter[fi]")}}{{Spec2('WebGL2')}}Définition mise à jour pour WebGL.
{{SpecName('OpenGL ES 3.0', "glTexParameter.xhtml", "glTexParameter")}}{{Spec2('OpenGL ES 3.0')}}Page man de l’API OpenGL ES 3.0 API (similaire).
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/uniform/index.html b/files/fr/web/api/webglrenderingcontext/uniform/index.html deleted file mode 100644 index cb27eaeb2c..0000000000 --- a/files/fr/web/api/webglrenderingcontext/uniform/index.html +++ /dev/null @@ -1,97 +0,0 @@ ---- -title: 'WebGLRenderingContext.uniform[1234][fi][v]()' -slug: Web/API/WebGLRenderingContext/uniform -tags: - - API - - Méthode - - Reference - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/uniform ---- -
{{APIRef("WebGL")}}
- -

Les méthodes WebGLRenderingContext.uniform[1234][fi][v]() de l'API WebGL indiquent les valeurs des variables uniform.

- -
-

Note : Beaucoup des fonctions décrites ici ont des interfaces WebGL 2 étendues, qui peuvent être trouvées en {{domxref("WebGL2RenderingContext.uniform","WebGL2RenderingContext.uniform[1234][uif][v]()")}}.

-
- -

Syntaxe

- -
void gl.uniform1f(emplacement, v0);
-void gl.uniform1fv(emplacement, valeur);
-void gl.uniform1i(emplacement, v0);
-void gl.uniform1iv(emplacement, valeur);
-
-void gl.uniform2f(emplacement, v0, v1);
-void gl.uniform2fv(emplacement, valeur);
-void gl.uniform2i(emplacement, v0, v1);
-void gl.uniform2iv(emplacement, valeur);
-
-void gl.uniform3f(emplacement, v0, v1, v2);
-void gl.uniform3fv(emplacement, valeur);
-void gl.uniform3i(emplacement, v0, v1, v2);
-void gl.uniform3iv(emplacement, valeur);
-
-void gl.uniform4f(emplacement, v0, v1, v2, v3);
-void gl.uniform4fv(emplacement, valeur);
-void gl.uniform4i(emplacement, v0, v1, v2, v3);
-void gl.uniform4iv(emplacement, valeur);
-
- -

Paramètres

- -
-
emplacement
-
Un objet {{domxref("WebGLUniformLocation")}} contenant l'emplacement de l'attribut uniform à modifier.
-
valeur, v0, v1, v2, v3
-
La nouvelle valeur à utiliser pour la variable uniform. Types possibles : -
    -
  • Un {{jsxref("Number")}} flottant pour les valeurs flottantes (méthodes avec "f").
  • -
  • Une suite de nombres flottants (par exemple, un {{jsxref("Float32Array")}} ou un {{jsxref("Array")}} de nombres) pour les méthodes de vecteurs de flottants (méthodes avec "fv").
  • -
  • Un {{jsxref("Number")}} entier pour les valeurs entières (méthodes avec "i").
  • -
  • Un {{jsxref("int32Array")}} pour les méthodes de vecteur d'entiers (méthodes avec "iv").
  • -
-
-
- -

Valeur retournée

- -

Aucune.

- -

Exemples

- -
gl.uniform1f(u_alpha, 0.8);
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.10", "uniform")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glUniform.xml", "glUniform")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API OpenGL.
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/uniform/index.md b/files/fr/web/api/webglrenderingcontext/uniform/index.md new file mode 100644 index 0000000000..cb27eaeb2c --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/uniform/index.md @@ -0,0 +1,97 @@ +--- +title: 'WebGLRenderingContext.uniform[1234][fi][v]()' +slug: Web/API/WebGLRenderingContext/uniform +tags: + - API + - Méthode + - Reference + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/uniform +--- +
{{APIRef("WebGL")}}
+ +

Les méthodes WebGLRenderingContext.uniform[1234][fi][v]() de l'API WebGL indiquent les valeurs des variables uniform.

+ +
+

Note : Beaucoup des fonctions décrites ici ont des interfaces WebGL 2 étendues, qui peuvent être trouvées en {{domxref("WebGL2RenderingContext.uniform","WebGL2RenderingContext.uniform[1234][uif][v]()")}}.

+
+ +

Syntaxe

+ +
void gl.uniform1f(emplacement, v0);
+void gl.uniform1fv(emplacement, valeur);
+void gl.uniform1i(emplacement, v0);
+void gl.uniform1iv(emplacement, valeur);
+
+void gl.uniform2f(emplacement, v0, v1);
+void gl.uniform2fv(emplacement, valeur);
+void gl.uniform2i(emplacement, v0, v1);
+void gl.uniform2iv(emplacement, valeur);
+
+void gl.uniform3f(emplacement, v0, v1, v2);
+void gl.uniform3fv(emplacement, valeur);
+void gl.uniform3i(emplacement, v0, v1, v2);
+void gl.uniform3iv(emplacement, valeur);
+
+void gl.uniform4f(emplacement, v0, v1, v2, v3);
+void gl.uniform4fv(emplacement, valeur);
+void gl.uniform4i(emplacement, v0, v1, v2, v3);
+void gl.uniform4iv(emplacement, valeur);
+
+ +

Paramètres

+ +
+
emplacement
+
Un objet {{domxref("WebGLUniformLocation")}} contenant l'emplacement de l'attribut uniform à modifier.
+
valeur, v0, v1, v2, v3
+
La nouvelle valeur à utiliser pour la variable uniform. Types possibles : +
    +
  • Un {{jsxref("Number")}} flottant pour les valeurs flottantes (méthodes avec "f").
  • +
  • Une suite de nombres flottants (par exemple, un {{jsxref("Float32Array")}} ou un {{jsxref("Array")}} de nombres) pour les méthodes de vecteurs de flottants (méthodes avec "fv").
  • +
  • Un {{jsxref("Number")}} entier pour les valeurs entières (méthodes avec "i").
  • +
  • Un {{jsxref("int32Array")}} pour les méthodes de vecteur d'entiers (méthodes avec "iv").
  • +
+
+
+ +

Valeur retournée

+ +

Aucune.

+ +

Exemples

+ +
gl.uniform1f(u_alpha, 0.8);
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.10", "uniform")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glUniform.xml", "glUniform")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API OpenGL.
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/uniformmatrix/index.html b/files/fr/web/api/webglrenderingcontext/uniformmatrix/index.html deleted file mode 100644 index 14f4da6939..0000000000 --- a/files/fr/web/api/webglrenderingcontext/uniformmatrix/index.html +++ /dev/null @@ -1,88 +0,0 @@ ---- -title: 'WebGLRenderingContext.uniformMatrix[234]fv()' -slug: Web/API/WebGLRenderingContext/uniformMatrix -tags: - - API - - Matrice - - Reference - - Uniforms - - Variables Uniform - - WebGL - - WebGLAPI - - WebGLRenderingContext - - matrices - - uniformMatrix2fv - - uniformMatrix3fv - - uniformMatrix4fv -translation_of: Web/API/WebGLRenderingContext/uniformMatrix ---- -
{{APIRef("WebGL")}}
- -

Les méthodes WebGLRenderingContext.uniformMatrix[234]fv() de l'API WebGL définissent des valeurs matricielles pour les variables uniform.

- -

Les trois versions de cette méthode (uniformMatrix2fv(), uniformMatrix3fv() et unifomMatrix4fv()) prennent comme valeur d'entrée des vecteurs à 2, 3 et 4 composantes, respectivement.

- -

Syntaxe

- -
WebGLRenderingContext.uniformMatrix2fv(emplacement, transposer, valeur);
-WebGLRenderingContext.uniformMatrix3fv(emplacement, transposer, valeur);
-WebGLRenderingContext.uniformMatrix4fv(emplacement, transposer, valeur);
-
- -

Paramètres

- -
-
emplacement
-
Un objet {{domxref("WebGLUniformLocation")}} contenant l'emplacement de l'attribut uniform à modifier. L'emplacement est obtenu en utilisant {{domxref("WebGLRenderingContext.getAttribLocation", "getAttribLocation()")}}.
-
transposer
-
Un {{domxref("GLboolean")}} indiquant si la matrice doit être transposée. Doit être false.
-
valeur
-
-

Un {{jsxref("Float32Array")}} ou une suite de valeurs GLfloat.

-
-
- -

Valeur retournée

- -

undefined

- -

Exemples

- -
gl.uniformMatrix2fv(loc, false, [2.1, 2.2]);
- -

Spécifications

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

Définition initiale.

-
{{SpecName('OpenGL ES 2.0', "glUniform.xml", "glUniform")}}{{Spec2('OpenGL ES 2.0')}} -

Page man de l’API OpenGL.

-
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/uniformmatrix/index.md b/files/fr/web/api/webglrenderingcontext/uniformmatrix/index.md new file mode 100644 index 0000000000..14f4da6939 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/uniformmatrix/index.md @@ -0,0 +1,88 @@ +--- +title: 'WebGLRenderingContext.uniformMatrix[234]fv()' +slug: Web/API/WebGLRenderingContext/uniformMatrix +tags: + - API + - Matrice + - Reference + - Uniforms + - Variables Uniform + - WebGL + - WebGLAPI + - WebGLRenderingContext + - matrices + - uniformMatrix2fv + - uniformMatrix3fv + - uniformMatrix4fv +translation_of: Web/API/WebGLRenderingContext/uniformMatrix +--- +
{{APIRef("WebGL")}}
+ +

Les méthodes WebGLRenderingContext.uniformMatrix[234]fv() de l'API WebGL définissent des valeurs matricielles pour les variables uniform.

+ +

Les trois versions de cette méthode (uniformMatrix2fv(), uniformMatrix3fv() et unifomMatrix4fv()) prennent comme valeur d'entrée des vecteurs à 2, 3 et 4 composantes, respectivement.

+ +

Syntaxe

+ +
WebGLRenderingContext.uniformMatrix2fv(emplacement, transposer, valeur);
+WebGLRenderingContext.uniformMatrix3fv(emplacement, transposer, valeur);
+WebGLRenderingContext.uniformMatrix4fv(emplacement, transposer, valeur);
+
+ +

Paramètres

+ +
+
emplacement
+
Un objet {{domxref("WebGLUniformLocation")}} contenant l'emplacement de l'attribut uniform à modifier. L'emplacement est obtenu en utilisant {{domxref("WebGLRenderingContext.getAttribLocation", "getAttribLocation()")}}.
+
transposer
+
Un {{domxref("GLboolean")}} indiquant si la matrice doit être transposée. Doit être false.
+
valeur
+
+

Un {{jsxref("Float32Array")}} ou une suite de valeurs GLfloat.

+
+
+ +

Valeur retournée

+ +

undefined

+ +

Exemples

+ +
gl.uniformMatrix2fv(loc, false, [2.1, 2.2]);
+ +

Spécifications

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

Définition initiale.

+
{{SpecName('OpenGL ES 2.0', "glUniform.xml", "glUniform")}}{{Spec2('OpenGL ES 2.0')}} +

Page man de l’API OpenGL.

+
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/useprogram/index.html b/files/fr/web/api/webglrenderingcontext/useprogram/index.html deleted file mode 100644 index dced5c95a4..0000000000 --- a/files/fr/web/api/webglrenderingcontext/useprogram/index.html +++ /dev/null @@ -1,80 +0,0 @@ ---- -title: WebGLRenderingContext.useProgram() -slug: Web/API/WebGLRenderingContext/useProgram -tags: - - API - - Méthode - - Reference - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/useProgram ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.useProgram() de l'API WebGL définit le {{domxref("WebGLProgram")}} spécifié comme faisant partie de l'état de rendu en cours.

- -

Syntaxe

- -
void gl.useProgram(programme);
-
- -

Paramètres

- -
-
programme
-
Un {{domxref("WebGLProgram")}} à utiliser.
-
- -

Valeur retournée

- -

Aucune.

- -

Exemples

- -
var programme = gl.createProgram();
-
-// Attacher les shaders pré-existants
-gl.attachShader(programme, vertexShader);
-gl.attachShader(programme, fragmentShader);
-
-gl.linkProgram(programme);
-gl.useProgram(programme);
-
- -

Spécifications

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.9", "useProgram")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glUseProgram.xml", "glUseProgram")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API OpenGL.
- -

Browser compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/useprogram/index.md b/files/fr/web/api/webglrenderingcontext/useprogram/index.md new file mode 100644 index 0000000000..dced5c95a4 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/useprogram/index.md @@ -0,0 +1,80 @@ +--- +title: WebGLRenderingContext.useProgram() +slug: Web/API/WebGLRenderingContext/useProgram +tags: + - API + - Méthode + - Reference + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/useProgram +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.useProgram() de l'API WebGL définit le {{domxref("WebGLProgram")}} spécifié comme faisant partie de l'état de rendu en cours.

+ +

Syntaxe

+ +
void gl.useProgram(programme);
+
+ +

Paramètres

+ +
+
programme
+
Un {{domxref("WebGLProgram")}} à utiliser.
+
+ +

Valeur retournée

+ +

Aucune.

+ +

Exemples

+ +
var programme = gl.createProgram();
+
+// Attacher les shaders pré-existants
+gl.attachShader(programme, vertexShader);
+gl.attachShader(programme, fragmentShader);
+
+gl.linkProgram(programme);
+gl.useProgram(programme);
+
+ +

Spécifications

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{SpecName('WebGL', "#5.14.9", "useProgram")}}{{Spec2('WebGL')}}Définition initiale.
{{SpecName('OpenGL ES 2.0', "glUseProgram.xml", "glUseProgram")}}{{Spec2('OpenGL ES 2.0')}}Page man de l'API OpenGL.
+ +

Browser compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/vertexattribpointer/index.html b/files/fr/web/api/webglrenderingcontext/vertexattribpointer/index.html deleted file mode 100644 index 93961c4fda..0000000000 --- a/files/fr/web/api/webglrenderingcontext/vertexattribpointer/index.html +++ /dev/null @@ -1,254 +0,0 @@ ---- -title: WebGLRenderingContext.vertexAttribPointer() -slug: Web/API/WebGLRenderingContext/vertexAttribPointer -tags: - - API - - Méthode - - Reference - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/vertexAttribPointer ---- -
{{APIRef("WebGL")}}
- -

La méthode WebGLRenderingContext.vertexAttribPointer() de l'API WebGL spécifie la disposition en mémoire de l'objet de tampon vertex. Elle doit être appelée une fois pour chaque attribut de sommet.

- -

Syntaxe

- -
void gl.vertexAttribPointer(indice, taille, type, normalise, pas, decalage);
-
- -

Paramètres

- -
-
indice
-
Un {{domxref("GLuint")}} indiquant l'indice de l'attribut de sommet à modifier.
-
taille
-
Un {{domxref("GLint")}} indiquant le nombre de composantes par attribut de sommet. Doit être 1, 2, 3 ou 4.
-
type
-
Un {{domxref ("GLenum")}} spécifiant le type de données de chaque composante dans le tableau. Valeurs possibles : -
    -
  • gl.BYTE : entier signé sur 8 bits, à valeurs dans [-128, 127]
  • -
  • gl.SHORT : entier signé sur 16 bits, à valeurs dans [-32768, 32767]
  • -
  • gl.UNSIGNED_BYTE : entier non signé sur 8 bits, à valeurs dans [0, 255]
  • -
  • gl.UNSIGNED_SHORT : entier non signé sur 16 bits, à valeurs dans [0, 65535]
  • -
  • gl.FLOAT : nombre flottant IEEE 32 bits
  • -
  • lors de l'utilisation d'un {{domxref("WebGL2RenderingContext", "WebGL context 2", "", 1)}}, la valeur suivante est en outre disponible : -
      -
    • gl.HALF_FLOAT : nombre flottant IEEE 16 bits
    • -
    -
  • -
-
-
normalise
-
Un {{domxref("GLboolean")}} indiquant si les valeurs des données entières doivent être normalisées dans une certaine plage lorsqu'elles sont converties en flottant. -
    -
  • Pour les types gl.BYTE et gl.SHORT, normalise les valeurs à [-1, 1] si true.
  • -
  • Pour les types gl.UNSIGNED_BYTE et gl.UNSIGNED_SHORT, normalise les valeurs à [0, 1] si true.
  • -
  • Pour les types gl.FLOAT et gl.HALF_FLOAT, ce paramètre est sans effet.
  • -
-
-
pas
-
Un {{domxref ("GLsizei")}} spécifiant le décalage en octets entre le début des attributs de sommets consécutifs. Ne peut être supérieur à 255. Si la valeur de pas est 0, l'attribut est supposé être étroitement compacté, c'est-à-dire que les attributs ne sont pas entrelacés mais que chaque attribut se trouve dans un bloc distinct et que l'attribut du sommet suivant suit immédiatement le sommet en cours.
-
decalage
-
Un {{domxref ("GLintptr")}} spécifiant le décalage en octets de la première composante dans le tableau d'attributs de sommets. Doit être un multiple de type.
-
- -

Valeur retournée

- -

Aucune.

- -

Exceptions

- - - -

Description

- -

Supposons que nous voulions afficher une géométrie 3D, et que pour cela, nous ayons besoin de fournir nos sommets au Shader de Sommet. Chaque sommet a un certain nombre d'attributs, tels que la position, le vecteur normal ou les coordonnées de texture, qui sont définis dans un {{jsxref("ArrayBuffer")}} et qui seront fournis à l'Objet de Tampon de Sommets (OTS). Grâce à cette méthode gl.vertexAttribPointer(), nous spécifions dans quel ordre les attributs sont stockés, et quel est leur type de données. De plus, nous devons inclure le pas, qui est la longueur totale en octets de tous les attributs pour un sommet. Également, nous devons appeler {{domxref("WebGLRenderingContext/enableVertexAttribArray", "gl.enableVertexAttribArray()")}} pour indiquer à WebGL que cet attribut doit être rempli avec les données de notre tampon de tableaux.

- -

Habituellement, votre géométrie 3D se trouve déjà dans un certain format binaire, de sorte que vous devez lire la spécification de ce format particulier pour comprendre la disposition en mémoire. Cependant, si vous concevez le format vous-même, ou si votre géométrie se trouve dans des fichiers texte (comme les fichiers Wavefront .obj) et doit être convertie en ArrayBuffer à l'exécution, vous êtes libre de choisir comment structurer la mémoire. Pour des performances optimales, entrelacez les attributs et utilisez le plus petit type de données représentant néanmoins fidèlement votre géométrie.

- -

Le nombre maximum d'attributs de vertex dépend de la carte graphique, et vous pouvez appeler gl.getParameter(gl.MAX_VERTEX_ATTRIBS) pour obtenir cette valeur. Sur les cartes graphiques haut de gamme, le maximum est de 16, sur les cartes graphiques de bas de gamme, la valeur sera inférieure.

- -

Indice d'attribut

- -

Pour chaque attribut, vous devez spécifier son indice. Cela est indépendant de l'emplacement à l'intérieur de la mémoire tampon de tableaux, de sorte que vos attributs peuvent être envoyés dans un ordre différent de celui dans lequel ils sont stockés dans le tampon de tableaux. Vous avez deux options :

- - - -

Attributs entiers

- -

Bien que le ArrayBuffer puisse être rempli à la fois d'entiers et de flottants, les attributs seront toujours convertis en flottant lorsqu'ils seront envoyés au shader de sommet. Si vous avez besoin d'utiliser des entiers dans votre code de shader de sommet, vous pouvez, soit reconvertir les flottants en entiers dans le shader de sommet (par exemple, (int) floatNumber), soit utiliser {{domxref("WebGL2RenderingContext.vertexAttribIPointer()", "gl.vertexAttribIPointer()")}} à partir de WebGL2.

- -

Valeurs d'attribut par défaut

- -

Le code de vertex shader peut inclure un certain nombre d'attributs, mais nous n'avons pas besoin de spécifier les valeurs pour chaque attribut. A la place, nous pouvons fournir une valeur par défaut qui sera identique pour tous les sommets. Nous pouvons appeler {{domxref("WebGLRenderingContext.disableVertexAttribArray()", "gl.disableVertexAttribArray()")}} pour indiquer à WebGL d'utiliser la valeur par défaut, tandis que l'appel à {{domxref("WebGLRenderingContext.enableVertexAttribArray ()", "gl.enableVertexAttribArray () ")}} lira les valeurs du buffer du tableau comme spécifié avec gl.vertexAttribPointer().

- -

De façon similaire, si notre shader de sommet attend par ex. un attribut à 4 composantes avec vec4, mais que dans notre appel à gl.vertexAttribPointer(), nous définissons la taille à 2, alors WebGL définira les deux premières composantes en se basant sur le tampon des tableaux, tandis que les troisième et quatrième composantes prendront la valeur par défaut.

- -

La valeur par défaut est vec4(0.0, 0.0, 0.0, 1.0) par défaut, mais nous pouvons spécifier une valeur par défaut différente avec {{domxref ("WebGLRenderingContext.vertexAttrib()", "gl.vertexAttrib[1234]f[v]()")}}.

- -

Par exemple, votre shader de sommet peut utiliser une position et un attribut de couleur. La plupart des maillages ont leur couleur spécifiée au niveau des sommets, mais certains maillages ont une teinte uniforme. Pour ces maillages, il n'est pas nécessaire de définir la même couleur pour chaque sommet dans le tampon des tableaux, aussi vous utiliserez gl.vertexAttrib4fv() pour définir une couleur constante.

- -

Interrogation des paramètres en cours

- -

Vous pouvez appeler {{domxref ("WebGLRenderingContext.getVertexAttrib()", "gl.getVertexAttrib()")}} et {{domxref ("WebGLRenderingContext.getVertexAttribOffset()", "gl.getVertexAttribOffset()")}} pour obtenir les paramètres en cours d'un attribut, par ex., le type de données ou si l'attribut doit être normalisé. Gardez présent à l'esprit que ces fonctions WebGL ont des performances faibles et qu'il est préférable de stocker l'état dans votre application JavaScript. Cependant, ces fonctions sont idéales pour déboguer un contexte WebGL sans toucher au code de l'application.

- -

Exemples

- -

Cet exemple montre comment envoyer vos attributs de sommet au programme shader. Nous utilisons une structure de données imaginaire, dans laquelle les attributs de chaque sommet sont stockés entrelacés avec une longueur de 20 octets par sommet :

- -
    -
  1. position : nous devons stocker les coordonnées X, Y et Z. Pour une précision maximale, nous utilisons des flottants 32 bits ; au total, cela utilise 12 octets ;
  2. -
  3. vecteur normal : nous avons besoin de stocker les composantes X, Y et Z du vecteur normal, mais comme la précision n'est pas si importante que cela, nous utilisons des entiers signés sur 8 bits. Pour de meilleures performances, nous alignons les données sur 32 bits en stockant également une quatrième composante de valeur zéro, ce qui porte la taille totale à 4 octets. Également, nous indiquons à WebGL de normaliser les valeurs, car nos normales sont toujours dans la plage [-1, 1] ;
  4. -
  5. coordonnées de texture : nous avons besoin de stocker les coordonnées U et V ; pour que ces nombres entiers non signés sur 16 bits offrent suffisamment de précision, la taille totale est de 4 octets. Nous indiquons également à WebGL de normaliser les valeurs à [0, 1].
  6. -
- -

Par exemple, le sommet suivant :

- -
{
-  "position": [1.0, 2.0, 1.5],
-  "normale": [1.0, 0.0, 0.0],
-  "coordTex": [0.5, 0.25]
-}
-
- -

sera stocké dans le tampon des tableaux comme suit :

- - - - - - - - - - - - - - - -
00 00 80 3F00 00 00 4000 00 0C 3F7F0000007F FF3F FF
- -

Création du tampon des tableaux

- -

Tout d'abord, nous créons dynamiquement le tampon des tableaux à partir de données JSON en utilisant un {{domxref("DataView")}}. Notez l'utilisation de true, car WebGL s'attend à ce que nos données soient en little-endian.

- -
// Charger la géometrie avec fetch() et Response.json()
-const response = await fetch('assets/geometry.json');
-const sommets = await response.json();
-
-// Créer le tampon des tableaux
-const tampon = new ArrayBuffer(20 * sommets.length);
-// Remplir le tampon des tableaux
-const dv = new DataView(tampon);
-for (let i = 0; i < sommets.length; i++) {
-  dv.setFloat32(20 * i, sommets[i].position[0], true);
-  dv.setFloat32(20 * i + 4, sommets[i].position[1], true);
-  dv.setFloat32(20 * i + 8, sommets[i].position[2], true);
-  dv.setInt8(20 * i + 12, sommets[i].normale[0] * 0x7F);
-  dv.setInt8(20 * i + 13, sommets[i].normale[1] * 0x7F);
-  dv.setInt8(20 * i + 14, sommets[i].normale[2] * 0x7F);
-  dv.setInt8(20 * i + 15, 0);
-  dv.setUint16(20 * i + 16, sommets[i].coordTex[0] * 0xFFFF, true);
-  dv.setUint16(20 * i + 18, sommets[i].coordTex[1] * 0xFFFF, true);
-}
- -

Pour de meilleures performances, nous pourrions également effectuer la conversion JSON vers ArrayBuffer précédente du côté serveur, par ex. avec Node.js. Nous pourrions alors charger le fichier binaire et l'interpréter comme un tampon de tableaux :

- -
const response = await fetch('assets/geometry.bin');
-const tampon = await response.arrayBuffer();
-
- -

Utiliser le tampon de tableaux avec WebGL

- -

Tout d'abord, nous créons un nouvel Objet Tampon de Sommets (OTS) et nous l'alimentons avec notre tampon de tableaux :

- -
// Lier le tampon de tableaux à l'Objet Tampon de Sommets
-const ots = gl.createBuffer();
-gl.bindBuffer(gl.ARRAY_BUFFER, ots);
-gl.bufferData(gl.ARRAY_BUFFER, buffer, gl.STATIC_DRAW);
-
- -

Ensuite, nous spécifions la disposition en mémoire du tampon de tableaux, soit en définissant nous-mêmes l'indice :

- -
// Décrire la disposition du tampon :
-//1. position, non normalisé
-gl.vertexAttribPointer(0, 3, gl.FLOAT, false, 20, 0);
-gl.enableVertexAttribArray(0);
-//2. vecteur normal, normalisé à [-1, 1]
-gl.vertexAttribPointer(1, 4, gl.BYTE, true, 20, 12);
-gl.enableVertexAttribArray(1);
-//3. coordonnées de texture, normalisées à [0, 1]
-gl.vertexAttribPointer(2, 2, gl.UNSIGNED_SHORT, true, 20, 16);
-gl.enableVertexAttribArray(2);
-
-// Définir les attributs dans le shader de sommet aux mêmes indices
-gl.bindAttribLocation(shaderProgram, 0, 'position');
-gl.bindAttribLocation(shaderProgram, 1, 'normal');
-gl.bindAttribLocation(shaderProgram, 2, 'texUV');
-// Du fait que indices des attributs ont changé, nous devons refaire l'édition de liens du shader
-// Noter que cela réinitialisera tous les uniforms qui avaient été précédemment définis.
-gl.linkProgram(shaderProgram);
-
- -

soit en utilisant l'indice fourni par la carte graphique, au lieu de le définir nous-mêmes ; cela évite la réédition des liens du programme shader.

- -
const positionLoc = gl.getAttribLocation(shaderProgram, 'position');
-gl.vertexAttribPointer(positionLoc, 3, gl.FLOAT, false, 20, 0);
-gl.enableVertexAttribArray(positionLoc);
-
-const normalLoc = gl.getAttribLocation(shaderProgram, 'normal');
-gl.vertexAttribPointer(normalLoc, 4, gl.BYTE, true, 20, 12);
-gl.enableVertexAttribArray(normalLoc);
-
-const texUVLoc = gl.getAttribLocation(shaderProgram, 'texUV');
-gl.vertexAttribPointer(texUVLoc, 2, gl.UNSIGNED_SHORT, true, 20, 16);
-gl.enableVertexAttribArray(texUVLoc);
-
- -

Spécifications

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

Définition initiale.

-
{{SpecName('OpenGL ES 2.0', "glVertexAttribPointer.xml", "glVertexAttribPointer")}}{{Spec2('OpenGL ES 2.0')}} -

Page man de l’API OpenGL.

-
- -

Compatibilité des navigateurs

- -

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

- -

Voir aussi

- - diff --git a/files/fr/web/api/webglrenderingcontext/vertexattribpointer/index.md b/files/fr/web/api/webglrenderingcontext/vertexattribpointer/index.md new file mode 100644 index 0000000000..93961c4fda --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/vertexattribpointer/index.md @@ -0,0 +1,254 @@ +--- +title: WebGLRenderingContext.vertexAttribPointer() +slug: Web/API/WebGLRenderingContext/vertexAttribPointer +tags: + - API + - Méthode + - Reference + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/vertexAttribPointer +--- +
{{APIRef("WebGL")}}
+ +

La méthode WebGLRenderingContext.vertexAttribPointer() de l'API WebGL spécifie la disposition en mémoire de l'objet de tampon vertex. Elle doit être appelée une fois pour chaque attribut de sommet.

+ +

Syntaxe

+ +
void gl.vertexAttribPointer(indice, taille, type, normalise, pas, decalage);
+
+ +

Paramètres

+ +
+
indice
+
Un {{domxref("GLuint")}} indiquant l'indice de l'attribut de sommet à modifier.
+
taille
+
Un {{domxref("GLint")}} indiquant le nombre de composantes par attribut de sommet. Doit être 1, 2, 3 ou 4.
+
type
+
Un {{domxref ("GLenum")}} spécifiant le type de données de chaque composante dans le tableau. Valeurs possibles : +
    +
  • gl.BYTE : entier signé sur 8 bits, à valeurs dans [-128, 127]
  • +
  • gl.SHORT : entier signé sur 16 bits, à valeurs dans [-32768, 32767]
  • +
  • gl.UNSIGNED_BYTE : entier non signé sur 8 bits, à valeurs dans [0, 255]
  • +
  • gl.UNSIGNED_SHORT : entier non signé sur 16 bits, à valeurs dans [0, 65535]
  • +
  • gl.FLOAT : nombre flottant IEEE 32 bits
  • +
  • lors de l'utilisation d'un {{domxref("WebGL2RenderingContext", "WebGL context 2", "", 1)}}, la valeur suivante est en outre disponible : +
      +
    • gl.HALF_FLOAT : nombre flottant IEEE 16 bits
    • +
    +
  • +
+
+
normalise
+
Un {{domxref("GLboolean")}} indiquant si les valeurs des données entières doivent être normalisées dans une certaine plage lorsqu'elles sont converties en flottant. +
    +
  • Pour les types gl.BYTE et gl.SHORT, normalise les valeurs à [-1, 1] si true.
  • +
  • Pour les types gl.UNSIGNED_BYTE et gl.UNSIGNED_SHORT, normalise les valeurs à [0, 1] si true.
  • +
  • Pour les types gl.FLOAT et gl.HALF_FLOAT, ce paramètre est sans effet.
  • +
+
+
pas
+
Un {{domxref ("GLsizei")}} spécifiant le décalage en octets entre le début des attributs de sommets consécutifs. Ne peut être supérieur à 255. Si la valeur de pas est 0, l'attribut est supposé être étroitement compacté, c'est-à-dire que les attributs ne sont pas entrelacés mais que chaque attribut se trouve dans un bloc distinct et que l'attribut du sommet suivant suit immédiatement le sommet en cours.
+
decalage
+
Un {{domxref ("GLintptr")}} spécifiant le décalage en octets de la première composante dans le tableau d'attributs de sommets. Doit être un multiple de type.
+
+ +

Valeur retournée

+ +

Aucune.

+ +

Exceptions

+ + + +

Description

+ +

Supposons que nous voulions afficher une géométrie 3D, et que pour cela, nous ayons besoin de fournir nos sommets au Shader de Sommet. Chaque sommet a un certain nombre d'attributs, tels que la position, le vecteur normal ou les coordonnées de texture, qui sont définis dans un {{jsxref("ArrayBuffer")}} et qui seront fournis à l'Objet de Tampon de Sommets (OTS). Grâce à cette méthode gl.vertexAttribPointer(), nous spécifions dans quel ordre les attributs sont stockés, et quel est leur type de données. De plus, nous devons inclure le pas, qui est la longueur totale en octets de tous les attributs pour un sommet. Également, nous devons appeler {{domxref("WebGLRenderingContext/enableVertexAttribArray", "gl.enableVertexAttribArray()")}} pour indiquer à WebGL que cet attribut doit être rempli avec les données de notre tampon de tableaux.

+ +

Habituellement, votre géométrie 3D se trouve déjà dans un certain format binaire, de sorte que vous devez lire la spécification de ce format particulier pour comprendre la disposition en mémoire. Cependant, si vous concevez le format vous-même, ou si votre géométrie se trouve dans des fichiers texte (comme les fichiers Wavefront .obj) et doit être convertie en ArrayBuffer à l'exécution, vous êtes libre de choisir comment structurer la mémoire. Pour des performances optimales, entrelacez les attributs et utilisez le plus petit type de données représentant néanmoins fidèlement votre géométrie.

+ +

Le nombre maximum d'attributs de vertex dépend de la carte graphique, et vous pouvez appeler gl.getParameter(gl.MAX_VERTEX_ATTRIBS) pour obtenir cette valeur. Sur les cartes graphiques haut de gamme, le maximum est de 16, sur les cartes graphiques de bas de gamme, la valeur sera inférieure.

+ +

Indice d'attribut

+ +

Pour chaque attribut, vous devez spécifier son indice. Cela est indépendant de l'emplacement à l'intérieur de la mémoire tampon de tableaux, de sorte que vos attributs peuvent être envoyés dans un ordre différent de celui dans lequel ils sont stockés dans le tampon de tableaux. Vous avez deux options :

+ + + +

Attributs entiers

+ +

Bien que le ArrayBuffer puisse être rempli à la fois d'entiers et de flottants, les attributs seront toujours convertis en flottant lorsqu'ils seront envoyés au shader de sommet. Si vous avez besoin d'utiliser des entiers dans votre code de shader de sommet, vous pouvez, soit reconvertir les flottants en entiers dans le shader de sommet (par exemple, (int) floatNumber), soit utiliser {{domxref("WebGL2RenderingContext.vertexAttribIPointer()", "gl.vertexAttribIPointer()")}} à partir de WebGL2.

+ +

Valeurs d'attribut par défaut

+ +

Le code de vertex shader peut inclure un certain nombre d'attributs, mais nous n'avons pas besoin de spécifier les valeurs pour chaque attribut. A la place, nous pouvons fournir une valeur par défaut qui sera identique pour tous les sommets. Nous pouvons appeler {{domxref("WebGLRenderingContext.disableVertexAttribArray()", "gl.disableVertexAttribArray()")}} pour indiquer à WebGL d'utiliser la valeur par défaut, tandis que l'appel à {{domxref("WebGLRenderingContext.enableVertexAttribArray ()", "gl.enableVertexAttribArray () ")}} lira les valeurs du buffer du tableau comme spécifié avec gl.vertexAttribPointer().

+ +

De façon similaire, si notre shader de sommet attend par ex. un attribut à 4 composantes avec vec4, mais que dans notre appel à gl.vertexAttribPointer(), nous définissons la taille à 2, alors WebGL définira les deux premières composantes en se basant sur le tampon des tableaux, tandis que les troisième et quatrième composantes prendront la valeur par défaut.

+ +

La valeur par défaut est vec4(0.0, 0.0, 0.0, 1.0) par défaut, mais nous pouvons spécifier une valeur par défaut différente avec {{domxref ("WebGLRenderingContext.vertexAttrib()", "gl.vertexAttrib[1234]f[v]()")}}.

+ +

Par exemple, votre shader de sommet peut utiliser une position et un attribut de couleur. La plupart des maillages ont leur couleur spécifiée au niveau des sommets, mais certains maillages ont une teinte uniforme. Pour ces maillages, il n'est pas nécessaire de définir la même couleur pour chaque sommet dans le tampon des tableaux, aussi vous utiliserez gl.vertexAttrib4fv() pour définir une couleur constante.

+ +

Interrogation des paramètres en cours

+ +

Vous pouvez appeler {{domxref ("WebGLRenderingContext.getVertexAttrib()", "gl.getVertexAttrib()")}} et {{domxref ("WebGLRenderingContext.getVertexAttribOffset()", "gl.getVertexAttribOffset()")}} pour obtenir les paramètres en cours d'un attribut, par ex., le type de données ou si l'attribut doit être normalisé. Gardez présent à l'esprit que ces fonctions WebGL ont des performances faibles et qu'il est préférable de stocker l'état dans votre application JavaScript. Cependant, ces fonctions sont idéales pour déboguer un contexte WebGL sans toucher au code de l'application.

+ +

Exemples

+ +

Cet exemple montre comment envoyer vos attributs de sommet au programme shader. Nous utilisons une structure de données imaginaire, dans laquelle les attributs de chaque sommet sont stockés entrelacés avec une longueur de 20 octets par sommet :

+ +
    +
  1. position : nous devons stocker les coordonnées X, Y et Z. Pour une précision maximale, nous utilisons des flottants 32 bits ; au total, cela utilise 12 octets ;
  2. +
  3. vecteur normal : nous avons besoin de stocker les composantes X, Y et Z du vecteur normal, mais comme la précision n'est pas si importante que cela, nous utilisons des entiers signés sur 8 bits. Pour de meilleures performances, nous alignons les données sur 32 bits en stockant également une quatrième composante de valeur zéro, ce qui porte la taille totale à 4 octets. Également, nous indiquons à WebGL de normaliser les valeurs, car nos normales sont toujours dans la plage [-1, 1] ;
  4. +
  5. coordonnées de texture : nous avons besoin de stocker les coordonnées U et V ; pour que ces nombres entiers non signés sur 16 bits offrent suffisamment de précision, la taille totale est de 4 octets. Nous indiquons également à WebGL de normaliser les valeurs à [0, 1].
  6. +
+ +

Par exemple, le sommet suivant :

+ +
{
+  "position": [1.0, 2.0, 1.5],
+  "normale": [1.0, 0.0, 0.0],
+  "coordTex": [0.5, 0.25]
+}
+
+ +

sera stocké dans le tampon des tableaux comme suit :

+ + + + + + + + + + + + + + + +
00 00 80 3F00 00 00 4000 00 0C 3F7F0000007F FF3F FF
+ +

Création du tampon des tableaux

+ +

Tout d'abord, nous créons dynamiquement le tampon des tableaux à partir de données JSON en utilisant un {{domxref("DataView")}}. Notez l'utilisation de true, car WebGL s'attend à ce que nos données soient en little-endian.

+ +
// Charger la géometrie avec fetch() et Response.json()
+const response = await fetch('assets/geometry.json');
+const sommets = await response.json();
+
+// Créer le tampon des tableaux
+const tampon = new ArrayBuffer(20 * sommets.length);
+// Remplir le tampon des tableaux
+const dv = new DataView(tampon);
+for (let i = 0; i < sommets.length; i++) {
+  dv.setFloat32(20 * i, sommets[i].position[0], true);
+  dv.setFloat32(20 * i + 4, sommets[i].position[1], true);
+  dv.setFloat32(20 * i + 8, sommets[i].position[2], true);
+  dv.setInt8(20 * i + 12, sommets[i].normale[0] * 0x7F);
+  dv.setInt8(20 * i + 13, sommets[i].normale[1] * 0x7F);
+  dv.setInt8(20 * i + 14, sommets[i].normale[2] * 0x7F);
+  dv.setInt8(20 * i + 15, 0);
+  dv.setUint16(20 * i + 16, sommets[i].coordTex[0] * 0xFFFF, true);
+  dv.setUint16(20 * i + 18, sommets[i].coordTex[1] * 0xFFFF, true);
+}
+ +

Pour de meilleures performances, nous pourrions également effectuer la conversion JSON vers ArrayBuffer précédente du côté serveur, par ex. avec Node.js. Nous pourrions alors charger le fichier binaire et l'interpréter comme un tampon de tableaux :

+ +
const response = await fetch('assets/geometry.bin');
+const tampon = await response.arrayBuffer();
+
+ +

Utiliser le tampon de tableaux avec WebGL

+ +

Tout d'abord, nous créons un nouvel Objet Tampon de Sommets (OTS) et nous l'alimentons avec notre tampon de tableaux :

+ +
// Lier le tampon de tableaux à l'Objet Tampon de Sommets
+const ots = gl.createBuffer();
+gl.bindBuffer(gl.ARRAY_BUFFER, ots);
+gl.bufferData(gl.ARRAY_BUFFER, buffer, gl.STATIC_DRAW);
+
+ +

Ensuite, nous spécifions la disposition en mémoire du tampon de tableaux, soit en définissant nous-mêmes l'indice :

+ +
// Décrire la disposition du tampon :
+//1. position, non normalisé
+gl.vertexAttribPointer(0, 3, gl.FLOAT, false, 20, 0);
+gl.enableVertexAttribArray(0);
+//2. vecteur normal, normalisé à [-1, 1]
+gl.vertexAttribPointer(1, 4, gl.BYTE, true, 20, 12);
+gl.enableVertexAttribArray(1);
+//3. coordonnées de texture, normalisées à [0, 1]
+gl.vertexAttribPointer(2, 2, gl.UNSIGNED_SHORT, true, 20, 16);
+gl.enableVertexAttribArray(2);
+
+// Définir les attributs dans le shader de sommet aux mêmes indices
+gl.bindAttribLocation(shaderProgram, 0, 'position');
+gl.bindAttribLocation(shaderProgram, 1, 'normal');
+gl.bindAttribLocation(shaderProgram, 2, 'texUV');
+// Du fait que indices des attributs ont changé, nous devons refaire l'édition de liens du shader
+// Noter que cela réinitialisera tous les uniforms qui avaient été précédemment définis.
+gl.linkProgram(shaderProgram);
+
+ +

soit en utilisant l'indice fourni par la carte graphique, au lieu de le définir nous-mêmes ; cela évite la réédition des liens du programme shader.

+ +
const positionLoc = gl.getAttribLocation(shaderProgram, 'position');
+gl.vertexAttribPointer(positionLoc, 3, gl.FLOAT, false, 20, 0);
+gl.enableVertexAttribArray(positionLoc);
+
+const normalLoc = gl.getAttribLocation(shaderProgram, 'normal');
+gl.vertexAttribPointer(normalLoc, 4, gl.BYTE, true, 20, 12);
+gl.enableVertexAttribArray(normalLoc);
+
+const texUVLoc = gl.getAttribLocation(shaderProgram, 'texUV');
+gl.vertexAttribPointer(texUVLoc, 2, gl.UNSIGNED_SHORT, true, 20, 16);
+gl.enableVertexAttribArray(texUVLoc);
+
+ +

Spécifications

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

Définition initiale.

+
{{SpecName('OpenGL ES 2.0', "glVertexAttribPointer.xml", "glVertexAttribPointer")}}{{Spec2('OpenGL ES 2.0')}} +

Page man de l’API OpenGL.

+
+ +

Compatibilité des navigateurs

+ +

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

+ +

Voir aussi

+ + diff --git a/files/fr/web/api/webglrenderingcontext/viewport/index.html b/files/fr/web/api/webglrenderingcontext/viewport/index.html deleted file mode 100644 index 76290a9bd6..0000000000 --- a/files/fr/web/api/webglrenderingcontext/viewport/index.html +++ /dev/null @@ -1,92 +0,0 @@ ---- -title: WebGLRenderingContext.viewport() -slug: Web/API/WebGLRenderingContext/viewport -tags: - - API - - Méthode - - Reference - - WebGL - - WebGLRenderingContext -translation_of: Web/API/WebGLRenderingContext/viewport ---- -
{{APIRef("WebGL")}}
- -

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 {{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.
-
- -

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 {{jsxref ("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

- - - - - - - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{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

- - diff --git a/files/fr/web/api/webglrenderingcontext/viewport/index.md b/files/fr/web/api/webglrenderingcontext/viewport/index.md new file mode 100644 index 0000000000..76290a9bd6 --- /dev/null +++ b/files/fr/web/api/webglrenderingcontext/viewport/index.md @@ -0,0 +1,92 @@ +--- +title: WebGLRenderingContext.viewport() +slug: Web/API/WebGLRenderingContext/viewport +tags: + - API + - Méthode + - Reference + - WebGL + - WebGLRenderingContext +translation_of: Web/API/WebGLRenderingContext/viewport +--- +
{{APIRef("WebGL")}}
+ +

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 {{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.
+
+ +

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 {{jsxref ("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

+ + + + + + + + + + + + + + + + + + + +
SpécificationStatutCommentaire
{{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

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