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)

Construit un objet géométrique basé sur attributes.

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

L'adresse 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 au moment de l'exécution et n'est pas toujours disponible.

Les objets géométriques sont construits par défaut avec DrawTriangleStrip comme mode de dessin.

[virtual noexcept] QSGGeometry::~QSGGeometry()

Détruit l'objet géométrique et les données de vertex et d'index qu'il a allouées.

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

Redimensionne les données de vertex et d'index de cet objet géométrique pour qu'elles correspondent aux vertices vertexCount et aux index indexCount et définit le nombre de vertices et d'index en conséquence.

Utilisez setVertexCount() ou setIndexCount() pour modifier le nombre de sommets ou d'index sans appeler à nouveau allocate().

Les données relatives aux sommets et aux index seront invalidées après cet appel et l'appelant doit marquer le nœud géométrique associé comme sale, en appelant node->markDirty(QSGNode::DirtyGeometry), afin de s'assurer que le moteur de rendu a une chance de mettre à jour les tampons internes.

Voir également setVertexCount() et setIndexCount().

int QSGGeometry::attributeCount() const

Renvoie le nombre d'attributs du jeu 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 attributeCount().

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

Fonction de commodité qui renvoie les attributs à utiliser pour le dessin 2D coloré par sommet.

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

Fonction de commodité qui renvoie les attributs à utiliser pour le dessin 2D en aplat de couleur.

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

Fonction de commodité 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 également setDrawingMode().

int QSGGeometry::indexCount() const

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

Voir aussi setIndexCount().

void *QSGGeometry::indexData()

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

Voir aussi indexDataAsUShort() et indexDataAsUInt().

const void *QSGGeometry::indexData() const

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

Voir aussi indexDataAsUShort() et indexDataAsUInt().

uint *QSGGeometry::indexDataAsUInt()

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

const uint *QSGGeometry::indexDataAsUInt() const

Fonction de commodité 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 de commodité permettant d'accéder aux données d'index sous la forme d'un tableau mutable d'entiers non signés de 16 bits.

const quint16 *QSGGeometry::indexDataAsUShort() const

Fonction de commodité 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 aussi setIndexDataPattern().

int QSGGeometry::indexType() const

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

float QSGGeometry::lineWidth() const

Obtient la largeur actuelle de la ligne ou du point à utiliser pour cette géométrie. Cette propriété s'applique uniquement à la largeur de ligne lorsque drawingMode est DrawLines ou DrawLineStrip. Si elle est prise en charge, elle s'applique également à la taille de point lorsque drawingMode est DrawPoints.

La valeur par défaut est 1.0

Voir également setLineWidth() et drawingMode().

void QSGGeometry::markIndexDataDirty()

Indique que les sommets de cette géométrie ont changé et qu'ils doivent être téléchargés à nouveau.

Cette fonction n'a d'effet que lorsque le modèle d'utilisation des sommets est StaticData et que le moteur de rendu qui effectue le rendu de cette géométrie télécharge la géométrie dans des objets tampons de sommets (VBO).

void QSGGeometry::markVertexDataDirty()

Indique que les sommets de cette géométrie ont changé et qu'ils doivent être téléchargés à nouveau.

Cette fonction n'a d'effet que lorsque le modèle d'utilisation des sommets est StaticData et que le moteur de rendu qui effectue le rendu de cette géométrie télécharge la géométrie dans des objets tampons de sommets (VBO).

void QSGGeometry::setDrawingMode(unsigned int mode)

Définit le site mode à utiliser pour dessiner cette géométrie.

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

Voir aussi drawingMode() et DrawingMode.

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

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

L'adresse 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 sommet et d'index ne sont pas invalidées après cet appel, mais l'appelant doit marquer le nœud géométrique comme sale, en appelant node->markDirty(QSGNode::DirtyGeometry), pour s'assurer que le moteur de rendu a une chance de mettre à jour les tampons internes.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi indexCount().

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

Définit le modèle d'utilisation des index à p.

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

Voir également indexDataPattern().

void QSGGeometry::setLineWidth(float width)

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

Voir également lineWidth() et drawingMode().

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

Définit le nombre de vertices à rendre.

L'adresse 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 de vertices alloués sont spécifiées.

Les données des sommets ne sont pas invalidées après cet appel, mais l'appelant doit marquer le nœud géométrique comme sale, en appelant node->markDirty(QSGNode::DirtyGeometry), pour s'assurer que le moteur de rendu a une chance de mettre à jour les tampons internes.

Cette fonction a été introduite dans Qt 6.10.

Voir aussi vertexCount().

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

Définit le modèle d'utilisation des sommets à p.

La valeur par défaut est AlwaysUploadPattern. Si la valeur est différente de la valeur par défaut, l'utilisateur doit appeler markVertexDataDirty() après avoir modifié les données des sommets, en plus d'appeler 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 la géométrie g avec les coordonnées de rect.

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

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

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

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

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

Met à jour la géométrie g avec les coordonnées de rect et les coordonnées de texture de textureRect.

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

g est supposé être un triangle à quatre sommets de type QSGGeometry::TexturedPoint2D.

int QSGGeometry::vertexCount() const

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

Voir aussi setVertexCount().

void *QSGGeometry::vertexData()

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

Voir aussi vertexDataAsPoint2D() et vertexDataAsTexturedPoint2D().

const void *QSGGeometry::vertexData() const

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

Voir aussi vertexDataAsPoint2D() et vertexDataAsTexturedPoint2D().

QSGGeometry::ColoredPoint2D *QSGGeometry::vertexDataAsColoredPoint2D()

Fonction de commodité permettant d'accéder aux données des sommets sous la forme d'un tableau mutable de QSGGeometry::ColoredPoint2D.

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

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

QSGGeometry::Point2D *QSGGeometry::vertexDataAsPoint2D()

Fonction de commodité permettant d'accéder aux données des sommets sous la forme d'un tableau mutable de QSGGeometry::Point2D.

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

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

QSGGeometry::TexturedPoint2D *QSGGeometry::vertexDataAsTexturedPoint2D()

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

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

Fonction de commodité permettant d'accéder aux données des sommets sous la forme d'un tableau immuable de 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 aussi setVertexDataPattern().