QGoochMaterial

The QGoochMaterial provides a material that implements the Gooch shading model, popular in CAD and CAM applications. More…

Synopsis

Functions

• def alpha ()

• def beta ()

• def cool ()

• def diffuse ()

• def shininess ()

• def specular ()

• def warm ()

Slots

• def setAlpha (alpha)

• def setBeta (beta)

• def setCool (cool)

• def setDiffuse (diffuse)

• def setShininess (shininess)

• def setSpecular (specular)

• def setWarm (warm)

Signals

• def alphaChanged (alpha)

• def betaChanged (beta)

• def coolChanged (cool)

• def diffuseChanged (diffuse)

• def shininessChanged (shininess)

• def specularChanged (specular)

• def warmChanged (warm)

Detailed Description

The Gooch lighting model uses both color and brightness to help show the curvature of 3D surfaces. This is often better than models such as Phong that rely purely upon changes in brightness. In situations such as in CAD and CAM applications where photorealism is not a goal, the Gooch shading model in conjunction with some kind of silhouette edge inking is a popular solution.

The Gooch lighting model is explained fully in the original Gooch paper . The Gooch model mixes a diffuse object color with a user-provided cool color and warm color to produce the end points of a color ramp that is used to shade the object based upon the cosine of the angle between the vector from the fragment to the light source and the fragment’s normal vector. Optionally, a specular highlight can be added on top. The relative contributions to the cool and warm colors by the diffuse color are controlled by the alpha and beta properties respecitvely.

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.QGoochMaterial([parent=None])

Parameters

parent – PySide6.Qt3DCore.Qt3DCore.QNode

Constructs a new QGoochMaterial instance with parent object parent.

PySide6.Qt3DExtras.Qt3DExtras.QGoochMaterial.alpha()

Return type

float

Holds the current alpha value. The start point of the color ramp used by the Gooch shader is calculated as {c = cool + alpha * diffuse}.

PySide6.Qt3DExtras.Qt3DExtras.QGoochMaterial.alphaChanged(alpha)

Parameters

alpha – float

PySide6.Qt3DExtras.Qt3DExtras.QGoochMaterial.beta()

Return type

float

Holds the current beta value. The start point of the color ramp used by the Gooch shader is calculated as {c = warm + beta * diffuse}.

PySide6.Qt3DExtras.Qt3DExtras.QGoochMaterial.betaChanged(beta)

Parameters

beta – float

PySide6.Qt3DExtras.Qt3DExtras.QGoochMaterial.cool()

Return type

PySide6.QtGui.QColor

Holds the current cool color.

PySide6.Qt3DExtras.Qt3DExtras.QGoochMaterial.coolChanged(cool)

Parameters

cool – PySide6.QtGui.QColor

PySide6.Qt3DExtras.Qt3DExtras.QGoochMaterial.diffuse()

Return type

PySide6.QtGui.QColor

Holds the current diffuse color.

PySide6.Qt3DExtras.Qt3DExtras.QGoochMaterial.diffuseChanged(diffuse)

Parameters

diffuse – PySide6.QtGui.QColor

PySide6.Qt3DExtras.Qt3DExtras.QGoochMaterial.setAlpha(alpha)

Parameters

alpha – float

Holds the current alpha value. The start point of the color ramp used by the Gooch shader is calculated as {c = cool + alpha * diffuse}.

PySide6.Qt3DExtras.Qt3DExtras.QGoochMaterial.setBeta(beta)

Parameters

beta – float

Holds the current beta value. The start point of the color ramp used by the Gooch shader is calculated as {c = warm + beta * diffuse}.

PySide6.Qt3DExtras.Qt3DExtras.QGoochMaterial.setCool(cool)

Parameters

cool – PySide6.QtGui.QColor

Holds the current cool color.

PySide6.Qt3DExtras.Qt3DExtras.QGoochMaterial.setDiffuse(diffuse)

Parameters

diffuse – PySide6.QtGui.QColor

Holds the current diffuse color.

PySide6.Qt3DExtras.Qt3DExtras.QGoochMaterial.setShininess(shininess)

Parameters

shininess – float

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

PySide6.Qt3DExtras.Qt3DExtras.QGoochMaterial.setSpecular(specular)

Parameters

specular – PySide6.QtGui.QColor

Holds the current specular color.

PySide6.Qt3DExtras.Qt3DExtras.QGoochMaterial.setWarm(warm)

Parameters

warm – PySide6.QtGui.QColor

Holds the current warm color.

PySide6.Qt3DExtras.Qt3DExtras.QGoochMaterial.shininess()

Return type

float

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

PySide6.Qt3DExtras.Qt3DExtras.QGoochMaterial.shininessChanged(shininess)

Parameters

shininess – float

PySide6.Qt3DExtras.Qt3DExtras.QGoochMaterial.specular()

Return type

PySide6.QtGui.QColor

Holds the current specular color.

PySide6.Qt3DExtras.Qt3DExtras.QGoochMaterial.specularChanged(specular)

Parameters

specular – PySide6.QtGui.QColor

PySide6.Qt3DExtras.Qt3DExtras.QGoochMaterial.warm()

Return type

PySide6.QtGui.QColor

Holds the current warm color.

PySide6.Qt3DExtras.Qt3DExtras.QGoochMaterial.warmChanged(warm)

Parameters

warm – PySide6.QtGui.QColor