class QDiffuseSpecularMapMaterial¶

The QDiffuseSpecularMapMaterial provides a default implementation of the phong lighting effect where the diffuse and specular light components are read from texture maps. More…

Synopsis¶

Properties¶

ambientᅟ
diffuseᅟ
shininessᅟ
specularᅟ
textureScaleᅟ

Methods¶

def __init__()
def ambient()
def diffuse()
def shininess()
def specular()
def textureScale()

Signals¶

def ambientChanged()
def diffuseChanged()
def shininessChanged()
def specularChanged()
def textureScaleChanged()

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description¶

This class is deprecated; use QDiffuseSpecularMaterial instead.

The specular lighting effect is based on the combination of 3 lighting components ambient, diffuse and specular. The relative strengths of these components are controlled by means of their reflectivity coefficients which are modelled as RGB triplets:

Ambient is the color that is emitted by an object without any other light source.

Diffuse is the color that is emitted for rough surface reflections with the lights.

Specular is the color emitted for shiny surface reflections with the lights.

The shininess of a surface is controlled by a float property.

This material uses an effect with a single render pass approach and performs per fragment lighting. Techniques are provided for OpenGL 2, OpenGL 3 or above as well as OpenGL ES 2.

Note

Properties can be used directly when from __feature__ import true_property is used or via accessor functions otherwise.

property ambientᅟ: QColor¶

Holds the current ambient color that is emitted by an object without any other light source.

Access functions:

ambient()
setAmbient()
Signal ambientChanged()

property diffuseᅟ: QAbstractTexture¶

Holds the current diffuse map texture.

By default, the diffuse texture has the following properties:

Linear minification and magnification filters

Linear mipmap with mipmapping enabled

Repeat wrap mode

Maximum anisotropy of 16.0

Access functions:

diffuse()
setDiffuse()
Signal diffuseChanged()

property shininessᅟ: float¶

Holds the current shininess as a float value. Higher values of shininess result in a smaller and brighter highlight.

Defaults to 150.0.

Access functions:

shininess()
setShininess()
Signal shininessChanged()

property specularᅟ: QAbstractTexture¶

Holds the current specular map texture.

By default, the specular texture has the following properties:

Linear minification and magnification filters

Linear mipmap with mipmapping enabled

Repeat wrap mode

Maximum anisotropy of 16.0

Access functions:

specular()
setSpecular()
Signal specularChanged()

property textureScaleᅟ: float¶

Holds the current texture scale. It is applied as a multiplier to texture coordinates at render time. Defaults to 1.0.

When used in conjunction with QTextureWrapMode::Repeat, textureScale provides a simple way to tile a texture across a surface. For example, a texture scale of 4.0 would result in 16 (4x4) tiles.

Access functions:

textureScale()
setTextureScale()
Signal textureScaleChanged()

__init__([parent=None])¶

Parameters:: parent – QNode

Constructs a new QDiffuseSpecularMapMaterial instance with parent object parent.

ambient()¶

Return type:: QColor

See also

setAmbient()

Getter of property ambientᅟ .

ambientChanged(ambient)¶

Parameters:: ambient – QColor

Notification signal of property ambientᅟ .

diffuse()¶

Return type:: QAbstractTexture

See also

setDiffuse()

Getter of property diffuseᅟ .

diffuseChanged(diffuse)¶

Parameters:: diffuse – QAbstractTexture

Notification signal of property diffuseᅟ .

setAmbient(ambient)¶

Parameters:: ambient – QColor

See also

ambient()

Setter of property ambientᅟ .

setDiffuse(diffuse)¶

Parameters:: diffuse – QAbstractTexture

See also

diffuse()

Setter of property diffuseᅟ .

setShininess(shininess)¶

Parameters:: shininess – float

See also

shininess()

Setter of property shininessᅟ .

setSpecular(specular)¶

Parameters:: specular – QAbstractTexture

See also

specular()

Setter of property specularᅟ .

setTextureScale(textureScale)¶

Parameters:: textureScale – float

See also

textureScale()

Setter of property textureScaleᅟ .

shininess()¶

Return type:: float

See also

setShininess()

Getter of property shininessᅟ .

shininessChanged(shininess)¶

Parameters:: shininess – float

Notification signal of property shininessᅟ .

specular()¶

Return type:: QAbstractTexture

See also

setSpecular()

Getter of property specularᅟ .

specularChanged(specular)¶

Parameters:: specular – QAbstractTexture

Notification signal of property specularᅟ .

textureScale()¶

Return type:: float

See also

setTextureScale()

Getter of property textureScaleᅟ .

textureScaleChanged(textureScale)¶

Parameters:: textureScale – float

Notification signal of property textureScaleᅟ .