QQuickWindow Class

メンバ関数ドキュメント

[explicit] QQuickWindow::QQuickWindow(QQuickRenderControl *control)

QML シーンを表示するためのウィンドウを構築します。そのレンダリングはcontrol オブジェクトによって制御されます。詳しくはQQuickRenderControl のドキュメントを参照してください。

[explicit] QQuickWindow::QQuickWindow(QWindow *parent = nullptr)

親ウィンドウparent を持つ QML シーンを表示するためのウィンドウを構築します。

[override virtual noexcept] QQuickWindow::~QQuickWindow()

ウィンドウを破棄します。

[override virtual] QAccessibleInterface *QQuickWindow::accessibleRoot() const

このウィンドウのアクセシビリティインタフェースを返します。

[signal] void QQuickWindow::afterAnimating()

このシグナルはレンダリングスレッドにシーングラフの同期を要求する前にGUIスレッド上で発せられます。

他の同様のシグナルとは異なり、このシグナルはレンダースレッドではなくGUIスレッド上で発行されます。このシグナルは、外部のアニメーションシステムをQMLコンテンツと同期させるために使用することができます。これは同時に、このシグナルがグラフィックス操作のトリガーには適していないことを意味します。

[signal, since 6.0] void QQuickWindow::afterFrameEnd()

このシグナルは、シーングラフがフレームを送信したときに発行されます。このシグナルは、afterRendering （）のような、他のすべての関連シグナルの後に発せられます。これは、シーングラフのレンダリングスレッドがフレームをレンダリングするときに発する最後のシグナルです。

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

beforeFrameBegin() とrendererInterface()も参照してください 。

[signal] void QQuickWindow::afterRenderPassRecording()

このシグナルは、シーングラフがメインレンダーパスのコマンドを記録した後に発行されます。

このシグナルは、afterRendering （）よりも早く発せられ、フレームだけでなく、シーングラフのメインレンダーパスの記録もまだアクティブであることを保証します。これにより、別個のレンダーパスを生成することなく、コマンドを挿入することができます（通常、添付された画像はクリアされます）。ネイティブグラフィックオブジェクトは、QSGRendererInterface を介してクエリできます。

rendererInterface() およびScene Graph - RHI Under QMLも参照して ください。

[signal] void QQuickWindow::afterRendering()

このシグナルは、シーングラフがコマンドバッファにコマンドを追加した後に発行されます。必要であれば、このシグナルに接続されたスロット関数は、QSGRendererInterface を介して、コマンドバッファのようなネイティブリソースに問い合わせることができます。しかし、レンダーパス（またはパス）は、この時点ですでに記録されており、シーングラフのパス内にコマンドを追加することはできないことに注意してください。代わりに、afterRenderPassRecording （）を使用してください。そのため、Qt 6では、Qt 5とは異なり、このシグナルの使用は限られています。むしろ、beforeRendering （）とbeforeRenderPassRecording （）、またはbeforeRendering （）とafterRenderPassRecording （）の組み合わせが、カスタムレンダリングのアンダーレイ・オーバーレイを実現するために一般的に使用されます。

rendererInterface()、Scene Graph - RHI Under QML、Scene Graph - OpenGL Under QML、Scene Graph - Metal Under QML、Scene Graph - Vulkan Under QML、Scene Graph - Direct3D 11 Under QMLも参照してください 。

[signal] void QQuickWindow::afterSynchronizing()

このシグナルは、シーングラフがQMLの状態と同期した後に発行されます。

このシグナルは、GUIスレッドがまだロックされている間に、QQuickItem::updatePaintNode （）を呼び出した後に必要な準備を行うために使用することができます。

OpenGLを使用する場合、シーングラフによるレンダリングに使用されるQOpenGLContext はこの時点でバインドされます。

[signal, since 6.0] void QQuickWindow::beforeFrameBegin()

このシグナルは、シーングラフがフレームの準備を始める前に発せられます。これは、beforeSynchronizing （）やbeforeRendering （）のようなシグナルに先行します。これは、シーングラフのレンダリングスレッドが新しいフレームの準備を始めるときに発する最も早いシグナルです。

このシグナルは、Qt Quick が基礎となるレンダリングハードウェアインタフェース API を介して新しいフレームの記録を開始していない段階で、リソースのクリーンアップなどの特定の処理を実行する必要がある、低レベルのグラフィックスフレームワークに関連します。

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

afterFrameEnd() とrendererInterface()も参照してください 。

[signal] void QQuickWindow::beforeRenderPassRecording()

このシグナルは、シーングラフがメインレンダーパスのコマンドの記録を開始する前に発行されます。(レイヤーは、それ自身のパスを持ち、このシグナルが発せられる頃には、完全に記録されています)。このシグナルが発せられるとき、レンダーパスはすでにコマンドバッファ上でアクティブになっています。

このシグナルは、beforeRendering()より後に発せられ、フレームだけでなく、シーングラフのメインレンダーパスの記録もアクティブであることを保証します。これにより、別個のレンダーパスを生成することなく、コマンドを挿入することができます。ネイティブグラフィックオブジェクトは、QSGRendererInterface を介してクエリできます。

rendererInterface() およびScene Graph - RHI Under QMLも参照してください 。

[signal] void QQuickWindow::beforeRendering()

このシグナルは、フレームの準備が完了した後に発せられます。つまり、該当する場合、記録モードのコマンドバッファが存在します。必要であれば、このシグナルに接続されたスロット関数は、QSGRendererInterface を介して、以前のコマンドのようにネイティブリソースに問い合わせることができます。ただし、この時点ではメインレンダーパスの記録はまだ開始されておらず、そのパス内でコマンドを追加することはできないことに注意してください。パスの開始は、カラー、深度、およびステンシルバッファをクリアすることを意味するため、このシグナルに接続するだけでは、アンダーレイタイプのレンダリングを実現することはできません。むしろ、beforeRenderPassRecording （）に接続します。しかし、コピータイプのコマンドを記録したい場合は、レンダーパスの中でキューに入れることができないので、このシグナルに接続することは重要です。

rendererInterface()、Scene Graph - RHI Under QML、Scene Graph - OpenGL Under QML、Scene Graph - Metal Under QML、Scene Graph - Vulkan Under QML、Scene Graph - Direct3D 11 Under QMLも参照してください 。

[signal] void QQuickWindow::beforeSynchronizing()

このシグナルは、シーングラフがQMLの状態と同期する前に発行されます。

このシグナルはシーングラフのレンダリングスレッドから発行されますが、GUIスレッドはQQuickItem::updatePaintNode （）のようにブロックされることが保証されています。従って、Qt::DirectConnection に接続されたスロットやラムダでGUIスレッドのスレッドデータにアクセスすることは安全です。

このシグナルは、QQuickItem::updatePaintNode （）を呼び出す前に必要な準備を行うために使用できる。

OpenGLを使用する場合、シーングラフによるレンダリングに使用されるQOpenGLContext 、この時点でバインドされる。

void QQuickWindow::beginExternalCommands()

rawグラフィックス（OpenGL、Vulkan、Metalなど）のコマンドをシーングラフレンダリングと混在させる場合、シーングラフがメインレンダーパスをレンダリングするために使用するコマンドバッファにコマンドを記録する前に、この関数を呼び出す必要があります。これは、状態のクローバを避けるためです。

実際には、この関数は、beforeRenderPassRecording （）またはafterRenderPassRecording （）信号に接続されたスロットから呼び出されることがよくあります。

この関数は、アプリケーション独自のコマンドバッファ（シーングラフから取得するのではなく、アプリケーションによって作成され管理される VkCommandBuffer または MTLCommandBuffer + MTLRenderCommandEncoder など）にコマンドを記録するときに呼び出される必要はありません。ネイティブコマンドバッファの概念が公開されていないグラフィックスAPI（OpenGL、Direct 3D 11）では、beginExternalCommands()とendExternalCommands()を併用することで、Qt 5のresetOpenGLState()関数の代替となります。

この関数とendExternalCommands() を呼び出すことは、QSGRenderNode のrender() 実装内では必要ありません。なぜなら、シーングラフはレンダーノードに対して暗黙のうちに必要なステップを実行するからです。

ネイティブ・グラフィック・オブジェクト（グラフィック・デバイス、コマンド・バッファ、エンコーダなど）には、QSGRendererInterface::getResource （）を介してアクセスできます。

endExternalCommands() およびQQuickOpenGLUtils::resetOpenGLState()も参照してください 。

[override virtual protected] void QQuickWindow::closeEvent(QCloseEvent *e)

再実装：QWindow::closeEvent(QCloseEvent *ev)。

QSGImageNode *QQuickWindow::createImageNode() const

単純なイメージ・ノードを作成します。シーングラフが初期化されていない場合、戻り値はNULLです。

これは、QSGSimpleTextureNode を直接構築するクロスバックエンド代替です。

QSGImageNodeも参照してください 。

QSGNinePatchNode *QQuickWindow::createNinePatchNode() const

9 パッチ・ノードを作成します。シーングラフが初期化されていない場合、戻り値は NULL です。

QSGRectangleNode *QQuickWindow::createRectangleNode() const

単純な矩形ノードを作成します。シーングラフが初期化されていない場合、戻り値は NULL です。

これは、QSGSimpleRectNode を直接構築するクロスバックエンド代替手段です。

QSGRectangleNodeも参照してください 。

[since 6.7] QSGTextNode *QQuickWindow::createTextNode() const

テキスト ノードを作成します。シーングラフが初期化されていない場合、戻り値は NULL です。

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

QSGTextNodeも参照して ください。

QSGTexture *QQuickWindow::createTextureFromImage(const QImage &image, QQuickWindow::CreateTextureOptions options) const

与えられたimage から新しいQSGTexture を作成します。画像にアルファチャンネルがある場合、対応するテクスチャもアルファチャンネルを持ちます。

この関数の呼び出し元は、返されたテクスチャを削除する責任があります。その場合、基礎となるネイティブテクスチャオブジェクトは、QSGTexture とともに破棄されます。

options にTextureCanUseAtlas が含まれている場合、エンジンは画像をテクスチャアト ラスに入れることができます。アトラス内のテクスチャはジオメトリをQSGTexture::normalizedTextureSubRect() に依存する必要があり、QSGTexture::Repeat をサポートしません。CreateTextureOption のその他の値は無視されます。

options がTextureIsOpaque を含む場合、 エンジンは RGB テクスチャを作成し、QSGTexture::hasAlphaChannel() に対して false を返します。ほとんどの場合、不透明テクスチャの方がレンダリング速度が速くなります。このフラグが設定されていない場合、テクスチャは画像のフォーマットに基づいたアルファチャンネルを持ちます。

options がTextureHasMipmaps を含む場合、エンジンはミップマップフィルタリングを使用できるテクスチャを作成します。ミップマップされたテクスチャをアトラスに含めることはできません。

options でTextureHasAlphaChannel を設定しても、アルファチャンネルとブレンディングがデフォルトなので、この機能には意味がありません。これを避けるには、TextureIsOpaque を設定します。

シーングラフがOpenGLを使用する場合、返されるテクスチャはテクスチャターゲットとしてGL_TEXTURE_2D 、内部フォーマットとしてGL_RGBA 。他のグラフィックスAPIでは、テクスチャフォーマットは通常RGBA8 。異なるパラメータでテクスチャを作成するには、QSGTexture を再実装してください。

この関数は、メインスレッドとレンダリングスレッドの両方から呼び出すことができます。

sceneGraphInitialized() およびQSGTextureも参照してください 。

QSGTexture *QQuickWindow::createTextureFromImage(const QImage &image) const

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

[since 6.6] QSGTexture *QQuickWindow::createTextureFromRhiTexture(QRhiTexture *texture, QQuickWindow::CreateTextureOptions options = {}) const

与えられたtexture から新しいQSGTexture を作成します。

テクスチャ属性をカスタマイズするにはoptions を使用します。この関数ではTextureHasAlphaChannel フラグのみが考慮されます。設定されると、生成されたQSGTexture は常にシーングラフレンダラによってブレンドが必要であるとして扱われます。完全に不透明なテクスチャの場合、フラグを設定しないことで、レンダリング時にアルファブレンディングを実行するコストを節約できます。このフラグは、QRhiTexture のformat と直接の対応はありません。つまり、一般的に使用されているQRhiTexture::RGBA8 のようなテクスチャフォーマットを持ちながらフラグを設定しないことは、完全に正常です。

ミップマップはoptions によって制御されません。なぜなら、texture はすでに作成されており、ミップマップの有無を焼き付けているからです。

返されたQSGTexture はQRhiTexture を所有する。つまり、texture は返されたQSGTexture とともに破棄される。

texture がその基礎となるネイティブグラフィックリソース（OpenGL テクスチャオブジェクト、Vulkan イメージなど）を所有している場合、それはQRhiTexture がどのように作成されたか（QRhiTexture::create() またはQRhiTexture::createFrom() ）に依存し、この関数によって制御または変更されることはありません。

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

createTextureFromImage(),sceneGraphInitialized(),QSGTextureも参照してください 。

qreal QQuickWindow::effectiveDevicePixelRatio() const

このウィンドウのデバイスピクセル比率を返します。

これはQWindow::devicePixelRatio() と異なり、QQuickRenderControl とQQuickRenderTarget を介したリダイレクトレンダリングをサポートします。QQuickRenderControl を使用する場合、多くの場合、QQuickWindow は完全には作成されない。つまり、表示されることはなく、ウィンドウシステムで作成される基礎となるネイティブウィンドウは存在しない。その結果、デバイスのピクセル比率のようなプロパティを照会しても、正しい結果は得られません。この関数は、QQuickRenderControl::renderWindowFor （）とQQuickRenderTarget::devicePixelRatio （）の両方を考慮する。リダイレクトが有効でない場合、結果はQWindow::devicePixelRatio() と同じである。

QQuickRenderControl 、QQuickRenderTarget 、setRenderTarget （）、QWindow::devicePixelRatio （）も参照 。

void QQuickWindow::endExternalCommands()

生のグラフィックス（OpenGL、Vulkan、Metalなど）コマンドをシーングラフレンダリングと混在させる場合、シーングラフがメインレンダーパスをレンダリングするために使用するコマンドバッファにコマンドを記録した後に、この関数を呼び出す必要があります。これは、状態のクローバを避けるためです。

実際には、この関数は、beforeRenderPassRecording （）またはafterRenderPassRecording （）信号に接続されたスロットから呼び出されることがよくあります。

この関数は、アプリケーション独自のコマンドバッファ（シーングラフから取得するのではなく、アプリケーションによって作成され管理される VkCommandBuffer または MTLCommandBuffer + MTLRenderCommandEncoder など）にコマンドを記録するときに呼び出される必要はありません。ネイティブコマンドバッファの概念が公開されていないグラフィックスAPI（OpenGL、Direct 3D 11）では、beginExternalCommands （）とendExternalCommands（）を組み合わせることで、Qt 5のresetOpenGLState（）関数の代替となります。

この関数とbeginExternalCommands() を呼び出すことは、QSGRenderNode のrender() 実装内では必要ありません。なぜなら、シーングラフはレンダーノードに対して暗黙のうちに必要なステップを実行するからです。

beginExternalCommands() およびQQuickOpenGLUtils::resetOpenGLState()も参照してください 。

[override virtual protected] bool QQuickWindow::event(QEvent *event)

再実装：QWindow::event(QEvent *ev)。

[override virtual protected] void QQuickWindow::exposeEvent(QExposeEvent *)

再実装：QWindow::exposeEvent(QExposeEvent *ev)。

[override virtual protected] void QQuickWindow::focusInEvent(QFocusEvent *ev)

再リンプルメント: (QExposeEvent *ev)：QWindow::focusInEvent(QFocusEvent *ev).

[override virtual protected] void QQuickWindow::focusOutEvent(QFocusEvent *ev)

再リンプルメント：QWindow::focusOutEvent(QFocusEvent *ev)を再定義します。

[signal] void QQuickWindow::frameSwapped()

このシグナルは、フレームが提示のためにキューに入れられた時に発行されます。垂直同期が有効な場合、このシグナルは連続的にアニメーションするシーンでvsync間隔ごとに最大1回発行されます。

このシグナルは、シーングラフのレンダリングスレッドから発行されます。

QImage QQuickWindow::grabWindow()

ウィンドウの内容を取得し、画像として返します。

ウィンドウが表示されていないときにgrabWindow()関数を呼び出すことも可能です。この場合、ウィンドウがcreated で、有効なサイズがあり、同じプロセスで他のQQuickWindow インスタンスがレンダリングされていないことが必要です。

[static, since 6.0] QSGRendererInterface::GraphicsApi QQuickWindow::graphicsApi()

シーングラフがこの時点で初期化された場合に使用されるグラフィックAPIを返します。

シーングラフによって使用されるAPIを問い合わせる標準的な方法は、シーングラフが初期化された後、例えば、sceneGraphInitialized （）シグナルが発せられた時、またはその後に、QSGRendererInterface::graphicsApi （）を使用することです。この場合、そのグラフィックスAPIを使用してすべてが正しく初期化されたことが分かるので、本当の本当の結果が得られます。

これは必ずしも便利なことではない。アプリケーションが外部フレームワークをセットアップする必要がある場合や、シーングラフに組み込まれたAPI選択ロジックに依存する方法でsetGraphicsDevice （）を操作する必要がある場合、QQuickWindow が可視化されたり、QQuickRenderControl::initialize （）が呼び出された後まで、そのような操作を延期することは必ずしも容易ではありません。

したがって、この静的関数は、setGraphicsApi （）と対になるものとして提供されます。これはいつでも呼び出すことができ、その結果は、シーングラフが呼び出された時点で初期化されていれば、どのAPIを選択するかを反映します。

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

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

[since 6.0] QQuickGraphicsConfiguration QQuickWindow::graphicsConfiguration() const

setGraphicsDevice() に渡されたQQuickGraphicsDevice か、そうでない場合はデフォルトで構築されたものを返します。

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

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

[since 6.0] QQuickGraphicsDevice QQuickWindow::graphicsDevice() const

setGraphicsDevice() に渡されたQQuickGraphicsDevice を返します。

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

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

const QQuickWindow::GraphicsStateInfo &QQuickWindow::graphicsStateInfo()

RHIの内部状態、特にバックエンド（VulkanやMetal統合など）のダブルバッファリングやトリプルバッファリングの状態を記述したGraphicsStateInfo 構造体への参照を返します。これは、基礎となるグラフィックスAPIがVulkanまたはMetalであり、外部のレンダリングコードが、パイプラインのストールを避けるために、ユニフォームバッファなどの、頻繁に変化する独自のリソースのダブルバッファリングまたはトリプルバッファリングを実行したい場合に関連します。

[static] bool QQuickWindow::hasDefaultAlphaBuffer()

新しく作成されたウィンドウでアルファ透過を使用するかどうかを返します。

setDefaultAlphaBuffer()も参照 。

[override virtual protected] void QQuickWindow::hideEvent(QHideEvent *)

再インプリメントです：QWindow::hideEvent(QHideEvent *ev).

QQmlIncubationController *QQuickWindow::incubationController() const

このウィンドウのフレーム間のインキュベーションをスプライスするインキュベーションコントローラを返します。QQuickView は自動的にこのコントローラをインストールしてくれますが、そうでない場合はQQmlEngine::setIncubationController() を使用して自分でインストールする必要があります。

このコントローラはウィンドウが所有し、ウィンドウが削除されると破棄されます。

bool QQuickWindow::isPersistentGraphics() const

QQuickWindow の有効期間中に、必須のグラフィックリソースを解放できるかどうかを返します。

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

bool QQuickWindow::isPersistentSceneGraph() const

シーングラフのノードとリソースが、このQQuickWindow のライフタイム中に解放できるかどうかを返します。

bool QQuickWindow::isSceneGraphInitialized() const

シーングラフが初期化されていれば true を返し、そうでなければ false を返す。

[override virtual protected] void QQuickWindow::keyPressEvent(QKeyEvent *e)

再実装：QWindow::keyPressEvent(QKeyEvent*ev)を再実装します。

[override virtual protected] void QQuickWindow::keyReleaseEvent(QKeyEvent *e)

再実装：QWindow::keyReleaseEvent(QKeyEvent *ev).

[override virtual protected] void QQuickWindow::mouseDoubleClickEvent(QMouseEvent *event)

再リンプルメント：QWindow::mouseDoubleClickEvent(QMouseEvent *ev).

[override virtual protected] void QQuickWindow::mouseMoveEvent(QMouseEvent *event)

再リンプルメント：QWindow::mouseMoveEvent(QMouseEvent *ev).

[override virtual protected] void QQuickWindow::mousePressEvent(QMouseEvent *event)

再リンプルメント：QWindow::mousePressEvent(QMouseEvent *ev).

[override virtual protected] void QQuickWindow::mouseReleaseEvent(QMouseEvent *event)

再リンプルメント: (QMouseEvent *ev)：QWindow::mouseReleaseEvent(QMouseEvent *ev) を再実装します。

[slot] void QQuickWindow::releaseResources()

この関数は、QMLシーンが現在保持している冗長なリソースの解放を試みます。

この関数を呼び出すと、シーングラフに対して、グラフィックスパイプラインオブジェクト、シェーダプログラム、画像データなどのキャッシュされたグラフィックスリソースの解放を要求します。

さらに、使用中のレンダリングループによっては、この関数によってシーングラフとすべてのウィンドウ関連レンダリングリソースが解放されることもあります。このような場合、sceneGraphInvalidated （）シグナルが発行され、ユーザーは自分のグラフィックリソースをクリーンアップすることができます。アプリケーションでクリーンアップを処理することが不可能な場合は、setPersistentGraphics （）とsetPersistentSceneGraph （）関数を使用することで、メモリ使用量が増加しますが、これを防ぐことができます。

sceneGraphInvalidated()、setPersistentGraphics()、setPersistentSceneGraph()も参照 。

[since 6.0] QQuickRenderTarget QQuickWindow::renderTarget() const

setRenderTarget() に渡されたQQuickRenderTarget を返すか、そうでない場合はデフォルトで構築されたものを返します。

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

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

QSGRendererInterface *QQuickWindow::rendererInterface() const

現在のレンダラー・インターフェースを返します。この値は常に有効で、NULLになることはありません。

QSGRenderNode およびQSGRendererInterfaceも参照して ください。

[override virtual protected] void QQuickWindow::resizeEvent(QResizeEvent *ev)

再実装：QWindow::resizeEvent(QResizeEvent *ev)。

[since 6.6] QRhi *QQuickWindow::rhi() const

このウィンドウがレンダリングに使用するQRhi オブジェクトを返します。

ウィンドウがQtの3D APIとシェーディング言語の抽象化を使用している場合にのみ利用可能です。つまり、software 適応を使用している場合、結果は常にNULLです。

この結果は、レンダリングが初期化されたときのみ有効であり、sceneGraphInitialized() シグナルの発信によって示されます。それ以前は、返される値はnullである。通常の画面上のQQuickWindow シーングラフの初期化は、通常、ネイティブ・ウィンドウが最初に露出（表示）されるときに起こります。QQuickRenderControl を使用する場合、初期化は明示的なinitialize() 呼び出しで行われます。

実際には、この関数はQSGRendererInterface を介してQRhi をクエリするためのショートカットです。

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

[signal] void QQuickWindow::sceneGraphAboutToStop()

このシグナルは、シーングラフのレンダリングが停止するときに、レンダリングスレッドで発行されます。これは通常、ウィンドウが隠されたために起こります。

アプリケーションはこのシグナルを使ってリソースを解放することができます。シーングラフとグラフィックコンテキストは、この時点では解放されません。

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

[static] QString QQuickWindow::sceneGraphBackend()

要求された Qt Quick scenegraph バックエンドを返します。

setSceneGraphBackend()も参照 。

[signal] void QQuickWindow::sceneGraphError(QQuickWindow::SceneGraphError error, const QString &message)

このシグナルは、シーングラフの初期化中にerror 。

アプリケーションは、グラフィックス・コンテキスト作成の失敗のようなエラーをカスタムな方法で処理したい場合、このシグナルに接続する必要があります。このシグナルにスロットが接続されていない場合、動作は異なります：Quickはmessage を表示するか、メッセージボックスを表示し、アプリケーションを終了します。

このシグナルはGUIスレッドから発行されます。

[signal] void QQuickWindow::sceneGraphInitialized()

このシグナルはシーン・グラフが初期化されたときに発行されます。

このシグナルは、シーン・グラフのレンダリング・スレッドから発行されます。

[signal] void QQuickWindow::sceneGraphInvalidated()

シーングラフが無効化されると、このシグナルが発せられる。

このシグナルは、使用されたグラフィックス・レンダリング・コンテキストが無効化され、そのコンテキストに結びついたすべてのユーザー・リソースが解放されるべきであることを意味する。

OpenGLでレンダリングする場合、この関数が呼ばれると、このウィンドウのQOpenGLContext 。唯一の例外は、ネイティブOpenGLがEGL_CONTEXT_LOSTなどによってQtの制御外で破棄された場合です。

このシグナルは、シーングラフのレンダリングスレッドから発せられます。

void QQuickWindow::scheduleRenderJob(QRunnable *job, QQuickWindow::RenderStage stage)

このウィンドウのレンダリングが与えられたstage に達したときに実行されるようにjob をスケジューリングします。

これは、「ワンショット」タスクのためのQQuickWindow の同等のシグナルの利便性です。

このウィンドウはjob の所有権を持ち、ジョブが完了すると削除されます。

job が実行される前にレンダリングがシャットダウンされた場合、ジョブは実行され、シーングラフのクリーンアップの一部として削除されます。ウィンドウが表示されず、QQuickWindow が破棄される前にレンダリングが行われなかった場合、保留中のジョブはすべて run() メソッドが呼び出されることなく破棄されます。

レンダリングが別のスレッドで発生している場合、ジョブはレンダリングスレッドで発生します。

stage がNoStage の場合、job は、レンダリング スレッドがフレームのレンダリングに追われていないときに、最も早いタイミングで実行されます。ウィンドウが公開されておらず、レンダリング可能でない場合、ジョブがポストまたは処理された時点で、ジョブはrun()メソッドを実行せずに削除されます。非スレッドのレンダラーが使用されている場合、ジョブの run() メソッドは同期的に実行されます。OpenGLでレンダリングする場合、NoStage ジョブを含むすべてのジョブを実行する前に、OpenGLコンテキストがレンダラーのコンテキストに変更されます。

beforeRendering()、afterRendering()、beforeSynchronizing()、afterSynchronizing()、frameSwapped()、sceneGraphInvalidated()も参照のこと 。

[static] void QQuickWindow::setDefaultAlphaBuffer(bool useAlpha)

useAlpha は、新しく作成されるウィンドウにアルファ透過を使用するかどうかを指定します。

半透明のウィンドウを作成することを期待するアプリケーションでは、最初のQQuickWindow を作成する前に、これをtrueに設定する必要があります。デフォルト値はfalseです。

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

[static, since 6.0] void QQuickWindow::setGraphicsApi(QSGRendererInterface::GraphicsApi api)

指定されたグラフィックスapi を要求します。

組み込みのデフォルトのグラフィックス適応が使用される場合、api 、シーングラフがレンダリングに使用するグラフィックスAPI（OpenGL、Vulkan、Metal、またはDirect3D）を指定します。さらに、software バックエンドもビルトインされており、api をQSGRendererInterface::Software に設定することで要求できます。

指定したバックエンド（ビルトインで出荷されているか、動的にロードされるプラグインとしてインストールされている）のみを要求するために使用できるsetSceneGraphBackend() とは異なり、この関数は、グラフィックスAPIのより高いレベルの概念で動作します。この関数は、Qt Quick に同梱され、QSGRendererInterface::GraphicsApi enum に対応する値を持つバックエンドをカバーします。

この関数が全く呼び出されず、同等の環境変数QSG_RHI_BACKEND も設定されていない場合、シーングラフはプラットフォームに基づいて使用するグラフィックAPIを選択します。

この関数は、指定されたAPIでしかレンダリングできないアプリケーションで重要になります。例えば、アプリケーションによってネイティブの OpenGL や Vulkan レンダリングが行われる場合、Qt Quick も OpenGL や Vulkan を使用してレンダリングされるようにしたいでしょう。そのようなアプリケーションは、main()関数の早い段階でこの関数を呼び出すことが期待されます。

シーングラフがレンダリングに使用しているグラフィックAPIを問い合わせるには、シーングラフhas initialized の後にQSGRendererInterface::graphicsApi() を実行します。これは通常、ウィンドウが初めて表示されたときか、QQuickRenderControl::initialize() が呼び出されたときに起こります。

シーングラフがプラットフォームやその他の条件に基づいてグラフィック API を選択するデフォルトの動作に戻すには、api をQSGRendererInterface::Unknown に設定します。

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

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

[since 6.0] void QQuickWindow::setGraphicsConfiguration(const QQuickGraphicsConfiguration &config)

このウィンドウのグラフィック設定を設定します。config には、基礎となるグラフィックデバイスとコンテキストを初期化するときに、シーングラフが考慮する可能性のあるさまざまな設定が含まれています。

このような追加設定は、たとえば、Vulkan 用に有効にするデバイス拡張を指定するもので、特定の拡張に依存するネイティブ グラフィックス レンダリング コードを統合するときに関連し、不可欠になります。OpenXRのような外部の3DエンジンやVRエンジンと統合する場合も同様です。

QQuickGraphicsConfiguration インスタンスは暗黙的に共有され、コピー可能で、値で渡すことができます。

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

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

[since 6.0] void QQuickWindow::setGraphicsDevice(const QQuickGraphicsDevice &device)

このウィンドウのグラフィックス・デバイス・オブジェクトを設定します。シーングラフは、新しいオブジェクトを作成する代わりに、device で指定された既存のデバイス、物理デバイス、その他のオブジェクトを使用します。

この関数は、QQuickRenderControl やsetRenderTarget() と組み合わせて、Qt Quick のレンダリングをテクスチャにリダイレクトするためによく使用されます。

デフォルトで作成されたQQuickGraphicsDevice は、デフォルトの動作を一切変更しません。QQuickGraphicsDevice::fromDeviceObjects() などのQQuickGraphicsDevice ファクトリ関数の 1 つを介して作成されたdevice が渡され、シーングラフが一致するグラフィッ クス API（fromDeviceObjects()の例では、Vulkan）を使用すると、シーングラフは、QQuickGraphicsDevice によってカプセル化された既存のデバイス・オブジェクト（Vulkan の場合、VkPhysicalDevice 、VkDevice 、グラフィッ クス・キュー・ファミリ・インデックスなど）を使用します。これにより、Qt Quick とネイティブのレンダリングエンジン間で、同じデバイスを使用し、バッファやテクスチャなどのリソースを共有することができます。

例として、今回はDirect3Dを使用していますが、典型的な使い方は以下のようになると思われます：

// native graphics resources set up by a custom D3D rendering engine
ID3D11Device *device;
ID3D11DeviceContext *context;
ID3D11Texture2D *texture;
...
// now to redirect Qt Quick content into 'texture' we could do the following:
QQuickRenderControl *renderControl = new QQuickRenderControl;
QQuickWindow *window = new QQuickWindow(renderControl); // this window will never be shown on-screen
...
window->setGraphicsDevice(QQuickGraphicsDevice::fromDeviceAndContext(device, context));
renderControl->initialize();
window->setRenderTarget(QQuickRenderTarget::fromD3D11Texture(texture, textureSize);
...

この関数を使用する重要な点は、リソースまたはリソースへのハンドル（上記の例ではtexture など）が、外部レンダリングエンジンとシーングラフレンダラの両方から見えるようにし、使用できるようにすることです。このためには、同じグラフィック・デバイス（またはOpenGLではOpenGLコンテキスト）を使用する必要がある。

QQuickGraphicsDevice インスタンスは暗黙的に共有され、コピー可能で、値で渡すことができる。インスタンスは、関連するネイティブ・オブジェクト（例のID3D11Deviceなど）を所有しません。

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

graphicsDevice()、QQuickRenderControl 、setRenderTarget()、setGraphicsApi()も参照してください 。

void QQuickWindow::setPersistentGraphics(bool persistent)

グラフィックリソース（グラフィックデバイスまたはコンテキスト、スワップチェーン、バッファ、テクスチャ）を保存し、最後のウィンドウが削除されるまで解放できないようにするかどうかをpersistent に設定します。 デフォルト値は true です。

releaseResources （）を呼び出すとき、またはウィンドウが非表示になる（より具体的には、レンダリング不可能になる）とき、いくつかのレンダリングループは、キャッシュされたグラフィックリソースだけでなく、すべてを解放する可能性があります。これは一時的にメモリを解放することができますが、ウィンドウを再びレンダリングする必要があるときに、レンダリングエンジンがリソースの完全な、潜在的にコストのかかる再初期化を行う必要があることも意味します。

isPersistentGraphics()、setPersistentSceneGraph()、sceneGraphInitialized()、sceneGraphInvalidated()、releaseResources()も参照 。

void QQuickWindow::setPersistentSceneGraph(bool persistent)

シーングラフのノードとリソースがpersistent であるかどうかを設定する。Persistent は、ノードとリソースが解放されないことを意味します。デフォルト値はtrue です。

releaseResources （）を呼び出すとき、ウィンドウが非表示になると（より具体的には、レンダリング不可能になると）、いくつかのレンダー・ループは、シーン・グラフ・ノードと関連するグラフィック・リソースを解放する可能性があります。これにより、一時的にメモリが解放されますが、ウィンドウが次回レンダリングするときにシーングラフを再構築する必要があります。

isPersistentSceneGraph()、setPersistentGraphics()、sceneGraphInvalidated()、sceneGraphInitialized()、releaseResources()も参照してください 。

[since 6.0] void QQuickWindow::setRenderTarget(const QQuickRenderTarget &target)

このウィンドウのレンダリングターゲットをtarget に設定する。

QQuickRenderTarget は、レンダリング可能なネイティブオブジェクト（最も一般的なのは 2D テクスチャ）と、ピクセル単位のサイズなどの関連メタデータの不透明ハンドルとして機能します。

デフォルトで構築されたQQuickRenderTarget は、リダイレクトがないことを意味します。target一方、静的なQQuickRenderTarget ファクトリ関数の 1 つを介して作成された有効なtarget は、Qt Quick シーンのレンダリングのリダイレクトを可能にします。

例えば、シーングラフがレンダリングにVulkanを使用していると仮定すると、その出力をVkImage にリダイレクトすることができます。VulkanのようなグラフィックスAPIでは、イメージレイアウトも提供する必要があります。QQuickRenderTarget インスタンスは暗黙的に共有され、コピー可能で、値で渡すことができます。ただし、関連するネイティブオブジェクト（例の VkImage など）は所有しません。

QQuickRenderTarget rt = QQuickRenderTarget::fromVulkanImage(vulkanImage, VK_IMAGE_LAYOUT_PREINITIALIZED, pixelSize);
quickWindow->setRenderTarget(rt);

QQuickWindowこの関数は、QQuickRenderControl および不可視のQQuickWindow と組み合わせて使用されることが非常に多く、Qt Quick コンテンツをテクスチャにレンダリングするために使用されます。

目的のターゲットや、サイズなどの関連データが変更された場合は、新しいQQuickRenderTarget でこの関数を呼び出します。QQuickRenderTarget インスタンスを構築し、この関数を呼び出すのは簡単ですが、異なるネイティブオブジェク トやその他のデータで新しいtarget を設定すると、シーングラフが次のフレーム をレンダリングしようとしているときに、初期化ステップにコストがかかる可能性がある ことに注意してください。そのため、ターゲットは必要なときだけ変更してください。

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

renderTarget(),QQuickRenderControl,setGraphicsDevice(),setGraphicsApi()も参照してください 。

[static] void QQuickWindow::setSceneGraphBackend(const QString &backend)

Qt Quick scenegraphbackend をリクエストします。バックエンドはビルトインされるか、動的にロードされるプラグインの形でインストールされます。

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

バックエンドのリストの詳細については、アプリケーションの適応の切り替えを参照してください。backend が無効であるかエラーが発生した場合、リクエストは無視されます。

sceneGraphBackend()も参照のこと 。

[static] void QQuickWindow::setTextRenderType(QQuickWindow::TextRenderType renderType)

Qt Quick の text-like 要素のデフォルトのレンダリングタイプをrenderType に設定します。

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

[override virtual protected] void QQuickWindow::showEvent(QShowEvent *)

再実装：QWindow::showEvent(QShowEvent *ev).

[since 6.6] QRhiSwapChain *QQuickWindow::swapChain() const

もしあれば、このウィンドウによって使用されるQRhiSwapChain を返します。

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

[override virtual protected] void QQuickWindow::tabletEvent(QTabletEvent *event)

この関数は Qt 6.6 で導入されました：QWindow::tabletEvent(QTabletEvent *ev)。

[static] QQuickWindow::TextRenderType QQuickWindow::textRenderType()

Qt Quickのテキストのような要素のレンダリングタイプを返します。デフォルトはQQuickWindow::QtTextRendering です。

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

[slot] void QQuickWindow::update()

別のフレームをレンダリングするようにウィンドウをスケジューリングします。

QQuickWindow::update() を呼び出すと、QQuickItem::update() と異なり、基礎となるシーングラフの変更の有無に関係なく、常に再描画がトリガされます。

[override virtual protected] void QQuickWindow::wheelEvent(QWheelEvent *event)

再実装します：QWindow::wheelEvent(QWheelEvent *ev)を再実装しています。