Тип QML GraphicsInfo

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

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

Свойства

• api : перечисление
• majorVersion : int
• minorVersion : int
• profile : перечисление
• renderableType : перечисление
• shaderCompilationType : перечисление
• shaderSourceType : перечисление
• shaderType : перечисление

Подробное описание

Тип GraphicsInfo, присоединенный к элементу, предоставляет информацию о бэкэнде графического сцены и графическом API, используемом для отрисовки содержимого связанного окна.

Если элемент, к которому прикреплены свойства, в данный момент не связан ни с каким окном, свойства устанавливаются в значения по умолчанию. При изменении связанного окна свойства будут обновлены.

Документация по свойствам

api : перечисление

Это свойство описывает графический API, который в настоящее время используется.

Возможные значения:

• GraphicsInfo.Unknown - значение по умолчанию, когда с элементом не связан активный графический сцены
• GraphicsInfo.Software - программный рендерер Qt Quick, основанный на QPainter с растровым движком отрисовки
• GraphicsInfo.OpenVG - OpenVG
• GraphicsInfo.OpenGL - OpenGL или OpenGL ES поверх QRhi, уровня абстракции графики
• GraphicsInfo.Direct3D11 - Direct3D 11 поверх QRhi, уровня абстракции графики
• GraphicsInfo.Vulkan - Vulkan поверх QRhi, уровня абстракции графики
• GraphicsInfo.Metal - Metal поверх QRhi, уровня абстракции графики
• GraphicsInfo.Null - Null (без вывода) поверх QRhi, уровня абстракции графики

majorVersion : int

Это свойство содержит главную версию используемого графического API.

Для OpenGL значение по умолчанию — 2.0.

Примечание: Это применимо только к OpenGL.

См. также minorVersion и profile.

minorVersion : int

Это свойство содержит второстепенную версию используемого графического API.

Для OpenGL значение по умолчанию — 2.0.

Примечание: Это применимо только к OpenGL.

См. также majorVersion и profile.

profile : перечисление

Это свойство содержит конфигурированный профиль контекста OpenGL.

Возможные значения:

• GraphicsInfo.OpenGLNoProfile (по умолчанию) - версия OpenGL ниже 3.2 или OpenGL не используется.
• GraphicsInfo.OpenGLCoreProfile - Функциональность, устаревшая в версии OpenGL 3.0, недоступна.
• GraphicsInfo.OpenGLCompatibilityProfile - Доступна функциональность из более ранних версий OpenGL.

Многократно используемые компоненты QML обычно используют это свойство в связываниях для выбора между профилями с поддержкой и без поддержки ядра в совместимых источниках шейдеров.

Примечание: Это применимо только к OpenGL.

См. также majorVersion, minorVersion и QSurfaceFormat.

renderableType : перечисление

Это свойство содержит тип рендерируемого объекта. Значение не имеет смысла для API, отличных от OpenGL.

Возможные значения:

• GraphicsInfo.SurfaceFormatUnspecified (по умолчанию) - Неопределенный метод рендеринга
• GraphicsInfo.SurfaceFormatOpenGL - Рабочий OpenGL или другой графический API
• GraphicsInfo.SurfaceFormatOpenGLES - OpenGL ES

Примечание: Это применимо только к OpenGL.

См. также QSurfaceFormat.

[с QtQuick 2.8] shaderCompilationType : перечисление

Это свойство содержит битовую маску подходов к компиляции шейдеров, поддерживаемых бэкэндом Qt Quick, используемым приложением.

• GraphicsInfo.RuntimeCompilation
• GraphicsInfo.OfflineCompilation

Для OpenGL значение равно GraphicsInfo.RuntimeCompilation, что соответствует традиционному способу использования ShaderEffect. Однако для бэкэндов, отличных от OpenGL, ожидается, что они будут уделять больше внимания GraphicsInfo.OfflineCompilation.

Примечание: Значение обновляется только после того, как элемент будет связан с окном. Связывания, использующие это значение, должны учитывать это, поскольку значение может измениться с 0 до фактической битовой маски после завершения инициализации компонента. Это особенно важно для элементов ShaderEffect внутри элементов ShaderEffectSource, заданных в качестве значений свойств.

Это свойство было введено в QtQuick 2.8.

См. также shaderType и shaderSourceType.

[с QtQuick 2.8] 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.

[с QtQuick 2.8] 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.