QGLShaderProgram

Note

This class was introduced in Qt 4.6

Synopsis

Functions

Virtual functions

Slots

Static functions

Detailed Description

The PySide.QtOpenGL.QGLShaderProgram class allows OpenGL shader programs to be linked and used.

Introduction

This class supports shader programs written in the OpenGL Shading Language (GLSL) and in the OpenGL/ES Shading Language (GLSL/ES).

PySide.QtOpenGL.QGLShader and PySide.QtOpenGL.QGLShaderProgram shelter the programmer from the details of compiling and linking vertex and fragment shaders.

The following example creates a vertex shader program using the supplied source code . Once compiled and linked, the shader program is activated in the current PySide.QtOpenGL.QGLContext by calling QGLShaderProgram.bind() :

shader = QGLShader(QGLShader.Vertex)
shader.compileSourceCode(code)

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

program.bind()

Writing portable shaders

Shader programs can be difficult to reuse across OpenGL implementations because of varying levels of support for standard vertex attributes and uniform variables. In particular, GLSL/ES lacks all of the standard variables that are present on desktop OpenGL systems: gl_Vertex , gl_Normal , gl_Color , and so on. Desktop OpenGL lacks the variable qualifiers highp , mediump , and lowp .

The PySide.QtOpenGL.QGLShaderProgram class makes the process of writing portable shaders easier by prefixing all shader programs with the following lines on desktop OpenGL:

#define highp
#define mediump
#define lowp

This makes it possible to run most GLSL/ES shader programs on desktop systems. The programmer should restrict themselves to just features that are present in GLSL/ES, and avoid standard variable names that only work on the desktop.

Simple shader example

program.addShaderFromSourceCode(QGLShader.Vertex,
    "attribute highp vec4 vertex\n" \
    "attribute mediump 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()

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

With the above shader program active, we can draw a green triangle as follows:

triangleVertices = (
    60.0f,  10.0f,  0.0f,
    110.0f, 110.0f, 0.0f,
    10.0f,  110.0f, 0.0f)

color = QColor(0, 255, 0, 255)

pmvMatrix = QMatrix4x4()
pmvMatrix.ortho(self.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)

Binary shaders and programs

Binary shaders may be specified using glShaderBinary() on the return value from QGLShader.shaderId() . The PySide.QtOpenGL.QGLShader instance containing the binary can then be added to the shader program with PySide.QtOpenGL.QGLShaderProgram.addShader() and linked in the usual fashion with PySide.QtOpenGL.QGLShaderProgram.link() .

Binary programs may be specified using glProgramBinaryOES() on the return value from PySide.QtOpenGL.QGLShaderProgram.programId() . Then the application should call PySide.QtOpenGL.QGLShaderProgram.link() , which will notice that the program has already been specified and linked, allowing other operations to be performed on the shader program.

class PySide.QtOpenGL.QGLShaderProgram([parent=None])
class PySide.QtOpenGL.QGLShaderProgram(context[, parent=None])
Parameters:

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

The shader program will be associated with the current PySide.QtOpenGL.QGLContext .

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

The shader program will be associated with context .

PySide.QtOpenGL.QGLShaderProgram.addShader(shader)
Parameters:shaderPySide.QtOpenGL.QGLShader
Return type:PySide.QtCore.bool

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 PySide.QtOpenGL.QGLShaderProgram instance is deleted. This allows the caller to add the same shader to multiple shader programs.

PySide.QtOpenGL.QGLShaderProgram.addShaderFromSourceCode(type, source)
Parameters:
  • typePySide.QtOpenGL.QGLShader.ShaderType
  • source – unicode
Return type:

PySide.QtCore.bool

PySide.QtOpenGL.QGLShaderProgram.addShaderFromSourceCode(type, source)
Parameters:
  • typePySide.QtOpenGL.QGLShader.ShaderType
  • source – str
Return type:

PySide.QtCore.bool

PySide.QtOpenGL.QGLShaderProgram.addShaderFromSourceCode(type, source)
Parameters:
Return type:

PySide.QtCore.bool

PySide.QtOpenGL.QGLShaderProgram.addShaderFromSourceFile(type, fileName)
Parameters:
  • typePySide.QtOpenGL.QGLShader.ShaderType
  • fileName – unicode
Return type:

PySide.QtCore.bool

PySide.QtOpenGL.QGLShaderProgram.attributeLocation(name)
Parameters:name – str
Return type:PySide.QtCore.int

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.

PySide.QtOpenGL.QGLShaderProgram.attributeLocation(name)
Parameters:name – unicode
Return type:PySide.QtCore.int

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.

PySide.QtOpenGL.QGLShaderProgram.attributeLocation(name)
Parameters:namePySide.QtCore.QByteArray
Return type:PySide.QtCore.int

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.

PySide.QtOpenGL.QGLShaderProgram.bind()
Return type:PySide.QtCore.bool

Binds this shader program to the active PySide.QtOpenGL.QGLContext and makes it the current shader program. Any previously bound shader program is released. This is equivalent to calling glUseProgram() on PySide.QtOpenGL.QGLShaderProgram.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 PySide.QtOpenGL.QGLShaderProgram.link() .

PySide.QtOpenGL.QGLShaderProgram.bindAttributeLocation(name, location)
Parameters:
  • name – str
  • locationPySide.QtCore.int

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.

PySide.QtOpenGL.QGLShaderProgram.bindAttributeLocation(name, location)
Parameters:

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.

PySide.QtOpenGL.QGLShaderProgram.bindAttributeLocation(name, location)
Parameters:
  • name – unicode
  • locationPySide.QtCore.int

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.

PySide.QtOpenGL.QGLShaderProgram.disableAttributeArray(name)
Parameters:name – str

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.disableAttributeArray(location)
Parameters:locationPySide.QtCore.int

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

PySide.QtOpenGL.QGLShaderProgram.enableAttributeArray(name)
Parameters:name – str

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.enableAttributeArray(location)
Parameters:locationPySide.QtCore.int

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

PySide.QtOpenGL.QGLShaderProgram.geometryInputType()
Return type:PySide.QtOpenGL.GLenum

Returns the geometry shader input type, if active.

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

PySide.QtOpenGL.QGLShaderProgram.geometryOutputType()
Return type:PySide.QtOpenGL.GLenum

Returns the geometry shader output type, if active.

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

PySide.QtOpenGL.QGLShaderProgram.geometryOutputVertexCount()
Return type:PySide.QtCore.int

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.

static PySide.QtOpenGL.QGLShaderProgram.hasOpenGLShaderPrograms([context=None])
Parameters:contextPySide.QtOpenGL.QGLContext
Return type:PySide.QtCore.bool

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.

PySide.QtOpenGL.QGLShaderProgram.init()
Return type:PySide.QtCore.bool
PySide.QtOpenGL.QGLShaderProgram.isLinked()
Return type:PySide.QtCore.bool

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

Return type:PySide.QtCore.bool

Links together the shaders that were added to this program with PySide.QtOpenGL.QGLShaderProgram.addShader() . Returns true if the link was successful or false otherwise. If the link failed, the error messages can be retrieved with PySide.QtOpenGL.QGLShaderProgram.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.

PySide.QtOpenGL.QGLShaderProgram.log()
Return type:unicode

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

PySide.QtOpenGL.QGLShaderProgram.maxGeometryOutputVertices()
Return type:PySide.QtCore.int

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

PySide.QtOpenGL.QGLShaderProgram.programId()
Return type:PySide.QtOpenGL.GLuint

Returns the OpenGL identifier associated with this shader program.

PySide.QtOpenGL.QGLShaderProgram.release()

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

PySide.QtOpenGL.QGLShaderProgram.removeAllShaders()

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

PySide.QtOpenGL.QGLShaderProgram.removeShader(shader)
Parameters:shaderPySide.QtOpenGL.QGLShader

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

PySide.QtOpenGL.QGLShaderProgram.setAttributeArray2D(location, values[, stride=0])
Parameters:

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 PySide.QtOpenGL.QGLShaderProgram.enableAttributeArray() is called on the location . Otherwise the value specified with PySide.QtOpenGL.QGLShaderProgram.setAttributeValue() for location will be used.

PySide.QtOpenGL.QGLShaderProgram.setAttributeArray2D(name, values[, stride=0])
Parameters:

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 PySide.QtOpenGL.QGLShaderProgram.enableAttributeArray() is called on name . Otherwise the value specified with PySide.QtOpenGL.QGLShaderProgram.setAttributeValue() for name will be used.

PySide.QtOpenGL.QGLShaderProgram.setAttributeArray3D(location, values[, stride=0])
Parameters:

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 PySide.QtOpenGL.QGLShaderProgram.enableAttributeArray() is called on the location . Otherwise the value specified with PySide.QtOpenGL.QGLShaderProgram.setAttributeValue() for location will be used.

PySide.QtOpenGL.QGLShaderProgram.setAttributeArray3D(name, values[, stride=0])
Parameters:

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 PySide.QtOpenGL.QGLShaderProgram.enableAttributeArray() is called on name . Otherwise the value specified with PySide.QtOpenGL.QGLShaderProgram.setAttributeValue() for name will be used.

PySide.QtOpenGL.QGLShaderProgram.setAttributeArray4D(location, values[, stride=0])
Parameters:

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 PySide.QtOpenGL.QGLShaderProgram.enableAttributeArray() is called on the location . Otherwise the value specified with PySide.QtOpenGL.QGLShaderProgram.setAttributeValue() for location will be used.

PySide.QtOpenGL.QGLShaderProgram.setAttributeArray4D(name, values[, stride=0])
Parameters:

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 PySide.QtOpenGL.QGLShaderProgram.enableAttributeArray() is called on name . Otherwise the value specified with PySide.QtOpenGL.QGLShaderProgram.setAttributeValue() for name will be used.

PySide.QtOpenGL.QGLShaderProgram.setAttributeBuffer(name, type, offset, tupleSize[, stride=0])
Parameters:
  • name – str
  • typePySide.QtOpenGL.GLenum
  • offsetPySide.QtCore.int
  • tupleSizePySide.QtCore.int
  • stridePySide.QtCore.int

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 PySide.QtOpenGL.QGLShaderProgram.enableAttributeArray() is called on the name . Otherwise the value specified with PySide.QtOpenGL.QGLShaderProgram.setAttributeValue() for name will be used.

See also

PySide.QtOpenGL.QGLShaderProgram.setAttributeArray()

PySide.QtOpenGL.QGLShaderProgram.setAttributeBuffer(location, type, offset, tupleSize[, stride=0])
Parameters:
  • locationPySide.QtCore.int
  • typePySide.QtOpenGL.GLenum
  • offsetPySide.QtCore.int
  • tupleSizePySide.QtCore.int
  • stridePySide.QtCore.int

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 PySide.QtOpenGL.QGLShaderProgram.enableAttributeArray() is called on the location . Otherwise the value specified with PySide.QtOpenGL.QGLShaderProgram.setAttributeValue() for location will be used.

See also

PySide.QtOpenGL.QGLShaderProgram.setAttributeArray()

PySide.QtOpenGL.QGLShaderProgram.setAttributeValue(location, x, y, z, w)
Parameters:
  • locationPySide.QtCore.int
  • xPySide.QtOpenGL.GLfloat
  • yPySide.QtOpenGL.GLfloat
  • zPySide.QtOpenGL.GLfloat
  • wPySide.QtOpenGL.GLfloat

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

PySide.QtOpenGL.QGLShaderProgram.setAttributeValue(location, x, y, z)
Parameters:
  • locationPySide.QtCore.int
  • xPySide.QtOpenGL.GLfloat
  • yPySide.QtOpenGL.GLfloat
  • zPySide.QtOpenGL.GLfloat

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

PySide.QtOpenGL.QGLShaderProgram.setAttributeValue(location, x, y)
Parameters:
  • locationPySide.QtCore.int
  • xPySide.QtOpenGL.GLfloat
  • yPySide.QtOpenGL.GLfloat

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

PySide.QtOpenGL.QGLShaderProgram.setAttributeValue(location, value)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setAttributeValue(location, value)
Parameters:
  • locationPySide.QtCore.int
  • valuePySide.QtOpenGL.GLfloat

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

PySide.QtOpenGL.QGLShaderProgram.setAttributeValue(location, value)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setAttributeValue(location, value)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setAttributeValue(location, value)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setAttributeValue(name, value)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setAttributeValue(name, value)
Parameters:
  • name – str
  • valuePySide.QtOpenGL.GLfloat

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setAttributeValue(name, x, y)
Parameters:
  • name – str
  • xPySide.QtOpenGL.GLfloat
  • yPySide.QtOpenGL.GLfloat

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setAttributeValue(name, x, y, z)
Parameters:
  • name – str
  • xPySide.QtOpenGL.GLfloat
  • yPySide.QtOpenGL.GLfloat
  • zPySide.QtOpenGL.GLfloat

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setAttributeValue(name, x, y, z, w)
Parameters:
  • name – str
  • xPySide.QtOpenGL.GLfloat
  • yPySide.QtOpenGL.GLfloat
  • zPySide.QtOpenGL.GLfloat
  • wPySide.QtOpenGL.GLfloat

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setAttributeValue(name, value)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setAttributeValue(name, value)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setAttributeValue(name, value)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setGeometryInputType(inputType)
Parameters:inputTypePySide.QtOpenGL.GLenum

Sets the input type from inputType .

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

PySide.QtOpenGL.QGLShaderProgram.setGeometryOutputType(outputType)
Parameters:outputTypePySide.QtOpenGL.GLenum

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

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

PySide.QtOpenGL.QGLShaderProgram.setGeometryOutputVertexCount(count)
Parameters:countPySide.QtCore.int

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.

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, value)
Parameters:
  • locationPySide.QtCore.int
  • valuePySide.QtOpenGL.GLuint

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, color)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, value)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, value)
Parameters:
  • locationPySide.QtCore.int
  • valuePySide.QtOpenGL.GLint

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, value)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, x, y, z)
Parameters:
  • locationPySide.QtCore.int
  • xPySide.QtOpenGL.GLfloat
  • yPySide.QtOpenGL.GLfloat
  • zPySide.QtOpenGL.GLfloat

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, x, y, z, w)
Parameters:
  • locationPySide.QtCore.int
  • xPySide.QtOpenGL.GLfloat
  • yPySide.QtOpenGL.GLfloat
  • zPySide.QtOpenGL.GLfloat
  • wPySide.QtOpenGL.GLfloat

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, x, y)
Parameters:
  • locationPySide.QtCore.int
  • xPySide.QtOpenGL.GLfloat
  • yPySide.QtOpenGL.GLfloat

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, value)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, value)
Parameters:
  • locationPySide.QtCore.int
  • valuePySide.QtOpenGL.GLfloat

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, value)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, size)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, value)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, value)
Parameters:

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

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, value)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, value)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, value)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, size)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, point)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, value)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, value)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, point)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, value)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(location, value)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, value)
Parameters:
  • name – str
  • valuePySide.QtOpenGL.GLint

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, value)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, value)
Parameters:
  • name – str
  • valuePySide.QtOpenGL.GLuint

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.

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, value)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, value)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, color)
Parameters:

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 .

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, x, y, z, w)
Parameters:
  • name – str
  • xPySide.QtOpenGL.GLfloat
  • yPySide.QtOpenGL.GLfloat
  • zPySide.QtOpenGL.GLfloat
  • wPySide.QtOpenGL.GLfloat

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, x, y, z)
Parameters:
  • name – str
  • xPySide.QtOpenGL.GLfloat
  • yPySide.QtOpenGL.GLfloat
  • zPySide.QtOpenGL.GLfloat

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, value)
Parameters:
  • name – str
  • valuePySide.QtOpenGL.GLfloat

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, x, y)
Parameters:
  • name – str
  • xPySide.QtOpenGL.GLfloat
  • yPySide.QtOpenGL.GLfloat

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, value)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, size)
Parameters:

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 .

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, point)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, size)
Parameters:

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 .

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, value)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, value)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, value)
Parameters:

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 PySide.QtGui.QTransform value.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, value)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, value)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, value)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, value)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, point)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, value)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValue(name, value)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray2D(location, values)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray2D(name, values)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray2x2(location, values)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray2x2(name, values)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray2x3(name, values)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray2x3(location, values)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray2x4(location, values)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray2x4(name, values)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray3D(name, values)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray3D(location, values)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray3x2(name, values)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray3x2(location, values)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray3x3(name, values)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray3x3(location, values)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray3x4(location, values)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray3x4(name, values)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray4D(name, values)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray4D(location, values)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray4x2(location, values)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray4x2(name, values)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray4x3(name, values)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray4x3(location, values)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray4x4(name, values)
Parameters:

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArray4x4(location, values)
Parameters:

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArrayInt(name, values)
Parameters:
  • name – str
  • valuesPySide.QtOpenGL.GLint

This is an overloaded function.

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArrayInt(location, values)
Parameters:
  • locationPySide.QtCore.int
  • valuesPySide.QtOpenGL.GLint

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

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArrayUint(name, values)
Parameters:
  • name – str
  • valuesPySide.QtOpenGL.GLuint

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.

PySide.QtOpenGL.QGLShaderProgram.setUniformValueArrayUint(location, values)
Parameters:
  • locationPySide.QtCore.int
  • valuesPySide.QtOpenGL.GLuint

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.

PySide.QtOpenGL.QGLShaderProgram.shaderDestroyed()
PySide.QtOpenGL.QGLShaderProgram.shaders()
Return type:

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

PySide.QtOpenGL.QGLShaderProgram.uniformLocation(name)
Parameters:namePySide.QtCore.QByteArray
Return type:PySide.QtCore.int

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.

PySide.QtOpenGL.QGLShaderProgram.uniformLocation(name)
Parameters:name – unicode
Return type:PySide.QtCore.int

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.

PySide.QtOpenGL.QGLShaderProgram.uniformLocation(name)
Parameters:name – str
Return type:PySide.QtCore.int

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.