blob: 86065baf61c2ff9a846ca0139b2617480244fad2 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
|
---
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](/fr-FR/docs/Web/API/WebGL_API) 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.
```js
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.
```js
gl.getParameter(gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS);
```
Pour obtenir la texture en cours, faire une requête sur la constante `ACTIVE_TEXTURE`.
```js
gl.activeTexture(gl.TEXTURE0);
gl.getParameter(gl.ACTIVE_TEXTURE);
// retourne "33984" (0x84C0, valeur enum pour gl.TEXTURE0)
```
## Spécifications
| Spécification | Statué | 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
- {{domxref("WebGLRenderingContext.getParameter()")}}
|
