Тип QML GraphicsInfo
Предоставляет информацию о используемом бэкенде Qt Quick. Подробнее...
| Оператор импорта: | import QtQuick 2.15 |
| С версии: | 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
- GraphicsInfo.OpenVG - OpenVG
- GraphicsInfo.OpenGLRhi - OpenGL поверх QRhi, уровня абстракции графики
- GraphicsInfo.Direct3D11Rhi - Direct3D 11 поверх QRhi, уровня абстракции графики
- GraphicsInfo.VulkanRhi - Vulkan поверх QRhi, уровня абстракции графики
- GraphicsInfo.MetalRhi - Metal поверх QRhi, уровня абстракции графики
- GraphicsInfo.NullRhi - Null (без вывода) поверх QRhi, уровня абстракции графики
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 обычно используют это свойство в связывании, чтобы выбирать между профилями core и non core совместимыми источниками шейдеров.
См. также 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.RhiShader - QShader
Примечание: Значение обновляется только после того, как элемент связан с окном. Связки, полагающиеся на значение, должны учитывать это, так как значение может измениться с 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/qt-5.15/qml-qtquick-graphicsinfo.html