QSGGeometry Class

struct MyPoint2D {
    float x;
    float y;
    float r;
    float g;
    float b;
    float a;

    void set(float x_, float y_, float r_, float g_, float b_, float a_) {
        x = x_;
        y = y_;
        r = r_;
        g = g_;
        b = b_;
        a = a_;
    }
};

QSGGeometry::Attribute MyPoint2D_Attributes[] = {
    QSGGeometry::Attribute::create(0, 2, FloatType, true),
    QSGGeometry::Attribute::create(1, 4, FloatType, false)
};

QSGGeometry::AttributeSet MyPoint2D_AttributeSet = {
    2,
    sizeof(MyPoint2D),
    MyPoint2D_Attributes
};

...

geometry = new QSGGeometry(MyPoint2D_AttributeSet, 2);
geometry->setDrawingMode(DrawLines);

MyPoint2D *vertices = static_cast<MyPoint2D *>(geometry->vertexData());
vertices[0].set(0, 0, 1, 0, 0, 1);
vertices[1].set(width(), height(), 0, 0, 1, 1);

Documentation sur les fonctions membres

QSGGeometry::QSGGeometry(const QSGGeometry::AttributeSet &attributes, int vertexCount, int indexCount = 0, int indexType = UnsignedShortType)

Crée un objet géométrique à partir de attributes.

L'objet alloue de l'espace pour les sommets de vertexCount en fonction de la taille cumulée dans attributes et pour indexCount.

indexType peut être UnsignedShortType ou UnsignedIntType. La prise en charge de cette dernière dépend de l’implémentation de l’API graphique utilisée lors de l’exécution et peut ne pas toujours être disponible.

Les objets de géométrie sont créés par défaut avec l'DrawTriangleStrip comme mode de dessin.

[virtual noexcept] QSGGeometry::~QSGGeometry()

Supprime l'objet géométrique ainsi que les données de sommets et d'indices qu'il a allouées.

void QSGGeometry::allocate(int vertexCount, int indexCount = 0)

Redimensionne les données de sommets et d'indices de cet objet géométrique pour les adapter à vertexCount sommets et indexCount indices, puis définit le nombre de sommets et d'indices en conséquence.

Utilisez ` setVertexCount()` ou ` setIndexCount()` pour modifier le nombre de sommets ou d’indices sans appeler à nouveau `allocate()`.

Les données de sommets et d’indices seront invalidées après cet appel et l’appelant doit marquer le nœud de géométrie associé comme modifié, en appelant ` node->markDirty(QSGNode::DirtyGeometry)`, afin de garantir que le moteur de rendu ait la possibilité de mettre à jour ses tampons internes.

Voir également setVertexCount() et setIndexCount().

int QSGGeometry::attributeCount() const

Renvoie le nombre d'attributs contenus dans l'ensemble d'attributs utilisé par cette géométrie.

const QSGGeometry::Attribute *QSGGeometry::attributes() const

Renvoie un tableau contenant les attributs de cette géométrie. La taille du tableau est indiquée par la fonction ` attributeCount()`.

[static] const QSGGeometry::AttributeSet &QSGGeometry::defaultAttributes_ColoredPoint2D()

Fonction pratique qui renvoie les attributs à utiliser pour un tracé 2D coloré par sommet.

[static] const QSGGeometry::AttributeSet &QSGGeometry::defaultAttributes_Point2D()

Fonction pratique qui renvoie les attributs à utiliser pour le tracé en couleur unie en 2D.

[static] const QSGGeometry::AttributeSet &QSGGeometry::defaultAttributes_TexturedPoint2D()

Fonction pratique qui renvoie les attributs à utiliser pour le dessin 2D texturé.

unsigned int QSGGeometry::drawingMode() const

Renvoie le mode de dessin de cette géométrie.

La valeur par défaut est ` DrawTriangleStrip`.

Voir aussi setDrawingMode().

int QSGGeometry::indexCount() const

Renvoie le nombre d'indices traités lors du rendu de l'objet géométrique.

Voir également setIndexCount().

void *QSGGeometry::indexData()

Renvoie un pointeur vers les données d'index brutes de cet objet géométrique.

Voir également indexDataAsUShort() et indexDataAsUInt().

const void *QSGGeometry::indexData() const

Renvoie un pointeur vers les données d'index brutes de cet objet géométrique.

Voir également indexDataAsUShort() et indexDataAsUInt().

uint *QSGGeometry::indexDataAsUInt()

Fonction pratique permettant d'accéder aux données d'index sous la forme d'un tableau modifiable d'entiers non signés de 32 bits.

const uint *QSGGeometry::indexDataAsUInt() const

Fonction pratique permettant d'accéder aux données d'index sous la forme d'un tableau immuable d'entiers non signés de 32 bits.

quint16 *QSGGeometry::indexDataAsUShort()

Fonction pratique permettant d'accéder aux données d'index sous la forme d'un tableau modifiable d'entiers non signés de 16 bits.

const quint16 *QSGGeometry::indexDataAsUShort() const

Fonction pratique permettant d'accéder aux données d'index sous la forme d'un tableau immuable d'entiers non signés de 16 bits.

QSGGeometry::DataPattern QSGGeometry::indexDataPattern() const

Renvoie le modèle d'utilisation des indices dans cette géométrie. Le modèle par défaut est AlwaysUploadPattern.

Voir également setIndexDataPattern().

int QSGGeometry::indexType() const

Renvoie le type primitif utilisé pour les indices dans cet objet géométrique.

float QSGGeometry::lineWidth() const

Récupère la largeur actuelle de la ligne ou du point à utiliser pour cette géométrie. Cette propriété ne s'applique à la largeur de ligne que lorsque l'drawingMode est définie sur DrawLines ou DrawLineStrip. Lorsqu'elle est prise en charge, elle s'applique également à la taille du point lorsque l'drawingMode est définie sur DrawPoints.

La valeur par défaut est 1.0

Voir également setLineWidth() et drawingMode().

void QSGGeometry::markIndexDataDirty()

Notez que les sommets de cette géométrie ont changé et doivent être réimportés.

Cette fonction n'a d'effet que lorsque le modèle d'utilisation des sommets est « StaticData » et que le moteur de rendu chargé de rendre cette géométrie la charge dans des objets de tampon de sommets (VBO).

void QSGGeometry::markVertexDataDirty()

Notez que les sommets de cette géométrie ont changé et doivent être réimportés.

Cette fonction n'a d'effet que lorsque le modèle d'utilisation des sommets est « StaticData » et que le moteur de rendu chargé de rendre cette géométrie la charge dans des objets de tampon de sommets (VBO).

void QSGGeometry::setDrawingMode(unsigned int mode)

Définit l'mode à utiliser pour le tracé de cette géométrie.

La valeur par défaut est ` QSGGeometry::DrawTriangleStrip`.

Voir également drawingMode() et DrawingMode.

[since 6.10] void QSGGeometry::setIndexCount(int count)

Définit le nombre d'indices à traiter à chaque rendu de l'objet géométrique.

La fonction ` count ` n'est pas validée et il incombe à l'utilisateur de s'assurer que seules des valeurs comprises entre zéro et le nombre d'indices alloués sont spécifiées.

Les données de sommets et d’indices ne sont pas invalidées après cet appel, mais l’appelant doit marquer le nœud de géométrie comme « sale » (dirty), en appelant ` node->markDirty(QSGNode::DirtyGeometry)`, afin de garantir que le moteur de rendu ait la possibilité de mettre à jour ses tampons internes.

Cette fonction a été introduite dans Qt 6.10.

Voir également indexCount().

void QSGGeometry::setIndexDataPattern(QSGGeometry::DataPattern p)

Définit le modèle d'utilisation des index sur « p ».

La valeur par défaut est ` AlwaysUploadPattern`. Lorsque la valeur définie diffère de la valeur par défaut, l'utilisateur doit appeler la fonction ` markIndexDataDirty()` après avoir modifié les données de l'index, en plus d'appeler la fonction ` QSGNode::markDirty()` avec ` QSGNode::DirtyGeometry`.

Voir également indexDataPattern().

void QSGGeometry::setLineWidth(float width)

Définit la largeur de ligne ou la taille de point à utiliser pour cette géométrie sur width. Cette propriété s'applique uniquement à la largeur de ligne lorsque l'drawingMode est DrawLines ou DrawLineStrip. Lorsqu'elle est prise en charge, elle s'applique également à la taille des points lorsque l'drawingMode est DrawPoints.

Voir également lineWidth() et drawingMode().

[since 6.10] void QSGGeometry::setVertexCount(int count)

Définit le nombre de sommets à afficher.

La fonction ` count ` n'effectue aucune validation ; il incombe à l'utilisateur de s'assurer que seules des valeurs comprises entre zéro et le nombre de sommets alloués sont spécifiées.

Les données de sommets ne sont pas invalidées après cet appel, mais l'appelant doit marquer le nœud de géométrie comme « sale » ( node->markDirty(QSGNode::DirtyGeometry)), afin de garantir que le moteur de rendu ait la possibilité de mettre à jour ses tampons internes.

Cette fonction a été introduite dans Qt 6.10.

Voir également vertexCount().

void QSGGeometry::setVertexDataPattern(QSGGeometry::DataPattern p)

Définit le modèle d'utilisation des sommets sur « p ».

La valeur par défaut est ` AlwaysUploadPattern`. Lorsque la valeur définie diffère de la valeur par défaut, l'utilisateur doit appeler la fonction ` markVertexDataDirty()` après avoir modifié les données des sommets, en plus d'appeler la fonction ` QSGNode::markDirty()` avec ` QSGNode::DirtyGeometry`.

Voir également vertexDataPattern().

int QSGGeometry::sizeOfIndex() const

Renvoie la taille en octets du type d'index.

Cette valeur est soit 2 lorsque le type d'index est UnsignedShortType, soit 4 lorsque le type d'index est UnsignedIntType.

int QSGGeometry::sizeOfVertex() const

Renvoie la taille, en octets, d'un sommet.

Cette valeur provient des attributs.

[static] void QSGGeometry::updateColoredRectGeometry(QSGGeometry *g, const QRectF &rect)

Met à jour l'g de géométrie avec les coordonnées contenues dans rect.

La fonction suppose que l'objet géométrique contient une seule bande de triangles composée de QSGGeometry::ColoredPoint2D sommets

[static] void QSGGeometry::updateRectGeometry(QSGGeometry *g, const QRectF &rect)

Met à jour la géométrie g avec les coordonnées contenues dans rect.

La fonction suppose que l’objet géométrique contient une seule bande triangulaire composée de sommets QSGGeometry::Point2D.

[static] void QSGGeometry::updateTexturedRectGeometry(QSGGeometry *g, const QRectF &rect, const QRectF &textureRect)

Met à jour la géométrie g avec les coordonnées disponibles à l'adresse rect et les coordonnées de texture issues de textureRect.

textureRect Les coordonnées doivent être normalisées.

g On suppose qu’il s’agit d’une bande de triangles composée de quatre sommets de type QSGGeometry::TexturedPoint2D.

int QSGGeometry::vertexCount() const

Renvoie le nombre de sommets pouvant être affichés ou, si des indices sont utilisés, le nombre de sommets accessibles via ces indices.

Voir également setVertexCount().

void *QSGGeometry::vertexData()

Renvoie un pointeur vers les données brutes des sommets de cet objet géométrique.

Voir également vertexDataAsPoint2D() et vertexDataAsTexturedPoint2D().

const void *QSGGeometry::vertexData() const

Renvoie un pointeur vers les données brutes des sommets de cet objet géométrique.

Voir également vertexDataAsPoint2D() et vertexDataAsTexturedPoint2D().

QSGGeometry::ColoredPoint2D *QSGGeometry::vertexDataAsColoredPoint2D()

Fonction pratique permettant d'accéder aux données des sommets sous la forme d'un tableau modifiable de type ` QSGGeometry::ColoredPoint2D`.

const QSGGeometry::ColoredPoint2D *QSGGeometry::vertexDataAsColoredPoint2D() const

Fonction pratique permettant d'accéder aux données des sommets sous la forme d'un tableau immuable de type ` QSGGeometry::ColoredPoint2D`.

QSGGeometry::Point2D *QSGGeometry::vertexDataAsPoint2D()

Fonction pratique permettant d'accéder aux données des sommets sous la forme d'un tableau modifiable de type ` QSGGeometry::Point2D`.

const QSGGeometry::Point2D *QSGGeometry::vertexDataAsPoint2D() const

Fonction pratique permettant d'accéder aux données des sommets sous la forme d'un tableau immuable de type ` QSGGeometry::Point2D`.

QSGGeometry::TexturedPoint2D *QSGGeometry::vertexDataAsTexturedPoint2D()

Fonction pratique permettant d'accéder aux données des sommets sous la forme d'un tableau modifiable de type ` QSGGeometry::TexturedPoint2D`.

const QSGGeometry::TexturedPoint2D *QSGGeometry::vertexDataAsTexturedPoint2D() const

Fonction pratique permettant d'accéder aux données des sommets sous la forme d'un tableau immuable de type QSGGeometry::TexturedPoint2D.

QSGGeometry::DataPattern QSGGeometry::vertexDataPattern() const

Renvoie le modèle d'utilisation des sommets de cette géométrie. Le modèle par défaut est « AlwaysUploadPattern ».

Voir également setVertexDataPattern().