class Material : public QSGMaterial
{
public:
    QSGMaterialType *type() const { static QSGMaterialType type; return &type; }
    QSGMaterialShader *createShader() const { return new Shader; }
};

class Material : public QSGMaterial
{
public:
    Material() { setFlag(SupportsRhiShader, true); }
    QSGMaterialType *type() const { static QSGMaterialType type; return &type; }
    QSGMaterialShader *createShader() {
        if (flags().testFlag(RhiShaderWanted)) {
            return new RhiShader;
        } else {
            // this is optional, relevant for materials that intend to be usable with the legacy OpenGL renderer as well
            return new Shader;
        }
    }
};

Member Function Documentation

[virtual] int QSGMaterial::compare(const QSGMaterial *other) const

Compares this material to other and returns 0 if they are equal; -1 if this material should sort before other and 1 if other should sort before.

The scene graph can reorder geometry nodes to minimize state changes. The compare function is called during the sorting process so that the materials can be sorted to minimize state changes in each call to QSGMaterialShader::updateState().

The this pointer and other is guaranteed to have the same type().

[pure virtual] QSGMaterialShader *QSGMaterial::createShader() const

This function returns a new instance of a the QSGMaterialShader implementatation used to render geometry for a specific implementation of QSGMaterial.

The function will be called only once for each material type that exists in the scene graph and will be cached internally.

When the QSGMaterial reports SupportsRhiShader in flags(), the scene graph may request a QSGMaterialRhiShader instead of QSGMaterialShader. This is indicated by having the RhiShaderWanted flag set. In this case the return value must be a QSGRhiMaterialShader subclass.

QSGMaterial::Flags QSGMaterial::flags() const

Returns the material's flags.

void QSGMaterial::setFlag(QSGMaterial::Flags flags, bool on = true)

Sets the flags flags on this material if on is true; otherwise clears the attribute.

[pure virtual] QSGMaterialType *QSGMaterial::type() const

This function is called by the scene graph to return a unique instance per subclass.