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 Mitgliedsfunktionen

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

Fügt eine Beschreibung der Scheitelpunkt-Attribute hinzu. Jedes Attribut hat eine semantic, die die Verwendung des Attributs und die Anzahl der Komponenten angibt, die es hat, eine offset vom Anfang bis zum Scheitelpunkt bis zur Position des Attributs innerhalb eines Scheitelpunkts und eine componentType, die den Datentyp und die Größe des Attributs angibt.

Die Semantik kann eine der folgenden sein:

Darüber hinaus kann semantic IndexSemantic sein. 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 Scheitelpunkt gibt, macht offset für den Indexpuffer keinen Sinn und sollte auf Null belassen werden.

Der Komponententyp kann einer der folgenden sein:

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

Dies ist eine überladene Funktion.

Fügt die Beschreibung von Vertex-Attributen hinzu. Jedes Attribut hat eine Semantik, die die Verwendung des Attributs und die Anzahl der Komponenten angibt, die es hat, einen Offset vom Anfang des Scheitelpunkts bis zur Position des Attributs innerhalb eines Scheitelpunkts und 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. Untermengen ermöglichen das Rendern von Teilen der Geometrie mit unterschiedlichen Materialien. Die Materialien werden in model angegeben.

Wenn die Geometrie über einen Indexpuffer verfügt, dann sind offset und count der Primitiv-Offset und die Anzahl der Indizes in der Untergruppe. Wenn die Geometrie nur einen Scheitelpunkt-Puffer hat, ist der Offset der Scheitelpunkt-Offset und die Anzahl die Anzahl der Scheitelpunkte in der Untermenge.

Die Begrenzungen boundsMin und boundsMax sollten die Teilmenge genau wie die Geometriebegrenzungen umschließen. Auch die Teilmenge kann eine name haben.

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

Fügt die Beschreibung von Morph-Zielattributen hinzu. Jedes Attribut hat eine targetId, zu der das Attribut gehört, eine semantic, die die Verwendung des Attributs und die Anzahl der Komponenten angibt, die es hat, eine offset vom Anfang bis zum Vertex bis zur Position des Attributs innerhalb eines Vertex, und eine stride, die eine Bytegröße zwischen den Elementen ist.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch addAttribute.

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

Dies ist eine überladene Funktion.

Fügt die Beschreibung von Morph-Zielattributen hinzu. Jedes Attribut hat eine targetId, zu der das Attribut gehört, eine Semantik, die die Verwendung des Attributs und die Anzahl der Komponenten, die es hat, angibt, einen Offset vom Anfang des Vertex bis zur Position des Attributs innerhalb eines Vertex und einen Stride, der eine Bytegröße zwischen den Elementen ist.

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 nummeriert 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 auf ihren Ausgangszustand zurück, wobei zuvor gesetzte Eckpunkt- und Indexdaten sowie Attribute gelöscht werden.

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. Die Vorgabe ist Triangles.

Siehe auch setPrimitiveType.

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

Setzt das Begrenzungsvolumen der Geometrie auf den Würfel, 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 indiziertes Zeichnen zu verwenden, fügen Sie ein Attribut mit IndexSemantic

Siehe auch indexData() und addAttribute.

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

Dies ist eine überladene Funktion.

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

Mit dieser Funktion wird die Größe des Puffers nicht verändert. Wenn offset + data.size() größer ist als die aktuelle Größe des Puffers, werden die überschießenden Daten ignoriert.

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

Setzt den für das Rendering verwendeten Primitivtyp auf type.

Der Anfangswert ist Triangles.

Siehe auch primitiveType().

void QQuick3DGeometry::setStride(int stride)

Setzt die Schrittweite des Scheitelpunktpuffers auf stride, gemessen in Bytes. Dies ist der Abstand zwischen zwei aufeinanderfolgenden Scheitelpunkten im Puffer.

Ein dicht gepackter, verschachtelter Scheitelpunktpuffer für eine Geometrie, die PositionSemantic, IndexSemantic und ColorSemantic verwendet, hat zum Beispiel einen Stride von 28 (insgesamt sieben Floats: drei für die Position, vier für die Farbe und keine für die Indizes, die nicht in den Scheitelpunktpuffer gehen).

Siehe auch stride() und addAttribute.

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

Setzt den Morph-Ziel-Puffer data. 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)

Dies ist eine überladene Funktion.

Aktualisiert eine Teilmenge des Morph-Zielpuffers. offset gibt den Offset in Bytes an, data gibt die Größe und die Daten an.

Diese Funktion verändert nicht die Größe des Puffers. Wenn offset + data.size() größer ist als die aktuelle Größe des Puffers, werden die überschießenden Daten ignoriert.

Diese Funktion wurde in Qt 6.6 eingeführt.

void QQuick3DGeometry::setVertexData(const QByteArray &data)

Setzt den Scheitelpunktpuffer data. Der Puffer sollte alle Scheitelpunktdaten enthalten, die im Array gepackt sind, wie in den Attributdefinitionen beschrieben. Beachten Sie, dass dies keine Attribute mit IndexSemantic beinhaltet, die in den Indexpuffer gehören.

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

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

Dies ist eine überladene Funktion.

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

Diese Funktion verändert nicht die Größe des Puffers. Wenn offset + data.size() größer ist als die aktuelle Größe des Puffers, werden die überschießenden Daten ignoriert.

int QQuick3DGeometry::stride() const

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

Siehe auch setStride.

QVector3D QQuick3DGeometry::subsetBoundsMax(int subset) const

Gibt die Anzahl der maximalen Schranken einer subset zurück.

Siehe auch subsetBoundsMin.

QVector3D QQuick3DGeometry::subsetBoundsMin(int subset) const

Gibt die Anzahl der minimalen Grenzen einer 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 Untermengenprimitive 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 subset Offset zum Vertex- oder Indexpuffer zurück.

Siehe auch subsetCount.

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

Gibt die Nummer der Morph-Zielattributdefinition zurück index

Die Attributdefinitionen werden 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 Zielpufferdaten zurück, die durch setTargetData gesetzt wurden.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch setTargetData().

QByteArray QQuick3DGeometry::vertexData() const

Gibt die Scheitelpunktpufferdaten zurück, die von setVertexData gesetzt wurden.

Siehe auch setVertexData().