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