Documentation de Gambas - /comp/gb.opengl.glsl/gl/getprogramiv

/comp/gb.opengl.glsl/gl/getprogramiv

# Gl.GetProgramiv (gb.opengl.glsl)

Static Function GetProgramiv ( Program As Integer, Pname As Integer ) As Integer[]

### Retourne un paramètre d’un object programme

#### Paramètres

- Program Spécifie l'objet programme à interroger.

- Pname Spécifie le paramètre de l’objet . Le noms symboliques acceptés sont Gl.GL_DELETE_STATUS, Gl.GL_LINK_STATUS, Gl.GL_VALIDATE_STATUS, Gl.GL_INFO_LOG_LENGTH, Gl.GL_ATTACHED_SHADERS, Gl.GL_ACTIVE_ATTRIBUTES, Gl.GL_ACTIVE_ATTRIBUTE_MAX_LENGTH, Gl.GL_ACTIVE_UNIFORMS, Gl.GL_ACTIVE_UNIFORM_MAX_LENGTH.

#### Description

Gl.GetProgramiv retourne dans un tableau d’entiers la valeur d’un paramètre pour un objet programme spécifique. Les paramètres suivants sont définis :

- Gl.GL_DELETE_STATUS retourne TRUE si Program est actuellement marqué pour suppression, et FALSE autrement.

- Gl.GL_LINK_STATUS retourne TRUE si la dernière opération de liaison de Program a réussi, et FALSE autrement.

- Gl.GL_VALIDATE_STATUS retourne TRUE si la dernière opération de validation de Program a réussi, et FALSE autrement.

- Gl.GL_INFO_LOG_LENGTH retourne le nombre de caractères dans le log d’information du Program incluant le caractère null de terminaison (c.a.d., la taille du tampon de caractères nécessaire pour accueillir le log d’information). Si Program n’a pas de log d’information, une valeur 0 est renvoyée.

- Gl.GL_ATTACHED_SHADERS retourne le nombre d’objets shader attachés à Program.

- Gl.GL_ACTIVE_ATTRIBUTES retourne le nombre de variables attribut actives pour Program.

- Gl.GL_ACTIVE_ATTRIBUTE_MAX_LENGTH retourne la longueur du plus grand nom d’attribut actif pour Program, caractère null de terminaison inclus. (c.a.d., la taille du tampon de caractères nécessaire pour accueillir le plus grand nom d’attribut). Renvoie 0 si aucun attribut actif n’existe.

- Gl.GL_ACTIVE_UNIFORMS retourne le nombre de variables uniform actives pour Program.

- Gl.GL_ACTIVE_UNIFORM_MAX_LENGTH retourne la longueur du plus grand nom de variable uniform active pour Program , caractère null de terminaison inclus. (c.a.d., la taille du tampon de caractères nécessaire pour accueillir le plus grand nom de variable uniform). Renvoie 0 s’il n’y a pas de variable uniform active.

Gl.GetProgramiv n’est disponible qu’à partir de la version 2.0 de GL.

#### Erreurs

- Gl.GL_INVALID_VALUE est générée si Program n’est pas une valeur générée par OpenGL.

- Gl.GL_INVALID_OPERATION est générée si Program ne se réfère pas à un objet programme .

- Gl.GL_INVALID_ENUM est générée si Pname n’est pas une valeur acceptée.

- Gl.GL_INVALID_OPERATION est générée si Gl.GetProgramiv est exécuté entre un appel à Gl.Begin et l’appel correspondant à Gl.End.

#### _ Gets Associés

- Gl.GetActiveAttrib avec l’argument program

- Gl.GetActiveUniform avec l’argument program

- Gl.GetAttachedShaders avec l’argument program

- Gl.GetProgramInfoLog avec l’argument program

- GL.IsProgram

### Voir aussi

- Gl.AttachShader,

- Gl.CreateProgram,

- Gl.DeleteProgram,

- Gl.GetShaderiv,

- Gl.LinkProgram,

- Gl.ValidateProgram