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 とindexCount の累積サイズに基づいてvertexCount 頂点用のスペースを確保します。

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

頂点ごとのカラー 2D 描画に使用するアトリビュートを返す便利な関数です。

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

2D ベタ塗り描画に使用する属性を返す便利な関数です。

[static] 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 で、このジオメトリをレンダリングするレンダラーがジオメトリを Vertex Buffer Objects（VBOs）にアップロードする場合にのみ効果があります。

void QSGGeometry::setDrawingMode(unsigned int mode)

このジオメトリの描画に使用するmode を設定します。

デフォルト値はQSGGeometry::DrawTriangleStrip です。

drawingMode() およびDrawingModeも参照してください 。

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()も参照して ください。

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)

ジオメトリg をrect の座標で更新します。

この関数は、ジオメトリ オブジェクトにQSGGeometry::ColoredPoint2D の頂点からなる単一の三角形の帯が含まれていると仮定します。

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

ジオメトリg をrect の座標で更新します。

この関数は、ジオメトリ オブジェクトがQSGGeometry::Point2D の頂点を持つ単一の三角形ストリップを含んでいると仮定します。

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

ジオメトリg をrect の座標とtextureRect のテクスチャ座標で更新します。

textureRect は正規化座標でなければなりません。

g は、 型の 4 つの頂点からなる三角形の帯であると仮定します。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()も参照してください 。