QNormalDiffuseMapMaterial Class
(Qt3DExtras::QNormalDiffuseMapMaterial)The QNormalDiffuseMapMaterial provides a default implementation of the phong lighting and bump effect where the diffuse light component is read from a texture map and the normals of the mesh being rendered from a normal texture map. More...
Header: | #include <QNormalDiffuseMapMaterial> |
qmake: | QT += 3dextras |
Since: | Qt 5.7 |
Inherits: | Qt3DRender::QMaterial |
Inherited By: |
Properties
|
- 1 property inherited from Qt3DRender::QMaterial
- 1 property inherited from Qt3DCore::QComponent
- 2 properties inherited from Qt3DCore::QNode
- 1 property inherited from QObject
Public Functions
QNormalDiffuseMapMaterial(Qt3DCore::QNode *parent = nullptr) | |
~QNormalDiffuseMapMaterial() | |
QColor | ambient() const |
Qt3DRender::QAbstractTexture * | diffuse() const |
Qt3DRender::QAbstractTexture * | normal() const |
float | shininess() const |
QColor | specular() const |
float | textureScale() const |
- 4 public functions inherited from Qt3DRender::QMaterial
- 2 public functions inherited from Qt3DCore::QComponent
- 6 public functions inherited from Qt3DCore::QNode
- 31 public functions inherited from QObject
Public Slots
void | setAmbient(const QColor &ambient) |
void | setDiffuse(Qt3DRender::QAbstractTexture *diffuse) |
void | setNormal(Qt3DRender::QAbstractTexture *normal) |
void | setShininess(float shininess) |
void | setSpecular(const QColor &specular) |
void | setTextureScale(float textureScale) |
- 1 public slot inherited from Qt3DRender::QMaterial
- 1 public slot inherited from Qt3DCore::QComponent
- 2 public slots inherited from Qt3DCore::QNode
- 1 public slot inherited from QObject
Signals
void | ambientChanged(const QColor &ambient) |
void | diffuseChanged(Qt3DRender::QAbstractTexture *diffuse) |
void | normalChanged(Qt3DRender::QAbstractTexture *normal) |
void | shininessChanged(float shininess) |
void | specularChanged(const QColor &specular) |
void | textureScaleChanged(float textureScale) |
- 1 signal inherited from Qt3DRender::QMaterial
- 1 signal inherited from Qt3DCore::QComponent
- 3 signals inherited from Qt3DCore::QNode
- 2 signals inherited from QObject
Protected Functions
QNormalDiffuseMapMaterial(QNormalDiffuseMapMaterialPrivate &dd, Qt3DCore::QNode *parent = nullptr) |
- 2 protected functions inherited from Qt3DCore::QNode
- 9 protected functions inherited from QObject
Additional Inherited Members
- 11 static public members inherited from QObject
Detailed Description
The QNormalDiffuseMapMaterial provides a default implementation of the phong lighting and bump effect where the diffuse light component is read from a texture map and the normals of the mesh being rendered from a normal texture map.
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 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.
Property Documentation
ambient : QColor
Holds the current ambient color.
Access functions:
QColor | ambient() const |
void | setAmbient(const QColor &ambient) |
Notifier signal:
void | ambientChanged(const QColor &ambient) |
diffuse : Qt3DRender::QAbstractTexture *
Holds the current diffuse map texture.
By default, the diffuse texture has these properties:
- Linear minification and magnification filters
- Linear mipmap with mipmapping enabled
- Repeat wrap modeM
- Maximum anisotropy of 16.0
Access functions:
Qt3DRender::QAbstractTexture * | diffuse() const |
void | setDiffuse(Qt3DRender::QAbstractTexture *diffuse) |
Notifier signal:
void | diffuseChanged(Qt3DRender::QAbstractTexture *diffuse) |
normal : Qt3DRender::QAbstractTexture *
Holds the current normal map texture.
By default, the normal texture has the following properties:
- Linear minification and magnification filters
- Repeat wrap mode
- Maximum anisotropy of 16.0
Access functions:
Qt3DRender::QAbstractTexture * | normal() const |
void | setNormal(Qt3DRender::QAbstractTexture *normal) |
Notifier signal:
void | normalChanged(Qt3DRender::QAbstractTexture *normal) |
shininess : float
Holds the current shininess as a float value.
Access functions:
float | shininess() const |
void | setShininess(float shininess) |
Notifier signal:
void | shininessChanged(float shininess) |
specular : QColor
Holds the current specular color.
Access functions:
QColor | specular() const |
void | setSpecular(const QColor &specular) |
Notifier signal:
void | specularChanged(const QColor &specular) |
textureScale : float
Holds the current texture scale. It is applied as a multiplier to texture coordinates at render time. Defaults to 1.0.
Access functions:
float | textureScale() const |
void | setTextureScale(float textureScale) |
Notifier signal:
void | textureScaleChanged(float textureScale) |
Member Function Documentation
QNormalDiffuseMapMaterial::QNormalDiffuseMapMaterial(Qt3DCore::QNode *parent = nullptr)
Default constructs an instance of QNormalDiffuseMapMaterial.
[protected]
QNormalDiffuseMapMaterial::QNormalDiffuseMapMaterial(QNormalDiffuseMapMaterialPrivate &dd, Qt3DCore::QNode *parent = nullptr)
Copy constructor.
QNormalDiffuseMapMaterial::~QNormalDiffuseMapMaterial()
Destroys the QNormalDiffuseMapMaterial instance.
© 2017 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.