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

Dokumentation zu Mitgliedsfunktionen

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

Erstellt ein Geometrieobjekt auf der Grundlage von attributes.

Das Objekt reserviert Speicherplatz für die Eckpunkte von „ vertexCount “ basierend auf der kumulierten Größe in „ attributes “ sowie für „ indexCount “.

indexType kann entweder UnsignedShortType oder UnsignedIntType sein. Die Unterstützung für Letzteres hängt von der zur Laufzeit verwendeten Grafik-API-Implementierung ab und ist möglicherweise nicht immer verfügbar.

Geometrieobjekte werden standardmäßig mit „ DrawTriangleStrip “ als Zeichenmodus erstellt.

[virtual noexcept] QSGGeometry::~QSGGeometry()

Löscht das Geometrieobjekt sowie die von ihm zugewiesenen Scheitelpunkt- und Indexdaten.

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

Passen Sie die Größe der Scheitelpunkt- und Indexdaten dieses Geometrieobjekts so an, dass sie zu vertexCount Scheitelpunkten und indexCount Indizes passen, und legen Sie die Anzahl der Scheitelpunkte und Indizes entsprechend fest.

Verwenden Sie „ setVertexCount()“ oder „ setIndexCount()“, um die Anzahl der Scheitelpunkte oder Indizes zu ändern, ohne „allocate()“ erneut aufzurufen.

Die Eckpunkt- und Indexdaten werden nach diesem Aufruf ungültig, und der Aufrufer muss den zugehörigen Geometrie-Knoten durch Aufruf von ` node->markDirty(QSGNode::DirtyGeometry)` als „dirty“ markieren, um sicherzustellen, dass der Renderer die Möglichkeit hat, interne Puffer zu aktualisieren.

Siehe auch ` setVertexCount()` und ` setIndexCount()`.

int QSGGeometry::attributeCount() const

Gibt die Anzahl der Attribute in dem von dieser Geometrie verwendeten Attributsatz zurück.

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

Gibt ein Array mit den Attributen dieser Geometrie zurück. Die Größe des Arrays wird mit ` attributeCount()` angegeben.

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

Hilfsfunktion, die Attribute zurückgibt, die für die farbige 2D-Darstellung einzelner Eckpunkte verwendet werden sollen.

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

Hilfsfunktion, die Attribute zurückgibt, die für die 2D-Flächenfarbe verwendet werden sollen.

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

Hilfsfunktion, die Attribute zurückgibt, die für das texturierte 2D-Zeichnen verwendet werden sollen.

unsigned int QSGGeometry::drawingMode() const

Gibt den Zeichenmodus dieser Geometrie zurück.

Der Standardwert ist „ DrawTriangleStrip “.

Siehe auch ` setDrawingMode()`.

int QSGGeometry::indexCount() const

Gibt die Anzahl der Indizes zurück, die beim Rendern des Geometrieobjekts verarbeitet werden.

Siehe auch ` setIndexCount()`.

void *QSGGeometry::indexData()

Gibt einen Zeiger auf die Rohindexdaten dieses Geometrieobjekts zurück.

Siehe auch „ indexDataAsUShort()“ und „ indexDataAsUInt()“.

const void *QSGGeometry::indexData() const

Gibt einen Zeiger auf die Rohindexdaten dieses Geometrieobjekts zurück.

Siehe auch „ indexDataAsUShort()“ und „ indexDataAsUInt()“.

uint *QSGGeometry::indexDataAsUInt()

Hilfsfunktion zum Abrufen der Indexdaten als veränderbliches Array aus 32-Bit-Ganzzahlen ohne Vorzeichen.

const uint *QSGGeometry::indexDataAsUInt() const

Hilfsfunktion zum Abrufen der Indexdaten als unveränderliches Array aus 32-Bit-Ganzzahlen ohne Vorzeichen.

quint16 *QSGGeometry::indexDataAsUShort()

Hilfsfunktion für den Zugriff auf die Indexdaten als veränderbare Array aus 16-Bit-Ganzzahlen ohne Vorzeichen.

const quint16 *QSGGeometry::indexDataAsUShort() const

Hilfsfunktion zum Abrufen der Indexdaten als unveränderliches Array aus 16-Bit-Ganzzahlen ohne Vorzeichen.

QSGGeometry::DataPattern QSGGeometry::indexDataPattern() const

Gibt das Verwendungsmuster für Indizes in dieser Geometrie zurück. Das Standardmuster lautet „ AlwaysUploadPattern “.

Siehe auch ` setIndexDataPattern()`.

int QSGGeometry::indexType() const

Gibt den für Indizes in diesem Geometrieobjekt verwendeten Primitivtyp zurück.

float QSGGeometry::lineWidth() const

Ruft die aktuelle Linien- oder Punktbreite ab, die für diese Geometrie verwendet werden soll. Diese Eigenschaft gilt nur für die Linienbreite, wenn der Wert von „ drawingMode “ auf „ DrawLines “ oder „ DrawLineStrip “ gesetzt ist. Sofern unterstützt, gilt sie auch für die Punktgröße, wenn der Wert von „ drawingMode “ auf „ DrawPoints “ gesetzt ist.

Der Standardwert ist 1.0

Siehe auch „ setLineWidth()“ und „ drawingMode()“.

void QSGGeometry::markIndexDataDirty()

Beachten Sie, dass sich die Scheitelpunkte dieser Geometrie geändert haben und erneut hochgeladen werden müssen.

Diese Funktion hat nur dann eine Auswirkung, wenn das Verwendungsmuster für Scheitelpunkte „StaticData“ lautet und der Renderer, der diese Geometrie rendert, die Geometrie in Vertex-Buffer-Objekte (VBOs) hochlädt.

void QSGGeometry::markVertexDataDirty()

Beachten Sie, dass sich die Eckpunkte dieser Geometrie geändert haben und erneut hochgeladen werden müssen.

Diese Funktion wirkt sich nur aus, wenn das Verwendungsmuster für Scheitelpunkte „StaticData“ lautet und der Renderer, der diese Geometrie rendert, die Geometrie in Vertex-Buffer-Objekte (VBOs) hochlädt.

void QSGGeometry::setDrawingMode(unsigned int mode)

Legt die „ mode “ fest, die zum Zeichnen dieser Geometrie verwendet werden soll.

Der Standardwert ist ` QSGGeometry::DrawTriangleStrip`.

Siehe auch „ drawingMode()“ und „ DrawingMode “.

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

Legt die Anzahl der Indizes fest, die bei jedem Rendern des Geometrieobjekts verarbeitet werden sollen.

Die Funktion „ count “ wird nicht validiert, und es liegt in der Verantwortung des Benutzers, sicherzustellen, dass nur Werte zwischen Null und der Anzahl der zugewiesenen Indizes angegeben werden.

Vertex- und Indexdaten werden nach diesem Aufruf nicht ungültig gemacht, aber der Aufrufer muss den Geometrie-Knoten durch Aufruf von ` node->markDirty(QSGNode::DirtyGeometry)` als „dirty“ markieren, um sicherzustellen, dass der Renderer die Möglichkeit hat, interne Puffer zu aktualisieren.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch ` indexCount()`.

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

Legt das Verwendungsmuster für Indizes auf „ p “ fest.

Der Standardwert ist „ AlwaysUploadPattern “. Wenn ein anderer Wert als der Standardwert festgelegt wird, muss der Benutzer nach dem Ändern der Indexdaten zusätzlich zum Aufruf von „ QSGNode::markDirty()“ mit „ QSGNode::DirtyGeometry “ auch „ markIndexDataDirty()“ aufrufen.

Siehe auch ` indexDataPattern()`.

void QSGGeometry::setLineWidth(float width)

Legt die für diese Geometrie zu verwendende Linien- oder Punktbreite auf „ width “ fest. Diese Eigenschaft gilt nur für die Linienbreite, wenn der Wert von „ drawingMode “ auf „ DrawLines “ oder „ DrawLineStrip “ gesetzt ist. Sofern unterstützt, gilt sie auch für die Punktgröße, wenn der Wert von „ drawingMode “ auf „ DrawPoints “ gesetzt ist.

Siehe auch „ lineWidth()“ und „ drawingMode()“.

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

Legt die Anzahl der zu rendernden Eckpunkte fest.

Der Parameter „ count “ wird nicht validiert, und es liegt in der Verantwortung des Benutzers, sicherzustellen, dass nur Werte zwischen Null und der Anzahl der zugewiesenen Scheitelpunkte angegeben werden.

Die Scheitelpunktdaten werden nach diesem Aufruf nicht ungültig gemacht, aber der Aufrufer muss den Geometrie-Knoten durch Aufruf von ` node->markDirty(QSGNode::DirtyGeometry)` als „dirty“ markieren, um sicherzustellen, dass der Renderer die Möglichkeit hat, interne Puffer zu aktualisieren.

Diese Funktion wurde in Qt 6.10 eingeführt.

Siehe auch ` vertexCount()`.

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

Legt das Verwendungsmuster für Knoten auf „ p “ fest.

Der Standardwert ist „ AlwaysUploadPattern “. Wenn ein anderer Wert als der Standardwert festgelegt wird, muss der Benutzer nach dem Ändern der Eckpunktdaten zusätzlich zum Aufruf von „ QSGNode::markDirty()“ mit „ QSGNode::DirtyGeometry “ auch „ markVertexDataDirty()“ aufrufen.

Siehe auch ` vertexDataPattern()`.

int QSGGeometry::sizeOfIndex() const

Gibt die Bytegröße des Indextyps zurück.

Dieser Wert ist entweder „ 2 “, wenn der Indextyp „ UnsignedShortType “ ist, oder „ 4 “, wenn der Indextyp „ UnsignedIntType “ ist.

int QSGGeometry::sizeOfVertex() const

Gibt die Größe eines Scheitelpunkts in Byte zurück.

Dieser Wert stammt aus den Attributen.

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

Aktualisiert die Geometrie „ g “ mit den Koordinaten aus „ rect “.

Die Funktion setzt voraus, dass das Geometrieobjekt einen einzelnen Dreiecksstreifen mit den Scheitelpunkten aus QSGGeometry::ColoredPoint2D enthält.

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

Aktualisiert die Geometrie g mit den Koordinaten in rect.

Die Funktion setzt voraus, dass das Geometrieobjekt einen einzelnen Dreiecksstreifen mit den Scheitelpunkten aus QSGGeometry::Point2D enthält.

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

Aktualisiert die Geometrie g mit den Koordinaten aus rect und den Texturkoordinaten aus textureRect.

textureRect sollten in normalisierten Koordinaten vorliegen.

g Es wird angenommen, dass es sich um einen Dreiecksstreifen mit vier Eckpunkten vom Typ QSGGeometry::TexturedPoint2D handelt.

int QSGGeometry::vertexCount() const

Gibt die Anzahl der Knoten zurück, die gerendert werden können, oder – falls Indizes verwendet werden – die Anzahl der Knoten, auf die über Indizes zugegriffen werden kann.

Siehe auch ` setVertexCount()`.

void *QSGGeometry::vertexData()

Gibt einen Zeiger auf die Rohdaten der Eckpunkte dieses Geometrieobjekts zurück.

Siehe auch „ vertexDataAsPoint2D()“ und „ vertexDataAsTexturedPoint2D()“.

const void *QSGGeometry::vertexData() const

Gibt einen Zeiger auf die Rohdaten der Eckpunkte dieses Geometrieobjekts zurück.

Siehe auch „ vertexDataAsPoint2D()“ und „ vertexDataAsTexturedPoint2D()“.

QSGGeometry::ColoredPoint2D *QSGGeometry::vertexDataAsColoredPoint2D()

Hilfsfunktion zum Abrufen der Eckpunktdaten als veränderbare Array-Struktur vom Typ „ QSGGeometry::ColoredPoint2D “.

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

Hilfsfunktion zum Abrufen der Eckpunktdaten als unveränderliches Array vom Typ „ QSGGeometry::ColoredPoint2D “.

QSGGeometry::Point2D *QSGGeometry::vertexDataAsPoint2D()

Hilfsfunktion zum Abrufen der Eckpunktdaten als veränderbare Array-Struktur vom Typ „ QSGGeometry::Point2D “.

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

Hilfsfunktion zum Abrufen der Eckpunktdaten als unveränderliches Array vom Typ „ QSGGeometry::Point2D “.

QSGGeometry::TexturedPoint2D *QSGGeometry::vertexDataAsTexturedPoint2D()

Hilfsfunktion zum Abrufen der Eckpunktdaten als veränderbare Array-Struktur vom Typ „ QSGGeometry::TexturedPoint2D “.

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

Hilfsfunktion zum Abrufen der Eckpunktdaten als unveränderliches Array vom Typ „ QSGGeometry::TexturedPoint2D “.

QSGGeometry::DataPattern QSGGeometry::vertexDataPattern() const

Gibt das Verwendungsmuster für die Eckpunkte dieser Geometrie zurück. Das Standardmuster lautet „ AlwaysUploadPattern “.

Siehe auch „ setVertexDataPattern()“.