WebGLProgram

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Das WebGLProgram ist Teil der WebGL API und ist eine Kombination aus zwei kompilierten WebGLShader, bestehend aus einem Vertex-Shader und einem Fragment-Shader (beide in GLSL geschrieben).

Um ein WebGLProgram zu erstellen, rufen Sie die Funktion createProgram() des GL-Kontextes auf. Nachdem Sie die Shader-Programme mit attachShader() angehängt haben, verlinken Sie diese zu einem nutzbaren Programm. Dies wird im untenstehenden Code gezeigt.

const program = gl.createProgram();

// Attach pre-existing shaders
gl.attachShader(program, vertexShader);
gl.attachShader(program, fragmentShader);

gl.linkProgram(program);

if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
  const info = gl.getProgramInfoLog(program);
  throw new Error(`Could not compile WebGL program. \n\n${info}`);
}

Siehe WebGLShader für Informationen zur Erstellung des vertexShader und fragmentShader im obigen Beispiel.

Beispiele

Verwendung des Programms

Die Schritte, um mit dem Programm tatsächlich zu arbeiten, bestehen darin, der GPU mitzuteilen, das Programm zu verwenden, die entsprechenden Daten und Konfigurationsoptionen zu binden und schließlich etwas auf den Bildschirm zu zeichnen.

// Use the program
gl.useProgram(program);

// Bind existing attribute data
gl.bindBuffer(gl.ARRAY_BUFFER, buffer);
gl.enableVertexAttribArray(attributeLocation);
gl.vertexAttribPointer(attributeLocation, 3, gl.FLOAT, false, 0, 0);

// Draw a single triangle
gl.drawArrays(gl.TRIANGLES, 0, 3);

Löschen des Programms

Wenn beim Verlinken des Programms ein Fehler auftritt oder Sie ein bestehendes Programm löschen möchten, ist es so einfach, WebGLRenderingContext.deleteProgram() auszuführen. Dies gibt den Speicher des verlinkten Programms frei.

gl.deleteProgram(program);

Spezifikationen

Specification
WebGL Specification # 5.6