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

Member Function Dokumentation

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

Konstruiert ein Geometrieobjekt auf der Grundlage von attributes.

Das Objekt weist Platz für vertexCount Scheitelpunkte zu, basierend auf der kumulierten Größe in attributes und für indexCount.

indexType kann 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()

Zerstört das Geometrieobjekt und die ihm zugewiesenen Scheitelpunkt- und Indexdaten.

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

Ändert die Größe der Scheitelpunkt- und Indexdaten dieses Geometrieobjekts, damit sie in die vertexCount Scheitelpunkte und indexCount Indizes passen.

Scheitelpunkt- und Indexdaten werden nach diesem Aufruf ungültig, und der Aufrufer muß den zugehörigen Geometrieknoten als schmutzig markieren, indem er node->markDirty(QSGNode::DirtyGeometry) aufruft, um sicherzustellen, daß der Renderer die Möglichkeit hat, die internen Puffer zu aktualisieren.

int QSGGeometry::attributeCount() const

Gibt die Anzahl der Attribute im Attributsatz zurück, die von dieser Geometrie verwendet werden.

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

Convenience-Funktion, die Attribute zurückgibt, die für farbige 2D-Zeichnungen pro Scheitelpunkt verwendet werden können.

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

Convenience-Funktion, die Attribute zurückgibt, die für das Zeichnen von 2D-Volltonfarben verwendet werden können.

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

Convenience-Funktion, die Attribute zurückgibt, die für texturierte 2D-Zeichnungen verwendet werden können.

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 in diesem Geometrieobjekt zurück.

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

Convenience-Funktion für den Zugriff auf die Indexdaten als veränderbares Array von 32-Bit-Ganzzahlen ohne Vorzeichen.

const uint *QSGGeometry::indexDataAsUInt() const

Convenience-Funktion für den Zugriff auf die Indexdaten als unveränderliches Array von 32-Bit-Ganzzahlen ohne Vorzeichen.

quint16 *QSGGeometry::indexDataAsUShort()

Convenience-Funktion für den Zugriff auf die Indexdaten als veränderbares Array von 16-Bit-Ganzzahlen ohne Vorzeichen.

const quint16 *QSGGeometry::indexDataAsUShort() const

Convenience-Funktion für den Zugriff auf die Indexdaten als unveränderliches Array von 16-Bit-Ganzzahlen ohne Vorzeichen.

QSGGeometry::DataPattern QSGGeometry::indexDataPattern() const

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

Siehe auch setIndexDataPattern().

int QSGGeometry::indexType() const

Gibt den primitiven Typ zurück, der für Indizes in diesem Geometrieobjekt verwendet wird.

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 drawingMode DrawLines oder DrawLineStrip ist. Wenn unterstützt, gilt sie auch für die Punktgröße, wenn drawingMode DrawPoints ist.

Der Standardwert ist 1.0

Siehe auch setLineWidth() und drawingMode().

void QSGGeometry::markIndexDataDirty()

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

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

void QSGGeometry::markVertexDataDirty()

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

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

void QSGGeometry::setDrawingMode(unsigned int mode)

Legt die mode fest, die für das Zeichnen dieser Geometrie verwendet werden soll.

Der Standardwert ist QSGGeometry::DrawTriangleStrip.

Siehe auch drawingMode() und DrawingMode.

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

Legt das Verwendungsmuster für Indizes auf p fest.

Die Standardeinstellung ist AlwaysUploadPattern. Wenn eine andere Einstellung als die Standardeinstellung gewählt wird, muss der Benutzer nach dem Ändern der Indexdaten zusätzlich zum Aufruf von QSGNode::markDirty() mit QSGNode::DirtyGeometry 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 drawingMode DrawLines oder DrawLineStrip ist. Wenn unterstützt, gilt sie auch für die Punktgröße, wenn drawingMode DrawPoints ist.

Siehe auch lineWidth() und drawingMode().

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

Setzt das Verwendungsmuster für Scheitelpunkte auf p.

Die Standardeinstellung ist AlwaysUploadPattern. Wenn eine andere Einstellung als die Standardeinstellung gewählt wird, muss der Benutzer nach dem Ändern der Scheitelpunktdaten markVertexDataDirty() aufrufen, zusätzlich zum Aufruf von QSGNode::markDirty() mit QSGNode::DirtyGeometry.

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 Bytes zurück.

Dieser Wert stammt aus den Attributen.

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

Aktualisiert die Geometrie g mit den Koordinaten in rect.

Die Funktion geht davon aus, dass das Geometrieobjekt einen einzelnen Dreiecksstreifen mit QSGGeometry::ColoredPoint2D Scheitelpunkten enthält

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

Aktualisiert die Geometrie g mit den Koordinaten in rect.

Die Funktion geht davon aus, dass das Geometrieobjekt einen einzelnen Dreiecksstreifen mit QSGGeometry::Point2D Scheitelpunkten enthält

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

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

textureRect sollte in normalisierten Koordinaten vorliegen.

g wird als Dreiecksstreifen mit vier Scheitelpunkten des Typs QSGGeometry::TexturedPoint2D angenommen.

int QSGGeometry::vertexCount() const

Gibt die Anzahl der Scheitelpunkte in diesem Geometrieobjekt zurück.

void *QSGGeometry::vertexData()

Gibt einen Zeiger auf die rohen Scheitelpunktdaten dieses Geometrieobjekts zurück.

Siehe auch vertexDataAsPoint2D() und vertexDataAsTexturedPoint2D().

const void *QSGGeometry::vertexData() const

Gibt einen Zeiger auf die rohen Scheitelpunktdaten dieses Geometrieobjekts zurück.

Siehe auch vertexDataAsPoint2D() und vertexDataAsTexturedPoint2D().

QSGGeometry::ColoredPoint2D *QSGGeometry::vertexDataAsColoredPoint2D()

Convenience-Funktion für den Zugriff auf die Vertex-Daten als veränderbares Array von QSGGeometry::ColoredPoint2D.

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

Convenience-Funktion zum Zugriff auf die Scheitelpunktdaten als unveränderliches Array von QSGGeometry::ColoredPoint2D.

QSGGeometry::Point2D *QSGGeometry::vertexDataAsPoint2D()

Convenience-Funktion für den Zugriff auf die Scheitelpunktdaten als veränderbares Array von QSGGeometry::Point2D.

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

Convenience-Funktion zum Zugriff auf die Scheitelpunktdaten als unveränderliches Array von QSGGeometry::Point2D.

QSGGeometry::TexturedPoint2D *QSGGeometry::vertexDataAsTexturedPoint2D()

Convenience-Funktion für den Zugriff auf die Scheitelpunktdaten als veränderbares Array von QSGGeometry::TexturedPoint2D.

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

Convenience-Funktion zum Zugriff auf die Scheitelpunktdaten als unveränderliches Array von QSGGeometry::TexturedPoint2D.

QSGGeometry::DataPattern QSGGeometry::vertexDataPattern() const

Gibt das Verwendungsmuster für Scheitelpunkte in dieser Geometrie zurück. Das Standardmuster ist AlwaysUploadPattern.

Siehe auch setVertexDataPattern().