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

成员函数文档

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

根据attributes 构建一个几何对象。

该对象会根据attributes 中累积的大小为vertexCount 的顶点分配空间，并为indexCount 分配空间。

indexType 可以是UnsignedShortType 或UnsignedIntType 。对后者的支持取决于运行时使用的图形API实现，并且可能并非总是可用。

几何对象默认以DrawTriangleStrip 作为绘制模式进行构建。

[virtual noexcept] QSGGeometry::~QSGGeometry()

销毁该几何体对象及其已分配的顶点和索引数据。

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

将该几何对象的顶点和索引数据调整大小，使其适应vertexCount 个顶点和indexCount 个索引，并据此设置顶点和索引的数量。

使用setVertexCount() 或setIndexCount() 可在无需再次调用 allocate() 的情况下更改顶点或索引的数量。

此调用后，顶点和索引数据将失效，调用方必须通过调用node->markDirty(QSGNode::DirtyGeometry) 将相关的几何节点标记为“已修改”，以确保渲染器有机会更新内部缓冲区。

另请参阅 setVertexCount() 和setIndexCount()。

int QSGGeometry::attributeCount() const

返回此几何体所使用的属性集中包含的属性数量。

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

返回一个包含该几何体属性的数组。数组的大小由attributeCount() 指定。

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

一个便利函数，用于返回用于按顶点着色的二维绘图所需的属性。

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

一个便捷函数，用于返回用于绘制二维纯色图形的属性。

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

一个便捷函数，用于返回用于带纹理的二维绘图的属性。

unsigned int QSGGeometry::drawingMode() const

返回该几何体的绘制模式。

默认值为DrawTriangleStrip 。

另请参阅 setDrawingMode()。

int QSGGeometry::indexCount() const

返回在渲染几何体对象时处理的索引数量。

另请参阅 setIndexCount()。

void *QSGGeometry::indexData()

返回指向该几何对象原始索引数据的指针。

另请参见 indexDataAsUShort() 和indexDataAsUInt()。

const void *QSGGeometry::indexData() const

返回指向该几何体对象原始索引数据的指针。

另请参阅 indexDataAsUShort() 和indexDataAsUInt()。

uint *QSGGeometry::indexDataAsUInt()

一种便捷函数，用于将索引数据作为由 32 位无符号整数组成的可变数组进行访问。

const uint *QSGGeometry::indexDataAsUInt() const

一种便捷函数，用于将索引数据作为由 32 位无符号整数组成的不可变数组进行访问。

quint16 *QSGGeometry::indexDataAsUShort()

一种便捷函数，用于将索引数据作为由 16 位无符号整数组成的可变数组进行访问。

const quint16 *QSGGeometry::indexDataAsUShort() const

一种便捷函数，用于将索引数据作为由 16 位无符号整数组成的不可变数组进行访问。

QSGGeometry::DataPattern QSGGeometry::indexDataPattern() const

返回该几何体中索引的使用模式。默认模式为AlwaysUploadPattern 。

另请参阅 setIndexDataPattern()。

int QSGGeometry::indexType() const

返回此几何体对象中用于索引的原始类型。

float QSGGeometry::lineWidth() const

获取当前线宽或点大小，或用于该几何体的线宽或点大小。当drawingMode 设置为DrawLines 或DrawLineStrip 时，此属性仅适用于线宽。在受支持的情况下，当drawingMode 设置为DrawPoints 时，此属性也适用于点大小。

默认值为1.0

另请参阅 setLineWidth() 和drawingMode()。

void QSGGeometry::markIndexDataDirty()

标记该几何体的顶点已发生变化，必须重新上传。

此函数仅在顶点的使用模式为 StaticData 且渲染该几何体的渲染器将该几何体上传到顶点缓冲对象 (VBOs) 时才生效。

void QSGGeometry::markVertexDataDirty()

标记该几何体的顶点已发生变化，必须重新上传。

此函数仅在顶点的使用模式为 StaticData 且渲染该几何体的渲染器将几何体上传至顶点缓冲对象 (VBOs) 时才生效。

void QSGGeometry::setDrawingMode(unsigned int mode)

设置用于绘制此几何体的mode 。

默认值为QSGGeometry::DrawTriangleStrip 。

另请参阅 drawingMode() 和DrawingMode 。

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

设置每次渲染几何体对象时要处理的索引数量。

count 不会经过有效性验证，用户有责任确保仅指定 0 到已分配索引数量之间的值。

调用此函数后，顶点和索引数据不会被置为无效，但调用方必须通过调用 `node->markDirty(QSGNode::DirtyGeometry)` 将几何节点标记为“已修改”，以确保渲染器有机会更新内部缓冲区。

该函数在 Qt 6.10 中引入。

另请参阅 indexCount()。

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

将索引的使用模式设置为p 。

默认值为AlwaysUploadPattern 。当设置为默认值以外的任何值时，用户在修改索引数据后，除了需使用QSGNode::DirtyGeometry 调用QSGNode::markDirty()外，还必须调用markIndexDataDirty()。

另请参阅 indexDataPattern()。

void QSGGeometry::setLineWidth(float width)

将此几何体使用的线宽或点宽设置为width 。当drawingMode 为DrawLines 或DrawLineStrip 时，此属性仅适用于线宽。在受支持的情况下，当drawingMode 为DrawPoints 时，此属性也适用于点大小。

另请参阅 lineWidth() 和drawingMode()。

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

设置要渲染的顶点数量。

count 参数不会经过有效性验证，用户有责任确保指定的值仅在 0 到已分配顶点数之间。

调用此函数后，顶点数据不会被置为无效，但调用方必须通过调用 `node->markDirty(QSGNode::DirtyGeometry)` 将几何节点标记为“已修改”，以确保渲染器有机会更新内部缓冲区。

该函数在 Qt 6.10 中引入。

另请参阅 vertexCount()。

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

将顶点的使用模式设置为p 。

默认值为AlwaysUploadPattern 。当设置为默认值以外的任何值时，用户在修改顶点数据后，除了必须调用带有QSGNode::DirtyGeometry 参数的QSGNode::markDirty()外，还必须调用markVertexDataDirty()。

另请参阅 vertexDataPattern()。

int QSGGeometry::sizeOfIndex() const

返回索引类型的字节大小。

当索引类型为 `UnsignedShortType` 时，该值为 `2 `；当索引类型为 `UnsignedIntType` 时，该值为 `4 `。

int QSGGeometry::sizeOfVertex() const

返回一个顶点的字节大小。

该值来自属性。

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

使用rect 中的坐标更新几何体g 。

该函数假设几何体对象包含一个由QSGGeometry::ColoredPoint2D 个顶点组成的三角带。

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

使用rect 中的坐标更新几何体g 。

该函数假设几何体对象包含一个由QSGGeometry::Point2D 个顶点组成的单个三角带

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

使用rect 中的坐标以及textureRect 中的纹理坐标，更新几何体g 。

textureRect 应为归一化坐标。

g 假设其为由四个类型为QSGGeometry::TexturedPoint2D 的顶点组成的三角带。

int QSGGeometry::vertexCount() const

返回可渲染的顶点数量；如果使用了索引，则返回可通过索引访问的顶点数量。

另请参阅 setVertexCount()。

void *QSGGeometry::vertexData()

返回指向该几何体对象原始顶点数据的指针。

另请参阅 vertexDataAsPoint2D() 和vertexDataAsTexturedPoint2D()。

const void *QSGGeometry::vertexData() const

返回指向该几何体对象原始顶点数据的指针。

另请参阅 vertexDataAsPoint2D() 和vertexDataAsTexturedPoint2D()。

QSGGeometry::ColoredPoint2D *QSGGeometry::vertexDataAsColoredPoint2D()

一个便捷函数，用于将顶点数据作为QSGGeometry::ColoredPoint2D 的可变数组进行访问。

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

一个便捷函数，用于将顶点数据作为不可变的QSGGeometry::ColoredPoint2D 数组进行访问。

QSGGeometry::Point2D *QSGGeometry::vertexDataAsPoint2D()

一个便捷函数，用于将顶点数据作为QSGGeometry::Point2D 的可变数组进行访问。

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

一个便捷函数，用于将顶点数据作为QSGGeometry::Point2D 的不可变数组进行访问。

QSGGeometry::TexturedPoint2D *QSGGeometry::vertexDataAsTexturedPoint2D()

一个便捷函数，用于将顶点数据作为QSGGeometry::TexturedPoint2D 的可变数组进行访问。

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

一个便捷函数，用于将顶点数据作为QSGGeometry::TexturedPoint2D 的不可变数组进行访问。

QSGGeometry::DataPattern QSGGeometry::vertexDataPattern() const

返回该几何体中顶点的使用模式。默认模式为AlwaysUploadPattern 。

另请参阅 setVertexDataPattern()。