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)

Ajout d'une description des attributs des sommets. Chaque attribut a un semantic, qui spécifie l'utilisation de l'attribut et le nombre de composants qu'il possède, un offset du début au sommet jusqu'à l'emplacement de l'attribut à l'intérieur d'un sommet et un componentType spécifiant le type de données et la taille de l'attribut.

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

En outre, semantic peut être IndexSemantic. Dans ce cas, l'attribut ne représente pas une entrée dans le tampon de vertex, mais décrit plutôt les données d'index dans le tampon d'index. Étant donné qu'il n'y a toujours qu'un seul index par sommet, offset n'a aucun 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 une description de l'attribut de sommet. Chaque attribut possède une sémantique, qui spécifie l'utilisation de l'attribut et le nombre de composants qu'il possède, un décalage entre le début du sommet et l'emplacement de l'attribut à l'intérieur du sommet, ainsi qu'un componentType spécifiant 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 des parties de la géométrie avec des matériaux différents. Les matériaux sont spécifiés dans model.

Si la géométrie dispose d'un tampon d'index, les valeurs offset et count sont le décalage de la primitive et le nombre d'index dans le sous-ensemble. Si la géométrie ne dispose que d'un tampon de sommets, le décalage est le décalage de sommets et le nombre est le nombre de sommets dans le sous-ensemble.

Les limites boundsMin et boundsMax doivent entourer le sous-ensemble comme les limites de la géométrie. Le sous-ensemble peut également avoir un name.

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

Ajoute la description de l'attribut cible morph. Chaque attribut a un targetId auquel l'attribut appartient, un semantic, qui spécifie l'utilisation de l'attribut et le nombre de composants qu'il a, un offset du début au sommet jusqu'à l'emplacement de l'attribut à l'intérieur d'un sommet, et un stride qui est une taille d'octet entre les éléments.

Cette fonction a été introduite dans Qt 6.6.

Voir aussi addAttribute.

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

Ajoute la description d'un attribut cible de morphologie. Chaque attribut a un targetId auquel l'attribut appartient, une sémantique, qui spécifie l'utilisation de l'attribut et le nombre de composants qu'il a, un décalage entre le début du sommet et l'emplacement de l'attribut à l'intérieur d'un sommet, et un stride qui est une taille d'octet 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 la 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 aussi attribute.

QVector3D QQuick3DGeometry::boundsMax() const

Renvoie la coordonnée maximale du volume délimité.

Voir aussi setBounds.

QVector3D QQuick3DGeometry::boundsMin() const

Renvoie la coordonnée minimale du volume délimité.

Voir aussi setBounds.

void QQuick3DGeometry::clear()

Réinitialise la géométrie à son état initial, en effaçant les données de vertex et d'index ainsi que les attributs précédemment définis.

QByteArray QQuick3DGeometry::indexData() const

Renvoie les données du tampon d'index.

Voir aussi setIndexData().

QQuick3DGeometry::PrimitiveType QQuick3DGeometry::primitiveType() const

Renvoie le type de primitive utilisé lors du rendu. La valeur par défaut est Triangles.

Voir aussi setPrimitiveType.

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

Définit le volume délimité de la géométrie au cube défini par les points min et max. Ceci est utilisé pour picking.

void QQuick3DGeometry::setIndexData(const QByteArray &data)

Définit le tampon d'index à data. Pour utiliser le dessin indexé, ajoutez un attribut avec la mention 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, data spécifie la taille et les données.

Cette fonction ne redimensionne pas la mémoire tampon. Si offset + data.size() est supérieur à la taille actuelle du tampon, les données en dépassement seront ignorées.

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

Définit le type de primitive utilisé pour le rendu à type.

La valeur initiale est Triangles.

Voir également primitiveType().

void QQuick3DGeometry::setStride(int stride)

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

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

Voir aussi stride() et addAttribute.

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

Définit le tampon de la cible morphologique data. Le tampon doit contenir toutes les données de la cible morph.

Cette fonction a été introduite dans Qt 6.6.

Voir aussi targetData() et addTargetAttribute.

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

Met à jour un sous-ensemble du tampon cible morph. offset spécifie le décalage en octets, 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 en dépassement seront ignorées.

Cette fonction a été introduite dans Qt 6.6.

void QQuick3DGeometry::setVertexData(const QByteArray &data)

Définit la mémoire tampon des vertex data. Le tampon doit contenir toutes les données de vertex emballées dans le tableau, comme décrit par les définitions d'attributs. Notez que cela n'inclut pas les attributs avec IndexSemantic, qui appartiennent au tampon d'index.

Voir aussi vertexData(), addAttribute, setStride, et setIndexData.

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

Met à jour un sous-ensemble de la mémoire tampon des vertex. offset spécifie le décalage en octets, data spécifie la taille et les données.

Cette fonction ne redimensionne pas la mémoire tampon. Si offset + data.size() est supérieur à la taille actuelle de la mémoire tampon, les données en dépassement seront ignorées.

int QQuick3DGeometry::stride() const

Renvoie le nombre d'octets du tampon de vertex.

Voir aussi setStride.

QVector3D QQuick3DGeometry::subsetBoundsMax(int subset) const

Renvoie le nombre de bornes maximales d'une subset.

Voir aussi subsetBoundsMin.

QVector3D QQuick3DGeometry::subsetBoundsMin(int subset) const

Renvoie le nombre de bornes minimales d'un 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 aussi subsetOffset.

QString QQuick3DGeometry::subsetName(int subset) const

Renvoie le nom de subset.

int QQuick3DGeometry::subsetOffset(int subset) const

Renvoie le décalage subset vers le tampon de vertex ou d'index.

Voir aussi subsetCount.

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

Renvoie le numéro de la définition de l'attribut cible morph 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 cibles morph 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 aussi setTargetData().

QByteArray QQuick3DGeometry::vertexData() const

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

Voir aussi setVertexData().