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