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

/comp/gb.opengl.glsl/gl/getshaderinfolog

# Gl.GetShaderInfoLog (gb.opengl.glsl)

Static Function GetShaderInfoLog ( Shader As Integer ) As String

Retourne le fichier log d’information pour un objet reflet (shader)

### Parameters

shader

  Spécifie l’objet reflet pour lequel le log d’information est demandé.

maxLength

  Spécifie la taille du tampon de caractères où stoker les informations du log retournées.

length

  Retourne la longueur de la chaîne envoyée dans infoLog (terminaison null non comprise).

infoLog

  Spécifie un tableau de caractères utilisé pour le retour des informations du log.

### Description

Gl.GetShaderInfoLog retourne le log d’information pour l’ objet reflet spécifié. Le log d’information pour un objet reflet objet est modifié quand le shader est compilé. La chaîne retournée sera terminée par null.

Gl.GetShaderInfoLog retourne dans infoLog autant d’ informations du log qu’il peut, jusq’au nombre maximum de caractères maxLength. Le nombre de caractères effectivement retournés, terminaison null non comprise, est specifiée par length. Si la longueur de la chaîne retournée n’est pas requise, une valeur NULL peut être passée à l’argument length. La taille du tampon nécessaire pour enregistrer le log d’information peut être obtenue par appel à Gl.GetShader avec la valeur Gl.INFO_LOG_LENGTH.

Le log d’information pour un objet reflet est une chaîne qui peut contenir des messages de diagnostic, des messages d’alarme, et d’autres informations concernant la dernière opération de compilation. Quand un objet shader est créé, son log d’information sera une chaîne de longueur 0.

### Notes

Le log d’information pour un objet reflet est le mécanisme principal de l’implémenteur OpenGL pour véhiculer les informations concernant le processus de compilation. De ce fait, le log d’information peut être d’un grand secours pour les développeurs d’application au cours du processus de développement , même lorsque la compilation a réussi. Les développeurs d’applications ne doivent pas s’attendre à ce que différentes implémentations OpenGL produisent des log d’information identiques.}

### Erreurs

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

Gl.INVALID_OPERATION est provoqué si Shader n’est pas un objet shader.

Gl.INVALID_VALUE est provoqué si maxLength est < 0.

### Gets Associés

Gl.GetShaderiv avec l’argument Gl.GL_INFO_LOG_LENGTH

Gl.IsShader

### Voir aussi

- Gl.CompileShader,

- Gl.GetProgramInfoLog,

- Gl.LinkProgram,

- Gl.ValidateProgram

Voir documentation originale sur le site OpenGL