Тип QML GraphicsInfo

Предоставляет информацию о используемом бэкенде Qt Quick. Подробнее...

• Список всех членов, включая унаследованные члены

Свойства

• 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.