QSSGRhiContext Class

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

void QSSGRhiContext::checkAndAdjustForNPoT(QRhiTexture *texture, QSSGRhiSamplerDescription *samplerDescription)

texture のピクセルサイズに基づいてsamplerDescription のタイリングとフィルタリングモードを調整する。

ほとんどの場合、samplerDescription は変更されません。しかし、古いレガシーな 3D API が使用されている場合、QRhiSampler::Repeat のようなタイリングモードが、幅や高さが 2 のべき乗でないテクスチャではサポートされない可能性があります。

この便利な関数は、QRhi::NPOTTextureRepeat のような機能が OpenGL ES 2.0 や WebGL 1 の実装でサポートされていない場合でも、実行時に機能する堅牢なアプリケーションを作成するのに役立ちます。

QRhiCommandBuffer *QSSGRhiContext::commandBuffer() const

Qt Quick 3D レンダラーが使用する現在のフレームのコマンドバッファを返します。

QRhiCommandBuffer::BeginPassFlags QSSGRhiContext::commonPassFlags() const

QRhiCommandBuffer::beginPass() を呼び出すときに推奨されるフラグを返します。

QRhiTexture *QSSGRhiContext::dummyTexture(QRhiTexture::Flags flags, QRhiResourceUpdateBatch *rub, const QSize &size = QSize(64, 64), const QColor &fillColor = Qt::black, int arraySize = 0)

指定されたflags とピクセルsize を持つテクスチャを返します。

これは、指定されたfillColor で満たされた「ダミー」テクスチャに効率的にアクセスし、レンダリングスタックのさまざまな場所で再利用することを目的としています。

rub 適切なキャッシュオブジェクトが見つからない場合、この関数は新しいテクスチャを作成し、そのためのコンテンツを生成するため、 は有効でなければなりません。その後、必要なアップロード操作が、この与えられた更新バッチにエンキューされます。QRhiResourceUpdateBatch

arraySize が2以上の場合、2Dテクスチャ配列が返されます。

返されたテクスチャの所有権は Qt Quick 3D に残ります。

bool QSSGRhiContext::isValid() const

レンダラーが正常に初期化された場合、true を返します。

int QSSGRhiContext::mainPassSampleCount() const

メインレンダーパスで使用されるサンプルカウントを返します。

int QSSGRhiContext::mainPassViewCount() const

メインレンダーパスで使用されるマルチビューカウントを返します。マルチビューレンダリングが使用されている場合は 2、マルチビューが使用されていない場合は 1 になります。

QRhiRenderPassDescriptor *QSSGRhiContext::mainRenderPassDescriptor() const

Qt Quick 3D レンダラのメインレンダーパスで使用されるQRhiRenderPassDescriptor を返します。

QRhiRenderTarget *QSSGRhiContext::renderTarget() const

Qt Quick 3D レンダラが現在のフレームでメインレンダーパスに使用するレンダーターゲットを返します。

これは、View3D が Offscreen 以外の renderMode を使用している場合、スワップチェーンからのレンダーターゲットになります。より一般的には、レンダーターゲットはテクスチャを指します（つまり、QRhiTextureRenderTarget ）。これは、レンダリングモードがデフォルトのOffscreenである場合や、ポストプロセッシングエフェクトが使用されている場合などです。

QRhi *QSSGRhiContext::rhi() const

Qt Quick 3D レンダラーが使用するQRhi オブジェクトを返します。

QRhiSampler *QSSGRhiContext::sampler(const QSSGRhiSamplerDescription &samplerDescription)

samplerDescription で指定されたフィルタとタイリングモードを持つサンプラーを返します。

生成されたQRhiSampler オブジェクトはキャッシュされ、再利用されます。したがって、これは、常に新しい専用のオブジェクトを作成することなく、指定された設定でQRhiSampler にアクセスする便利な方法です。

返されたQRhiSampler の所有権は Qt Quick 3D にあります。