Тип QML GraphicsInfo
Предоставляет информацию о используемом бэкенде Qt Quick. Подробнее...
| Заявление об импорте: | import QtQuick 2.11 |
| С момента: | QtQuick 2.8 |
Свойства
- api : перечисление
- majorVersion : int
- minorVersion : int
- profile : перечисление
- renderableType : перечисление
- shaderCompilationType : перечисление
- shaderSourceType : перечисление
- shaderType : перечисление
Подробное описание
Присоединенный тип GraphicsInfo предоставляет информацию о бэкенде сцены, используемом для отрисовки содержимого связанного окна.
Если элемент, к которому привязаны свойства, в данный момент не связан ни с каким окном, свойства устанавливаются в значения по умолчанию. При изменении связанного окна свойства обновляются.
Документация по свойствам
api : перечисление
Это свойство описывает графический API, который в настоящее время используется.
Возможные значения:
- GraphicsInfo.Unknown - значение по умолчанию, когда с элементом не связан активный граф сцены
- GraphicsInfo.Software - программный рендерер Qt Quick, основанный на QPainter с растровым движком отрисовки
- GraphicsInfo.OpenGL - OpenGL или OpenGL ES
- GraphicsInfo.Direct3D12 - Direct3D 12
majorVersion : int
Это свойство содержит главную версию используемого графического API.
Для OpenGL значение по умолчанию - 2.0.
См. также minorVersion и profile.
minorVersion : int
Это свойство содержит второстепенную версию используемого графического API.
Для OpenGL значение по умолчанию - 2.0.
См. также majorVersion и profile.
profile : перечисление
Это свойство содержит конфигурированный профиль контекста OpenGL.
Возможные значения:
- GraphicsInfo.OpenGLNoProfile (по умолчанию) - версия OpenGL ниже 3.2 или OpenGL не используется.
- GraphicsInfo.OpenGLCoreProfile - Функциональность, устаревшая в OpenGL версии 3.0, недоступна.
- GraphicsInfo.OpenGLCompatibilityProfile - Функциональность из более ранних версий OpenGL доступна.
Переиспользуемые компоненты QML обычно используют это свойство в привязках, чтобы выбирать между совместимыми с профилями ядром и без ядра источниками шейдеров.
См. также majorVersion, minorVersion и QSurfaceFormat.
renderableType : перечисление
Это свойство содержит тип рендерируемого объекта. Значение не имеет смысла для API, отличного от OpenGL.
Возможные значения:
- GraphicsInfo.SurfaceFormatUnspecified (по умолчанию) - Не указан метод рендеринга
- GraphicsInfo.SurfaceFormatOpenGL - Рабочая станция OpenGL или другой графический API
- GraphicsInfo.SurfaceFormatOpenGLES - OpenGL ES
См. также QSurfaceFormat.
shaderCompilationType : перечисление
Это свойство содержит битовую маску подходов к компиляции шейдеров, поддерживаемых бэкендом Qt Quick, используемым приложением.
- GraphicsInfo.RuntimeCompilation
- GraphicsInfo.OfflineCompilation
Для OpenGL значение равно GraphicsInfo.RuntimeCompilation, что соответствует традиционному способу использования ShaderEffect. Однако для бэкендов, отличных от OpenGL, ожидается, что они будут больше сосредоточены на GraphicsInfo.OfflineCompilation.
Примечание: Значение обновляется только после того, как элемент будет связан с окном. Привязкам, использующим значение, следует учитывать это, поскольку значение может изменяться с 0 на фактическую битовую маску после завершения инициализации компонента. Это особенно актуально для элементов ShaderEffect внутри элементов ShaderEffectSource, установленных в качестве значений свойств.
Это свойство было добавлено в QtQuick 2.8.
См. также shaderType и shaderSourceType.
shaderSourceType : перечисление
Это свойство содержит битовую маску поддерживаемых способов предоставления источников шейдеров.
- GraphicsInfo.ShaderSourceString
- GraphicsInfo.ShaderSourceFile
- GraphicsInfo.ShaderByteCode
Для OpenGL значение равно GraphicsInfo.ShaderSourceString, что соответствует традиционному способу встраивания исходного кода GLSL в QML. Однако другие бэкэнды Qt Quick, отличные от OpenGL, могут решить не поддерживать встроенные источники шейдеров или вообще источники шейдеров. В этом случае шейдеры ожидается прекомпилировать в форматы, такие как SPIR-V или байтовый код шейдера D3D.
Примечание: Значение обновляется только после того, как элемент будет связан с окном. Привязкам, использующим значение, следует учитывать это, поскольку значение может изменяться с 0 на фактическую битовую маску после завершения инициализации компонента. Это особенно актуально для элементов ShaderEffect внутри элементов ShaderEffectSource, установленных в качестве значений свойств.
Это свойство было добавлено в QtQuick 2.8.
См. также shaderType и shaderCompilationType.
shaderType : перечисление
Это свойство содержит язык шейдинга, поддерживаемый бэкендом Qt Quick, используемым приложением.
- GraphicsInfo.UnknownShadingLanguage - Пока неизвестно из-за отсутствия связанного окна и графа сцены
- GraphicsInfo.GLSL - GLSL или GLSL ES
- GraphicsInfo.HLSL - HLSL
Примечание: Значение обновляется только после того, как элемент будет связан с окном. Привязкам, использующим значение, следует учитывать это, поскольку значение может изменяться с GraphicsInfo.UnknownShadingLanguage на фактическое значение после завершения инициализации компонента. Это особенно актуально для элементов ShaderEffect внутри элементов ShaderEffectSource, установленных в качестве значений свойств.
Это свойство было добавлено в QtQuick 2.8.
См. также shaderCompilationType и shaderSourceType.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.11/qml-qtquick-graphicsinfo.html