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 索引。

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

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

返回此几何对象中的索引数。

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），且渲染此几何体的渲染器将几何体上载到顶点缓冲对象（VBO）中时，此函数才会生效。

void QSGGeometry::markVertexDataDirty()

标记此几何体中的顶点已更改，必须重新上传。

只有当顶点的使用模式为静态数据（StaticData），且渲染此几何体的渲染器将几何体上载到顶点缓冲对象（VBO）中时，此函数才会生效。

void QSGGeometry::setDrawingMode(unsigned int mode)

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

默认值为QSGGeometry::DrawTriangleStrip 。

另请参阅 drawingMode() 和DrawingMode 。

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

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

默认值为AlwaysUploadPattern 。当设置为默认值以外的其他值时，用户必须在更改索引数据后调用markIndexDataDirty() ，此外还必须使用QSGNode::DirtyGeometry 调用QSGNode::markDirty() 。

另请参阅 indexDataPattern()。

void QSGGeometry::setLineWidth(float width)

将此几何体使用的线宽或点宽设置为width 。该属性仅适用于drawingMode 为DrawLines 或DrawLineStrip 时的线宽。如果支持，也适用于drawingMode 为DrawPoints 时的点尺寸。

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

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

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

默认值为AlwaysUploadPattern 。当设置为默认值以外的其他值时，用户必须在更改顶点数据后调用markVertexDataDirty() ，此外还必须调用QSGNode::markDirty() 和QSGNode::DirtyGeometry 。

另请参见 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

返回此几何对象的顶点数。

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