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

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

void QSGGeometry::setDrawingMode(unsigned int mode)

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

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

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

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

インデックスの使用パターンをp に設定します。

デフォルトはAlwaysUploadPattern 。デフォルト以外に設定した場合、ユーザは、インデックス・データを変更した後にQSGNode::markDirty() を呼び出すだけでなく、QSGNode::DirtyGeometry を使用して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

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)

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

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