QQuickRenderTarget Class

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

QQuickRenderTarget::QQuickRenderTarget()

ネイティブオブジェクトを参照しないデフォルトの QQuickRenderTarget を構築します。

[noexcept] QQuickRenderTarget::~QQuickRenderTarget()

破壊者。

[since 6.8] QRhiTexture *QQuickRenderTarget::depthTexture() const

現在設定されている深度テクスチャ、またはほとんどの場合、nullptr を返します。

この値は、setDepthTexture() が呼び出されたときのみ非 null になります。

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

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

[since 6.3] qreal QQuickRenderTarget::devicePixelRatio() const

レンダーターゲットのデバイスピクセル比率を返します。これは、デバイスピクセルと デバイス非依存ピクセルの比率です。

デフォルトのデバイスピクセル比は 1.0 です。

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

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

[static, since 6.4] QQuickRenderTarget QQuickRenderTarget::fromD3D11Texture(void *texture, uint format, const QSize &pixelSize, int sampleCount = 1)

texture で指定された D3D11 テクスチャオブジェクトを参照する新しいQQuickRenderTarget を返します。

format はテクスチャの DXGI_FORMAT を指定します。Qt のレンダリングインフラストラクチャでサポートされているテクスチャフォーマットのみを使用する必要があります。

pixelSize は画像のサイズをピクセル単位で指定します。現在のところ、2D テクスチャのみがサポートされています。

sampleCount はサンプル数を指定します。0 や 1 はマルチサンプリングしないことを意味し、4 や 8 のような値はネイティブオブジェクトがマルチサンプルテクスチャであることを示します。

このテクスチャは、Qt Quick scenegraph で使用されるレンダーターゲットの最初のカラーアタッチメントとして使用されます。適用可能な場合は、デプス-ステンシル-バッファが自動的に作成され、使用されます。

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

QQuickWindow::setRenderTarget() およびQQuickRenderControlも参照してください 。

[static] QQuickRenderTarget QQuickRenderTarget::fromD3D11Texture(void *texture, const QSize &pixelSize, int sampleCount = 1)

これはオーバーロードされた関数です。

texture で指定された D3D11 テクスチャオブジェクトを参照する新しいQQuickRenderTarget を返します。テクスチャのフォーマットは DXGI_FORMAT_R8G8B8A8_UNORM とします。

pixelSize は画像のサイズをピクセル単位で指定します。現在は2Dテクスチャのみがサポートされています。

sampleCount はサンプル数を指定します。0または1はマルチサンプリングしないことを意味し、4または8のような値はネイティブオブジェクトがマルチサンプルテクスチャであることを示します。

このテクスチャは、Qt Quick scenegraph で使用されるレンダーターゲットの最初のカラーアタッチメントとして使用されます。適用可能な場合は、デプス-ステンシル-バッファが自動的に作成され、使用されます。

QQuickWindow::setRenderTarget() およびQQuickRenderControlも参照のこと 。

[static, since 6.8] QQuickRenderTarget QQuickRenderTarget::fromD3D11Texture(void *texture, uint format, QSize pixelSize, int sampleCount, QQuickRenderTarget::Flags flags)

これはオーバーロードされた関数です。

texture で指定された D3D11 テクスチャオブジェクトを参照する新しいQQuickRenderTarget を返します。

format はテクスチャの DXGI_FORMAT を指定します。Qt のレンダリングインフラストラクチャでサポートされているテクスチャフォーマットのみを使用する必要があります。

pixelSize は画像のサイズをピクセル単位で指定します。現在のところ、2D テクスチャのみがサポートされています。

sampleCount はサンプル数を指定します。0 や 1 はマルチサンプリングしないことを意味し、4 や 8 のような値は、 が を含む場合を除き、ネイティブオブジェクトがマルチサンプルテクスチャであることを示します。この場合、 は非マルチサンプルの 2D テクスチャと仮定され、 は希望するサンプル数を定義します。結果の は、自動的に作成された中間的なマルチサンプルテクスチャをカラーアタッチメントとして使用し、サンプルを に分解します。これは、ネイティブテクスチャがまだマルチサンプルでない場合にMSAAを実行するための推奨アプローチです。flags MultisampleResolve texture sampleCount QQuickRenderTarget texture

テクスチャは、Qt Quick シーングラフで使用されるレンダーターゲットの最初のカラーアタッチメントとして使用されます。適用可能であれば、深度ステンシルバッファが自動的に作成され、使用されます。カラーバッファがマルチサンプルの場合、深度ステンシルバッファも自動的にマルチサンプルになります。

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

QQuickWindow::setRenderTarget(),QQuickRenderControl,fromD3D11Texture()も参照してください 。

[static, since 6.6] QQuickRenderTarget QQuickRenderTarget::fromD3D12Texture(void *texture, int resourceState, uint format, const QSize &pixelSize, int sampleCount = 1)

texture で指定された D3D12 テクスチャオブジェクトを参照する新しいQQuickRenderTarget を返します。

resourceState は、リソースの現在の状態を指定する、D3D12_RESOURCE_STATESからのビットを持つ有効なビットマスクでなければなりません。

format はテクスチャのDXGI_FORMATを指定します。Qtのレンダリングインフラストラクチャでサポートされているテクスチャフォーマットのみを使用する必要があります。

pixelSize 画像のサイズをピクセル単位で指定します。現在は 2D テクスチャのみサポートしています。

sampleCount はサンプル数を指定します。0 や 1 はマルチサンプリングしないことを意味し、4 や 8 のような値はネイティブオブジェクトがマルチサンプルテクスチャであることを示します。

このテクスチャは、Qt Quick scenegraph で使用されるレンダーターゲットの最初のカラーアタッチメントとして使用されます。適用可能な場合は、デプス-ステンシル-バッファが自動的に作成され、使用されます。

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

QQuickWindow::setRenderTarget() およびQQuickRenderControlも参照してください 。

[static, since 6.8] QQuickRenderTarget QQuickRenderTarget::fromD3D12Texture(void *texture, int resourceState, uint format, uint viewFormat, QSize pixelSize, int sampleCount, int arraySize, QQuickRenderTarget::Flags flags)

これはオーバーロードされた関数です。

texture で指定された D3D12 2D テクスチャまたは 2D テクスチャ配列オブジェクトを参照する新しいQQuickRenderTarget を返します。

resourceState は、リソースの現在の状態を指定する、D3D12_RESOURCE_STATESからのビットを持つ有効なビットマスクでなければなりません。

format はテクスチャのDXGI_FORMATを指定します。Qtのレンダリングインフラストラクチャでサポートされているテクスチャフォーマットのみを使用する必要があります。

viewFormat は、レンダーターゲットビュー（RTV）に使用されるDXGI_FORMATです。多くの場合、 と同じです。この引数は、ドライバでformatリラックスフォーマットキャストがサポートされている場合にのみ機能し、そうでない場合は無視されます。実際には、Windows 10 1703以降では常にサポートされる予定です。

pixelSize は画像のサイズをピクセル単位で指定します。現在のところ、2Dテクスチャと2Dテクスチャ配列のみがサポートされています。

sampleCount はサンプル数を指定します。0 または 1 はマルチサンプリングしないことを意味し、4 または 8 のような値は、 が を含む場合を除き、ネイティブオブジェクトがマルチサンプルテクスチャであることを示します。この場合、 は非マルチサンプルの2Dテクスチャまたは2Dテクスチャ配列であると仮定され、 は希望するサンプル数を定義します。結果の は、自動的に作成された中間的なマルチサンプルテクスチャ（またはテクスチャ配列）をカラーアタッチメントとして使用し、サンプルを に分解します。これは、ネイティブ D3D12 テクスチャがまだマルチサンプルでない場合に MSAA を実行するために推奨されるアプローチです。flags MultisampleResolve texture sampleCount QQuickRenderTarget texture

配列の要素数（レイヤー）はarraySize で与えられます。1より大きい場合、マルチビューレンダリング（ビューインスタン ス）を意味し、特にVR/ARに関連する可能性があります。arraySize はビュー数で、通常は2 です。Qt Quick シーングラフ内でマルチビューレンダリングを有効にする方法については、QSGMaterial::viewCount() を参照してください。

テクスチャは、Qt Quick scenegraphによって使用されるレンダーターゲットの最初のカラーアタッチメントとして使用されます。適用可能であれば、深度ステンシルバッファが自動的に作成され、使用されます。カラーバッファがマルチサンプルの場合、深度ステンシルバッファも自動的にマルチサンプルになります。マルチビューレンダリングの場合、深度ステンシルテクスチャは自動的に、arraySize に一致する配列になります。

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

QQuickWindow::setRenderTarget() およびQQuickRenderControlも参照してください 。

[static, since 6.4] QQuickRenderTarget QQuickRenderTarget::fromMetalTexture(MTLTexture *texture, uint format, const QSize &pixelSize, int sampleCount = 1)

texture で指定された Metal texture オブジェクトを参照する新しいQQuickRenderTarget を返します。

format はテクスチャの MTLPixelFormat を指定します。Qt のレンダリングインフラストラクチャでサポートされているテクスチャフォーマットのみを使用する必要があります。

pixelSize は画像のサイズをピクセル単位で指定します。現在は 2D テクスチャのみがサポートされています。

sampleCount はサンプル数を指定します。0 や 1 はマルチサンプリングしないことを意味し、4 や 8 のような値はネイティブオブジェクトがマルチサンプルテクスチャであることを示します。

このテクスチャは、Qt Quick scenegraph で使用されるレンダーターゲットの最初のカラーアタッチメントとして使用されます。適用可能な場合は、デプス-ステンシル-バッファが自動的に作成され、使用されます。

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

QQuickWindow::setRenderTarget() およびQQuickRenderControlも参照してください 。

[static] QQuickRenderTarget QQuickRenderTarget::fromMetalTexture(MTLTexture *texture, const QSize &pixelSize, int sampleCount = 1)

これはオーバーロードされた関数である。

texture で指定された金属テクスチャオブジェクトを参照する新しいQQuickRenderTarget を返します。テクスチャのフォーマットは MTLPixelFormatRGBA8Unorm とします。

pixelSize は画像のサイズをピクセル単位で指定します。現在のところ、2Dテクスチャのみがサポートされています。

sampleCount はサンプル数を指定します。0または1はマルチサンプリングしないことを意味し、4または8のような値はネイティブオブジェクトがマルチサンプルテクスチャであることを示します。

このテクスチャは、Qt Quick scenegraph で使用されるレンダーターゲットの最初のカラーアタッチメントとして使用されます。適用可能な場合は、デプス-ステンシル-バッファが自動的に作成され、使用されます。

QQuickWindow::setRenderTarget() およびQQuickRenderControlも参照のこと 。

[static, since 6.8] QQuickRenderTarget QQuickRenderTarget::fromMetalTexture(MTLTexture *texture, uint format, uint viewFormat, QSize pixelSize, int sampleCount, int arraySize, QQuickRenderTarget::Flags flags)

これはオーバーロードされた関数です。

texture で与えられた Metal 2D テクスチャまたは 2D テクスチャ配列を参照する新しいQQuickRenderTarget を返します。

format はテクスチャの MTLPixelFormat を指定します。Qt のレンダリングインフラストラクチャでサポートされているテクスチャフォーマットのみを使用する必要があります。

viewFormat は通常、 と同じ値に設定されます。 フォーマットのテクスチャにレンダリングし、シェーダ書き込み時の暗黙的な linear->sRGB 変換を望まない場合など、場合によっては、値を異なるものにすることができます。ただし、実行時に が の機能をサポートしていないと報告した場合、Qt はこの値を無視することがあります。format _SRGB QRhi QRhi::TextureViewFormat

pixelSize は画像のサイズをピクセル単位で指定します。現在のところ、2Dテクスチャと2Dテクスチャ配列のみがサポートされています。

sampleCount はサンプル数を指定します。0 または 1 はマルチサンプリングしないことを意味し、4 または 8 のような値は、 に が含まれている場合を除き、ネイティブオブジェクトがマルチサンプルテクスチャであることを示します。この場合、 は非マルチサンプルの2Dテクスチャまたは2Dテクスチャ配列であると仮定され、 は希望するサンプル数を定義します。結果の は、自動的に作成された中間的なマルチサンプルテクスチャ（またはテクスチャ配列）をカラーアタッチメントとして使用し、サンプルを に分解します。これは、ネイティブのMetalテクスチャがまだマルチサンプルでない場合に、MSAAを実行するために推奨される方法です。flags MultisampleResolve texture sampleCount QQuickRenderTarget texture

配列要素（レイヤー）の数はarraySize で指定します。1より大きい場合、マルチビューレンダリングを意味し、特にVR/ARに関連する可能性があります。arraySize はビュー数で、通常は2 です。Qt Quick シーングラフ内でマルチビューレンダリングを有効にする方法については、QSGMaterial::viewCount() を参照してください。

テクスチャは、Qt Quick scenegraphによって使用されるレンダーターゲットの最初のカラーアタッチメントとして使用されます。適用可能であれば、深度ステンシルバッファが自動的に作成され、使用されます。カラーバッファがマルチサンプルの場合、深度ステンシルバッファも自動的にマルチサンプルになります。マルチビューレンダリングの場合、深度ステンシルテクスチャは自動的に、arraySize に一致する配列になります。

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

QQuickWindow::setRenderTarget() およびQQuickRenderControlも参照してください 。

[static, since 6.2] QQuickRenderTarget QQuickRenderTarget::fromOpenGLRenderBuffer(uint renderbufferId, const QSize &pixelSize, int sampleCount = 1)

renderbufferId で指定されたOpenGLレンダーバッファ・オブジェクトを参照する新しいQQuickRenderTarget を返します。

レンダーバッファは、内部フレームバッファオブジェクトのカラーアタッチメントとして使用されます。この関数は、EGLImageKHRのような外部バッファの下にあるアプリケーションによって作成されたレンダーバッファをターゲットにできるようにするために提供されています。アプリケーションがglEGLImageTargetRenderbufferStorageOESを呼び出したら、レンダーバッファはこの関数に渡すことができます。

pixelSize は画像のサイズをピクセル単位で指定します．

sampleCount はサンプル数を指定します。0または1はマルチサンプリングしないことを意味し、4または8のような値は、ネイティブオブジェクトがマルチサンプルレンダーバッファであることを示します。

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

QQuickWindow::setRenderTarget() およびQQuickRenderControlも参照してください 。

[static, since 6.4] QQuickRenderTarget QQuickRenderTarget::fromOpenGLTexture(uint textureId, uint format, const QSize &pixelSize, int sampleCount = 1)

textureId で指定された OpenGL テクスチャオブジェクトを参照する新しいQQuickRenderTarget を返します。

format はテクスチャのネイティブな内部フォーマットを指定します。Qt のレンダリングインフラストラクチャでサポートされているテクスチャフォーマットのみを使用する必要があります。

pixelSize は画像のサイズをピクセル単位で指定します。現在のところ、2D テクスチャのみがサポートされています。

sampleCount はサンプル数を指定します。0 や 1 はマルチサンプリングしないことを意味し、4 や 8 のような値はネイティブオブジェクトがマルチサンプルテクスチャであることを示します。

このテクスチャは、Qt Quick scenegraph で使用されるレンダーターゲットの最初のカラーアタッチメントとして使用されます。該当する場合は、デプス-ステンシル-バッファが自動的に作成され、使用されます。

OpenGLオブジェクト名textureId は、Qt Quick シーングラフによって使用されるレンダリングコンテキストで有効な名前でなければなりません。

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

QQuickWindow::setRenderTarget() およびQQuickRenderControlも参照してください 。

[static] QQuickRenderTarget QQuickRenderTarget::fromOpenGLTexture(uint textureId, const QSize &pixelSize, int sampleCount = 1)

これはオーバーロードされた関数である。

textureId で指定された OpenGL テクスチャオブジェクトを参照する新しいQQuickRenderTarget を返します。テクスチャのフォーマットはGL_RGBA（GL_RGBA8）であると仮定されます。

pixelSize は画像のサイズをピクセル単位で指定します。現在は2Dテクスチャのみがサポートされています。

sampleCount はサンプル数を指定します。0または1はマルチサンプリングしないことを意味し、4または8のような値は、ネイティブオブジェクトがマルチサンプルテクスチャであることを示します。

このテクスチャは、Qt Quick scenegraph で使用されるレンダーターゲットの最初のカラーアタッチメントとして使用されます。該当する場合は、デプス-ステンシル-バッファが自動的に作成され、使用されます。

OpenGLオブジェクト名textureId は、Qt Quick シーングラフによって使用されるレンダリングコンテキストで有効な名前でなければなりません。

QQuickWindow::setRenderTarget() およびQQuickRenderControlも参照のこと 。

[static, since 6.8] QQuickRenderTarget QQuickRenderTarget::fromOpenGLTexture(uint textureId, uint format, QSize pixelSize, int sampleCount, int arraySize, QQuickRenderTarget::Flags flags)

これはオーバーロードされた関数である。

textureId で指定された OpenGL 2D テクスチャまたはテクスチャ配列オブジェクトを参照する新しいQQuickRenderTarget を返します。

format はテクスチャのネイティブ内部フォーマットを指定します。Qt のレンダリングインフラストラクチャでサポートされているテクスチャフォーマットのみを使用する必要があります。

pixelSize は画像のサイズをピクセル単位で指定します。現在のところ、2Dテクスチャと2Dテクスチャ配列のみがサポートされています。

sampleCount はサンプル数を指定します。0 または 1 はマルチサンプリングしないことを意味し、4 または 8 のような値は、 が を含む場合を除き、ネイティブオブジェクトがマルチサンプルテクスチャであることを示します。この場合、 は非マルチサンプルの2Dテクスチャまたは2Dテクスチャ配列であると仮定され、 は希望するサンプル数を定義します。結果の は、自動的に作成された中間的なマルチサンプルテクスチャ（またはテクスチャ配列）をカラーアタッチメントとして使用し、サンプルを に分解します。これは、ネイティブの OpenGL テクスチャがまだマルチサンプルでない場合に MSAA を実行するために推奨されるアプローチです。flags MultisampleResolve textureId sampleCount QQuickRenderTarget textureId

arraySize が1より大きい場合、マルチビューレンダリング（GL_OVR_multiview,QRhiColorAttachment::setMultiViewCount()）を意味し、特にVR/ARと関連する可能性があります。この場合、arraySize はビューの数であり、通常は2 である。Qt Quick シーングラフ内でマルチビューレンダリングを有効にする詳細については、QSGMaterial::viewCount() を参照してください。

該当する場合は、深度ステンシルバッファが自動的に作成され、使用されます。カラーバッファがマルチサンプルの場合、深度ステンシルバッファも自動的にマルチサンプルになります。マルチビューレンダリングの場合、深度ステンシルテクスチャは自動的に、arraySize に一致する配列になります。

OpenGLオブジェクト名textureId は、Qt Quick シーングラフで使用されるレンダリングコンテキストで有効な2Dテクスチャ名でなければなりません。arraySize が1より大きいとき、textureId は有効な2Dテクスチャ配列名でなければなりません。

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

QQuickWindow::setRenderTarget()、QQuickRenderControl 、fromOpenGLTexture()も参照してください 。

[static, since 6.4] QQuickRenderTarget QQuickRenderTarget::fromPaintDevice(QPaintDevice *device)

device で指定されたペイントデバイスオブジェクトを参照する新しいQQuickRenderTarget を返します。

レンダリングをQPaintDevice にリダイレクトするこのオプションは、Qt Quick のsoftware バックエンドで実行されている場合にのみ利用可能です。

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

QQuickWindow::setRenderTarget() およびQQuickRenderControlも参照してください 。

[static, since 6.6] QQuickRenderTarget QQuickRenderTarget::fromRhiRenderTarget(QRhiRenderTarget *renderTarget)

既存のrenderTarget を参照する新しいQQuickRenderTarget を返す。

renderTarget ほとんどの場合、 となり、 シーンのレンダリングを に向けることができます。QRhiTextureRenderTarget Qt Quick QRhiTexture

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

QQuickWindow::setRenderTarget() およびQQuickRenderControlも参照してください 。

[static, since 6.4] QQuickRenderTarget QQuickRenderTarget::fromVulkanImage(VkImage image, VkImageLayout layout, VkFormat format, const QSize &pixelSize, int sampleCount = 1)

image で指定されたVulkanイメージオブジェクトを参照する新しいQQuickRenderTarget を返します。画像の現在のlayout も提供する必要があります。

format は画像の VkFormat を指定します。Qtのレンダリングインフラストラクチャでサポートされている画像フォーマットのみを使用する必要があります。

pixelSize は画像のサイズをピクセル単位で指定します。現在のところ、2D テクスチャのみがサポートされています。

sampleCount はサンプル数を指定します。0 や 1 はマルチサンプリングしないことを意味し、4 や 8 のような値はネイティブオブジェクトがマルチサンプルテクスチャであることを示します。

このイメージは、Qt Quick scenegraph で使用されるレンダーターゲットの最初のカラーアタッチメントとして使用されます。該当する場合は、深度ステンシルバッファが自動的に作成され、使用されます。

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

QQuickWindow::setRenderTarget() およびQQuickRenderControlも参照してください 。

[static] QQuickRenderTarget QQuickRenderTarget::fromVulkanImage(VkImage image, VkImageLayout layout, const QSize &pixelSize, int sampleCount = 1)

これはオーバーロードされた関数です。

image で指定されたVulkanイメージオブジェクトを参照する新しいQQuickRenderTarget を返します。画像はVK_FORMAT_R8G8B8A8_UNORMのフォーマットを持つと仮定されます。

pixelSize はイメージのサイズをピクセル単位で指定します。現在のところ、2Dテクスチャのみがサポートされています。

sampleCount はサンプル数を指定します。0または1はマルチサンプリングしないことを意味し、4または8のような値はネイティブオブジェクトがマルチサンプルテクスチャであることを示します。

このテクスチャは、Qt Quick scenegraph で使用されるレンダーターゲットの最初のカラーアタッチメントとして使用されます。適用可能な場合は、デプス-ステンシル-バッファが自動的に作成され、使用されます。

QQuickWindow::setRenderTarget() およびQQuickRenderControlも参照のこと 。

[static, since 6.8] QQuickRenderTarget QQuickRenderTarget::fromVulkanImage(VkImage image, VkImageLayout layout, VkFormat format, VkFormat viewFormat, QSize pixelSize, int sampleCount, int arraySize, QQuickRenderTarget::Flags flags)

これはオーバーロードされた関数です。

image で指定されたVulkanイメージオブジェクトを参照する新しいQQuickRenderTarget を返します。イメージの現在のlayout も提供されなければなりません。イメージは、2Dテクスチャまたは2Dテクスチャ配列でなければなりません。

format は画像のVkFormatを指定します。Qtのレンダリングインフラストラクチャがサポートしている画像フォーマットのみを使用する必要があります。

viewFormat は通常、 と同じ値に設定されます。 フォーマットのテクスチャにレンダリングする場合で、シェーダ書き込み時の暗黙的な linear->sRGB 変換を望まない場合など、場合によっては異なる値にすることができます。(たとえば、 の と の のように）。format _SRGB VK_FORMAT_R8G8B8A8_SRGB format VK_FORMAT_R8G8B8A8_UNORM viewFormat

pixelSize は画像のサイズをピクセル単位で指定します。現在、2D テクスチャのみがサポートされています。

sampleCount はサンプル数を指定します。0 または 1 はマルチサンプリングしないことを意味し、4 または 8 のような値は、 が を含む場合を除き、ネイティブオブジェクトがマルチサンプルテクスチャであることを示します。この場合、 は非マルチサンプルの2Dテクスチャまたは2Dテクスチャ配列であると仮定され、 は希望するサンプル数を定義します。結果の は、自動的に作成された中間的なマルチサンプルテクスチャ（またはテクスチャ配列）をカラーアタッチメントとして使用し、サンプルを に分解します。これは、ネイティブVulkanイメージがまだマルチサンプルでない場合にMSAAを実行するための推奨アプローチです。flags MultisampleResolve image sampleCount QQuickRenderTarget image

配列要素（レイヤー）の数はarraySize 。1より大きい場合、マルチビューレンダリング（VK_KHR_multiview）を意味し、特にVR/ARに関連する可能性があります。arraySize はビュー数で、通常は2 です。Qt Quick シーングラフ内でマルチビューレンダリングを有効にする方法については、QSGMaterial::viewCount() を参照してください。

テクスチャは、Qt Quick scenegraphによって使用されるレンダーターゲットの最初のカラーアタッチメントとして使用されます。適用可能であれば、深度ステンシルバッファが自動的に作成され、使用されます。カラーバッファがマルチサンプルの場合、深度ステンシルバッファも自動的にマルチサンプルになります。マルチビューレンダリングの場合、深度ステンシルテクスチャは自動的に、arraySize に一致する配列になります。

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

QQuickWindow::setRenderTarget() およびQQuickRenderControlも参照してください 。

bool QQuickRenderTarget::isNull() const

このQQuickRenderTarget がデフォルトで構築されており、ネイティブオブジェクトを参照していない場合は true を返します。

[since 6.4] bool QQuickRenderTarget::mirrorVertically() const

戻り値 レンダーターゲットが垂直方向にミラーされているかどうかを返します。

デフォルト値はfalse です。

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

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

[since 6.8] void QQuickRenderTarget::setDepthTexture(QRhiTexture *texture)

与えられたtexture を depth または depth-stencil バッファとして使用することを要求する。texture の所有権は取得されない。

リクエストは、関連する場合にのみ考慮される。たとえば、この関数を呼び出しても、fromRhiRenderTarget()、fromPaintDevice()、fromOpenGLRenderBuffer() には影響しない。

通常、深度-ステンシルバッファは、QQuickRenderTarget のユーザーに対して透過的に、自動的に作成されます。 したがって、QQuickRenderTarget で作業する場合、ほとんどのケースでこの関数を呼び出す必要はありません。 しかし、特殊な状況では、Qt Quick に独自の中間テクスチャやバッファを作成させる代わりに、深度（または深度とステンシル）データをレンダリングするテクスチャを提供できることが重要になることがあります。この例として、OpenXRとXR_KHR_composition_layer_depth のような拡張があります。XRコンポジターに「深度バッファを提出」するためには、実際には、OpenXRから（XrSwapchainから）すでに作成された深度（深度ステンシル）テクスチャを取得し、深度データのレンダーターゲットとしてそのテクスチャを使用する必要があります。これは、この関数なしでは不可能です。

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

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

[since 6.3] void QQuickRenderTarget::setDevicePixelRatio(qreal ratio)

このレンダーターゲットのデバイスピクセル比率をratio に設定する。 これは、デバイスピクセルと デバイス非依存ピクセルの比率である。

QQuickRenderControl::renderWindow() を再実装して有効なQWindow を返した場合、指定されたデバイスピクセル比の値は無視されることに注意してください。

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

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

[since 6.4] void QQuickRenderTarget::setMirrorVertically(bool enable)

描画時にレンダーターゲットの内容を垂直方向にミラーリングするサイズをenable に設定します。これにより、標準の期待値に従わないサードパーティのレンダリングコードを簡単に統合できます。

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

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