Qt3DRender::QRenderCapture Class
class Qt3DRender::QRenderCaptureレンダリングキャプチャ用のフレームグラフノード。詳細...
| ヘッダー: | #include <Qt3DRender/QRenderCapture> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| QML内: | RenderCapture |
| 継承元: | Qt3DRender::QFrameGraphNode |
| ステータス: | 非推奨 |
このクラスは非推奨です。新しいコードでの使用は強く推奨しません。
パブリック関数
| QRenderCapture(Qt3DCore::QNode *parent = nullptr) | |
| Qt3DRender::QRenderCaptureReply * | requestCapture() |
| Qt3DRender::QRenderCaptureReply * | requestCapture(const QRect &rect) |
詳細な説明
QRenderCapture は、任意のレンダリング段階でレンダリング結果を画像としてキャプチャするために使用されます。キャプチャはユーザーによって開始される必要があり、キャプチャ要求 1 件につき 1 枚の画像が返されます。ユーザーは複数のレンダリングキャプチャ要求を同時に発行できますが、1 フレームにつき 1 つの QRenderCapture インスタンスに対して 1 件の要求のみが処理されます。
メンバ関数のドキュメント
[explicit] QRenderCapture::QRenderCapture(Qt3DCore::QNode *parent = nullptr)
このコンストラクタは、指定されたparent を持つインスタンスを作成します。
[invokable] Qt3DRender::QRenderCaptureReply *QRenderCapture::requestCapture()
レンダリングキャプチャを要求するために使用します。フレームグラフに複数のリーフノードが存在する場合でも、requestCapture の呼び出し 1 回につき、生成されるレンダリングキャプチャ結果は 1 つだけです。この関数は QRenderCaptureReply オブジェクトを返し、処理が完了すると、このオブジェクトにキャプチャされた画像が格納されます。返されたオブジェクトの解放は、deleterLater() を呼び出すことでユーザーが行う必要があります。
注：この関数は 、メタオブジェクトシステムを介して、またQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] Qt3DRender::QRenderCaptureReply *QRenderCapture::requestCapture(const QRect &rect)
指定されたrect に対してレンダーキャプチャを要求するために使用されます。フレームグラフに複数のリーフノードが存在する場合でも、requestCaptureの呼び出し1回につき生成されるレンダーキャプチャ結果は1つだけです。この関数はQRenderCaptureReplyオブジェクトを返し、処理が完了するとそのオブジェクトにキャプチャされた画像が格納されます。返されたオブジェクトの解放は、deleteLater()を呼び出すことでユーザーが行う必要があります。
注：この関数は 、メタオブジェクトシステムを介して、またはQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
