QSGMaterialShader Class

メンバ関数のドキュメント

QSGMaterialShader::QSGMaterialShader()

新しい QSGMaterialShader を作成します。

[since 6.4] int QSGMaterialShader::combinedImageSamplerCount(int binding) const

binding にある結合済み画像サンプラー変数の要素数を返します。この値は、シェーダーコードからイントロスペクションによって取得されます。この変数は配列である場合があり、多次元である場合もあります。

このカウント値は、変数内の結合された画像サンプラー項目の総数を反映します。以下の例では、srcA のカウントは1、srcB は4、srcC は6となります。

layout (binding = 0) uniform sampler2D srcA;
layout (binding = 1) uniform sampler2D srcB[4];
layout (binding = 2) uniform sampler2D srcC[2][3];

このカウント値は、QSGMaterialShader::updateSampledImage のtextureパラメータに含まれるQSGTexture ポインタの数です。

この関数は Qt 6.4 で導入されました。

「QSGMaterialShader::updateSampledImage」も参照してください 。

QSGMaterialShader::Flags QSGMaterialShader::flags() const

このマテリアルシェーダーに対して現在設定されているフラグを返します。

setFlags()も参照してください 。

void QSGMaterialShader::setFlag(QSGMaterialShader::Flags flags, bool on = true)

on がtrueの場合、このマテリアルシェーダーのflags を設定します。それ以外の場合は、指定されたフラグをクリアします。

void QSGMaterialShader::setFlags(QSGMaterialShader::Flags flags)

このマテリアルシェーダーのflags を設定します。

「flags()」も参照してください 。

[protected] void QSGMaterialShader::setShader(QSGMaterialShader::Stage stage, const QShader &shader)

指定されたstage に対して、shader を設定します。

[protected] void QSGMaterialShader::setShaderFileName(QSGMaterialShader::Stage stage, const QString &filename)

指定されたstage に対するシェーダーのfilename を設定します。

このファイルには、シリアル化されたQShader が含まれていることが想定されます。

[protected, since 6.8] void QSGMaterialShader::setShaderFileName(QSGMaterialShader::Stage stage, const QString &filename, int viewCount)

指定されたstage のシェーダーに対して、filename を設定します。

このファイルには、シリアライズされたQShader が含まれていることが想定されます。

このオーバーロードは、multiview レンダリングを有効にする場合、特にビルドシステムの MULTIVIEW 便利オプションが使用される場合に使用されます。

viewCount は 2、3、または 4 である必要があります。filename はこれに基づいて自動的に調整されます。

この関数は Qt 6.8 で導入されました。

[virtual] bool QSGMaterialShader::updateGraphicsPipelineState(QSGMaterialShader::RenderState &state, QSGMaterialShader::GraphicsPipelineState *ps, QSGMaterial *newMaterial, QSGMaterial *oldMaterial)

この関数は、シーングラフによって呼び出され、マテリアルがカスタムなグラフィックス状態のセットを提供できるようにします。マテリアルごとにカスタマイズ可能な状態のセットは、ブレンディングおよび関連する設定に限定されます。

ps のメンバーのいずれかに変更が加えられた場合は、戻り値は必ずtrue でなければなりません。

現在のレンダリング用 `state ` は、シーングラフから渡されます。

サブクラス固有の状態は、newMaterial から抽出できます。oldMaterial が null の場合、このシェーダーはアクティブになったばかりです。

[virtual] void QSGMaterialShader::updateSampledImage(QSGMaterialShader::RenderState &state, int binding, QSGTexture **texture, QSGMaterial *newMaterial, QSGMaterial *oldMaterial)

この関数は、シーングラフによって呼び出され、シェーダー内でのサンプリング済み画像（通常は複合画像サンプラーの形式）の使用準備を行います。

binding は、サンプラーのバインディング番号です。この関数は、QSGMaterialShader に関連付けられたシェーダーコード内の各複合画像サンプラー変数に対して呼び出されます。

texture は、QSGTexture ポインタの配列です。この配列の要素数は、シェーダーコードで指定された画像サンプラー変数の要素数と一致します。この変数は配列である場合があり、多次元である場合もあります。配列の要素数は、次のようにして確認できます。QSGMaterialShader::combinedImageSamplerCount

texture の要素がnullの場合、戻り値として返される前に、有効なQSGTexture ポインタに設定する必要があります。nullでない場合、新しいQSGTexture * をそこに格納するか、あるいは既に既知のQSGTexture のパラメータを更新するかは、マテリアル側の判断に委ねられます。QSGTexture の所有権は譲渡されません。

現在のレンダリング用state はシーングラフから渡されます。必要に応じて、QSGTexture::commitTextureOperations()を介してテクスチャデータのアップロードをキューに入れるかどうかは、マテリアル側で決定します。

サブクラス固有の状態は、newMaterial から取得できます。

oldMaterial を使用することで、変更を最小限に抑えることができます。oldMaterial が null の場合、このシェーダーはアクティブになったばかりです。

QSGMaterialShader::combinedImageSamplerCountも参照してください 。

[virtual] bool QSGMaterialShader::updateUniformData(QSGMaterialShader::RenderState &state, QSGMaterial *newMaterial, QSGMaterial *oldMaterial)

この関数は、シェーダープログラムのユニフォームバッファの内容を更新するために、シーングラフによって呼び出されます。この実装では、実際のグラフィックス演算を実行することは想定されておらず、RenderState::uniformData() から返されるQByteArray へのデータコピーのみを担当します。そのバッファをシェーダー内で可視化するのは、シーングラフの役割です。

現在のレンダリング用state はシーングラフから渡されます。状態が「ダーティ」であることを示している場合、実装はRenderState::uniformData()を介してアクセス可能なバッファデータ内の適切な領域を更新しなければなりません。行列や不透明度などの状態が「ダーティ」でない場合、データは永続的であるため、対応する領域を変更する必要はありません。

ユニフォームデータに変更が加えられた場合は、必ずtrue を戻り値として返さなければなりません。

フラットカラーマテリアルの色など、サブクラス固有の状態は、newMaterial から抽出し、それに応じてバッファ内の関連する領域を更新する必要があります。

oldMaterial を使用すると、マテリアルの状態を更新する際のバッファの変更（通常は memcpy 呼び出し）を最小限に抑えることができます。oldMaterial が null の場合、このシェーダーはアクティブになったばかりです。