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()

生のグラフィックス（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

単純なイメージ・ノードを作成する。scenegraph が初期化されていない場合、戻り値は null です。

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

QSGImageNodeも参照してください 。

QSGNinePatchNode *QQuickWindow::createNinePatchNode() const

ナイン・パッチ・ノードを作成する。scenegraph が初期化されていない場合、戻り値は null です。

QSGRectangleNode *QQuickWindow::createRectangleNode() const

単純な矩形ノードを作成する。scenegraph が初期化されていない場合、戻り値は null です。

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

QSGRectangleNodeも参照してください 。

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

テキスト・ノードを作成する。scenegraph が初期化されていない場合、戻り値は 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)

再実装：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

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

この関数は 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)

再インプリメント：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 を返す。

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 。唯一の例外は、例えばEGL_CONTEXT_LOSTによって、ネイティブOpenGLが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 によって指定された既存のデバイス、物理デバイス、およびその他のオブジェクトを使用します。

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

デフォルトで作成された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 は、リダイレクトがないことを意味します。一方、静的なQQuickRenderTarget ファクトリ関数のいずれかを介して作成された有効なtarget は、Qt Quick シーンのレンダリングのリダイレクトを可能にします。これは、ウィンドウに関連付けられたサーフェスのカラーバッファをターゲットにするのではなく、target で指定されたテクスチャやその他のグラフィックオブジェクトをターゲットにします。

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

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

この関数は、QQuickRenderControl および不可視のQQuickWindow と組み合わせて、Qt Quick コンテンツをテクスチャにレンダリングするために、このQQuickWindow のための画面上のネイティブウィンドウを作成することなく、非常に頻繁に使用されます。

希望するターゲット、またはサイズなどの関連データが変更されたら、新しい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 のテキストライク要素のデフォルトレンダータイプを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)

再インプリメント：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).