glProgramUniform

Syntaxe

Paramètres

Description

Cette fonction permet de définir une valeur uniforme (constante pour tous les fragments ou vertex d'un programme shader). Elle permet de mettre à jour une valeur directement dans le programme shader spécifié sans devoir lier le programme au contexte actif.

La fonction `glProgramUniform` modifie la valeur d'une variable uniforme ou d'un tableau de variables uniformes. L'emplacement de la variable à modifier est spécifié par `location`, qui doit correspondre à une valeur renvoyée par `glGetUniformLocation`. `glProgramUniform` agit sur l'objet programme spécifié par `program`.

Les commandes `glProgramUniform{1|2|3|4}{f|i|ui}` permettent de modifier la valeur de la variable uniforme spécifiée par `location` à l'aide des valeurs passées en arguments. Le nombre spécifié dans la commande doit correspondre au nombre de composantes du type de données de la variable uniforme (par exemple, 1 pour `float`, `int`, `unsigned int`, `bool` ; 2 pour `vec2`, `ivec2`, `uvec2`, `bvec2`, etc.). Le suffixe `f` indique que des valeurs à virgule flottante sont passées ; le suffixe `i` indique que des valeurs entières sont passées ; le suffixe `ui` indique que des valeurs entières non signées sont passées, et ce type doit également correspondre au type de données de la variable uniforme spécifiée. Les variantes `i` de cette fonction doivent être utilisées pour fournir des valeurs aux variables uniformes de type `int`, `ivec2`, `ivec3`, `ivec4` ou à des tableaux de ces types. Les variantes `ui` doivent être utilisées pour fournir des valeurs aux variables uniformes de type `unsigned int`, `uvec2`, `uvec3`, `uvec4` ou à des tableaux de ces types. Les variantes `f` doivent être utilisées pour fournir des valeurs aux variables uniformes de type `float`, `vec2`, `vec3`, `vec4` ou à des tableaux de ces types. Les variantes `i`, `ui` ou `f` peuvent être utilisées pour fournir des valeurs aux variables uniformes de type `bool`, `bvec2`, `bvec3`, `bvec4` ou à des tableaux de ces types. La variable uniforme sera initialisée à `false` si la valeur d'entrée est 0 ou 0.0f, et à `true` sinon.

Toutes les variables uniformes actives définies dans un objet programme sont initialisées à 0 lors de la liaison réussie de l'objet programme. Elles conservent les valeurs qui leur sont assignées par un appel à `glProgramUniform` jusqu'à la prochaine opération de liaison réussie sur l'objet programme, après quoi elles sont réinitialisées à 0.

Les commandes `glProgramUniform{1|2|3|4}{f|i|ui}v` permettent de modifier une variable uniforme unique ou un tableau de variables uniformes. Ces commandes prennent en paramètres un compteur et un pointeur vers les valeurs à charger dans une variable uniforme ou un tableau de variables uniformes. Un compteur de 1 doit être utilisé pour modifier la valeur d'une seule variable uniforme, et un compteur supérieur ou égal à 1 peut être utilisé pour modifier un tableau entier ou une partie de tableau. Lors du chargement de `n` éléments à partir d'une position arbitraire `m` dans un tableau de variables uniformes, les éléments `m + n - 1` du tableau seront remplacés par les nouvelles valeurs. Si `m + n - 1` est supérieur à la taille du tableau de variables uniformes, les valeurs de tous les éléments du tableau situés au-delà de la fin du tableau seront ignorées. Le nombre indiqué dans le nom de la commande correspond au nombre de composantes de chaque élément de la valeur et doit correspondre au nombre de composantes du type de données de la variable uniforme spécifiée (par exemple, 1 pour float, int, bool ; 2 pour vec2, ivec2, bvec2, etc.). Le type de données spécifié dans le nom de la commande doit correspondre à celui de la variable uniforme spécifiée, comme décrit précédemment pour glProgramUniform{1|2|3|4}{f|i|ui}.

Pour les tableaux de variables uniformes, chaque élément du tableau est considéré comme étant du type indiqué dans le nom de la commande (par exemple, glProgramUniform3f ou glProgramUniform3fv permettent de charger un tableau de variables uniformes de type vec3). Le nombre d'éléments du tableau de variables uniformes à modifier est spécifié par `count`.

Les commandes `glProgramUniformMatrix{2|3|4|2x3|3x2|2x4|4x2|3x4|4x3}fv` permettent de modifier une matrice ou un tableau de matrices. Les nombres dans le nom de la commande correspondent à la dimensionnalité de la matrice. Le nombre 2 indique une matrice 2 × 2 (soit 4 valeurs), le nombre 3 une matrice 3 × 3 (soit 9 valeurs) et le nombre 4 une matrice 4 × 4 (soit 16 valeurs). La dimensionnalité des matrices non carrées est explicite : le premier nombre représente le nombre de colonnes et le second le nombre de lignes. Par exemple, `2x4` indique une matrice 2 × 4 avec 2 colonnes et 4 lignes (soit 8 valeurs). Si la transposition est définie sur GL_FALSE, chaque matrice est supposée être fournie en ordre colonne. Si la transposition est définie sur GL_TRUE, chaque matrice est supposée être fournie en ordre ligne. L'argument «count» indique le nombre de matrices à transmettre. Utilisez la valeur 1 pour modifier la valeur d'une seule matrice et une valeur supérieure à 1 pour modifier un tableau de matrices.

Remarques

• Seules les fonctions `glProgramUniform1i` et `glProgramUniform1iv` permettent de charger des variables uniformes définies comme des types échantillonneurs. Le chargement d'échantillonneurs avec toute autre fonction générera une erreur `GL_INVALID_OPERATION`.
• Si `count` est supérieur à 1 et que la variable uniforme indiquée n'est pas un tableau, une erreur `GL_INVALID_OPERATION` est générée et la variable uniforme spécifiée reste inchangée.
• Hormis les exceptions précédentes, si le type et la taille de la variable uniforme définis dans le shader ne correspondent pas au type et à la taille spécifiés dans le nom de la commande utilisée pour charger sa valeur, une erreur `GL_INVALID_OPERATION` est générée et la variable uniforme spécifiée reste inchangée.

• Si `location` a une valeur différente de -1 et ne représente pas un emplacement valide pour une variable uniforme dans le programme, une erreur est générée et aucune modification n'est apportée à l'entreposage des variables uniformes du programme. Si `location` est égal à -1, les données transmises sont ignorées silencieusement et la variable uniforme spécifiée reste inchangée.

Erreurs

Requêtes associées

• glGetActiveUniform : avec le descripteur d'un objet programme et l'index d'une variable uniforme active.
• glGetUniform : avec le descripteur d'un objet programme et l'emplacement d'une variable uniforme.
• glGetUniformLocation : avec le descripteur d'un objet programme et le nom d'une variable uniforme.

Version supportée

Voir également

glLinkProgram, glUseProgram