QQuick3DGeometry Class

class CustomGeometry : public QQuick3DGeometry
{
public:
    CustomGeometry() { rebuildGeometry(); }

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

       // Then rebuild the vertex and index data and pass it to QQuick3DGeometry.
       rebuildGeometry();

       // Finally, trigger an update. This is relevant in case nothing else
       // is changing in the scene; this way we make sure a new frame will
       // be rendered.
       update();
    }

private:
    void rebuildGeometry()
    {
        QByteArray vertices;
        QByteArray indices;
        ...
        setPrimitiveType(Lines);
        setVertexBuffer(vertices);
        setIndexBuffer(indices);
        setStride(3 * sizeof(float)); // e.g. when having 3 components per vertex
        setBounds(...); // minimum and maximum extents, for picking
        addAttribute(PositionSemantic, 0, F32Type);
        ...
    }
};

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

CONFIG += qmltypes
QML_IMPORT_NAME = Example
QML_IMPORT_MAJOR_VERSION = 1

qt_add_qml_module(application
    URI Example
    VERSION 1.0
)

class CustomGeometry : public QQuick3DGeometry
{
    Q_OBJECT
    QML_NAMED_ELEMENT(CustomGeometry)
    ...
};

import Example 1.0

Model {
    id: customModel
    geometry: CustomGeometry {
    }
}

class ExampleGeometry : public QQuick3DGeometry
{
    Q_OBJECT
    QML_NAMED_ELEMENT(ExampleGeometry)

public:
    ExampleGeometry();

private:
    void updateData();
};

ExampleGeometry::ExampleGeometry()
{
    updateData();
}

void ExampleGeometry::updateData()
{
    QByteArray v;
    v.resize(3 * 3 * sizeof(float));
    float *p = reinterpret_cast<float *>(v.data());

    // a triangle, front face = counter-clockwise
    *p++ = -1.0f; *p++ = -1.0f; *p++ = 0.0f;
    *p++ = 1.0f; *p++ = -1.0f; *p++ = 0.0f;
    *p++ = 0.0f; *p++ = 1.0f; *p++ = 0.0f;

    setVertexData(v);
    setStride(3 * sizeof(float));

    setPrimitiveType(QQuick3DGeometry::PrimitiveType::Triangles);

    addAttribute(QQuick3DGeometry::Attribute::PositionSemantic,
                 0,
                 QQuick3DGeometry::Attribute::F32Type);
}

Dokumentation der Member-Funktionen

void QQuick3DGeometry::addAttribute(QQuick3DGeometry::Attribute::Semantic semantic, int offset, QQuick3DGeometry::Attribute::ComponentType componentType)

Fügt eine Beschreibung des Knotenattributs hinzu. Jedes Attribut verfügt über eine „ semantic “, die die Verwendung des Attributs und die Anzahl seiner Komponenten angibt, eine „ offset “, die den Weg vom Anfang über den Knoten bis zur Position des Attributs innerhalb eines Knotens beschreibt, sowie eine „ componentType “, die den Datentyp und die Größe des Attributs angibt.

Die Semantik kann eine der folgenden sein:

Darüber hinaus kann „ semantic “ den Wert „ IndexSemantic “ annehmen. In diesem Fall stellt das Attribut keinen Eintrag im Vertex-Puffer dar, sondern beschreibt die Indexdaten im Index-Puffer. Da es immer nur einen Index pro Vertex gibt, ist „ offset “ für den Index-Puffer nicht sinnvoll und sollte auf Null gesetzt werden.

Der Komponententyp kann einer der folgenden sein:

void QQuick3DGeometry::addAttribute(const QQuick3DGeometry::Attribute &attribute)

Fügt eine Beschreibung des Scheitelpunktattributs hinzu. Jedes Attribut verfügt über eine Semantik, die die Verwendung des Attributs und die Anzahl seiner Komponenten angibt, einen Versatz vom Anfang des Scheitelpunkts bis zur Position des Attributs innerhalb eines Scheitelpunkts sowie einen „componentType“, der den Datentyp und die Größe des Attributs angibt.

void QQuick3DGeometry::addSubset(int offset, int count, const QVector3D &boundsMin, const QVector3D &boundsMax, const QString &name = {})

Fügt der Geometrie eine neue Teilmenge hinzu. Teilmengen ermöglichen es, Teile der Geometrie mit unterschiedlichen Materialien darzustellen. Die Materialien werden in der Datei „ model “ angegeben.

Verfügt die Geometrie über einen Indexpuffer, so sind „ offset “ und „ count “ der Offset der Primitive und die Anzahl der Indizes in der Teilmenge. Verfügt die Geometrie nur über einen Vertexpuffer, so ist der Offset der Vertex-Offset und „count“ die Anzahl der Vertexpunkte in der Teilmenge.

Die Begrenzungen „ boundsMin “ und „ boundsMax “ sollten die Teilmenge ebenso umschließen wie die Geometriegrenzen. Außerdem kann die Teilmenge einen „ name “ haben.

[since 6.6] void QQuick3DGeometry::addTargetAttribute(quint32 targetId, QQuick3DGeometry::Attribute::Semantic semantic, int offset, int stride = 0)

Fügt eine Beschreibung des Morph-Zielattributs hinzu. Jedes Attribut verfügt über eine „ targetId “, zu der das Attribut gehört, eine „ semantic “, die die Verwendung des Attributs und die Anzahl seiner Komponenten angibt, eine „ offset “ vom Anfang über den Scheitelpunkt bis zur Position des Attributs innerhalb eines Scheitelpunkts sowie eine „ stride “, die die Byte-Größe zwischen den Elementen angibt.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch addAttribute.

[since 6.6] void QQuick3DGeometry::addTargetAttribute(const QQuick3DGeometry::TargetAttribute &attribute)

Fügt eine Beschreibung des Morph-Zielattributs hinzu. Jedes Attribut verfügt über eine „targetId“, zu der das Attribut gehört, eine „semantic“, die die Verwendung des Attributs und die Anzahl seiner Komponenten angibt, einen „offset“, der den Abstand vom Anfang des Vertix bis zur Position des Attributs innerhalb eines Vertix angibt, sowie einen „stride“, der die Byte-Größe zwischen den Elementen angibt.

Diese Funktion wurde in Qt 6.6 eingeführt.

QQuick3DGeometry::Attribute QQuick3DGeometry::attribute(int index) const

Gibt die Nummer der Attributdefinition zurück index

Die Attributdefinitionen sind von 0 bis attributeCount() - 1

int QQuick3DGeometry::attributeCount() const

Gibt die Anzahl der für diese Geometrie definierten Attribute zurück.

Siehe auch „ attribute “.

QVector3D QQuick3DGeometry::boundsMax() const

Gibt die maximale Koordinate des Begrenzungsvolumens zurück.

Siehe auch „ setBounds “.

QVector3D QQuick3DGeometry::boundsMin() const

Gibt die minimale Koordinate des Begrenzungsvolumens zurück.

Siehe auch „ setBounds “.

void QQuick3DGeometry::clear()

Setzt die Geometrie in ihren Ausgangszustand zurück und löscht dabei zuvor festgelegte Scheitelpunkt- und Indexdaten sowie Attribute.

QByteArray QQuick3DGeometry::indexData() const

Gibt die Daten des Indexpuffers zurück.

Siehe auch „ setIndexData()“.

QQuick3DGeometry::PrimitiveType QQuick3DGeometry::primitiveType() const

Gibt den beim Rendern verwendeten primitiven Typ zurück. Der Standardwert ist „ Triangles “.

Siehe auch „ setPrimitiveType “.

void QQuick3DGeometry::setBounds(const QVector3D &min, const QVector3D &max)

Legt das Begrenzungsvolumen der Geometrie auf den Würfel fest, der durch die Punkte min und max definiert ist. Dies wird für picking verwendet.

void QQuick3DGeometry::setIndexData(const QByteArray &data)

Setzt den Indexpuffer auf „ data “. Um das indizierte Zeichnen zu verwenden, fügen Sie ein Attribut mit IndexSemantic

Siehe auch ` indexData()` und ` addAttribute`.

void QQuick3DGeometry::setIndexData(int offset, const QByteArray &data)

Aktualisiert eine Teilmenge des Indexpuffers. ` offset ` gibt den Offset in Byte an, ` data ` gibt die Größe und die Daten an.

Diese Funktion ändert die Größe des Puffers nicht. Ist offset + data.size() größer als die aktuelle Größe des Puffers, werden die über den Puffer hinausgehenden Daten ignoriert.

void QQuick3DGeometry::setPrimitiveType(QQuick3DGeometry::PrimitiveType type)

Legt den für die Darstellung verwendeten Primitivtyp auf „ type “ fest.

Der Anfangswert lautet „ Triangles “.

Siehe auch ` primitiveType()`.

void QQuick3DGeometry::setStride(int stride)

Legt den Schritt des Vertex-Puffers auf stride fest, gemessen in Byte. Dies ist der Abstand zwischen zwei aufeinanderfolgenden Scheitelpunkten im Puffer.

Beispielsweise hat ein dicht gepackter, verschachtelter Vertex-Puffer für eine Geometrie, die „ PositionSemantic “, „ IndexSemantic “ und „ ColorSemantic “ verwendet, einen Stride von „ 28 “ (insgesamt sieben Floats: drei für die Position, vier für die Farbe und keine für Indizes, da diese nicht im Vertex-Puffer enthalten sind).

Siehe auch stride() und addAttribute.

[since 6.6] void QQuick3DGeometry::setTargetData(const QByteArray &data)

Legt den Morph-Ziel-Puffer „ data “ fest. Der Puffer sollte alle Morph-Ziel-Daten enthalten.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch targetData() und addTargetAttribute.

[since 6.6] void QQuick3DGeometry::setTargetData(int offset, const QByteArray &data)

Aktualisiert einen Teilbereich des Morph-Zielpuffers. ` offset ` gibt den Offset in Byte an, ` data ` gibt die Größe und die Daten an.

Diese Funktion passt die Größe des Puffers nicht an. Ist offset + data.size() größer als die aktuelle Größe des Puffers, werden die über den Puffer hinausgehenden Daten ignoriert.

Diese Funktion wurde in Qt 6.6 eingeführt.

void QQuick3DGeometry::setVertexData(const QByteArray &data)

Legt den Vertex-Puffer „ data “ fest. Der Puffer sollte alle im Array gepackten Vertex-Daten enthalten, wie in den Attributdefinitionen beschrieben. Beachten Sie, dass dies keine Attribute mit „ IndexSemantic “ umfasst, die in den Index-Puffer gehören.

Siehe auch „ vertexData()“, „ addAttribute “, „ setStride “ und „ setIndexData “.

void QQuick3DGeometry::setVertexData(int offset, const QByteArray &data)

Aktualisiert eine Teilmenge des Vertex-Puffers. „ offset “ gibt den Offset in Byte an, „ data “ gibt die Größe und die Daten an.

Diese Funktion passt die Größe des Puffers nicht an. Ist offset + data.size() größer als die aktuelle Größe des Puffers, werden die über den Puffer hinausgehenden Daten ignoriert.

int QQuick3DGeometry::stride() const

Gibt den Byte-Schritt des Vertex-Puffers zurück.

Siehe auch „ setStride “.

QVector3D QQuick3DGeometry::subsetBoundsMax(int subset) const

Gibt die Anzahl der maximalen Grenzen eines ` subset` zurück.

Siehe auch „ subsetBoundsMin “.

QVector3D QQuick3DGeometry::subsetBoundsMin(int subset) const

Gibt die Anzahl der Minimalgrenzen eines „ subset “ zurück.

Siehe auch „ subsetBoundsMax “.

int QQuick3DGeometry::subsetCount() const

Gibt die Anzahl der Teilmengen zurück.

int QQuick3DGeometry::subsetCount(int subset) const

Gibt die Anzahl der Primitive in der Teilmenge zurück.

Siehe auch „ subsetOffset “.

QString QQuick3DGeometry::subsetName(int subset) const

Gibt den Namen „ subset “ zurück.

int QQuick3DGeometry::subsetOffset(int subset) const

Gibt den Offset „ subset “ für den Vertex- oder Indexpuffer zurück.

Siehe auch „ subsetCount “.

[since 6.6] QQuick3DGeometry::TargetAttribute QQuick3DGeometry::targetAttribute(int index) const

Gibt die Nummer der Attributdefinition des Morph-Ziels zurück index

Die Attributdefinitionen sind von 0 bis attributeCount() - 1

Diese Funktion wurde in Qt 6.6 eingeführt.

[since 6.6] int QQuick3DGeometry::targetAttributeCount() const

Gibt die Anzahl der für diese Geometrie definierten Morph-Zielattribute zurück.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch targetAttribute.

[since 6.6] QByteArray QQuick3DGeometry::targetData() const

Gibt die mit ` setTargetData` festgelegten Daten des Zielpuffers zurück.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch ` setTargetData()`.

QByteArray QQuick3DGeometry::vertexData() const

Gibt die durch ` setVertexData` festgelegten Vertex-Buffer-Daten zurück.

Siehe auch ` setVertexData()`.