Тип 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.