QSGGeometry 类

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作为绘制模式。

[虚拟"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()给出。

[静态] const QSGGeometry::AttributeSet &QSGGeometry::defaultAttributes_ColoredPoint2D()

返回用于逐顶点着色2D绘制的属性。

[静态] const QSGGeometry::AttributeSet &QSGGeometry::defaultAttributes_Point2D()

返回用于2D实心色绘制的属性。

[静态] const QSGGeometry::AttributeSet &QSGGeometry::defaultAttributes_TexturedPoint2D()

返回用于纹理化2D绘制的属性。

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::markDirty()并传入QSGNode::DirtyGeometry。

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

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

此值来自属性。

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

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

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

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

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

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

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

使用矩形的坐标和纹理坐标从 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。