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の実装に依存するため、常に利用可能とは限りません。

Geometry オブジェクトは、デフォルトで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()

頂点ごとの色付けを行う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

ジオメトリオブジェクトのレンダリング時に処理されるインデックスの数を返します。

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」であり、このジオメトリをレンダリングするレンダラーがジオメトリを頂点バッファオブジェクト（VBO）にアップロードする場合にのみ効果を発揮します。

void QSGGeometry::markVertexDataDirty()

このジオメトリの頂点が変更されたため、再度アップロードする必要があることに注意してください。

この関数は、頂点の使用パターンが「StaticData」であり、かつこのジオメトリをレンダリングするレンダラーがジオメトリを頂点バッファオブジェクト（VBO）にアップロードする場合にのみ効果を発揮します。

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

1つの頂点のサイズをバイト単位で返します。

この値は属性から取得されます。

[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 QSGGeometry::TexturedPoint2D 型の4つの頂点からなるトライアングル・ストリップであると仮定します。

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