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 scenegraph で使用されるレンダーターゲットの最初のカラーアタッチメントとして使用されます。適用可能な場合は、深度ステンシルバッファが自動的に作成され、使用されます。カラーバッファがマルチサンプルの場合、深度ステンシルバッファも自動的にマルチサンプルになります。

この関数は 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 scenegraph でマルチビューレンダリングを有効にする方法については、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 で指定された Metal 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 で指定されたメタル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 scenegraph でマルチビュー・レンダリングを有効にする方法については、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 scenegraphで使用されるレンダリングコンテキストで有効な名前でなければなりません。

この関数は 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 scenegraphで使用されるレンダリングコンテキストで有効な名前でなければなりません。

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 scenegraph でマルチビューレンダリングを有効にする詳細については、QSGMaterial::viewCount() を参照してください。

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

OpenGL オブジェクト名textureId は、Qt Quick scenegraph で使用されるレンダリングコンテキストで有効な 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 ほとんどの場合、 になり、Qt Quick シーンのレンダリングを に向けることができます。QRhiTextureRenderTarget 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 scenegraph でマルチビュー・レンダリングを有効にする方法については、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 を深度バッファまたは深度ステンシルバッファとして使用するように要求します。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()も参照してください 。