GraphicsInfo QML Type (Uncreatable)
Qt Quick で使用されるシーングラフ・バックエンドおよびグラフィックス API に関する情報を提供します。詳細...
| Import Statement: | import QtQuick |
| Since: | QtQuick 2.8 |
注:これは生成不可能な型です。QML ではインスタンス化できません。
プロパティ
- api : enumeration
- majorVersion : int
- minorVersion : int
- profile : enumeration
- renderableType : enumeration
- shaderCompilationType : enumeration
(since QtQuick 2.8) - shaderSourceType : enumeration
(since QtQuick 2.8) - shaderType : enumeration
(since QtQuick 2.8)
詳細な説明
GraphicsInfo 添付型は、関連付けられたウィンドウのコンテンツをレンダリングするために使用されるシーングラフ・バックエンドおよびグラフィックス API に関する情報を提供します。
プロパティがアタッチされている項目が現在どのウィンドウにも関連付けられていない場合、プロパティはデフォルト値に設定されます。関連付けられているウィンドウが変更されると、プロパティは更新されます。
プロパティのドキュメント
api : enumeration [read-only]
このプロパティは、現在使用されているグラフィックス API を表します。
取り得る値は以下の通りです:
| 定数 | 説明 |
|---|---|
GraphicsInfo.Unknown | この項目に関連付けられているアクティブなシーングラフがない場合のデフォルト値 |
GraphicsInfo.Software | Qt Quickラスタペイントエンジンを備えたQPainter ベースのソフトウェアレンダラー |
GraphicsInfo.OpenVG | OpenVG |
GraphicsInfo.OpenGL | QRhi 上に構築された OpenGL または OpenGL ES。これはグラフィックス抽象化レイヤーです。 |
GraphicsInfo.Direct3D11 | グラフィックス抽象化レイヤーであるQRhi 上に構築された Direct3D 11 |
GraphicsInfo.Direct3D12 | グラフィックス抽象化レイヤーであるQRhi 上に構築された Direct3D 12 |
GraphicsInfo.Vulkan | QRhi (グラフィックス抽象化レイヤー)上に構築された Vulkan |
GraphicsInfo.Metal | QRhi (グラフィックス抽象化レイヤー)上に構築された Metal |
GraphicsInfo.Null | QRhi (グラフィックス抽象化レイヤー)上にNull(出力なし) |
majorVersion : int [read-only]
このプロパティには、使用中のグラフィックスAPIのメジャーバージョンが格納されます。
OpenGL の場合、デフォルトのバージョンは `2.0` です。
注:これは OpenGL にのみ適用されます。
「 minorVersion 」および「profile 」も参照してください 。
minorVersion : int [read-only]
このプロパティには、使用中のグラフィックスAPIのマイナーバージョンが格納されます。
OpenGL の場合、デフォルトのバージョンは `2.0` です。
注:これは OpenGL にのみ適用されます。
「 majorVersion 」および「profile 」も参照してください 。
profile : enumeration [read-only]
このプロパティには、設定された OpenGL コンテキストのプロファイルが格納されます。
取り得る値は次のとおりです:
| 定数 | 説明 |
|---|---|
GraphicsInfo.OpenGLNoProfile | (デフォルト) OpenGLのバージョンが3.2未満、またはOpenGLが使用されていない場合。 |
GraphicsInfo.OpenGLCoreProfile | OpenGL バージョン 3.0 で非推奨となった機能は利用できません。 |
GraphicsInfo.OpenGLCompatibilityProfile | 以前の OpenGL バージョンの機能は利用可能です。 |
再利用可能な QML コンポーネントでは、通常、コアプロファイルと非コアプロファイルの互換性のあるシェーダーソースのいずれかを選択するために、バインディングでこのプロパティを使用します。
注:これは OpenGL にのみ適用されます。
majorVersion 、minorVersion 、およびQSurfaceFormatも参照してください 。
renderableType : enumeration [read-only]
このプロパティは、レンダリング可能な型を保持します。この値は、OpenGL 以外の API では意味を持ちません。
取り得る値は以下の通りです:
| 定数 | 説明 |
|---|---|
GraphicsInfo.SurfaceFormatUnspecified | (既定値) レンダリング方法が指定されていない |
GraphicsInfo.SurfaceFormatOpenGL | デスクトップ版 OpenGL またはその他のグラフィックス API |
GraphicsInfo.SurfaceFormatOpenGLES | OpenGL ES 注:これは OpenGL にのみ適用されます。 |
関連項目: QSurfaceFormat 。
shaderCompilationType : enumeration [read-only, since QtQuick 2.8]
このプロパティには、アプリケーションが使用しているQt Quick バックエンドでサポートされているシェーダーコンパイル手法のビットマスクが含まれています。
| 定数 | 値 |
|---|---|
GraphicsInfo.RuntimeCompilation | |
GraphicsInfo.OfflineCompilation |
OpenGL の場合、この値は `GraphicsInfo.RuntimeCompilation` となり、これは `ShaderEffect` を使用する従来の方法に対応します。ただし、OpenGL 以外のバックエンドでは、`GraphicsInfo.OfflineCompilation` をより重視することが想定されています。
注:この値は 、アイテムがウィンドウに関連付けられて初めて最新の状態になります。この値に依存するバインディングでは、コンポーネントの初期化が完了すると、値が `0 ` から実際のビットマスクに変更される可能性があるため、この点に留意する必要があります。これは、プロパティ値として設定された `ShaderEffectSource ` アイテム内の `ShaderEffect ` アイテムにおいて特に重要です。
このプロパティは QtQuick 2.8 で導入されました。
shaderType およびshaderSourceTypeも参照してください 。
shaderSourceType : enumeration [read-only, since QtQuick 2.8]
このプロパティには、シェーダーソースの提供方法としてサポートされている方式のビットマスクが含まれています。
| 定数 | 値 |
|---|---|
GraphicsInfo.ShaderSourceString | |
GraphicsInfo.ShaderSourceFile | |
GraphicsInfo.ShaderByteCode |
OpenGL の場合、値は `GraphicsInfo.ShaderSourceString` となり、これは GLSL ソースコードを QML にインラインで埋め込む従来の方法に対応しています。ただし、OpenGL 以外の `Qt Quick ` バックエンドでは、インライン化されたシェーダーソースをサポートしない、あるいはシェーダーソース自体をまったくサポートしない場合もあります。 この場合、シェーダーはSPIR-VやD3Dシェーダーバイトコードなどの形式に事前にコンパイルされていることが想定されます。
注:この値は 、アイテムがウィンドウに関連付けられて初めて最新の状態になります。この値に依存するバインディングでは、コンポーネントの初期化が完了すると、値が `0 ` から実際のビットマスクに変更される可能性があるため、この点に留意する必要があります。これは、プロパティ値として設定された `ShaderEffectSource ` アイテム内の `ShaderEffect ` アイテムにおいて特に重要です。
このプロパティは QtQuick 2.8 で導入されました。
shaderType およびshaderCompilationTypeも参照してください 。
shaderType : enumeration [read-only, since QtQuick 2.8]
このプロパティには、アプリケーションが使用しているQt Quick バックエンドでサポートされているシェーディング言語が格納されています。
| 定数 | 説明 |
|---|---|
GraphicsInfo.UnknownShadingLanguage | 関連付けられたウィンドウおよびシーングラフが存在しないため、現時点では不明です。 |
GraphicsInfo.GLSL | GLSL または GLSL ES |
GraphicsInfo.HLSL | HLSL |
GraphicsInfo.RhiShader | QShader 注:この値は 、アイテムがウィンドウに関連付けられて初めて最新の状態になります。この値に依存するバインディングでは、コンポーネントの初期化が完了した後に、値が `GraphicsInfo.UnknownShadingLanguage` から実際の値へ変更される可能性があるため、この点に留意する必要があります。これは特に、プロパティ値として設定された `ShaderEffectSource ` アイテム内の `ShaderEffect ` アイテムに関して重要です。 |
このプロパティは QtQuick 2.8 で導入されました。
shaderCompilationType およびshaderSourceTypeも参照してください 。
© 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.