QDiffuseSpecularMaterial#

The QDiffuseSpecularMaterial class provides a default implementation of the phong lighting effect. More…

Synopsis#

Properties#

alphaBlending
ambient
diffuse
normal
shininess
specular
textureScale

Functions#

def ambient ()
def diffuse ()
def isAlphaBlendingEnabled ()
def normal ()
def shininess ()
def specular ()
def textureScale ()

Slots#

def setAlphaBlendingEnabled (enabled)
def setAmbient (ambient)
def setDiffuse (diffuse)
def setNormal (normal)
def setShininess (shininess)
def setSpecular (specular)
def setTextureScale (textureScale)

Signals#

def alphaBlendingEnabledChanged (enabled)
def ambientChanged (ambient)
def diffuseChanged (diffuse)
def normalChanged (normal)
def shininessChanged (shininess)
def specularChanged (specular)
def textureScaleChanged (textureScale)

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#

The phong 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 rought 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.

class PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial([parent=None])#

Parameters:: parent – PySide6.Qt3DCore.Qt3DCore.QNode

Constructs a new QDiffuseSpecularMaterial instance with parent object parent.

Note

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

property PᅟySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.alphaBlending: bool#

Indicates if the alpha information coming from the diffuse property will be taken into account during rendering. Defaults to false.

Access functions:

isAlphaBlendingEnabled ()
setAlphaBlendingEnabled (enabled)
Signal alphaBlendingEnabledChanged (enabled)

property PᅟySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.ambient: PySide6.QtGui.QColor#

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

Access functions:

ambient ()
setAmbient (ambient)
Signal ambientChanged (ambient)

property PᅟySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.diffuse: object#

Holds the diffuse color of the material that is emitted for rough surface reflections with the lights. This can be either a plain color value or a texture.

Access functions:

diffuse ()
setDiffuse (diffuse)
Signal diffuseChanged (diffuse)

property PᅟySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.normal: object#

Holds the current normal map texture of the material. This can only be a texture, otherwise it is ignored. By default this map is not set.

Access functions:

normal ()
setNormal (normal)
Signal normalChanged (normal)

property PᅟySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.shininess: float#

Holds the shininess exponent. Higher values of shininess result in a smaller and brighter highlight.

Defaults to 150.0.

Access functions:

shininess ()
setShininess (shininess)
Signal shininessChanged (shininess)

property PᅟySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.specular: object#

Holds the specular color of the material that is emitted for shiny surface reflections with the lights. This can be either a plain color value or a texture.

Access functions:

specular ()
setSpecular (specular)
Signal specularChanged (specular)

property PᅟySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.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 (textureScale)
Signal textureScaleChanged (textureScale)

PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.alphaBlendingEnabledChanged(enabled)#

Parameters:: enabled – bool

Notification signal of property alphaBlending .

PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.ambient()#

Return type:: PySide6.QtGui.QColor

See also

setAmbient()

Getter of property ambient .

PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.ambientChanged(ambient)#

Parameters:: ambient – PySide6.QtGui.QColor

Notification signal of property ambient .

PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.diffuse()#

Return type:: object

See also

setDiffuse()

Getter of property diffuse .

PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.diffuseChanged(diffuse)#

Parameters:: diffuse – object

Notification signal of property diffuse .

PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.isAlphaBlendingEnabled()#

Return type:: bool

Getter of property alphaBlending .

PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.normal()#

Return type:: object

See also

setNormal()

Getter of property normal .

PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.normalChanged(normal)#

Parameters:: normal – object

Notification signal of property normal .

PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.setAlphaBlendingEnabled(enabled)#

Parameters:: enabled – bool

See also

isAlphaBlendingEnabled()

Setter of property alphaBlending .

PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.setAmbient(ambient)#

Parameters:: ambient – PySide6.QtGui.QColor

See also

ambient()

Setter of property ambient .

PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.setDiffuse(diffuse)#

Parameters:: diffuse – object

See also

diffuse()

Setter of property diffuse .

PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.setNormal(normal)#

Parameters:: normal – object

See also

normal()

Setter of property normal .

PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.setShininess(shininess)#

Parameters:: shininess – float

See also

shininess()

Setter of property shininess .

PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.setSpecular(specular)#

Parameters:: specular – object

See also

specular()

Setter of property specular .

PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.setTextureScale(textureScale)#

Parameters:: textureScale – float

See also

textureScale()

Setter of property textureScale .

PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.shininess()#

Return type:: float

See also

setShininess()

Getter of property shininess .

PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.shininessChanged(shininess)#

Parameters:: shininess – float

Notification signal of property shininess .

PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.specular()#

Return type:: object

See also

setSpecular()

Getter of property specular .

PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.specularChanged(specular)#

Parameters:: specular – object

Notification signal of property specular .

PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.textureScale()#

Return type:: float

See also

setTextureScale()

Getter of property textureScale .

PySide6.Qt3DExtras.Qt3DExtras.QDiffuseSpecularMaterial.textureScaleChanged(textureScale)#

Parameters:: textureScale – float

Notification signal of property textureScale .