QGLShaderProgram Class

QGLShader shader(QGLShader::Vertex);
shader.compileSourceCode(code);

QGLShaderProgram program(context);
program.addShader(shader);
program.link();

program.bind();

#define highp
#define mediump
#define lowp

program.addShaderFromSourceCode(QGLShader::Vertex,
    "attribute highp vec4 vertex;\n"
    "uniform highp mat4 matrix;\n"
    "void main(void)\n"
    "{\n"
    "   gl_Position = matrix * vertex;\n"
    "}");
program.addShaderFromSourceCode(QGLShader::Fragment,
    "uniform mediump vec4 color;\n"
    "void main(void)\n"
    "{\n"
    "   gl_FragColor = color;\n"
    "}");
program.link();
program.bind();

int vertexLocation = program.attributeLocation("vertex");
int matrixLocation = program.uniformLocation("matrix");
int colorLocation = program.uniformLocation("color");

static GLfloat const triangleVertices[] = {
    60.0f,  10.0f,  0.0f,
    110.0f, 110.0f, 0.0f,
    10.0f,  110.0f, 0.0f
};

QColor color(0, 255, 0, 255);

QMatrix4x4 pmvMatrix;
pmvMatrix.ortho(rect());

program.enableAttributeArray(vertexLocation);
program.setAttributeArray(vertexLocation, triangleVertices, 3);
program.setUniformValue(matrixLocation, pmvMatrix);
program.setUniformValue(colorLocation, color);

glDrawArrays(GL_TRIANGLES, 0, 3);

program.disableAttributeArray(vertexLocation);

Member Function Documentation

QGLShaderProgram::QGLShaderProgram(QObject *parent = nullptr)

Constructs a new shader program and attaches it to parent. The program will be invalid until addShader() is called.

The shader program will be associated with the current QGLContext.

See also addShader().

QGLShaderProgram::QGLShaderProgram(const QGLContext *context, QObject *parent = nullptr)

Constructs a new shader program and attaches it to parent. The program will be invalid until addShader() is called.

The shader program will be associated with context.

See also addShader().

[virtual] QGLShaderProgram::~QGLShaderProgram()

Deletes this shader program.

bool QGLShaderProgram::addShader(QGLShader *shader)

Adds a compiled shader to this shader program. Returns true if the shader could be added, or false otherwise.

Ownership of the shader object remains with the caller. It will not be deleted when this QGLShaderProgram instance is deleted. This allows the caller to add the same shader to multiple shader programs.

See also addShaderFromSourceCode(), addShaderFromSourceFile(), removeShader(), link(), and removeAllShaders().

bool QGLShaderProgram::addShaderFromSourceCode(QGLShader::ShaderType type, const char *source)

Compiles source as a shader of the specified type and adds it to this shader program. Returns true if compilation was successful, false otherwise. The compilation errors and warnings will be made available via log().

This function is intended to be a short-cut for quickly adding vertex and fragment shaders to a shader program without creating an instance of QGLShader first.

See also addShader(), addShaderFromSourceFile(), removeShader(), link(), log(), and removeAllShaders().

bool QGLShaderProgram::addShaderFromSourceCode(QGLShader::ShaderType type, const QByteArray &source)

This is an overloaded function.

Compiles source as a shader of the specified type and adds it to this shader program. Returns true if compilation was successful, false otherwise. The compilation errors and warnings will be made available via log().

This function is intended to be a short-cut for quickly adding vertex and fragment shaders to a shader program without creating an instance of QGLShader first.

See also addShader(), addShaderFromSourceFile(), removeShader(), link(), log(), and removeAllShaders().

bool QGLShaderProgram::addShaderFromSourceCode(QGLShader::ShaderType type, const QString &source)

This is an overloaded function.

Compiles source as a shader of the specified type and adds it to this shader program. Returns true if compilation was successful, false otherwise. The compilation errors and warnings will be made available via log().

This function is intended to be a short-cut for quickly adding vertex and fragment shaders to a shader program without creating an instance of QGLShader first.

See also addShader(), addShaderFromSourceFile(), removeShader(), link(), log(), and removeAllShaders().

bool QGLShaderProgram::addShaderFromSourceFile(QGLShader::ShaderType type, const QString &fileName)

Compiles the contents of fileName as a shader of the specified type and adds it to this shader program. Returns true if compilation was successful, false otherwise. The compilation errors and warnings will be made available via log().

This function is intended to be a short-cut for quickly adding vertex and fragment shaders to a shader program without creating an instance of QGLShader first.

See also addShader() and addShaderFromSourceCode().

int QGLShaderProgram::attributeLocation(const char *name) const

Returns the location of the attribute name within this shader program's parameter list. Returns -1 if name is not a valid attribute for this shader program.

See also uniformLocation() and bindAttributeLocation().

int QGLShaderProgram::attributeLocation(const QByteArray &name) const

This is an overloaded function.

Returns the location of the attribute name within this shader program's parameter list. Returns -1 if name is not a valid attribute for this shader program.

See also uniformLocation() and bindAttributeLocation().

int QGLShaderProgram::attributeLocation(const QString &name) const

This is an overloaded function.

Returns the location of the attribute name within this shader program's parameter list. Returns -1 if name is not a valid attribute for this shader program.

See also uniformLocation() and bindAttributeLocation().

bool QGLShaderProgram::bind()

Binds this shader program to the active QGLContext and makes it the current shader program. Any previously bound shader program is released. This is equivalent to calling glUseProgram() on programId(). Returns true if the program was successfully bound; false otherwise. If the shader program has not yet been linked, or it needs to be re-linked, this function will call link().

See also link() and release().

void QGLShaderProgram::bindAttributeLocation(const char *name, int location)

Binds the attribute name to the specified location. This function can be called before or after the program has been linked. Any attributes that have not been explicitly bound when the program is linked will be assigned locations automatically.

When this function is called after the program has been linked, the program will need to be relinked for the change to take effect.

See also attributeLocation().

void QGLShaderProgram::bindAttributeLocation(const QByteArray &name, int location)

This is an overloaded function.

Binds the attribute name to the specified location. This function can be called before or after the program has been linked. Any attributes that have not been explicitly bound when the program is linked will be assigned locations automatically.

When this function is called after the program has been linked, the program will need to be relinked for the change to take effect.

See also attributeLocation().

void QGLShaderProgram::bindAttributeLocation(const QString &name, int location)

This is an overloaded function.

Binds the attribute name to the specified location. This function can be called before or after the program has been linked. Any attributes that have not been explicitly bound when the program is linked will be assigned locations automatically.

When this function is called after the program has been linked, the program will need to be relinked for the change to take effect.

See also attributeLocation().

void QGLShaderProgram::disableAttributeArray(int location)

Disables the vertex array at location in this shader program that was enabled by a previous call to enableAttributeArray().

See also enableAttributeArray(), setAttributeArray(), setAttributeValue(), and setUniformValue().

void QGLShaderProgram::disableAttributeArray(const char *name)

This is an overloaded function.

Disables the vertex array called name in this shader program that was enabled by a previous call to enableAttributeArray().

See also enableAttributeArray(), setAttributeArray(), setAttributeValue(), and setUniformValue().

void QGLShaderProgram::enableAttributeArray(int location)

Enables the vertex array at location in this shader program so that the value set by setAttributeArray() on location will be used by the shader program.

See also disableAttributeArray(), setAttributeArray(), setAttributeValue(), and setUniformValue().

void QGLShaderProgram::enableAttributeArray(const char *name)

This is an overloaded function.

Enables the vertex array called name in this shader program so that the value set by setAttributeArray() on name will be used by the shader program.

See also disableAttributeArray(), setAttributeArray(), setAttributeValue(), and setUniformValue().

GLenum QGLShaderProgram::geometryInputType() const

Returns the geometry shader input type, if active.

This parameter takes effect the next time the program is linked.

This function was introduced in Qt 4.7.

See also setGeometryInputType().

GLenum QGLShaderProgram::geometryOutputType() const

Returns the geometry shader output type, if active.

This parameter takes effect the next time the program is linked.

This function was introduced in Qt 4.7.

See also setGeometryOutputType().

int QGLShaderProgram::geometryOutputVertexCount() const

Returns the maximum number of vertices the current geometry shader program will produce, if active.

This parameter takes effect the ntext time the program is linked.

This function was introduced in Qt 4.7.

See also setGeometryOutputVertexCount().

[static] bool QGLShaderProgram::hasOpenGLShaderPrograms(const QGLContext *context = nullptr)

Returns true if shader programs written in the OpenGL Shading Language (GLSL) are supported on this system; false otherwise.

The context is used to resolve the GLSL extensions. If context is null, then QGLContext::currentContext() is used.

bool QGLShaderProgram::isLinked() const

Returns true if this shader program has been linked; false otherwise.

See also link().

[virtual] bool QGLShaderProgram::link()

Links together the shaders that were added to this program with addShader(). Returns true if the link was successful or false otherwise. If the link failed, the error messages can be retrieved with log().

Subclasses can override this function to initialize attributes and uniform variables for use in specific shader programs.

If the shader program was already linked, calling this function again will force it to be re-linked.

See also addShader() and log().

QString QGLShaderProgram::log() const

Returns the errors and warnings that occurred during the last link() or addShader() with explicitly specified source code.

See also link().

int QGLShaderProgram::maxGeometryOutputVertices() const

Returns the hardware limit for how many vertices a geometry shader can output.

This function was introduced in Qt 4.7.

See also setGeometryOutputVertexCount().

GLuint QGLShaderProgram::programId() const

Returns the OpenGL identifier associated with this shader program.

See also QGLShader::shaderId().

void QGLShaderProgram::release()

Releases the active shader program from the current QGLContext. This is equivalent to calling glUseProgram(0).

See also bind().

void QGLShaderProgram::removeAllShaders()

Removes all of the shaders that were added to this program previously. The QGLShader objects for the shaders will not be deleted if they were constructed externally. QGLShader objects that are constructed internally by QGLShaderProgram will be deleted.

See also addShader() and removeShader().

void QGLShaderProgram::removeShader(QGLShader *shader)

Removes shader from this shader program. The object is not deleted.

The shader program must be valid in the current QGLContext.

See also addShader(), link(), and removeAllShaders().

void QGLShaderProgram::setAttributeArray(int location, const GLfloat *values, int tupleSize, int stride = 0)

Sets an array of vertex values on the attribute at location in this shader program. The tupleSize indicates the number of components per vertex (1, 2, 3, or 4), and the stride indicates the number of bytes between vertices. A default stride value of zero indicates that the vertices are densely packed in values.

The array will become active when enableAttributeArray() is called on the location. Otherwise the value specified with setAttributeValue() for location will be used.

See also setAttributeValue(), setUniformValue(), enableAttributeArray(), and disableAttributeArray().

void QGLShaderProgram::setAttributeArray(int location, const QVector2D *values, int stride = 0)

Sets an array of 2D vertex values on the attribute at location in this shader program. The stride indicates the number of bytes between vertices. A default stride value of zero indicates that the vertices are densely packed in values.

The array will become active when enableAttributeArray() is called on the location. Otherwise the value specified with setAttributeValue() for location will be used.

See also setAttributeValue(), setUniformValue(), enableAttributeArray(), and disableAttributeArray().

void QGLShaderProgram::setAttributeArray(int location, const QVector3D *values, int stride = 0)

Sets an array of 3D vertex values on the attribute at location in this shader program. The stride indicates the number of bytes between vertices. A default stride value of zero indicates that the vertices are densely packed in values.

The array will become active when enableAttributeArray() is called on the location. Otherwise the value specified with setAttributeValue() for location will be used.

See also setAttributeValue(), setUniformValue(), enableAttributeArray(), and disableAttributeArray().

void QGLShaderProgram::setAttributeArray(int location, const QVector4D *values, int stride = 0)

Sets an array of 4D vertex values on the attribute at location in this shader program. The stride indicates the number of bytes between vertices. A default stride value of zero indicates that the vertices are densely packed in values.

The array will become active when enableAttributeArray() is called on the location. Otherwise the value specified with setAttributeValue() for location will be used.

See also setAttributeValue(), setUniformValue(), enableAttributeArray(), and disableAttributeArray().

void QGLShaderProgram::setAttributeArray(int location, GLenum type, const void *values, int tupleSize, int stride = 0)

Sets an array of vertex values on the attribute at location in this shader program. The stride indicates the number of bytes between vertices. A default stride value of zero indicates that the vertices are densely packed in values.

The type indicates the type of elements in the values array, usually GL_FLOAT, GL_UNSIGNED_BYTE, etc. The tupleSize indicates the number of components per vertex: 1, 2, 3, or 4.

The array will become active when enableAttributeArray() is called on the location. Otherwise the value specified with setAttributeValue() for location will be used.

The setAttributeBuffer() function can be used to set the attribute array to an offset within a vertex buffer.

Note: Normalization will be enabled. If this is not desired, call glVertexAttribPointer directly through QGLFunctions.

This function was introduced in Qt 4.7.

See also setAttributeValue(), setUniformValue(), enableAttributeArray(), disableAttributeArray(), and setAttributeBuffer().

void QGLShaderProgram::setAttributeArray(const char *name, const GLfloat *values, int tupleSize, int stride = 0)

This is an overloaded function.

Sets an array of vertex values on the attribute called name in this shader program. The tupleSize indicates the number of components per vertex (1, 2, 3, or 4), and the stride indicates the number of bytes between vertices. A default stride value of zero indicates that the vertices are densely packed in values.

The array will become active when enableAttributeArray() is called on name. Otherwise the value specified with setAttributeValue() for name will be used.

See also setAttributeValue(), setUniformValue(), enableAttributeArray(), and disableAttributeArray().

void QGLShaderProgram::setAttributeArray(const char *name, const QVector2D *values, int stride = 0)

This is an overloaded function.

Sets an array of 2D vertex values on the attribute called name in this shader program. The stride indicates the number of bytes between vertices. A default stride value of zero indicates that the vertices are densely packed in values.

The array will become active when enableAttributeArray() is called on name. Otherwise the value specified with setAttributeValue() for name will be used.

See also setAttributeValue(), setUniformValue(), enableAttributeArray(), and disableAttributeArray().

void QGLShaderProgram::setAttributeArray(const char *name, const QVector3D *values, int stride = 0)

This is an overloaded function.

Sets an array of 3D vertex values on the attribute called name in this shader program. The stride indicates the number of bytes between vertices. A default stride value of zero indicates that the vertices are densely packed in values.

The array will become active when enableAttributeArray() is called on name. Otherwise the value specified with setAttributeValue() for name will be used.

See also setAttributeValue(), setUniformValue(), enableAttributeArray(), and disableAttributeArray().

void QGLShaderProgram::setAttributeArray(const char *name, const QVector4D *values, int stride = 0)

This is an overloaded function.

Sets an array of 4D vertex values on the attribute called name in this shader program. The stride indicates the number of bytes between vertices. A default stride value of zero indicates that the vertices are densely packed in values.

The array will become active when enableAttributeArray() is called on name. Otherwise the value specified with setAttributeValue() for name will be used.

See also setAttributeValue(), setUniformValue(), enableAttributeArray(), and disableAttributeArray().

void QGLShaderProgram::setAttributeArray(const char *name, GLenum type, const void *values, int tupleSize, int stride = 0)

This is an overloaded function.

Sets an array of vertex values on the attribute called name in this shader program. The stride indicates the number of bytes between vertices. A default stride value of zero indicates that the vertices are densely packed in values.

The type indicates the type of elements in the values array, usually GL_FLOAT, GL_UNSIGNED_BYTE, etc. The tupleSize indicates the number of components per vertex: 1, 2, 3, or 4.

The array will become active when enableAttributeArray() is called on the name. Otherwise the value specified with setAttributeValue() for name will be used.

The setAttributeBuffer() function can be used to set the attribute array to an offset within a vertex buffer.

This function was introduced in Qt 4.7.

See also setAttributeValue(), setUniformValue(), enableAttributeArray(), disableAttributeArray(), and setAttributeBuffer().

void QGLShaderProgram::setAttributeBuffer(int location, GLenum type, int offset, int tupleSize, int stride = 0)

Sets an array of vertex values on the attribute at location in this shader program, starting at a specific offset in the currently bound vertex buffer. The stride indicates the number of bytes between vertices. A default stride value of zero indicates that the vertices are densely packed in the value array.

The type indicates the type of elements in the vertex value array, usually GL_FLOAT, GL_UNSIGNED_BYTE, etc. The tupleSize indicates the number of components per vertex: 1, 2, 3, or 4.

The array will become active when enableAttributeArray() is called on the location. Otherwise the value specified with setAttributeValue() for location will be used.

Note: Normalization will be enabled. If this is not desired, call glVertexAttribPointer directly though QGLFunctions.

This function was introduced in Qt 4.7.

See also setAttributeArray().

void QGLShaderProgram::setAttributeBuffer(const char *name, GLenum type, int offset, int tupleSize, int stride = 0)

This is an overloaded function.

Sets an array of vertex values on the attribute called name in this shader program, starting at a specific offset in the currently bound vertex buffer. The stride indicates the number of bytes between vertices. A default stride value of zero indicates that the vertices are densely packed in the value array.

The type indicates the type of elements in the vertex value array, usually GL_FLOAT, GL_UNSIGNED_BYTE, etc. The tupleSize indicates the number of components per vertex: 1, 2, 3, or 4.

The array will become active when enableAttributeArray() is called on the name. Otherwise the value specified with setAttributeValue() for name will be used.

This function was introduced in Qt 4.7.

See also setAttributeArray().

void QGLShaderProgram::setAttributeValue(int location, GLfloat value)

Sets the attribute at location in the current context to value.

See also setUniformValue().

void QGLShaderProgram::setAttributeValue(int location, GLfloat x, GLfloat y)

Sets the attribute at location in the current context to the 2D vector (x, y).

See also setUniformValue().

void QGLShaderProgram::setAttributeValue(int location, GLfloat x, GLfloat y, GLfloat z)

Sets the attribute at location in the current context to the 3D vector (x, y, z).

See also setUniformValue().

void QGLShaderProgram::setAttributeValue(int location, GLfloat x, GLfloat y, GLfloat z, GLfloat w)

Sets the attribute at location in the current context to the 4D vector (x, y, z, w).

See also setUniformValue().

void QGLShaderProgram::setAttributeValue(int location, const QVector2D &value)

Sets the attribute at location in the current context to value.

See also setUniformValue().

void QGLShaderProgram::setAttributeValue(int location, const QVector3D &value)

Sets the attribute at location in the current context to value.

See also setUniformValue().

void QGLShaderProgram::setAttributeValue(int location, const QVector4D &value)

Sets the attribute at location in the current context to value.

See also setUniformValue().

void QGLShaderProgram::setAttributeValue(int location, const QColor &value)

Sets the attribute at location in the current context to value.

See also setUniformValue().

void QGLShaderProgram::setAttributeValue(int location, const GLfloat *values, int columns, int rows)

Sets the attribute at location in the current context to the contents of values, which contains columns elements, each consisting of rows elements. The rows value should be 1, 2, 3, or 4. This function is typically used to set matrix values and column vectors.

See also setUniformValue().

void QGLShaderProgram::setAttributeValue(const char *name, GLfloat value)

This is an overloaded function.

Sets the attribute called name in the current context to value.

See also setUniformValue().

void QGLShaderProgram::setAttributeValue(const char *name, GLfloat x, GLfloat y)

This is an overloaded function.

Sets the attribute called name in the current context to the 2D vector (x, y).

See also setUniformValue().

void QGLShaderProgram::setAttributeValue(const char *name, GLfloat x, GLfloat y, GLfloat z)

This is an overloaded function.

Sets the attribute called name in the current context to the 3D vector (x, y, z).

See also setUniformValue().

void QGLShaderProgram::setAttributeValue(const char *name, GLfloat x, GLfloat y, GLfloat z, GLfloat w)

This is an overloaded function.

Sets the attribute called name in the current context to the 4D vector (x, y, z, w).

See also setUniformValue().

void QGLShaderProgram::setAttributeValue(const char *name, const QVector2D &value)

This is an overloaded function.

Sets the attribute called name in the current context to value.

See also setUniformValue().

void QGLShaderProgram::setAttributeValue(const char *name, const QVector3D &value)

This is an overloaded function.

Sets the attribute called name in the current context to value.

See also setUniformValue().

void QGLShaderProgram::setAttributeValue(const char *name, const QVector4D &value)

This is an overloaded function.

Sets the attribute called name in the current context to value.

See also setUniformValue().

void QGLShaderProgram::setAttributeValue(const char *name, const QColor &value)

This is an overloaded function.

Sets the attribute called name in the current context to value.

See also setUniformValue().

void QGLShaderProgram::setAttributeValue(const char *name, const GLfloat *values, int columns, int rows)

This is an overloaded function.

Sets the attribute called name in the current context to the contents of values, which contains columns elements, each consisting of rows elements. The rows value should be 1, 2, 3, or 4. This function is typically used to set matrix values and column vectors.

See also setUniformValue().

void QGLShaderProgram::setGeometryInputType(GLenum inputType)

Sets the input type from inputType.

This parameter takes effect the next time the program is linked.

See also geometryInputType().

void QGLShaderProgram::setGeometryOutputType(GLenum outputType)

Sets the output type from the geometry shader, if active, to outputType.

This parameter takes effect the next time the program is linked.

This function was introduced in Qt 4.7.

See also geometryOutputType().

void QGLShaderProgram::setGeometryOutputVertexCount(int count)

Sets the maximum number of vertices the current geometry shader program will produce, if active, to count.

This parameter takes effect the next time the program is linked.

This function was introduced in Qt 4.7.

See also geometryOutputVertexCount().

void QGLShaderProgram::setUniformValue(int location, GLfloat value)

Sets the uniform variable at location in the current context to value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, GLint value)

Sets the uniform variable at location in the current context to value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, const QColor &color)

This is an overloaded function.

Sets the uniform variable called name in the current context to the red, green, blue, and alpha components of color.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, const QPoint &point)

This is an overloaded function.

Sets the uniform variable associated with name in the current context to the x and y coordinates of point.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, const QPointF &point)

This is an overloaded function.

Sets the uniform variable associated with name in the current context to the x and y coordinates of point.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, const QSize &size)

This is an overloaded function.

Sets the uniform variable associated with name in the current context to the width and height of the given size.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, const QSizeF &size)

This is an overloaded function.

Sets the uniform variable associated with name in the current context to the width and height of the given size.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, const QMatrix2x2 &value)

This is an overloaded function.

Sets the uniform variable called name in the current context to a 2x2 matrix value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, const QMatrix2x3 &value)

This is an overloaded function.

Sets the uniform variable called name in the current context to a 2x3 matrix value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, const QMatrix2x4 &value)

This is an overloaded function.

Sets the uniform variable called name in the current context to a 2x4 matrix value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, const QMatrix3x2 &value)

This is an overloaded function.

Sets the uniform variable called name in the current context to a 3x2 matrix value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, const QMatrix3x3 &value)

This is an overloaded function.

Sets the uniform variable called name in the current context to a 3x3 matrix value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, const QMatrix3x4 &value)

This is an overloaded function.

Sets the uniform variable called name in the current context to a 3x4 matrix value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, const QMatrix4x2 &value)

This is an overloaded function.

Sets the uniform variable called name in the current context to a 4x2 matrix value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, const QMatrix4x3 &value)

This is an overloaded function.

Sets the uniform variable called name in the current context to a 4x3 matrix value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, const QMatrix4x4 &value)

This is an overloaded function.

Sets the uniform variable called name in the current context to a 4x4 matrix value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, const GLfloat [2][2] value = 2)

This is an overloaded function.

Sets the uniform variable called name in the current context to a 2x2 matrix value. The matrix elements must be specified in column-major order.

This function was introduced in Qt 4.7.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, const GLfloat [3][3] value = 3)

This is an overloaded function.

Sets the uniform variable called name in the current context to a 3x3 matrix value. The matrix elements must be specified in column-major order.

This function was introduced in Qt 4.7.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, const GLfloat [4][4] value = 4)

This is an overloaded function.

Sets the uniform variable called name in the current context to a 4x4 matrix value. The matrix elements must be specified in column-major order.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, const QTransform &value)

This is an overloaded function.

Sets the uniform variable called name in the current context to a 3x3 transformation matrix value that is specified as a QTransform value.

To set a QTransform value as a 4x4 matrix in a shader, use setUniformValue(name, QMatrix4x4(value)).

void QGLShaderProgram::setUniformValue(int location, GLuint value)

Sets the uniform variable at location in the current context to value. This function should be used when setting sampler values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, GLfloat x, GLfloat y)

Sets the uniform variable at location in the current context to the 2D vector (x, y).

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, GLfloat x, GLfloat y, GLfloat z)

Sets the uniform variable at location in the current context to the 3D vector (x, y, z).

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, GLfloat x, GLfloat y, GLfloat z, GLfloat w)

Sets the uniform variable at location in the current context to the 4D vector (x, y, z, w).

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, const QVector2D &value)

Sets the uniform variable at location in the current context to value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, const QVector3D &value)

Sets the uniform variable at location in the current context to value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, const QVector4D &value)

Sets the uniform variable at location in the current context to value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, const QColor &color)

Sets the uniform variable at location in the current context to the red, green, blue, and alpha components of color.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, const QPoint &point)

Sets the uniform variable at location in the current context to the x and y coordinates of point.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, const QPointF &point)

Sets the uniform variable at location in the current context to the x and y coordinates of point.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, const QSize &size)

Sets the uniform variable at location in the current context to the width and height of the given size.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, const QSizeF &size)

Sets the uniform variable at location in the current context to the width and height of the given size.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, const QMatrix2x2 &value)

Sets the uniform variable at location in the current context to a 2x2 matrix value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, const QMatrix2x3 &value)

Sets the uniform variable at location in the current context to a 2x3 matrix value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, const QMatrix2x4 &value)

Sets the uniform variable at location in the current context to a 2x4 matrix value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, const QMatrix3x2 &value)

Sets the uniform variable at location in the current context to a 3x2 matrix value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, const QMatrix3x3 &value)

Sets the uniform variable at location in the current context to a 3x3 matrix value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, const QMatrix3x4 &value)

Sets the uniform variable at location in the current context to a 3x4 matrix value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, const QMatrix4x2 &value)

Sets the uniform variable at location in the current context to a 4x2 matrix value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, const QMatrix4x3 &value)

Sets the uniform variable at location in the current context to a 4x3 matrix value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, const QMatrix4x4 &value)

Sets the uniform variable at location in the current context to a 4x4 matrix value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, const GLfloat [2][2] value = 2)

This is an overloaded function.

Sets the uniform variable at location in the current context to a 2x2 matrix value. The matrix elements must be specified in column-major order.

This function was introduced in Qt 4.7.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, const GLfloat [3][3] value = 3)

This is an overloaded function.

Sets the uniform variable at location in the current context to a 3x3 matrix value. The matrix elements must be specified in column-major order.

This function was introduced in Qt 4.7.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, const GLfloat [4][4] value = 4)

This is an overloaded function.

Sets the uniform variable at location in the current context to a 4x4 matrix value. The matrix elements must be specified in column-major order.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(int location, const QTransform &value)

Sets the uniform variable at location in the current context to a 3x3 transformation matrix value that is specified as a QTransform value.

To set a QTransform value as a 4x4 matrix in a shader, use setUniformValue(location, QMatrix4x4(value)).

void QGLShaderProgram::setUniformValue(const char *name, GLfloat value)

This is an overloaded function.

Sets the uniform variable called name in the current context to value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, GLint value)

This is an overloaded function.

Sets the uniform variable called name in the current context to value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, GLuint value)

This is an overloaded function.

Sets the uniform variable called name in the current context to value. This function should be used when setting sampler values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, GLfloat x, GLfloat y)

This is an overloaded function.

Sets the uniform variable called name in the current context to the 2D vector (x, y).

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, GLfloat x, GLfloat y, GLfloat z)

This is an overloaded function.

Sets the uniform variable called name in the current context to the 3D vector (x, y, z).

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, GLfloat x, GLfloat y, GLfloat z, GLfloat w)

This is an overloaded function.

Sets the uniform variable called name in the current context to the 4D vector (x, y, z, w).

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, const QVector2D &value)

This is an overloaded function.

Sets the uniform variable called name in the current context to value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, const QVector3D &value)

This is an overloaded function.

Sets the uniform variable called name in the current context to value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValue(const char *name, const QVector4D &value)

This is an overloaded function.

Sets the uniform variable called name in the current context to value.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(int location, const GLfloat *values, int count, int tupleSize)

Sets the uniform variable array at location in the current context to the count elements of values. Each element has tupleSize components. The tupleSize must be 1, 2, 3, or 4.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(int location, const GLint *values, int count)

Sets the uniform variable array at location in the current context to the count elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(int location, const GLuint *values, int count)

Sets the uniform variable array at location in the current context to the count elements of values. This overload should be used when setting an array of sampler values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(int location, const QVector2D *values, int count)

Sets the uniform variable array at location in the current context to the count 2D vector elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(int location, const QVector3D *values, int count)

Sets the uniform variable array at location in the current context to the count 3D vector elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(int location, const QVector4D *values, int count)

Sets the uniform variable array at location in the current context to the count 4D vector elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(int location, const QMatrix2x2 *values, int count)

Sets the uniform variable array at location in the current context to the count 2x2 matrix elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(int location, const QMatrix2x3 *values, int count)

Sets the uniform variable array at location in the current context to the count 2x3 matrix elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(int location, const QMatrix2x4 *values, int count)

Sets the uniform variable array at location in the current context to the count 2x4 matrix elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(int location, const QMatrix3x2 *values, int count)

Sets the uniform variable array at location in the current context to the count 3x2 matrix elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(int location, const QMatrix3x3 *values, int count)

Sets the uniform variable array at location in the current context to the count 3x3 matrix elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(int location, const QMatrix3x4 *values, int count)

Sets the uniform variable array at location in the current context to the count 3x4 matrix elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(int location, const QMatrix4x2 *values, int count)

Sets the uniform variable array at location in the current context to the count 4x2 matrix elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(int location, const QMatrix4x3 *values, int count)

Sets the uniform variable array at location in the current context to the count 4x3 matrix elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(int location, const QMatrix4x4 *values, int count)

Sets the uniform variable array at location in the current context to the count 4x4 matrix elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(const char *name, const GLfloat *values, int count, int tupleSize)

This is an overloaded function.

Sets the uniform variable array called name in the current context to the count elements of values. Each element has tupleSize components. The tupleSize must be 1, 2, 3, or 4.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(const char *name, const GLint *values, int count)

This is an overloaded function.

Sets the uniform variable array called name in the current context to the count elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(const char *name, const GLuint *values, int count)

This is an overloaded function.

Sets the uniform variable array called name in the current context to the count elements of values. This overload should be used when setting an array of sampler values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(const char *name, const QVector2D *values, int count)

This is an overloaded function.

Sets the uniform variable array called name in the current context to the count 2D vector elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(const char *name, const QVector3D *values, int count)

This is an overloaded function.

Sets the uniform variable array called name in the current context to the count 3D vector elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(const char *name, const QVector4D *values, int count)

This is an overloaded function.

Sets the uniform variable array called name in the current context to the count 4D vector elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(const char *name, const QMatrix2x2 *values, int count)

This is an overloaded function.

Sets the uniform variable array called name in the current context to the count 2x2 matrix elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(const char *name, const QMatrix2x3 *values, int count)

This is an overloaded function.

Sets the uniform variable array called name in the current context to the count 2x3 matrix elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(const char *name, const QMatrix2x4 *values, int count)

This is an overloaded function.

Sets the uniform variable array called name in the current context to the count 2x4 matrix elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(const char *name, const QMatrix3x2 *values, int count)

This is an overloaded function.

Sets the uniform variable array called name in the current context to the count 3x2 matrix elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(const char *name, const QMatrix3x3 *values, int count)

This is an overloaded function.

Sets the uniform variable array called name in the current context to the count 3x3 matrix elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(const char *name, const QMatrix3x4 *values, int count)

This is an overloaded function.

Sets the uniform variable array called name in the current context to the count 3x4 matrix elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(const char *name, const QMatrix4x2 *values, int count)

This is an overloaded function.

Sets the uniform variable array called name in the current context to the count 4x2 matrix elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(const char *name, const QMatrix4x3 *values, int count)

This is an overloaded function.

Sets the uniform variable array called name in the current context to the count 4x3 matrix elements of values.

See also setAttributeValue().

void QGLShaderProgram::setUniformValueArray(const char *name, const QMatrix4x4 *values, int count)

This is an overloaded function.

Sets the uniform variable array called name in the current context to the count 4x4 matrix elements of values.

See also setAttributeValue().

QList<QGLShader *> QGLShaderProgram::shaders() const

Returns a list of all shaders that have been added to this shader program using addShader().

See also addShader() and removeShader().

int QGLShaderProgram::uniformLocation(const char *name) const

Returns the location of the uniform variable name within this shader program's parameter list. Returns -1 if name is not a valid uniform variable for this shader program.

See also attributeLocation().

int QGLShaderProgram::uniformLocation(const QByteArray &name) const

This is an overloaded function.

Returns the location of the uniform variable name within this shader program's parameter list. Returns -1 if name is not a valid uniform variable for this shader program.

See also attributeLocation().

int QGLShaderProgram::uniformLocation(const QString &name) const

This is an overloaded function.

Returns the location of the uniform variable name within this shader program's parameter list. Returns -1 if name is not a valid uniform variable for this shader program.

See also attributeLocation().