GraphicsInfo QML Type

Qt Quick で使用される scenegraph バックエンドとグラフィックス API に関する情報を提供します。詳細...

Import Statement: import QtQuick
Since: QtQuick 2.8

プロパティ

詳細説明

GraphicsInfo attached タイプは、シーングラフバックエンドと、関連付けられたウィンドウのコンテンツをレンダリングするために使用されるグラフィックス API に関する情報を提供します。

プロパティがアタッチされているアイテムが、現在どのウィンドウにも関連付けられていない場合、プロパティはデフォルト値に設定されます。関連するウィンドウが変更されると、プロパティは更新されます。

プロパティの説明

api : enumeration [read-only]

このプロパティは、現在使用されているグラフィックス API を記述する。

指定可能な値は以下の通りです:

定数説明
GraphicsInfo.Unknownアクティブなシーングラフがアイテムに関連付けられていない場合のデフォルト値。
GraphicsInfo.SoftwareQt Quickラスターペイントエンジンを持つQPainter に基づくソフトウェアレンダラー。
GraphicsInfo.OpenVGOpenVG
GraphicsInfo.OpenGLグラフィックス抽象化レイヤであるQRhi 上の OpenGL または OpenGL ES
GraphicsInfo.Direct3D11Direct3D 11QRhi の上にある、グラフィックス抽象化レイヤ。
GraphicsInfo.Direct3D12グラフィックス抽象化レイヤーのDirect3D 12(QRhi )。
GraphicsInfo.VulkanVulkan、QRhi の上に、グラフィックス抽象化レイヤー。
GraphicsInfo.MetalMetal(メタル):QRhi の上、グラフィック抽象化レイヤー。
GraphicsInfo.NullNull (出力なし) on top ofQRhi, a graphics abstraction layer.

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.OpenGLCoreProfileOpenGLバージョン3.0で廃止された機能は利用できません。
GraphicsInfo.OpenGLCompatibilityProfileそれ以前のOpenGLバージョンの機能は利用可能です。

再利用可能なQMLコンポーネントは、コアプロファイルと非コアプロファイルの互換性のあるシェーダーソースを選択するために、通常、バインディングでこのプロパティを使用します。

注意: これはOpenGLにのみ適用されます。

majorVersion,minorVersion,QSurfaceFormatも参照して ください。


renderableType : enumeration [read-only]

このプロパティはレンダラブルタイプを保持します。この値はOpenGL以外のAPIでは意味を持たない。

可能な値は次のとおりです:

定数説明
GraphicsInfo.SurfaceFormatUnspecified(デフォルト) 未指定のレンダリング方法
GraphicsInfo.SurfaceFormatOpenGLデスクトップOpenGLまたは他のグラフィックスAPI
GraphicsInfo.SurfaceFormatOpenGLESOpenGL 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.GLSLGLSL または GLSL ES
GraphicsInfo.HLSLHLSL
GraphicsInfo.RhiShaderQShader

注意: この値は、アイテムがウィンドウに関連づけられた時にのみ最新になります。コンポーネントの初期化が完了した後、値がGraphicsInfo.UnknownShadingLanguage から実際の値に変更される可能性があるため、この値に依存するバインディングは、この点に留意する必要があります。これは、プロパティ値として設定されたShaderEffectSource アイテム内のShaderEffect アイテムに特に関連します。

このプロパティは QtQuick 2.8 で導入されました。

shaderCompilationType およびshaderSourceTypeも参照してください


© 2025 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.