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);
}

Documentation des fonctions membres

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

Ajoute la description d'un attribut de sommet. Chaque attribut comporte une « semantic » (définition de l'attribut), qui précise l'utilisation de l'attribut et le nombre de composants qu'il comporte, une « offset » (définition de la position de l'attribut) indiquant le chemin depuis le début jusqu'au sommet et l'emplacement de l'attribut à l'intérieur d'un sommet, ainsi qu'une « componentType » (définition de la structure de l'attribut) précisant le type de données et la taille de l'attribut.

La sémantique peut être l'une des suivantes :

De plus, l’attribut « semantic » peut prendre la valeur « IndexSemantic ». Dans ce cas, l’attribut ne représente pas une entrée dans le tampon de sommets, mais décrit plutôt les données d’index dans le tampon d’index. Comme il n’y a toujours qu’un seul index par sommet, l’attribut « offset » n’a pas de sens pour le tampon d’index et doit être laissé à zéro.

Le type de composant peut être l’un des suivants :

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

Ajoute la description d'un attribut de sommet. Chaque attribut possède une sémantique, qui précise son utilisation et le nombre de composants qu'il comporte, un décalage entre le début du sommet et l'emplacement de l'attribut à l'intérieur de celui-ci, ainsi qu'un « componentType » indiquant le type de données et la taille de l'attribut.

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

Ajoute un nouveau sous-ensemble à la géométrie. Les sous-ensembles permettent de rendre certaines parties de la géométrie avec des matériaux différents. Les matériaux sont spécifiés dans les fichiers model.

Si la géométrie dispose d’un tampon d’index, alors les paramètres ` offset ` et ` count ` correspondent respectivement au décalage de la primitive et au nombre d’index dans le sous-ensemble. Si la géométrie ne dispose que d’un tampon de sommets, le décalage correspond au décalage des sommets et le nombre d’index correspond au nombre de sommets dans le sous-ensemble.

Les limites boundsMin et boundsMax doivent englober le sous-ensemble, tout comme les limites de la géométrie. Le sous-ensemble peut également disposer d’une name.

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

Ajoute la description de l'attribut de cible de morphing. Chaque attribut comporte une « targetId » (cible de morphing) à laquelle il appartient, une « semantic » (définition de l'attribut) qui précise l'utilisation de l'attribut et le nombre de composants qu'il comporte, une « offset » (distance de l'attribut) allant du début au sommet jusqu'à l'emplacement de l'attribut à l'intérieur d'un sommet, ainsi qu'une « stride » (espacement) qui correspond à la taille en octets entre les éléments.

Cette fonction a été introduite dans Qt 6.6.

Voir également addAttribute.

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

Ajoute la description des attributs de cible de morphing. Chaque attribut possède un `targetId` auquel il appartient, une `semantic` qui précise son utilisation et le nombre de composants qu’il comporte, un `offset` indiquant la distance entre le début du sommet et l’emplacement de l’attribut à l’intérieur de ce sommet, ainsi qu’un `stride` correspondant à la taille en octets entre les éléments.

Cette fonction a été introduite dans Qt 6.6.

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

Renvoie le numéro de définition de l'attribut index

Les définitions d'attributs sont numérotées de 0 à attributeCount() - 1

int QQuick3DGeometry::attributeCount() const

Renvoie le nombre d'attributs définis pour cette géométrie.

Voir également attribute.

QVector3D QQuick3DGeometry::boundsMax() const

Renvoie la coordonnée maximale du volume englobant.

Voir aussi setBounds.

QVector3D QQuick3DGeometry::boundsMin() const

Renvoie la coordonnée minimale du volume englobant.

Voir également setBounds.

void QQuick3DGeometry::clear()

Rétablit la géométrie dans son état initial, en effaçant les données de sommets et d'indices précédemment définies, ainsi que les attributs.

QByteArray QQuick3DGeometry::indexData() const

Renvoie les données du tampon d'index.

Voir également setIndexData().

QQuick3DGeometry::PrimitiveType QQuick3DGeometry::primitiveType() const

Renvoie le type primitif utilisé lors du rendu. La valeur par défaut est « Triangles ».

Voir également setPrimitiveType.

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

Définit le volume englobant de la géométrie comme étant le cube défini par les points min et max. Cette fonction est utilisée pour la commande « picking ».

void QQuick3DGeometry::setIndexData(const QByteArray &data)

Définit le tampon d'index sur data. Pour utiliser le dessin indexé, ajoutez un attribut avec IndexSemantic

Voir également indexData() et addAttribute.

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

Met à jour un sous-ensemble du tampon d’index. ` offset ` spécifie le décalage en octets, tandis que ` data ` spécifie la taille et les données.

Cette fonction ne redimensionne pas le tampon. Si offset + data.size() est supérieur à la taille actuelle du tampon, les données excédentaires seront ignorées.

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

Définit le type primitif utilisé pour le rendu sur « type ».

La valeur initiale est Triangles.

Voir également primitiveType().

void QQuick3DGeometry::setStride(int stride)

Définit la taille de pas du tampon de sommets à stride, exprimée en octets. Il s'agit de la distance entre deux sommets consécutifs dans le tampon.

Par exemple, un tampon de sommets étroitement compacté et entrelacé pour une géométrie utilisant PositionSemantic, IndexSemantic et ColorSemantic aura un pas de 28 (sept flottants au total : trois pour la position, quatre pour la couleur et aucun pour les index, qui ne figurent pas dans le tampon de sommets).

Voir également stride() et addAttribute.

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

Définit la mémoire tampon de la cible de morphing data. Cette mémoire tampon doit contenir toutes les données de la cible de morphing.

Cette fonction a été introduite dans Qt 6.6.

Voir également targetData() et addTargetAttribute.

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

Met à jour un sous-ensemble du tampon de cible de morphing. ` offset ` spécifie le décalage en octets, tandis que ` data ` spécifie la taille et les données.

Cette fonction ne redimensionne pas le tampon. Si offset + data.size() est supérieure à la taille actuelle du tampon, les données excédentaires seront ignorées.

Cette fonction a été introduite dans Qt 6.6.

void QQuick3DGeometry::setVertexData(const QByteArray &data)

Définit le tampon de sommets data. Ce tampon doit contenir toutes les données de sommets regroupées dans le tableau, conformément aux définitions des attributs. Notez que cela n'inclut pas les attributs avec l'IndexSemantic, qui doivent figurer dans le tampon d'index.

Voir également vertexData(), addAttribute, setStride et setIndexData.

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

Met à jour un sous-ensemble du tampon de sommets. ` offset ` spécifie le décalage en octets, tandis que ` data ` spécifie la taille et les données.

Cette fonction ne redimensionne pas le tampon. Si offset + data.size() est supérieure à la taille actuelle du tampon, les données excédentaires seront ignorées.

int QQuick3DGeometry::stride() const

Renvoie la longueur en octets du tampon de sommets.

Voir également setStride.

QVector3D QQuick3DGeometry::subsetBoundsMax(int subset) const

Renvoie le nombre maximal de limites d'un objet de type ` subset`.

Voir aussi subsetBoundsMin.

QVector3D QQuick3DGeometry::subsetBoundsMin(int subset) const

Renvoie le nombre de limites minimales d'un objet de type ` subset`.

Voir aussi subsetBoundsMax.

int QQuick3DGeometry::subsetCount() const

Renvoie le nombre de sous-ensembles.

int QQuick3DGeometry::subsetCount(int subset) const

Renvoie le nombre de primitives du sous-ensemble.

Voir également subsetOffset.

QString QQuick3DGeometry::subsetName(int subset) const

Renvoie le nom de l'subset.

int QQuick3DGeometry::subsetOffset(int subset) const

Renvoie l'offset de l'subset e vers le tampon de sommets ou d'indices.

Voir aussi subsetCount.

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

Renvoie le numéro de définition de l'attribut « morph target » index

Les définitions d'attributs sont numérotées de 0 à attributeCount() - 1

Cette fonction a été introduite dans Qt 6.6.

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

Renvoie le nombre d'attributs de cible de morphing définis pour cette géométrie.

Cette fonction a été introduite dans Qt 6.6.

Voir aussi targetAttribute.

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

Renvoie les données du tampon cible définies par ` setTargetData`.

Cette fonction a été introduite dans Qt 6.6.

Voir également ` setTargetData()`.

QByteArray QQuick3DGeometry::vertexData() const

Renvoie les données du tampon de sommets définies par ` setVertexData`.

Voir également setVertexData().