QQuick3DTextureData Class

class CustomTextureData : public QQuick3DTextureData
{
    Q_OBJECT
    ... properties ...

public:
    CustomTextureData() { regenerateTextureData(); }

    void setProperty(...)
    {
        // Change relevant internal data.
        // ...

        // Update the texture data
        regenerateTextureData();

        // Finally, trigger an update. This is relevant in case nothing else
        // is changed in the scene; this way we make sure a new frame will
        // be rendered
        update();
    }
private:
    void regenerateTextureData()
    {
        QByteArray textureData;
        textureData = generateTextureData();
        setTextureData(textureData);
        setSize(QSize(256, 256));
        setFormat(QQuick3DTextureData::Format::RGBA8)
        setHasTransparency(true);
    }
};

qmlRegisterType<MyCustomTextureData>("Example", 1, 0, "MyCustomTextureData");

CONFIG += qmltypes
QML_IMPORT_NAME = Example
QML_IMPORT_MAJOR_VERSION = 1

qt_add_qml_module(application
    URI Example
    VERSION 1.0
)

class CustomTextureData : public QQuick3DTextureData
{
    Q_OBJECT
    QML_NAMED_ELEMENT(MyCustomTextureData)
    ...
};

import Example 1.0

Model {
    source: "#Cube"
    materials: [
        DefaultMaterial {
            diffuseMap: diffuseMapCustomTexture
        }
    ]
    Texture {
        id: diffuseMapCustomTexture
        textureData: MyCustomTextureData { }
    }
}

Dokumentation der Member-Funktionen

int QQuick3DTextureData::depth() const

Gibt die Farbtiefe der Texturdaten in Pixeln zurück.

Siehe auch „ setDepth()“.

QQuick3DTextureData::Format QQuick3DTextureData::format() const

Gibt das Format der Texturdaten zurück.

Siehe auch „ setFormat()“.

bool QQuick3DTextureData::hasTransparency() const

Gibt „ true “ zurück, wenn die Texturdaten Transparenz aufweisen.

Der Standardwert ist „ false “.

Siehe auch setHasTransparency().

void QQuick3DTextureData::setDepth(int depth)

Legt die „ depth “ der Texturdaten in Pixeln fest. Wird ein Wert größer als 0 festgelegt, wird die Textur als 3D-Textur behandelt.

Siehe auch ` depth()`

void QQuick3DTextureData::setFormat(QQuick3DTextureData::Format format)

Legt das Format „ format “ der Texturdaten fest.

Das Standardformat ist /c RGBA8

Siehe auch ` format()`

void QQuick3DTextureData::setHasTransparency(bool hasTransparency)

Setzen Sie „ hasTransparency “ auf „true“, wenn die Texturdaten einen aktiven Alphakanal mit nicht-undurchsichtigen Werten enthalten.

Dies wird von der Engine als Optimierung genutzt, damit bei Formaten, die einen Alphakanal unterstützen, nicht jeder Wert auf nicht-opake Werte überprüft werden muss.

Siehe auch „ hasTransparency()“.

void QQuick3DTextureData::setSize(const QSize &size)

Legt die „ size “ der Texturdaten in Pixeln fest.

Siehe auch size().

void QQuick3DTextureData::setTextureData(const QByteArray &data)

Legt die Texturdaten fest. Der Inhalt von ` data ` muss den Eigenschaften ` size ` und ` format ` entsprechen, da das Backend versucht, die Daten so hochzuladen und zu verwenden, als handele es sich um eine Textur mit der angegebenen Größe und dem angegebenen Format. Bei Abweichungen kann dies zu einer fehlerhaften Darstellung der Textur oder möglicherweise zu einem Absturz führen.

Siehe auch textureData().

QSize QQuick3DTextureData::size() const

Gibt die Größe der Texturdaten in Pixeln zurück.

Siehe auch „ setSize()“.

const QByteArray QQuick3DTextureData::textureData() const

Gibt die aktuellen Texturdaten zurück, die durch dieses Element definiert sind.

Siehe auch „ setTextureData()“.